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,895 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from math import fabs
|
|
6
|
+
from math import sqrt
|
|
7
|
+
|
|
8
|
+
from compas.itertools import pairwise
|
|
9
|
+
from compas.tolerance import TOL
|
|
10
|
+
|
|
11
|
+
from ._algebra import add_vectors
|
|
12
|
+
from ._algebra import add_vectors_xy
|
|
13
|
+
from ._algebra import cross_vectors
|
|
14
|
+
from ._algebra import cross_vectors_xy
|
|
15
|
+
from ._algebra import dot_vectors
|
|
16
|
+
from ._algebra import length_vector
|
|
17
|
+
from ._algebra import length_vector_sqrd
|
|
18
|
+
from ._algebra import length_vector_sqrd_xy
|
|
19
|
+
from ._algebra import length_vector_xy
|
|
20
|
+
from ._algebra import normalize_vector
|
|
21
|
+
from ._algebra import scale_vector
|
|
22
|
+
from ._algebra import subtract_vectors
|
|
23
|
+
from ._algebra import subtract_vectors_xy
|
|
24
|
+
from ._algebra import vector_component
|
|
25
|
+
from ._algebra import vector_component_xy
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
def distance_point_point(a, b):
|
|
29
|
+
"""Compute the distance bewteen a and b.
|
|
30
|
+
|
|
31
|
+
Parameters
|
|
32
|
+
----------
|
|
33
|
+
a : [float, float, float] | :class:`compas.geometry.Point`
|
|
34
|
+
XYZ coordinates of point a.
|
|
35
|
+
b : [float, float, float] | :class:`compas.geometry.Point`
|
|
36
|
+
XYZ coordinates of point b.
|
|
37
|
+
|
|
38
|
+
Returns
|
|
39
|
+
-------
|
|
40
|
+
float
|
|
41
|
+
Distance bewteen a and b.
|
|
42
|
+
|
|
43
|
+
Examples
|
|
44
|
+
--------
|
|
45
|
+
>>> distance_point_point([0.0, 0.0, 0.0], [2.0, 0.0, 0.0])
|
|
46
|
+
2.0
|
|
47
|
+
|
|
48
|
+
See Also
|
|
49
|
+
--------
|
|
50
|
+
distance_point_point_xy
|
|
51
|
+
|
|
52
|
+
"""
|
|
53
|
+
ab = subtract_vectors(b, a)
|
|
54
|
+
return length_vector(ab)
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
def distance_point_point_xy(a, b):
|
|
58
|
+
"""Compute the distance between points a and b, assuming they lie in the XY plane.
|
|
59
|
+
|
|
60
|
+
Parameters
|
|
61
|
+
----------
|
|
62
|
+
a : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
63
|
+
XY(Z) coordinates of a 2D or 3D point (Z will be ignored).
|
|
64
|
+
b : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
65
|
+
XY(Z) coordinates of a 2D or 3D point (Z will be ignored).
|
|
66
|
+
|
|
67
|
+
Returns
|
|
68
|
+
-------
|
|
69
|
+
float
|
|
70
|
+
Distance between a and b in the XY-plane.
|
|
71
|
+
|
|
72
|
+
Examples
|
|
73
|
+
--------
|
|
74
|
+
>>> distance_point_point_xy([0.0, 0.0], [2.0, 0.0])
|
|
75
|
+
2.0
|
|
76
|
+
|
|
77
|
+
>>> distance_point_point_xy([0.0, 0.0, 0.0], [2.0, 0.0, 0.0])
|
|
78
|
+
2.0
|
|
79
|
+
|
|
80
|
+
>>> distance_point_point_xy([0.0, 0.0, 1.0], [2.0, 0.0, 1.0])
|
|
81
|
+
2.0
|
|
82
|
+
|
|
83
|
+
"""
|
|
84
|
+
ab = subtract_vectors_xy(b, a)
|
|
85
|
+
return length_vector_xy(ab)
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
def distance_point_point_sqrd(a, b):
|
|
89
|
+
"""Compute the squared distance bewteen points a and b.
|
|
90
|
+
|
|
91
|
+
Parameters
|
|
92
|
+
----------
|
|
93
|
+
a : [float, float, float] | :class:`compas.geometry.Point`
|
|
94
|
+
XYZ coordinates of point a.
|
|
95
|
+
b : [float, float, float] | :class:`compas.geometry.Point`
|
|
96
|
+
XYZ coordinates of point b.
|
|
97
|
+
|
|
98
|
+
Returns
|
|
99
|
+
-------
|
|
100
|
+
float
|
|
101
|
+
Squared distance bewteen a and b.
|
|
102
|
+
|
|
103
|
+
Examples
|
|
104
|
+
--------
|
|
105
|
+
>>> distance_point_point_sqrd([0.0, 0.0, 0.0], [2.0, 0.0, 0.0])
|
|
106
|
+
4.0
|
|
107
|
+
|
|
108
|
+
See Also
|
|
109
|
+
--------
|
|
110
|
+
distance_point_point_sqrd_xy
|
|
111
|
+
|
|
112
|
+
"""
|
|
113
|
+
ab = subtract_vectors(b, a)
|
|
114
|
+
return length_vector_sqrd(ab)
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
def distance_point_point_sqrd_xy(a, b):
|
|
118
|
+
"""Compute the squared distance between points a and b lying in the XY plane.
|
|
119
|
+
|
|
120
|
+
Parameters
|
|
121
|
+
----------
|
|
122
|
+
a : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
123
|
+
XY(Z) coordinates of the first point.
|
|
124
|
+
b : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
125
|
+
XY(Z) coordinates of the second point.
|
|
126
|
+
|
|
127
|
+
Returns
|
|
128
|
+
-------
|
|
129
|
+
float
|
|
130
|
+
Squared distance between a and b in the XY-plane.
|
|
131
|
+
|
|
132
|
+
Examples
|
|
133
|
+
--------
|
|
134
|
+
>>> distance_point_point_sqrd_xy([0.0, 0.0], [2.0, 0.0])
|
|
135
|
+
4.0
|
|
136
|
+
|
|
137
|
+
>>> distance_point_point_sqrd_xy([0.0, 0.0, 0.0], [2.0, 0.0, 0.0])
|
|
138
|
+
4.0
|
|
139
|
+
|
|
140
|
+
>>> distance_point_point_sqrd_xy([0.0, 0.0, 1.0], [2.0, 0.0, 1.0])
|
|
141
|
+
4.0
|
|
142
|
+
|
|
143
|
+
"""
|
|
144
|
+
ab = subtract_vectors_xy(b, a)
|
|
145
|
+
return length_vector_sqrd_xy(ab)
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
def distance_point_line(point, line):
|
|
149
|
+
"""Compute the distance between a point and a line.
|
|
150
|
+
|
|
151
|
+
Parameters
|
|
152
|
+
----------
|
|
153
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
154
|
+
Point location.
|
|
155
|
+
line : [point, point] | :class:`compas.geometry.Line`
|
|
156
|
+
Line defined by two points.
|
|
157
|
+
|
|
158
|
+
Returns
|
|
159
|
+
-------
|
|
160
|
+
float
|
|
161
|
+
The distance between the point and the line.
|
|
162
|
+
|
|
163
|
+
Notes
|
|
164
|
+
-----
|
|
165
|
+
This implementation computes the *right angle distance* from a point P to a
|
|
166
|
+
line defined by points A and B as twice the area of the triangle ABP divided
|
|
167
|
+
by the length of AB [1]_.
|
|
168
|
+
|
|
169
|
+
References
|
|
170
|
+
----------
|
|
171
|
+
.. [1] Wikipedia. *Distance from a point to a line*.
|
|
172
|
+
Available at: https://en.wikipedia.org/wiki/Distance_from_a_point_to_a_line
|
|
173
|
+
|
|
174
|
+
Examples
|
|
175
|
+
--------
|
|
176
|
+
>>>
|
|
177
|
+
|
|
178
|
+
"""
|
|
179
|
+
a, b = line
|
|
180
|
+
ab = subtract_vectors(b, a)
|
|
181
|
+
pa = subtract_vectors(a, point)
|
|
182
|
+
pb = subtract_vectors(b, point)
|
|
183
|
+
length = length_vector(cross_vectors(pa, pb))
|
|
184
|
+
length_ab = length_vector(ab)
|
|
185
|
+
return length / length_ab
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
def distance_point_line_xy(point, line):
|
|
189
|
+
"""Compute the distance between a point and a line, assuming they lie in the XY-plane.
|
|
190
|
+
|
|
191
|
+
Parameters
|
|
192
|
+
----------
|
|
193
|
+
point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
194
|
+
XY(Z) coordinates of the point.
|
|
195
|
+
line : [point, point] | :class:`compas.geometry.Line`
|
|
196
|
+
Line defined by two points.
|
|
197
|
+
|
|
198
|
+
Returns
|
|
199
|
+
-------
|
|
200
|
+
float
|
|
201
|
+
The distance between the point and the line.
|
|
202
|
+
|
|
203
|
+
Notes
|
|
204
|
+
-----
|
|
205
|
+
This implementation computes the orthogonal distance from a point P to a
|
|
206
|
+
line defined by points A and B as twice the area of the triangle ABP divided
|
|
207
|
+
by the length of AB [1]_.
|
|
208
|
+
|
|
209
|
+
References
|
|
210
|
+
----------
|
|
211
|
+
.. [1] Wikipedia. *Distance from a point to a line*.
|
|
212
|
+
Available at: https://en.wikipedia.org/wiki/Distance_from_a_point_to_a_line.
|
|
213
|
+
|
|
214
|
+
"""
|
|
215
|
+
a, b = line
|
|
216
|
+
ab = subtract_vectors_xy(b, a)
|
|
217
|
+
pa = subtract_vectors_xy(a, point)
|
|
218
|
+
pb = subtract_vectors_xy(b, point)
|
|
219
|
+
length = fabs(cross_vectors_xy(pa, pb)[2])
|
|
220
|
+
length_ab = length_vector_xy(ab)
|
|
221
|
+
return length / length_ab
|
|
222
|
+
|
|
223
|
+
|
|
224
|
+
def distance_point_line_sqrd(point, line):
|
|
225
|
+
"""Compute the squared distance between a point and a line.
|
|
226
|
+
|
|
227
|
+
Parameters
|
|
228
|
+
----------
|
|
229
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
230
|
+
XYZ coordinates of the point.
|
|
231
|
+
line : [point, point] | :class:`compas.geometry.Line`
|
|
232
|
+
Line defined by two points.
|
|
233
|
+
|
|
234
|
+
Returns
|
|
235
|
+
-------
|
|
236
|
+
float
|
|
237
|
+
The squared distance between the point and the line.
|
|
238
|
+
|
|
239
|
+
Notes
|
|
240
|
+
-----
|
|
241
|
+
For more info, see [1]_.
|
|
242
|
+
|
|
243
|
+
References
|
|
244
|
+
----------
|
|
245
|
+
.. [1] Wikipedia. *Distance from a point to a line*.
|
|
246
|
+
Available at: https://en.wikipedia.org/wiki/Distance_from_a_point_to_a_line.
|
|
247
|
+
|
|
248
|
+
"""
|
|
249
|
+
a, b = line
|
|
250
|
+
ab = subtract_vectors(b, a)
|
|
251
|
+
pa = subtract_vectors(a, point)
|
|
252
|
+
pb = subtract_vectors(b, point)
|
|
253
|
+
length = length_vector_sqrd(cross_vectors(pa, pb))
|
|
254
|
+
length_ab = length_vector_sqrd(ab)
|
|
255
|
+
return length / length_ab
|
|
256
|
+
|
|
257
|
+
|
|
258
|
+
def distance_point_line_sqrd_xy(point, line):
|
|
259
|
+
"""Compute the squared distance between a point and a line lying in the XY-plane.
|
|
260
|
+
|
|
261
|
+
Parameters
|
|
262
|
+
----------
|
|
263
|
+
point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
264
|
+
XY(Z) coordinates of a 2D or 3D point (Z will be ignored).
|
|
265
|
+
line : [point, point] | :class:`compas.geometry.Line`
|
|
266
|
+
Line defined by two points.
|
|
267
|
+
|
|
268
|
+
Returns
|
|
269
|
+
-------
|
|
270
|
+
float
|
|
271
|
+
The squared distance between the point and the line.
|
|
272
|
+
|
|
273
|
+
Notes
|
|
274
|
+
-----
|
|
275
|
+
This implementation computes the orthogonal squared distance from a point P to a
|
|
276
|
+
line defined by points A and B as twice the area of the triangle ABP divided
|
|
277
|
+
by the length of AB [1]_.
|
|
278
|
+
|
|
279
|
+
References
|
|
280
|
+
----------
|
|
281
|
+
.. [1] Wikipedia. *Distance from a point to a line*.
|
|
282
|
+
Available at: https://en.wikipedia.org/wiki/Distance_from_a_point_to_a_line.
|
|
283
|
+
|
|
284
|
+
"""
|
|
285
|
+
a, b = line
|
|
286
|
+
ab = subtract_vectors_xy(b, a)
|
|
287
|
+
pa = subtract_vectors_xy(a, point)
|
|
288
|
+
pb = subtract_vectors_xy(b, point)
|
|
289
|
+
length = cross_vectors_xy(pa, pb)[2] ** 2
|
|
290
|
+
length_ab = length_vector_sqrd_xy(ab)
|
|
291
|
+
return length / length_ab
|
|
292
|
+
|
|
293
|
+
|
|
294
|
+
def distance_point_plane(point, plane):
|
|
295
|
+
r"""Compute the distance from a point to a plane defined by origin point and normal.
|
|
296
|
+
|
|
297
|
+
Parameters
|
|
298
|
+
----------
|
|
299
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
300
|
+
Point coordinates.
|
|
301
|
+
plane : [point, vector]
|
|
302
|
+
A point and a vector defining a plane.
|
|
303
|
+
|
|
304
|
+
Returns
|
|
305
|
+
-------
|
|
306
|
+
float
|
|
307
|
+
Distance between point and plane.
|
|
308
|
+
|
|
309
|
+
Notes
|
|
310
|
+
-----
|
|
311
|
+
The distance from a point to a plane can be computed from the coefficients
|
|
312
|
+
of the equation of the plane and the coordinates of the point [1]_.
|
|
313
|
+
|
|
314
|
+
The equation of a plane is
|
|
315
|
+
|
|
316
|
+
.. math::
|
|
317
|
+
|
|
318
|
+
Ax + By + Cz + D = 0
|
|
319
|
+
|
|
320
|
+
where
|
|
321
|
+
|
|
322
|
+
.. math::
|
|
323
|
+
:nowrap:
|
|
324
|
+
|
|
325
|
+
\begin{align}
|
|
326
|
+
D &= - Ax_0 - Bx_0 - Cz_0 \\
|
|
327
|
+
Q &= (x_0, y_0, z_0) \\
|
|
328
|
+
N &= (A, B, C)
|
|
329
|
+
\end{align}
|
|
330
|
+
|
|
331
|
+
with :math:`Q` a point on the plane, and :math:`N` the normal vector at
|
|
332
|
+
that point. The distance of any point :math:`P` to a plane is the
|
|
333
|
+
absolute value of the dot product of the vector from :math:`Q` to :math:`P`
|
|
334
|
+
and the normal at :math:`Q`.
|
|
335
|
+
|
|
336
|
+
References
|
|
337
|
+
----------
|
|
338
|
+
.. [1] Nykamp, D. *Distance from point to plane*.
|
|
339
|
+
Available at: http://mathinsight.org/distance_point_plane.
|
|
340
|
+
|
|
341
|
+
Examples
|
|
342
|
+
--------
|
|
343
|
+
>>>
|
|
344
|
+
|
|
345
|
+
"""
|
|
346
|
+
return fabs(distance_point_plane_signed(point, plane))
|
|
347
|
+
|
|
348
|
+
|
|
349
|
+
def distance_point_plane_signed(point, plane):
|
|
350
|
+
r"""Compute the signed distance from a point to a plane defined by origin point and normal.
|
|
351
|
+
|
|
352
|
+
Parameters
|
|
353
|
+
----------
|
|
354
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
355
|
+
Point coordinates.
|
|
356
|
+
plane : [point, vector]
|
|
357
|
+
A point and a vector defining a plane.
|
|
358
|
+
|
|
359
|
+
Returns
|
|
360
|
+
-------
|
|
361
|
+
float
|
|
362
|
+
Distance between point and plane.
|
|
363
|
+
|
|
364
|
+
Notes
|
|
365
|
+
-----
|
|
366
|
+
The distance from a point to a plane can be computed from the coefficients
|
|
367
|
+
of the equation of the plane and the coordinates of the point [1]_.
|
|
368
|
+
|
|
369
|
+
The equation of a plane is
|
|
370
|
+
|
|
371
|
+
.. math::
|
|
372
|
+
|
|
373
|
+
Ax + By + Cz + D = 0
|
|
374
|
+
|
|
375
|
+
where
|
|
376
|
+
|
|
377
|
+
.. math::
|
|
378
|
+
:nowrap:
|
|
379
|
+
|
|
380
|
+
\begin{align}
|
|
381
|
+
D &= - Ax_0 - Bx_0 - Cz_0 \\
|
|
382
|
+
Q &= (x_0, y_0, z_0) \\
|
|
383
|
+
N &= (A, B, C)
|
|
384
|
+
\end{align}
|
|
385
|
+
|
|
386
|
+
with :math:`Q` a point on the plane, and :math:`N` the normal vector at
|
|
387
|
+
that point. The distance of any point :math:`P` to a plane is the
|
|
388
|
+
value of the dot product of the vector from :math:`Q` to :math:`P`
|
|
389
|
+
and the normal at :math:`Q`.
|
|
390
|
+
|
|
391
|
+
References
|
|
392
|
+
----------
|
|
393
|
+
.. [1] Nykamp, D. *Distance from point to plane*.
|
|
394
|
+
Available at: http://mathinsight.org/distance_point_plane.
|
|
395
|
+
|
|
396
|
+
Examples
|
|
397
|
+
--------
|
|
398
|
+
>>>
|
|
399
|
+
|
|
400
|
+
"""
|
|
401
|
+
base, normal = plane
|
|
402
|
+
vector = subtract_vectors(point, base)
|
|
403
|
+
return dot_vectors(vector, normal)
|
|
404
|
+
|
|
405
|
+
|
|
406
|
+
def distance_line_line(l1, l2, tol=None):
|
|
407
|
+
r"""Compute the shortest distance between two lines.
|
|
408
|
+
|
|
409
|
+
Parameters
|
|
410
|
+
----------
|
|
411
|
+
l1 : [point, point] | :class:`compas.geometry.Line`
|
|
412
|
+
Two points defining a line.
|
|
413
|
+
l2 : [point, point] | :class:`compas.geometry.Line`
|
|
414
|
+
Two points defining a line.
|
|
415
|
+
tol : float, optional
|
|
416
|
+
The tolerance for comparing values to zero.
|
|
417
|
+
Default is :attr:`TOL.absolute`.
|
|
418
|
+
|
|
419
|
+
Returns
|
|
420
|
+
-------
|
|
421
|
+
float
|
|
422
|
+
The distance between the two lines.
|
|
423
|
+
|
|
424
|
+
Notes
|
|
425
|
+
-----
|
|
426
|
+
The distance is the absolute value of the dot product of a unit vector that
|
|
427
|
+
is perpendicular to the two lines, and the vector between two points on the lines ([1]_, [2]_).
|
|
428
|
+
|
|
429
|
+
If each of the lines is defined by two points (:math:`l_1 = (\mathbf{x_1}, \mathbf{x_2})`,
|
|
430
|
+
:math:`l_2 = (\mathbf{x_3}, \mathbf{x_4})`), then the unit vector that is
|
|
431
|
+
perpendicular to both lines is...
|
|
432
|
+
|
|
433
|
+
References
|
|
434
|
+
----------
|
|
435
|
+
.. [1] Weisstein, E.W. *Line-line Distance*.
|
|
436
|
+
Available at: http://mathworld.wolfram.com/Line-LineDistance.html.
|
|
437
|
+
.. [2] Wikipedia. *Skew lines Distance*.
|
|
438
|
+
Available at: https://en.wikipedia.org/wiki/Skew_lines#Distance.
|
|
439
|
+
|
|
440
|
+
Examples
|
|
441
|
+
--------
|
|
442
|
+
>>>
|
|
443
|
+
|
|
444
|
+
"""
|
|
445
|
+
a, b = l1
|
|
446
|
+
c, d = l2
|
|
447
|
+
ab = subtract_vectors(b, a)
|
|
448
|
+
cd = subtract_vectors(d, c)
|
|
449
|
+
ac = subtract_vectors(c, a)
|
|
450
|
+
n = cross_vectors(ab, cd)
|
|
451
|
+
length = length_vector(n)
|
|
452
|
+
if TOL.is_zero(length, tol):
|
|
453
|
+
return distance_point_point(closest_point_on_line(l1[0], l2), l1[0])
|
|
454
|
+
n = scale_vector(n, 1.0 / length)
|
|
455
|
+
return fabs(dot_vectors(n, ac))
|
|
456
|
+
|
|
457
|
+
|
|
458
|
+
# ==============================================================================
|
|
459
|
+
# closest
|
|
460
|
+
# ==============================================================================
|
|
461
|
+
|
|
462
|
+
|
|
463
|
+
def sort_points(point, cloud):
|
|
464
|
+
"""Sorts points of a pointcloud based on their distance from a given point.
|
|
465
|
+
|
|
466
|
+
Parameters
|
|
467
|
+
----------
|
|
468
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
469
|
+
The XYZ coordinates of the base point.
|
|
470
|
+
cloud : sequence[[float, float, float] | :class:`compas.geometry.Point`]
|
|
471
|
+
A sequence locations in three-dimensional space.
|
|
472
|
+
|
|
473
|
+
Returns
|
|
474
|
+
-------
|
|
475
|
+
list[[float, [float, float, float], int]]
|
|
476
|
+
A list containing the points of the cloud sorted by their squared distance to the base points.
|
|
477
|
+
Each item in the list contains the squared distance to the base point, the XYZ coordinates
|
|
478
|
+
of the point in the cloud, and the index of the point in the original cloud.
|
|
479
|
+
|
|
480
|
+
Notes
|
|
481
|
+
-----
|
|
482
|
+
Check kdTree class for an optimized implementation (MR).
|
|
483
|
+
|
|
484
|
+
Examples
|
|
485
|
+
--------
|
|
486
|
+
>>>
|
|
487
|
+
|
|
488
|
+
"""
|
|
489
|
+
minsq = [distance_point_point_sqrd(p, point) for p in cloud]
|
|
490
|
+
return sorted(zip(minsq, cloud, range(len(cloud))), key=lambda x: x[0])
|
|
491
|
+
|
|
492
|
+
|
|
493
|
+
def sort_points_xy(point, cloud):
|
|
494
|
+
"""Sorts points of a pointcloud based on their distance from a given point,
|
|
495
|
+
assuming all points lie in the XY plane.
|
|
496
|
+
|
|
497
|
+
Parameters
|
|
498
|
+
----------
|
|
499
|
+
point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
500
|
+
XY(Z) coordinates of a point.
|
|
501
|
+
cloud : sequence[[float, float] or [float, float, float] | :class:`compas.geometry.Point`]
|
|
502
|
+
A list of points represented by their XY(Z) coordinates.
|
|
503
|
+
|
|
504
|
+
Returns
|
|
505
|
+
-------
|
|
506
|
+
list[[float, [float, float, 0.0], int]]
|
|
507
|
+
A list containing the points of the cloud sorted by their squared distance to the base points.
|
|
508
|
+
Each item in the list contains the squared distance to the base point, the XYZ coordinates
|
|
509
|
+
of the point in the cloud in the XY plane, and the index of the point in the original cloud.
|
|
510
|
+
|
|
511
|
+
Notes
|
|
512
|
+
-----
|
|
513
|
+
Check kdTree class for an optimized implementation (MR).
|
|
514
|
+
|
|
515
|
+
Examples
|
|
516
|
+
--------
|
|
517
|
+
>>>
|
|
518
|
+
|
|
519
|
+
"""
|
|
520
|
+
minsq = [distance_point_point_sqrd_xy(p, point) for p in cloud]
|
|
521
|
+
return sorted(zip(minsq, cloud, range(len(cloud))), key=lambda x: x[0])
|
|
522
|
+
|
|
523
|
+
|
|
524
|
+
def closest_point_in_cloud(point, cloud):
|
|
525
|
+
"""Calculates the closest point in a pointcloud.
|
|
526
|
+
|
|
527
|
+
Parameters
|
|
528
|
+
----------
|
|
529
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
530
|
+
XYZ coordinates of the base point.
|
|
531
|
+
cloud : sequence[[float, float, float] | :class:`compas.geometry.Point`]
|
|
532
|
+
A sequence locations in three-dimensional space.
|
|
533
|
+
|
|
534
|
+
Returns
|
|
535
|
+
-------
|
|
536
|
+
float
|
|
537
|
+
The distance to the closest point.
|
|
538
|
+
[float, float, float]
|
|
539
|
+
XYZ coordinates of the closest point.
|
|
540
|
+
int
|
|
541
|
+
The index of the closest point in the original list.
|
|
542
|
+
|
|
543
|
+
Notes
|
|
544
|
+
-----
|
|
545
|
+
Check kdTree class for an optimized implementation.
|
|
546
|
+
|
|
547
|
+
Examples
|
|
548
|
+
--------
|
|
549
|
+
>>>
|
|
550
|
+
|
|
551
|
+
"""
|
|
552
|
+
data = sort_points(point, cloud)
|
|
553
|
+
d, xyz, index = data[0]
|
|
554
|
+
return sqrt(d), xyz, index
|
|
555
|
+
|
|
556
|
+
|
|
557
|
+
def closest_points_in_cloud_numpy(points, cloud, threshold=10**7, distances=True, num_nbrs=1):
|
|
558
|
+
"""Find the closest points in a point cloud to a set of sample points.
|
|
559
|
+
|
|
560
|
+
Parameters
|
|
561
|
+
----------
|
|
562
|
+
points : array_like [n x 3]
|
|
563
|
+
The sample points.
|
|
564
|
+
cloud : array_like [n x 3]
|
|
565
|
+
The cloud points to compare to.
|
|
566
|
+
threshold : float, optional
|
|
567
|
+
Only points within this distance are checked.
|
|
568
|
+
distances : bool, optional
|
|
569
|
+
If True, return the distance matrix in addition to the indices of the closest points.
|
|
570
|
+
num_nbrs : int, optional
|
|
571
|
+
The number of nearest neighbors to include in the result.
|
|
572
|
+
|
|
573
|
+
Returns
|
|
574
|
+
-------
|
|
575
|
+
list or tuple[list, array]
|
|
576
|
+
If `distances` is False, indices of the closest points in the cloud per point in points.
|
|
577
|
+
If `distances` is True, indices of the closest points in the cloud per point in points
|
|
578
|
+
and distances between points and closest points in cloud (n x n).
|
|
579
|
+
|
|
580
|
+
Notes
|
|
581
|
+
-----
|
|
582
|
+
Items in cloud further from items in points than threshold return zero
|
|
583
|
+
distance and will affect the indices returned if not set suitably high.
|
|
584
|
+
|
|
585
|
+
Examples
|
|
586
|
+
--------
|
|
587
|
+
>>> from numpy import allclose
|
|
588
|
+
>>> points = [[0, 0, 0], [1, 0, 0], [1, 1, 0], [0, 1, 0]]
|
|
589
|
+
>>> cloud = [[0, 0, 0], [1, 0, 0], [1, 1, 0], [0, 1, 0]]
|
|
590
|
+
>>> cp = closest_points_in_cloud_numpy(points, cloud, distances=True)
|
|
591
|
+
>>> allclose(cp[1], [[0, 1, 1.4142, 1], [1, 0, 1, 1.4142], [1.4142, 1, 0, 1], [1, 1.4142, 1, 0]])
|
|
592
|
+
True
|
|
593
|
+
|
|
594
|
+
"""
|
|
595
|
+
from numpy import argmin
|
|
596
|
+
from numpy import argpartition
|
|
597
|
+
from numpy import asarray
|
|
598
|
+
from scipy.spatial import distance_matrix
|
|
599
|
+
|
|
600
|
+
points = asarray(points).reshape((-1, 3))
|
|
601
|
+
cloud = asarray(cloud).reshape((-1, 3))
|
|
602
|
+
d_matrix = distance_matrix(points, cloud, threshold=threshold)
|
|
603
|
+
if num_nbrs == 1:
|
|
604
|
+
indices = argmin(d_matrix, axis=1)
|
|
605
|
+
else:
|
|
606
|
+
indices = argpartition(d_matrix, num_nbrs, axis=1)
|
|
607
|
+
if distances:
|
|
608
|
+
return indices, d_matrix
|
|
609
|
+
return indices
|
|
610
|
+
|
|
611
|
+
|
|
612
|
+
def closest_point_in_cloud_xy(point, cloud):
|
|
613
|
+
"""Calculates the closest point in a list of points in the XY-plane.
|
|
614
|
+
|
|
615
|
+
Parameters
|
|
616
|
+
----------
|
|
617
|
+
point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
618
|
+
XY(Z) coordinates of a the base point.
|
|
619
|
+
cloud : sequence[[float, float] or [float, float, float] | :class:`compas.geometry.Point`]
|
|
620
|
+
A list of points forming the cloud, with each point represented by its XY(Z) coordinates.
|
|
621
|
+
|
|
622
|
+
Returns
|
|
623
|
+
-------
|
|
624
|
+
float
|
|
625
|
+
The distance to the closest point.
|
|
626
|
+
[float, float, 0.0]
|
|
627
|
+
The XYZ coordinates of the closest point in the XY plane.
|
|
628
|
+
int
|
|
629
|
+
The index of the closest point in the cloud.
|
|
630
|
+
|
|
631
|
+
Notes
|
|
632
|
+
-----
|
|
633
|
+
Check kdTree class for an optimized implementation (MR).
|
|
634
|
+
|
|
635
|
+
"""
|
|
636
|
+
data = sort_points_xy(point, cloud)
|
|
637
|
+
d, xyz, index = data[0]
|
|
638
|
+
return sqrt(d), xyz, index
|
|
639
|
+
|
|
640
|
+
|
|
641
|
+
def closest_point_on_line(point, line):
|
|
642
|
+
"""Computes closest point on line to a given point.
|
|
643
|
+
|
|
644
|
+
Parameters
|
|
645
|
+
----------
|
|
646
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
647
|
+
XYZ coordinates.
|
|
648
|
+
line : [point, point] | :class:`compas.geometry.Line`
|
|
649
|
+
Two points defining the line.
|
|
650
|
+
|
|
651
|
+
Returns
|
|
652
|
+
-------
|
|
653
|
+
[float, float, float]
|
|
654
|
+
XYZ coordinates of closest point.
|
|
655
|
+
|
|
656
|
+
Examples
|
|
657
|
+
--------
|
|
658
|
+
>>>
|
|
659
|
+
|
|
660
|
+
See Also
|
|
661
|
+
--------
|
|
662
|
+
:func:`basic.transformations.project_point_line`
|
|
663
|
+
|
|
664
|
+
"""
|
|
665
|
+
a, b = line
|
|
666
|
+
ab = subtract_vectors(b, a)
|
|
667
|
+
ap = subtract_vectors(point, a)
|
|
668
|
+
c = vector_component(ap, ab)
|
|
669
|
+
return add_vectors(a, c)
|
|
670
|
+
|
|
671
|
+
|
|
672
|
+
def closest_point_on_line_xy(point, line):
|
|
673
|
+
"""Compute closest point on line (continuous) to a given point lying in the XY-plane.
|
|
674
|
+
|
|
675
|
+
Parameters
|
|
676
|
+
----------
|
|
677
|
+
point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
678
|
+
XY(Z) coordinates of a point.
|
|
679
|
+
line : [point, point] | :class:`compas.geometry.Line`
|
|
680
|
+
Two XY(Z) points defining a line.
|
|
681
|
+
|
|
682
|
+
Returns
|
|
683
|
+
-------
|
|
684
|
+
[float, float, 0.0]
|
|
685
|
+
XYZ coordinates of the closest point in the XY plane.
|
|
686
|
+
|
|
687
|
+
"""
|
|
688
|
+
a, b = line
|
|
689
|
+
ab = subtract_vectors_xy(b, a)
|
|
690
|
+
ap = subtract_vectors_xy(point, a)
|
|
691
|
+
c = vector_component_xy(ap, ab)
|
|
692
|
+
return add_vectors_xy(a, c)
|
|
693
|
+
|
|
694
|
+
|
|
695
|
+
def closest_point_on_segment(point, segment):
|
|
696
|
+
"""Computes closest point on line segment (p1, p2) to test point.
|
|
697
|
+
|
|
698
|
+
Parameters
|
|
699
|
+
----------
|
|
700
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
701
|
+
XYZ coordinates.
|
|
702
|
+
segment : [point, point] | :class:`compas.geometry.Line`
|
|
703
|
+
Two points defining the segment.
|
|
704
|
+
|
|
705
|
+
Returns
|
|
706
|
+
-------
|
|
707
|
+
[float, float, float]
|
|
708
|
+
XYZ coordinates of closest point.
|
|
709
|
+
|
|
710
|
+
Examples
|
|
711
|
+
--------
|
|
712
|
+
>>>
|
|
713
|
+
|
|
714
|
+
"""
|
|
715
|
+
a, b = segment
|
|
716
|
+
p = closest_point_on_line(point, segment)
|
|
717
|
+
d = distance_point_point_sqrd(a, b)
|
|
718
|
+
d1 = distance_point_point_sqrd(a, p)
|
|
719
|
+
d2 = distance_point_point_sqrd(b, p)
|
|
720
|
+
if d1 > d or d2 > d:
|
|
721
|
+
if d1 < d2:
|
|
722
|
+
return a
|
|
723
|
+
return b
|
|
724
|
+
return p
|
|
725
|
+
|
|
726
|
+
|
|
727
|
+
def closest_point_on_segment_xy(point, segment):
|
|
728
|
+
"""Compute closest point on a line segment to a given point lying in the XY-plane.
|
|
729
|
+
|
|
730
|
+
Parameters
|
|
731
|
+
----------
|
|
732
|
+
point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
733
|
+
XY(Z) coordinates of a point.
|
|
734
|
+
segment : [point, point] | :class:`compas.geometry.Line`
|
|
735
|
+
Two 2D or 3D points defining the line segment (Z components will be ignored).
|
|
736
|
+
|
|
737
|
+
Returns
|
|
738
|
+
-------
|
|
739
|
+
[float, float, 0.0]
|
|
740
|
+
XYZ coordinates of closest point in the XY plane.
|
|
741
|
+
|
|
742
|
+
"""
|
|
743
|
+
a, b = segment
|
|
744
|
+
p = closest_point_on_line_xy(point, segment)
|
|
745
|
+
d = distance_point_point_sqrd_xy(a, b)
|
|
746
|
+
d1 = distance_point_point_sqrd_xy(a, p)
|
|
747
|
+
d2 = distance_point_point_sqrd_xy(b, p)
|
|
748
|
+
if d1 > d or d2 > d:
|
|
749
|
+
if d1 < d2:
|
|
750
|
+
return [a[0], a[1], 0.0]
|
|
751
|
+
return [b[0], b[1], 0.0]
|
|
752
|
+
return p
|
|
753
|
+
|
|
754
|
+
|
|
755
|
+
def closest_point_on_polyline(point, polyline):
|
|
756
|
+
"""Find the closest point on a polyline to a given point.
|
|
757
|
+
|
|
758
|
+
Parameters
|
|
759
|
+
----------
|
|
760
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
761
|
+
XYZ coordinates of a 2D or 3D point (Z will be ignored).
|
|
762
|
+
polyline : sequence[point] | :class:`compas.geometry.Polyline`
|
|
763
|
+
A sequence of XYZ coordinates representing the locations of the corners of a polyline.
|
|
764
|
+
The vertices are assumed to be in order.
|
|
765
|
+
|
|
766
|
+
Returns
|
|
767
|
+
-------
|
|
768
|
+
[float, float, float]
|
|
769
|
+
XYZ coordinates of closest point.
|
|
770
|
+
|
|
771
|
+
"""
|
|
772
|
+
cloud = []
|
|
773
|
+
|
|
774
|
+
for segment in pairwise(polyline):
|
|
775
|
+
cloud.append(closest_point_on_segment(point, segment))
|
|
776
|
+
|
|
777
|
+
return closest_point_in_cloud(point, cloud)[1]
|
|
778
|
+
|
|
779
|
+
|
|
780
|
+
def closest_point_on_polyline_xy(point, polyline):
|
|
781
|
+
"""Compute closest point on a polyline to a given point,
|
|
782
|
+
assuming they both lie in the XY-plane.
|
|
783
|
+
|
|
784
|
+
Parameters
|
|
785
|
+
----------
|
|
786
|
+
point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
787
|
+
XY(Z) coordinates of a 2D or 3D point (Z will be ignored).
|
|
788
|
+
polyline : sequence[point] | :class:`compas.geometry.Polyline`
|
|
789
|
+
A sequence of XY(Z) coordinates of 2D or 3D points (Z will be ignored)
|
|
790
|
+
representing the locations of the corners of a polyline.
|
|
791
|
+
The vertices are assumed to be in order.
|
|
792
|
+
|
|
793
|
+
Returns
|
|
794
|
+
-------
|
|
795
|
+
[float, float, 0.0]
|
|
796
|
+
XYZ coordinates of closest point in the XY plane.
|
|
797
|
+
|
|
798
|
+
"""
|
|
799
|
+
cloud = []
|
|
800
|
+
|
|
801
|
+
for segment in pairwise(polyline):
|
|
802
|
+
cloud.append(closest_point_on_segment_xy(point, segment))
|
|
803
|
+
|
|
804
|
+
return closest_point_in_cloud_xy(point, cloud)[1]
|
|
805
|
+
|
|
806
|
+
|
|
807
|
+
def closest_point_on_polygon_xy(point, polygon):
|
|
808
|
+
"""Compute closest point on a polygon to a given point lying in the XY-plane.
|
|
809
|
+
|
|
810
|
+
Parameters
|
|
811
|
+
----------
|
|
812
|
+
point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
|
|
813
|
+
XY(Z) coordinates of a 2D or 3D point (Z will be ignored).
|
|
814
|
+
polygon : sequence[point] | :class:`compas.geometry.Polygon`
|
|
815
|
+
A sequence of XY(Z) coordinates of 2D or 3D points
|
|
816
|
+
(Z will be ignored) representing the locations of the corners of a polygon.
|
|
817
|
+
The vertices are assumed to be in order. The polygon is assumed to be closed:
|
|
818
|
+
the first and last vertex in the sequence should not be the same.
|
|
819
|
+
|
|
820
|
+
Returns
|
|
821
|
+
-------
|
|
822
|
+
[float, float, 0.0]
|
|
823
|
+
XYZ coordinates of closest point in the XY plane.
|
|
824
|
+
|
|
825
|
+
"""
|
|
826
|
+
points = []
|
|
827
|
+
for i in range(len(polygon)):
|
|
828
|
+
segment = polygon[i - 1], polygon[i]
|
|
829
|
+
points.append(closest_point_on_segment_xy(point, segment))
|
|
830
|
+
|
|
831
|
+
return closest_point_in_cloud_xy(point, points)[1]
|
|
832
|
+
|
|
833
|
+
|
|
834
|
+
def closest_point_on_plane(point, plane):
|
|
835
|
+
"""Compute closest point on a plane to a given point.
|
|
836
|
+
|
|
837
|
+
Parameters
|
|
838
|
+
----------
|
|
839
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
840
|
+
XYZ coordinates of point.
|
|
841
|
+
plane : [point, vector]
|
|
842
|
+
The base point and normal defining the plane.
|
|
843
|
+
|
|
844
|
+
Returns
|
|
845
|
+
-------
|
|
846
|
+
[float, float, float]
|
|
847
|
+
XYZ coordinates of the closest point.
|
|
848
|
+
|
|
849
|
+
Notes
|
|
850
|
+
-----
|
|
851
|
+
For more info, see [1]_.
|
|
852
|
+
|
|
853
|
+
References
|
|
854
|
+
----------
|
|
855
|
+
.. [1] Wikipedia. *Distance from a point to a plane*.
|
|
856
|
+
Available at: https://en.wikipedia.org/wiki/Distance_from_a_point_to_a_plane
|
|
857
|
+
|
|
858
|
+
Examples
|
|
859
|
+
--------
|
|
860
|
+
>>> plane = ([0.0, 0.0, 0.0], [0.0, 0.0, 1.0])
|
|
861
|
+
>>> point = [1.0, 2.0, 3.0]
|
|
862
|
+
>>> closest_point_on_plane(point, plane)
|
|
863
|
+
[1.0, 2.0, 0.0]
|
|
864
|
+
|
|
865
|
+
"""
|
|
866
|
+
base, normal = plane
|
|
867
|
+
x, y, z = base
|
|
868
|
+
a, b, c = normalize_vector(normal)
|
|
869
|
+
x1, y1, z1 = point
|
|
870
|
+
d = a * x + b * y + c * z
|
|
871
|
+
k = (a * x1 + b * y1 + c * z1 - d) / (a**2 + b**2 + c**2)
|
|
872
|
+
return [x1 - k * a, y1 - k * b, z1 - k * c]
|
|
873
|
+
|
|
874
|
+
|
|
875
|
+
def closest_line_to_point(point, lines):
|
|
876
|
+
"""Compute closest line to a point from a list of lines.
|
|
877
|
+
|
|
878
|
+
Parameters
|
|
879
|
+
----------
|
|
880
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
881
|
+
XYZ coordinates of point.
|
|
882
|
+
lines : sequence[[point, point] | :class:`compas.geometry.Line`].
|
|
883
|
+
The lines to be checked for distance.
|
|
884
|
+
|
|
885
|
+
Returns
|
|
886
|
+
-------
|
|
887
|
+
tuple[point, point]
|
|
888
|
+
The closest line.
|
|
889
|
+
"""
|
|
890
|
+
cloud = []
|
|
891
|
+
|
|
892
|
+
for segment in lines:
|
|
893
|
+
cloud.append(closest_point_on_segment(point, segment))
|
|
894
|
+
|
|
895
|
+
return lines[closest_point_in_cloud(point, cloud)[2]]
|