COMPAS 2.1.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- compas/__init__.py +274 -0
- compas/__main__.py +31 -0
- compas/_iotools.py +80 -0
- compas/_os.py +746 -0
- compas/colors/__init__.py +14 -0
- compas/colors/cmcrameri/acton.txt +256 -0
- compas/colors/cmcrameri/actonS.txt +100 -0
- compas/colors/cmcrameri/bam.txt +256 -0
- compas/colors/cmcrameri/bamO.txt +256 -0
- compas/colors/cmcrameri/bamako.txt +256 -0
- compas/colors/cmcrameri/bamakoS.txt +100 -0
- compas/colors/cmcrameri/batlow.txt +256 -0
- compas/colors/cmcrameri/batlowK.txt +256 -0
- compas/colors/cmcrameri/batlowS.txt +100 -0
- compas/colors/cmcrameri/batlowW.txt +256 -0
- compas/colors/cmcrameri/berlin.txt +256 -0
- compas/colors/cmcrameri/bilbao.txt +256 -0
- compas/colors/cmcrameri/bilbaoS.txt +100 -0
- compas/colors/cmcrameri/broc.txt +256 -0
- compas/colors/cmcrameri/brocO.txt +256 -0
- compas/colors/cmcrameri/buda.txt +256 -0
- compas/colors/cmcrameri/budaS.txt +100 -0
- compas/colors/cmcrameri/bukavu.txt +256 -0
- compas/colors/cmcrameri/cork.txt +256 -0
- compas/colors/cmcrameri/corkO.txt +256 -0
- compas/colors/cmcrameri/davos.txt +256 -0
- compas/colors/cmcrameri/davosS.txt +100 -0
- compas/colors/cmcrameri/devon.txt +256 -0
- compas/colors/cmcrameri/devonS.txt +100 -0
- compas/colors/cmcrameri/fes.txt +256 -0
- compas/colors/cmcrameri/grayC.txt +256 -0
- compas/colors/cmcrameri/grayCS.txt +100 -0
- compas/colors/cmcrameri/hawaii.txt +256 -0
- compas/colors/cmcrameri/hawaiiS.txt +100 -0
- compas/colors/cmcrameri/imola.txt +256 -0
- compas/colors/cmcrameri/imolaS.txt +100 -0
- compas/colors/cmcrameri/lajolla.txt +256 -0
- compas/colors/cmcrameri/lajollaS.txt +100 -0
- compas/colors/cmcrameri/lapaz.txt +256 -0
- compas/colors/cmcrameri/lapazS.txt +100 -0
- compas/colors/cmcrameri/lisbon.txt +256 -0
- compas/colors/cmcrameri/nuuk.txt +256 -0
- compas/colors/cmcrameri/nuukS.txt +100 -0
- compas/colors/cmcrameri/oleron.txt +256 -0
- compas/colors/cmcrameri/oslo.txt +256 -0
- compas/colors/cmcrameri/osloS.txt +100 -0
- compas/colors/cmcrameri/roma.txt +256 -0
- compas/colors/cmcrameri/romaO.txt +256 -0
- compas/colors/cmcrameri/tofino.txt +256 -0
- compas/colors/cmcrameri/tokyo.txt +256 -0
- compas/colors/cmcrameri/tokyoS.txt +100 -0
- compas/colors/cmcrameri/turku.txt +256 -0
- compas/colors/cmcrameri/turkuS.txt +100 -0
- compas/colors/cmcrameri/vanimo.txt +256 -0
- compas/colors/cmcrameri/vik.txt +256 -0
- compas/colors/cmcrameri/vikO.txt +256 -0
- compas/colors/color.py +1118 -0
- compas/colors/colordict.py +103 -0
- compas/colors/colormap.py +306 -0
- compas/colors/html_colors.py +149 -0
- compas/colors/mpl_colormap.py +1064 -0
- compas/data/__init__.py +31 -0
- compas/data/coercion.py +71 -0
- compas/data/conftest.py +10 -0
- compas/data/data.py +342 -0
- compas/data/encoders.py +240 -0
- compas/data/exceptions.py +2 -0
- compas/data/json.py +240 -0
- compas/data/samples/boxes.obj +250 -0
- compas/data/samples/butt_model.obj +2829 -0
- compas/data/samples/cone.stl +0 -0
- compas/data/samples/cube.off +16 -0
- compas/data/samples/cube_ascii.stl +56114 -0
- compas/data/samples/cube_binary.stl +0 -0
- compas/data/samples/cube_binary_2.stl +0 -0
- compas/data/samples/doosabin.json +1 -0
- compas/data/samples/faces.obj +63 -0
- compas/data/samples/faces_big.obj +9663 -0
- compas/data/samples/faces_reversed.obj +63 -0
- compas/data/samples/fink.obj +135 -0
- compas/data/samples/grid_irregular.obj +303 -0
- compas/data/samples/hypar.obj +148 -0
- compas/data/samples/lines.json +1 -0
- compas/data/samples/lines.obj +282 -0
- compas/data/samples/lines_big.obj +40322 -0
- compas/data/samples/lines_bigger.obj +161282 -0
- compas/data/samples/lines_noleaves.obj +422 -0
- compas/data/samples/mesh.obj +874 -0
- compas/data/samples/mesh_100_faces.json +1893 -0
- compas/data/samples/mesh_110_faces.json +2081 -0
- compas/data/samples/open_edges.obj +424 -0
- compas/data/samples/point.json +1 -0
- compas/data/samples/quadmesh.obj +183 -0
- compas/data/samples/quadmesh_planar.obj +181 -0
- compas/data/samples/saddle.obj +314 -0
- compas/data/samples/spline.obj +72 -0
- compas/data/samples/tubemesh.json +1 -0
- compas/data/samples/tubemesh.obj +378 -0
- compas/data/samples/tubemesh.off +374 -0
- compas/data/samples/tubemesh.ply +551 -0
- compas/data/schema.py +137 -0
- compas/data/validators.py +243 -0
- compas/datastructures/__init__.py +75 -0
- compas/datastructures/_mutablemapping.py +148 -0
- compas/datastructures/assembly/__init__.py +0 -0
- compas/datastructures/assembly/assembly.py +234 -0
- compas/datastructures/assembly/exceptions.py +6 -0
- compas/datastructures/assembly/part.py +228 -0
- compas/datastructures/attributes.py +85 -0
- compas/datastructures/cell_network/__init__.py +0 -0
- compas/datastructures/cell_network/cell_network.py +4190 -0
- compas/datastructures/datastructure.py +309 -0
- compas/datastructures/graph/__init__.py +0 -0
- compas/datastructures/graph/duality.py +197 -0
- compas/datastructures/graph/graph.py +2478 -0
- compas/datastructures/graph/operations/__init__.py +0 -0
- compas/datastructures/graph/operations/join.py +124 -0
- compas/datastructures/graph/operations/split.py +63 -0
- compas/datastructures/graph/planarity.py +292 -0
- compas/datastructures/graph/smoothing.py +59 -0
- compas/datastructures/mesh/__init__.py +0 -0
- compas/datastructures/mesh/conway.py +553 -0
- compas/datastructures/mesh/duality.py +104 -0
- compas/datastructures/mesh/mesh.py +5103 -0
- compas/datastructures/mesh/operations/__init__.py +0 -0
- compas/datastructures/mesh/operations/collapse.py +350 -0
- compas/datastructures/mesh/operations/extrude.py +0 -0
- compas/datastructures/mesh/operations/insert.py +120 -0
- compas/datastructures/mesh/operations/merge.py +83 -0
- compas/datastructures/mesh/operations/split.py +263 -0
- compas/datastructures/mesh/operations/substitute.py +37 -0
- compas/datastructures/mesh/operations/swap.py +62 -0
- compas/datastructures/mesh/operations/weld.py +107 -0
- compas/datastructures/mesh/remesh.py +234 -0
- compas/datastructures/mesh/slice.py +170 -0
- compas/datastructures/mesh/smoothing.py +187 -0
- compas/datastructures/mesh/subdivision.py +754 -0
- compas/datastructures/tree/__init__.py +0 -0
- compas/datastructures/tree/tree.py +504 -0
- compas/datastructures/volmesh/__init__.py +0 -0
- compas/datastructures/volmesh/volmesh.py +4203 -0
- compas/files/__init__.py +27 -0
- compas/files/_xml/__init__.py +0 -0
- compas/files/_xml/xml_cli.py +213 -0
- compas/files/_xml/xml_cpython.py +32 -0
- compas/files/_xml/xml_pre_38.py +58 -0
- compas/files/_xml/xml_shared.py +40 -0
- compas/files/gltf/__init__.py +0 -0
- compas/files/gltf/constants.py +59 -0
- compas/files/gltf/data_classes.py +657 -0
- compas/files/gltf/extensions.py +317 -0
- compas/files/gltf/gltf.py +92 -0
- compas/files/gltf/gltf_children.py +64 -0
- compas/files/gltf/gltf_content.py +615 -0
- compas/files/gltf/gltf_exporter.py +465 -0
- compas/files/gltf/gltf_mesh.py +273 -0
- compas/files/gltf/gltf_node.py +348 -0
- compas/files/gltf/gltf_parser.py +115 -0
- compas/files/gltf/gltf_reader.py +310 -0
- compas/files/gltf/gltf_scene.py +125 -0
- compas/files/gltf/helpers.py +59 -0
- compas/files/obj.py +680 -0
- compas/files/off.py +296 -0
- compas/files/ply.py +697 -0
- compas/files/stl.py +436 -0
- compas/files/xml.py +328 -0
- compas/geometry/__init__.py +772 -0
- compas/geometry/_core/__init__.py +0 -0
- compas/geometry/_core/_algebra.py +2826 -0
- compas/geometry/_core/angles.py +408 -0
- compas/geometry/_core/centroids.py +573 -0
- compas/geometry/_core/distance.py +895 -0
- compas/geometry/_core/normals.py +149 -0
- compas/geometry/_core/nurbs.py +367 -0
- compas/geometry/_core/predicates_2.py +582 -0
- compas/geometry/_core/predicates_3.py +1111 -0
- compas/geometry/_core/quaternions.py +196 -0
- compas/geometry/_core/size.py +204 -0
- compas/geometry/_core/tangent.py +56 -0
- compas/geometry/_core/transformations.py +1121 -0
- compas/geometry/_core/transformations_numpy.py +279 -0
- compas/geometry/bbox.py +145 -0
- compas/geometry/bbox_numpy.py +306 -0
- compas/geometry/bestfit.py +77 -0
- compas/geometry/bestfit_numpy.py +259 -0
- compas/geometry/booleans.py +297 -0
- compas/geometry/booleans_shapely.py +147 -0
- compas/geometry/brep/__init__.py +112 -0
- compas/geometry/brep/brep.py +1131 -0
- compas/geometry/brep/edge.py +302 -0
- compas/geometry/brep/errors.py +22 -0
- compas/geometry/brep/face.py +329 -0
- compas/geometry/brep/loop.py +87 -0
- compas/geometry/brep/trim.py +46 -0
- compas/geometry/brep/vertex.py +46 -0
- compas/geometry/contours.py +32 -0
- compas/geometry/curves/__init__.py +0 -0
- compas/geometry/curves/arc.py +429 -0
- compas/geometry/curves/bezier.py +345 -0
- compas/geometry/curves/circle.py +500 -0
- compas/geometry/curves/conic.py +16 -0
- compas/geometry/curves/curve.py +614 -0
- compas/geometry/curves/ellipse.py +408 -0
- compas/geometry/curves/hyperbola.py +336 -0
- compas/geometry/curves/line.py +431 -0
- compas/geometry/curves/nurbs.py +412 -0
- compas/geometry/curves/parabola.py +256 -0
- compas/geometry/curves/polyline.py +724 -0
- compas/geometry/frame.py +769 -0
- compas/geometry/geometry.py +296 -0
- compas/geometry/hull.py +146 -0
- compas/geometry/hull_numpy.py +82 -0
- compas/geometry/icp_numpy.py +104 -0
- compas/geometry/interpolation_barycentric.py +38 -0
- compas/geometry/interpolation_coons.py +102 -0
- compas/geometry/interpolation_tweening.py +87 -0
- compas/geometry/intersection.py +121 -0
- compas/geometry/intersections.py +1105 -0
- compas/geometry/kdtree.py +153 -0
- compas/geometry/offset.py +208 -0
- compas/geometry/pca_numpy.py +87 -0
- compas/geometry/plane.py +657 -0
- compas/geometry/point.py +664 -0
- compas/geometry/pointcloud.py +409 -0
- compas/geometry/polygon.py +473 -0
- compas/geometry/polyhedron.py +650 -0
- compas/geometry/projection.py +155 -0
- compas/geometry/quadmesh_planarize.py +30 -0
- compas/geometry/quadmesh_planarize_none.py +114 -0
- compas/geometry/quaternion.py +544 -0
- compas/geometry/reflection.py +102 -0
- compas/geometry/rotation.py +354 -0
- compas/geometry/scale.py +100 -0
- compas/geometry/shapes/__init__.py +0 -0
- compas/geometry/shapes/box.py +747 -0
- compas/geometry/shapes/capsule.py +472 -0
- compas/geometry/shapes/cone.py +309 -0
- compas/geometry/shapes/cylinder.py +355 -0
- compas/geometry/shapes/shape.py +300 -0
- compas/geometry/shapes/sphere.py +362 -0
- compas/geometry/shapes/torus.py +294 -0
- compas/geometry/shear.py +115 -0
- compas/geometry/surfaces/__init__.py +0 -0
- compas/geometry/surfaces/conical.py +166 -0
- compas/geometry/surfaces/cylindrical.py +251 -0
- compas/geometry/surfaces/extrusion.py +0 -0
- compas/geometry/surfaces/nurbs.py +380 -0
- compas/geometry/surfaces/planar.py +223 -0
- compas/geometry/surfaces/revolution.py +0 -0
- compas/geometry/surfaces/spherical.py +259 -0
- compas/geometry/surfaces/surface.py +689 -0
- compas/geometry/surfaces/toroidal.py +198 -0
- compas/geometry/transformation.py +554 -0
- compas/geometry/translation.py +104 -0
- compas/geometry/triangulation_delaunay.py +102 -0
- compas/geometry/triangulation_earclip.py +300 -0
- compas/geometry/trimesh_curvature.py +113 -0
- compas/geometry/trimesh_descent_numpy.py +26 -0
- compas/geometry/trimesh_geodistance.py +35 -0
- compas/geometry/trimesh_gradient_numpy.py +74 -0
- compas/geometry/trimesh_isolines.py +41 -0
- compas/geometry/trimesh_matrices.py +31 -0
- compas/geometry/trimesh_matrices_numpy.py +191 -0
- compas/geometry/trimesh_parametrisation.py +55 -0
- compas/geometry/trimesh_pull_points_numpy.py +216 -0
- compas/geometry/trimesh_remeshing.py +97 -0
- compas/geometry/trimesh_samplepoints_numpy.py +108 -0
- compas/geometry/trimesh_slicing.py +28 -0
- compas/geometry/trimesh_smoothing_numpy.py +34 -0
- compas/geometry/vector.py +889 -0
- compas/itertools.py +441 -0
- compas/linalg.py +634 -0
- compas/matrices.py +314 -0
- compas/plugins.py +488 -0
- compas/rpc/__init__.py +20 -0
- compas/rpc/__main__.py +77 -0
- compas/rpc/dispatcher.py +181 -0
- compas/rpc/errors.py +11 -0
- compas/rpc/proxy.py +437 -0
- compas/rpc/server.py +79 -0
- compas/rpc/services/__init__.py +0 -0
- compas/rpc/services/default.py +87 -0
- compas/rpc/services/watcher.py +43 -0
- compas/scene/__init__.py +56 -0
- compas/scene/assemblyobject.py +3 -0
- compas/scene/context.py +154 -0
- compas/scene/descriptors/__init__.py +0 -0
- compas/scene/descriptors/attribute.py +30 -0
- compas/scene/descriptors/color.py +91 -0
- compas/scene/descriptors/colordict.py +101 -0
- compas/scene/descriptors/protocol.py +12 -0
- compas/scene/exceptions.py +7 -0
- compas/scene/geometryobject.py +58 -0
- compas/scene/graphobject.py +173 -0
- compas/scene/meshobject.py +238 -0
- compas/scene/scene.py +144 -0
- compas/scene/sceneobject.py +253 -0
- compas/scene/volmeshobject.py +252 -0
- compas/tolerance.py +879 -0
- compas/topology/__init__.py +45 -0
- compas/topology/combinatorics.py +108 -0
- compas/topology/connectivity.py +129 -0
- compas/topology/orientation.py +204 -0
- compas/topology/traversal.py +567 -0
- compas/utilities/__init__.py +25 -0
- compas/utilities/azync.py +155 -0
- compas/utilities/datetime.py +40 -0
- compas/utilities/decorators.py +136 -0
- compas/utilities/remote.py +54 -0
- compas/utilities/ssh.py +169 -0
- compas-2.1.1.dist-info/AUTHORS.md +42 -0
- compas-2.1.1.dist-info/LICENSE +21 -0
- compas-2.1.1.dist-info/METADATA +132 -0
- compas-2.1.1.dist-info/RECORD +468 -0
- compas-2.1.1.dist-info/WHEEL +5 -0
- compas-2.1.1.dist-info/entry_points.txt +2 -0
- compas-2.1.1.dist-info/top_level.txt +4 -0
- compas_blender/__init__.py +250 -0
- compas_blender/collections.py +130 -0
- compas_blender/conversions/__init__.py +48 -0
- compas_blender/conversions/breps.py +0 -0
- compas_blender/conversions/colors.py +23 -0
- compas_blender/conversions/curves.py +125 -0
- compas_blender/conversions/geometry.py +161 -0
- compas_blender/conversions/meshes.py +148 -0
- compas_blender/conversions/surfaces.py +48 -0
- compas_blender/conversions/transformations.py +46 -0
- compas_blender/data.py +30 -0
- compas_blender/geometry/__init__.py +14 -0
- compas_blender/geometry/booleans.py +100 -0
- compas_blender/install.py +338 -0
- compas_blender/objects.py +326 -0
- compas_blender/print_python_path.py +18 -0
- compas_blender/scene/__init__.py +116 -0
- compas_blender/scene/boxobject.py +64 -0
- compas_blender/scene/capsuleobject.py +73 -0
- compas_blender/scene/circleobject.py +53 -0
- compas_blender/scene/coneobject.py +70 -0
- compas_blender/scene/curveobject.py +58 -0
- compas_blender/scene/cylinderobject.py +70 -0
- compas_blender/scene/frameobject.py +105 -0
- compas_blender/scene/graphobject.py +257 -0
- compas_blender/scene/lineobject.py +60 -0
- compas_blender/scene/meshobject.py +508 -0
- compas_blender/scene/planeobject.py +81 -0
- compas_blender/scene/pointcloudobject.py +67 -0
- compas_blender/scene/pointobject.py +71 -0
- compas_blender/scene/polygonobject.py +57 -0
- compas_blender/scene/polyhedronobject.py +57 -0
- compas_blender/scene/polylineobject.py +54 -0
- compas_blender/scene/sceneobject.py +249 -0
- compas_blender/scene/sphereobject.py +72 -0
- compas_blender/scene/surfaceobject.py +54 -0
- compas_blender/scene/torusobject.py +73 -0
- compas_blender/scene/vectorobject.py +69 -0
- compas_blender/scene/volmeshobject.py +475 -0
- compas_blender/utilities/__init__.py +38 -0
- compas_blender/utilities/drawing.py +768 -0
- compas_ghpython/__init__.py +124 -0
- compas_ghpython/components/Compas_FromJson/code.py +18 -0
- compas_ghpython/components/Compas_Info/code.py +15 -0
- compas_ghpython/components/Compas_RpcCall/code.py +31 -0
- compas_ghpython/components/Compas_ToJson/code.py +19 -0
- compas_ghpython/components/Compas_ToRhinoGeometry/code.py +15 -0
- compas_ghpython/components/__init__.py +99 -0
- compas_ghpython/install.py +29 -0
- compas_ghpython/scene/__init__.py +115 -0
- compas_ghpython/scene/boxobject.py +40 -0
- compas_ghpython/scene/brepobject.py +40 -0
- compas_ghpython/scene/capsuleobject.py +41 -0
- compas_ghpython/scene/circleobject.py +40 -0
- compas_ghpython/scene/coneobject.py +40 -0
- compas_ghpython/scene/curveobject.py +42 -0
- compas_ghpython/scene/cylinderobject.py +38 -0
- compas_ghpython/scene/ellipseobject.py +40 -0
- compas_ghpython/scene/frameobject.py +67 -0
- compas_ghpython/scene/graphobject.py +77 -0
- compas_ghpython/scene/lineobject.py +39 -0
- compas_ghpython/scene/meshobject.py +137 -0
- compas_ghpython/scene/planeobject.py +61 -0
- compas_ghpython/scene/pointobject.py +38 -0
- compas_ghpython/scene/polygonobject.py +48 -0
- compas_ghpython/scene/polyhedronobject.py +48 -0
- compas_ghpython/scene/polylineobject.py +39 -0
- compas_ghpython/scene/sceneobject.py +12 -0
- compas_ghpython/scene/sphereobject.py +39 -0
- compas_ghpython/scene/surfaceobject.py +42 -0
- compas_ghpython/scene/torusobject.py +39 -0
- compas_ghpython/scene/vectorobject.py +51 -0
- compas_ghpython/scene/volmeshobject.py +154 -0
- compas_ghpython/sets.py +83 -0
- compas_ghpython/timer.py +36 -0
- compas_ghpython/uninstall.py +31 -0
- compas_ghpython/utilities/__init__.py +33 -0
- compas_ghpython/utilities/drawing.py +457 -0
- compas_rhino/__init__.py +607 -0
- compas_rhino/conduits/__init__.py +16 -0
- compas_rhino/conduits/base.py +121 -0
- compas_rhino/conduits/faces.py +91 -0
- compas_rhino/conduits/labels.py +102 -0
- compas_rhino/conduits/lines.py +109 -0
- compas_rhino/conduits/points.py +111 -0
- compas_rhino/conversions/__init__.py +168 -0
- compas_rhino/conversions/breps.py +122 -0
- compas_rhino/conversions/curves.py +453 -0
- compas_rhino/conversions/docobjects.py +0 -0
- compas_rhino/conversions/exceptions.py +7 -0
- compas_rhino/conversions/extrusions.py +80 -0
- compas_rhino/conversions/geometry.py +187 -0
- compas_rhino/conversions/meshes.py +281 -0
- compas_rhino/conversions/shapes.py +291 -0
- compas_rhino/conversions/surfaces.py +355 -0
- compas_rhino/conversions/transformations.py +45 -0
- compas_rhino/geometry/__init__.py +44 -0
- compas_rhino/geometry/booleans.py +118 -0
- compas_rhino/geometry/brep/__init__.py +40 -0
- compas_rhino/geometry/brep/brep.py +554 -0
- compas_rhino/geometry/brep/builder.py +184 -0
- compas_rhino/geometry/brep/edge.py +202 -0
- compas_rhino/geometry/brep/face.py +285 -0
- compas_rhino/geometry/brep/loop.py +129 -0
- compas_rhino/geometry/brep/trim.py +99 -0
- compas_rhino/geometry/brep/vertex.py +76 -0
- compas_rhino/geometry/curves/__init__.py +43 -0
- compas_rhino/geometry/curves/curve.py +382 -0
- compas_rhino/geometry/curves/nurbs.py +298 -0
- compas_rhino/geometry/surfaces/__init__.py +50 -0
- compas_rhino/geometry/surfaces/nurbs.py +370 -0
- compas_rhino/geometry/surfaces/surface.py +407 -0
- compas_rhino/geometry/trimesh_curvature.py +344 -0
- compas_rhino/geometry/trimesh_slicing.py +65 -0
- compas_rhino/install.py +382 -0
- compas_rhino/install_plugin.py +169 -0
- compas_rhino/install_with_pip.py +20 -0
- compas_rhino/layers.py +347 -0
- compas_rhino/objects.py +1141 -0
- compas_rhino/print_python_path.py +18 -0
- compas_rhino/scene/__init__.py +123 -0
- compas_rhino/scene/boxobject.py +44 -0
- compas_rhino/scene/brepobject.py +41 -0
- compas_rhino/scene/capsuleobject.py +45 -0
- compas_rhino/scene/circleobject.py +43 -0
- compas_rhino/scene/coneobject.py +43 -0
- compas_rhino/scene/curveobject.py +43 -0
- compas_rhino/scene/cylinderobject.py +43 -0
- compas_rhino/scene/ellipseobject.py +44 -0
- compas_rhino/scene/frameobject.py +99 -0
- compas_rhino/scene/graphobject.py +364 -0
- compas_rhino/scene/helpers.py +33 -0
- compas_rhino/scene/lineobject.py +43 -0
- compas_rhino/scene/meshobject.py +673 -0
- compas_rhino/scene/planeobject.py +71 -0
- compas_rhino/scene/pointobject.py +43 -0
- compas_rhino/scene/polygonobject.py +45 -0
- compas_rhino/scene/polyhedronobject.py +45 -0
- compas_rhino/scene/polylineobject.py +43 -0
- compas_rhino/scene/sceneobject.py +123 -0
- compas_rhino/scene/sphereobject.py +43 -0
- compas_rhino/scene/surfaceobject.py +42 -0
- compas_rhino/scene/torusobject.py +43 -0
- compas_rhino/scene/vectorobject.py +49 -0
- compas_rhino/scene/volmeshobject.py +518 -0
- compas_rhino/ui.py +114 -0
- compas_rhino/uninstall.py +243 -0
- compas_rhino/uninstall_plugin.py +91 -0
- compas_rhino/utilities/__init__.py +37 -0
- compas_rhino/utilities/constructors.py +71 -0
- compas_rhino/utilities/drawing.py +1081 -0
compas/geometry/frame.py
ADDED
|
@@ -0,0 +1,769 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from compas.geometry import Geometry
|
|
6
|
+
from compas.geometry import Transformation
|
|
7
|
+
from compas.geometry import argmax
|
|
8
|
+
from compas.geometry import axis_angle_vector_from_matrix
|
|
9
|
+
from compas.geometry import basis_vectors_from_matrix
|
|
10
|
+
from compas.geometry import cross_vectors
|
|
11
|
+
from compas.geometry import decompose_matrix
|
|
12
|
+
from compas.geometry import euler_angles_from_matrix
|
|
13
|
+
from compas.geometry import matrix_from_axis_angle_vector
|
|
14
|
+
from compas.geometry import matrix_from_basis_vectors
|
|
15
|
+
from compas.geometry import matrix_from_euler_angles
|
|
16
|
+
from compas.geometry import matrix_from_quaternion
|
|
17
|
+
from compas.geometry import quaternion_from_matrix
|
|
18
|
+
from compas.geometry import subtract_vectors
|
|
19
|
+
from compas.itertools import linspace
|
|
20
|
+
from compas.tolerance import TOL
|
|
21
|
+
|
|
22
|
+
from .point import Point
|
|
23
|
+
from .quaternion import Quaternion
|
|
24
|
+
from .vector import Vector
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
class Frame(Geometry):
|
|
28
|
+
"""A frame is defined by a base point and two orthonormal base vectors.
|
|
29
|
+
|
|
30
|
+
Parameters
|
|
31
|
+
----------
|
|
32
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
33
|
+
The origin of the frame.
|
|
34
|
+
xaxis : [float, float, float] | :class:`compas.geometry.Vector`, optional
|
|
35
|
+
The x-axis of the frame. Defaults to the unit X vector.
|
|
36
|
+
yaxis : [float, float, float] | :class:`compas.geometry.Vector`, optional
|
|
37
|
+
The y-axis of the frame. Defaults to the unit Y vector.
|
|
38
|
+
name : str, optional
|
|
39
|
+
The name of the frame.
|
|
40
|
+
|
|
41
|
+
Attributes
|
|
42
|
+
----------
|
|
43
|
+
axes : list of :class:`compas.geometry.Vector`, read-only
|
|
44
|
+
The XYZ axes of the frame.
|
|
45
|
+
axis_angle_vector : :class:`compas.geometry.Vector`, read-only
|
|
46
|
+
The axis-angle vector representing the rotation of the frame.
|
|
47
|
+
normal : :class:`compas.geometry.Vector`, read-only
|
|
48
|
+
The normal of the base plane of the frame.
|
|
49
|
+
point : :class:`compas.geometry.Point`
|
|
50
|
+
The base point of the frame.
|
|
51
|
+
quaternion : :class:`compas.geometry.Quaternion`, read-only
|
|
52
|
+
The quaternion from the rotation given by the frame.
|
|
53
|
+
xaxis : :class:`compas.geometry.Vector`
|
|
54
|
+
The local X axis of the frame.
|
|
55
|
+
yaxis : :class:`compas.geometry.Vector`
|
|
56
|
+
The local Y axis of the frame.
|
|
57
|
+
zaxis : :class:`compas.geometry.Vector`, read-only
|
|
58
|
+
The Z axis of the frame.
|
|
59
|
+
|
|
60
|
+
Notes
|
|
61
|
+
-----
|
|
62
|
+
All input vectors are orthonormalized when creating a frame, with the first
|
|
63
|
+
vector as starting point.
|
|
64
|
+
|
|
65
|
+
Examples
|
|
66
|
+
--------
|
|
67
|
+
>>> from compas.geometry import Point
|
|
68
|
+
>>> from compas.geometry import Vector
|
|
69
|
+
>>> f = Frame([0, 0, 0], [1, 0, 0], [0, 1, 0])
|
|
70
|
+
>>> f = Frame(Point(0, 0, 0), Vector(1, 0, 0), Vector(0, 1, 0))
|
|
71
|
+
>>> f = Frame([0, 0, 0])
|
|
72
|
+
|
|
73
|
+
"""
|
|
74
|
+
|
|
75
|
+
DATASCHEMA = {
|
|
76
|
+
"type": "object",
|
|
77
|
+
"properties": {
|
|
78
|
+
"point": Point.DATASCHEMA,
|
|
79
|
+
"xaxis": Vector.DATASCHEMA,
|
|
80
|
+
"yaxis": Vector.DATASCHEMA,
|
|
81
|
+
},
|
|
82
|
+
"required": ["point", "xaxis", "yaxis"],
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
@property
|
|
86
|
+
def __data__(self):
|
|
87
|
+
return {
|
|
88
|
+
"point": self.point.__data__,
|
|
89
|
+
"xaxis": self.xaxis.__data__,
|
|
90
|
+
"yaxis": self.yaxis.__data__,
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
def __init__(self, point, xaxis=None, yaxis=None, name=None):
|
|
94
|
+
super(Frame, self).__init__(name=name)
|
|
95
|
+
self._point = None
|
|
96
|
+
self._xaxis = None
|
|
97
|
+
self._yaxis = None
|
|
98
|
+
self._zaxis = None
|
|
99
|
+
self.point = point
|
|
100
|
+
self.xaxis = Vector(1, 0, 0) if xaxis is None else xaxis
|
|
101
|
+
self.yaxis = Vector(0, 1, 0) if yaxis is None else yaxis
|
|
102
|
+
|
|
103
|
+
def __repr__(self):
|
|
104
|
+
return "{0}(point={1!r}, xaxis={2!r}, yaxis={3!r})".format(
|
|
105
|
+
type(self).__name__,
|
|
106
|
+
self.point,
|
|
107
|
+
self.xaxis,
|
|
108
|
+
self.yaxis,
|
|
109
|
+
)
|
|
110
|
+
|
|
111
|
+
def __len__(self):
|
|
112
|
+
return 3
|
|
113
|
+
|
|
114
|
+
def __getitem__(self, key):
|
|
115
|
+
if key == 0:
|
|
116
|
+
return self.point
|
|
117
|
+
if key == 1:
|
|
118
|
+
return self.xaxis
|
|
119
|
+
if key == 2:
|
|
120
|
+
return self.yaxis
|
|
121
|
+
raise KeyError
|
|
122
|
+
|
|
123
|
+
def __setitem__(self, key, value):
|
|
124
|
+
if key == 0:
|
|
125
|
+
self.point = value
|
|
126
|
+
return
|
|
127
|
+
if key == 1:
|
|
128
|
+
self.xaxis = value
|
|
129
|
+
return
|
|
130
|
+
if key == 2:
|
|
131
|
+
self.yaxis = value
|
|
132
|
+
raise KeyError
|
|
133
|
+
|
|
134
|
+
def __iter__(self):
|
|
135
|
+
return iter([self.point, self.xaxis, self.yaxis])
|
|
136
|
+
|
|
137
|
+
def __eq__(self, other, tol=None):
|
|
138
|
+
if not hasattr(other, "__iter__") or not hasattr(other, "__len__") or len(self) != len(other):
|
|
139
|
+
return False
|
|
140
|
+
return TOL.is_allclose(self, other, atol=tol)
|
|
141
|
+
|
|
142
|
+
# ==========================================================================
|
|
143
|
+
# Properties
|
|
144
|
+
# ==========================================================================
|
|
145
|
+
|
|
146
|
+
@property
|
|
147
|
+
def point(self):
|
|
148
|
+
if not self._point:
|
|
149
|
+
raise ValueError("The frame has no origin.")
|
|
150
|
+
return self._point
|
|
151
|
+
|
|
152
|
+
@point.setter
|
|
153
|
+
def point(self, point):
|
|
154
|
+
self._point = Point(*point)
|
|
155
|
+
|
|
156
|
+
@property
|
|
157
|
+
def xaxis(self):
|
|
158
|
+
if not self._xaxis:
|
|
159
|
+
raise ValueError("The frame has no x-axis.")
|
|
160
|
+
return self._xaxis
|
|
161
|
+
|
|
162
|
+
@xaxis.setter
|
|
163
|
+
def xaxis(self, vector):
|
|
164
|
+
xaxis = Vector(*vector)
|
|
165
|
+
xaxis.unitize()
|
|
166
|
+
self._xaxis = xaxis
|
|
167
|
+
self._zaxis = None
|
|
168
|
+
|
|
169
|
+
@property
|
|
170
|
+
def yaxis(self):
|
|
171
|
+
if not self._yaxis:
|
|
172
|
+
raise ValueError("The frame has no y-axis.")
|
|
173
|
+
return self._yaxis
|
|
174
|
+
|
|
175
|
+
@yaxis.setter
|
|
176
|
+
def yaxis(self, vector):
|
|
177
|
+
yaxis = Vector(*vector)
|
|
178
|
+
yaxis.unitize()
|
|
179
|
+
zaxis = self.xaxis.cross(yaxis)
|
|
180
|
+
zaxis.unitize()
|
|
181
|
+
self._yaxis = zaxis.cross(self.xaxis)
|
|
182
|
+
self._zaxis = None
|
|
183
|
+
|
|
184
|
+
@property
|
|
185
|
+
def normal(self):
|
|
186
|
+
return self.zaxis
|
|
187
|
+
|
|
188
|
+
@property
|
|
189
|
+
def zaxis(self):
|
|
190
|
+
if not self._zaxis:
|
|
191
|
+
self._zaxis = self.xaxis.cross(self.yaxis)
|
|
192
|
+
return self._zaxis
|
|
193
|
+
|
|
194
|
+
def axes(self):
|
|
195
|
+
return [self.xaxis, self.yaxis, self.zaxis]
|
|
196
|
+
|
|
197
|
+
@property
|
|
198
|
+
def quaternion(self):
|
|
199
|
+
R = matrix_from_basis_vectors(self.xaxis, self.yaxis)
|
|
200
|
+
return Quaternion(*quaternion_from_matrix(R))
|
|
201
|
+
|
|
202
|
+
@property
|
|
203
|
+
def axis_angle_vector(self):
|
|
204
|
+
R = matrix_from_basis_vectors(self.xaxis, self.yaxis)
|
|
205
|
+
return Vector(*axis_angle_vector_from_matrix(R))
|
|
206
|
+
|
|
207
|
+
# ==========================================================================
|
|
208
|
+
# Constructors
|
|
209
|
+
# ==========================================================================
|
|
210
|
+
|
|
211
|
+
@classmethod
|
|
212
|
+
def worldXY(cls): # type: () -> Frame
|
|
213
|
+
"""Construct the world XY frame.
|
|
214
|
+
|
|
215
|
+
Returns
|
|
216
|
+
-------
|
|
217
|
+
:class:`compas.geometry.Frame`
|
|
218
|
+
The world XY frame.
|
|
219
|
+
|
|
220
|
+
Examples
|
|
221
|
+
--------
|
|
222
|
+
>>> frame = Frame.worldXY()
|
|
223
|
+
>>> frame.point
|
|
224
|
+
Point(0.000, 0.000, 0.000)
|
|
225
|
+
>>> frame.xaxis
|
|
226
|
+
Vector(1.000, 0.000, 0.000)
|
|
227
|
+
>>> frame.yaxis
|
|
228
|
+
Vector(0.000, 1.000, 0.000)
|
|
229
|
+
|
|
230
|
+
"""
|
|
231
|
+
return cls([0, 0, 0], [1, 0, 0], [0, 1, 0])
|
|
232
|
+
|
|
233
|
+
@classmethod
|
|
234
|
+
def worldZX(cls): # type: () -> Frame
|
|
235
|
+
"""Construct the world ZX frame.
|
|
236
|
+
|
|
237
|
+
Returns
|
|
238
|
+
-------
|
|
239
|
+
:class:`compas.geometry.Frame`
|
|
240
|
+
The world ZX frame.
|
|
241
|
+
|
|
242
|
+
Examples
|
|
243
|
+
--------
|
|
244
|
+
>>> frame = Frame.worldZX()
|
|
245
|
+
>>> frame.point
|
|
246
|
+
Point(0.000, 0.000, 0.000)
|
|
247
|
+
>>> frame.xaxis
|
|
248
|
+
Vector(0.000, 0.000, 1.000)
|
|
249
|
+
>>> frame.yaxis
|
|
250
|
+
Vector(1.000, 0.000, 0.000)
|
|
251
|
+
|
|
252
|
+
"""
|
|
253
|
+
return cls([0, 0, 0], [0, 0, 1], [1, 0, 0])
|
|
254
|
+
|
|
255
|
+
@classmethod
|
|
256
|
+
def worldYZ(cls): # type: () -> Frame
|
|
257
|
+
"""Construct the world YZ frame.
|
|
258
|
+
|
|
259
|
+
Returns
|
|
260
|
+
-------
|
|
261
|
+
:class:`compas.geometry.Frame`
|
|
262
|
+
The world YZ frame.
|
|
263
|
+
|
|
264
|
+
Examples
|
|
265
|
+
--------
|
|
266
|
+
>>> frame = Frame.worldYZ()
|
|
267
|
+
>>> frame.point
|
|
268
|
+
Point(0.000, 0.000, 0.000)
|
|
269
|
+
>>> frame.xaxis
|
|
270
|
+
Vector(0.000, 1.000, 0.000)
|
|
271
|
+
>>> frame.yaxis
|
|
272
|
+
Vector(0.000, 0.000, 1.000)
|
|
273
|
+
|
|
274
|
+
"""
|
|
275
|
+
return cls([0, 0, 0], [0, 1, 0], [0, 0, 1])
|
|
276
|
+
|
|
277
|
+
@classmethod
|
|
278
|
+
def from_points(cls, point, point_xaxis, point_xyplane): # type: (...) -> Frame
|
|
279
|
+
"""Constructs a frame from 3 points.
|
|
280
|
+
|
|
281
|
+
Parameters
|
|
282
|
+
----------
|
|
283
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
284
|
+
The origin of the frame.
|
|
285
|
+
point_xaxis : [float, float, float] | :class:`compas.geometry.Point`
|
|
286
|
+
A point on the x-axis of the frame.
|
|
287
|
+
point_xyplane : [float, float, float] | :class:`compas.geometry.Point`
|
|
288
|
+
A point within the xy-plane of the frame.
|
|
289
|
+
|
|
290
|
+
Returns
|
|
291
|
+
-------
|
|
292
|
+
:class:`compas.geometry.Frame`
|
|
293
|
+
The constructed frame.
|
|
294
|
+
|
|
295
|
+
Examples
|
|
296
|
+
--------
|
|
297
|
+
>>> frame = Frame.from_points([0, 0, 0], [1, 0, 0], [0, 1, 0])
|
|
298
|
+
>>> frame.point
|
|
299
|
+
Point(0.000, 0.000, 0.000)
|
|
300
|
+
>>> frame.xaxis
|
|
301
|
+
Vector(1.000, 0.000, 0.000)
|
|
302
|
+
>>> frame.yaxis
|
|
303
|
+
Vector(0.000, 1.000, 0.000)
|
|
304
|
+
|
|
305
|
+
"""
|
|
306
|
+
xaxis = subtract_vectors(point_xaxis, point)
|
|
307
|
+
xyvec = subtract_vectors(point_xyplane, point)
|
|
308
|
+
yaxis = cross_vectors(cross_vectors(xaxis, xyvec), xaxis)
|
|
309
|
+
return cls(point, xaxis, yaxis)
|
|
310
|
+
|
|
311
|
+
@classmethod
|
|
312
|
+
def from_rotation(cls, rotation, point=[0, 0, 0]): # type: (...) -> Frame
|
|
313
|
+
"""Constructs a frame from a Rotation.
|
|
314
|
+
|
|
315
|
+
Parameters
|
|
316
|
+
----------
|
|
317
|
+
rotation : :class:`compas.geometry.Rotation`
|
|
318
|
+
The rotation defines the orientation of the frame.
|
|
319
|
+
point : [float, float, float] | :class:`compas.geometry.Point`, optional
|
|
320
|
+
The origin of the frame.
|
|
321
|
+
|
|
322
|
+
Returns
|
|
323
|
+
-------
|
|
324
|
+
:class:`compas.geometry.Frame`
|
|
325
|
+
The constructed frame.
|
|
326
|
+
|
|
327
|
+
Examples
|
|
328
|
+
--------
|
|
329
|
+
>>> from compas.geometry import Rotation
|
|
330
|
+
>>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
331
|
+
>>> R = Rotation.from_frame(f1)
|
|
332
|
+
>>> f2 = Frame.from_rotation(R, point=f1.point)
|
|
333
|
+
>>> f1 == f2
|
|
334
|
+
True
|
|
335
|
+
|
|
336
|
+
"""
|
|
337
|
+
xaxis, yaxis = rotation.basis_vectors
|
|
338
|
+
return cls(point, xaxis, yaxis)
|
|
339
|
+
|
|
340
|
+
@classmethod
|
|
341
|
+
def from_transformation(cls, transformation): # type: (...) -> Frame
|
|
342
|
+
"""Constructs a frame from a Transformation.
|
|
343
|
+
|
|
344
|
+
Parameters
|
|
345
|
+
----------
|
|
346
|
+
transformation : :class:`compas.geometry.Transformation`
|
|
347
|
+
The transformation defines the orientation of the frame through the
|
|
348
|
+
rotation and the origin through the translation.
|
|
349
|
+
|
|
350
|
+
Returns
|
|
351
|
+
-------
|
|
352
|
+
:class:`compas.geometry.Frame`
|
|
353
|
+
The constructed frame.
|
|
354
|
+
|
|
355
|
+
Examples
|
|
356
|
+
--------
|
|
357
|
+
>>> from compas.geometry import Transformation
|
|
358
|
+
>>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
359
|
+
>>> T = Transformation.from_frame(f1)
|
|
360
|
+
>>> f2 = Frame.from_transformation(T)
|
|
361
|
+
>>> f1 == f2
|
|
362
|
+
True
|
|
363
|
+
|
|
364
|
+
"""
|
|
365
|
+
xaxis, yaxis = transformation.basis_vectors
|
|
366
|
+
point = transformation.translation_vector
|
|
367
|
+
return cls(point, xaxis, yaxis)
|
|
368
|
+
|
|
369
|
+
@classmethod
|
|
370
|
+
def from_matrix(cls, matrix): # type: (...) -> Frame
|
|
371
|
+
"""Construct a frame from a matrix.
|
|
372
|
+
|
|
373
|
+
Parameters
|
|
374
|
+
----------
|
|
375
|
+
matrix : list[list[float]]
|
|
376
|
+
The 4x4 transformation matrix in row-major order.
|
|
377
|
+
|
|
378
|
+
Returns
|
|
379
|
+
-------
|
|
380
|
+
:class:`compas.geometry.Frame`
|
|
381
|
+
The constructed frame.
|
|
382
|
+
|
|
383
|
+
Examples
|
|
384
|
+
--------
|
|
385
|
+
>>> from compas.geometry import matrix_from_euler_angles
|
|
386
|
+
>>> ea1 = [0.5, 0.4, 0.8]
|
|
387
|
+
>>> M = matrix_from_euler_angles(ea1)
|
|
388
|
+
>>> f = Frame.from_matrix(M)
|
|
389
|
+
>>> ea2 = f.euler_angles()
|
|
390
|
+
>>> allclose(ea1, ea2)
|
|
391
|
+
True
|
|
392
|
+
|
|
393
|
+
"""
|
|
394
|
+
_, _, angles, point, _ = decompose_matrix(matrix)
|
|
395
|
+
R = matrix_from_euler_angles(angles, static=True, axes="xyz")
|
|
396
|
+
xaxis, yaxis = basis_vectors_from_matrix(R)
|
|
397
|
+
return cls(point, xaxis, yaxis)
|
|
398
|
+
|
|
399
|
+
@classmethod
|
|
400
|
+
def from_list(cls, values): # type: (...) -> Frame
|
|
401
|
+
"""Construct a frame from a list of 12 or 16 float values.
|
|
402
|
+
|
|
403
|
+
Parameters
|
|
404
|
+
----------
|
|
405
|
+
values : list[float]
|
|
406
|
+
The list of 12 or 16 values representing a 4x4 matrix.
|
|
407
|
+
|
|
408
|
+
Returns
|
|
409
|
+
-------
|
|
410
|
+
:class:`compas.geometry.Frame`
|
|
411
|
+
The constructed frame.
|
|
412
|
+
|
|
413
|
+
Raises
|
|
414
|
+
------
|
|
415
|
+
ValueError
|
|
416
|
+
If the length of the list is neither 12 nor 16.
|
|
417
|
+
|
|
418
|
+
Notes
|
|
419
|
+
-----
|
|
420
|
+
Since the transformation matrix follows the row-major order, the
|
|
421
|
+
translational components must be at the list's indices 3, 7, 11.
|
|
422
|
+
|
|
423
|
+
Examples
|
|
424
|
+
--------
|
|
425
|
+
>>> l = [-1.0, 0.0, 0.0, 8110, 0.0, 0.0, -1.0, 7020, 0.0, -1.0, 0.0, 1810]
|
|
426
|
+
>>> f = Frame.from_list(l)
|
|
427
|
+
|
|
428
|
+
"""
|
|
429
|
+
if len(values) == 12:
|
|
430
|
+
values.extend([0.0, 0.0, 0.0, 1.0])
|
|
431
|
+
if len(values) != 16:
|
|
432
|
+
raise ValueError("Expected 12 or 16 floats but got %d" % len(values))
|
|
433
|
+
|
|
434
|
+
matrix = [[0.0 for i in range(4)] for j in range(4)]
|
|
435
|
+
for i in range(4):
|
|
436
|
+
for j in range(4):
|
|
437
|
+
matrix[i][j] = float(values[i * 4 + j])
|
|
438
|
+
|
|
439
|
+
return cls.from_matrix(matrix)
|
|
440
|
+
|
|
441
|
+
@classmethod
|
|
442
|
+
def from_quaternion(cls, quaternion, point=[0, 0, 0]): # type: (...) -> Frame
|
|
443
|
+
"""Construct a frame from a rotation represented by quaternion coefficients.
|
|
444
|
+
|
|
445
|
+
Parameters
|
|
446
|
+
----------
|
|
447
|
+
quaternion : [float, float, float, float] | :class:`compas.geometry.Quaternion`
|
|
448
|
+
Four numbers that represent the four coefficient values of a quaternion.
|
|
449
|
+
point : [float, float, float] | :class:`compas.geometry.Point`, optional
|
|
450
|
+
The point of the frame.
|
|
451
|
+
|
|
452
|
+
Returns
|
|
453
|
+
-------
|
|
454
|
+
:class:`compas.geometry.Frame`
|
|
455
|
+
The constructed frame.
|
|
456
|
+
|
|
457
|
+
Examples
|
|
458
|
+
--------
|
|
459
|
+
>>> q1 = [0.945, -0.021, -0.125, 0.303]
|
|
460
|
+
>>> f = Frame.from_quaternion(q1, point=[1.0, 1.0, 1.0])
|
|
461
|
+
>>> q2 = f.quaternion
|
|
462
|
+
>>> allclose(q1, q2)
|
|
463
|
+
True
|
|
464
|
+
|
|
465
|
+
"""
|
|
466
|
+
R = matrix_from_quaternion(quaternion)
|
|
467
|
+
xaxis, yaxis = basis_vectors_from_matrix(R)
|
|
468
|
+
return cls(point, xaxis, yaxis)
|
|
469
|
+
|
|
470
|
+
@classmethod
|
|
471
|
+
def from_axis_angle_vector(cls, axis_angle_vector, point=[0, 0, 0]): # type: (...) -> Frame
|
|
472
|
+
"""Construct a frame from an axis-angle vector representing the rotation.
|
|
473
|
+
|
|
474
|
+
Parameters
|
|
475
|
+
----------
|
|
476
|
+
axis_angle_vector : [float, float, float]
|
|
477
|
+
Three numbers that represent the axis of rotation and angle of
|
|
478
|
+
rotation by its magnitude.
|
|
479
|
+
point : [float, float, float] | :class:`compas.geometry.Point`, optional
|
|
480
|
+
The point of the frame.
|
|
481
|
+
|
|
482
|
+
Returns
|
|
483
|
+
-------
|
|
484
|
+
:class:`compas.geometry.Frame`
|
|
485
|
+
The constructed frame.
|
|
486
|
+
|
|
487
|
+
Examples
|
|
488
|
+
--------
|
|
489
|
+
>>> aav1 = [-0.043, -0.254, 0.617]
|
|
490
|
+
>>> f = Frame.from_axis_angle_vector(aav1, point=[0, 0, 0])
|
|
491
|
+
>>> aav2 = f.axis_angle_vector
|
|
492
|
+
>>> allclose(aav1, aav2)
|
|
493
|
+
True
|
|
494
|
+
|
|
495
|
+
"""
|
|
496
|
+
R = matrix_from_axis_angle_vector(axis_angle_vector)
|
|
497
|
+
xaxis, yaxis = basis_vectors_from_matrix(R)
|
|
498
|
+
return cls(point, xaxis, yaxis)
|
|
499
|
+
|
|
500
|
+
@classmethod
|
|
501
|
+
def from_euler_angles(cls, euler_angles, static=True, axes="xyz", point=[0, 0, 0]): # type: (...) -> Frame
|
|
502
|
+
"""Construct a frame from a rotation represented by Euler angles.
|
|
503
|
+
|
|
504
|
+
Parameters
|
|
505
|
+
----------
|
|
506
|
+
euler_angles : [float, float, float]
|
|
507
|
+
Three numbers that represent the angles of rotations about the defined axes.
|
|
508
|
+
static : bool, optional
|
|
509
|
+
If True, the rotations are applied to a static frame.
|
|
510
|
+
If False, to a rotational.
|
|
511
|
+
axes : str, optional
|
|
512
|
+
A 3 character string specifying the order of the axes.
|
|
513
|
+
point : [float, float, float] | :class:`compas.geometry.Point`, optional
|
|
514
|
+
The point of the frame.
|
|
515
|
+
|
|
516
|
+
Returns
|
|
517
|
+
-------
|
|
518
|
+
:class:`compas.geometry.Frame`
|
|
519
|
+
The constructed frame.
|
|
520
|
+
|
|
521
|
+
Examples
|
|
522
|
+
--------
|
|
523
|
+
>>> ea1 = 1.4, 0.5, 2.3
|
|
524
|
+
>>> f = Frame.from_euler_angles(ea1, static=True, axes="xyz")
|
|
525
|
+
>>> ea2 = f.euler_angles(static=True, axes="xyz")
|
|
526
|
+
>>> allclose(ea1, ea2)
|
|
527
|
+
True
|
|
528
|
+
|
|
529
|
+
"""
|
|
530
|
+
R = matrix_from_euler_angles(euler_angles, static, axes)
|
|
531
|
+
xaxis, yaxis = basis_vectors_from_matrix(R)
|
|
532
|
+
return cls(point, xaxis, yaxis)
|
|
533
|
+
|
|
534
|
+
@classmethod
|
|
535
|
+
def from_plane(cls, plane): # type: (...) -> Frame
|
|
536
|
+
"""Constructs a frame from a plane.
|
|
537
|
+
|
|
538
|
+
Xaxis and yaxis are arbitrarily selected based on the plane's normal.
|
|
539
|
+
|
|
540
|
+
Parameters
|
|
541
|
+
----------
|
|
542
|
+
plane : [point, vector] | :class:`compas.geometry.Plane`
|
|
543
|
+
A plane.
|
|
544
|
+
|
|
545
|
+
Returns
|
|
546
|
+
-------
|
|
547
|
+
:class:`compas.geometry.Frame`
|
|
548
|
+
The constructed frame.
|
|
549
|
+
|
|
550
|
+
Examples
|
|
551
|
+
--------
|
|
552
|
+
>>> from compas.geometry import Plane
|
|
553
|
+
>>> plane = Plane([0, 0, 0], [0, 0, 1])
|
|
554
|
+
>>> frame = Frame.from_plane(plane)
|
|
555
|
+
>>> allclose(frame.normal, plane.normal)
|
|
556
|
+
True
|
|
557
|
+
|
|
558
|
+
"""
|
|
559
|
+
point, normal = plane
|
|
560
|
+
# To construct a frame we need to find a vector v that is perpendicular
|
|
561
|
+
# to the plane's normal. This means that the dot-product of v with the
|
|
562
|
+
# normal must be equal to 0, which is true for the following vectors:
|
|
563
|
+
vectors = [
|
|
564
|
+
Vector(-normal[1], normal[0], 0),
|
|
565
|
+
Vector(0, -normal[2], normal[1]),
|
|
566
|
+
Vector(normal[2], 0, -normal[0]),
|
|
567
|
+
]
|
|
568
|
+
# But if we are unlucky, one of these vectors is (0, 0, 0), so we
|
|
569
|
+
# choose the vector with the longest length as xaxis.
|
|
570
|
+
idx = argmax([v.length for v in vectors])
|
|
571
|
+
xaxis = vectors[idx]
|
|
572
|
+
yaxis = cross_vectors(normal, xaxis)
|
|
573
|
+
return cls(point, xaxis, yaxis)
|
|
574
|
+
|
|
575
|
+
# ==========================================================================
|
|
576
|
+
# Conversions
|
|
577
|
+
# ==========================================================================
|
|
578
|
+
|
|
579
|
+
def to_transformation(self):
|
|
580
|
+
"""Convert the frame to a transformation.
|
|
581
|
+
|
|
582
|
+
Returns
|
|
583
|
+
-------
|
|
584
|
+
:class:`compas.geometry.Transformation`
|
|
585
|
+
The transformation.
|
|
586
|
+
|
|
587
|
+
"""
|
|
588
|
+
return Transformation.from_frame(self)
|
|
589
|
+
|
|
590
|
+
# ==========================================================================
|
|
591
|
+
# Methods
|
|
592
|
+
# ==========================================================================
|
|
593
|
+
|
|
594
|
+
def interpolate_frame(self, other, t):
|
|
595
|
+
"""Interpolates between two frames at a given parameter t in the range [0, 1]
|
|
596
|
+
|
|
597
|
+
Parameters
|
|
598
|
+
----------
|
|
599
|
+
other : :class:`compas.geometry.Frame`
|
|
600
|
+
t : float
|
|
601
|
+
A parameter in the range [0-1].
|
|
602
|
+
|
|
603
|
+
Returns
|
|
604
|
+
-------
|
|
605
|
+
:class:`compas.geometry.Frame`
|
|
606
|
+
A list of the interpolated :class:`compas.geometry.Frame` instances.
|
|
607
|
+
|
|
608
|
+
Examples
|
|
609
|
+
--------
|
|
610
|
+
>>> frame1 = Frame(Point(0, 0, 0), Vector(1, 0, 0), Vector(0, 1, 0))
|
|
611
|
+
>>> frame2 = Frame(Point(1, 1, 1), Vector(0, 0, 1), Vector(0, 1, 0))
|
|
612
|
+
>>> start_frame = frame1.interpolate_frame(frame2, 0)
|
|
613
|
+
>>> allclose(start_frame.point, frame1.point) and allclose(start_frame.quaternion, frame1.quaternion)
|
|
614
|
+
True
|
|
615
|
+
"""
|
|
616
|
+
quat1 = Quaternion.from_frame(self)
|
|
617
|
+
quat2 = Quaternion.from_frame(other)
|
|
618
|
+
|
|
619
|
+
# Interpolate origin
|
|
620
|
+
origin_interpolated = (self.point * (1.0 - t)) + other.point * t
|
|
621
|
+
|
|
622
|
+
rot_interpolated = quat1.slerp(quat2, t)
|
|
623
|
+
|
|
624
|
+
# Create a new frame with the interpolated position and orientation
|
|
625
|
+
interpolated_frame = Frame.from_quaternion(rot_interpolated, point=origin_interpolated)
|
|
626
|
+
|
|
627
|
+
return interpolated_frame
|
|
628
|
+
|
|
629
|
+
def interpolate_frames(self, other, steps):
|
|
630
|
+
"""Generates a specified number of interpolated frames between two given frames
|
|
631
|
+
|
|
632
|
+
Parameters
|
|
633
|
+
----------
|
|
634
|
+
other : :class:`compas.geometry.Frame`
|
|
635
|
+
steps : int
|
|
636
|
+
The number of interpolated frames to return.
|
|
637
|
+
|
|
638
|
+
Returns
|
|
639
|
+
-------
|
|
640
|
+
list of :class:`compas.geometry.Frame`
|
|
641
|
+
|
|
642
|
+
Examples
|
|
643
|
+
--------
|
|
644
|
+
>>> frame1 = Frame(Point(0, 0, 0), Vector(1, 0, 0), Vector(0, 1, 0))
|
|
645
|
+
>>> frame2 = Frame(Point(1, 1, 1), Vector(0, 0, 1), Vector(0, 1, 0))
|
|
646
|
+
>>> steps = 5
|
|
647
|
+
>>> frames = frame1.interpolate_frames(frame2, steps)
|
|
648
|
+
>>> assert len(frames) == steps
|
|
649
|
+
True
|
|
650
|
+
"""
|
|
651
|
+
return [self.interpolate_frame(other, t) for t in linspace(0, 1, steps)]
|
|
652
|
+
|
|
653
|
+
def euler_angles(self, static=True, axes="xyz"):
|
|
654
|
+
"""The Euler angles from the rotation given by the frame.
|
|
655
|
+
|
|
656
|
+
Parameters
|
|
657
|
+
----------
|
|
658
|
+
static : bool, optional
|
|
659
|
+
If True the rotations are applied to a static frame.
|
|
660
|
+
If False, to a rotational.
|
|
661
|
+
axes : str, optional
|
|
662
|
+
A 3 character string specifying the order of the axes.
|
|
663
|
+
|
|
664
|
+
Returns
|
|
665
|
+
-------
|
|
666
|
+
list[float]
|
|
667
|
+
Three numbers that represent the angles of rotations about the defined axes.
|
|
668
|
+
|
|
669
|
+
Examples
|
|
670
|
+
--------
|
|
671
|
+
>>> ea1 = 1.4, 0.5, 2.3
|
|
672
|
+
>>> f = Frame.from_euler_angles(ea1, static=True, axes="xyz")
|
|
673
|
+
>>> ea2 = f.euler_angles(static=True, axes="xyz")
|
|
674
|
+
>>> allclose(ea1, ea2)
|
|
675
|
+
True
|
|
676
|
+
|
|
677
|
+
"""
|
|
678
|
+
R = matrix_from_basis_vectors(self.xaxis, self.yaxis)
|
|
679
|
+
return euler_angles_from_matrix(R, static, axes)
|
|
680
|
+
|
|
681
|
+
def to_local_coordinates(self, obj_in_wcf):
|
|
682
|
+
"""Returns the object's coordinates in the local coordinate system of the frame.
|
|
683
|
+
|
|
684
|
+
Parameters
|
|
685
|
+
----------
|
|
686
|
+
obj_in_wcf : [float, float, float] | :class:`compas.geometry.Geometry`
|
|
687
|
+
An object in the world coordinate frame.
|
|
688
|
+
|
|
689
|
+
Returns
|
|
690
|
+
-------
|
|
691
|
+
:class:`compas.geometry.Geometry`
|
|
692
|
+
The object in the local coordinate system of the frame.
|
|
693
|
+
|
|
694
|
+
Notes
|
|
695
|
+
-----
|
|
696
|
+
If you pass a list of floats, it is assumed to represent a point.
|
|
697
|
+
|
|
698
|
+
Examples
|
|
699
|
+
--------
|
|
700
|
+
>>> from compas.geometry import Point
|
|
701
|
+
>>> frame = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
702
|
+
>>> pw = Point(2, 2, 2) # point in wcf
|
|
703
|
+
>>> pl = frame.to_local_coordinates(pw) # point in frame
|
|
704
|
+
>>> frame.to_world_coordinates(pl)
|
|
705
|
+
Point(2.000, 2.000, 2.000)
|
|
706
|
+
|
|
707
|
+
"""
|
|
708
|
+
T = Transformation.from_change_of_basis(Frame.worldXY(), self)
|
|
709
|
+
if isinstance(obj_in_wcf, (list, tuple)):
|
|
710
|
+
return Point(*obj_in_wcf).transformed(T)
|
|
711
|
+
return obj_in_wcf.transformed(T)
|
|
712
|
+
|
|
713
|
+
def to_world_coordinates(self, obj_in_lcf):
|
|
714
|
+
"""Returns the object's coordinates in the global coordinate frame.
|
|
715
|
+
|
|
716
|
+
Parameters
|
|
717
|
+
----------
|
|
718
|
+
obj_in_lcf : [float, float, float] | :class:`compas.geometry.Geometry`
|
|
719
|
+
An object in local coordinate system of the frame.
|
|
720
|
+
|
|
721
|
+
Returns
|
|
722
|
+
-------
|
|
723
|
+
:class:`compas.geometry.Geometry`
|
|
724
|
+
The object in the world coordinate frame.
|
|
725
|
+
|
|
726
|
+
Notes
|
|
727
|
+
-----
|
|
728
|
+
If you pass a list of floats, it is assumed to represent a point.
|
|
729
|
+
|
|
730
|
+
Examples
|
|
731
|
+
--------
|
|
732
|
+
>>> from compas.geometry import Point
|
|
733
|
+
>>> frame = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
734
|
+
>>> pl = Point(1.632, -0.090, 0.573) # point in frame
|
|
735
|
+
>>> pw = frame.to_world_coordinates(pl) # point in wcf
|
|
736
|
+
>>> frame.to_local_coordinates(pw)
|
|
737
|
+
Point(1.632, -0.090, 0.573)
|
|
738
|
+
|
|
739
|
+
"""
|
|
740
|
+
T = Transformation.from_change_of_basis(self, Frame.worldXY())
|
|
741
|
+
if isinstance(obj_in_lcf, list):
|
|
742
|
+
return Point(*obj_in_lcf).transformed(T)
|
|
743
|
+
return obj_in_lcf.transformed(T)
|
|
744
|
+
|
|
745
|
+
def transform(self, T):
|
|
746
|
+
"""Transform the frame.
|
|
747
|
+
|
|
748
|
+
Parameters
|
|
749
|
+
----------
|
|
750
|
+
T : :class:`compas.geometry.Transformation`
|
|
751
|
+
The transformation.
|
|
752
|
+
|
|
753
|
+
Examples
|
|
754
|
+
--------
|
|
755
|
+
>>> from compas.geometry import Transformation
|
|
756
|
+
>>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
757
|
+
>>> T = Transformation.from_frame(f1)
|
|
758
|
+
>>> f2 = Frame.worldXY()
|
|
759
|
+
>>> f2.transform(T)
|
|
760
|
+
>>> f1 == f2
|
|
761
|
+
True
|
|
762
|
+
|
|
763
|
+
"""
|
|
764
|
+
X = T * Transformation.from_frame(self)
|
|
765
|
+
point = X.translation_vector
|
|
766
|
+
xaxis, yaxis = X.basis_vectors
|
|
767
|
+
self.point = point
|
|
768
|
+
self.xaxis = xaxis
|
|
769
|
+
self.yaxis = yaxis
|