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,294 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from math import cos
|
|
6
|
+
from math import pi
|
|
7
|
+
from math import sin
|
|
8
|
+
|
|
9
|
+
from compas.geometry import Frame
|
|
10
|
+
from compas.geometry import Plane
|
|
11
|
+
from compas.geometry import matrix_from_frame
|
|
12
|
+
from compas.geometry import transform_points
|
|
13
|
+
|
|
14
|
+
from .shape import Shape
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
class Torus(Shape):
|
|
18
|
+
"""A torus is defined by a plane and two radii.
|
|
19
|
+
|
|
20
|
+
Parameters
|
|
21
|
+
----------
|
|
22
|
+
radius_axis: float, optional
|
|
23
|
+
The radius of the axis.
|
|
24
|
+
radius_pipe: float, optional
|
|
25
|
+
The radius of the pipe.
|
|
26
|
+
frame : :class:`compas.geometry.Frame`, optional
|
|
27
|
+
The local coordinate system of the torus.
|
|
28
|
+
Default is ``None``, in which case the torus is constructed in the world XY plane.
|
|
29
|
+
name : str, optional
|
|
30
|
+
The name of the shape.
|
|
31
|
+
|
|
32
|
+
Attributes
|
|
33
|
+
----------
|
|
34
|
+
frame : :class:`compas.geometry.Frame`
|
|
35
|
+
The coordinate system of the torus.
|
|
36
|
+
transformation : :class:`compas.geometry.Transformation`
|
|
37
|
+
The transformation of the sphere to global coordinates.
|
|
38
|
+
radius_axis : float
|
|
39
|
+
The radius of the axis.
|
|
40
|
+
radius_pipe : float
|
|
41
|
+
The radius of the pipe.
|
|
42
|
+
axis : :class:`compas.geometry.Line`, read-only
|
|
43
|
+
The central axis of the torus.
|
|
44
|
+
base : :class:`compas.geometry.Point`, read-only
|
|
45
|
+
The base point of the torus.
|
|
46
|
+
The base point is at the origin of the local coordinate system.
|
|
47
|
+
plane : :class:`compas.geometry.Plane`, read-only
|
|
48
|
+
The plane of the torus.
|
|
49
|
+
The base point of the plane is at the origin of the local coordinate system.
|
|
50
|
+
The normal of the plane is in the direction of the z-axis of the local coordinate system.
|
|
51
|
+
circle : :class:`compas.geometry.Circle`, read-only
|
|
52
|
+
The base circle of the torus.
|
|
53
|
+
The center of the circle is at the origin of the local coordinate system.
|
|
54
|
+
area : float, read-only
|
|
55
|
+
The surface area of the torus.
|
|
56
|
+
volume : float, read-only
|
|
57
|
+
The volume of the torus.
|
|
58
|
+
|
|
59
|
+
Examples
|
|
60
|
+
--------
|
|
61
|
+
>>> from compas.geometry import Frame
|
|
62
|
+
>>> from compas.geometry import Torus
|
|
63
|
+
>>> torus = Torus(frame=Frame.worldXY(), radius_axis=5.0, radius_pipe=2.0)
|
|
64
|
+
>>> torus = Torus(radius_axis=5.0, radius_pipe=2.0)
|
|
65
|
+
|
|
66
|
+
"""
|
|
67
|
+
|
|
68
|
+
DATASCHEMA = {
|
|
69
|
+
"type": "object",
|
|
70
|
+
"properties": {
|
|
71
|
+
"radius_axis": {"type": "number", "minimum": 0},
|
|
72
|
+
"radius_pipe": {"type": "number", "minimum": 0},
|
|
73
|
+
"frame": Frame.DATASCHEMA,
|
|
74
|
+
},
|
|
75
|
+
"required": ["radius_axis", "radius_pipe", "frame"],
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
@property
|
|
79
|
+
def __data__(self):
|
|
80
|
+
return {
|
|
81
|
+
"radius_axis": self.radius_axis,
|
|
82
|
+
"radius_pipe": self.radius_pipe,
|
|
83
|
+
"frame": self.frame.__data__,
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
@classmethod
|
|
87
|
+
def __from_data__(cls, data):
|
|
88
|
+
return cls(
|
|
89
|
+
radius_axis=data["radius_axis"],
|
|
90
|
+
radius_pipe=data["radius_pipe"],
|
|
91
|
+
frame=Frame.__from_data__(data["frame"]),
|
|
92
|
+
)
|
|
93
|
+
|
|
94
|
+
def __init__(self, radius_axis, radius_pipe, frame=None, name=None):
|
|
95
|
+
super(Torus, self).__init__(frame=frame, name=name)
|
|
96
|
+
self._radius_axis = None
|
|
97
|
+
self._radius_pipe = None
|
|
98
|
+
self.radius_axis = radius_axis
|
|
99
|
+
self.radius_pipe = radius_pipe
|
|
100
|
+
|
|
101
|
+
def __repr__(self):
|
|
102
|
+
return "Torus(frame={0!r}, radius_axis={1!r}, radius_pipe={2!r})".format(
|
|
103
|
+
self.frame,
|
|
104
|
+
self.radius_axis,
|
|
105
|
+
self.radius_pipe,
|
|
106
|
+
)
|
|
107
|
+
|
|
108
|
+
# ==========================================================================
|
|
109
|
+
# Properties
|
|
110
|
+
# ==========================================================================
|
|
111
|
+
|
|
112
|
+
@property
|
|
113
|
+
def plane(self):
|
|
114
|
+
return Plane(self.frame.point, self.frame.zaxis)
|
|
115
|
+
|
|
116
|
+
@property
|
|
117
|
+
def radius_axis(self):
|
|
118
|
+
if self._radius_axis is None:
|
|
119
|
+
raise ValueError("The torus has no axis radius.")
|
|
120
|
+
return self._radius_axis
|
|
121
|
+
|
|
122
|
+
@radius_axis.setter
|
|
123
|
+
def radius_axis(self, radius):
|
|
124
|
+
if radius < 0:
|
|
125
|
+
raise ValueError("The value for the axis radius should be radius >= 0.")
|
|
126
|
+
self._radius_axis = float(radius)
|
|
127
|
+
|
|
128
|
+
@property
|
|
129
|
+
def radius_pipe(self):
|
|
130
|
+
if self._radius_pipe is None:
|
|
131
|
+
raise ValueError("The torus has no pipe radius.")
|
|
132
|
+
return self._radius_pipe
|
|
133
|
+
|
|
134
|
+
@radius_pipe.setter
|
|
135
|
+
def radius_pipe(self, radius):
|
|
136
|
+
if radius < 0:
|
|
137
|
+
raise ValueError("The value for the pipe radius should be radius >= 0.")
|
|
138
|
+
self._radius_pipe = float(radius)
|
|
139
|
+
|
|
140
|
+
@property
|
|
141
|
+
def center(self):
|
|
142
|
+
return self.plane.point
|
|
143
|
+
|
|
144
|
+
@property
|
|
145
|
+
def area(self):
|
|
146
|
+
return (2 * pi * self.radius_pipe) * (2 * pi * self.radius_axis)
|
|
147
|
+
|
|
148
|
+
@property
|
|
149
|
+
def volume(self):
|
|
150
|
+
return (pi * self.radius_pipe**2) * (2 * pi * self.radius_axis)
|
|
151
|
+
|
|
152
|
+
# ==========================================================================
|
|
153
|
+
# Constructors
|
|
154
|
+
# ==========================================================================
|
|
155
|
+
|
|
156
|
+
@classmethod
|
|
157
|
+
def from_plane_and_radii(cls, plane, radius_axis, radius_pipe):
|
|
158
|
+
"""Construct a torus from a plane and two radii.
|
|
159
|
+
|
|
160
|
+
Parameters
|
|
161
|
+
----------
|
|
162
|
+
plane : :class:`compas.geometry.Plane`
|
|
163
|
+
The plane of the torus.
|
|
164
|
+
radius_axis: float
|
|
165
|
+
The radius of the axis.
|
|
166
|
+
radius_pipe: float
|
|
167
|
+
The radius of the pipe.
|
|
168
|
+
|
|
169
|
+
Returns
|
|
170
|
+
-------
|
|
171
|
+
:class:`compas.geometry.Torus`
|
|
172
|
+
The constructed torus.
|
|
173
|
+
|
|
174
|
+
Examples
|
|
175
|
+
--------
|
|
176
|
+
>>> from compas.geometry import Plane
|
|
177
|
+
>>> from compas.geometry import Torus
|
|
178
|
+
>>> plane = Plane.worldXY()
|
|
179
|
+
>>> torus = Torus.from_plane_and_radii(plane, 5.0, 2.0)
|
|
180
|
+
|
|
181
|
+
"""
|
|
182
|
+
frame = Frame.from_plane(plane)
|
|
183
|
+
return cls(radius_axis=radius_axis, radius_pipe=radius_pipe, frame=frame)
|
|
184
|
+
|
|
185
|
+
# ==========================================================================
|
|
186
|
+
# Conversions
|
|
187
|
+
# ==========================================================================
|
|
188
|
+
|
|
189
|
+
def to_vertices_and_faces(self, u=16, v=16, triangulated=False):
|
|
190
|
+
"""Returns a list of vertices and faces.
|
|
191
|
+
|
|
192
|
+
The vertices are defined in global coordinates.
|
|
193
|
+
|
|
194
|
+
Parameters
|
|
195
|
+
----------
|
|
196
|
+
u : int, optional
|
|
197
|
+
Number of faces in the "u" direction.
|
|
198
|
+
v : int, optional
|
|
199
|
+
Number of faces in the "v" direction.
|
|
200
|
+
triangulated: bool, optional
|
|
201
|
+
If True, triangulate the faces.
|
|
202
|
+
|
|
203
|
+
Returns
|
|
204
|
+
-------
|
|
205
|
+
list[list[float]], list[list[int]]
|
|
206
|
+
A list of vertex locations, and a list of faces,
|
|
207
|
+
with each face defined as a list of indices into the list of vertices.
|
|
208
|
+
|
|
209
|
+
"""
|
|
210
|
+
if u < 3:
|
|
211
|
+
raise ValueError("The value for u should be u > 3.")
|
|
212
|
+
if v < 3:
|
|
213
|
+
raise ValueError("The value for v should be v > 3.")
|
|
214
|
+
|
|
215
|
+
theta = pi * 2 / u
|
|
216
|
+
phi = pi * 2 / v
|
|
217
|
+
vertices = []
|
|
218
|
+
for i in range(u):
|
|
219
|
+
for j in range(v):
|
|
220
|
+
x = cos(i * theta) * (self.radius_axis + self.radius_pipe * cos(j * phi))
|
|
221
|
+
y = sin(i * theta) * (self.radius_axis + self.radius_pipe * cos(j * phi))
|
|
222
|
+
z = self.radius_pipe * sin(j * phi)
|
|
223
|
+
vertices.append([x, y, z])
|
|
224
|
+
|
|
225
|
+
# transform vertices to torus' plane
|
|
226
|
+
frame = Frame.from_plane(self.plane)
|
|
227
|
+
M = matrix_from_frame(frame)
|
|
228
|
+
vertices = transform_points(vertices, M)
|
|
229
|
+
|
|
230
|
+
faces = []
|
|
231
|
+
for i in range(u):
|
|
232
|
+
ii = (i + 1) % u
|
|
233
|
+
for j in range(v):
|
|
234
|
+
jj = (j + 1) % v
|
|
235
|
+
a = i * v + j
|
|
236
|
+
b = ii * v + j
|
|
237
|
+
c = ii * v + jj
|
|
238
|
+
d = i * v + jj
|
|
239
|
+
faces.append([a, b, c, d])
|
|
240
|
+
|
|
241
|
+
if triangulated:
|
|
242
|
+
triangles = []
|
|
243
|
+
for face in faces:
|
|
244
|
+
if len(face) == 4:
|
|
245
|
+
triangles.append(face[0:3])
|
|
246
|
+
triangles.append([face[0], face[2], face[3]])
|
|
247
|
+
else:
|
|
248
|
+
triangles.append(face)
|
|
249
|
+
faces = triangles
|
|
250
|
+
|
|
251
|
+
vertices = transform_points(vertices, self.transformation)
|
|
252
|
+
|
|
253
|
+
return vertices, faces
|
|
254
|
+
|
|
255
|
+
def to_brep(self):
|
|
256
|
+
"""Returns a BRep representation of the torus.
|
|
257
|
+
|
|
258
|
+
Returns
|
|
259
|
+
-------
|
|
260
|
+
:class:`compas.brep.Brep`
|
|
261
|
+
|
|
262
|
+
"""
|
|
263
|
+
from compas.geometry import Brep
|
|
264
|
+
|
|
265
|
+
return Brep.from_torus(self)
|
|
266
|
+
|
|
267
|
+
# ==========================================================================
|
|
268
|
+
# Transformations
|
|
269
|
+
# ==========================================================================
|
|
270
|
+
|
|
271
|
+
def transform(self, transformation):
|
|
272
|
+
"""Transform the torus.
|
|
273
|
+
|
|
274
|
+
Parameters
|
|
275
|
+
----------
|
|
276
|
+
transformation : :class:`compas.geometry.Transformation`
|
|
277
|
+
The transformation used to transform the Torus.
|
|
278
|
+
|
|
279
|
+
Returns
|
|
280
|
+
-------
|
|
281
|
+
None
|
|
282
|
+
|
|
283
|
+
Examples
|
|
284
|
+
--------
|
|
285
|
+
>>> from compas.geometry import Frame
|
|
286
|
+
>>> from compas.geometry import Transformation
|
|
287
|
+
>>> from compas.geometry import Torus
|
|
288
|
+
>>> torus = Torus(Frame.worldXY(), 5, 2)
|
|
289
|
+
>>> frame = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
|
|
290
|
+
>>> T = Transformation.from_frame(frame)
|
|
291
|
+
>>> torus.transform(T)
|
|
292
|
+
|
|
293
|
+
"""
|
|
294
|
+
self.frame.transform(transformation)
|
compas/geometry/shear.py
ADDED
|
@@ -0,0 +1,115 @@
|
|
|
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_shear
|
|
17
|
+
from compas.geometry import matrix_from_shear_entries
|
|
18
|
+
from compas.itertools import flatten
|
|
19
|
+
from compas.tolerance import TOL
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
class Shear(Transformation):
|
|
23
|
+
"""Class representing a shear transformation.
|
|
24
|
+
|
|
25
|
+
A point P is transformed by the shear matrix into P" such that
|
|
26
|
+
the vector P-P" is parallel to the direction vector and its extent is
|
|
27
|
+
given by the angle of P-P'-P", where P' is the orthogonal projection
|
|
28
|
+
of P onto the shear plane.
|
|
29
|
+
|
|
30
|
+
Parameters
|
|
31
|
+
----------
|
|
32
|
+
matrix : list[list[float]], optional
|
|
33
|
+
A 4x4 matrix (or similar) representing a shear transformation.
|
|
34
|
+
check : bool, optional
|
|
35
|
+
If ``True``, the provided matrix will be checked for validity.
|
|
36
|
+
name : str, optional
|
|
37
|
+
The name of the transformation.
|
|
38
|
+
|
|
39
|
+
Raises
|
|
40
|
+
------
|
|
41
|
+
ValueError
|
|
42
|
+
If ``check`` is ``True`` and the provided transformation matrix is not a shear matrix.
|
|
43
|
+
|
|
44
|
+
Examples
|
|
45
|
+
--------
|
|
46
|
+
>>>
|
|
47
|
+
|
|
48
|
+
"""
|
|
49
|
+
|
|
50
|
+
def __init__(self, matrix=None, check=False, name=None):
|
|
51
|
+
if matrix and check:
|
|
52
|
+
_, shear, _, _, _ = decompose_matrix(matrix)
|
|
53
|
+
if not TOL.is_allclose(flatten(matrix), flatten(matrix_from_shear_entries(shear))):
|
|
54
|
+
raise ValueError("This is not a proper shear matrix.")
|
|
55
|
+
super(Shear, self).__init__(matrix=matrix, name=name)
|
|
56
|
+
|
|
57
|
+
@classmethod
|
|
58
|
+
def from_angle_direction_plane(cls, angle, direction, plane):
|
|
59
|
+
"""Construct a shear transformation from an angle, direction and plane.
|
|
60
|
+
|
|
61
|
+
Parameters
|
|
62
|
+
----------
|
|
63
|
+
angle : float
|
|
64
|
+
The angle in radians.
|
|
65
|
+
direction : [float, float, float] | :class:`compas.geometry.Vector`
|
|
66
|
+
The direction vector as list of 3 numbers.
|
|
67
|
+
It must be orthogonal to the normal vector (i.e. it must lie in the shear plane).
|
|
68
|
+
plane : [point, vector] | :class:`compas.geometry.Plane`
|
|
69
|
+
The shear plane defined by a point and normal.
|
|
70
|
+
|
|
71
|
+
Returns
|
|
72
|
+
-------
|
|
73
|
+
:class:`compas.geometry.Shear`
|
|
74
|
+
The shear transformation object.
|
|
75
|
+
|
|
76
|
+
Raises
|
|
77
|
+
------
|
|
78
|
+
ValueError
|
|
79
|
+
If the shear direction does not lie in the shear plane.
|
|
80
|
+
|
|
81
|
+
Examples
|
|
82
|
+
--------
|
|
83
|
+
>>> from compas.geometry import cross_vectors
|
|
84
|
+
>>> angle = 0.1
|
|
85
|
+
>>> direction = [0.1, 0.2, 0.3]
|
|
86
|
+
>>> point = [4, 3, 1]
|
|
87
|
+
>>> normal = cross_vectors(direction, [1, 0.3, -0.1])
|
|
88
|
+
>>> S = Shear.from_angle_direction_plane(angle, direction, (point, normal))
|
|
89
|
+
|
|
90
|
+
"""
|
|
91
|
+
point, normal = plane
|
|
92
|
+
matrix = matrix_from_shear(angle, direction, point, normal)
|
|
93
|
+
return cls(matrix)
|
|
94
|
+
|
|
95
|
+
@classmethod
|
|
96
|
+
def from_entries(cls, shear_entries):
|
|
97
|
+
"""Construct a shear transformation from the 3 factors for x-y, x-z, and y-z axes.
|
|
98
|
+
|
|
99
|
+
Parameters
|
|
100
|
+
----------
|
|
101
|
+
shear_factors : [float, float, float]
|
|
102
|
+
The 3 shear factors for x-y, x-z, and y-z axes.
|
|
103
|
+
|
|
104
|
+
Returns
|
|
105
|
+
-------
|
|
106
|
+
:class:`compas.geometry.Shear`
|
|
107
|
+
The shear transformation object.
|
|
108
|
+
|
|
109
|
+
Examples
|
|
110
|
+
--------
|
|
111
|
+
>>> S = Shear.from_entries([1, 2, 3])
|
|
112
|
+
|
|
113
|
+
"""
|
|
114
|
+
matrix = matrix_from_shear_entries(shear_entries)
|
|
115
|
+
return cls(matrix)
|
|
File without changes
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from math import cos
|
|
6
|
+
from math import pi
|
|
7
|
+
from math import sin
|
|
8
|
+
|
|
9
|
+
from compas.geometry import Frame
|
|
10
|
+
from compas.geometry import Point
|
|
11
|
+
|
|
12
|
+
from .surface import Surface
|
|
13
|
+
|
|
14
|
+
PI2 = 2 * pi
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
class ConicalSurface(Surface):
|
|
18
|
+
"""A cylindrical surface is defined by a radius and a local coordinate system.
|
|
19
|
+
|
|
20
|
+
Parameters
|
|
21
|
+
----------
|
|
22
|
+
radius : float
|
|
23
|
+
The radius of the cone.
|
|
24
|
+
frame : :class:`Frame`
|
|
25
|
+
The local coordinate system of the cone.
|
|
26
|
+
name : str, optional
|
|
27
|
+
The name of the surface.
|
|
28
|
+
|
|
29
|
+
"""
|
|
30
|
+
|
|
31
|
+
# overwriting the __new__ method is necessary
|
|
32
|
+
# to avoid triggering the plugin mechanism of the base surface class
|
|
33
|
+
def __new__(cls, *args, **kwargs):
|
|
34
|
+
surface = object.__new__(cls)
|
|
35
|
+
surface.__init__(*args, **kwargs)
|
|
36
|
+
return surface
|
|
37
|
+
|
|
38
|
+
DATASCHEMA = {
|
|
39
|
+
"type": "object",
|
|
40
|
+
"properties": {
|
|
41
|
+
"radius": {"type": "number", "minimum": 0},
|
|
42
|
+
"height": {"type": "number", "minimum": 0},
|
|
43
|
+
"frame": Frame.DATASCHEMA,
|
|
44
|
+
},
|
|
45
|
+
"required": ["radius", "height", "frame"],
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
@property
|
|
49
|
+
def __data__(self):
|
|
50
|
+
return {
|
|
51
|
+
"radius": self.radius,
|
|
52
|
+
"height": self.height,
|
|
53
|
+
"frame": self.frame.__data__,
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
@classmethod
|
|
57
|
+
def __from_data__(cls, data):
|
|
58
|
+
return cls(
|
|
59
|
+
radius=data["radius"],
|
|
60
|
+
height=data["height"],
|
|
61
|
+
frame=Frame.__from_data__(data["frame"]),
|
|
62
|
+
)
|
|
63
|
+
|
|
64
|
+
def __init__(self, radius, height, frame=None, name=None):
|
|
65
|
+
super(ConicalSurface, self).__init__(frame=frame, name=name)
|
|
66
|
+
self._radius = None
|
|
67
|
+
self._height = None
|
|
68
|
+
self.radius = radius
|
|
69
|
+
self.height = height
|
|
70
|
+
|
|
71
|
+
def __repr__(self):
|
|
72
|
+
return "{0}(radius={1}, height={2}, frame={3!r})".format(
|
|
73
|
+
type(self).__name__,
|
|
74
|
+
self.radius,
|
|
75
|
+
self.height,
|
|
76
|
+
self.frame,
|
|
77
|
+
)
|
|
78
|
+
|
|
79
|
+
def __eq__(self, other):
|
|
80
|
+
try:
|
|
81
|
+
other_frame = other.frame
|
|
82
|
+
other_radius = other.radius
|
|
83
|
+
other_height = other.height
|
|
84
|
+
except Exception:
|
|
85
|
+
return False
|
|
86
|
+
return self.radius == other_radius and self.height == other_height and self.frame == other_frame
|
|
87
|
+
|
|
88
|
+
# =============================================================================
|
|
89
|
+
# Properties
|
|
90
|
+
# =============================================================================
|
|
91
|
+
|
|
92
|
+
@property
|
|
93
|
+
def center(self):
|
|
94
|
+
return self.frame.point
|
|
95
|
+
|
|
96
|
+
@center.setter
|
|
97
|
+
def center(self, point):
|
|
98
|
+
self.frame.point = point
|
|
99
|
+
|
|
100
|
+
@property
|
|
101
|
+
def radius(self):
|
|
102
|
+
if self._radius is None:
|
|
103
|
+
raise ValueError("The radius of the surface has not been set yet.")
|
|
104
|
+
return self._radius
|
|
105
|
+
|
|
106
|
+
@radius.setter
|
|
107
|
+
def radius(self, radius):
|
|
108
|
+
if radius < 0:
|
|
109
|
+
raise ValueError("The radius of a sphere should be larger than or equal to zero.")
|
|
110
|
+
self._radius = float(radius)
|
|
111
|
+
|
|
112
|
+
@property
|
|
113
|
+
def height(self):
|
|
114
|
+
if self._height is None:
|
|
115
|
+
raise ValueError("The height of the surface has not been set yet.")
|
|
116
|
+
return self._height
|
|
117
|
+
|
|
118
|
+
@height.setter
|
|
119
|
+
def height(self, height):
|
|
120
|
+
if height < 0:
|
|
121
|
+
raise ValueError("The height of the surface should be larger than or equal to zero.")
|
|
122
|
+
self._height = float(height)
|
|
123
|
+
|
|
124
|
+
# =============================================================================
|
|
125
|
+
# Constructors
|
|
126
|
+
# =============================================================================
|
|
127
|
+
|
|
128
|
+
# =============================================================================
|
|
129
|
+
# Conversions
|
|
130
|
+
# =============================================================================
|
|
131
|
+
|
|
132
|
+
# =============================================================================
|
|
133
|
+
# Transformations
|
|
134
|
+
# =============================================================================
|
|
135
|
+
|
|
136
|
+
# =============================================================================
|
|
137
|
+
# Methods
|
|
138
|
+
# =============================================================================
|
|
139
|
+
|
|
140
|
+
def point_at(self, u, v, world=True):
|
|
141
|
+
"""Compute a point on the surface at the given parameters.
|
|
142
|
+
|
|
143
|
+
Parameters
|
|
144
|
+
----------
|
|
145
|
+
u : float
|
|
146
|
+
The first parameter.
|
|
147
|
+
v : float
|
|
148
|
+
The second parameter.
|
|
149
|
+
world : bool, optional
|
|
150
|
+
If ``True``, return the point in world coordinates.
|
|
151
|
+
|
|
152
|
+
Returns
|
|
153
|
+
-------
|
|
154
|
+
:class:`compas.geometry.Point`
|
|
155
|
+
The point at the given parameters.
|
|
156
|
+
|
|
157
|
+
"""
|
|
158
|
+
u = u * PI2
|
|
159
|
+
radius = (1 - v) * self.radius
|
|
160
|
+
x = radius * cos(u)
|
|
161
|
+
y = radius * sin(u)
|
|
162
|
+
z = v * self.height
|
|
163
|
+
point = Point(x, y, z)
|
|
164
|
+
if world:
|
|
165
|
+
point.transform(self.transformation)
|
|
166
|
+
return point
|