abspy v0.2.6

This release comes with changes as follows:

Added

• engine='mesh' for AdjacencyGraph.save_surface_obj for mesh output (#18).
• .github/workflows/tests.yml for automated tests.
• CONTRIBUTING.md

Removed

• engine='projection' and engine='sorted' for AdjacencyGraph.save_surface_obj.

Changed

• Rename engine='rendering' → engine='soup' for AdjacencyGraph.save_surface_obj.
• Reduce environment.yml to core dependencies.
• Replace SDF input with fixed values in tests/test_combined.py.

Full Changelog

abspy v0.2.5

This release comes with changes as follows:

Added

• VertexGroupReference.bottom_indices.
• VertexGroupReference.wall_indices.
• VertexGroupReference.perturb to perturb plane normals.
• VertexGroupReference.inject_points to inject and overwrite points.
• VertexGroup.save_cloud and VertexGroupReference.save_cloud to save point cloud and optionally normals.
• Copyright notice.

Changed

• VertexGroupReference.bounds → VertexGroupReference.aabbs.
• VertexGroup.save_bounds_npy → VertexGroup.save_aabbs_npy.
• Correct SDF file test_sdf.npy for improved complex with OBB.
• Update Sphinx requirements.
• Fix writing (.vg/.bvg) by removing a place (previously KSR would crash).
• Fix reading multi-line points from VG.

Full Changelog

abspy v0.2.4

This release comes with changes as follows:

Added

• Options to refit and skip global vertex group.
• OBB pre-intersection test to reduce runtime and maintain compactness (#20).
  • Stats therebefore:

  .../test_complex.py 
  INFO          primitive.py:617   processing .../abspy/tests/test_data/test_church.obj
  INFO            complex.py:444   constructing cell complex
  100%|██████████| 218/218 [01:12<00:00,  3.02it/s]
  INFO            complex.py:537   cell complex constructed: 72.22 s
  INFO            complex.py:831   number of planes: 218
  INFO            complex.py:832   number of cells: 3408

  • Stats thereafter:

  .../test_complex.py 
  INFO          primitive.py:632   processing .../abspy/tests/test_data/test_church.obj
  INFO            complex.py:609   constructing cell complex
  100%|██████████| 218/218 [01:01<00:00,  3.55it/s]
  INFO            complex.py:705   cell complex constructed: 61.43 s
  INFO            complex.py:999   number of planes: 218
  INFO            complex.py:1000  number of cells: 2735

• An example for convex decomposition from mesh in README.
• RTD configuration .readthedocs.yaml.
• A complex church test mesh.

Removed

• Obsolete PyPi requirements.txt.
• The Why adaptive section in README.

Changed

• A few trivial optimizations.
• Rename test meshes
• Upgrade sage=10.0.

Full Changelog

abspy v0.2.3

This release comes with cumulative small changes as follows:

Added

• Issue templates.
• GitHub workflow to publish package.
• Animation GIF in README.
• Download stats badge in README.
• License attribute in setup.cfg.
• AdjacencyGraph.to_uids()
• option location=random_t and location=boundary in CellComplex.cell_representatives
• environment.yml
• CellComplex.cells_boundary()

Removed

• Download stats in README.

Changed

• Fix docs autofunction names __init__.
• Fix planar segment extraction from VertexGroupReference
• Clean Misc section in README.
• Rename location=random to location=random_r (rejection-based) in CellComplex.cell_representatives()

abspy can be installed as a package from PyPI:

pip install abspy

Full Changelog

abspy v0.2.1

The first release for abspy, a Python tool for 3D adaptive binary space partitioning and beyond. It offers the following features:

• Manipulation of planar primitives detected from point clouds
• Linear cell complex creation with adaptive binary space partitioning (a-BSP)
• Dynamic BSP-tree (NetworkX graph) updated locally upon insertion of primitives
• Support of polygonal surface reconstruction from graph cuts
• Compatible data structure with Easy3D on point clouds, primitives, cell complexes and surfaces
• Robust Boolean spatial operations underpinned by the rational ring from SageMath's exact kernel

abspy can also be installed as a package from PyPI:

pip install abspy

Full Changelog