Changelog

The format is based on Keep a Changelog. This project adheres to Semantic Versioning.

v0.6.0 - 2021-07-14

Added

  • Plotting and other graphical rendering of shapes using plato.

  • Notebooks with example use-cases for the package.

  • A quickstart tutorial.

v0.5.0 - 2021-02-23

Added

  • Ellipse area setter and Ellipsoid volume setter.

  • Point in circle checks.

  • Point in ellipse checks.

  • Inertia tensors for 2D shapes that implement moments of inertia.

  • Add minimal bounding sphere for all shapes.

  • Add minimal centered bounding sphere calculations for all shapes except general polygons, general polyhedra, spheropolygons, and spheropolyhedra.

  • Enable getting and setting the circumsphere or bounding sphere radius of a polyhedron (for both types of bounding sphere).

  • Add maximal bounded sphere for all shapes.

  • Add maximal centered bounded sphere calculations for all shapes except general polygons, general polyhedra, spheropolygons, and spheropolyhedra.

  • Enable getting and setting the insphere or bounded sphere radius of a polyhedron (for both types of bounding sphere).

  • Point in polygon checks for general (nonconvex) polygons.

  • Point in polyhedron checks for general (nonconvex) polyhedrons.

  • Minimal bounding sphere for all shapes except spheropolygons and spheropolyhedra.

  • Add minimal centered bounding sphere calculations for all shapes except general polygons, general polyhedra, spheropolygons, and spheropolyhedra.

  • Getters and setters for the circumsphere or bounding sphere radius of a polyhedron (for both types of bounding sphere).

  • A repr for all shapes.

Changed

  • Ensure that hypothesis-based tests don’t implicitly reuse pytest fixtures.

Deprecated

  • The circumsphere from center calculations (replaced by minimal centered bounding sphere).

  • The bounding_sphere property is deprecated in favor of minimal_bounding_sphere.

  • The insphere from center calculations (replaced by maximal centered bounded sphere).

Fixed

  • Centroid calculations for polygon and polyhedron use the full integrals rather than simple averages of vertices.

v0.4.0 - 2020-10-14

Added

  • Circumsphere and insphere from center calculations for ConvexSpheropolyhedron.

  • Form factors amplitudes for sphere, polygons, and polyhedra.

  • Shape families associated with a DOI can be directly accessed via a dictionary.

  • Expected abstract interface for shapes (both 2D and 3D) has expanded.

  • Plotting polygons or polyhedra can automatically create matplotlib axes.

  • Perimeter calculation for polygons.

  • Area and perimeter setters for spheropolygons.

Changed

  • Shape family API is now entirely based on class methods rather than a call operator.

  • The parent ShapeFamily class is now part of the public API.

  • Doctests are now run as part of pytest.

  • Subpackages have been renamed: shape_classes is now shapes, and shape_families is now families.

  • The common_families submodule of shape_families is now just common.

Fixed

  • Volume calculation for ConvexSpheropolyhedron includes area of extruded faces in addition to vertices and edges.

  • Documentation has been revised and edited.

Removed

  • The symmetry.py module.

  • The ft.py module.

  • The symmetry.py module.

  • The get_params method of TabulatedShapeFamily.

  • The family_from_doi method (the underlying data dictionary is now directly exposed).

v0.3.0 - 2020-06-18

Added

  • Calculation of circumsphere from center for convex polyhedra.

  • Simple name-based shape getter for damasceno SHAPES dictionary.

  • Polygons moment of inertia calculation.

  • Interoperability with the GSD shape specification.

  • Shape families and stored data for well-known families.

  • All shapes can be centered anywhere in 3D Euclidean space.

  • Extensive style checking using black, isort, and various other flake8 plugins.

  • Make Circle area settable.

  • 3D shapes can be oriented by their principal axes.

  • Make Sphere volume settable.

Changed

  • Inertia tensors for polyhedra and moments of inertia for polygons are calculated in global coordinates rather than the body frame.

  • Modified testing of convex hulls to generate points on ellipsoids to avoid degenerate simplices.

  • All insphere, circumsphere, and bounding sphere calculations now return the appropriate classes instead of tuples.

Removed

  • The common_shapes subpackage.

v0.2.0 - 2020-04-09

Added

  • Continuous integrated testing on CircleCI.

  • New Polygon class with property-based API.

  • New ConvexSpheropolygon class with property-based API.

  • New Polyhedron class with property-based API and robust facet sorting and merging.

  • New ConvexPolyhedron class with property-based API.

  • New ConvexSpheropolyhedron class with property-based API.

  • Ability to plot Polyhedra and Polygons.

  • Can now check whether points lie inside a ConvexPolyhedron or ConvexSpheropolyhedron.

  • Added documentation.

  • New Ellipsoid class with property-based API.

  • New Sphere class with property-based API.

  • New Ellipse class with property-based API.

  • New Circle class with property-based API.

  • Added insphere from center calculation for convex polyhedra.

  • New ConvexPolygon class.

  • Documentation is hosted on ReadTheDocs.

Changed

  • Moved core shape classes from euclid.FreudShape into top-level package namespace.

  • Moved common shape definitions into common_shapes subpackage.

  • Shapes from Damasceno science 2012 paper are now stored in a JSON file that is loaded in the damasceno module.

Fixed

  • Formatting now properly follows PEP8.

Removed

  • Various unused or redundant functions in the utils module.

  • The quaternion_tools module (uses rowan for quaternion math instead).

  • The shapelib module.

  • Old polygon.py and polyhedron.py modules, which contained old implementations of various poly* and spheropoly* classes.

v0.1.0

  • Initial version of code base.