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
compas/geometry/point.py
ADDED
|
@@ -0,0 +1,664 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from compas.geometry import centroid_points
|
|
6
|
+
from compas.geometry import distance_point_line
|
|
7
|
+
from compas.geometry import distance_point_plane
|
|
8
|
+
from compas.geometry import distance_point_point
|
|
9
|
+
from compas.geometry import is_point_behind_plane
|
|
10
|
+
from compas.geometry import is_point_in_circle
|
|
11
|
+
from compas.geometry import is_point_in_convex_polygon_xy
|
|
12
|
+
from compas.geometry import is_point_in_polygon_xy
|
|
13
|
+
from compas.geometry import is_point_in_triangle
|
|
14
|
+
from compas.geometry import is_point_on_polyline
|
|
15
|
+
from compas.geometry import is_point_on_segment
|
|
16
|
+
from compas.geometry import normal_polygon
|
|
17
|
+
from compas.geometry import transform_points
|
|
18
|
+
from compas.tolerance import TOL
|
|
19
|
+
|
|
20
|
+
from .geometry import Geometry
|
|
21
|
+
from .vector import Vector
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
class Point(Geometry):
|
|
25
|
+
"""A point is defined by XYZ coordinates.
|
|
26
|
+
|
|
27
|
+
Parameters
|
|
28
|
+
----------
|
|
29
|
+
x : float
|
|
30
|
+
The X coordinate of the point.
|
|
31
|
+
y : float
|
|
32
|
+
The Y coordinate of the point.
|
|
33
|
+
z : float, optional
|
|
34
|
+
The Z coordinate of the point.
|
|
35
|
+
name : str, optional
|
|
36
|
+
The name of the point.
|
|
37
|
+
|
|
38
|
+
Attributes
|
|
39
|
+
----------
|
|
40
|
+
x : float
|
|
41
|
+
The X coordinate of the point.
|
|
42
|
+
y : float
|
|
43
|
+
The Y coordinate of the point.
|
|
44
|
+
z : float
|
|
45
|
+
The Z coordinate of the point.
|
|
46
|
+
|
|
47
|
+
Notes
|
|
48
|
+
-----
|
|
49
|
+
A `Point` object supports direct access to its xyz coordinates through
|
|
50
|
+
the dot notation, as well list-style access using indices. Indexed
|
|
51
|
+
access is implemented such that the `Point` behaves like a circular
|
|
52
|
+
list [1]_.
|
|
53
|
+
|
|
54
|
+
References
|
|
55
|
+
----------
|
|
56
|
+
.. [1] Stack Overflow. *Pythonic Circular List*.
|
|
57
|
+
Available at: https://stackoverflow.com/questions/8951020/pythonic-circular-list.
|
|
58
|
+
|
|
59
|
+
Examples
|
|
60
|
+
--------
|
|
61
|
+
>>> p1 = Point(1, 2, 3)
|
|
62
|
+
>>> p2 = Point(4, 5, 6)
|
|
63
|
+
|
|
64
|
+
The XYZ coordinates of point objects can be accessed as object attributes or by trating the points as lists.
|
|
65
|
+
|
|
66
|
+
>>> p1.x
|
|
67
|
+
1.0
|
|
68
|
+
>>> p1.y
|
|
69
|
+
2.0
|
|
70
|
+
>>> p1.z
|
|
71
|
+
3.0
|
|
72
|
+
>>> p1[0]
|
|
73
|
+
1.0
|
|
74
|
+
>>> p1[1]
|
|
75
|
+
2.0
|
|
76
|
+
>>> p1[2]
|
|
77
|
+
3.0
|
|
78
|
+
|
|
79
|
+
Point objects support basic arithmetic operations.
|
|
80
|
+
|
|
81
|
+
>>> p1 + p2
|
|
82
|
+
Point(5.000, 7.000, 9.000)
|
|
83
|
+
>>> p1 * 2
|
|
84
|
+
Point(2.000, 4.000, 6.000)
|
|
85
|
+
>>> p1**2
|
|
86
|
+
Point(1.000, 4.000, 9.000)
|
|
87
|
+
>>> p1
|
|
88
|
+
Point(1.000, 2.000, 3.000)
|
|
89
|
+
|
|
90
|
+
Points and lists can be used interchangeably.
|
|
91
|
+
|
|
92
|
+
>>> p1 + [4, 5, 6]
|
|
93
|
+
Point(5.000, 7.000, 9.000)
|
|
94
|
+
|
|
95
|
+
Arithmetic operations can also be applied to modify a point object in-place.
|
|
96
|
+
|
|
97
|
+
>>> p1 += p2
|
|
98
|
+
>>> p1 *= 2
|
|
99
|
+
>>> p1 **= 2
|
|
100
|
+
>>> p1
|
|
101
|
+
Point(100.000, 196.000, 324.000)
|
|
102
|
+
|
|
103
|
+
"""
|
|
104
|
+
|
|
105
|
+
DATASCHEMA = {
|
|
106
|
+
"type": "array",
|
|
107
|
+
"minItems": 3,
|
|
108
|
+
"maxItems": 3,
|
|
109
|
+
"items": {"type": "number"},
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
@property
|
|
113
|
+
def __data__(self):
|
|
114
|
+
return list(self)
|
|
115
|
+
|
|
116
|
+
@classmethod
|
|
117
|
+
def __from_data__(cls, data):
|
|
118
|
+
return cls(*data)
|
|
119
|
+
|
|
120
|
+
def __init__(self, x, y, z=0.0, name=None):
|
|
121
|
+
super(Point, self).__init__(name=name)
|
|
122
|
+
self._x = 0.0
|
|
123
|
+
self._y = 0.0
|
|
124
|
+
self._z = 0.0
|
|
125
|
+
self.x = x
|
|
126
|
+
self.y = y
|
|
127
|
+
self.z = z
|
|
128
|
+
|
|
129
|
+
def __repr__(self):
|
|
130
|
+
return "{0}(x={1}, y={2}, z={3})".format(
|
|
131
|
+
type(self).__name__,
|
|
132
|
+
self.x,
|
|
133
|
+
self.y,
|
|
134
|
+
self.z,
|
|
135
|
+
)
|
|
136
|
+
|
|
137
|
+
def __str__(self):
|
|
138
|
+
return "{0}(x={1}, y={2}, z={3})".format(
|
|
139
|
+
type(self).__name__,
|
|
140
|
+
TOL.format_number(self.x),
|
|
141
|
+
TOL.format_number(self.y),
|
|
142
|
+
TOL.format_number(self.z),
|
|
143
|
+
)
|
|
144
|
+
|
|
145
|
+
def __len__(self):
|
|
146
|
+
return 3
|
|
147
|
+
|
|
148
|
+
def __getitem__(self, key):
|
|
149
|
+
if isinstance(key, slice):
|
|
150
|
+
return [self[i] for i in range(*key.indices(len(self)))]
|
|
151
|
+
i = key % 3
|
|
152
|
+
if i == 0:
|
|
153
|
+
return self.x
|
|
154
|
+
if i == 1:
|
|
155
|
+
return self.y
|
|
156
|
+
if i == 2:
|
|
157
|
+
return self.z
|
|
158
|
+
raise KeyError
|
|
159
|
+
|
|
160
|
+
def __setitem__(self, key, value):
|
|
161
|
+
i = key % 3
|
|
162
|
+
if i == 0:
|
|
163
|
+
self.x = value
|
|
164
|
+
return
|
|
165
|
+
if i == 1:
|
|
166
|
+
self.y = value
|
|
167
|
+
return
|
|
168
|
+
if i == 2:
|
|
169
|
+
self.z = value
|
|
170
|
+
return
|
|
171
|
+
raise KeyError
|
|
172
|
+
|
|
173
|
+
def __iter__(self):
|
|
174
|
+
return iter([self.x, self.y, self.z])
|
|
175
|
+
|
|
176
|
+
def __eq__(self, other):
|
|
177
|
+
return self.x == other[0] and self.y == other[1] and self.z == other[2]
|
|
178
|
+
|
|
179
|
+
def __add__(self, other):
|
|
180
|
+
return Point(self.x + other[0], self.y + other[1], self.z + other[2])
|
|
181
|
+
|
|
182
|
+
def __sub__(self, other):
|
|
183
|
+
x = self.x - other[0]
|
|
184
|
+
y = self.y - other[1]
|
|
185
|
+
z = self.z - other[2]
|
|
186
|
+
return Vector(x, y, z)
|
|
187
|
+
|
|
188
|
+
def __mul__(self, n):
|
|
189
|
+
return Point(n * self.x, n * self.y, n * self.z)
|
|
190
|
+
|
|
191
|
+
def __truediv__(self, n):
|
|
192
|
+
return Point(self.x / n, self.y / n, self.z / n)
|
|
193
|
+
|
|
194
|
+
def __pow__(self, n):
|
|
195
|
+
return Point(self.x**n, self.y**n, self.z**n)
|
|
196
|
+
|
|
197
|
+
def __iadd__(self, other):
|
|
198
|
+
self.x += other[0]
|
|
199
|
+
self.y += other[1]
|
|
200
|
+
self.z += other[2]
|
|
201
|
+
return self
|
|
202
|
+
|
|
203
|
+
def __isub__(self, other):
|
|
204
|
+
self.x -= other[0]
|
|
205
|
+
self.y -= other[1]
|
|
206
|
+
self.z -= other[2]
|
|
207
|
+
return self
|
|
208
|
+
|
|
209
|
+
def __imul__(self, n):
|
|
210
|
+
self.x *= n
|
|
211
|
+
self.y *= n
|
|
212
|
+
self.z *= n
|
|
213
|
+
return self
|
|
214
|
+
|
|
215
|
+
def __itruediv__(self, n):
|
|
216
|
+
self.x /= n
|
|
217
|
+
self.y /= n
|
|
218
|
+
self.z /= n
|
|
219
|
+
return self
|
|
220
|
+
|
|
221
|
+
def __ipow__(self, n):
|
|
222
|
+
self.x **= n
|
|
223
|
+
self.y **= n
|
|
224
|
+
self.z **= n
|
|
225
|
+
return self
|
|
226
|
+
|
|
227
|
+
# ==========================================================================
|
|
228
|
+
# Properties
|
|
229
|
+
# ==========================================================================
|
|
230
|
+
|
|
231
|
+
@property
|
|
232
|
+
def x(self):
|
|
233
|
+
return self._x
|
|
234
|
+
|
|
235
|
+
@x.setter
|
|
236
|
+
def x(self, x):
|
|
237
|
+
self._x = float(x)
|
|
238
|
+
|
|
239
|
+
@property
|
|
240
|
+
def y(self):
|
|
241
|
+
return self._y
|
|
242
|
+
|
|
243
|
+
@y.setter
|
|
244
|
+
def y(self, y):
|
|
245
|
+
self._y = float(y)
|
|
246
|
+
|
|
247
|
+
@property
|
|
248
|
+
def z(self):
|
|
249
|
+
return self._z
|
|
250
|
+
|
|
251
|
+
@z.setter
|
|
252
|
+
def z(self, z):
|
|
253
|
+
self._z = float(z)
|
|
254
|
+
|
|
255
|
+
# ==========================================================================
|
|
256
|
+
# Methods
|
|
257
|
+
# ==========================================================================
|
|
258
|
+
|
|
259
|
+
def distance_to_point(self, point):
|
|
260
|
+
"""Compute the distance to another point.
|
|
261
|
+
|
|
262
|
+
Parameters
|
|
263
|
+
----------
|
|
264
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
265
|
+
The other point.
|
|
266
|
+
|
|
267
|
+
Returns
|
|
268
|
+
-------
|
|
269
|
+
float
|
|
270
|
+
The distance.
|
|
271
|
+
|
|
272
|
+
Examples
|
|
273
|
+
--------
|
|
274
|
+
>>> a = Point(0.0, 0.0, 0.0)
|
|
275
|
+
>>> b = Point(1.0, 0.0, 0.0)
|
|
276
|
+
>>> a.distance_to_point(b)
|
|
277
|
+
1.0
|
|
278
|
+
|
|
279
|
+
"""
|
|
280
|
+
return distance_point_point(self, point)
|
|
281
|
+
|
|
282
|
+
def distance_to_line(self, line):
|
|
283
|
+
"""Compute the distance to a line.
|
|
284
|
+
|
|
285
|
+
Parameters
|
|
286
|
+
----------
|
|
287
|
+
line : [point, point] | :class:`compas.geometry.Line`
|
|
288
|
+
The line.
|
|
289
|
+
|
|
290
|
+
Returns
|
|
291
|
+
-------
|
|
292
|
+
float
|
|
293
|
+
The distance.
|
|
294
|
+
|
|
295
|
+
Examples
|
|
296
|
+
--------
|
|
297
|
+
>>> from compas.geometry import Line
|
|
298
|
+
>>> point = Point(0.0, 0.0, 0.0)
|
|
299
|
+
>>> line = Line(Point(1.0, 0.0, 0.0), Point(1.0, 1.0, 0.0))
|
|
300
|
+
>>> point.distance_to_line(line)
|
|
301
|
+
1.0
|
|
302
|
+
|
|
303
|
+
"""
|
|
304
|
+
return distance_point_line(self, line)
|
|
305
|
+
|
|
306
|
+
def distance_to_plane(self, plane):
|
|
307
|
+
"""Compute the distance to a plane.
|
|
308
|
+
|
|
309
|
+
Parameters
|
|
310
|
+
----------
|
|
311
|
+
plane : [point, vector] | :class:`compas.geometry.Plane`
|
|
312
|
+
The plane.
|
|
313
|
+
|
|
314
|
+
Returns
|
|
315
|
+
-------
|
|
316
|
+
float
|
|
317
|
+
The distance.
|
|
318
|
+
|
|
319
|
+
Examples
|
|
320
|
+
--------
|
|
321
|
+
>>> from compas.geometry import Plane
|
|
322
|
+
>>> from compas.geometry import Vector
|
|
323
|
+
>>> point = Point(0.0, 0.0, 0.0)
|
|
324
|
+
>>> plane = Plane(Point(1.0, 0.0, 0.0), Vector(1.0, 0.0, 0.0))
|
|
325
|
+
>>> point.distance_to_plane(plane)
|
|
326
|
+
1.0
|
|
327
|
+
|
|
328
|
+
"""
|
|
329
|
+
return distance_point_plane(self, plane)
|
|
330
|
+
|
|
331
|
+
# ==========================================================================
|
|
332
|
+
# 2D predicates
|
|
333
|
+
# ==========================================================================
|
|
334
|
+
|
|
335
|
+
def in_polygon(self, polygon):
|
|
336
|
+
"""Determine if the point lies inside the given polygon.
|
|
337
|
+
|
|
338
|
+
For this test, the point and polygon are assumed to lie in the XY plane.
|
|
339
|
+
The Z coordinates of the point and of the points of the polygon are ignored.
|
|
340
|
+
If the point and/or polygon do not lie in the XY plane, the result of this test is meaningless.
|
|
341
|
+
It is up to the user to apply the necessary transformations beforehand.
|
|
342
|
+
|
|
343
|
+
The polygon can be convex or concave.
|
|
344
|
+
|
|
345
|
+
Parameters
|
|
346
|
+
----------
|
|
347
|
+
polygon : sequence[point] | :class:`compas.geometry.Polygon`
|
|
348
|
+
The polygon.
|
|
349
|
+
|
|
350
|
+
Returns
|
|
351
|
+
-------
|
|
352
|
+
bool
|
|
353
|
+
True, if the point lies in the polygon.
|
|
354
|
+
False, otherwise.
|
|
355
|
+
|
|
356
|
+
See Also
|
|
357
|
+
--------
|
|
358
|
+
:meth:`in_convex_polygon`
|
|
359
|
+
|
|
360
|
+
Examples
|
|
361
|
+
--------
|
|
362
|
+
>>> from compas.geometry import Polygon
|
|
363
|
+
>>> poly = Polygon([Point(0.0, 0.0, 0.0), Point(1.0, 0.0, 0.0), Point(1.0, 1.0, 0.0), Point(0.0, 1.0, 0.0)])
|
|
364
|
+
>>> point = Point(0.5, 0.5, 0.0)
|
|
365
|
+
>>> point.in_polygon(poly)
|
|
366
|
+
True
|
|
367
|
+
|
|
368
|
+
"""
|
|
369
|
+
return is_point_in_polygon_xy(self, polygon)
|
|
370
|
+
|
|
371
|
+
def in_convex_polygon(self, polygon):
|
|
372
|
+
"""Determine if the point lies inside the given convex polygon.
|
|
373
|
+
|
|
374
|
+
For this test, the point and polygon are assumed to lie in the XY plane.
|
|
375
|
+
The Z coordinates of the point and of the points of the polygon are ignored.
|
|
376
|
+
If the point and/or polygon do not lie in the XY plane, the result of this test is meaningless.
|
|
377
|
+
It is up to the user to apply the necessary transformations beforehand.
|
|
378
|
+
|
|
379
|
+
The polygon must be convex.
|
|
380
|
+
However, the method will not check that this is indeed the case.
|
|
381
|
+
|
|
382
|
+
Parameters
|
|
383
|
+
----------
|
|
384
|
+
polygon : sequence[point] | :class:`compas.geometry.Polygon`
|
|
385
|
+
The polygon.
|
|
386
|
+
|
|
387
|
+
Returns
|
|
388
|
+
-------
|
|
389
|
+
bool
|
|
390
|
+
True, if the point lies in the polygon.
|
|
391
|
+
False, otherwise.
|
|
392
|
+
|
|
393
|
+
See Also
|
|
394
|
+
--------
|
|
395
|
+
:meth:`in_polygon`
|
|
396
|
+
|
|
397
|
+
Examples
|
|
398
|
+
--------
|
|
399
|
+
>>> from compas.geometry import Polygon
|
|
400
|
+
>>> poly = Polygon([Point(0.0, 0.0, 0.0), Point(1.0, 0.0, 0.0), Point(1.0, 1.0, 0.0), Point(0.0, 1.0, 0.0)])
|
|
401
|
+
>>> point = Point(0.5, 0.5, 0.0)
|
|
402
|
+
>>> point.in_convex_polygon(poly)
|
|
403
|
+
True
|
|
404
|
+
|
|
405
|
+
"""
|
|
406
|
+
return is_point_in_convex_polygon_xy(self, polygon)
|
|
407
|
+
|
|
408
|
+
# ==========================================================================
|
|
409
|
+
# 3D predicates
|
|
410
|
+
# ==========================================================================
|
|
411
|
+
|
|
412
|
+
def on_line(self, line, tol=None):
|
|
413
|
+
"""Determine if the point lies on the given line.
|
|
414
|
+
|
|
415
|
+
Parameters
|
|
416
|
+
----------
|
|
417
|
+
line : [point, point] | :class:`compas.geometry.Line`
|
|
418
|
+
The line.
|
|
419
|
+
tol : float, optional
|
|
420
|
+
A tolerance value for the distance between the point and the line.
|
|
421
|
+
Default is :attr:`TOL.absolute`.
|
|
422
|
+
|
|
423
|
+
Returns
|
|
424
|
+
-------
|
|
425
|
+
bool
|
|
426
|
+
True, if the point lies on the line.
|
|
427
|
+
False, otherwise.
|
|
428
|
+
|
|
429
|
+
Examples
|
|
430
|
+
--------
|
|
431
|
+
>>> from compas.geometry import Line
|
|
432
|
+
>>> line = Line(Point(1.0, 0.0, 0.0), Point(1.0, 1.0, 0.0))
|
|
433
|
+
>>> point = line.point(1.5)
|
|
434
|
+
>>> point.on_line(line)
|
|
435
|
+
True
|
|
436
|
+
|
|
437
|
+
"""
|
|
438
|
+
return TOL.is_zero(self.distance_to_line(line), tol)
|
|
439
|
+
|
|
440
|
+
def on_segment(self, segment, tol=None):
|
|
441
|
+
"""Determine if the point lies on the given segment.
|
|
442
|
+
|
|
443
|
+
Parameters
|
|
444
|
+
----------
|
|
445
|
+
segment : [point, point] | :class:`compas.geometry.Line`
|
|
446
|
+
The segment.
|
|
447
|
+
tol : float, optional
|
|
448
|
+
A tolerance value for the distance between the point and the segment.
|
|
449
|
+
Default is :attr:`TOL.absolute`.
|
|
450
|
+
|
|
451
|
+
Returns
|
|
452
|
+
-------
|
|
453
|
+
bool
|
|
454
|
+
True, if the point lies on the segment.
|
|
455
|
+
False, otherwise.
|
|
456
|
+
|
|
457
|
+
Examples
|
|
458
|
+
--------
|
|
459
|
+
>>> from compas.geometry import Line
|
|
460
|
+
>>> line = Line(Point(1.0, 0.0, 0.0), Point(1.0, 1.0, 0.0))
|
|
461
|
+
>>> point = line.point(1.5)
|
|
462
|
+
>>> point.on_segment(line)
|
|
463
|
+
False
|
|
464
|
+
|
|
465
|
+
"""
|
|
466
|
+
return is_point_on_segment(self, segment, tol=tol)
|
|
467
|
+
|
|
468
|
+
def on_polyline(self, polyline):
|
|
469
|
+
"""Determine if the point lies on the given polyline.
|
|
470
|
+
|
|
471
|
+
Parameters
|
|
472
|
+
----------
|
|
473
|
+
polyline : sequence[point] | :class:`compas.geometry.Polyline`
|
|
474
|
+
The polyline.
|
|
475
|
+
|
|
476
|
+
Returns
|
|
477
|
+
-------
|
|
478
|
+
bool
|
|
479
|
+
True, if the point lies on the polyline.
|
|
480
|
+
False, otherwise.
|
|
481
|
+
|
|
482
|
+
Examples
|
|
483
|
+
--------
|
|
484
|
+
>>> from compas.geometry import Polyline
|
|
485
|
+
>>> poly = Polyline([Point(0.0, 0.0, 0.0), Point(1.0, 0.0, 0.0), Point(2.0, 0.0, 0.0)])
|
|
486
|
+
>>> point = poly.point(0.5)
|
|
487
|
+
>>> point.on_polyline(poly)
|
|
488
|
+
True
|
|
489
|
+
|
|
490
|
+
"""
|
|
491
|
+
return is_point_on_polyline(self, polyline)
|
|
492
|
+
|
|
493
|
+
def on_plane(self, plane, tol=None):
|
|
494
|
+
"""Determine if the point lies on the given plane.
|
|
495
|
+
|
|
496
|
+
Parameters
|
|
497
|
+
----------
|
|
498
|
+
plane : :class:`compas.geometry.Plane`
|
|
499
|
+
The plane.
|
|
500
|
+
tol : float, optional
|
|
501
|
+
A tolerance value for the distance between the point and the plane.
|
|
502
|
+
Default is :attr:`TOL.absolute`.
|
|
503
|
+
|
|
504
|
+
Returns
|
|
505
|
+
-------
|
|
506
|
+
bool
|
|
507
|
+
True, if the point lies on the plane.
|
|
508
|
+
False, otherwise.
|
|
509
|
+
|
|
510
|
+
Examples
|
|
511
|
+
--------
|
|
512
|
+
>>> from compas.geometry import Plane
|
|
513
|
+
>>> from compas.geometry import Vector
|
|
514
|
+
>>> plane = Plane(Point(0.0, 0.0, 0.0), Vector(0.0, 0.0, 1.0))
|
|
515
|
+
>>> point = Point(0.5, 0.5, 0.0)
|
|
516
|
+
>>> point.on_plane(plane)
|
|
517
|
+
True
|
|
518
|
+
|
|
519
|
+
"""
|
|
520
|
+
return TOL.is_zero(self.distance_to_plane(plane), tol)
|
|
521
|
+
|
|
522
|
+
def on_circle(self, circle, tol=None):
|
|
523
|
+
"""Determine if the point lies on the given circle.
|
|
524
|
+
|
|
525
|
+
Parameters
|
|
526
|
+
----------
|
|
527
|
+
circle : :class:`compas.geometry.Circle`
|
|
528
|
+
The circle.
|
|
529
|
+
tol : float, optional
|
|
530
|
+
A tolerance value for the distance between the point and the circle.
|
|
531
|
+
Default is :attr:`TOL.absolute`.
|
|
532
|
+
|
|
533
|
+
Returns
|
|
534
|
+
-------
|
|
535
|
+
bool
|
|
536
|
+
True, if the point lies on the circle.
|
|
537
|
+
False, otherwise.
|
|
538
|
+
|
|
539
|
+
"""
|
|
540
|
+
if not self.on_plane(circle.plane, tol):
|
|
541
|
+
return False
|
|
542
|
+
return TOL.is_close(self.distance_to_point(circle.center), circle.radius, rtol=0, atol=tol)
|
|
543
|
+
|
|
544
|
+
def on_curve(self, curve, tol=None):
|
|
545
|
+
"""Determine if the point lies on the given curve.
|
|
546
|
+
|
|
547
|
+
Parameters
|
|
548
|
+
----------
|
|
549
|
+
curve : :class:`compas.geometry.Curve`
|
|
550
|
+
The curve.
|
|
551
|
+
tol : float, optional
|
|
552
|
+
A tolerance value for the distance between the point and the curve.
|
|
553
|
+
|
|
554
|
+
Returns
|
|
555
|
+
-------
|
|
556
|
+
bool
|
|
557
|
+
True, if the point lies on the curve.
|
|
558
|
+
False, otherwise.
|
|
559
|
+
|
|
560
|
+
"""
|
|
561
|
+
return TOL.is_zero(self.distance_to_point(curve.closest_point(self)), tol)
|
|
562
|
+
|
|
563
|
+
def in_triangle(self, triangle):
|
|
564
|
+
"""Determine if the point lies inside the given triangle.
|
|
565
|
+
|
|
566
|
+
Parameters
|
|
567
|
+
----------
|
|
568
|
+
triangle : [point, point, point] | :class:`compas.geometry.Polygon`
|
|
569
|
+
The triangle.
|
|
570
|
+
|
|
571
|
+
Returns
|
|
572
|
+
-------
|
|
573
|
+
bool
|
|
574
|
+
True, if the point lies in the triangle.
|
|
575
|
+
False, otherwise.
|
|
576
|
+
|
|
577
|
+
Examples
|
|
578
|
+
--------
|
|
579
|
+
>>> from compas.geometry import Polygon
|
|
580
|
+
>>> tri = Polygon([Point(0.0, 0.0, 0.0), Point(1.0, 0.0, 0.0), Point(0.5, 1.0, 0.0)])
|
|
581
|
+
>>> point = Point(0.5, 0.5, 0.0)
|
|
582
|
+
>>> point.in_triangle(tri)
|
|
583
|
+
True
|
|
584
|
+
|
|
585
|
+
"""
|
|
586
|
+
return is_point_in_triangle(self, triangle)
|
|
587
|
+
|
|
588
|
+
def in_circle(self, circle):
|
|
589
|
+
"""Determine if the point lies inside the given circle.
|
|
590
|
+
|
|
591
|
+
Parameters
|
|
592
|
+
----------
|
|
593
|
+
circle : :class:`compas.geometry.Circle`
|
|
594
|
+
The circle.
|
|
595
|
+
|
|
596
|
+
Returns
|
|
597
|
+
-------
|
|
598
|
+
bool
|
|
599
|
+
True, if the point lies inside the circle.
|
|
600
|
+
False, otherwise.
|
|
601
|
+
|
|
602
|
+
Examples
|
|
603
|
+
--------
|
|
604
|
+
>>> from compas.geometry import Vector
|
|
605
|
+
>>> from compas.geometry import Plane
|
|
606
|
+
>>> from compas.geometry import Circle
|
|
607
|
+
>>> circle = Circle(Plane(Point(0.0, 0.0, 0.0), Vector(0.0, 0.0, 1.0)), 1.0)
|
|
608
|
+
>>> point = Point(0.5, 0.0, 0.0)
|
|
609
|
+
>>> point.in_circle(circle)
|
|
610
|
+
True
|
|
611
|
+
|
|
612
|
+
"""
|
|
613
|
+
return is_point_in_circle(self, (circle.plane, circle.radius))
|
|
614
|
+
|
|
615
|
+
def in_polyhedron(self, polyhedron):
|
|
616
|
+
"""Determine if the point lies inside the given polyhedron.
|
|
617
|
+
|
|
618
|
+
This method verifies that the point lies behind the planes of all the faces of the polyhedron.
|
|
619
|
+
Therefore, if the polyhedron is not convex, or if the faces are not planar, the result of this test is meaningless.
|
|
620
|
+
Convexity and planarity are not checked.
|
|
621
|
+
|
|
622
|
+
Parameters
|
|
623
|
+
----------
|
|
624
|
+
polyhedron : [vertices, faces] | :class:`compas.geometry.Polyhedron`
|
|
625
|
+
The polyhedron.
|
|
626
|
+
|
|
627
|
+
Returns
|
|
628
|
+
-------
|
|
629
|
+
bool
|
|
630
|
+
True, if the point lies on the polyline.
|
|
631
|
+
False, otherwise.
|
|
632
|
+
|
|
633
|
+
"""
|
|
634
|
+
vertices, faces = polyhedron
|
|
635
|
+
polygons = [[vertices[index] for index in face] for face in faces]
|
|
636
|
+
planes = [[centroid_points(polygon), normal_polygon(polygon)] for polygon in polygons]
|
|
637
|
+
return all(is_point_behind_plane(self, plane) for plane in planes)
|
|
638
|
+
|
|
639
|
+
# ==========================================================================
|
|
640
|
+
# Transformations
|
|
641
|
+
# ==========================================================================
|
|
642
|
+
|
|
643
|
+
def transform(self, T):
|
|
644
|
+
"""Transform this point.
|
|
645
|
+
|
|
646
|
+
Parameters
|
|
647
|
+
----------
|
|
648
|
+
T : :class:`compas.geometry.Transformation` | list[list[float]]
|
|
649
|
+
The transformation matrix.
|
|
650
|
+
|
|
651
|
+
Examples
|
|
652
|
+
--------
|
|
653
|
+
>>> from compas.geometry import Translation
|
|
654
|
+
>>> point = Point(0.0, 0.0, 0.0)
|
|
655
|
+
>>> T = Translation.from_vector([1.0, 1.0, 1.0])
|
|
656
|
+
>>> point.transform(T)
|
|
657
|
+
>>> point.x == 1.0
|
|
658
|
+
True
|
|
659
|
+
|
|
660
|
+
"""
|
|
661
|
+
point = transform_points([self], T)[0]
|
|
662
|
+
self.x = point[0]
|
|
663
|
+
self.y = point[1]
|
|
664
|
+
self.z = point[2]
|