Skip to content

Releases

v0.1.0a5

v0.1.0a5 Pre-release
Pre-release

Choose a tag to compare

@DavidMStraub DavidMStraub released this 20 Nov 15:59

Notebook display

  • A shape at the end of a notebook cell displays as an interactive 3D view in Jupyter, VS Code, and other notebook frontends, with no extra Python packages. The view uses vtk.js, loaded from a CDN at a pinned version.
  • Where scripts can't run (GitHub, nbviewer, untrusted notebooks) or the CDN is unreachable, a static isometric SVG shows instead.

Reprs

  • Shape, Face, Edge, Vertex, Curve2D, Path2D, Path3D, and Profile have readable reprs, such as <Shape: 10 faces, 18 edges>, <Face plane, normal (0, 0, 1)>, or <Edge circle r=10, (10, 0, 10) to (10, 0, 10)>. They avoid costly computations such as volume or face centroids.

Try it in the browser

Development

  • The dev container installs ipykernel and the VS Code Jupyter extension.

See the API reference for signatures and conventions.

v0.1.0a4

v0.1.0a4 Pre-release
Pre-release

Choose a tag to compare

@DavidMStraub DavidMStraub released this 20 Nov 12:02

Selection data

  • Faces report kind ("plane", "cylinder", "cone", "sphere", "torus", "spline", "revolution", or "blend") and area.
  • Edges report start, end, and, for line edges, line_direction.
  • FaceKind and EdgeKind are Literal types, so a type checker rejects a misspelled comparison such as face.kind == "cylindre".

Viewing and platforms

  • show() shades with the kernel's vertex normals, so curved faces render without visible facets.
  • Python 3.15 is tested in CI and declared in the package metadata.

Documentation

  • The README has a gallery of parts from CAD as Code, rebuilt as examples, and describes the project's motivation, findings, and coverage.
  • CITATION.cff describes how to cite solidfunc.

See the API reference for signatures and conventions.

v0.1.0a3

v0.1.0a3 Pre-release
Pre-release

Choose a tag to compare

@DavidMStraub DavidMStraub released this 20 Nov 09:47

Breaking API changes

  • polygon() and rectangle() return closed Path2D boundaries. Fill them with profile(). rectangle() is centred on center instead of starting at origin.
  • extrude(), revolve(), sweep(), and loft() accept only a Profile and raise TypeError for curves and paths.
  • box() and cylinder() are centred in XY with their base at z = 0, and origin is removed. Position them with place() or translate().
  • Renamed: loft(interpolation_deg=) to loft(degree=), spline() to spline3d(), Face.center to Face.centroid, and Face.normal to Face.planar_normal.
  • a - b raises EmptyResultError, a ValueError subclass, when no material remains. difference() still returns None.

Modeling

  • place(shape, plane) carries a shape from world XY onto a plane, and Plane.offset() moves a plane along its own axes, for example place(stud, Plane.from_face(top).offset(x=3)).
  • union() accepts any number of shapes and combines them in one kernel operation.
  • a & b intersects two shapes and raises EmptyResultError when they share no material. intersection() still returns None.
  • polyline() builds open planar paths. profile() accepts a single closed curve, so profile(circle(radius=5)) fills a disk, and rectangles, polygons, and circles can all be holes.
  • cylinder() and circle() accept diameter as an alternative to radius.
  • bounds() returns a Bounds named tuple with min, max, size, and center.

Fixes

  • Faces, edges, and vertices from separate queries of one shape compare equal and hash alike, so sets and in work. fillet() and chamfer() round a repeated edge once instead of failing.

See the API reference for signatures and conventions.

v0.1.0a2

v0.1.0a2 Pre-release
Pre-release

Choose a tag to compare

@DavidMStraub DavidMStraub released this 19 Nov 14:45

Breaking API changes

  • box() uses size_x, size_y, and size_z.
  • rotate() and revolve() use axis_direction, axis_origin, and angle_deg. arc() uses start_angle_deg and sweep_angle_deg.
  • Use distance for extrusion, setback for chamfer, interpolation_deg for loft, and relative_tolerance for volume.

Modeling and exchange

  • Create planar curves and profiles, place them in 3D, and extrude, revolve, loft, or sweep them. Sweeps support hollow sections.
  • Inspect faces, edges, and vertices. Apply fillets and equal-distance chamfers to selected edges.
  • Import and export STEP. See the API reference for signatures and conventions.

v0.1.0a1

v0.1.0a1 Pre-release
Pre-release

Choose a tag to compare

@DavidMStraub DavidMStraub released this 17 Nov 21:51

First experimental release: functional SolidCore bindings with box creation, translation, volume, bounds, and STEP export.