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,354 @@
|
|
|
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 axis_and_angle_from_matrix
|
|
16
|
+
from compas.geometry import basis_vectors_from_matrix
|
|
17
|
+
from compas.geometry import cross_vectors
|
|
18
|
+
from compas.geometry import decompose_matrix
|
|
19
|
+
from compas.geometry import euler_angles_from_matrix
|
|
20
|
+
from compas.geometry import length_vector
|
|
21
|
+
from compas.geometry import matrix_from_axis_and_angle
|
|
22
|
+
from compas.geometry import matrix_from_euler_angles
|
|
23
|
+
from compas.geometry import matrix_from_frame
|
|
24
|
+
from compas.geometry import matrix_from_quaternion
|
|
25
|
+
from compas.geometry import normalize_vector
|
|
26
|
+
from compas.itertools import flatten
|
|
27
|
+
from compas.tolerance import TOL
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
class Rotation(Transformation):
|
|
31
|
+
"""Class representing a rotation transformation.
|
|
32
|
+
|
|
33
|
+
The class contains methods for converting rotation matrices to axis-angle
|
|
34
|
+
representations, Euler angles, quaternion and basis vectors.
|
|
35
|
+
|
|
36
|
+
Parameters
|
|
37
|
+
----------
|
|
38
|
+
matrix : list[list[float]], optional
|
|
39
|
+
A 4x4 matrix (or similar) representing a rotation.
|
|
40
|
+
check : bool, optional
|
|
41
|
+
If ``True``, the provided matrix will be checked for validity.
|
|
42
|
+
name : str, optional
|
|
43
|
+
The name of the transformation.
|
|
44
|
+
|
|
45
|
+
Attributes
|
|
46
|
+
----------
|
|
47
|
+
quaternion : :class:`compas.geometry.Quaternion`, read-only
|
|
48
|
+
The quaternion from the rotation.
|
|
49
|
+
axis_and_angle : tuple[:class:`compas.geometry.Vector`, float], read-only
|
|
50
|
+
The axis and the angle of the rotation.
|
|
51
|
+
axis_angle_vector : :class:`compas.geometry.Vector`, read-only
|
|
52
|
+
The axis-angle vector of the rotation.
|
|
53
|
+
basis_vectors : tuple[:class:`compas.geometry.Vector`, :class:`compas.geometry.Vector`], read-only
|
|
54
|
+
The basis vectors of the rotation.
|
|
55
|
+
|
|
56
|
+
Raises
|
|
57
|
+
------
|
|
58
|
+
ValueError
|
|
59
|
+
If ``check`` is ``True`` and the provided transformation matrix is not a rotation.
|
|
60
|
+
|
|
61
|
+
Examples
|
|
62
|
+
--------
|
|
63
|
+
>>> from compas.geometry import Frame
|
|
64
|
+
>>> f1 = Frame([0, 0, 0], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
65
|
+
>>> R = Rotation.from_frame(f1)
|
|
66
|
+
>>> args = False, "xyz"
|
|
67
|
+
>>> alpha, beta, gamma = R.euler_angles(*args)
|
|
68
|
+
>>> xaxis, yaxis, zaxis = [1, 0, 0], [0, 1, 0], [0, 0, 1]
|
|
69
|
+
>>> Rx = Rotation.from_axis_and_angle(xaxis, alpha)
|
|
70
|
+
>>> Ry = Rotation.from_axis_and_angle(yaxis, beta)
|
|
71
|
+
>>> Rz = Rotation.from_axis_and_angle(zaxis, gamma)
|
|
72
|
+
>>> f2 = Frame.worldXY()
|
|
73
|
+
>>> f1 == f2.transformed(Rx * Ry * Rz)
|
|
74
|
+
True
|
|
75
|
+
|
|
76
|
+
"""
|
|
77
|
+
|
|
78
|
+
def __init__(self, matrix=None, check=False, name=None):
|
|
79
|
+
if matrix and check:
|
|
80
|
+
_, _, angles, _, _ = decompose_matrix(matrix)
|
|
81
|
+
if not TOL.is_allclose(flatten(matrix), flatten(matrix_from_euler_angles(angles))):
|
|
82
|
+
raise ValueError("This is not a proper rotation matrix.")
|
|
83
|
+
super(Rotation, self).__init__(matrix=matrix, name=name)
|
|
84
|
+
|
|
85
|
+
@property
|
|
86
|
+
def quaternion(self):
|
|
87
|
+
from compas.geometry import Quaternion
|
|
88
|
+
|
|
89
|
+
return Quaternion.from_matrix(self.matrix)
|
|
90
|
+
|
|
91
|
+
@property
|
|
92
|
+
def axis_and_angle(self):
|
|
93
|
+
from compas.geometry import Vector
|
|
94
|
+
|
|
95
|
+
axis, angle = axis_and_angle_from_matrix(self.matrix)
|
|
96
|
+
return Vector(*axis), angle
|
|
97
|
+
|
|
98
|
+
@property
|
|
99
|
+
def axis_angle_vector(self):
|
|
100
|
+
axis, angle = self.axis_and_angle
|
|
101
|
+
return axis.scaled(angle)
|
|
102
|
+
|
|
103
|
+
@property
|
|
104
|
+
def basis_vectors(self):
|
|
105
|
+
from compas.geometry import Vector
|
|
106
|
+
|
|
107
|
+
xaxis, yaxis = basis_vectors_from_matrix(self.matrix)
|
|
108
|
+
return Vector(*xaxis), Vector(*yaxis)
|
|
109
|
+
|
|
110
|
+
@classmethod
|
|
111
|
+
def from_axis_and_angle(cls, axis, angle, point=[0, 0, 0]):
|
|
112
|
+
"""Construct a rotation transformation from a rotation axis and an angle and an optional point of rotation.
|
|
113
|
+
|
|
114
|
+
The rotation is based on the right hand rule, i.e. anti-clockwise if the
|
|
115
|
+
axis of rotation points towards the observer.
|
|
116
|
+
|
|
117
|
+
Parameters
|
|
118
|
+
----------
|
|
119
|
+
axis : [float, float, float] | :class:`compas.geometry.Vector`
|
|
120
|
+
Three numbers that represent the axis of rotation.
|
|
121
|
+
angle : float
|
|
122
|
+
The rotation angle in radians.
|
|
123
|
+
point : [float, float, float] | :class:`compas.geometry.Point`
|
|
124
|
+
A point to perform a rotation around an origin other than [0, 0, 0].
|
|
125
|
+
|
|
126
|
+
Returns
|
|
127
|
+
-------
|
|
128
|
+
:class:`compas.geometry.Rotation`
|
|
129
|
+
|
|
130
|
+
Notes
|
|
131
|
+
-----
|
|
132
|
+
The rotation is based on the right hand rule, i.e. anti-clockwise
|
|
133
|
+
if the axis of rotation points towards the observer.
|
|
134
|
+
|
|
135
|
+
Examples
|
|
136
|
+
--------
|
|
137
|
+
>>> axis1 = normalize_vector([-0.043, -0.254, 0.617])
|
|
138
|
+
>>> angle1 = 0.1
|
|
139
|
+
>>> R = Rotation.from_axis_and_angle(axis1, angle1)
|
|
140
|
+
>>> axis2, angle2 = R.axis_and_angle
|
|
141
|
+
>>> allclose(axis1, axis2)
|
|
142
|
+
True
|
|
143
|
+
>>> allclose([angle1], [angle2])
|
|
144
|
+
True
|
|
145
|
+
|
|
146
|
+
"""
|
|
147
|
+
matrix = matrix_from_axis_and_angle(axis, angle, point=point)
|
|
148
|
+
return cls(matrix)
|
|
149
|
+
|
|
150
|
+
@classmethod
|
|
151
|
+
def from_basis_vectors(cls, xaxis, yaxis):
|
|
152
|
+
"""Construct a rotation transformation from basis vectors (= orthonormal vectors).
|
|
153
|
+
|
|
154
|
+
Parameters
|
|
155
|
+
----------
|
|
156
|
+
xaxis : [float, float, float] | :class:`compas.geometry.Vector`
|
|
157
|
+
The x-axis of the frame.
|
|
158
|
+
yaxis : [float, float, float] | :class:`compas.geometry.Vector`
|
|
159
|
+
The y-axis of the frame.
|
|
160
|
+
|
|
161
|
+
Returns
|
|
162
|
+
-------
|
|
163
|
+
:class:`compas.geometry.Rotation`
|
|
164
|
+
|
|
165
|
+
Examples
|
|
166
|
+
--------
|
|
167
|
+
>>> xaxis = [0.68, 0.68, 0.27]
|
|
168
|
+
>>> yaxis = [-0.67, 0.73, -0.15]
|
|
169
|
+
>>> R = Rotation.from_basis_vectors(xaxis, yaxis)
|
|
170
|
+
|
|
171
|
+
"""
|
|
172
|
+
xaxis = normalize_vector(list(xaxis))
|
|
173
|
+
yaxis = normalize_vector(list(yaxis))
|
|
174
|
+
zaxis = cross_vectors(xaxis, yaxis)
|
|
175
|
+
yaxis = cross_vectors(zaxis, xaxis)
|
|
176
|
+
matrix = [
|
|
177
|
+
[xaxis[0], yaxis[0], zaxis[0], 0],
|
|
178
|
+
[xaxis[1], yaxis[1], zaxis[1], 0],
|
|
179
|
+
[xaxis[2], yaxis[2], zaxis[2], 0],
|
|
180
|
+
[0, 0, 0, 1],
|
|
181
|
+
]
|
|
182
|
+
return cls(matrix)
|
|
183
|
+
|
|
184
|
+
@classmethod
|
|
185
|
+
def from_frame(cls, frame):
|
|
186
|
+
"""Construct a rotation transformationn from world XY to frame.
|
|
187
|
+
|
|
188
|
+
Parameters
|
|
189
|
+
----------
|
|
190
|
+
frame : [point, vector, vector] | :class:`compas.geometry.Frame`
|
|
191
|
+
A frame describing the targeted Cartesian coordinate system.
|
|
192
|
+
|
|
193
|
+
Returns
|
|
194
|
+
-------
|
|
195
|
+
:class:`compas.geometry.Rotation`
|
|
196
|
+
|
|
197
|
+
Notes
|
|
198
|
+
-----
|
|
199
|
+
Creating a rotation from a frame means that we omit all translational
|
|
200
|
+
components. If that is unwanted, use ``Transformation.from_frame(frame)``.
|
|
201
|
+
|
|
202
|
+
Examples
|
|
203
|
+
--------
|
|
204
|
+
>>> from compas.geometry import Frame
|
|
205
|
+
>>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
206
|
+
>>> T = Transformation.from_frame(f1)
|
|
207
|
+
>>> f2 = Frame.from_transformation(T)
|
|
208
|
+
>>> f1 == f2
|
|
209
|
+
True
|
|
210
|
+
|
|
211
|
+
"""
|
|
212
|
+
matrix = matrix_from_frame(frame)
|
|
213
|
+
matrix[0][3] = 0.0
|
|
214
|
+
matrix[1][3] = 0.0
|
|
215
|
+
matrix[2][3] = 0.0
|
|
216
|
+
return cls(matrix)
|
|
217
|
+
|
|
218
|
+
@classmethod
|
|
219
|
+
def from_quaternion(cls, quaternion):
|
|
220
|
+
"""Construct a rotation transformation` from quaternion coefficients.
|
|
221
|
+
|
|
222
|
+
Parameters
|
|
223
|
+
----------
|
|
224
|
+
quaternion : [float, float, float, float] | :class:`compas.geometry.Quaternion`
|
|
225
|
+
Four numbers that represents the four coefficient values of a quaternion.
|
|
226
|
+
|
|
227
|
+
Returns
|
|
228
|
+
-------
|
|
229
|
+
:class:`compas.geometry.Rotation`
|
|
230
|
+
|
|
231
|
+
Examples
|
|
232
|
+
--------
|
|
233
|
+
>>> from compas.tolerance import TOL
|
|
234
|
+
>>> q1 = [0.945, -0.021, -0.125, 0.303]
|
|
235
|
+
>>> R = Rotation.from_quaternion(q1)
|
|
236
|
+
>>> q2 = R.quaternion
|
|
237
|
+
>>> TOL.is_allclose(q1, q2)
|
|
238
|
+
True
|
|
239
|
+
|
|
240
|
+
"""
|
|
241
|
+
matrix = matrix_from_quaternion(quaternion)
|
|
242
|
+
return cls(matrix)
|
|
243
|
+
|
|
244
|
+
@classmethod
|
|
245
|
+
def from_axis_angle_vector(cls, axis_angle_vector, point=[0, 0, 0]):
|
|
246
|
+
"""Construct a rotation transformation from an axis-angle vector.
|
|
247
|
+
|
|
248
|
+
Parameters
|
|
249
|
+
----------
|
|
250
|
+
axis_angle_vector : [float, float, float] | :class:`compas.geometry.Vector`
|
|
251
|
+
Three numbers that represent the axis of rotation and angle of rotation through the vector's magnitude.
|
|
252
|
+
point : [float, float, float] | :class:`compas.geometry.Point`, optional
|
|
253
|
+
A point to perform a rotation around an origin other than [0, 0, 0].
|
|
254
|
+
|
|
255
|
+
Returns
|
|
256
|
+
-------
|
|
257
|
+
:class:`compas.geometry.Rotation`
|
|
258
|
+
|
|
259
|
+
Examples
|
|
260
|
+
--------
|
|
261
|
+
>>> from compas.tolerance import TOL
|
|
262
|
+
>>> aav1 = [-0.043, -0.254, 0.617]
|
|
263
|
+
>>> R = Rotation.from_axis_angle_vector(aav1)
|
|
264
|
+
>>> aav2 = R.axis_angle_vector
|
|
265
|
+
>>> TOL.is_allclose(aav1, aav2)
|
|
266
|
+
True
|
|
267
|
+
|
|
268
|
+
"""
|
|
269
|
+
angle = length_vector(axis_angle_vector)
|
|
270
|
+
return cls.from_axis_and_angle(axis_angle_vector, angle, point)
|
|
271
|
+
|
|
272
|
+
# why is this repeated here?
|
|
273
|
+
@classmethod
|
|
274
|
+
def from_euler_angles(cls, euler_angles, static=True, axes="xyz", **kwargs):
|
|
275
|
+
"""Construct a rotation transformation from Euler angles.
|
|
276
|
+
|
|
277
|
+
In 3D space any orientation can be achieved by composing three
|
|
278
|
+
elemental rotations, rotations about the axes (x,y,z) of a coordinate
|
|
279
|
+
system. A triple of Euler angles can be interpreted in 24 ways, which
|
|
280
|
+
depends on if the rotations are applied to a static (extrinsic) or
|
|
281
|
+
rotating (intrinsic) frame and the order of axes.
|
|
282
|
+
|
|
283
|
+
Parameters
|
|
284
|
+
----------
|
|
285
|
+
euler_angles: [float, float, float]
|
|
286
|
+
Three numbers that represent the angles of rotations about the
|
|
287
|
+
defined axes.
|
|
288
|
+
static: bool, optional
|
|
289
|
+
If True the rotations are applied to a static frame.
|
|
290
|
+
If False, to a rotational.
|
|
291
|
+
axes: str, optional
|
|
292
|
+
A 3 character string specifying order of the axes.
|
|
293
|
+
|
|
294
|
+
Returns
|
|
295
|
+
-------
|
|
296
|
+
:class:`compas.geometry.Rotation`
|
|
297
|
+
|
|
298
|
+
Examples
|
|
299
|
+
--------
|
|
300
|
+
>>> from compas.tolerance import TOL
|
|
301
|
+
>>> ea1 = 1.4, 0.5, 2.3
|
|
302
|
+
>>> args = False, "xyz"
|
|
303
|
+
>>> R1 = Rotation.from_euler_angles(ea1, *args)
|
|
304
|
+
>>> ea2 = R1.euler_angles(*args)
|
|
305
|
+
>>> TOL.is_allclose(ea1, ea2)
|
|
306
|
+
True
|
|
307
|
+
|
|
308
|
+
>>> alpha, beta, gamma = ea1
|
|
309
|
+
>>> xaxis, yaxis, zaxis = [1, 0, 0], [0, 1, 0], [0, 0, 1]
|
|
310
|
+
>>> Rx = Rotation.from_axis_and_angle(xaxis, alpha)
|
|
311
|
+
>>> Ry = Rotation.from_axis_and_angle(yaxis, beta)
|
|
312
|
+
>>> Rz = Rotation.from_axis_and_angle(zaxis, gamma)
|
|
313
|
+
>>> R2 = Rx * Ry * Rz
|
|
314
|
+
>>> R1 == R2
|
|
315
|
+
True
|
|
316
|
+
|
|
317
|
+
"""
|
|
318
|
+
return super(Rotation, cls).from_euler_angles(euler_angles, static, axes)
|
|
319
|
+
|
|
320
|
+
# split up into two properties
|
|
321
|
+
# euler_angles
|
|
322
|
+
# rotating_euler_angles
|
|
323
|
+
# xyz seems irelevant
|
|
324
|
+
# could be added to base Transformation
|
|
325
|
+
# always relevant
|
|
326
|
+
def euler_angles(self, static=True, axes="xyz"):
|
|
327
|
+
"""Returns Euler angles from the rotation according to specified
|
|
328
|
+
axis sequence and rotation type.
|
|
329
|
+
|
|
330
|
+
Parameters
|
|
331
|
+
----------
|
|
332
|
+
static : bool, optional
|
|
333
|
+
If True the rotations are applied to a static frame.
|
|
334
|
+
If False, to a rotational.
|
|
335
|
+
axes : str, optional
|
|
336
|
+
A 3 character string specifying the order of the axes.
|
|
337
|
+
|
|
338
|
+
Returns
|
|
339
|
+
-------
|
|
340
|
+
[float, float, float]
|
|
341
|
+
The 3 Euler angles.
|
|
342
|
+
|
|
343
|
+
Examples
|
|
344
|
+
--------
|
|
345
|
+
>>> from compas.tolerance import TOL
|
|
346
|
+
>>> ea1 = 1.4, 0.5, 2.3
|
|
347
|
+
>>> args = False, "xyz"
|
|
348
|
+
>>> R1 = Rotation.from_euler_angles(ea1, *args)
|
|
349
|
+
>>> ea2 = R1.euler_angles(*args)
|
|
350
|
+
>>> TOL.is_allclose(ea1, ea2)
|
|
351
|
+
True
|
|
352
|
+
|
|
353
|
+
"""
|
|
354
|
+
return euler_angles_from_matrix(self.matrix, static, axes)
|
compas/geometry/scale.py
ADDED
|
@@ -0,0 +1,100 @@
|
|
|
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 decompose_matrix
|
|
16
|
+
from compas.geometry import matrix_from_frame
|
|
17
|
+
from compas.geometry import matrix_from_scale_factors
|
|
18
|
+
from compas.geometry import matrix_inverse
|
|
19
|
+
from compas.geometry import multiply_matrices
|
|
20
|
+
from compas.itertools import flatten
|
|
21
|
+
from compas.tolerance import TOL
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
class Scale(Transformation):
|
|
25
|
+
"""Class representing a scale transformation.
|
|
26
|
+
|
|
27
|
+
Parameters
|
|
28
|
+
----------
|
|
29
|
+
matrix : list[list[float]], optional
|
|
30
|
+
A 4x4 matrix (or similar) representing a scaling.
|
|
31
|
+
check : bool, optional
|
|
32
|
+
If ``True``, the provided matrix will be checked for validity.
|
|
33
|
+
name : str, optional
|
|
34
|
+
The name of the transformation.
|
|
35
|
+
|
|
36
|
+
Raises
|
|
37
|
+
------
|
|
38
|
+
ValueError
|
|
39
|
+
If ``check`` is ``True`` and the provided transformation matrix is not a scale matrix.
|
|
40
|
+
|
|
41
|
+
Examples
|
|
42
|
+
--------
|
|
43
|
+
>>> S = Scale.from_factors([1, 2, 3])
|
|
44
|
+
>>> S[0, 0] == 1
|
|
45
|
+
True
|
|
46
|
+
>>> S[1, 1] == 2
|
|
47
|
+
True
|
|
48
|
+
>>> S[2, 2] == 3
|
|
49
|
+
True
|
|
50
|
+
|
|
51
|
+
>>> from compas.geometry import Point, Frame
|
|
52
|
+
>>> point = Point(2, 5, 0)
|
|
53
|
+
>>> frame = Frame(point, (1, 0, 0), (0, 1, 0))
|
|
54
|
+
>>> points = [point, Point(2, 10, 0)]
|
|
55
|
+
>>> S = Scale.from_factors([2.0] * 3, frame)
|
|
56
|
+
>>> [p.transformed(S) for p in points]
|
|
57
|
+
[Point(2.000, 5.000, 0.000), Point(2.000, 15.000, 0.000)]
|
|
58
|
+
|
|
59
|
+
"""
|
|
60
|
+
|
|
61
|
+
def __init__(self, matrix=None, check=False, name=None):
|
|
62
|
+
if matrix and check:
|
|
63
|
+
scale, _, _, _, _ = decompose_matrix(matrix)
|
|
64
|
+
if not TOL.is_allclose(flatten(matrix), flatten(matrix_from_scale_factors(scale))):
|
|
65
|
+
raise ValueError("This is not a proper scale matrix.")
|
|
66
|
+
super(Scale, self).__init__(matrix=matrix, name=name)
|
|
67
|
+
|
|
68
|
+
@classmethod
|
|
69
|
+
def from_factors(cls, factors, frame=None):
|
|
70
|
+
"""Construct a scale transformation from scale factors.
|
|
71
|
+
|
|
72
|
+
Parameters
|
|
73
|
+
----------
|
|
74
|
+
factors : [float, float, float]
|
|
75
|
+
The scale factors along X, Y, Z.
|
|
76
|
+
frame : [point, vector, vector] | :class:`compas.geometry.Frame`, optional
|
|
77
|
+
The anchor frame for the scaling transformation.
|
|
78
|
+
|
|
79
|
+
Returns
|
|
80
|
+
-------
|
|
81
|
+
:class:`compas.geometry.Scale`
|
|
82
|
+
A scale transformation.
|
|
83
|
+
|
|
84
|
+
Examples
|
|
85
|
+
--------
|
|
86
|
+
>>> from compas.geometry import Point, Frame
|
|
87
|
+
>>> point = Point(2, 5, 0)
|
|
88
|
+
>>> frame = Frame(point, (1, 0, 0), (0, 1, 0))
|
|
89
|
+
>>> points = [point, Point(2, 10, 0)]
|
|
90
|
+
>>> S = Scale.from_factors([2.0] * 3, frame)
|
|
91
|
+
>>> [p.transformed(S) for p in points]
|
|
92
|
+
[Point(2.000, 5.000, 0.000), Point(2.000, 15.000, 0.000)]
|
|
93
|
+
|
|
94
|
+
"""
|
|
95
|
+
matrix = matrix_from_scale_factors(factors)
|
|
96
|
+
if frame:
|
|
97
|
+
Tw = matrix_from_frame(frame)
|
|
98
|
+
Tl = matrix_inverse(Tw)
|
|
99
|
+
matrix = multiply_matrices(multiply_matrices(Tw, matrix), Tl)
|
|
100
|
+
return cls(matrix)
|
|
File without changes
|