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,724 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from compas.geometry import Frame
|
|
6
|
+
from compas.geometry import Line
|
|
7
|
+
from compas.geometry import Point
|
|
8
|
+
from compas.geometry import is_point_on_line
|
|
9
|
+
from compas.geometry import is_point_on_polyline
|
|
10
|
+
from compas.geometry import transform_points
|
|
11
|
+
from compas.itertools import pairwise
|
|
12
|
+
from compas.tolerance import TOL
|
|
13
|
+
|
|
14
|
+
from .curve import Curve
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
class Polyline(Curve):
|
|
18
|
+
"""A polyline is a curve defined by a sequence of points connected by line segments.
|
|
19
|
+
|
|
20
|
+
A Polyline can be open or closed.
|
|
21
|
+
It can be self-intersecting.
|
|
22
|
+
It does not have an interior.
|
|
23
|
+
|
|
24
|
+
The parameter space is defined along the consecutive direction vectors of the line segments of the polyline.
|
|
25
|
+
The coordinate system of the parametrisation is the world coordinate system.
|
|
26
|
+
Transformations of polylines are defined as transformations of the points defining the polyline.
|
|
27
|
+
|
|
28
|
+
Parameters
|
|
29
|
+
----------
|
|
30
|
+
points : list[[float, float, float] | :class:`compas.geometry.Point`]
|
|
31
|
+
An ordered list of points.
|
|
32
|
+
Each consecutive pair of points forms a segment of the polyline.
|
|
33
|
+
name : str, optional
|
|
34
|
+
The name of the polyline.
|
|
35
|
+
|
|
36
|
+
Attributes
|
|
37
|
+
----------
|
|
38
|
+
frame : :class:`compas.geometry.Frame`, read-only
|
|
39
|
+
The frame of the spatial coordinates of the polyline.
|
|
40
|
+
This is always the world XY frame.
|
|
41
|
+
points : list[:class:`compas.geometry.Point`]
|
|
42
|
+
The points of the polyline.
|
|
43
|
+
lines : list[:class:`compas.geometry.Line`], read-only
|
|
44
|
+
The lines of the polyline.
|
|
45
|
+
length : float, read-only
|
|
46
|
+
The length of the polyline.
|
|
47
|
+
start : :class:`compas.geometry.Point`, read-only
|
|
48
|
+
The start point of the polyline.
|
|
49
|
+
end : :class:`compas.geometry.Point`, read-only
|
|
50
|
+
The end point of the polyline.
|
|
51
|
+
is_selfintersecting : bool, read-only
|
|
52
|
+
True if the polyline is self-intersecting.
|
|
53
|
+
is_closed : bool, read-only
|
|
54
|
+
True if the polyline is closed.
|
|
55
|
+
|
|
56
|
+
Examples
|
|
57
|
+
--------
|
|
58
|
+
>>> polyline = Polyline([[0, 0, 0], [1, 0, 0], [2, 0, 0], [3, 0, 0]])
|
|
59
|
+
>>> polyline.length
|
|
60
|
+
3.0
|
|
61
|
+
|
|
62
|
+
>>> type(polyline.points[0]) == Point
|
|
63
|
+
True
|
|
64
|
+
>>> polyline.points[0].x
|
|
65
|
+
0.0
|
|
66
|
+
|
|
67
|
+
>>> type(polyline.lines[0]) == Line
|
|
68
|
+
True
|
|
69
|
+
>>> polyline.lines[0].length
|
|
70
|
+
1.0
|
|
71
|
+
|
|
72
|
+
"""
|
|
73
|
+
|
|
74
|
+
# overwriting the __new__ method is necessary
|
|
75
|
+
# to avoid triggering the plugin mechanism of the base curve class
|
|
76
|
+
def __new__(cls, *args, **kwargs):
|
|
77
|
+
curve = object.__new__(cls)
|
|
78
|
+
curve.__init__(*args, **kwargs)
|
|
79
|
+
return curve
|
|
80
|
+
|
|
81
|
+
DATASCHEMA = {
|
|
82
|
+
"type": "object",
|
|
83
|
+
"properties": {
|
|
84
|
+
"points": {"type": "array", "minItems": 2, "items": Point.DATASCHEMA},
|
|
85
|
+
},
|
|
86
|
+
"required": ["points"],
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
@property
|
|
90
|
+
def __data__(self):
|
|
91
|
+
return {"points": [point.__data__ for point in self.points]}
|
|
92
|
+
|
|
93
|
+
def __init__(self, points, name=None):
|
|
94
|
+
super(Polyline, self).__init__(name=name)
|
|
95
|
+
self._points = []
|
|
96
|
+
self._lines = []
|
|
97
|
+
self.points = points
|
|
98
|
+
|
|
99
|
+
def __repr__(self):
|
|
100
|
+
return "{0}({1!r})".format(
|
|
101
|
+
type(self).__name__,
|
|
102
|
+
self.points,
|
|
103
|
+
)
|
|
104
|
+
|
|
105
|
+
def __getitem__(self, key):
|
|
106
|
+
return self.points[key]
|
|
107
|
+
|
|
108
|
+
def __setitem__(self, key, value):
|
|
109
|
+
self.points[key] = Point(*value)
|
|
110
|
+
self._lines = None
|
|
111
|
+
|
|
112
|
+
def __iter__(self):
|
|
113
|
+
return iter(self.points)
|
|
114
|
+
|
|
115
|
+
def __len__(self):
|
|
116
|
+
return len(self.points)
|
|
117
|
+
|
|
118
|
+
def __eq__(self, other):
|
|
119
|
+
if not hasattr(other, "__iter__") or not hasattr(other, "__len__") or len(self) != len(other):
|
|
120
|
+
return False
|
|
121
|
+
return TOL.is_allclose(self, other)
|
|
122
|
+
|
|
123
|
+
# ==========================================================================
|
|
124
|
+
# properties
|
|
125
|
+
# ==========================================================================
|
|
126
|
+
|
|
127
|
+
@property
|
|
128
|
+
def frame(self):
|
|
129
|
+
return Frame.worldXY()
|
|
130
|
+
|
|
131
|
+
@frame.setter
|
|
132
|
+
def frame(self, frame):
|
|
133
|
+
raise AttributeError("Setting the coordinate frame of a polyline is not supported.")
|
|
134
|
+
|
|
135
|
+
@property
|
|
136
|
+
def points(self):
|
|
137
|
+
return self._points
|
|
138
|
+
|
|
139
|
+
@points.setter
|
|
140
|
+
def points(self, points):
|
|
141
|
+
self._points = [Point(*xyz) for xyz in points]
|
|
142
|
+
self._lines = None
|
|
143
|
+
|
|
144
|
+
@property
|
|
145
|
+
def lines(self):
|
|
146
|
+
if self._lines is None:
|
|
147
|
+
self._lines = [Line(a, b) for a, b in pairwise(self.points)]
|
|
148
|
+
return self._lines
|
|
149
|
+
|
|
150
|
+
@property
|
|
151
|
+
def length(self):
|
|
152
|
+
return sum([line.length for line in self.lines])
|
|
153
|
+
|
|
154
|
+
@property
|
|
155
|
+
def start(self):
|
|
156
|
+
return self.points[0]
|
|
157
|
+
|
|
158
|
+
@property
|
|
159
|
+
def end(self):
|
|
160
|
+
return self.points[-1]
|
|
161
|
+
|
|
162
|
+
@property
|
|
163
|
+
def is_selfintersecting(self):
|
|
164
|
+
raise NotImplementedError
|
|
165
|
+
|
|
166
|
+
@property
|
|
167
|
+
def is_closed(self):
|
|
168
|
+
return self.points[0] == self.points[-1]
|
|
169
|
+
|
|
170
|
+
# ==========================================================================
|
|
171
|
+
# Constructors
|
|
172
|
+
# ==========================================================================
|
|
173
|
+
|
|
174
|
+
# ==========================================================================
|
|
175
|
+
# Transformations
|
|
176
|
+
# ==========================================================================
|
|
177
|
+
|
|
178
|
+
def transform(self, T):
|
|
179
|
+
"""Transform this polyline.
|
|
180
|
+
|
|
181
|
+
Parameters
|
|
182
|
+
----------
|
|
183
|
+
T : :class:`compas.geometry.Transformation` | list[list[float]]
|
|
184
|
+
The transformation.
|
|
185
|
+
|
|
186
|
+
Examples
|
|
187
|
+
--------
|
|
188
|
+
>>> from math import radians
|
|
189
|
+
>>> from compas.geometry import Rotation
|
|
190
|
+
>>> polyline = Polyline([[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0], [0.0, 1.0, 0.0], [0.0, 0.0, 0.0]])
|
|
191
|
+
>>> R = Rotation.from_axis_and_angle([0.0, 0.0, 1.0], radians(90))
|
|
192
|
+
>>> polyline.transform(R)
|
|
193
|
+
|
|
194
|
+
"""
|
|
195
|
+
for index, point in enumerate(transform_points(self.points, T)):
|
|
196
|
+
self.points[index].x = point[0]
|
|
197
|
+
self.points[index].y = point[1]
|
|
198
|
+
self.points[index].z = point[2]
|
|
199
|
+
|
|
200
|
+
# ==========================================================================
|
|
201
|
+
# Methods
|
|
202
|
+
# ==========================================================================
|
|
203
|
+
|
|
204
|
+
def append(self, point):
|
|
205
|
+
"""Append a point to the end of the polyline.
|
|
206
|
+
|
|
207
|
+
Parameters
|
|
208
|
+
----------
|
|
209
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
210
|
+
The point to append.
|
|
211
|
+
|
|
212
|
+
"""
|
|
213
|
+
self.points.append(Point(*point))
|
|
214
|
+
self._lines = None
|
|
215
|
+
|
|
216
|
+
def insert(self, i, point):
|
|
217
|
+
"""Insert a point at the specified index.
|
|
218
|
+
|
|
219
|
+
Parameters
|
|
220
|
+
----------
|
|
221
|
+
i : int
|
|
222
|
+
The index of the insertion point.
|
|
223
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
224
|
+
The point to insert.
|
|
225
|
+
|
|
226
|
+
"""
|
|
227
|
+
self.points.insert(i, Point(*point))
|
|
228
|
+
self._lines = None
|
|
229
|
+
|
|
230
|
+
def point_at(self, t, snap=False):
|
|
231
|
+
"""Point on the polyline at a specific normalized parameter.
|
|
232
|
+
|
|
233
|
+
Parameters
|
|
234
|
+
----------
|
|
235
|
+
t : float
|
|
236
|
+
The parameter value.
|
|
237
|
+
snap : bool, optional
|
|
238
|
+
If True, return the closest polyline point.
|
|
239
|
+
|
|
240
|
+
Returns
|
|
241
|
+
-------
|
|
242
|
+
:class:`compas.geometry.Point`
|
|
243
|
+
The point on the polyline.
|
|
244
|
+
|
|
245
|
+
Examples
|
|
246
|
+
--------
|
|
247
|
+
>>> polyline = Polyline([[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0]])
|
|
248
|
+
>>> polyline.point(0.75)
|
|
249
|
+
Point(1.000, 0.500, 0.000)
|
|
250
|
+
|
|
251
|
+
"""
|
|
252
|
+
if t < 0 or t > 1:
|
|
253
|
+
return None
|
|
254
|
+
|
|
255
|
+
points = self.points
|
|
256
|
+
if t == 0:
|
|
257
|
+
return points[0]
|
|
258
|
+
if t == 1:
|
|
259
|
+
return points[-1]
|
|
260
|
+
|
|
261
|
+
polyline_length = self.length
|
|
262
|
+
|
|
263
|
+
x = 0
|
|
264
|
+
i = 0
|
|
265
|
+
while x <= t:
|
|
266
|
+
line = Line(points[i], points[i + 1])
|
|
267
|
+
line_length = line.length
|
|
268
|
+
dx = line_length / polyline_length
|
|
269
|
+
if x + dx > t:
|
|
270
|
+
if snap:
|
|
271
|
+
if t - x < x + dx - t:
|
|
272
|
+
return line.start
|
|
273
|
+
else:
|
|
274
|
+
return line.end
|
|
275
|
+
return line.point_at((t - x) * polyline_length / line_length)
|
|
276
|
+
x += dx
|
|
277
|
+
i += 1
|
|
278
|
+
|
|
279
|
+
def parameter_at(self, point, tol=None):
|
|
280
|
+
"""Parameter of the polyline at a specific point.
|
|
281
|
+
|
|
282
|
+
Parameters
|
|
283
|
+
----------
|
|
284
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
285
|
+
The point on the polyline.
|
|
286
|
+
tol : float, optional
|
|
287
|
+
A tolerance value for verifying that the point is on the polyline.
|
|
288
|
+
Default is :attr:`TOL.absolute`.
|
|
289
|
+
|
|
290
|
+
Returns
|
|
291
|
+
-------
|
|
292
|
+
float
|
|
293
|
+
The parameter of the polyline.
|
|
294
|
+
|
|
295
|
+
Examples
|
|
296
|
+
--------
|
|
297
|
+
>>> from compas.geometry import Point
|
|
298
|
+
>>> polyline = Polyline([[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0]])
|
|
299
|
+
>>> polyline.parameter_at(Point(0.1, 0.0, 0.0))
|
|
300
|
+
0.5
|
|
301
|
+
|
|
302
|
+
"""
|
|
303
|
+
if not is_point_on_polyline(point, self, tol):
|
|
304
|
+
raise Exception("{} not found!".format(point))
|
|
305
|
+
dx = 0
|
|
306
|
+
for line in self.lines:
|
|
307
|
+
if not is_point_on_line(point, line, tol):
|
|
308
|
+
dx += line.length
|
|
309
|
+
continue
|
|
310
|
+
dx += line.start.distance_to_point(point)
|
|
311
|
+
break
|
|
312
|
+
return dx / self.length
|
|
313
|
+
|
|
314
|
+
def tangent_at(self, t):
|
|
315
|
+
"""Tangent vector at a specific normalized parameter.
|
|
316
|
+
|
|
317
|
+
Parameters
|
|
318
|
+
----------
|
|
319
|
+
t : float
|
|
320
|
+
The parameter value.
|
|
321
|
+
|
|
322
|
+
Returns
|
|
323
|
+
-------
|
|
324
|
+
:class:`compas.geometry.Vector`
|
|
325
|
+
The tangent vector at the specified parameter.
|
|
326
|
+
|
|
327
|
+
Examples
|
|
328
|
+
--------
|
|
329
|
+
>>> polyline = Polyline([[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0]])
|
|
330
|
+
>>> polyline.tangent(0.75)
|
|
331
|
+
Vector(0.000, 1.000, 0.000)
|
|
332
|
+
|
|
333
|
+
"""
|
|
334
|
+
if t < 0 or t > 1:
|
|
335
|
+
return None
|
|
336
|
+
|
|
337
|
+
points = self.points
|
|
338
|
+
if t == 0:
|
|
339
|
+
return points[1] - points[0]
|
|
340
|
+
if t == 1:
|
|
341
|
+
return points[-1] - points[-2]
|
|
342
|
+
|
|
343
|
+
polyline_length = self.length
|
|
344
|
+
|
|
345
|
+
x = 0
|
|
346
|
+
i = 0
|
|
347
|
+
while x <= t:
|
|
348
|
+
line = Line(points[i], points[i + 1])
|
|
349
|
+
line_length = line.length
|
|
350
|
+
dx = line_length / polyline_length
|
|
351
|
+
if x + dx > t:
|
|
352
|
+
return line.direction
|
|
353
|
+
x += dx
|
|
354
|
+
i += 1
|
|
355
|
+
|
|
356
|
+
def tangent_at_point(self, point):
|
|
357
|
+
"""Calculates the tangent vector of a point on a polyline
|
|
358
|
+
|
|
359
|
+
Parameters
|
|
360
|
+
----------
|
|
361
|
+
point: [float, float, float] | :class:`compas.geometry.Point`
|
|
362
|
+
|
|
363
|
+
Returns
|
|
364
|
+
-------
|
|
365
|
+
:class:`compas.geometry.Vector`
|
|
366
|
+
|
|
367
|
+
"""
|
|
368
|
+
for line in self.lines:
|
|
369
|
+
if is_point_on_line(point, line):
|
|
370
|
+
return line.direction
|
|
371
|
+
raise Exception("{} not found!".format(point))
|
|
372
|
+
|
|
373
|
+
def split_at_corners(self, angle_threshold):
|
|
374
|
+
"""Splits a polyline at corners larger than the given angle_threshold
|
|
375
|
+
|
|
376
|
+
Parameters
|
|
377
|
+
----------
|
|
378
|
+
angle_threshold : float
|
|
379
|
+
In radians.
|
|
380
|
+
|
|
381
|
+
Returns
|
|
382
|
+
-------
|
|
383
|
+
list[:class:`compas.geometry.Polyline`]
|
|
384
|
+
|
|
385
|
+
"""
|
|
386
|
+
corner_ids = []
|
|
387
|
+
split_polylines = []
|
|
388
|
+
points = self.points
|
|
389
|
+
seg_ids = list(range(len(self.lines)))
|
|
390
|
+
|
|
391
|
+
if self.is_closed:
|
|
392
|
+
seg_ids.append(0)
|
|
393
|
+
|
|
394
|
+
for seg1, seg2 in pairwise(seg_ids):
|
|
395
|
+
angle = self.lines[seg2].vector.angle(-self.lines[seg1].vector)
|
|
396
|
+
if angle >= angle_threshold:
|
|
397
|
+
corner_ids.append(seg1 + 1)
|
|
398
|
+
|
|
399
|
+
if self.is_closed and len(corner_ids) > 0:
|
|
400
|
+
if corner_ids[-1] != len(points):
|
|
401
|
+
corner_ids = [corner_ids[-1]] + corner_ids
|
|
402
|
+
else:
|
|
403
|
+
corner_ids = [0] + corner_ids + [len(points)]
|
|
404
|
+
|
|
405
|
+
for id1, id2 in pairwise(corner_ids):
|
|
406
|
+
if id1 < id2:
|
|
407
|
+
split_polylines.append(Polyline(points[id1 : id2 + 1]))
|
|
408
|
+
else:
|
|
409
|
+
looped_pts = [points[i] for i in range(id1, len(points))] + points[1 : id2 + 1]
|
|
410
|
+
split_polylines.append(Polyline(looped_pts))
|
|
411
|
+
|
|
412
|
+
if self.is_closed and not corner_ids:
|
|
413
|
+
return [Polyline(self.points)]
|
|
414
|
+
|
|
415
|
+
return split_polylines
|
|
416
|
+
|
|
417
|
+
def divide_at_corners(self, angle_threshold):
|
|
418
|
+
"""Divides a polyline at corners larger than the given angle_threshold
|
|
419
|
+
|
|
420
|
+
Parameters
|
|
421
|
+
----------
|
|
422
|
+
angle_threshold : float
|
|
423
|
+
In radians.
|
|
424
|
+
|
|
425
|
+
Returns
|
|
426
|
+
-------
|
|
427
|
+
list[:class:`compas.geometry.Point`]
|
|
428
|
+
|
|
429
|
+
"""
|
|
430
|
+
corner_ids = []
|
|
431
|
+
seg_ids = list(range(len(self.lines)))
|
|
432
|
+
if self.is_closed:
|
|
433
|
+
seg_ids.insert(0, seg_ids[-1])
|
|
434
|
+
|
|
435
|
+
for seg1, seg2 in pairwise(seg_ids):
|
|
436
|
+
angle = self.lines[seg2].vector.angle(-self.lines[seg1].vector)
|
|
437
|
+
if angle >= angle_threshold:
|
|
438
|
+
corner_ids.append(seg1 + 1)
|
|
439
|
+
return [self.points[i] for i in corner_ids]
|
|
440
|
+
|
|
441
|
+
def divide(self, num_segments):
|
|
442
|
+
"""Divide a polyline in equal segments.
|
|
443
|
+
|
|
444
|
+
Parameters
|
|
445
|
+
----------
|
|
446
|
+
num_segments : int
|
|
447
|
+
|
|
448
|
+
Returns
|
|
449
|
+
-------
|
|
450
|
+
list
|
|
451
|
+
list[:class:`compas.geometry.Point`]
|
|
452
|
+
|
|
453
|
+
Examples
|
|
454
|
+
--------
|
|
455
|
+
>>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
|
|
456
|
+
>>> divided_polylines = polyline.divide(3)
|
|
457
|
+
>>> divided_polyline
|
|
458
|
+
[Point(0.000, 0.000, 0.000), Point(1.578, 2.157, 0.000), Point(3.578, 3.789, 0.000), Point(5.000, 2.000, 0.000)]
|
|
459
|
+
|
|
460
|
+
"""
|
|
461
|
+
segment_length = self.length / num_segments
|
|
462
|
+
return self.divide_by_length(segment_length, False)
|
|
463
|
+
|
|
464
|
+
def divide_by_length(self, length, strict=True, tol=1e-06):
|
|
465
|
+
"""Divide a polyline in segments of a given length.
|
|
466
|
+
|
|
467
|
+
Parameters
|
|
468
|
+
----------
|
|
469
|
+
length : float
|
|
470
|
+
Length of the segments.
|
|
471
|
+
strict : bool, optional
|
|
472
|
+
If False, the remainder segment will be added even if it is smaller than the desired length
|
|
473
|
+
tol : float, optional
|
|
474
|
+
Floating point error tolerance.
|
|
475
|
+
|
|
476
|
+
Returns
|
|
477
|
+
-------
|
|
478
|
+
list[:class:`compas.geometry.Point`]
|
|
479
|
+
|
|
480
|
+
Notes
|
|
481
|
+
-----
|
|
482
|
+
The points of the new polyline are constrained to the segments of the old polyline.
|
|
483
|
+
However, since the old points are not part of the new set of points, the geometry of the polyline will change.
|
|
484
|
+
|
|
485
|
+
Examples
|
|
486
|
+
--------
|
|
487
|
+
>>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
|
|
488
|
+
>>> divided_polylines = polyline.divide_by_length(3)
|
|
489
|
+
>>> divided_polyline
|
|
490
|
+
[Point(0.000, 0.000, 0.000), Point(1.709, 2.418, 0.000), Point(4.051, 3.898, 0.000)]
|
|
491
|
+
|
|
492
|
+
>>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
|
|
493
|
+
>>> divided_polylines = polyline.divide_by_length(3, strict=False)
|
|
494
|
+
>>> divided_polyline
|
|
495
|
+
[Point(0.000, 0.000, 0.000), Point(1.709, 2.418, 0.000), Point(4.051, 3.898, 0.000), Point(5.000, 2.000, 0.000)]
|
|
496
|
+
|
|
497
|
+
"""
|
|
498
|
+
num_pts = int(self.length / length)
|
|
499
|
+
total_length = [0, 0]
|
|
500
|
+
division_pts = [self.points[0]]
|
|
501
|
+
new_polyline = self
|
|
502
|
+
|
|
503
|
+
for i in range(num_pts):
|
|
504
|
+
for i_ln, line in enumerate(new_polyline.lines):
|
|
505
|
+
total_length.append(total_length[-1] + line.length) # type: ignore
|
|
506
|
+
if total_length[-1] > length:
|
|
507
|
+
amp = (length - total_length[-2]) / line.length
|
|
508
|
+
new_pt = line.start + line.vector.scaled(amp)
|
|
509
|
+
division_pts.append(new_pt)
|
|
510
|
+
total_length = [0, 0]
|
|
511
|
+
remaining_pts = new_polyline.points[i_ln + 2 :]
|
|
512
|
+
new_polyline = Polyline([new_pt, line.end] + remaining_pts)
|
|
513
|
+
break
|
|
514
|
+
elif total_length[-1] == length:
|
|
515
|
+
total_length = [0, 0]
|
|
516
|
+
division_pts.append(line.end)
|
|
517
|
+
|
|
518
|
+
if len(division_pts) == num_pts + 1:
|
|
519
|
+
break
|
|
520
|
+
|
|
521
|
+
if strict is False and not self.is_closed and len(division_pts) < num_pts + 1:
|
|
522
|
+
division_pts.append(new_polyline.points[-1])
|
|
523
|
+
elif strict is False and division_pts[-1].distance_to_point(self.points[-1]) > tol:
|
|
524
|
+
division_pts.append(self.points[-1])
|
|
525
|
+
|
|
526
|
+
return division_pts
|
|
527
|
+
|
|
528
|
+
def split_by_length(self, length, strict=True):
|
|
529
|
+
"""Split a polyline in segments of a given length.
|
|
530
|
+
|
|
531
|
+
Parameters
|
|
532
|
+
----------
|
|
533
|
+
length : float
|
|
534
|
+
Length of the segments.
|
|
535
|
+
strict : bool, optional
|
|
536
|
+
If False, the remainder segment will be added even if it is smaller than the desired length
|
|
537
|
+
tol : float, optional
|
|
538
|
+
Floating point error tolerance.
|
|
539
|
+
|
|
540
|
+
Returns
|
|
541
|
+
-------
|
|
542
|
+
list[:class:`compas.geometry.Polyline`]
|
|
543
|
+
|
|
544
|
+
Examples
|
|
545
|
+
--------
|
|
546
|
+
>>> from compas.geometry import Polyline
|
|
547
|
+
>>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
|
|
548
|
+
>>> split_polylines = polyline.split_polyline_by_length(3)
|
|
549
|
+
>>> split_polylines
|
|
550
|
+
[Polyline([Point(0.000, 0.000, 0.000), Point(1.000, 1.000, 0.000), Point(1.709, 2.418, 0.000)]),\
|
|
551
|
+
Polyline([Point(1.709, 2.418, 0.000), Point(2.000, 3.000, 0.000), Point(4.000, 4.000, 0.000),\
|
|
552
|
+
Point(4.051, 3.898, 0.000)])]
|
|
553
|
+
|
|
554
|
+
>>> from compas.geometry import Polyline
|
|
555
|
+
>>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
|
|
556
|
+
>>> split_polylines = polyline.split_polyline_by_length(3, strict=False)
|
|
557
|
+
>>> split_polylines
|
|
558
|
+
[Polyline([Point(0.000, 0.000, 0.000), Point(1.000, 1.000, 0.000), Point(1.709, 2.418, 0.000)]),\
|
|
559
|
+
Polyline([Point(1.709, 2.418, 0.000), Point(2.000, 3.000, 0.000), Point(4.000, 4.000, 0.000),\
|
|
560
|
+
Point(4.051, 3.898, 0.000)]), Polyline([Point(4.051, 3.898, 0.000), Point(5.000, 2.000, 0.000)])]
|
|
561
|
+
|
|
562
|
+
"""
|
|
563
|
+
if length <= 0:
|
|
564
|
+
raise ValueError("Length should be bigger than 0.")
|
|
565
|
+
elif length > self.length:
|
|
566
|
+
raise ValueError("Polyline length {0} is smaller than input length {1}.".format(self.length, length))
|
|
567
|
+
divided_polylines = []
|
|
568
|
+
polyline_copy = self.copy()
|
|
569
|
+
segment = Polyline([self[0]]) # Start a new segment
|
|
570
|
+
i, current_length = 0, 0
|
|
571
|
+
polyline_points_num = len(polyline_copy)
|
|
572
|
+
while i < polyline_points_num - 1:
|
|
573
|
+
pt1, pt2 = polyline_copy.points[i : i + 2]
|
|
574
|
+
line_length = pt1.distance_to_point(pt2)
|
|
575
|
+
current_length += line_length
|
|
576
|
+
if current_length <= length:
|
|
577
|
+
segment.points.append(pt2)
|
|
578
|
+
i += 1
|
|
579
|
+
else:
|
|
580
|
+
amp = 1 - ((current_length - length) / line_length)
|
|
581
|
+
new_pt = pt1 + (pt2 - pt1).scaled(amp)
|
|
582
|
+
polyline_copy.points.insert(i + 1, new_pt)
|
|
583
|
+
segment.points.append(new_pt)
|
|
584
|
+
divided_polylines.append(segment)
|
|
585
|
+
segment = Polyline([new_pt]) # Start a new segment
|
|
586
|
+
current_length = 0
|
|
587
|
+
i += 1
|
|
588
|
+
polyline_points_num = len(polyline_copy)
|
|
589
|
+
if not strict and len(divided_polylines):
|
|
590
|
+
divided_polylines.append(segment) # Add the last segment
|
|
591
|
+
return divided_polylines
|
|
592
|
+
|
|
593
|
+
def split(self, num_segments):
|
|
594
|
+
"""Split a polyline in equal segments.
|
|
595
|
+
|
|
596
|
+
Parameters
|
|
597
|
+
----------
|
|
598
|
+
num_segments : int
|
|
599
|
+
|
|
600
|
+
Returns
|
|
601
|
+
-------
|
|
602
|
+
list
|
|
603
|
+
list[:class:`compas.geometry.Polyline`]
|
|
604
|
+
|
|
605
|
+
Examples
|
|
606
|
+
--------
|
|
607
|
+
>>> from compas.geometry import Polyline
|
|
608
|
+
>>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
|
|
609
|
+
>>> split_polylines = polyline.split_polyline(3)
|
|
610
|
+
>>> split_polylines
|
|
611
|
+
[Polyline([Point(0.000, 0.000, 0.000), Point(1.000, 1.000, 0.000), Point(1.578, 2.157, 0.000)]),\
|
|
612
|
+
Polyline([Point(1.578, 2.157, 0.000), Point(2.000, 3.000, 0.000), Point(3.578, 3.789, 0.000)]),\
|
|
613
|
+
Polyline([Point(3.578, 3.789, 0.000), Point(4.000, 4.000, 0.000), Point(5.000, 2.000, 0.000)])]
|
|
614
|
+
"""
|
|
615
|
+
if num_segments < 1:
|
|
616
|
+
raise ValueError("Number of segments must be greater than or equal to 1.")
|
|
617
|
+
elif num_segments == 1:
|
|
618
|
+
return [self]
|
|
619
|
+
total_length = self.length
|
|
620
|
+
segment_length = total_length / num_segments
|
|
621
|
+
return self.split_by_length(segment_length, False)
|
|
622
|
+
|
|
623
|
+
def extend(self, length):
|
|
624
|
+
"""Extends a polyline by a given length, by modifying the first and/or last point tangentially.
|
|
625
|
+
|
|
626
|
+
Parameters
|
|
627
|
+
----------
|
|
628
|
+
length: float or tuple[float, float]
|
|
629
|
+
A single length value to extend the polyline only at the end,
|
|
630
|
+
or two length values to extend at both ends.
|
|
631
|
+
|
|
632
|
+
Returns
|
|
633
|
+
-------
|
|
634
|
+
None
|
|
635
|
+
|
|
636
|
+
"""
|
|
637
|
+
try:
|
|
638
|
+
start, end = length
|
|
639
|
+
self.points[0] = self.points[0] + self.lines[0].vector.unitized().scaled(-start)
|
|
640
|
+
self._lines = None
|
|
641
|
+
except TypeError:
|
|
642
|
+
start = end = length
|
|
643
|
+
self.points[-1] = self.points[-1] + self.lines[-1].vector.unitized().scaled(end)
|
|
644
|
+
self._lines = None
|
|
645
|
+
|
|
646
|
+
def extended(self, length):
|
|
647
|
+
"""Returns a copy of this polyline extended by a given length.
|
|
648
|
+
|
|
649
|
+
Parameters
|
|
650
|
+
----------
|
|
651
|
+
length: float or tuple[float, float]
|
|
652
|
+
A single length value to extend the polyline only at the end,
|
|
653
|
+
or two length values to extend at both ends.
|
|
654
|
+
|
|
655
|
+
Returns
|
|
656
|
+
-------
|
|
657
|
+
:class:`compas.geometry.Polyline`
|
|
658
|
+
|
|
659
|
+
"""
|
|
660
|
+
crv = self.copy()
|
|
661
|
+
crv.extend(length)
|
|
662
|
+
return crv
|
|
663
|
+
|
|
664
|
+
def shorten(self, length):
|
|
665
|
+
"""Shortens a polyline by a given length.
|
|
666
|
+
|
|
667
|
+
Parameters
|
|
668
|
+
----------
|
|
669
|
+
length: float or tuple[float, float]
|
|
670
|
+
A single length value to shorten the polyline only at the end,
|
|
671
|
+
or two length values to shorten at both ends.
|
|
672
|
+
|
|
673
|
+
Returns
|
|
674
|
+
-------
|
|
675
|
+
None
|
|
676
|
+
|
|
677
|
+
"""
|
|
678
|
+
try:
|
|
679
|
+
start, end = length
|
|
680
|
+
total_length = 0
|
|
681
|
+
for line in self.lines:
|
|
682
|
+
total_length += line.length
|
|
683
|
+
if total_length < start:
|
|
684
|
+
del self.points[0]
|
|
685
|
+
elif total_length == start:
|
|
686
|
+
del self.points[0]
|
|
687
|
+
break
|
|
688
|
+
else:
|
|
689
|
+
self.points[0] = line.end + line.vector.unitized().scaled(-(total_length - start))
|
|
690
|
+
break
|
|
691
|
+
except TypeError:
|
|
692
|
+
start = end = length
|
|
693
|
+
|
|
694
|
+
total_length = 0
|
|
695
|
+
for i in range(len(self.lines)):
|
|
696
|
+
line = self.lines[-(i + 1)]
|
|
697
|
+
total_length += line.length
|
|
698
|
+
if total_length < end:
|
|
699
|
+
del self.points[-1]
|
|
700
|
+
elif total_length == end:
|
|
701
|
+
del self.points[-1]
|
|
702
|
+
break
|
|
703
|
+
else:
|
|
704
|
+
self.points[-1] = line.start + line.vector.unitized().scaled(total_length - end)
|
|
705
|
+
break
|
|
706
|
+
self._lines = None
|
|
707
|
+
|
|
708
|
+
def shortened(self, length):
|
|
709
|
+
"""Returns a copy of this polyline shortened by a given length.
|
|
710
|
+
|
|
711
|
+
Parameters
|
|
712
|
+
----------
|
|
713
|
+
length: float or tuple[float, float]
|
|
714
|
+
A single length value to shorten the polyline only at the end,
|
|
715
|
+
or two length values to shorten at both ends.
|
|
716
|
+
|
|
717
|
+
Returns
|
|
718
|
+
-------
|
|
719
|
+
:class:`compas.geometry.Polyline`
|
|
720
|
+
|
|
721
|
+
"""
|
|
722
|
+
crv = self.copy()
|
|
723
|
+
crv.shorten(length)
|
|
724
|
+
return crv
|