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,614 @@
|
|
|
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 Geometry
|
|
7
|
+
from compas.geometry import Plane
|
|
8
|
+
from compas.geometry import Transformation
|
|
9
|
+
from compas.itertools import linspace
|
|
10
|
+
from compas.plugins import pluggable
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
@pluggable(category="factories")
|
|
14
|
+
def new_curve(cls, *args, **kwargs):
|
|
15
|
+
curve = object.__new__(cls)
|
|
16
|
+
curve.__init__(*args, **kwargs)
|
|
17
|
+
return curve
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
class Curve(Geometry):
|
|
21
|
+
"""Class representing a general parametric curve.
|
|
22
|
+
|
|
23
|
+
Parameters
|
|
24
|
+
----------
|
|
25
|
+
frame : :class:`compas.geometry.Frame`, optional
|
|
26
|
+
The local coordinate system of the curve.
|
|
27
|
+
Default is the world coordinate system.
|
|
28
|
+
name : str, optional
|
|
29
|
+
The name of the curve.
|
|
30
|
+
|
|
31
|
+
Attributes
|
|
32
|
+
----------
|
|
33
|
+
frame : :class:`compas.geometry.Frame`
|
|
34
|
+
The frame of the curve.
|
|
35
|
+
transformation : :class:`compas.geometry.Transformation`, read-only
|
|
36
|
+
The transformation from the local coordinate system of the curve (:attr:`frame`) to the world coordinate system.
|
|
37
|
+
plane : :class:`compas.geometry.Plane`, read-only
|
|
38
|
+
The plane of the curve.
|
|
39
|
+
dimension : int, read-only
|
|
40
|
+
The spatial dimension of the curve.
|
|
41
|
+
In most cases this will be 3.
|
|
42
|
+
For curves embedded on a surface, this is 2.
|
|
43
|
+
domain : tuple[float, float], read-only
|
|
44
|
+
The domain of the parameter space of the curve is the interval ``[0.0, 1.0]``.
|
|
45
|
+
is_closed : bool, read-only
|
|
46
|
+
True if the curve is closed.
|
|
47
|
+
is_periodic : bool, read-only
|
|
48
|
+
True if the curve is periodic.
|
|
49
|
+
|
|
50
|
+
See Also
|
|
51
|
+
--------
|
|
52
|
+
:class:`compas.geometry.Arc`, :class:`compas.geometry.Circle`,
|
|
53
|
+
:class:`compas.geometry.Ellipse`, :class:`compas.geometry.Line`,
|
|
54
|
+
:class:`compas.geometry.NurbsCurve`, :class:`compas.geometry.Polyline`
|
|
55
|
+
|
|
56
|
+
Notes
|
|
57
|
+
-----
|
|
58
|
+
The curve is a "pluggable". This means that it does not provide an actual implementation
|
|
59
|
+
of a parametric curve, but rather serves as an interface for different backends.
|
|
60
|
+
If a backend is available, it will be used to construct the curve and provide its functionality.
|
|
61
|
+
This backend is referred to as the "plugin" implementation of the curve.
|
|
62
|
+
|
|
63
|
+
To activate the plugin mechanism, the backend should provide an implementation of the :func:`new_curve` function,
|
|
64
|
+
and of any other function that can be implemented through the functionality available in the backend.
|
|
65
|
+
|
|
66
|
+
"""
|
|
67
|
+
|
|
68
|
+
def __new__(cls, *args, **kwargs):
|
|
69
|
+
return new_curve(cls, *args, **kwargs)
|
|
70
|
+
|
|
71
|
+
def __init__(self, frame=None, name=None):
|
|
72
|
+
super(Curve, self).__init__(name=name)
|
|
73
|
+
self._frame = None
|
|
74
|
+
self._transformation = None
|
|
75
|
+
self._domain = None
|
|
76
|
+
if frame:
|
|
77
|
+
self.frame = frame
|
|
78
|
+
|
|
79
|
+
def __repr__(self):
|
|
80
|
+
return "{0}(frame={1!r}, domain={2})".format(
|
|
81
|
+
type(self).__name__,
|
|
82
|
+
self.frame,
|
|
83
|
+
self.domain,
|
|
84
|
+
)
|
|
85
|
+
|
|
86
|
+
# ==============================================================================
|
|
87
|
+
# Properties
|
|
88
|
+
# ==============================================================================
|
|
89
|
+
|
|
90
|
+
@property
|
|
91
|
+
def frame(self):
|
|
92
|
+
if not self._frame:
|
|
93
|
+
self._frame = Frame.worldXY()
|
|
94
|
+
return self._frame
|
|
95
|
+
|
|
96
|
+
@frame.setter
|
|
97
|
+
def frame(self, frame):
|
|
98
|
+
if not frame:
|
|
99
|
+
self._frame = None
|
|
100
|
+
else:
|
|
101
|
+
self._frame = Frame(frame[0], frame[1], frame[2])
|
|
102
|
+
self._transformation = None
|
|
103
|
+
|
|
104
|
+
@property
|
|
105
|
+
def transformation(self):
|
|
106
|
+
if not self._transformation:
|
|
107
|
+
self._transformation = Transformation.from_frame_to_frame(Frame.worldXY(), self.frame)
|
|
108
|
+
return self._transformation
|
|
109
|
+
|
|
110
|
+
@property
|
|
111
|
+
def plane(self):
|
|
112
|
+
return Plane(self.frame.point, self.frame.zaxis)
|
|
113
|
+
|
|
114
|
+
@property
|
|
115
|
+
def dimension(self):
|
|
116
|
+
return 3
|
|
117
|
+
|
|
118
|
+
@property
|
|
119
|
+
def domain(self):
|
|
120
|
+
return 0.0, 1.0
|
|
121
|
+
|
|
122
|
+
@property
|
|
123
|
+
def is_closed(self):
|
|
124
|
+
raise NotImplementedError
|
|
125
|
+
|
|
126
|
+
@property
|
|
127
|
+
def is_periodic(self):
|
|
128
|
+
raise NotImplementedError
|
|
129
|
+
|
|
130
|
+
# ==============================================================================
|
|
131
|
+
# Constructors
|
|
132
|
+
# ==============================================================================
|
|
133
|
+
|
|
134
|
+
@classmethod
|
|
135
|
+
def from_step(cls, filepath):
|
|
136
|
+
"""Load a curve from a STP file.
|
|
137
|
+
|
|
138
|
+
Parameters
|
|
139
|
+
----------
|
|
140
|
+
filepath : str
|
|
141
|
+
The path to the file.
|
|
142
|
+
|
|
143
|
+
Returns
|
|
144
|
+
-------
|
|
145
|
+
:class:`compas.geometry.Curve`
|
|
146
|
+
|
|
147
|
+
"""
|
|
148
|
+
raise NotImplementedError
|
|
149
|
+
|
|
150
|
+
@classmethod
|
|
151
|
+
def from_obj(cls, filepath):
|
|
152
|
+
"""Load a curve from an OBJ file.
|
|
153
|
+
|
|
154
|
+
Parameters
|
|
155
|
+
----------
|
|
156
|
+
filepath : str
|
|
157
|
+
The path to the file.
|
|
158
|
+
|
|
159
|
+
Returns
|
|
160
|
+
-------
|
|
161
|
+
:class:`compas.geometry.Curve`
|
|
162
|
+
|
|
163
|
+
"""
|
|
164
|
+
raise NotImplementedError
|
|
165
|
+
|
|
166
|
+
# ==============================================================================
|
|
167
|
+
# Conversions
|
|
168
|
+
# ==============================================================================
|
|
169
|
+
|
|
170
|
+
def to_step(self, filepath, schema="AP203"):
|
|
171
|
+
"""Write the curve geometry to a STP file.
|
|
172
|
+
|
|
173
|
+
Parameters
|
|
174
|
+
----------
|
|
175
|
+
filepath : str
|
|
176
|
+
The path of the output file.
|
|
177
|
+
schema : str, optional
|
|
178
|
+
The STEP schema to use. Default is ``"AP203"``.
|
|
179
|
+
|
|
180
|
+
Returns
|
|
181
|
+
-------
|
|
182
|
+
None
|
|
183
|
+
|
|
184
|
+
"""
|
|
185
|
+
raise NotImplementedError
|
|
186
|
+
|
|
187
|
+
def to_obj(self, filepath):
|
|
188
|
+
"""Write the curve geometry to an OBJ file.
|
|
189
|
+
|
|
190
|
+
Parameters
|
|
191
|
+
----------
|
|
192
|
+
filepath : str
|
|
193
|
+
The path of the output file.
|
|
194
|
+
|
|
195
|
+
Returns
|
|
196
|
+
-------
|
|
197
|
+
None
|
|
198
|
+
|
|
199
|
+
"""
|
|
200
|
+
raise NotImplementedError
|
|
201
|
+
|
|
202
|
+
def to_points(self, n=10, domain=None):
|
|
203
|
+
"""Convert the curve to a list of points.
|
|
204
|
+
|
|
205
|
+
Parameters
|
|
206
|
+
----------
|
|
207
|
+
n : int, optional
|
|
208
|
+
The number of points in the list.
|
|
209
|
+
Default is ``10``.
|
|
210
|
+
domain : tuple, optional
|
|
211
|
+
Subset of the domain to use for the discretisation.
|
|
212
|
+
Default is ``None``, in which case the entire curve domain is used.
|
|
213
|
+
|
|
214
|
+
Returns
|
|
215
|
+
-------
|
|
216
|
+
list[:class:`compas.geometry.Point`]
|
|
217
|
+
|
|
218
|
+
"""
|
|
219
|
+
domain = domain or self.domain
|
|
220
|
+
start, end = domain
|
|
221
|
+
points = [self.point_at(t) for t in linspace(start, end, n)]
|
|
222
|
+
return points
|
|
223
|
+
|
|
224
|
+
def to_polyline(self, n=128, domain=None):
|
|
225
|
+
"""Convert the curve to a polyline.
|
|
226
|
+
|
|
227
|
+
Parameters
|
|
228
|
+
----------
|
|
229
|
+
n : int, optional
|
|
230
|
+
The number of line segments in the polyline.
|
|
231
|
+
Default is ``16``.
|
|
232
|
+
domain : tuple, optional
|
|
233
|
+
Subset of the domain to use for the discretisation.
|
|
234
|
+
Default is ``None``, in which case the entire curve domain is used.
|
|
235
|
+
|
|
236
|
+
Returns
|
|
237
|
+
-------
|
|
238
|
+
:class:`compas.geometry.Polyline`
|
|
239
|
+
|
|
240
|
+
"""
|
|
241
|
+
from compas.geometry import Polyline
|
|
242
|
+
|
|
243
|
+
points = self.to_points(n=n + 1, domain=domain)
|
|
244
|
+
return Polyline(points)
|
|
245
|
+
|
|
246
|
+
def to_polygon(self, n=16):
|
|
247
|
+
"""Convert the curve to a polygon.
|
|
248
|
+
|
|
249
|
+
Parameters
|
|
250
|
+
----------
|
|
251
|
+
n : int, optional
|
|
252
|
+
The number of sides of the polygon.
|
|
253
|
+
Default is ``16``.
|
|
254
|
+
|
|
255
|
+
Returns
|
|
256
|
+
-------
|
|
257
|
+
:class:`compas.geometry.Polygon`
|
|
258
|
+
|
|
259
|
+
Raises
|
|
260
|
+
------
|
|
261
|
+
ValueError
|
|
262
|
+
If the curve is not closed.
|
|
263
|
+
|
|
264
|
+
"""
|
|
265
|
+
if not self.is_closed:
|
|
266
|
+
raise ValueError("The curve is not closed.")
|
|
267
|
+
|
|
268
|
+
from compas.geometry import Polygon
|
|
269
|
+
|
|
270
|
+
points = self.to_points(n=n + 1)
|
|
271
|
+
return Polygon(points[:-1])
|
|
272
|
+
|
|
273
|
+
# ==============================================================================
|
|
274
|
+
# Transformations
|
|
275
|
+
# ==============================================================================
|
|
276
|
+
|
|
277
|
+
def transform(self, T):
|
|
278
|
+
"""Transform the local coordinate system of the curve.
|
|
279
|
+
|
|
280
|
+
Parameters
|
|
281
|
+
----------
|
|
282
|
+
T : :class:`compas.geometry.Transformation` | list[list[float]]
|
|
283
|
+
The transformation.
|
|
284
|
+
|
|
285
|
+
Returns
|
|
286
|
+
-------
|
|
287
|
+
None
|
|
288
|
+
The (local coordinate system of the) curve is modified in-place.
|
|
289
|
+
|
|
290
|
+
Notes
|
|
291
|
+
-----
|
|
292
|
+
Transformations of frames are limited to rotations and translations.
|
|
293
|
+
All other transformations have no effect.
|
|
294
|
+
See :meth:`~compas.geometry.Frame.transform` for more info.
|
|
295
|
+
|
|
296
|
+
"""
|
|
297
|
+
self.frame.transform(T)
|
|
298
|
+
self._transformation = None
|
|
299
|
+
|
|
300
|
+
# ==============================================================================
|
|
301
|
+
# Methods
|
|
302
|
+
# ==============================================================================
|
|
303
|
+
|
|
304
|
+
def point_at(self, t):
|
|
305
|
+
"""Compute a point of the curve at a parameter.
|
|
306
|
+
|
|
307
|
+
Parameters
|
|
308
|
+
----------
|
|
309
|
+
t : float
|
|
310
|
+
The value of the curve parameter. Must be between 0 and 1.
|
|
311
|
+
|
|
312
|
+
Returns
|
|
313
|
+
-------
|
|
314
|
+
:class:`compas.geometry.Point`
|
|
315
|
+
the corresponding point on the curve.
|
|
316
|
+
|
|
317
|
+
Raises
|
|
318
|
+
------
|
|
319
|
+
ValueError
|
|
320
|
+
If the parameter is not in the curve domain.
|
|
321
|
+
|
|
322
|
+
See Also
|
|
323
|
+
--------
|
|
324
|
+
:meth:`normal_at`, :meth:`tangent_at`, :meth:`binormal_at`, :meth:`frame_at`, :meth:`curvature_at`
|
|
325
|
+
|
|
326
|
+
"""
|
|
327
|
+
raise NotImplementedError
|
|
328
|
+
|
|
329
|
+
def normal_at(self, t):
|
|
330
|
+
"""Compute the normal of the curve at a parameter.
|
|
331
|
+
|
|
332
|
+
Parameters
|
|
333
|
+
----------
|
|
334
|
+
t : float
|
|
335
|
+
The value of the curve parameter.
|
|
336
|
+
|
|
337
|
+
Returns
|
|
338
|
+
-------
|
|
339
|
+
:class:`compas.geometry.Vector`
|
|
340
|
+
The corresponding normal vector.
|
|
341
|
+
|
|
342
|
+
Raises
|
|
343
|
+
------
|
|
344
|
+
ValueError
|
|
345
|
+
If the parameter is not in the curve domain.
|
|
346
|
+
|
|
347
|
+
See Also
|
|
348
|
+
--------
|
|
349
|
+
:meth:`point_at`, :meth:`tangent_at`, :meth:`binormal_at`, :meth:`frame_at`, :meth:`curvature_at`
|
|
350
|
+
|
|
351
|
+
"""
|
|
352
|
+
raise NotImplementedError
|
|
353
|
+
|
|
354
|
+
def tangent_at(self, t):
|
|
355
|
+
"""Compute the tangent vector of the curve at a parameter.
|
|
356
|
+
|
|
357
|
+
Parameters
|
|
358
|
+
----------
|
|
359
|
+
t : float
|
|
360
|
+
The value of the curve parameter.
|
|
361
|
+
|
|
362
|
+
Returns
|
|
363
|
+
-------
|
|
364
|
+
:class:`compas.geometry.Vector`
|
|
365
|
+
The corresponding tangent vector.
|
|
366
|
+
|
|
367
|
+
Raises
|
|
368
|
+
------
|
|
369
|
+
ValueError
|
|
370
|
+
If the parameter is not in the curve domain.
|
|
371
|
+
|
|
372
|
+
See Also
|
|
373
|
+
--------
|
|
374
|
+
:meth:`point_at`, :meth:`normal_at`, :meth:`binormal_at`, :meth:`frame_at`, :meth:`curvature_at`
|
|
375
|
+
|
|
376
|
+
"""
|
|
377
|
+
raise NotImplementedError
|
|
378
|
+
|
|
379
|
+
def frame_at(self, t):
|
|
380
|
+
"""Compute the local frame of the curve at a parameter.
|
|
381
|
+
|
|
382
|
+
Parameters
|
|
383
|
+
----------
|
|
384
|
+
t : float
|
|
385
|
+
The value of the curve parameter.
|
|
386
|
+
|
|
387
|
+
Returns
|
|
388
|
+
-------
|
|
389
|
+
:class:`compas.geometry.Frame`
|
|
390
|
+
The corresponding local frame.
|
|
391
|
+
|
|
392
|
+
Raises
|
|
393
|
+
------
|
|
394
|
+
ValueError
|
|
395
|
+
If the parameter is not in the curve domain.
|
|
396
|
+
|
|
397
|
+
See Also
|
|
398
|
+
--------
|
|
399
|
+
:meth:`point_at`, :meth:`normal_at`, :meth:`tangent_at`, :meth:`binormal_at`, :meth:`curvature_at`
|
|
400
|
+
|
|
401
|
+
"""
|
|
402
|
+
return Frame(self.point_at(t), self.tangent_at(t), self.normal_at(t))
|
|
403
|
+
|
|
404
|
+
def curvature_at(self, t):
|
|
405
|
+
"""Compute the curvature vector of the curve at a parameter.
|
|
406
|
+
|
|
407
|
+
This is a vector pointing from the point on the curve at the specified parameter,
|
|
408
|
+
to the center of the oscillating circle of the curve at that location.
|
|
409
|
+
|
|
410
|
+
Note that this vector is parallel to the normal vector of the curve at that location.
|
|
411
|
+
|
|
412
|
+
Parameters
|
|
413
|
+
----------
|
|
414
|
+
t : float
|
|
415
|
+
The value of the curve parameter.
|
|
416
|
+
|
|
417
|
+
Returns
|
|
418
|
+
-------
|
|
419
|
+
:class:`compas.geometry.Vector`
|
|
420
|
+
The corresponding curvature vector.
|
|
421
|
+
|
|
422
|
+
Raises
|
|
423
|
+
------
|
|
424
|
+
ValueError
|
|
425
|
+
If the parameter is not in the curve domain.
|
|
426
|
+
|
|
427
|
+
See Also
|
|
428
|
+
--------
|
|
429
|
+
:meth:`point_at`, :meth:`normal_at`, :meth:`tangent_at`, :meth:`binormal_at`, :meth:`frame_at`
|
|
430
|
+
|
|
431
|
+
"""
|
|
432
|
+
raise NotImplementedError
|
|
433
|
+
|
|
434
|
+
# ==============================================================================
|
|
435
|
+
# Methods continued
|
|
436
|
+
# ==============================================================================
|
|
437
|
+
|
|
438
|
+
def reverse(self):
|
|
439
|
+
"""Reverse the parametrisation of the curve.
|
|
440
|
+
|
|
441
|
+
Returns
|
|
442
|
+
-------
|
|
443
|
+
None
|
|
444
|
+
|
|
445
|
+
See Also
|
|
446
|
+
--------
|
|
447
|
+
:meth:`reversed`
|
|
448
|
+
|
|
449
|
+
"""
|
|
450
|
+
raise NotImplementedError
|
|
451
|
+
|
|
452
|
+
def reversed(self):
|
|
453
|
+
"""Reverse a copy of the curve.
|
|
454
|
+
|
|
455
|
+
Returns
|
|
456
|
+
-------
|
|
457
|
+
:class:`compas.geometry.Curve`
|
|
458
|
+
|
|
459
|
+
See Also
|
|
460
|
+
--------
|
|
461
|
+
:meth:`reverse`
|
|
462
|
+
|
|
463
|
+
"""
|
|
464
|
+
copy = self.copy()
|
|
465
|
+
copy.reverse
|
|
466
|
+
return copy
|
|
467
|
+
|
|
468
|
+
# def space(self, n=10):
|
|
469
|
+
# """Compute evenly spaced parameters over the curve domain.
|
|
470
|
+
|
|
471
|
+
# Parameters
|
|
472
|
+
# ----------
|
|
473
|
+
# n : int, optional
|
|
474
|
+
# The number of values in the parameter space.
|
|
475
|
+
|
|
476
|
+
# Returns
|
|
477
|
+
# -------
|
|
478
|
+
# list[float]
|
|
479
|
+
|
|
480
|
+
# See Also
|
|
481
|
+
# --------
|
|
482
|
+
# :meth:`locus`
|
|
483
|
+
|
|
484
|
+
# """
|
|
485
|
+
# start, end = self.domain
|
|
486
|
+
# return linspace(start, end, n)
|
|
487
|
+
|
|
488
|
+
# def locus(self, resolution=100):
|
|
489
|
+
# """Compute the locus of points on the curve.
|
|
490
|
+
|
|
491
|
+
# Parameters
|
|
492
|
+
# ----------
|
|
493
|
+
# resolution : int
|
|
494
|
+
# The number of intervals at which a point on the
|
|
495
|
+
# curve should be computed.
|
|
496
|
+
|
|
497
|
+
# Returns
|
|
498
|
+
# -------
|
|
499
|
+
# list[:class:`compas.geometry.Point`]
|
|
500
|
+
# Points along the curve.
|
|
501
|
+
|
|
502
|
+
# See Also
|
|
503
|
+
# --------
|
|
504
|
+
# :meth:`space`
|
|
505
|
+
|
|
506
|
+
# """
|
|
507
|
+
# return [self.point_at(t) for t in self.space(resolution)]
|
|
508
|
+
|
|
509
|
+
def closest_point(self, point, return_parameter=False):
|
|
510
|
+
"""Compute the closest point on the curve to a given point.
|
|
511
|
+
|
|
512
|
+
Parameters
|
|
513
|
+
----------
|
|
514
|
+
point : :class:`compas.geometry.Point`
|
|
515
|
+
The test point.
|
|
516
|
+
return_parameter : bool, optional
|
|
517
|
+
If True, the parameter corresponding to the closest point should be returned in addition to the point.
|
|
518
|
+
|
|
519
|
+
Returns
|
|
520
|
+
-------
|
|
521
|
+
:class:`compas.geometry.Point` | tuple[:class:`compas.geometry.Point`, float]
|
|
522
|
+
If `return_parameter` is False (default), only the closest point is returned.
|
|
523
|
+
If `return_parameter` is True, the closest point and the corresponding parameter are returned.
|
|
524
|
+
|
|
525
|
+
"""
|
|
526
|
+
raise NotImplementedError
|
|
527
|
+
|
|
528
|
+
def divide_by_count(self, count, return_points=False):
|
|
529
|
+
"""Compute the curve parameters that divide the curve into a specific number of equal length segments.
|
|
530
|
+
|
|
531
|
+
Parameters
|
|
532
|
+
----------
|
|
533
|
+
count : int
|
|
534
|
+
The number of segments.
|
|
535
|
+
return_points : bool, optional
|
|
536
|
+
If True, return the list of division parameters,
|
|
537
|
+
and the points corresponding to those parameters.
|
|
538
|
+
If False, return only the list of parameters.
|
|
539
|
+
|
|
540
|
+
Returns
|
|
541
|
+
-------
|
|
542
|
+
list[float] | tuple[list[float], list[:class:`compas.geometry.Point`]]
|
|
543
|
+
If `return_points` is False, the parameters of the discretisation.
|
|
544
|
+
If `return_points` is True, a list of points in addition to the parameters of the discretisation.
|
|
545
|
+
|
|
546
|
+
See Also
|
|
547
|
+
--------
|
|
548
|
+
:meth:`divide_by_length`
|
|
549
|
+
:meth:`split`
|
|
550
|
+
|
|
551
|
+
"""
|
|
552
|
+
raise NotImplementedError
|
|
553
|
+
|
|
554
|
+
def divide_by_length(self, length, return_points=False):
|
|
555
|
+
"""Compute the curve parameters that divide the curve into segments of specified length.
|
|
556
|
+
|
|
557
|
+
Parameters
|
|
558
|
+
----------
|
|
559
|
+
length : float
|
|
560
|
+
The length of the segments.
|
|
561
|
+
return_points : bool, optional
|
|
562
|
+
If True, return the list of division parameters,
|
|
563
|
+
and the points corresponding to those parameters.
|
|
564
|
+
If False, return only the list of parameters.
|
|
565
|
+
|
|
566
|
+
Returns
|
|
567
|
+
-------
|
|
568
|
+
list[float] | tuple[list[float], list[:class:`compas.geometry.Point`]]
|
|
569
|
+
If `return_points` is False, the parameters of the discretisation.
|
|
570
|
+
If `return_points` is True, a list of points in addition to the parameters of the discretisation.
|
|
571
|
+
|
|
572
|
+
See Also
|
|
573
|
+
--------
|
|
574
|
+
:meth:`divide_by_count`
|
|
575
|
+
:meth:`split`
|
|
576
|
+
|
|
577
|
+
"""
|
|
578
|
+
raise NotImplementedError
|
|
579
|
+
|
|
580
|
+
def aabb(self):
|
|
581
|
+
"""Compute the axis-aligned bounding box of the curve.
|
|
582
|
+
|
|
583
|
+
Returns
|
|
584
|
+
-------
|
|
585
|
+
:class:`compas.geometry.Box`
|
|
586
|
+
|
|
587
|
+
"""
|
|
588
|
+
raise NotImplementedError
|
|
589
|
+
|
|
590
|
+
def length(self, tol=None):
|
|
591
|
+
"""Compute the length of the curve.
|
|
592
|
+
|
|
593
|
+
Parameters
|
|
594
|
+
----------
|
|
595
|
+
precision : float, optional
|
|
596
|
+
Required precision of the calculated length.
|
|
597
|
+
|
|
598
|
+
"""
|
|
599
|
+
raise NotImplementedError
|
|
600
|
+
|
|
601
|
+
def fair(self, tol=None):
|
|
602
|
+
raise NotImplementedError
|
|
603
|
+
|
|
604
|
+
def offset(self):
|
|
605
|
+
raise NotImplementedError
|
|
606
|
+
|
|
607
|
+
def smooth(self):
|
|
608
|
+
raise NotImplementedError
|
|
609
|
+
|
|
610
|
+
def split(self):
|
|
611
|
+
raise NotImplementedError
|
|
612
|
+
|
|
613
|
+
def trim(self):
|
|
614
|
+
raise NotImplementedError
|