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,554 @@
|
|
|
1
|
+
"""
|
|
2
|
+
This library for transformations partly derived and was re-implemented from the
|
|
3
|
+
following online resources:
|
|
4
|
+
|
|
5
|
+
* http://www.lfd.uci.edu/~gohlke/code/transformations.py.html
|
|
6
|
+
* http://www.euclideanspace.com/maths/geometry/rotations/
|
|
7
|
+
* http://code.activestate.com/recipes/578108-determinant-of-matrix-of-any-order/
|
|
8
|
+
* http://blog.acipo.com/matrix-inversion-in-javascript/
|
|
9
|
+
|
|
10
|
+
Many thanks to Christoph Gohlke, Martin John Baker, Sachin Joglekar and Andrew
|
|
11
|
+
Ippoliti for providing code and documentation.
|
|
12
|
+
"""
|
|
13
|
+
|
|
14
|
+
from compas.data import Data
|
|
15
|
+
from compas.geometry import basis_vectors_from_matrix
|
|
16
|
+
from compas.geometry import decompose_matrix
|
|
17
|
+
from compas.geometry import identity_matrix
|
|
18
|
+
from compas.geometry import matrix_determinant
|
|
19
|
+
from compas.geometry import matrix_from_euler_angles
|
|
20
|
+
from compas.geometry import matrix_from_frame
|
|
21
|
+
from compas.geometry import matrix_from_translation
|
|
22
|
+
from compas.geometry import matrix_inverse
|
|
23
|
+
from compas.geometry import multiply_matrices
|
|
24
|
+
from compas.geometry import translation_from_matrix
|
|
25
|
+
from compas.geometry import transpose_matrix
|
|
26
|
+
from compas.tolerance import TOL
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
class Transformation(Data):
|
|
30
|
+
"""Class representing a general 4x4 transformation matrix.
|
|
31
|
+
|
|
32
|
+
It is the base class for transformations like :class:`Rotation`,
|
|
33
|
+
:class:`Translation`, :class:`Scale`, :class:`Reflection`,
|
|
34
|
+
:class:`Projection` and :class:`Shear`.
|
|
35
|
+
|
|
36
|
+
The class allows to concatenate Transformations by multiplication, to
|
|
37
|
+
calculate the inverse transformation and to decompose a transformation into
|
|
38
|
+
its components of rotation, translation, scale, shear, and perspective.
|
|
39
|
+
The matrix follows the row-major order, such that translation components
|
|
40
|
+
x, y, z are in the right column of the matrix, i.e. ``M[0][3], M[1][3],
|
|
41
|
+
M[2][3] = x, y, z``.
|
|
42
|
+
|
|
43
|
+
Parameters
|
|
44
|
+
----------
|
|
45
|
+
matrix : list[list[float]], optional
|
|
46
|
+
The 4x4 transformation matrix.
|
|
47
|
+
name : str, optional
|
|
48
|
+
The name of the transformation.
|
|
49
|
+
|
|
50
|
+
Attributes
|
|
51
|
+
----------
|
|
52
|
+
scale : :class:`compas.geometry.Scale`, read-only
|
|
53
|
+
The scale component of the transformation matrix.
|
|
54
|
+
shear : :class:`compas.geometry.Shear`, read-only
|
|
55
|
+
The shear component of the transformation matrix.
|
|
56
|
+
rotation : :class:`compas.geometry.Rotation`, read-only
|
|
57
|
+
The rotation component of the transformation matrix.
|
|
58
|
+
translation : :class:`compas.geometry.Translation`, read-only
|
|
59
|
+
The translation component of the transformation matrix.
|
|
60
|
+
projection : :class:`compas.geometry.Projection`, read-only
|
|
61
|
+
The projection component of the transformation matrix.
|
|
62
|
+
translation_vector : :class:`compas.geometry.Vector`, read-only
|
|
63
|
+
The translation component of the transformation matrix as a translation vector.
|
|
64
|
+
basis_vectors : tuple[:class:`compas.geometry.Vector`, :class:`compas.geometry.Vector`], read-only
|
|
65
|
+
The basis vectors from the rotation component of the transformation matrix.
|
|
66
|
+
list : list[float], read-only
|
|
67
|
+
Flattens the 4x4 transformation matrix into a list of 16 numbers.
|
|
68
|
+
determinant : float, read-only
|
|
69
|
+
The determinant of the matrix of the transformation.
|
|
70
|
+
|
|
71
|
+
Examples
|
|
72
|
+
--------
|
|
73
|
+
>>> from compas.geometry import Frame
|
|
74
|
+
>>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
75
|
+
>>> T = Transformation.from_frame(f1)
|
|
76
|
+
>>> Sc, Sh, R, Tl, P = T.decomposed()
|
|
77
|
+
>>> Tinv = T.inverse()
|
|
78
|
+
|
|
79
|
+
"""
|
|
80
|
+
|
|
81
|
+
DATASCHEMA = {
|
|
82
|
+
"type": "object",
|
|
83
|
+
"properties": {
|
|
84
|
+
"matrix": {
|
|
85
|
+
"type": "array",
|
|
86
|
+
"items": {
|
|
87
|
+
"type": "array",
|
|
88
|
+
"items": {"type": "number"},
|
|
89
|
+
"minItems": 4,
|
|
90
|
+
"maxItems": 4,
|
|
91
|
+
},
|
|
92
|
+
"minItems": 4,
|
|
93
|
+
"maxItems": 4,
|
|
94
|
+
},
|
|
95
|
+
},
|
|
96
|
+
"required": ["matrix"],
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
@property
|
|
100
|
+
def __data__(self):
|
|
101
|
+
return {"matrix": self.matrix}
|
|
102
|
+
|
|
103
|
+
def __init__(self, matrix=None, name=None):
|
|
104
|
+
super(Transformation, self).__init__(name=name)
|
|
105
|
+
if not matrix:
|
|
106
|
+
matrix = identity_matrix(4)
|
|
107
|
+
self.matrix = matrix
|
|
108
|
+
|
|
109
|
+
def __mul__(self, other):
|
|
110
|
+
return self.concatenated(other)
|
|
111
|
+
|
|
112
|
+
def __imul__(self, other):
|
|
113
|
+
return self.concatenated(other)
|
|
114
|
+
|
|
115
|
+
def __getitem__(self, key):
|
|
116
|
+
i, j = key
|
|
117
|
+
return self.matrix[i][j]
|
|
118
|
+
|
|
119
|
+
def __setitem__(self, key, value):
|
|
120
|
+
i, j = key
|
|
121
|
+
self.matrix[i][j] = value
|
|
122
|
+
|
|
123
|
+
def __iter__(self):
|
|
124
|
+
return iter(self.matrix)
|
|
125
|
+
|
|
126
|
+
def __eq__(self, other, tol=None):
|
|
127
|
+
try:
|
|
128
|
+
A = self.matrix
|
|
129
|
+
B = other.matrix
|
|
130
|
+
return TOL.is_allclose(A, B, rtol=0, atol=tol)
|
|
131
|
+
except BaseException:
|
|
132
|
+
return False
|
|
133
|
+
|
|
134
|
+
def __ne__(self, other):
|
|
135
|
+
# this is not obvious to ironpython
|
|
136
|
+
return not self.__eq__(other)
|
|
137
|
+
|
|
138
|
+
def __repr__(self):
|
|
139
|
+
return "{0}({1!r}, check=False)".format(self.__class__.__name__, self.matrix)
|
|
140
|
+
|
|
141
|
+
def __str__(self):
|
|
142
|
+
s = "[[%s],\n" % ",".join([("%.4f" % n).rjust(10) for n in self.matrix[0]])
|
|
143
|
+
s += " [%s],\n" % ",".join([("%.4f" % n).rjust(10) for n in self.matrix[1]])
|
|
144
|
+
s += " [%s],\n" % ",".join([("%.4f" % n).rjust(10) for n in self.matrix[2]])
|
|
145
|
+
s += " [%s]]\n" % ",".join([("%.4f" % n).rjust(10) for n in self.matrix[3]])
|
|
146
|
+
return s
|
|
147
|
+
|
|
148
|
+
def __len__(self):
|
|
149
|
+
return len(self.matrix)
|
|
150
|
+
|
|
151
|
+
# ==========================================================================
|
|
152
|
+
# Properties
|
|
153
|
+
# ==========================================================================
|
|
154
|
+
|
|
155
|
+
@property
|
|
156
|
+
def scale(self):
|
|
157
|
+
S, H, R, T, P = self.decomposed()
|
|
158
|
+
return S
|
|
159
|
+
|
|
160
|
+
@property
|
|
161
|
+
def shear(self):
|
|
162
|
+
S, H, R, T, P = self.decomposed()
|
|
163
|
+
return H
|
|
164
|
+
|
|
165
|
+
@property
|
|
166
|
+
def rotation(self):
|
|
167
|
+
S, H, R, T, P = self.decomposed()
|
|
168
|
+
return R
|
|
169
|
+
|
|
170
|
+
@property
|
|
171
|
+
def translation(self):
|
|
172
|
+
S, H, R, T, P = self.decomposed()
|
|
173
|
+
return T
|
|
174
|
+
|
|
175
|
+
@property
|
|
176
|
+
def projection(self):
|
|
177
|
+
S, H, R, T, P = self.decomposed()
|
|
178
|
+
return P
|
|
179
|
+
|
|
180
|
+
@property
|
|
181
|
+
def translation_vector(self):
|
|
182
|
+
from compas.geometry import Vector
|
|
183
|
+
|
|
184
|
+
vector = translation_from_matrix(self.matrix)
|
|
185
|
+
return Vector(*vector)
|
|
186
|
+
|
|
187
|
+
@property
|
|
188
|
+
def basis_vectors(self):
|
|
189
|
+
from compas.geometry import Vector
|
|
190
|
+
|
|
191
|
+
x, y = basis_vectors_from_matrix(self.rotation.matrix)
|
|
192
|
+
return Vector(*x), Vector(*y)
|
|
193
|
+
|
|
194
|
+
@property
|
|
195
|
+
def list(self):
|
|
196
|
+
return [a for c in self.matrix for a in c]
|
|
197
|
+
|
|
198
|
+
@property
|
|
199
|
+
def determinant(self):
|
|
200
|
+
return matrix_determinant(self.matrix)
|
|
201
|
+
|
|
202
|
+
# ==========================================================================
|
|
203
|
+
# Constructors
|
|
204
|
+
# ==========================================================================
|
|
205
|
+
|
|
206
|
+
@classmethod
|
|
207
|
+
def from_matrix(cls, matrix):
|
|
208
|
+
"""Creates a transformation from a list[list[float]] object.
|
|
209
|
+
|
|
210
|
+
Parameters
|
|
211
|
+
----------
|
|
212
|
+
matrix : list[list[float]]
|
|
213
|
+
The 4x4 transformation matrix.
|
|
214
|
+
|
|
215
|
+
Returns
|
|
216
|
+
-------
|
|
217
|
+
:class:`compas.geometry.Transformation`
|
|
218
|
+
The transformation.
|
|
219
|
+
|
|
220
|
+
"""
|
|
221
|
+
return cls(matrix)
|
|
222
|
+
|
|
223
|
+
@classmethod
|
|
224
|
+
def from_list(cls, numbers):
|
|
225
|
+
"""Creates a transformation from a list of 16 numbers.
|
|
226
|
+
|
|
227
|
+
Parameters
|
|
228
|
+
----------
|
|
229
|
+
numbers : list[float]
|
|
230
|
+
A list of 16 numbers
|
|
231
|
+
|
|
232
|
+
Returns
|
|
233
|
+
-------
|
|
234
|
+
:class:`compas.geometry.Transformation`
|
|
235
|
+
The transformation.
|
|
236
|
+
|
|
237
|
+
Notes
|
|
238
|
+
-----
|
|
239
|
+
Since the transformation matrix follows the row-major order, the
|
|
240
|
+
translational components must be at the list's indices 3, 7, 11.
|
|
241
|
+
|
|
242
|
+
Examples
|
|
243
|
+
--------
|
|
244
|
+
>>> numbers = [1, 0, 0, 3, 0, 1, 0, 4, 0, 0, 1, 5, 0, 0, 0, 1]
|
|
245
|
+
>>> T = Transformation.from_list(numbers)
|
|
246
|
+
|
|
247
|
+
"""
|
|
248
|
+
matrix = identity_matrix(4)
|
|
249
|
+
for i in range(4):
|
|
250
|
+
for j in range(4):
|
|
251
|
+
matrix[i][j] = float(numbers[i * 4 + j])
|
|
252
|
+
return cls(matrix)
|
|
253
|
+
|
|
254
|
+
@classmethod
|
|
255
|
+
def from_euler_angles(cls, euler_angles, static=True, axes="xyz", point=[0, 0, 0]):
|
|
256
|
+
"""Construct a transformation from a rotation represented by Euler angles.
|
|
257
|
+
|
|
258
|
+
Parameters
|
|
259
|
+
----------
|
|
260
|
+
euler_angles : [float, float, float]
|
|
261
|
+
Three numbers that represent the angles of rotations about the defined axes.
|
|
262
|
+
static : bool, optional
|
|
263
|
+
If True the rotations are applied to a static frame.
|
|
264
|
+
If False, to a rotational.
|
|
265
|
+
axes : str, optional
|
|
266
|
+
A 3 character string specifying the order of the axes.
|
|
267
|
+
point : list[float], optional
|
|
268
|
+
The point of the frame.
|
|
269
|
+
|
|
270
|
+
Returns
|
|
271
|
+
-------
|
|
272
|
+
:class:`compas.geometry.Transformation`
|
|
273
|
+
The transformation.
|
|
274
|
+
|
|
275
|
+
"""
|
|
276
|
+
R = matrix_from_euler_angles(euler_angles, static, axes)
|
|
277
|
+
T = matrix_from_translation(point)
|
|
278
|
+
M = multiply_matrices(T, R)
|
|
279
|
+
return cls.from_matrix(M)
|
|
280
|
+
|
|
281
|
+
# should not one of the two just have a "to" function
|
|
282
|
+
@classmethod
|
|
283
|
+
def from_frame(cls, frame):
|
|
284
|
+
"""Construct a transformation from world XY to frame.
|
|
285
|
+
|
|
286
|
+
Parameters
|
|
287
|
+
----------
|
|
288
|
+
frame : :class:`compas.geometry.Frame`
|
|
289
|
+
A frame describing the targeted Cartesian coordinate system.
|
|
290
|
+
|
|
291
|
+
Returns
|
|
292
|
+
-------
|
|
293
|
+
:class:`compas.geometry.Transformation`
|
|
294
|
+
The transformation.
|
|
295
|
+
|
|
296
|
+
Notes
|
|
297
|
+
-----
|
|
298
|
+
It is the same as from_frame_to_frame(Frame.worldXY(), frame).
|
|
299
|
+
|
|
300
|
+
Examples
|
|
301
|
+
--------
|
|
302
|
+
>>> from compas.geometry import Frame
|
|
303
|
+
>>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
304
|
+
>>> T = Transformation.from_frame(f1)
|
|
305
|
+
>>> f2 = Frame.from_transformation(T)
|
|
306
|
+
>>> f1 == f2
|
|
307
|
+
True
|
|
308
|
+
|
|
309
|
+
"""
|
|
310
|
+
return cls(matrix_from_frame(frame))
|
|
311
|
+
|
|
312
|
+
@classmethod
|
|
313
|
+
def from_frame_to_frame(cls, frame_from, frame_to):
|
|
314
|
+
"""Construct a transformation between two frames.
|
|
315
|
+
|
|
316
|
+
This transformation allows to transform geometry from one Cartesian
|
|
317
|
+
coordinate system defined by `frame_from` to another Cartesian
|
|
318
|
+
coordinate system defined by `frame_to`.
|
|
319
|
+
|
|
320
|
+
Parameters
|
|
321
|
+
----------
|
|
322
|
+
frame_from : :class:`compas.geometry.Frame`
|
|
323
|
+
A frame defining the original Cartesian coordinate system.
|
|
324
|
+
frame_to : :class:`compas.geometry.Frame`
|
|
325
|
+
A frame defining the targeted Cartesian coordinate system.
|
|
326
|
+
|
|
327
|
+
Returns
|
|
328
|
+
-------
|
|
329
|
+
:class:`compas.geometry.Transformation`
|
|
330
|
+
The transformation.
|
|
331
|
+
|
|
332
|
+
Examples
|
|
333
|
+
--------
|
|
334
|
+
>>> from compas.geometry import Frame
|
|
335
|
+
>>> f1 = Frame([2, 2, 2], [0.12, 0.58, 0.81], [-0.80, 0.53, -0.26])
|
|
336
|
+
>>> f2 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
337
|
+
>>> T = Transformation.from_frame_to_frame(f1, f2)
|
|
338
|
+
>>> f1.transform(T)
|
|
339
|
+
>>> f1 == f2
|
|
340
|
+
True
|
|
341
|
+
|
|
342
|
+
"""
|
|
343
|
+
T1 = cls.from_frame(frame_from)
|
|
344
|
+
T2 = cls.from_frame(frame_to)
|
|
345
|
+
return cls(multiply_matrices(T2.matrix, matrix_inverse(T1.matrix)))
|
|
346
|
+
|
|
347
|
+
@classmethod
|
|
348
|
+
def from_change_of_basis(cls, frame_from, frame_to):
|
|
349
|
+
"""Construct a change of basis transformation between two frames.
|
|
350
|
+
|
|
351
|
+
A basis change is essentially a remapping of geometry from one
|
|
352
|
+
coordinate system to another.
|
|
353
|
+
|
|
354
|
+
Parameters
|
|
355
|
+
----------
|
|
356
|
+
frame_from : :class:`compas.geometry.Frame`
|
|
357
|
+
A frame defining the original Cartesian coordinate system.
|
|
358
|
+
frame_to : :class:`compas.geometry.Frame`
|
|
359
|
+
A frame defining the targeted Cartesian coordinate system.
|
|
360
|
+
|
|
361
|
+
Returns
|
|
362
|
+
-------
|
|
363
|
+
:class:`compas.geometry.Transformation`
|
|
364
|
+
The transformation representing a change of basis.
|
|
365
|
+
|
|
366
|
+
Examples
|
|
367
|
+
--------
|
|
368
|
+
>>> from compas.geometry import Point, Frame
|
|
369
|
+
>>> f1 = Frame([2, 2, 2], [0.12, 0.58, 0.81], [-0.80, 0.53, -0.26])
|
|
370
|
+
>>> f2 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
371
|
+
>>> T = Transformation.from_change_of_basis(f1, f2)
|
|
372
|
+
>>> p_f1 = Point(1, 1, 1) # point in f1
|
|
373
|
+
>>> p_f1.transformed(T) # point represented in f2
|
|
374
|
+
Point(1.395, 0.955, 1.934)
|
|
375
|
+
>>> Frame.local_to_local_coordinates(f1, f2, p_f1)
|
|
376
|
+
Point(1.395, 0.955, 1.934)
|
|
377
|
+
|
|
378
|
+
"""
|
|
379
|
+
T1 = cls.from_frame(frame_from)
|
|
380
|
+
T2 = cls.from_frame(frame_to)
|
|
381
|
+
return cls(multiply_matrices(matrix_inverse(T2.matrix), T1.matrix))
|
|
382
|
+
|
|
383
|
+
# ==========================================================================
|
|
384
|
+
# Methods
|
|
385
|
+
# ==========================================================================
|
|
386
|
+
|
|
387
|
+
def copy(self):
|
|
388
|
+
"""Returns a copy of the transformation.
|
|
389
|
+
|
|
390
|
+
Returns
|
|
391
|
+
-------
|
|
392
|
+
:class:`compas.geometry.Transformation`
|
|
393
|
+
An independent copy of the transformation.
|
|
394
|
+
|
|
395
|
+
"""
|
|
396
|
+
cls = type(self)
|
|
397
|
+
matrix = [
|
|
398
|
+
self.matrix[0][:],
|
|
399
|
+
self.matrix[1][:],
|
|
400
|
+
self.matrix[2][:],
|
|
401
|
+
self.matrix[3][:],
|
|
402
|
+
]
|
|
403
|
+
return cls(matrix)
|
|
404
|
+
|
|
405
|
+
def transpose(self):
|
|
406
|
+
"""Transpose the matrix of this transformation.
|
|
407
|
+
|
|
408
|
+
Returns
|
|
409
|
+
-------
|
|
410
|
+
None
|
|
411
|
+
The transformation is transposed in-place.
|
|
412
|
+
|
|
413
|
+
"""
|
|
414
|
+
self.matrix = transpose_matrix(self.matrix)
|
|
415
|
+
|
|
416
|
+
def transposed(self):
|
|
417
|
+
"""Create a transposed copy of this transformation.
|
|
418
|
+
|
|
419
|
+
Returns
|
|
420
|
+
-------
|
|
421
|
+
:class:`compas.geometry.Transformation`
|
|
422
|
+
The transposed transformation object.
|
|
423
|
+
|
|
424
|
+
"""
|
|
425
|
+
T = self.copy()
|
|
426
|
+
T.transpose()
|
|
427
|
+
return T
|
|
428
|
+
|
|
429
|
+
def invert(self):
|
|
430
|
+
"""Invert this transformation.
|
|
431
|
+
|
|
432
|
+
Returns
|
|
433
|
+
-------
|
|
434
|
+
None
|
|
435
|
+
The transformation is transposed in-place.
|
|
436
|
+
|
|
437
|
+
"""
|
|
438
|
+
self.matrix = matrix_inverse(self.matrix)
|
|
439
|
+
|
|
440
|
+
def inverse(self):
|
|
441
|
+
"""Returns the inverse transformation.
|
|
442
|
+
|
|
443
|
+
Returns
|
|
444
|
+
-------
|
|
445
|
+
:class:`compas.geometry.Transformation`
|
|
446
|
+
The inverse transformation.
|
|
447
|
+
|
|
448
|
+
Examples
|
|
449
|
+
--------
|
|
450
|
+
>>> from compas.geometry import Frame
|
|
451
|
+
>>> f = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
452
|
+
>>> T = Transformation.from_frame(f)
|
|
453
|
+
>>> I = Transformation(identity_matrix(4))
|
|
454
|
+
>>> I == T * T.inverse()
|
|
455
|
+
True
|
|
456
|
+
|
|
457
|
+
"""
|
|
458
|
+
T = self.copy()
|
|
459
|
+
T.invert()
|
|
460
|
+
return T
|
|
461
|
+
|
|
462
|
+
inverted = inverse
|
|
463
|
+
|
|
464
|
+
def decomposed(self):
|
|
465
|
+
"""Decompose the `Transformation` into its components.
|
|
466
|
+
|
|
467
|
+
Returns
|
|
468
|
+
-------
|
|
469
|
+
:class:`compas.geometry.Scale`
|
|
470
|
+
The scale component of the current transformation.
|
|
471
|
+
:class:`compas.geometry.Shear`
|
|
472
|
+
The shear component of the current transformation.
|
|
473
|
+
:class:`compas.geometry.Rotation`
|
|
474
|
+
The rotation component of the current transformation.
|
|
475
|
+
:class:`compas.geometry.Translation`
|
|
476
|
+
The translation component of the current transformation.
|
|
477
|
+
:class:`compas.geometry.Projection`
|
|
478
|
+
The projection component of the current transformation.
|
|
479
|
+
|
|
480
|
+
Examples
|
|
481
|
+
--------
|
|
482
|
+
>>> from compas.geometry import Scale, Translation, Rotation
|
|
483
|
+
>>> trans1 = [1, 2, 3]
|
|
484
|
+
>>> angle1 = [-2.142, 1.141, -0.142]
|
|
485
|
+
>>> scale1 = [0.123, 2, 0.5]
|
|
486
|
+
>>> T1 = Translation.from_vector(trans1)
|
|
487
|
+
>>> R1 = Rotation.from_euler_angles(angle1)
|
|
488
|
+
>>> S1 = Scale.from_factors(scale1)
|
|
489
|
+
>>> M = T1 * R1 * S1
|
|
490
|
+
>>> S, H, R, T, P = M.decomposed()
|
|
491
|
+
>>> S1 == S
|
|
492
|
+
True
|
|
493
|
+
>>> R1 == R
|
|
494
|
+
True
|
|
495
|
+
>>> T1 == T
|
|
496
|
+
True
|
|
497
|
+
|
|
498
|
+
"""
|
|
499
|
+
from compas.geometry import Projection
|
|
500
|
+
from compas.geometry import Rotation # noqa: F811
|
|
501
|
+
from compas.geometry import Scale # noqa: F811
|
|
502
|
+
from compas.geometry import Shear
|
|
503
|
+
from compas.geometry import Translation # noqa: F811
|
|
504
|
+
|
|
505
|
+
s, h, a, t, p = decompose_matrix(self.matrix)
|
|
506
|
+
S = Scale.from_factors(s)
|
|
507
|
+
H = Shear.from_entries(h)
|
|
508
|
+
R = Rotation.from_euler_angles(a, static=True, axes="xyz")
|
|
509
|
+
T = Translation.from_vector(t)
|
|
510
|
+
P = Projection.from_entries(p)
|
|
511
|
+
return S, H, R, T, P
|
|
512
|
+
|
|
513
|
+
def concatenate(self, other):
|
|
514
|
+
"""Concatenate another transformation to this transformation.
|
|
515
|
+
|
|
516
|
+
Parameters
|
|
517
|
+
----------
|
|
518
|
+
other: :class:`compas.geometry.Transformation`
|
|
519
|
+
The transformation object to concatenate.
|
|
520
|
+
|
|
521
|
+
Returns
|
|
522
|
+
-------
|
|
523
|
+
None
|
|
524
|
+
This transformation object is changed in-place.
|
|
525
|
+
|
|
526
|
+
Notes
|
|
527
|
+
-----
|
|
528
|
+
Rz * Ry * Rx means that Rx is first transformation, Ry second, and Rz third.
|
|
529
|
+
|
|
530
|
+
"""
|
|
531
|
+
self.matrix = multiply_matrices(self.matrix, other.matrix)
|
|
532
|
+
|
|
533
|
+
def concatenated(self, other):
|
|
534
|
+
"""Concatenate two transformations into one `Transformation`.
|
|
535
|
+
|
|
536
|
+
Parameters
|
|
537
|
+
----------
|
|
538
|
+
other : :class:`compas.geometry.Transformation`
|
|
539
|
+
The transformation object to concatenate.
|
|
540
|
+
|
|
541
|
+
Returns
|
|
542
|
+
-------
|
|
543
|
+
:class:`compas.geometry.Transformation`
|
|
544
|
+
The new transformation that is the concatenation of this one and the other.
|
|
545
|
+
|
|
546
|
+
Notes
|
|
547
|
+
-----
|
|
548
|
+
Rz * Ry * Rx means that Rx is first transformation, Ry second, and Rz third.
|
|
549
|
+
|
|
550
|
+
"""
|
|
551
|
+
cls = type(self)
|
|
552
|
+
if isinstance(other, cls):
|
|
553
|
+
return cls(multiply_matrices(self.matrix, other.matrix))
|
|
554
|
+
return Transformation(multiply_matrices(self.matrix, other.matrix))
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
"""
|
|
2
|
+
This library for transformations partly derived and was re-implemented from the
|
|
3
|
+
following online resources:
|
|
4
|
+
|
|
5
|
+
* http://www.lfd.uci.edu/~gohlke/code/transformations.py.html
|
|
6
|
+
* http://www.euclideanspace.com/maths/geometry/rotations/
|
|
7
|
+
* http://code.activestate.com/recipes/578108-determinant-of-matrix-of-any-order/
|
|
8
|
+
* http://blog.acipo.com/matrix-inversion-in-javascript/
|
|
9
|
+
|
|
10
|
+
Many thanks to Christoph Gohlke, Martin John Baker, Sachin Joglekar and Andrew
|
|
11
|
+
Ippoliti for providing code and documentation.
|
|
12
|
+
"""
|
|
13
|
+
|
|
14
|
+
from compas.geometry import Transformation
|
|
15
|
+
from compas.geometry import matrix_from_translation
|
|
16
|
+
from compas.geometry import translation_from_matrix
|
|
17
|
+
from compas.itertools import flatten
|
|
18
|
+
from compas.tolerance import TOL
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
class Translation(Transformation):
|
|
22
|
+
"""Class representing a translation transformation.
|
|
23
|
+
|
|
24
|
+
Parameters
|
|
25
|
+
----------
|
|
26
|
+
matrix : list[list[float]], optional
|
|
27
|
+
A 4x4 matrix (or similar) representing a translation.
|
|
28
|
+
check : bool, optional
|
|
29
|
+
If ``True``, the provided matrix will be checked for validity.
|
|
30
|
+
name : str, optional
|
|
31
|
+
The name of the transformation.
|
|
32
|
+
|
|
33
|
+
Attributes
|
|
34
|
+
----------
|
|
35
|
+
translation_vector : :class:`compas.geometry.Vector`
|
|
36
|
+
The translation vector.
|
|
37
|
+
|
|
38
|
+
Raises
|
|
39
|
+
------
|
|
40
|
+
ValueError
|
|
41
|
+
If ``check`` is ``True`` and the provided transformation matrix is not a translation.
|
|
42
|
+
|
|
43
|
+
Examples
|
|
44
|
+
--------
|
|
45
|
+
>>> T = Translation.from_vector([1, 2, 3])
|
|
46
|
+
>>> T[0, 3] == 1
|
|
47
|
+
True
|
|
48
|
+
>>> T[1, 3] == 2
|
|
49
|
+
True
|
|
50
|
+
>>> T[2, 3] == 3
|
|
51
|
+
True
|
|
52
|
+
|
|
53
|
+
>>> from compas.geometry import Vector
|
|
54
|
+
>>> T = Translation.from_vector(Vector(1, 2, 3))
|
|
55
|
+
>>> T[0, 3] == 1
|
|
56
|
+
True
|
|
57
|
+
>>> T[1, 3] == 2
|
|
58
|
+
True
|
|
59
|
+
>>> T[2, 3] == 3
|
|
60
|
+
True
|
|
61
|
+
|
|
62
|
+
>>> T = Translation([[1, 0, 0, 1], [0, 1, 0, 2], [0, 0, 1, 3], [0, 0, 0, 1]])
|
|
63
|
+
>>> T[0, 3] == 1
|
|
64
|
+
True
|
|
65
|
+
>>> T[1, 3] == 2
|
|
66
|
+
True
|
|
67
|
+
>>> T[2, 3] == 3
|
|
68
|
+
True
|
|
69
|
+
|
|
70
|
+
"""
|
|
71
|
+
|
|
72
|
+
def __init__(self, matrix=None, check=False, name=None):
|
|
73
|
+
if matrix and check:
|
|
74
|
+
translation = translation_from_matrix(matrix)
|
|
75
|
+
if not TOL.is_allclose(flatten(matrix), flatten(matrix_from_translation(translation))):
|
|
76
|
+
raise ValueError("This is not a proper translation matrix.")
|
|
77
|
+
super(Translation, self).__init__(matrix=matrix, name=name)
|
|
78
|
+
|
|
79
|
+
@property
|
|
80
|
+
def translation_vector(self):
|
|
81
|
+
from compas.geometry import Vector
|
|
82
|
+
|
|
83
|
+
x = self.matrix[0][3]
|
|
84
|
+
y = self.matrix[1][3]
|
|
85
|
+
z = self.matrix[2][3]
|
|
86
|
+
return Vector(x, y, z)
|
|
87
|
+
|
|
88
|
+
@classmethod
|
|
89
|
+
def from_vector(cls, vector):
|
|
90
|
+
"""Create a translation transformation from a translation vector.
|
|
91
|
+
|
|
92
|
+
Parameters
|
|
93
|
+
----------
|
|
94
|
+
vector : [float, float, float] | :class:`compas.geometry.Vector`
|
|
95
|
+
The translation vector.
|
|
96
|
+
|
|
97
|
+
Returns
|
|
98
|
+
-------
|
|
99
|
+
:class:`compas.geometry.Translation`
|
|
100
|
+
The translation transformation.
|
|
101
|
+
|
|
102
|
+
"""
|
|
103
|
+
matrix = matrix_from_translation(vector)
|
|
104
|
+
return cls(matrix)
|