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,87 @@
|
|
|
1
|
+
from compas.data import Data
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
class BrepLoop(Data):
|
|
5
|
+
"""An interface for a Brep Loop.
|
|
6
|
+
|
|
7
|
+
Attributes
|
|
8
|
+
----------
|
|
9
|
+
edges : list[:class:`compas.geometry.BrepEdge`], read-only
|
|
10
|
+
Returns the list of deges associated with this loop.
|
|
11
|
+
is_valid : bool, read-only
|
|
12
|
+
Returns True if this loop is valid, False otherwise.
|
|
13
|
+
vertices : list[:class:`compas.geometry.BrepVertex`], read-only
|
|
14
|
+
Returns the list of vertices associated with this loop.
|
|
15
|
+
native_loop : Any
|
|
16
|
+
The underlying loop object. Type is backend-dependent.
|
|
17
|
+
|
|
18
|
+
"""
|
|
19
|
+
|
|
20
|
+
# ==============================================================================
|
|
21
|
+
# Properties
|
|
22
|
+
# ==============================================================================
|
|
23
|
+
|
|
24
|
+
@property
|
|
25
|
+
def is_valid(self):
|
|
26
|
+
return NotImplementedError
|
|
27
|
+
|
|
28
|
+
@property
|
|
29
|
+
def vertices(self):
|
|
30
|
+
raise NotImplementedError
|
|
31
|
+
|
|
32
|
+
@property
|
|
33
|
+
def edges(self):
|
|
34
|
+
raise NotImplementedError
|
|
35
|
+
|
|
36
|
+
@property
|
|
37
|
+
def native_loop(self):
|
|
38
|
+
raise NotImplementedError
|
|
39
|
+
|
|
40
|
+
# ==============================================================================
|
|
41
|
+
# Constructors
|
|
42
|
+
# ==============================================================================
|
|
43
|
+
|
|
44
|
+
@classmethod
|
|
45
|
+
def from_edges(cls, edges):
|
|
46
|
+
"""Construct a loop from a list of edges.
|
|
47
|
+
|
|
48
|
+
Parameters
|
|
49
|
+
----------
|
|
50
|
+
edges : list[:class:`compas.geometry.BrepEdge`]
|
|
51
|
+
|
|
52
|
+
Returns
|
|
53
|
+
-------
|
|
54
|
+
:class:`compas.geometry.BrepLoop`
|
|
55
|
+
|
|
56
|
+
"""
|
|
57
|
+
raise NotImplementedError
|
|
58
|
+
|
|
59
|
+
@classmethod
|
|
60
|
+
def from_polyline(cls, polyline):
|
|
61
|
+
"""Construct a loop from a polyline.
|
|
62
|
+
|
|
63
|
+
Parameters
|
|
64
|
+
----------
|
|
65
|
+
polyline : :class:`compas.geometry.Polyline`
|
|
66
|
+
|
|
67
|
+
Returns
|
|
68
|
+
-------
|
|
69
|
+
:class:`compas.geometry.BrepLoop`
|
|
70
|
+
|
|
71
|
+
"""
|
|
72
|
+
raise NotImplementedError
|
|
73
|
+
|
|
74
|
+
@classmethod
|
|
75
|
+
def from_polygon(cls, polygon):
|
|
76
|
+
"""Construct a loop from a polygon.
|
|
77
|
+
|
|
78
|
+
Parameters
|
|
79
|
+
----------
|
|
80
|
+
polygon : :class:`compas.geometry.Polygon`
|
|
81
|
+
|
|
82
|
+
Returns
|
|
83
|
+
-------
|
|
84
|
+
:class:`compas.geometry.BrepLoop`
|
|
85
|
+
|
|
86
|
+
"""
|
|
87
|
+
raise NotImplementedError
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
from compas.data import Data
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
class BrepTrimIsoStatus(object):
|
|
5
|
+
"""An enumeration of isoparametric curve direction on the surface."""
|
|
6
|
+
|
|
7
|
+
NONE = 0
|
|
8
|
+
X = 1
|
|
9
|
+
Y = 2
|
|
10
|
+
WEST = 3
|
|
11
|
+
SOUTH = 4
|
|
12
|
+
EAST = 5
|
|
13
|
+
NORTH = 6
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
class BrepTrim(Data):
|
|
17
|
+
"""An interface for a Brep Trim
|
|
18
|
+
|
|
19
|
+
Attributes
|
|
20
|
+
----------
|
|
21
|
+
curve : :class:`compas.geometry.NurbsCurve`, read_only
|
|
22
|
+
Returns the geometry for this trim as a 2d curve.
|
|
23
|
+
iso_status : literal(NONE|X|Y|WEST|SOUTH|EAST|NORTH)
|
|
24
|
+
The isoparametric curve direction on the surface.
|
|
25
|
+
is_reversed : bool
|
|
26
|
+
True if this trim is reversed from its associated edge curve and False otherwise.
|
|
27
|
+
native_trim : Any
|
|
28
|
+
The underlying trim object. Type is backend-dependent.
|
|
29
|
+
|
|
30
|
+
"""
|
|
31
|
+
|
|
32
|
+
@property
|
|
33
|
+
def curve(self):
|
|
34
|
+
raise NotImplementedError
|
|
35
|
+
|
|
36
|
+
@property
|
|
37
|
+
def iso_status(self):
|
|
38
|
+
raise NotImplementedError
|
|
39
|
+
|
|
40
|
+
@property
|
|
41
|
+
def is_reversed(self):
|
|
42
|
+
raise NotImplementedError
|
|
43
|
+
|
|
44
|
+
@property
|
|
45
|
+
def native_trim(self):
|
|
46
|
+
raise NotImplementedError
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
from compas.data import Data
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
class BrepVertex(Data):
|
|
5
|
+
"""An interface for a Brep Vertex
|
|
6
|
+
|
|
7
|
+
Attributes
|
|
8
|
+
----------
|
|
9
|
+
point : :class:`compas.geometry.Point`, read_only
|
|
10
|
+
Returns the geometry of this vertex as a 3D point
|
|
11
|
+
native_vertex : Any
|
|
12
|
+
The underlying vertex object. Type is backend-dependent.
|
|
13
|
+
|
|
14
|
+
"""
|
|
15
|
+
|
|
16
|
+
# ==============================================================================
|
|
17
|
+
# Properties
|
|
18
|
+
# ==============================================================================
|
|
19
|
+
|
|
20
|
+
@property
|
|
21
|
+
def point(self):
|
|
22
|
+
raise NotImplementedError
|
|
23
|
+
|
|
24
|
+
@property
|
|
25
|
+
def native_vertex(self):
|
|
26
|
+
raise NotImplementedError
|
|
27
|
+
|
|
28
|
+
# ==============================================================================
|
|
29
|
+
# Constructors
|
|
30
|
+
# ==============================================================================
|
|
31
|
+
|
|
32
|
+
@classmethod
|
|
33
|
+
def from_point(cls, point):
|
|
34
|
+
"""Creates a Brep vertex from a Point
|
|
35
|
+
|
|
36
|
+
Parameters
|
|
37
|
+
----------
|
|
38
|
+
point: :class:`compas.geometry.Point`
|
|
39
|
+
The point to create a vertex from
|
|
40
|
+
|
|
41
|
+
Returns
|
|
42
|
+
-------
|
|
43
|
+
:class:`compas.geometry.BrepVertex`
|
|
44
|
+
The created vertex
|
|
45
|
+
"""
|
|
46
|
+
raise NotImplementedError
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
from compas.plugins import PluginNotInstalledError
|
|
2
|
+
from compas.plugins import pluggable
|
|
3
|
+
|
|
4
|
+
|
|
5
|
+
@pluggable(category="contours")
|
|
6
|
+
def scalarfield_contours(xy, s, levels=50, density=100):
|
|
7
|
+
r"""Compute the contour lines of a scalarfield.
|
|
8
|
+
|
|
9
|
+
Parameters
|
|
10
|
+
----------
|
|
11
|
+
xy : array-like
|
|
12
|
+
The xy-coordinates at which the scalar field is defined.
|
|
13
|
+
s : array-like
|
|
14
|
+
The values of the scalar field.
|
|
15
|
+
levels : int, optional
|
|
16
|
+
The number of contour lines to compute.
|
|
17
|
+
Default is ``50``.
|
|
18
|
+
|
|
19
|
+
Returns
|
|
20
|
+
-------
|
|
21
|
+
tuple
|
|
22
|
+
A tuple of a list of levels and a list of contour geometry.
|
|
23
|
+
|
|
24
|
+
The list of levels contains the values of the scalarfield at each of
|
|
25
|
+
the contours. The second item in the tuple is a list of contour lines.
|
|
26
|
+
Each contour line is a list of paths, and each path is a list polygons.
|
|
27
|
+
|
|
28
|
+
"""
|
|
29
|
+
raise PluginNotInstalledError()
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
scalarfield_contours.__pluggable__ = True
|
|
File without changes
|
|
@@ -0,0 +1,429 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from math import cos
|
|
6
|
+
from math import pi
|
|
7
|
+
from math import sin
|
|
8
|
+
|
|
9
|
+
from compas.geometry import Circle
|
|
10
|
+
from compas.geometry import Frame
|
|
11
|
+
from compas.geometry import Point
|
|
12
|
+
from compas.geometry import Vector
|
|
13
|
+
from compas.tolerance import TOL
|
|
14
|
+
|
|
15
|
+
from .curve import Curve
|
|
16
|
+
|
|
17
|
+
PI2 = 2.0 * pi
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
class Arc(Curve):
|
|
21
|
+
"""An arc is a segment of a circle, and is defined by a coordinate system, radius, and start and end angles.
|
|
22
|
+
|
|
23
|
+
The centre of the underlying circle is at the origin of the coordinate system.
|
|
24
|
+
The start and end angles are measured from the positive X axis towards the positive Y axis.
|
|
25
|
+
|
|
26
|
+
The parametrisation of the arc is normalised with respect to the arc angle.
|
|
27
|
+
The value ``t=0.0`` corresponds to the start angle of the arc.
|
|
28
|
+
The value ``t=1.0`` corresponds to the end angle of the arc.
|
|
29
|
+
The value ``t=0.5`` corresponds to the angle halfway between start and end.
|
|
30
|
+
|
|
31
|
+
Transformations of the arc are performed by transforming the local coordinate system.
|
|
32
|
+
|
|
33
|
+
Parameters
|
|
34
|
+
----------
|
|
35
|
+
radius : float
|
|
36
|
+
Radius of the arc's circle.
|
|
37
|
+
start_angle : float
|
|
38
|
+
The angle in radians of the start of this Arc.
|
|
39
|
+
end_angle : float
|
|
40
|
+
The angle in radians of the end of this Arc.
|
|
41
|
+
frame : :class:`compas.geometry.Frame`, optional
|
|
42
|
+
Local coordinate system of the arc.
|
|
43
|
+
Defaults to the world XY plane.
|
|
44
|
+
name : str, optional
|
|
45
|
+
The name of the arc.
|
|
46
|
+
|
|
47
|
+
Attributes
|
|
48
|
+
----------
|
|
49
|
+
frame : :class:`compas.geometry.Frame`
|
|
50
|
+
The coordinate frame of the arc.
|
|
51
|
+
transformation : :class:`Transformation`, read-only
|
|
52
|
+
The transformation from the local coordinate system of the arc (:attr:`frame`) to the world coordinate system.
|
|
53
|
+
radius : float
|
|
54
|
+
The radius of the circle.
|
|
55
|
+
start_angle : float
|
|
56
|
+
The start angle of the arc.
|
|
57
|
+
end_angle : float
|
|
58
|
+
The end angle of the arc.
|
|
59
|
+
circle : :class:`compas.geometry.Circle`, read-only
|
|
60
|
+
The underlying circle.
|
|
61
|
+
plane : :class:`compas.geometry.Plane`, read-only
|
|
62
|
+
The plane of the arc.
|
|
63
|
+
diameter : float, read-only
|
|
64
|
+
The diameter of the underlying circle.
|
|
65
|
+
length : float, read-only
|
|
66
|
+
The length of the arc.
|
|
67
|
+
angle : float, read-only
|
|
68
|
+
The sweep angle in radians between start angle and end angle.
|
|
69
|
+
circumference : float, read-only
|
|
70
|
+
The circumference of the underlying circle.
|
|
71
|
+
is_closed : bool, read-only
|
|
72
|
+
False.
|
|
73
|
+
is_periodic : bool, read-only
|
|
74
|
+
False.
|
|
75
|
+
|
|
76
|
+
See Also
|
|
77
|
+
--------
|
|
78
|
+
:class:`compas.geometry.Circle`
|
|
79
|
+
|
|
80
|
+
Examples
|
|
81
|
+
--------
|
|
82
|
+
Construct a semicircular arc in the XY plane, with radius 1.0, and compute its length.
|
|
83
|
+
|
|
84
|
+
>>> from math import pi
|
|
85
|
+
>>> from compas.geometry import Arc
|
|
86
|
+
>>> arc = Arc(radius=1.0, start_angle=0.0, end_angle=pi)
|
|
87
|
+
>>> arc.length == 1.0 * pi
|
|
88
|
+
True
|
|
89
|
+
|
|
90
|
+
Construct a quarter arc in the 3rd quadrant of a frame
|
|
91
|
+
aligned with the world ZX plane at a distance of 1.0 from the world origin along the world Y axis.
|
|
92
|
+
|
|
93
|
+
>>> from math import pi
|
|
94
|
+
>>> from compas.geometry import Frame
|
|
95
|
+
>>> from compas.geometry import Arc
|
|
96
|
+
>>> frame = Frame([0.0, 1.0, 0.0], [0.0, 0.0, 1.0], [1.0, 0.0, 0.0])
|
|
97
|
+
>>> arc = Arc(radius=1.0, start_angle=pi, end_angle=pi * 1.5, frame=frame)
|
|
98
|
+
>>> arc.length == 1.0 * pi * 0.5
|
|
99
|
+
True
|
|
100
|
+
|
|
101
|
+
Visualize the arc using the viewer.
|
|
102
|
+
|
|
103
|
+
>>> from compas_viewer import Viewer # doctest: +SKIP
|
|
104
|
+
>>> viewer = Viewer() # doctest: +SKIP
|
|
105
|
+
>>> viewer.scene.add(arc.to_polyline(n=20)) # doctest: +SKIP
|
|
106
|
+
>>> viewer.scene.add(arc.frame) # doctest: +SKIP
|
|
107
|
+
>>> viewer.show() # doctest: +SKIP
|
|
108
|
+
|
|
109
|
+
Visualize only part of the arc.
|
|
110
|
+
|
|
111
|
+
>>> from compas_viewer import Viewer # doctest: +SKIP
|
|
112
|
+
>>> viewer = Viewer() # doctest: +SKIP
|
|
113
|
+
>>> viewer.scene.add(arc.to_polyline(n=20, domain=(0.25, 0.75))) # doctest: +SKIP
|
|
114
|
+
>>> viewer.scene.add(arc.frame) # doctest: +SKIP
|
|
115
|
+
>>> viewer.show() # doctest: +SKIP
|
|
116
|
+
|
|
117
|
+
"""
|
|
118
|
+
|
|
119
|
+
# overwriting the __new__ method is necessary
|
|
120
|
+
# to avoid triggering the plugin mechanism of the base curve class
|
|
121
|
+
def __new__(cls, *args, **kwargs):
|
|
122
|
+
curve = object.__new__(cls)
|
|
123
|
+
curve.__init__(*args, **kwargs)
|
|
124
|
+
return curve
|
|
125
|
+
|
|
126
|
+
DATASCHEMA = {
|
|
127
|
+
"value": {
|
|
128
|
+
"type": "object",
|
|
129
|
+
"properties": {
|
|
130
|
+
"radius": {"type": "number", "minimum": 0},
|
|
131
|
+
"start_angle": {"type": "number", "minimum": 0, "optional": True},
|
|
132
|
+
"end_angle": {"type": "number", "minimum": 0},
|
|
133
|
+
"frame": Frame.DATASCHEMA,
|
|
134
|
+
},
|
|
135
|
+
"required": ["frame", "radius", "start_angle", "end_angle"],
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
@property
|
|
140
|
+
def __data__(self):
|
|
141
|
+
return {
|
|
142
|
+
"radius": self.radius,
|
|
143
|
+
"start_angle": self.start_angle,
|
|
144
|
+
"end_angle": self.end_angle,
|
|
145
|
+
"frame": self.frame.__data__,
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
@classmethod
|
|
149
|
+
def __from_data__(cls, data):
|
|
150
|
+
return cls(
|
|
151
|
+
radius=data["radius"],
|
|
152
|
+
start_angle=data["start_angle"],
|
|
153
|
+
end_angle=data["end_angle"],
|
|
154
|
+
frame=Frame.__from_data__(data["frame"]),
|
|
155
|
+
)
|
|
156
|
+
|
|
157
|
+
def __init__(self, radius, start_angle, end_angle, frame=None, name=None):
|
|
158
|
+
super(Arc, self).__init__(frame=frame, name=name)
|
|
159
|
+
self._radius = None
|
|
160
|
+
self._start_angle = None
|
|
161
|
+
self._end_angle = None
|
|
162
|
+
self.radius = radius
|
|
163
|
+
self.start_angle = start_angle
|
|
164
|
+
self.end_angle = end_angle
|
|
165
|
+
|
|
166
|
+
def __repr__(self):
|
|
167
|
+
return "{0}(radius={1}, start_angle={2}, end_angle={3}, frame={4!r})".format(
|
|
168
|
+
type(self).__name__,
|
|
169
|
+
self.radius,
|
|
170
|
+
self.start_angle,
|
|
171
|
+
self.end_angle,
|
|
172
|
+
self.frame,
|
|
173
|
+
)
|
|
174
|
+
|
|
175
|
+
def __eq__(self, other):
|
|
176
|
+
try:
|
|
177
|
+
return self.radius == other.radius and self.start_angle == other.start and self.end_angle == other.end and self.frame == other.frame
|
|
178
|
+
except Exception:
|
|
179
|
+
return False
|
|
180
|
+
|
|
181
|
+
# =============================================================================
|
|
182
|
+
# Properties
|
|
183
|
+
# =============================================================================
|
|
184
|
+
|
|
185
|
+
@property
|
|
186
|
+
def radius(self):
|
|
187
|
+
if self._radius is None:
|
|
188
|
+
raise ValueError("Radius is not set.")
|
|
189
|
+
return self._radius
|
|
190
|
+
|
|
191
|
+
@radius.setter
|
|
192
|
+
def radius(self, value):
|
|
193
|
+
if value < 0.0:
|
|
194
|
+
raise ValueError("Radius must be greater than or equal to zero.")
|
|
195
|
+
self._radius = value
|
|
196
|
+
|
|
197
|
+
@property
|
|
198
|
+
def start_angle(self):
|
|
199
|
+
if self._start_angle is None:
|
|
200
|
+
self._start_angle = 0.0
|
|
201
|
+
return self._start_angle
|
|
202
|
+
|
|
203
|
+
@start_angle.setter
|
|
204
|
+
def start_angle(self, value):
|
|
205
|
+
if value < 0.0 or value > PI2:
|
|
206
|
+
raise ValueError("Start angle must satisfy 0 <= angle <= 2 * pi.")
|
|
207
|
+
self._start_angle = value
|
|
208
|
+
|
|
209
|
+
@property
|
|
210
|
+
def end_angle(self):
|
|
211
|
+
if self._end_angle is None:
|
|
212
|
+
raise ValueError("End angle not set.")
|
|
213
|
+
return self._end_angle
|
|
214
|
+
|
|
215
|
+
@end_angle.setter
|
|
216
|
+
def end_angle(self, value):
|
|
217
|
+
if value < 0.0 or value > PI2:
|
|
218
|
+
raise ValueError("End angle must satisfy 0 <= angle <= 2 * pi.")
|
|
219
|
+
self._end_angle = value
|
|
220
|
+
|
|
221
|
+
@property
|
|
222
|
+
def circle(self):
|
|
223
|
+
return Circle(radius=self.radius, frame=self.frame)
|
|
224
|
+
|
|
225
|
+
@property
|
|
226
|
+
def center(self):
|
|
227
|
+
return self.frame.point
|
|
228
|
+
|
|
229
|
+
@property
|
|
230
|
+
def length(self):
|
|
231
|
+
return self.radius * self.angle
|
|
232
|
+
|
|
233
|
+
@property
|
|
234
|
+
def angle(self):
|
|
235
|
+
return self.end_angle - self.start_angle
|
|
236
|
+
|
|
237
|
+
@property
|
|
238
|
+
def diameter(self):
|
|
239
|
+
return 2.0 * self.radius
|
|
240
|
+
|
|
241
|
+
@property
|
|
242
|
+
def circumference(self):
|
|
243
|
+
return self.diameter * pi
|
|
244
|
+
|
|
245
|
+
@property
|
|
246
|
+
def is_circle(self):
|
|
247
|
+
return TOL.is_close(abs(self.angle), PI2)
|
|
248
|
+
|
|
249
|
+
@property
|
|
250
|
+
def is_closed(self):
|
|
251
|
+
return False
|
|
252
|
+
|
|
253
|
+
@property
|
|
254
|
+
def is_periodic(self):
|
|
255
|
+
return False
|
|
256
|
+
|
|
257
|
+
def _verify(self):
|
|
258
|
+
if self.angle < 0.0 or self.angle > PI2:
|
|
259
|
+
raise ValueError("Sweep angle must satisfy 0 < angle < 2 * Pi. Currently:{}".format(self.angle))
|
|
260
|
+
|
|
261
|
+
# =============================================================================
|
|
262
|
+
# Constructors
|
|
263
|
+
# =============================================================================
|
|
264
|
+
|
|
265
|
+
@classmethod
|
|
266
|
+
def from_circle(cls, circle, start_angle, end_angle):
|
|
267
|
+
"""Creates an Arc from a circle and start and end angles.
|
|
268
|
+
|
|
269
|
+
Parameters
|
|
270
|
+
----------
|
|
271
|
+
circle : :class:`compas.geometry.Circle`
|
|
272
|
+
The frame and radius of this circle will be used to create an Arc.
|
|
273
|
+
start_angle : float
|
|
274
|
+
The start angle in radians.
|
|
275
|
+
end_angle : float
|
|
276
|
+
The end angle in radians.
|
|
277
|
+
|
|
278
|
+
Returns
|
|
279
|
+
-------
|
|
280
|
+
:class:`compas.geometry.Arc`
|
|
281
|
+
|
|
282
|
+
"""
|
|
283
|
+
return cls(
|
|
284
|
+
frame=circle.frame,
|
|
285
|
+
radius=circle.radius,
|
|
286
|
+
start_angle=start_angle,
|
|
287
|
+
end_angle=end_angle,
|
|
288
|
+
)
|
|
289
|
+
|
|
290
|
+
# =============================================================================
|
|
291
|
+
# Conversions
|
|
292
|
+
# =============================================================================
|
|
293
|
+
|
|
294
|
+
# =============================================================================
|
|
295
|
+
# Transformations
|
|
296
|
+
# =============================================================================
|
|
297
|
+
|
|
298
|
+
# =============================================================================
|
|
299
|
+
# Methods
|
|
300
|
+
# =============================================================================
|
|
301
|
+
|
|
302
|
+
def point_at(self, t, world=True):
|
|
303
|
+
"""Returns the point at the specified parameter.
|
|
304
|
+
|
|
305
|
+
Parameters
|
|
306
|
+
----------
|
|
307
|
+
t : float
|
|
308
|
+
The parameter at which to evaluate the arc.
|
|
309
|
+
world : bool, optional
|
|
310
|
+
If ``True``, the point is returned in world coordinates.
|
|
311
|
+
|
|
312
|
+
Returns
|
|
313
|
+
-------
|
|
314
|
+
:class:`compas.geometry.Point`
|
|
315
|
+
|
|
316
|
+
Raises
|
|
317
|
+
------
|
|
318
|
+
ValueError
|
|
319
|
+
If the parameter is not in the domain of the curve ``[0, 1]``.
|
|
320
|
+
|
|
321
|
+
See Also
|
|
322
|
+
--------
|
|
323
|
+
:meth:`normal_at`, :meth:`tangent_at`
|
|
324
|
+
|
|
325
|
+
Notes
|
|
326
|
+
-----
|
|
327
|
+
The parametrisation of the arc is normalised with respect to the polar angle domain.
|
|
328
|
+
The value ``t=0.0`` corresponds to the start angle of the arc.
|
|
329
|
+
The value ``t=1.0`` corresponds to the end angle of the arc.
|
|
330
|
+
The value ``t=0.5`` corresponds to the angle halfway between start and end.
|
|
331
|
+
|
|
332
|
+
"""
|
|
333
|
+
if t < 0.0 or t > 1.0:
|
|
334
|
+
raise ValueError("Parameter t should be between 0.0 and 1.0")
|
|
335
|
+
|
|
336
|
+
angle = self.start_angle + t * self.angle
|
|
337
|
+
x = self.radius * cos(angle)
|
|
338
|
+
y = self.radius * sin(angle)
|
|
339
|
+
|
|
340
|
+
if not world:
|
|
341
|
+
return Point(x, y, 0.0)
|
|
342
|
+
|
|
343
|
+
return self.frame.point + self.frame.xaxis * x + self.frame.yaxis * y
|
|
344
|
+
|
|
345
|
+
def normal_at(self, t, world=True):
|
|
346
|
+
"""Construct a normal vector to the arc at a specific parameter.
|
|
347
|
+
|
|
348
|
+
Parameters
|
|
349
|
+
----------
|
|
350
|
+
t : float
|
|
351
|
+
The parameter at which to evaluate the arc.
|
|
352
|
+
world : bool, optional
|
|
353
|
+
If ``True``, the normal is returned in world coordinates.
|
|
354
|
+
|
|
355
|
+
Returns
|
|
356
|
+
-------
|
|
357
|
+
:class:`compas.geometry.Vector`
|
|
358
|
+
|
|
359
|
+
Raises
|
|
360
|
+
------
|
|
361
|
+
ValueError
|
|
362
|
+
If the parameter is not in the domain of the curve ``[0, 1]``.
|
|
363
|
+
|
|
364
|
+
See Also
|
|
365
|
+
--------
|
|
366
|
+
:meth:`point_at`, :meth:`tangent_at`
|
|
367
|
+
|
|
368
|
+
Notes
|
|
369
|
+
-----
|
|
370
|
+
The parametrisation of the arc is normalised with respect to the polar angle domain.
|
|
371
|
+
The value ``t=0.0`` corresponds to the start angle of the arc.
|
|
372
|
+
The value ``t=1.0`` corresponds to the end angle of the arc.
|
|
373
|
+
The value ``t=0.5`` corresponds to the angle halfway between start and end.
|
|
374
|
+
|
|
375
|
+
"""
|
|
376
|
+
if not world:
|
|
377
|
+
point = self.point_at(t, world=False)
|
|
378
|
+
normal = Vector(-point.x, -point.y, 0.0)
|
|
379
|
+
normal.unitize()
|
|
380
|
+
return normal
|
|
381
|
+
|
|
382
|
+
normal = self.frame.point - self.point_at(t)
|
|
383
|
+
normal.unitize()
|
|
384
|
+
return normal
|
|
385
|
+
|
|
386
|
+
def tangent_at(self, t, world=True):
|
|
387
|
+
"""Construct a tangent on the circle at a specific parameter.
|
|
388
|
+
|
|
389
|
+
Parameters
|
|
390
|
+
----------
|
|
391
|
+
t : float
|
|
392
|
+
The parameter at which to evaluate the arc.
|
|
393
|
+
world : bool, optional
|
|
394
|
+
If ``True``, the tangent is returned in world coordinates.
|
|
395
|
+
|
|
396
|
+
Returns
|
|
397
|
+
-------
|
|
398
|
+
:class:`compas.geometry.Vector`
|
|
399
|
+
The tangent on the circle at the specified parameter.
|
|
400
|
+
|
|
401
|
+
Raises
|
|
402
|
+
------
|
|
403
|
+
ValueError
|
|
404
|
+
If the parameter is not in the domain of the curve ``[0, 1]``.
|
|
405
|
+
|
|
406
|
+
See Also
|
|
407
|
+
--------
|
|
408
|
+
:meth:`point_at`, :meth:`normal_at`, :meth:`binormal_at`
|
|
409
|
+
|
|
410
|
+
Notes
|
|
411
|
+
-----
|
|
412
|
+
The parametrisation of the arc is normalised with respect to the polar angle domain.
|
|
413
|
+
The value ``t=0.0`` corresponds to the start angle of the arc.
|
|
414
|
+
The value ``t=1.0`` corresponds to the end angle of the arc.
|
|
415
|
+
The value ``t=0.5`` corresponds to the angle halfway between start and end.
|
|
416
|
+
|
|
417
|
+
"""
|
|
418
|
+
if t < 0.0 or t > 1.0:
|
|
419
|
+
raise ValueError("Parameter t should be between 0.0 and 1.0")
|
|
420
|
+
|
|
421
|
+
angle = self.start_angle + t * self.angle
|
|
422
|
+
|
|
423
|
+
x = -self.radius * sin(angle)
|
|
424
|
+
y = +self.radius * cos(angle)
|
|
425
|
+
|
|
426
|
+
if not world:
|
|
427
|
+
return Vector(x, y, 0.0)
|
|
428
|
+
|
|
429
|
+
return self.frame.xaxis * x + self.frame.yaxis * y
|