COMPAS 2.1.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- compas/__init__.py +274 -0
- compas/__main__.py +31 -0
- compas/_iotools.py +80 -0
- compas/_os.py +746 -0
- compas/colors/__init__.py +14 -0
- compas/colors/cmcrameri/acton.txt +256 -0
- compas/colors/cmcrameri/actonS.txt +100 -0
- compas/colors/cmcrameri/bam.txt +256 -0
- compas/colors/cmcrameri/bamO.txt +256 -0
- compas/colors/cmcrameri/bamako.txt +256 -0
- compas/colors/cmcrameri/bamakoS.txt +100 -0
- compas/colors/cmcrameri/batlow.txt +256 -0
- compas/colors/cmcrameri/batlowK.txt +256 -0
- compas/colors/cmcrameri/batlowS.txt +100 -0
- compas/colors/cmcrameri/batlowW.txt +256 -0
- compas/colors/cmcrameri/berlin.txt +256 -0
- compas/colors/cmcrameri/bilbao.txt +256 -0
- compas/colors/cmcrameri/bilbaoS.txt +100 -0
- compas/colors/cmcrameri/broc.txt +256 -0
- compas/colors/cmcrameri/brocO.txt +256 -0
- compas/colors/cmcrameri/buda.txt +256 -0
- compas/colors/cmcrameri/budaS.txt +100 -0
- compas/colors/cmcrameri/bukavu.txt +256 -0
- compas/colors/cmcrameri/cork.txt +256 -0
- compas/colors/cmcrameri/corkO.txt +256 -0
- compas/colors/cmcrameri/davos.txt +256 -0
- compas/colors/cmcrameri/davosS.txt +100 -0
- compas/colors/cmcrameri/devon.txt +256 -0
- compas/colors/cmcrameri/devonS.txt +100 -0
- compas/colors/cmcrameri/fes.txt +256 -0
- compas/colors/cmcrameri/grayC.txt +256 -0
- compas/colors/cmcrameri/grayCS.txt +100 -0
- compas/colors/cmcrameri/hawaii.txt +256 -0
- compas/colors/cmcrameri/hawaiiS.txt +100 -0
- compas/colors/cmcrameri/imola.txt +256 -0
- compas/colors/cmcrameri/imolaS.txt +100 -0
- compas/colors/cmcrameri/lajolla.txt +256 -0
- compas/colors/cmcrameri/lajollaS.txt +100 -0
- compas/colors/cmcrameri/lapaz.txt +256 -0
- compas/colors/cmcrameri/lapazS.txt +100 -0
- compas/colors/cmcrameri/lisbon.txt +256 -0
- compas/colors/cmcrameri/nuuk.txt +256 -0
- compas/colors/cmcrameri/nuukS.txt +100 -0
- compas/colors/cmcrameri/oleron.txt +256 -0
- compas/colors/cmcrameri/oslo.txt +256 -0
- compas/colors/cmcrameri/osloS.txt +100 -0
- compas/colors/cmcrameri/roma.txt +256 -0
- compas/colors/cmcrameri/romaO.txt +256 -0
- compas/colors/cmcrameri/tofino.txt +256 -0
- compas/colors/cmcrameri/tokyo.txt +256 -0
- compas/colors/cmcrameri/tokyoS.txt +100 -0
- compas/colors/cmcrameri/turku.txt +256 -0
- compas/colors/cmcrameri/turkuS.txt +100 -0
- compas/colors/cmcrameri/vanimo.txt +256 -0
- compas/colors/cmcrameri/vik.txt +256 -0
- compas/colors/cmcrameri/vikO.txt +256 -0
- compas/colors/color.py +1118 -0
- compas/colors/colordict.py +103 -0
- compas/colors/colormap.py +306 -0
- compas/colors/html_colors.py +149 -0
- compas/colors/mpl_colormap.py +1064 -0
- compas/data/__init__.py +31 -0
- compas/data/coercion.py +71 -0
- compas/data/conftest.py +10 -0
- compas/data/data.py +342 -0
- compas/data/encoders.py +240 -0
- compas/data/exceptions.py +2 -0
- compas/data/json.py +240 -0
- compas/data/samples/boxes.obj +250 -0
- compas/data/samples/butt_model.obj +2829 -0
- compas/data/samples/cone.stl +0 -0
- compas/data/samples/cube.off +16 -0
- compas/data/samples/cube_ascii.stl +56114 -0
- compas/data/samples/cube_binary.stl +0 -0
- compas/data/samples/cube_binary_2.stl +0 -0
- compas/data/samples/doosabin.json +1 -0
- compas/data/samples/faces.obj +63 -0
- compas/data/samples/faces_big.obj +9663 -0
- compas/data/samples/faces_reversed.obj +63 -0
- compas/data/samples/fink.obj +135 -0
- compas/data/samples/grid_irregular.obj +303 -0
- compas/data/samples/hypar.obj +148 -0
- compas/data/samples/lines.json +1 -0
- compas/data/samples/lines.obj +282 -0
- compas/data/samples/lines_big.obj +40322 -0
- compas/data/samples/lines_bigger.obj +161282 -0
- compas/data/samples/lines_noleaves.obj +422 -0
- compas/data/samples/mesh.obj +874 -0
- compas/data/samples/mesh_100_faces.json +1893 -0
- compas/data/samples/mesh_110_faces.json +2081 -0
- compas/data/samples/open_edges.obj +424 -0
- compas/data/samples/point.json +1 -0
- compas/data/samples/quadmesh.obj +183 -0
- compas/data/samples/quadmesh_planar.obj +181 -0
- compas/data/samples/saddle.obj +314 -0
- compas/data/samples/spline.obj +72 -0
- compas/data/samples/tubemesh.json +1 -0
- compas/data/samples/tubemesh.obj +378 -0
- compas/data/samples/tubemesh.off +374 -0
- compas/data/samples/tubemesh.ply +551 -0
- compas/data/schema.py +137 -0
- compas/data/validators.py +243 -0
- compas/datastructures/__init__.py +75 -0
- compas/datastructures/_mutablemapping.py +148 -0
- compas/datastructures/assembly/__init__.py +0 -0
- compas/datastructures/assembly/assembly.py +234 -0
- compas/datastructures/assembly/exceptions.py +6 -0
- compas/datastructures/assembly/part.py +228 -0
- compas/datastructures/attributes.py +85 -0
- compas/datastructures/cell_network/__init__.py +0 -0
- compas/datastructures/cell_network/cell_network.py +4190 -0
- compas/datastructures/datastructure.py +309 -0
- compas/datastructures/graph/__init__.py +0 -0
- compas/datastructures/graph/duality.py +197 -0
- compas/datastructures/graph/graph.py +2478 -0
- compas/datastructures/graph/operations/__init__.py +0 -0
- compas/datastructures/graph/operations/join.py +124 -0
- compas/datastructures/graph/operations/split.py +63 -0
- compas/datastructures/graph/planarity.py +292 -0
- compas/datastructures/graph/smoothing.py +59 -0
- compas/datastructures/mesh/__init__.py +0 -0
- compas/datastructures/mesh/conway.py +553 -0
- compas/datastructures/mesh/duality.py +104 -0
- compas/datastructures/mesh/mesh.py +5103 -0
- compas/datastructures/mesh/operations/__init__.py +0 -0
- compas/datastructures/mesh/operations/collapse.py +350 -0
- compas/datastructures/mesh/operations/extrude.py +0 -0
- compas/datastructures/mesh/operations/insert.py +120 -0
- compas/datastructures/mesh/operations/merge.py +83 -0
- compas/datastructures/mesh/operations/split.py +263 -0
- compas/datastructures/mesh/operations/substitute.py +37 -0
- compas/datastructures/mesh/operations/swap.py +62 -0
- compas/datastructures/mesh/operations/weld.py +107 -0
- compas/datastructures/mesh/remesh.py +234 -0
- compas/datastructures/mesh/slice.py +170 -0
- compas/datastructures/mesh/smoothing.py +187 -0
- compas/datastructures/mesh/subdivision.py +754 -0
- compas/datastructures/tree/__init__.py +0 -0
- compas/datastructures/tree/tree.py +504 -0
- compas/datastructures/volmesh/__init__.py +0 -0
- compas/datastructures/volmesh/volmesh.py +4203 -0
- compas/files/__init__.py +27 -0
- compas/files/_xml/__init__.py +0 -0
- compas/files/_xml/xml_cli.py +213 -0
- compas/files/_xml/xml_cpython.py +32 -0
- compas/files/_xml/xml_pre_38.py +58 -0
- compas/files/_xml/xml_shared.py +40 -0
- compas/files/gltf/__init__.py +0 -0
- compas/files/gltf/constants.py +59 -0
- compas/files/gltf/data_classes.py +657 -0
- compas/files/gltf/extensions.py +317 -0
- compas/files/gltf/gltf.py +92 -0
- compas/files/gltf/gltf_children.py +64 -0
- compas/files/gltf/gltf_content.py +615 -0
- compas/files/gltf/gltf_exporter.py +465 -0
- compas/files/gltf/gltf_mesh.py +273 -0
- compas/files/gltf/gltf_node.py +348 -0
- compas/files/gltf/gltf_parser.py +115 -0
- compas/files/gltf/gltf_reader.py +310 -0
- compas/files/gltf/gltf_scene.py +125 -0
- compas/files/gltf/helpers.py +59 -0
- compas/files/obj.py +680 -0
- compas/files/off.py +296 -0
- compas/files/ply.py +697 -0
- compas/files/stl.py +436 -0
- compas/files/xml.py +328 -0
- compas/geometry/__init__.py +772 -0
- compas/geometry/_core/__init__.py +0 -0
- compas/geometry/_core/_algebra.py +2826 -0
- compas/geometry/_core/angles.py +408 -0
- compas/geometry/_core/centroids.py +573 -0
- compas/geometry/_core/distance.py +895 -0
- compas/geometry/_core/normals.py +149 -0
- compas/geometry/_core/nurbs.py +367 -0
- compas/geometry/_core/predicates_2.py +582 -0
- compas/geometry/_core/predicates_3.py +1111 -0
- compas/geometry/_core/quaternions.py +196 -0
- compas/geometry/_core/size.py +204 -0
- compas/geometry/_core/tangent.py +56 -0
- compas/geometry/_core/transformations.py +1121 -0
- compas/geometry/_core/transformations_numpy.py +279 -0
- compas/geometry/bbox.py +145 -0
- compas/geometry/bbox_numpy.py +306 -0
- compas/geometry/bestfit.py +77 -0
- compas/geometry/bestfit_numpy.py +259 -0
- compas/geometry/booleans.py +297 -0
- compas/geometry/booleans_shapely.py +147 -0
- compas/geometry/brep/__init__.py +112 -0
- compas/geometry/brep/brep.py +1131 -0
- compas/geometry/brep/edge.py +302 -0
- compas/geometry/brep/errors.py +22 -0
- compas/geometry/brep/face.py +329 -0
- compas/geometry/brep/loop.py +87 -0
- compas/geometry/brep/trim.py +46 -0
- compas/geometry/brep/vertex.py +46 -0
- compas/geometry/contours.py +32 -0
- compas/geometry/curves/__init__.py +0 -0
- compas/geometry/curves/arc.py +429 -0
- compas/geometry/curves/bezier.py +345 -0
- compas/geometry/curves/circle.py +500 -0
- compas/geometry/curves/conic.py +16 -0
- compas/geometry/curves/curve.py +614 -0
- compas/geometry/curves/ellipse.py +408 -0
- compas/geometry/curves/hyperbola.py +336 -0
- compas/geometry/curves/line.py +431 -0
- compas/geometry/curves/nurbs.py +412 -0
- compas/geometry/curves/parabola.py +256 -0
- compas/geometry/curves/polyline.py +724 -0
- compas/geometry/frame.py +769 -0
- compas/geometry/geometry.py +296 -0
- compas/geometry/hull.py +146 -0
- compas/geometry/hull_numpy.py +82 -0
- compas/geometry/icp_numpy.py +104 -0
- compas/geometry/interpolation_barycentric.py +38 -0
- compas/geometry/interpolation_coons.py +102 -0
- compas/geometry/interpolation_tweening.py +87 -0
- compas/geometry/intersection.py +121 -0
- compas/geometry/intersections.py +1105 -0
- compas/geometry/kdtree.py +153 -0
- compas/geometry/offset.py +208 -0
- compas/geometry/pca_numpy.py +87 -0
- compas/geometry/plane.py +657 -0
- compas/geometry/point.py +664 -0
- compas/geometry/pointcloud.py +409 -0
- compas/geometry/polygon.py +473 -0
- compas/geometry/polyhedron.py +650 -0
- compas/geometry/projection.py +155 -0
- compas/geometry/quadmesh_planarize.py +30 -0
- compas/geometry/quadmesh_planarize_none.py +114 -0
- compas/geometry/quaternion.py +544 -0
- compas/geometry/reflection.py +102 -0
- compas/geometry/rotation.py +354 -0
- compas/geometry/scale.py +100 -0
- compas/geometry/shapes/__init__.py +0 -0
- compas/geometry/shapes/box.py +747 -0
- compas/geometry/shapes/capsule.py +472 -0
- compas/geometry/shapes/cone.py +309 -0
- compas/geometry/shapes/cylinder.py +355 -0
- compas/geometry/shapes/shape.py +300 -0
- compas/geometry/shapes/sphere.py +362 -0
- compas/geometry/shapes/torus.py +294 -0
- compas/geometry/shear.py +115 -0
- compas/geometry/surfaces/__init__.py +0 -0
- compas/geometry/surfaces/conical.py +166 -0
- compas/geometry/surfaces/cylindrical.py +251 -0
- compas/geometry/surfaces/extrusion.py +0 -0
- compas/geometry/surfaces/nurbs.py +380 -0
- compas/geometry/surfaces/planar.py +223 -0
- compas/geometry/surfaces/revolution.py +0 -0
- compas/geometry/surfaces/spherical.py +259 -0
- compas/geometry/surfaces/surface.py +689 -0
- compas/geometry/surfaces/toroidal.py +198 -0
- compas/geometry/transformation.py +554 -0
- compas/geometry/translation.py +104 -0
- compas/geometry/triangulation_delaunay.py +102 -0
- compas/geometry/triangulation_earclip.py +300 -0
- compas/geometry/trimesh_curvature.py +113 -0
- compas/geometry/trimesh_descent_numpy.py +26 -0
- compas/geometry/trimesh_geodistance.py +35 -0
- compas/geometry/trimesh_gradient_numpy.py +74 -0
- compas/geometry/trimesh_isolines.py +41 -0
- compas/geometry/trimesh_matrices.py +31 -0
- compas/geometry/trimesh_matrices_numpy.py +191 -0
- compas/geometry/trimesh_parametrisation.py +55 -0
- compas/geometry/trimesh_pull_points_numpy.py +216 -0
- compas/geometry/trimesh_remeshing.py +97 -0
- compas/geometry/trimesh_samplepoints_numpy.py +108 -0
- compas/geometry/trimesh_slicing.py +28 -0
- compas/geometry/trimesh_smoothing_numpy.py +34 -0
- compas/geometry/vector.py +889 -0
- compas/itertools.py +441 -0
- compas/linalg.py +634 -0
- compas/matrices.py +314 -0
- compas/plugins.py +488 -0
- compas/rpc/__init__.py +20 -0
- compas/rpc/__main__.py +77 -0
- compas/rpc/dispatcher.py +181 -0
- compas/rpc/errors.py +11 -0
- compas/rpc/proxy.py +437 -0
- compas/rpc/server.py +79 -0
- compas/rpc/services/__init__.py +0 -0
- compas/rpc/services/default.py +87 -0
- compas/rpc/services/watcher.py +43 -0
- compas/scene/__init__.py +56 -0
- compas/scene/assemblyobject.py +3 -0
- compas/scene/context.py +154 -0
- compas/scene/descriptors/__init__.py +0 -0
- compas/scene/descriptors/attribute.py +30 -0
- compas/scene/descriptors/color.py +91 -0
- compas/scene/descriptors/colordict.py +101 -0
- compas/scene/descriptors/protocol.py +12 -0
- compas/scene/exceptions.py +7 -0
- compas/scene/geometryobject.py +58 -0
- compas/scene/graphobject.py +173 -0
- compas/scene/meshobject.py +238 -0
- compas/scene/scene.py +144 -0
- compas/scene/sceneobject.py +253 -0
- compas/scene/volmeshobject.py +252 -0
- compas/tolerance.py +879 -0
- compas/topology/__init__.py +45 -0
- compas/topology/combinatorics.py +108 -0
- compas/topology/connectivity.py +129 -0
- compas/topology/orientation.py +204 -0
- compas/topology/traversal.py +567 -0
- compas/utilities/__init__.py +25 -0
- compas/utilities/azync.py +155 -0
- compas/utilities/datetime.py +40 -0
- compas/utilities/decorators.py +136 -0
- compas/utilities/remote.py +54 -0
- compas/utilities/ssh.py +169 -0
- compas-2.1.1.dist-info/AUTHORS.md +42 -0
- compas-2.1.1.dist-info/LICENSE +21 -0
- compas-2.1.1.dist-info/METADATA +132 -0
- compas-2.1.1.dist-info/RECORD +468 -0
- compas-2.1.1.dist-info/WHEEL +5 -0
- compas-2.1.1.dist-info/entry_points.txt +2 -0
- compas-2.1.1.dist-info/top_level.txt +4 -0
- compas_blender/__init__.py +250 -0
- compas_blender/collections.py +130 -0
- compas_blender/conversions/__init__.py +48 -0
- compas_blender/conversions/breps.py +0 -0
- compas_blender/conversions/colors.py +23 -0
- compas_blender/conversions/curves.py +125 -0
- compas_blender/conversions/geometry.py +161 -0
- compas_blender/conversions/meshes.py +148 -0
- compas_blender/conversions/surfaces.py +48 -0
- compas_blender/conversions/transformations.py +46 -0
- compas_blender/data.py +30 -0
- compas_blender/geometry/__init__.py +14 -0
- compas_blender/geometry/booleans.py +100 -0
- compas_blender/install.py +338 -0
- compas_blender/objects.py +326 -0
- compas_blender/print_python_path.py +18 -0
- compas_blender/scene/__init__.py +116 -0
- compas_blender/scene/boxobject.py +64 -0
- compas_blender/scene/capsuleobject.py +73 -0
- compas_blender/scene/circleobject.py +53 -0
- compas_blender/scene/coneobject.py +70 -0
- compas_blender/scene/curveobject.py +58 -0
- compas_blender/scene/cylinderobject.py +70 -0
- compas_blender/scene/frameobject.py +105 -0
- compas_blender/scene/graphobject.py +257 -0
- compas_blender/scene/lineobject.py +60 -0
- compas_blender/scene/meshobject.py +508 -0
- compas_blender/scene/planeobject.py +81 -0
- compas_blender/scene/pointcloudobject.py +67 -0
- compas_blender/scene/pointobject.py +71 -0
- compas_blender/scene/polygonobject.py +57 -0
- compas_blender/scene/polyhedronobject.py +57 -0
- compas_blender/scene/polylineobject.py +54 -0
- compas_blender/scene/sceneobject.py +249 -0
- compas_blender/scene/sphereobject.py +72 -0
- compas_blender/scene/surfaceobject.py +54 -0
- compas_blender/scene/torusobject.py +73 -0
- compas_blender/scene/vectorobject.py +69 -0
- compas_blender/scene/volmeshobject.py +475 -0
- compas_blender/utilities/__init__.py +38 -0
- compas_blender/utilities/drawing.py +768 -0
- compas_ghpython/__init__.py +124 -0
- compas_ghpython/components/Compas_FromJson/code.py +18 -0
- compas_ghpython/components/Compas_Info/code.py +15 -0
- compas_ghpython/components/Compas_RpcCall/code.py +31 -0
- compas_ghpython/components/Compas_ToJson/code.py +19 -0
- compas_ghpython/components/Compas_ToRhinoGeometry/code.py +15 -0
- compas_ghpython/components/__init__.py +99 -0
- compas_ghpython/install.py +29 -0
- compas_ghpython/scene/__init__.py +115 -0
- compas_ghpython/scene/boxobject.py +40 -0
- compas_ghpython/scene/brepobject.py +40 -0
- compas_ghpython/scene/capsuleobject.py +41 -0
- compas_ghpython/scene/circleobject.py +40 -0
- compas_ghpython/scene/coneobject.py +40 -0
- compas_ghpython/scene/curveobject.py +42 -0
- compas_ghpython/scene/cylinderobject.py +38 -0
- compas_ghpython/scene/ellipseobject.py +40 -0
- compas_ghpython/scene/frameobject.py +67 -0
- compas_ghpython/scene/graphobject.py +77 -0
- compas_ghpython/scene/lineobject.py +39 -0
- compas_ghpython/scene/meshobject.py +137 -0
- compas_ghpython/scene/planeobject.py +61 -0
- compas_ghpython/scene/pointobject.py +38 -0
- compas_ghpython/scene/polygonobject.py +48 -0
- compas_ghpython/scene/polyhedronobject.py +48 -0
- compas_ghpython/scene/polylineobject.py +39 -0
- compas_ghpython/scene/sceneobject.py +12 -0
- compas_ghpython/scene/sphereobject.py +39 -0
- compas_ghpython/scene/surfaceobject.py +42 -0
- compas_ghpython/scene/torusobject.py +39 -0
- compas_ghpython/scene/vectorobject.py +51 -0
- compas_ghpython/scene/volmeshobject.py +154 -0
- compas_ghpython/sets.py +83 -0
- compas_ghpython/timer.py +36 -0
- compas_ghpython/uninstall.py +31 -0
- compas_ghpython/utilities/__init__.py +33 -0
- compas_ghpython/utilities/drawing.py +457 -0
- compas_rhino/__init__.py +607 -0
- compas_rhino/conduits/__init__.py +16 -0
- compas_rhino/conduits/base.py +121 -0
- compas_rhino/conduits/faces.py +91 -0
- compas_rhino/conduits/labels.py +102 -0
- compas_rhino/conduits/lines.py +109 -0
- compas_rhino/conduits/points.py +111 -0
- compas_rhino/conversions/__init__.py +168 -0
- compas_rhino/conversions/breps.py +122 -0
- compas_rhino/conversions/curves.py +453 -0
- compas_rhino/conversions/docobjects.py +0 -0
- compas_rhino/conversions/exceptions.py +7 -0
- compas_rhino/conversions/extrusions.py +80 -0
- compas_rhino/conversions/geometry.py +187 -0
- compas_rhino/conversions/meshes.py +281 -0
- compas_rhino/conversions/shapes.py +291 -0
- compas_rhino/conversions/surfaces.py +355 -0
- compas_rhino/conversions/transformations.py +45 -0
- compas_rhino/geometry/__init__.py +44 -0
- compas_rhino/geometry/booleans.py +118 -0
- compas_rhino/geometry/brep/__init__.py +40 -0
- compas_rhino/geometry/brep/brep.py +554 -0
- compas_rhino/geometry/brep/builder.py +184 -0
- compas_rhino/geometry/brep/edge.py +202 -0
- compas_rhino/geometry/brep/face.py +285 -0
- compas_rhino/geometry/brep/loop.py +129 -0
- compas_rhino/geometry/brep/trim.py +99 -0
- compas_rhino/geometry/brep/vertex.py +76 -0
- compas_rhino/geometry/curves/__init__.py +43 -0
- compas_rhino/geometry/curves/curve.py +382 -0
- compas_rhino/geometry/curves/nurbs.py +298 -0
- compas_rhino/geometry/surfaces/__init__.py +50 -0
- compas_rhino/geometry/surfaces/nurbs.py +370 -0
- compas_rhino/geometry/surfaces/surface.py +407 -0
- compas_rhino/geometry/trimesh_curvature.py +344 -0
- compas_rhino/geometry/trimesh_slicing.py +65 -0
- compas_rhino/install.py +382 -0
- compas_rhino/install_plugin.py +169 -0
- compas_rhino/install_with_pip.py +20 -0
- compas_rhino/layers.py +347 -0
- compas_rhino/objects.py +1141 -0
- compas_rhino/print_python_path.py +18 -0
- compas_rhino/scene/__init__.py +123 -0
- compas_rhino/scene/boxobject.py +44 -0
- compas_rhino/scene/brepobject.py +41 -0
- compas_rhino/scene/capsuleobject.py +45 -0
- compas_rhino/scene/circleobject.py +43 -0
- compas_rhino/scene/coneobject.py +43 -0
- compas_rhino/scene/curveobject.py +43 -0
- compas_rhino/scene/cylinderobject.py +43 -0
- compas_rhino/scene/ellipseobject.py +44 -0
- compas_rhino/scene/frameobject.py +99 -0
- compas_rhino/scene/graphobject.py +364 -0
- compas_rhino/scene/helpers.py +33 -0
- compas_rhino/scene/lineobject.py +43 -0
- compas_rhino/scene/meshobject.py +673 -0
- compas_rhino/scene/planeobject.py +71 -0
- compas_rhino/scene/pointobject.py +43 -0
- compas_rhino/scene/polygonobject.py +45 -0
- compas_rhino/scene/polyhedronobject.py +45 -0
- compas_rhino/scene/polylineobject.py +43 -0
- compas_rhino/scene/sceneobject.py +123 -0
- compas_rhino/scene/sphereobject.py +43 -0
- compas_rhino/scene/surfaceobject.py +42 -0
- compas_rhino/scene/torusobject.py +43 -0
- compas_rhino/scene/vectorobject.py +49 -0
- compas_rhino/scene/volmeshobject.py +518 -0
- compas_rhino/ui.py +114 -0
- compas_rhino/uninstall.py +243 -0
- compas_rhino/uninstall_plugin.py +91 -0
- compas_rhino/utilities/__init__.py +37 -0
- compas_rhino/utilities/constructors.py +71 -0
- compas_rhino/utilities/drawing.py +1081 -0
|
@@ -0,0 +1,650 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from math import sqrt
|
|
6
|
+
|
|
7
|
+
from compas.geometry import Line
|
|
8
|
+
from compas.geometry import Point
|
|
9
|
+
from compas.geometry import Polygon
|
|
10
|
+
from compas.geometry import transform_points
|
|
11
|
+
from compas.itertools import pairwise
|
|
12
|
+
|
|
13
|
+
from .geometry import Geometry
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
def tetrahedron():
|
|
17
|
+
faces = [[0, 1, 2], [0, 3, 1], [0, 2, 3], [1, 3, 2]]
|
|
18
|
+
vertices = []
|
|
19
|
+
L = 2.0
|
|
20
|
+
r = L * sqrt(6) / 4.0
|
|
21
|
+
c = 1.0 / r
|
|
22
|
+
for i in (-1, 1):
|
|
23
|
+
i *= c
|
|
24
|
+
vertices.append([i, 0.0, -c / sqrt(2)])
|
|
25
|
+
vertices.append([0.0, i, +c / sqrt(2)])
|
|
26
|
+
return vertices, faces
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
def hexahedron():
|
|
30
|
+
faces = [
|
|
31
|
+
[0, 3, 2, 1],
|
|
32
|
+
[0, 1, 7, 6],
|
|
33
|
+
[0, 6, 5, 3],
|
|
34
|
+
[4, 2, 3, 5],
|
|
35
|
+
[4, 7, 1, 2],
|
|
36
|
+
[4, 5, 6, 7],
|
|
37
|
+
]
|
|
38
|
+
vertices = []
|
|
39
|
+
L = 1.0
|
|
40
|
+
r = L * sqrt(3) / 2.0
|
|
41
|
+
c = 1.0 / r
|
|
42
|
+
for i in -1.0, +1.0:
|
|
43
|
+
i *= c
|
|
44
|
+
vertices.append([+i, +i, +i])
|
|
45
|
+
vertices.append([-i, +i, +i])
|
|
46
|
+
vertices.append([-i, -i, +i])
|
|
47
|
+
vertices.append([+i, -i, +i])
|
|
48
|
+
return vertices, faces
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
def octahedron():
|
|
52
|
+
faces = [
|
|
53
|
+
[0, 1, 5],
|
|
54
|
+
[1, 3, 5],
|
|
55
|
+
[3, 4, 5],
|
|
56
|
+
[0, 5, 4],
|
|
57
|
+
[0, 2, 1],
|
|
58
|
+
[1, 2, 3],
|
|
59
|
+
[3, 2, 4],
|
|
60
|
+
[0, 4, 2],
|
|
61
|
+
]
|
|
62
|
+
vertices = []
|
|
63
|
+
L = sqrt(2)
|
|
64
|
+
r = L * sqrt(2) / 2.0
|
|
65
|
+
c = 1.0 / r
|
|
66
|
+
for i in -1.0, +1.0:
|
|
67
|
+
i *= c
|
|
68
|
+
vertices.append([i, 0.0, 0.0])
|
|
69
|
+
vertices.append([0.0, i, 0.0])
|
|
70
|
+
vertices.append([0.0, 0.0, i])
|
|
71
|
+
return vertices, faces
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
def dodecahedron():
|
|
75
|
+
phi = 0.5 * (1 + sqrt(5))
|
|
76
|
+
vertices = []
|
|
77
|
+
faces = [
|
|
78
|
+
[0, 13, 11, 1, 3],
|
|
79
|
+
[0, 3, 2, 8, 10],
|
|
80
|
+
[0, 10, 18, 12, 13],
|
|
81
|
+
[1, 4, 7, 2, 3],
|
|
82
|
+
[1, 11, 14, 5, 4],
|
|
83
|
+
[2, 7, 9, 6, 8],
|
|
84
|
+
[5, 15, 9, 7, 4],
|
|
85
|
+
[5, 14, 17, 19, 15],
|
|
86
|
+
[6, 16, 18, 10, 8],
|
|
87
|
+
[6, 9, 15, 19, 16],
|
|
88
|
+
[12, 17, 14, 11, 13],
|
|
89
|
+
[12, 18, 16, 19, 17],
|
|
90
|
+
]
|
|
91
|
+
L = 2.0 / phi
|
|
92
|
+
r = L * phi * sqrt(3) / 2.0
|
|
93
|
+
c = 1.0 / r
|
|
94
|
+
for i in -1, +1:
|
|
95
|
+
i *= c
|
|
96
|
+
for j in -1, +1:
|
|
97
|
+
j *= c
|
|
98
|
+
vertices.append([0, i / phi, j * phi])
|
|
99
|
+
vertices.append([i / phi, j * phi, 0])
|
|
100
|
+
vertices.append([i * phi, 0, j / phi])
|
|
101
|
+
for k in -1, +1:
|
|
102
|
+
k *= c
|
|
103
|
+
vertices.append([i * 1.0, j * 1.0, k * 1.0])
|
|
104
|
+
return vertices, faces
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
def icosahedron():
|
|
108
|
+
phi = (1 + sqrt(5)) / 2.0
|
|
109
|
+
vertices = [
|
|
110
|
+
(-1, phi, 0),
|
|
111
|
+
(1, phi, 0),
|
|
112
|
+
(-1, -phi, 0),
|
|
113
|
+
(1, -phi, 0),
|
|
114
|
+
(0, -1, phi),
|
|
115
|
+
(0, 1, phi),
|
|
116
|
+
(0, -1, -phi),
|
|
117
|
+
(0, 1, -phi),
|
|
118
|
+
(phi, 0, -1),
|
|
119
|
+
(phi, 0, 1),
|
|
120
|
+
(-phi, 0, -1),
|
|
121
|
+
(-phi, 0, 1),
|
|
122
|
+
]
|
|
123
|
+
faces = [
|
|
124
|
+
# 5 faces around point 0
|
|
125
|
+
[0, 11, 5],
|
|
126
|
+
[0, 5, 1],
|
|
127
|
+
[0, 1, 7],
|
|
128
|
+
[0, 7, 10],
|
|
129
|
+
[0, 10, 11],
|
|
130
|
+
# Adjacent faces
|
|
131
|
+
[1, 5, 9],
|
|
132
|
+
[5, 11, 4],
|
|
133
|
+
[11, 10, 2],
|
|
134
|
+
[10, 7, 6],
|
|
135
|
+
[7, 1, 8],
|
|
136
|
+
# 5 faces around 3
|
|
137
|
+
[3, 9, 4],
|
|
138
|
+
[3, 4, 2],
|
|
139
|
+
[3, 2, 6],
|
|
140
|
+
[3, 6, 8],
|
|
141
|
+
[3, 8, 9],
|
|
142
|
+
# Adjacent faces
|
|
143
|
+
[4, 9, 5],
|
|
144
|
+
[2, 4, 11],
|
|
145
|
+
[6, 2, 10],
|
|
146
|
+
[8, 6, 7],
|
|
147
|
+
[9, 8, 1],
|
|
148
|
+
]
|
|
149
|
+
return vertices, faces
|
|
150
|
+
|
|
151
|
+
|
|
152
|
+
class Polyhedron(Geometry):
|
|
153
|
+
"""A polyhedron is a geometric object defined by its vertices and faces.
|
|
154
|
+
|
|
155
|
+
Parameters
|
|
156
|
+
----------
|
|
157
|
+
vertices : list[[float, float, float] | :class:`compas.geometry.Point`]
|
|
158
|
+
The point locations of the vertices of the polyhedron.
|
|
159
|
+
faces : list[list[int]]
|
|
160
|
+
The faces as a list of index lists.
|
|
161
|
+
name : str, optional
|
|
162
|
+
The name of the polyhedron.
|
|
163
|
+
|
|
164
|
+
Attributes
|
|
165
|
+
----------
|
|
166
|
+
vertices : list[list[float]]
|
|
167
|
+
The XYZ coordinates of the vertices of the polyhedron.
|
|
168
|
+
faces : list[list[int]]
|
|
169
|
+
The faces of the polyhedron defined as lists of vertex indices.
|
|
170
|
+
edges : list[tuple[int, int]], read-only
|
|
171
|
+
The edges of the polyhedron as vertex index pairs.
|
|
172
|
+
|
|
173
|
+
"""
|
|
174
|
+
|
|
175
|
+
DATASCHEMA = {
|
|
176
|
+
"type": "object",
|
|
177
|
+
"properties": {
|
|
178
|
+
"vertices": {
|
|
179
|
+
"type": "array",
|
|
180
|
+
"minItems": 4,
|
|
181
|
+
"items": {
|
|
182
|
+
"type": "array",
|
|
183
|
+
"minItems": 3,
|
|
184
|
+
"maxItems": 3,
|
|
185
|
+
"items": {"type": "number"},
|
|
186
|
+
},
|
|
187
|
+
},
|
|
188
|
+
"faces": {
|
|
189
|
+
"type": "array",
|
|
190
|
+
"minItems": 4,
|
|
191
|
+
"items": {
|
|
192
|
+
"type": "array",
|
|
193
|
+
"minItems": 3,
|
|
194
|
+
"items": {"type": "integer", "minimum": 0},
|
|
195
|
+
},
|
|
196
|
+
},
|
|
197
|
+
},
|
|
198
|
+
"required": ["vertices", "faces"],
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
@property
|
|
202
|
+
def __data__(self):
|
|
203
|
+
return {"vertices": self.vertices, "faces": self.faces}
|
|
204
|
+
|
|
205
|
+
def __init__(self, vertices, faces, name=None):
|
|
206
|
+
super(Polyhedron, self).__init__(name=name)
|
|
207
|
+
self._vertices = None
|
|
208
|
+
self._faces = None
|
|
209
|
+
self.vertices = vertices
|
|
210
|
+
self.faces = faces
|
|
211
|
+
|
|
212
|
+
def __repr__(self):
|
|
213
|
+
return "{0}(vertices={1!r}, faces={2!r})".format(
|
|
214
|
+
type(self).__name__,
|
|
215
|
+
self.vertices,
|
|
216
|
+
self.faces,
|
|
217
|
+
)
|
|
218
|
+
|
|
219
|
+
def __len__(self):
|
|
220
|
+
return 2
|
|
221
|
+
|
|
222
|
+
def __getitem__(self, key):
|
|
223
|
+
if key == 0:
|
|
224
|
+
return self.vertices
|
|
225
|
+
elif key == 1:
|
|
226
|
+
return self.faces
|
|
227
|
+
else:
|
|
228
|
+
raise KeyError
|
|
229
|
+
|
|
230
|
+
def __setitem__(self, key, value):
|
|
231
|
+
if key == 0:
|
|
232
|
+
self.vertices = value
|
|
233
|
+
elif key == 1:
|
|
234
|
+
self.faces = value
|
|
235
|
+
else:
|
|
236
|
+
raise KeyError
|
|
237
|
+
|
|
238
|
+
def __iter__(self):
|
|
239
|
+
return iter([self.vertices, self.faces])
|
|
240
|
+
|
|
241
|
+
def __add__(self, other):
|
|
242
|
+
from compas.geometry import boolean_union_mesh_mesh
|
|
243
|
+
|
|
244
|
+
A = self.vertices, self.faces
|
|
245
|
+
B = other.vertices, other.faces
|
|
246
|
+
V, F = boolean_union_mesh_mesh(A, B) # type: ignore
|
|
247
|
+
return Polyhedron(V, F)
|
|
248
|
+
|
|
249
|
+
def __sub__(self, other):
|
|
250
|
+
from compas.geometry import boolean_difference_mesh_mesh
|
|
251
|
+
|
|
252
|
+
A = self.vertices, self.faces
|
|
253
|
+
B = other.vertices, other.faces
|
|
254
|
+
V, F = boolean_difference_mesh_mesh(A, B) # type: ignore
|
|
255
|
+
return Polyhedron(V, F)
|
|
256
|
+
|
|
257
|
+
def __and__(self, other):
|
|
258
|
+
from compas.geometry import boolean_intersection_mesh_mesh
|
|
259
|
+
|
|
260
|
+
A = self.vertices, self.faces
|
|
261
|
+
B = other.vertices, other.faces
|
|
262
|
+
V, F = boolean_intersection_mesh_mesh(A, B) # type: ignore
|
|
263
|
+
return Polyhedron(V, F)
|
|
264
|
+
|
|
265
|
+
def __or__(self, other):
|
|
266
|
+
return self.__add__(other)
|
|
267
|
+
|
|
268
|
+
# ==========================================================================
|
|
269
|
+
# Properties
|
|
270
|
+
# ==========================================================================
|
|
271
|
+
|
|
272
|
+
@property
|
|
273
|
+
def vertices(self):
|
|
274
|
+
if not self._vertices:
|
|
275
|
+
self._vertices = []
|
|
276
|
+
return self._vertices
|
|
277
|
+
|
|
278
|
+
@vertices.setter
|
|
279
|
+
def vertices(self, vertices):
|
|
280
|
+
self._vertices = vertices
|
|
281
|
+
|
|
282
|
+
@property
|
|
283
|
+
def faces(self):
|
|
284
|
+
if not self._faces:
|
|
285
|
+
self._faces = []
|
|
286
|
+
return self._faces
|
|
287
|
+
|
|
288
|
+
@faces.setter
|
|
289
|
+
def faces(self, faces):
|
|
290
|
+
self._faces = faces
|
|
291
|
+
|
|
292
|
+
@property
|
|
293
|
+
def edges(self):
|
|
294
|
+
seen = set()
|
|
295
|
+
for face in self.faces:
|
|
296
|
+
for u, v in pairwise(face + face[:1]):
|
|
297
|
+
if (u, v) not in seen:
|
|
298
|
+
seen.add((u, v))
|
|
299
|
+
seen.add((v, u))
|
|
300
|
+
yield u, v
|
|
301
|
+
|
|
302
|
+
@property
|
|
303
|
+
def points(self):
|
|
304
|
+
return [Point(x, y, z) for x, y, z in self.vertices]
|
|
305
|
+
|
|
306
|
+
@property
|
|
307
|
+
def lines(self):
|
|
308
|
+
return [Line(self.vertices[u], self.vertices[v]) for u, v in self.edges]
|
|
309
|
+
|
|
310
|
+
@property
|
|
311
|
+
def polygons(self):
|
|
312
|
+
return [Polygon([self.vertices[index] for index in face]) for face in self.faces]
|
|
313
|
+
|
|
314
|
+
@property
|
|
315
|
+
def planes(self):
|
|
316
|
+
return [polygon.plane for polygon in self.polygons]
|
|
317
|
+
|
|
318
|
+
@property
|
|
319
|
+
def is_convex(self):
|
|
320
|
+
for plane in self.planes:
|
|
321
|
+
for vertex in self.vertices:
|
|
322
|
+
if plane.normal.dot(plane.point - vertex) < 0:
|
|
323
|
+
return False
|
|
324
|
+
return True
|
|
325
|
+
|
|
326
|
+
@property
|
|
327
|
+
def area(self):
|
|
328
|
+
"""Compute the area of the polyhedron.
|
|
329
|
+
|
|
330
|
+
Returns
|
|
331
|
+
-------
|
|
332
|
+
float
|
|
333
|
+
The area of the polyhedron.
|
|
334
|
+
|
|
335
|
+
"""
|
|
336
|
+
return sum(polygon.area for polygon in self.polygons)
|
|
337
|
+
|
|
338
|
+
@property
|
|
339
|
+
def volume(self):
|
|
340
|
+
"""Compute the volume of the polyhedron."""
|
|
341
|
+
raise NotImplementedError
|
|
342
|
+
|
|
343
|
+
# ==========================================================================
|
|
344
|
+
# Constructors
|
|
345
|
+
# ==========================================================================
|
|
346
|
+
|
|
347
|
+
@classmethod
|
|
348
|
+
def from_platonicsolid(cls, f):
|
|
349
|
+
"""Construct a polyhedron from one of the platonic solids.
|
|
350
|
+
|
|
351
|
+
A Platonic solid is a regular, convex polyhedron. It is constructed by
|
|
352
|
+
congruent regular polygonal faces with the same number of faces meeting
|
|
353
|
+
at each vertex [1]_.
|
|
354
|
+
|
|
355
|
+
Parameters
|
|
356
|
+
----------
|
|
357
|
+
f : {4, 6, 8, 12, 20}
|
|
358
|
+
|
|
359
|
+
Returns
|
|
360
|
+
-------
|
|
361
|
+
:class:`compas.geometry.Polyhedron`
|
|
362
|
+
The constructed polyhedron.
|
|
363
|
+
|
|
364
|
+
References
|
|
365
|
+
----------
|
|
366
|
+
.. [1] Wikipedia. *Platonic solids*.
|
|
367
|
+
Available at: https://en.wikipedia.org/wiki/Platonic_solid.
|
|
368
|
+
|
|
369
|
+
"""
|
|
370
|
+
if f == 4:
|
|
371
|
+
vertices, faces = tetrahedron()
|
|
372
|
+
elif f == 6:
|
|
373
|
+
vertices, faces = hexahedron()
|
|
374
|
+
elif f == 8:
|
|
375
|
+
vertices, faces = octahedron()
|
|
376
|
+
elif f == 12:
|
|
377
|
+
vertices, faces = dodecahedron()
|
|
378
|
+
elif f == 20:
|
|
379
|
+
vertices, faces = icosahedron()
|
|
380
|
+
else:
|
|
381
|
+
raise ValueError("The number of sides of a platonic solid must be one of: 4, 6, 8, 12, 20.")
|
|
382
|
+
solid = cls(vertices, faces)
|
|
383
|
+
return solid
|
|
384
|
+
|
|
385
|
+
@classmethod
|
|
386
|
+
def from_halfspaces(cls, halfspaces, interior_point):
|
|
387
|
+
"""Construct a polyhedron from its half-spaces and one interior point.
|
|
388
|
+
|
|
389
|
+
Parameters
|
|
390
|
+
----------
|
|
391
|
+
halfspaces : array-like
|
|
392
|
+
The coefficients of the hgalfspace equations in normal form.
|
|
393
|
+
interior_point : array-like
|
|
394
|
+
A point on the interior.
|
|
395
|
+
|
|
396
|
+
Returns
|
|
397
|
+
-------
|
|
398
|
+
:class:`compas.geometry.Polyhedron`
|
|
399
|
+
|
|
400
|
+
Examples
|
|
401
|
+
--------
|
|
402
|
+
>>> from compas.geometry import Plane
|
|
403
|
+
>>> left = Plane([-1, 0, 0], [-1, 0, 0])
|
|
404
|
+
>>> right = Plane([+1, 0, 0], [+1, 0, 0])
|
|
405
|
+
>>> top = Plane([0, 0, +1], [0, 0, +1])
|
|
406
|
+
>>> bottom = Plane([0, 0, -1], [0, 0, -1])
|
|
407
|
+
>>> front = Plane([0, -1, 0], [0, -1, 0])
|
|
408
|
+
>>> back = Plane([0, +1, 0], [0, +1, 0])
|
|
409
|
+
|
|
410
|
+
>>> import numpy as np
|
|
411
|
+
>>> halfspaces = np.array([left.abcd, right.abcd, top.abcd, bottom.abcd, front.abcd, back.abcd], dtype=float)
|
|
412
|
+
>>> interior = np.array([0, 0, 0], dtype=float)
|
|
413
|
+
|
|
414
|
+
>>> p = Polyhedron.from_halfspaces(halfspaces, interior)
|
|
415
|
+
|
|
416
|
+
"""
|
|
417
|
+
from itertools import combinations
|
|
418
|
+
|
|
419
|
+
from numpy import asarray
|
|
420
|
+
from scipy.spatial import ConvexHull # type: ignore
|
|
421
|
+
from scipy.spatial import HalfspaceIntersection # type: ignore
|
|
422
|
+
|
|
423
|
+
from compas.datastructures import Mesh
|
|
424
|
+
from compas.geometry import cross_vectors
|
|
425
|
+
from compas.geometry import dot_vectors
|
|
426
|
+
from compas.geometry import length_vector
|
|
427
|
+
|
|
428
|
+
halfspaces = asarray(halfspaces, dtype=float)
|
|
429
|
+
interior_point = asarray(interior_point, dtype=float)
|
|
430
|
+
hsi = HalfspaceIntersection(halfspaces, interior_point)
|
|
431
|
+
hull = ConvexHull(hsi.intersections)
|
|
432
|
+
mesh = Mesh.from_vertices_and_faces([hsi.intersections[i] for i in hull.vertices], hull.simplices)
|
|
433
|
+
mesh.unify_cycles()
|
|
434
|
+
to_merge = []
|
|
435
|
+
for a, b in combinations(mesh.faces(), 2):
|
|
436
|
+
na = mesh.face_normal(a)
|
|
437
|
+
nb = mesh.face_normal(b)
|
|
438
|
+
if dot_vectors(na, nb) >= 1:
|
|
439
|
+
if length_vector(cross_vectors(na, nb)) < 1e-6:
|
|
440
|
+
to_merge.append([a, b])
|
|
441
|
+
for faces in to_merge:
|
|
442
|
+
mesh.merge_faces(faces)
|
|
443
|
+
vertices, faces = mesh.to_vertices_and_faces()
|
|
444
|
+
return cls(vertices, faces)
|
|
445
|
+
|
|
446
|
+
@classmethod
|
|
447
|
+
def from_planes(cls, planes):
|
|
448
|
+
"""Construct a polyhedron from intersecting planes.
|
|
449
|
+
|
|
450
|
+
Parameters
|
|
451
|
+
----------
|
|
452
|
+
planes : list[[point, normal] | :class:`compas.geometry.Plane`]
|
|
453
|
+
|
|
454
|
+
Returns
|
|
455
|
+
-------
|
|
456
|
+
:class:`compas.geometry.Polyhedron`
|
|
457
|
+
|
|
458
|
+
Examples
|
|
459
|
+
--------
|
|
460
|
+
>>> from compas.geometry import Plane
|
|
461
|
+
>>> left = Plane([-1, 0, 0], [-1, 0, 0])
|
|
462
|
+
>>> right = Plane([+1, 0, 0], [+1, 0, 0])
|
|
463
|
+
>>> top = Plane([0, 0, +1], [0, 0, +1])
|
|
464
|
+
>>> bottom = Plane([0, 0, -1], [0, 0, -1])
|
|
465
|
+
>>> front = Plane([0, -1, 0], [0, -1, 0])
|
|
466
|
+
>>> back = Plane([0, +1, 0], [0, +1, 0])
|
|
467
|
+
>>> p = Polyhedron.from_planes([left, right, top, bottom, front, back])
|
|
468
|
+
|
|
469
|
+
"""
|
|
470
|
+
from compas.geometry import Plane
|
|
471
|
+
from compas.geometry import centroid_points
|
|
472
|
+
|
|
473
|
+
planes = [Plane(point, normal) for point, normal in planes]
|
|
474
|
+
interior = centroid_points([plane.point for plane in planes])
|
|
475
|
+
return cls.from_halfspaces([plane.abcd for plane in planes], interior)
|
|
476
|
+
|
|
477
|
+
@classmethod
|
|
478
|
+
def from_convex_hull(cls, points):
|
|
479
|
+
"""Construct a polyhedron from the convex hull of a set of points.
|
|
480
|
+
|
|
481
|
+
Parameters
|
|
482
|
+
----------
|
|
483
|
+
points : list[point]
|
|
484
|
+
The XYZ coordinates of the points.
|
|
485
|
+
|
|
486
|
+
Returns
|
|
487
|
+
-------
|
|
488
|
+
:class:`compas.geometry.Polyhedron`
|
|
489
|
+
|
|
490
|
+
Examples
|
|
491
|
+
--------
|
|
492
|
+
>>> from compas.geometry import Polyhedron
|
|
493
|
+
>>> points = [[0, 0, 0], [1, 0, 0], [0, 1, 0]]
|
|
494
|
+
>>> p = Polyhedron.from_convex_hull(points)
|
|
495
|
+
|
|
496
|
+
"""
|
|
497
|
+
from compas.geometry import convex_hull_numpy
|
|
498
|
+
|
|
499
|
+
vertices, faces = convex_hull_numpy(points)
|
|
500
|
+
return cls(vertices, faces)
|
|
501
|
+
|
|
502
|
+
# =============================================================================
|
|
503
|
+
# Conversions
|
|
504
|
+
# =============================================================================
|
|
505
|
+
|
|
506
|
+
def to_vertices_and_faces(self):
|
|
507
|
+
"""Returns a list of vertices and faces.
|
|
508
|
+
|
|
509
|
+
Returns
|
|
510
|
+
-------
|
|
511
|
+
tuple[list[float], list[int]
|
|
512
|
+
A list of vertices and a list of faces.
|
|
513
|
+
|
|
514
|
+
"""
|
|
515
|
+
return self.vertices, self.faces
|
|
516
|
+
|
|
517
|
+
def to_mesh(self):
|
|
518
|
+
"""Returns a mesh representation of the polyhedron.
|
|
519
|
+
|
|
520
|
+
Returns
|
|
521
|
+
-------
|
|
522
|
+
:class:`compas.datastructures.Mesh`
|
|
523
|
+
A mesh object.
|
|
524
|
+
|
|
525
|
+
"""
|
|
526
|
+
from compas.datastructures import Mesh
|
|
527
|
+
|
|
528
|
+
return Mesh.from_vertices_and_faces(self.vertices, self.faces)
|
|
529
|
+
|
|
530
|
+
# =============================================================================
|
|
531
|
+
# Transformations
|
|
532
|
+
# =============================================================================
|
|
533
|
+
|
|
534
|
+
def transform(self, transformation):
|
|
535
|
+
"""Transform the polyhedron.
|
|
536
|
+
|
|
537
|
+
Parameters
|
|
538
|
+
----------
|
|
539
|
+
transformation : :class:`compas.geometry.Transformation`
|
|
540
|
+
|
|
541
|
+
Returns
|
|
542
|
+
-------
|
|
543
|
+
None
|
|
544
|
+
|
|
545
|
+
"""
|
|
546
|
+
self.vertices = transform_points(self.vertices, transformation)
|
|
547
|
+
|
|
548
|
+
# =============================================================================
|
|
549
|
+
# Methods
|
|
550
|
+
# =============================================================================
|
|
551
|
+
|
|
552
|
+
def is_closed(self):
|
|
553
|
+
"""Verify that the polyhedron forms a closed surface.
|
|
554
|
+
|
|
555
|
+
Returns
|
|
556
|
+
-------
|
|
557
|
+
bool
|
|
558
|
+
True if the polyhedron is closed.
|
|
559
|
+
False otherwise.
|
|
560
|
+
|
|
561
|
+
"""
|
|
562
|
+
mesh = self.to_mesh()
|
|
563
|
+
return mesh.is_closed()
|
|
564
|
+
|
|
565
|
+
def boolean_union(self, other):
|
|
566
|
+
"""Compute the boolean union of this polyhedron and another.
|
|
567
|
+
|
|
568
|
+
Parameters
|
|
569
|
+
----------
|
|
570
|
+
other : :class:`compas.geometry.Polyhedron`
|
|
571
|
+
The polyhedron to add.
|
|
572
|
+
|
|
573
|
+
Returns
|
|
574
|
+
-------
|
|
575
|
+
:class:`compas.geometry.Polyhedron`
|
|
576
|
+
The resulting polyhedron.
|
|
577
|
+
|
|
578
|
+
Examples
|
|
579
|
+
--------
|
|
580
|
+
>>> from compas.geometry import Box, Sphere
|
|
581
|
+
>>> A = Box(size=2).to_polyhedron()
|
|
582
|
+
>>> B = Sphere(point=[1, 1, 1], radius=1.0).to_polyhedron(u=16)
|
|
583
|
+
>>> C = A.boolean_union(B)
|
|
584
|
+
|
|
585
|
+
"""
|
|
586
|
+
from compas.geometry import boolean_union_mesh_mesh
|
|
587
|
+
|
|
588
|
+
A = self.vertices, self.faces
|
|
589
|
+
B = other.vertices, other.faces
|
|
590
|
+
V, F = boolean_union_mesh_mesh(A, B) # type: ignore
|
|
591
|
+
|
|
592
|
+
return Polyhedron(V, F)
|
|
593
|
+
|
|
594
|
+
def boolean_difference(self, other):
|
|
595
|
+
"""Compute the boolean difference of this polyhedron and another.
|
|
596
|
+
|
|
597
|
+
Parameters
|
|
598
|
+
----------
|
|
599
|
+
other : :class:`compas.geometry.Polyhedron`
|
|
600
|
+
The polyhedron to subtract.
|
|
601
|
+
|
|
602
|
+
Returns
|
|
603
|
+
-------
|
|
604
|
+
:class:`compas.geometry.Polyhedron`
|
|
605
|
+
The resulting polyhedron.
|
|
606
|
+
|
|
607
|
+
Examples
|
|
608
|
+
--------
|
|
609
|
+
>>> from compas.geometry import Box, Sphere
|
|
610
|
+
>>> A = Box(size=2).to_polyhedron()
|
|
611
|
+
>>> B = Sphere(point=[1, 1, 1], radius=1.0).to_polyhedron(u=16)
|
|
612
|
+
>>> C = A.boolean_difference(B)
|
|
613
|
+
|
|
614
|
+
"""
|
|
615
|
+
from compas.geometry import boolean_difference_mesh_mesh
|
|
616
|
+
|
|
617
|
+
A = self.vertices, self.faces
|
|
618
|
+
B = other.vertices, other.faces
|
|
619
|
+
V, F = boolean_difference_mesh_mesh(A, B) # type: ignore
|
|
620
|
+
|
|
621
|
+
return Polyhedron(V, F)
|
|
622
|
+
|
|
623
|
+
def boolean_intersection(self, other):
|
|
624
|
+
"""Compute the boolean intersection of this polyhedron and another.
|
|
625
|
+
|
|
626
|
+
Parameters
|
|
627
|
+
----------
|
|
628
|
+
other : :class:`compas.geometry.Polyhedron`
|
|
629
|
+
The polyhedron to intersect with.
|
|
630
|
+
|
|
631
|
+
Returns
|
|
632
|
+
-------
|
|
633
|
+
:class:`compas.geometry.Polyhedron`
|
|
634
|
+
The resulting polyhedron.
|
|
635
|
+
|
|
636
|
+
Examples
|
|
637
|
+
--------
|
|
638
|
+
>>> from compas.geometry import Box, Sphere
|
|
639
|
+
>>> A = Box(size=2).to_polyhedron()
|
|
640
|
+
>>> B = Sphere(point=[1, 1, 1], radius=1.0).to_polyhedron(u=16)
|
|
641
|
+
>>> C = A.boolean_intersection(B)
|
|
642
|
+
|
|
643
|
+
"""
|
|
644
|
+
from compas.geometry import boolean_intersection_mesh_mesh
|
|
645
|
+
|
|
646
|
+
A = self.vertices, self.faces
|
|
647
|
+
B = other.vertices, other.faces
|
|
648
|
+
V, F = boolean_intersection_mesh_mesh(A, B) # type: ignore
|
|
649
|
+
|
|
650
|
+
return Polyhedron(V, F)
|