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,573 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from math import fabs
|
|
6
|
+
|
|
7
|
+
from compas.itertools import pairwise
|
|
8
|
+
|
|
9
|
+
from ._algebra import add_vectors
|
|
10
|
+
from ._algebra import cross_vectors
|
|
11
|
+
from ._algebra import cross_vectors_xy
|
|
12
|
+
from ._algebra import dot_vectors
|
|
13
|
+
from ._algebra import length_vector
|
|
14
|
+
from ._algebra import length_vector_xy
|
|
15
|
+
from ._algebra import scale_vector
|
|
16
|
+
from ._algebra import subtract_vectors
|
|
17
|
+
from ._algebra import subtract_vectors_xy
|
|
18
|
+
from ._algebra import sum_vectors
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
def midpoint_point_point(a, b):
|
|
22
|
+
"""Compute the midpoint of two points.
|
|
23
|
+
|
|
24
|
+
Parameters
|
|
25
|
+
----------
|
|
26
|
+
a : [float, float, float] | :class:`compas.geometry.Point`
|
|
27
|
+
XYZ coordinates of the first point.
|
|
28
|
+
b : [float, float, float] | :class:`compas.geometry.Point`
|
|
29
|
+
XYZ coordinates of the second point.
|
|
30
|
+
|
|
31
|
+
Returns
|
|
32
|
+
-------
|
|
33
|
+
[float, float, float]
|
|
34
|
+
XYZ coordinates of the midpoint.
|
|
35
|
+
|
|
36
|
+
"""
|
|
37
|
+
return [0.5 * (a[0] + b[0]), 0.5 * (a[1] + b[1]), 0.5 * (a[2] + b[2])]
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
def midpoint_point_point_xy(a, b):
|
|
41
|
+
"""Compute the midpoint of two points lying in the XY-plane.
|
|
42
|
+
|
|
43
|
+
Parameters
|
|
44
|
+
----------
|
|
45
|
+
a : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
46
|
+
XY(Z) coordinates of the first 2D or 3D point (Z will be ignored).
|
|
47
|
+
b : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
48
|
+
XY(Z) coordinates of the second 2D or 3D point (Z will be ignored).
|
|
49
|
+
|
|
50
|
+
Returns
|
|
51
|
+
-------
|
|
52
|
+
[float, float, 0.0]
|
|
53
|
+
XYZ coordinates of the midpoint in the XY plane.
|
|
54
|
+
"""
|
|
55
|
+
return [0.5 * (a[0] + b[0]), 0.5 * (a[1] + b[1]), 0.0]
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
def midpoint_line(line):
|
|
59
|
+
"""Compute the midpoint of a line defined by two points.
|
|
60
|
+
|
|
61
|
+
Parameters
|
|
62
|
+
----------
|
|
63
|
+
line : [point, point] | :class:`compas.geometry.Line`
|
|
64
|
+
XYZ coordinates of the first point, and XYZ coordinates of the second point.
|
|
65
|
+
|
|
66
|
+
Returns
|
|
67
|
+
-------
|
|
68
|
+
[float, float, float]
|
|
69
|
+
XYZ coordinates of the midpoint.
|
|
70
|
+
|
|
71
|
+
Examples
|
|
72
|
+
--------
|
|
73
|
+
>>> midpoint_line(([0.0, 0.0, 0.0], [1.0, 0.0, 1.0]))
|
|
74
|
+
[0.5, 0.0, 0.5]
|
|
75
|
+
"""
|
|
76
|
+
return midpoint_point_point(*line)
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
def midpoint_line_xy(line):
|
|
80
|
+
"""Compute the midpoint of a line defined by two points.
|
|
81
|
+
|
|
82
|
+
Parameters
|
|
83
|
+
----------
|
|
84
|
+
line : [point, point] | :class:`compas.geometry.Line`
|
|
85
|
+
XYZ coordinates of the first point, and XYZ coordinates of the second point.
|
|
86
|
+
|
|
87
|
+
Returns
|
|
88
|
+
-------
|
|
89
|
+
[float, float, 0.0]
|
|
90
|
+
XYZ coordinates of the midpoint in the XY plane.
|
|
91
|
+
|
|
92
|
+
Examples
|
|
93
|
+
--------
|
|
94
|
+
>>> midpoint_line_xy(([0.0, 0.0, 0.0], [1.0, 0.0, 1.0]))
|
|
95
|
+
[0.5, 0.0, 0.0]
|
|
96
|
+
"""
|
|
97
|
+
return midpoint_point_point_xy(*line)
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
def centroid_points(points):
|
|
101
|
+
"""Compute the centroid of a set of points.
|
|
102
|
+
|
|
103
|
+
Parameters
|
|
104
|
+
----------
|
|
105
|
+
points : sequence[[float, float, float] | :class:`compas.geometry.Point`]
|
|
106
|
+
A sequence of XYZ coordinates.
|
|
107
|
+
|
|
108
|
+
Returns
|
|
109
|
+
-------
|
|
110
|
+
[float, float, float]
|
|
111
|
+
XYZ coordinates of the centroid.
|
|
112
|
+
|
|
113
|
+
Warnings
|
|
114
|
+
--------
|
|
115
|
+
Duplicate points are **NOT** removed. If there are duplicates in the
|
|
116
|
+
sequence, they should be there intentionally.
|
|
117
|
+
|
|
118
|
+
Examples
|
|
119
|
+
--------
|
|
120
|
+
>>> points = [[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0], [0.0, 1.0, 0.0]]
|
|
121
|
+
>>> centroid_points(points)
|
|
122
|
+
[0.5, 0.5, 0.0]
|
|
123
|
+
"""
|
|
124
|
+
p = len(points)
|
|
125
|
+
x, y, z = zip(*points)
|
|
126
|
+
return [sum(x) / p, sum(y) / p, sum(z) / p]
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
def centroid_points_weighted(points, weights):
|
|
130
|
+
"""Compute the weighted centroid of a set of points. The weights can be any between minus and plus infinity.
|
|
131
|
+
|
|
132
|
+
Parameters
|
|
133
|
+
----------
|
|
134
|
+
points : sequence[[float, float, float] | :class:`compas.geometry.Point`]
|
|
135
|
+
A list of point coordinates.
|
|
136
|
+
weights : sequence[float]
|
|
137
|
+
A list of weight floats.
|
|
138
|
+
|
|
139
|
+
Returns
|
|
140
|
+
-------
|
|
141
|
+
[float, float, float]
|
|
142
|
+
The coordinates of the weighted centroid.
|
|
143
|
+
"""
|
|
144
|
+
vectors = [scale_vector(point, weight) for point, weight in zip(points, weights)]
|
|
145
|
+
vector = scale_vector(sum_vectors(vectors), 1.0 / sum(weights))
|
|
146
|
+
return vector
|
|
147
|
+
|
|
148
|
+
|
|
149
|
+
def centroid_points_xy(points):
|
|
150
|
+
"""Compute the centroid of a set of points lying in the XY-plane.
|
|
151
|
+
|
|
152
|
+
Parameters
|
|
153
|
+
----------
|
|
154
|
+
points : sequence[[float, float] or [float, float, float] | :class:`compas.geometry.Point`]
|
|
155
|
+
A sequence of points represented by their XY(Z) coordinates.
|
|
156
|
+
|
|
157
|
+
Returns
|
|
158
|
+
-------
|
|
159
|
+
[float, float, 0.0]
|
|
160
|
+
XYZ coordinates of the centroid in the XY plane.
|
|
161
|
+
|
|
162
|
+
Warnings
|
|
163
|
+
--------
|
|
164
|
+
Duplicate points are **NOT** removed. If there are duplicates in the
|
|
165
|
+
sequence, they should be there intentionally.
|
|
166
|
+
|
|
167
|
+
Examples
|
|
168
|
+
--------
|
|
169
|
+
>>> points = [[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0], [0.0, 1.0, 0.0]]
|
|
170
|
+
>>> centroid_points_xy(points)
|
|
171
|
+
[0.5, 0.5, 0.0]
|
|
172
|
+
"""
|
|
173
|
+
p = len(points)
|
|
174
|
+
x, y = list(zip(*points))[:2]
|
|
175
|
+
return [sum(x) / p, sum(y) / p, 0.0]
|
|
176
|
+
|
|
177
|
+
|
|
178
|
+
def centroid_polygon(polygon):
|
|
179
|
+
r"""Compute the centroid of the surface of a polygon.
|
|
180
|
+
|
|
181
|
+
Parameters
|
|
182
|
+
----------
|
|
183
|
+
polygon : sequence[[float, float, float] | :class:`compas.geometry.Point`]
|
|
184
|
+
A sequence of polygon point coordinates.
|
|
185
|
+
|
|
186
|
+
Returns
|
|
187
|
+
-------
|
|
188
|
+
[float, float, float]
|
|
189
|
+
The XYZ coordinates of the centroid.
|
|
190
|
+
|
|
191
|
+
Raises
|
|
192
|
+
------
|
|
193
|
+
ValueError
|
|
194
|
+
If the polygon has less than three points.
|
|
195
|
+
|
|
196
|
+
Warnings
|
|
197
|
+
--------
|
|
198
|
+
The polygon need not be convex.
|
|
199
|
+
|
|
200
|
+
The polygon need not be flat. However, it is unclear what the meaning of the
|
|
201
|
+
centroid is in that case.
|
|
202
|
+
|
|
203
|
+
The polygon may be self-intersecting. However, it is unclear what the meaning
|
|
204
|
+
of the centroid is in that case.
|
|
205
|
+
|
|
206
|
+
Notes
|
|
207
|
+
-----
|
|
208
|
+
The centroid is the centre of gravity of the polygon surface if mass would be
|
|
209
|
+
uniformly distributed over it.
|
|
210
|
+
|
|
211
|
+
It is calculated by triangulating the polygon surface with respect to the centroid
|
|
212
|
+
of the polygon vertices, and then computing the centroid of the centroids of
|
|
213
|
+
the individual triangles, weighted by the corresponding triangle area in
|
|
214
|
+
proportion to the total surface area.
|
|
215
|
+
|
|
216
|
+
.. math::
|
|
217
|
+
|
|
218
|
+
c_x = \frac{1}{A} \sum_{i=1}^{N} A_i \cdot c_{x,i}
|
|
219
|
+
c_y = \frac{1}{A} \sum_{i=1}^{N} A_i \cdot c_{y,i}
|
|
220
|
+
c_z = \frac{1}{A} \sum_{i=1}^{N} A_i \cdot c_{z,i}
|
|
221
|
+
|
|
222
|
+
Examples
|
|
223
|
+
--------
|
|
224
|
+
>>> polygon = [[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0], [0.0, 1.0, 0.0]]
|
|
225
|
+
>>> centroid_polygon(polygon)
|
|
226
|
+
[0.5, 0.5, 0.0]
|
|
227
|
+
|
|
228
|
+
"""
|
|
229
|
+
p = len(polygon)
|
|
230
|
+
|
|
231
|
+
if p < 3:
|
|
232
|
+
raise ValueError("At least three points required.")
|
|
233
|
+
|
|
234
|
+
if p == 3:
|
|
235
|
+
return centroid_points(polygon)
|
|
236
|
+
|
|
237
|
+
o = centroid_points(polygon)
|
|
238
|
+
a = polygon[-1]
|
|
239
|
+
b = polygon[0]
|
|
240
|
+
oa = subtract_vectors(a, o)
|
|
241
|
+
ob = subtract_vectors(b, o)
|
|
242
|
+
n0 = cross_vectors(oa, ob)
|
|
243
|
+
|
|
244
|
+
x, y, z = centroid_points([o, a, b])
|
|
245
|
+
a2 = length_vector(n0)
|
|
246
|
+
|
|
247
|
+
A2 = a2
|
|
248
|
+
cx = a2 * x
|
|
249
|
+
cy = a2 * y
|
|
250
|
+
cz = a2 * z
|
|
251
|
+
|
|
252
|
+
for i in range(1, p):
|
|
253
|
+
a = b
|
|
254
|
+
b = polygon[i]
|
|
255
|
+
|
|
256
|
+
oa = ob
|
|
257
|
+
ob = subtract_vectors(b, o)
|
|
258
|
+
|
|
259
|
+
n = cross_vectors(oa, ob)
|
|
260
|
+
x, y, z = centroid_points([o, a, b])
|
|
261
|
+
|
|
262
|
+
if dot_vectors(n, n0) > 0:
|
|
263
|
+
a2 = length_vector(n)
|
|
264
|
+
else:
|
|
265
|
+
a2 = -length_vector(n)
|
|
266
|
+
|
|
267
|
+
A2 += a2
|
|
268
|
+
cx += a2 * x
|
|
269
|
+
cy += a2 * y
|
|
270
|
+
cz += a2 * z
|
|
271
|
+
|
|
272
|
+
if A2 == 0:
|
|
273
|
+
return polygon[0]
|
|
274
|
+
|
|
275
|
+
return [cx / A2, cy / A2, cz / A2]
|
|
276
|
+
|
|
277
|
+
|
|
278
|
+
def centroid_polygon_xy(polygon):
|
|
279
|
+
r"""Compute the centroid of the surface of a polygon projected to the XY plane.
|
|
280
|
+
|
|
281
|
+
Parameters
|
|
282
|
+
----------
|
|
283
|
+
polygon : sequence[[float, float] or [float, float, float] | :class:`compas.geometry.Point`]
|
|
284
|
+
A sequence of polygon point XY(Z) coordinates.
|
|
285
|
+
The Z coordinates are ignored.
|
|
286
|
+
|
|
287
|
+
Returns
|
|
288
|
+
-------
|
|
289
|
+
[float, float, 0.0]
|
|
290
|
+
The XYZ coordinates of the centroid in the XY plane.
|
|
291
|
+
|
|
292
|
+
Raises
|
|
293
|
+
------
|
|
294
|
+
ValueError
|
|
295
|
+
If the polygon has less than three points.
|
|
296
|
+
|
|
297
|
+
Warnings
|
|
298
|
+
--------
|
|
299
|
+
The polygon need not be convex.
|
|
300
|
+
|
|
301
|
+
The polygon may be self-intersecting. However, it is unclear what the meaning
|
|
302
|
+
of the centroid is in that case.
|
|
303
|
+
|
|
304
|
+
Notes
|
|
305
|
+
-----
|
|
306
|
+
The centroid is the centre of gravity of the polygon surface if mass would be
|
|
307
|
+
uniformly distributed over it.
|
|
308
|
+
|
|
309
|
+
It is calculated by triangulating the polygon surface with respect to the centroid
|
|
310
|
+
of the polygon vertices, and then computing the centroid of the centroids of
|
|
311
|
+
the individual triangles, weighted by the corresponding triangle area in
|
|
312
|
+
proportion to the total surface area.
|
|
313
|
+
|
|
314
|
+
.. math::
|
|
315
|
+
|
|
316
|
+
c_x = \frac{1}{A} \sum_{i=1}^{N} A_i \cdot c_{x,i}
|
|
317
|
+
c_y = \frac{1}{A} \sum_{i=1}^{N} A_i \cdot c_{y,i}
|
|
318
|
+
c_z = 0
|
|
319
|
+
|
|
320
|
+
Examples
|
|
321
|
+
--------
|
|
322
|
+
>>> polygon = [[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0], [0.0, 1.0, 0.0]]
|
|
323
|
+
>>> centroid_polygon_xy(polygon)
|
|
324
|
+
[0.5, 0.5, 0.0]
|
|
325
|
+
|
|
326
|
+
"""
|
|
327
|
+
p = len(polygon)
|
|
328
|
+
|
|
329
|
+
if p < 3:
|
|
330
|
+
raise ValueError("At least three points required")
|
|
331
|
+
|
|
332
|
+
if p == 3:
|
|
333
|
+
return centroid_points_xy(polygon)
|
|
334
|
+
|
|
335
|
+
o = centroid_points_xy(polygon)
|
|
336
|
+
a = polygon[-1]
|
|
337
|
+
b = polygon[0]
|
|
338
|
+
oa = subtract_vectors_xy(a, o)
|
|
339
|
+
ob = subtract_vectors_xy(b, o)
|
|
340
|
+
n0 = cross_vectors_xy(oa, ob)
|
|
341
|
+
|
|
342
|
+
x, y, z = centroid_points_xy([o, a, b])
|
|
343
|
+
a2 = fabs(n0[2])
|
|
344
|
+
|
|
345
|
+
A2 = a2
|
|
346
|
+
cx = a2 * x
|
|
347
|
+
cy = a2 * y
|
|
348
|
+
|
|
349
|
+
for i in range(1, p):
|
|
350
|
+
a = b
|
|
351
|
+
b = polygon[i]
|
|
352
|
+
|
|
353
|
+
oa = ob
|
|
354
|
+
ob = subtract_vectors_xy(b, o)
|
|
355
|
+
|
|
356
|
+
n = cross_vectors_xy(oa, ob)
|
|
357
|
+
x, y, z = centroid_points_xy([o, a, b])
|
|
358
|
+
|
|
359
|
+
if n[2] * n0[2] > 0:
|
|
360
|
+
a2 = fabs(n[2])
|
|
361
|
+
else:
|
|
362
|
+
a2 = -fabs(n[2])
|
|
363
|
+
|
|
364
|
+
A2 += a2
|
|
365
|
+
cx += a2 * x
|
|
366
|
+
cy += a2 * y
|
|
367
|
+
|
|
368
|
+
return [cx / A2, cy / A2, 0.0]
|
|
369
|
+
|
|
370
|
+
|
|
371
|
+
def centroid_polygon_vertices(polygon):
|
|
372
|
+
"""Compute the centroid of the vertices of a polygon.
|
|
373
|
+
|
|
374
|
+
Parameters
|
|
375
|
+
----------
|
|
376
|
+
polygon : sequence[[float, float, float] | :class:`compas.geometry.Point`]
|
|
377
|
+
A sequence of polygon point coordinates.
|
|
378
|
+
|
|
379
|
+
Returns
|
|
380
|
+
-------
|
|
381
|
+
[float, float, float]
|
|
382
|
+
The XYZ coordinates of the centroid.
|
|
383
|
+
|
|
384
|
+
"""
|
|
385
|
+
return centroid_points(polygon)
|
|
386
|
+
|
|
387
|
+
|
|
388
|
+
def centroid_polygon_vertices_xy(polygon):
|
|
389
|
+
"""Compute the centroid of the vertices of a polygon projected to the XY plane.
|
|
390
|
+
|
|
391
|
+
Parameters
|
|
392
|
+
----------
|
|
393
|
+
polygon : sequence[[float, float] or [float, float, float] | :class:`compas.geometry.Point`]
|
|
394
|
+
A sequence of polygon point coordinates.
|
|
395
|
+
The Z coordinates will be ignored.
|
|
396
|
+
|
|
397
|
+
Returns
|
|
398
|
+
-------
|
|
399
|
+
[float, float, 0.0]
|
|
400
|
+
The XYZ coordinates of the centroid in the XY plane.
|
|
401
|
+
|
|
402
|
+
"""
|
|
403
|
+
return centroid_points_xy(polygon)
|
|
404
|
+
|
|
405
|
+
|
|
406
|
+
def centroid_polygon_edges(polygon):
|
|
407
|
+
"""Compute the centroid of the edges of a polygon.
|
|
408
|
+
|
|
409
|
+
Parameters
|
|
410
|
+
----------
|
|
411
|
+
polygon : sequence[[float, float, float] | :class:`compas.geometry.Point`]
|
|
412
|
+
A sequence of polygon point coordinates.
|
|
413
|
+
|
|
414
|
+
Returns
|
|
415
|
+
-------
|
|
416
|
+
[float, float, float]
|
|
417
|
+
The XYZ coordinates of the centroid.
|
|
418
|
+
|
|
419
|
+
Notes
|
|
420
|
+
-----
|
|
421
|
+
The centroid of the edges is the centroid of the midpoints of the edges, with
|
|
422
|
+
each midpoint weighted by the length of the corresponding edge proportional
|
|
423
|
+
to the total length of the boundary.
|
|
424
|
+
"""
|
|
425
|
+
L = 0
|
|
426
|
+
cx = 0
|
|
427
|
+
cy = 0
|
|
428
|
+
cz = 0
|
|
429
|
+
p = len(polygon)
|
|
430
|
+
for i in range(-1, p - 1):
|
|
431
|
+
p1 = polygon[i]
|
|
432
|
+
p2 = polygon[i + 1]
|
|
433
|
+
d = length_vector(subtract_vectors(p2, p1))
|
|
434
|
+
cx += 0.5 * d * (p1[0] + p2[0])
|
|
435
|
+
cy += 0.5 * d * (p1[1] + p2[1])
|
|
436
|
+
cz += 0.5 * d * (p1[2] + p2[2])
|
|
437
|
+
L += d
|
|
438
|
+
return [cx / L, cy / L, cz / L]
|
|
439
|
+
|
|
440
|
+
|
|
441
|
+
def centroid_polygon_edges_xy(polygon):
|
|
442
|
+
"""Compute the centroid of the edges of a polygon prohected to the XY plane.
|
|
443
|
+
|
|
444
|
+
Parameters
|
|
445
|
+
----------
|
|
446
|
+
polygon : sequence[[float, float] or [float, float, float] | :class:`compas.geometry.Point`]
|
|
447
|
+
A sequence of polygon point coordinates.
|
|
448
|
+
The Z coordinates will be ignored.
|
|
449
|
+
|
|
450
|
+
Returns
|
|
451
|
+
-------
|
|
452
|
+
[float, float, 0.0]
|
|
453
|
+
The XYZ coordinates of the centroid in the XY plane.
|
|
454
|
+
|
|
455
|
+
Notes
|
|
456
|
+
-----
|
|
457
|
+
The centroid of the edges is the centroid of the midpoints of the edges, with
|
|
458
|
+
each midpoint weighted by the length of the corresponding edge proportional
|
|
459
|
+
to the total length of the boundary.
|
|
460
|
+
"""
|
|
461
|
+
L = 0
|
|
462
|
+
cx = 0
|
|
463
|
+
cy = 0
|
|
464
|
+
p = len(polygon)
|
|
465
|
+
for i in range(-1, p - 1):
|
|
466
|
+
p1 = polygon[i]
|
|
467
|
+
p2 = polygon[i + 1]
|
|
468
|
+
d = length_vector_xy(subtract_vectors_xy(p2, p1))
|
|
469
|
+
cx += 0.5 * d * (p1[0] + p2[0])
|
|
470
|
+
cy += 0.5 * d * (p1[1] + p2[1])
|
|
471
|
+
L += d
|
|
472
|
+
return [cx / L, cy / L, 0.0]
|
|
473
|
+
|
|
474
|
+
|
|
475
|
+
def centroid_polyhedron(polyhedron):
|
|
476
|
+
"""Compute the center of mass of a polyhedron.
|
|
477
|
+
|
|
478
|
+
Parameters
|
|
479
|
+
----------
|
|
480
|
+
polyhedron : tuple[sequence[[float, float, float] | :class:`compas.geometry.Point`], sequence[sequence[int]]]
|
|
481
|
+
The coordinates of the vertices,
|
|
482
|
+
and the indices of the vertices forming the faces.
|
|
483
|
+
|
|
484
|
+
Returns
|
|
485
|
+
-------
|
|
486
|
+
[float, float, float]
|
|
487
|
+
XYZ coordinates of the center of mass.
|
|
488
|
+
|
|
489
|
+
Warnings
|
|
490
|
+
--------
|
|
491
|
+
This function assumes that the vertex cycles of the faces are such that the
|
|
492
|
+
face normals are consistently pointing outwards, resulting in a *positive*
|
|
493
|
+
polyhedron.
|
|
494
|
+
|
|
495
|
+
Examples
|
|
496
|
+
--------
|
|
497
|
+
>>> from compas.geometry import Polyhedron
|
|
498
|
+
>>> p = Polyhedron.from_platonicsolid(6)
|
|
499
|
+
>>> centroid_polyhedron(p)
|
|
500
|
+
[0.0, 0.0, 0.0]
|
|
501
|
+
"""
|
|
502
|
+
vertices, faces = polyhedron
|
|
503
|
+
|
|
504
|
+
V = 0
|
|
505
|
+
x = 0.0
|
|
506
|
+
y = 0.0
|
|
507
|
+
z = 0.0
|
|
508
|
+
ex = [1.0, 0.0, 0.0]
|
|
509
|
+
ey = [0.0, 1.0, 0.0]
|
|
510
|
+
ez = [0.0, 0.0, 1.0]
|
|
511
|
+
|
|
512
|
+
for face in faces:
|
|
513
|
+
if len(face) == 3:
|
|
514
|
+
triangles = [face]
|
|
515
|
+
else:
|
|
516
|
+
centroid = centroid_points([vertices[index] for index in face])
|
|
517
|
+
w = len(vertices)
|
|
518
|
+
vertices.append(centroid)
|
|
519
|
+
triangles = [[w, u, v] for u, v in pairwise(face + face[0:1])]
|
|
520
|
+
|
|
521
|
+
for triangle in triangles:
|
|
522
|
+
a = vertices[triangle[0]]
|
|
523
|
+
b = vertices[triangle[1]]
|
|
524
|
+
c = vertices[triangle[2]]
|
|
525
|
+
ab = subtract_vectors(b, a)
|
|
526
|
+
ac = subtract_vectors(c, a)
|
|
527
|
+
n = cross_vectors(ab, ac)
|
|
528
|
+
V += dot_vectors(a, n)
|
|
529
|
+
|
|
530
|
+
nx = dot_vectors(n, ex)
|
|
531
|
+
ny = dot_vectors(n, ey)
|
|
532
|
+
nz = dot_vectors(n, ez)
|
|
533
|
+
|
|
534
|
+
ab = add_vectors(a, b)
|
|
535
|
+
bc = add_vectors(b, c)
|
|
536
|
+
ca = add_vectors(c, a)
|
|
537
|
+
|
|
538
|
+
ab_x2 = dot_vectors(ab, ex) ** 2
|
|
539
|
+
bc_x2 = dot_vectors(bc, ex) ** 2
|
|
540
|
+
ca_x2 = dot_vectors(ca, ex) ** 2
|
|
541
|
+
|
|
542
|
+
x += nx * (ab_x2 + bc_x2 + ca_x2)
|
|
543
|
+
|
|
544
|
+
ab_y2 = dot_vectors(ab, ey) ** 2
|
|
545
|
+
bc_y2 = dot_vectors(bc, ey) ** 2
|
|
546
|
+
ca_y2 = dot_vectors(ca, ey) ** 2
|
|
547
|
+
|
|
548
|
+
y += ny * (ab_y2 + bc_y2 + ca_y2)
|
|
549
|
+
|
|
550
|
+
ab_z2 = dot_vectors(ab, ez) ** 2
|
|
551
|
+
bc_z2 = dot_vectors(bc, ez) ** 2
|
|
552
|
+
ca_z2 = dot_vectors(ca, ez) ** 2
|
|
553
|
+
|
|
554
|
+
z += nz * (ab_z2 + bc_z2 + ca_z2)
|
|
555
|
+
|
|
556
|
+
# for j in (-1, 0, 1):
|
|
557
|
+
# ab = add_vectors(vertices[triangle[j]], vertices[triangle[j + 1]])
|
|
558
|
+
# x += nx * dot_vectors(ab, ex) ** 2
|
|
559
|
+
# y += ny * dot_vectors(ab, ey) ** 2
|
|
560
|
+
# z += nz * dot_vectors(ab, ez) ** 2
|
|
561
|
+
|
|
562
|
+
V = V / 6.0
|
|
563
|
+
|
|
564
|
+
if V < 1e-9:
|
|
565
|
+
d = 1.0 / (2 * 24)
|
|
566
|
+
else:
|
|
567
|
+
d = 1.0 / (2 * 24 * V)
|
|
568
|
+
|
|
569
|
+
x *= d
|
|
570
|
+
y *= d
|
|
571
|
+
z *= d
|
|
572
|
+
|
|
573
|
+
return [x, y, z]
|