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,309 @@
|
|
|
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
|
+
from math import sqrt
|
|
9
|
+
|
|
10
|
+
from compas.geometry import Circle
|
|
11
|
+
from compas.geometry import Frame
|
|
12
|
+
from compas.geometry import Line
|
|
13
|
+
from compas.geometry import Plane
|
|
14
|
+
from compas.geometry import transform_points
|
|
15
|
+
from compas.itertools import pairwise
|
|
16
|
+
|
|
17
|
+
from .shape import Shape
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
class Cone(Shape):
|
|
21
|
+
"""A cone is defined by a frame, radius, and height.
|
|
22
|
+
|
|
23
|
+
The cone is oriented along the z-axis of the frame.
|
|
24
|
+
The base point of the cone (i.e. the centre of the base circle) is at the origin of the frame.
|
|
25
|
+
The entire cone is in the positive z-direction.
|
|
26
|
+
|
|
27
|
+
Parameters
|
|
28
|
+
----------
|
|
29
|
+
frame : :class:`compas.geometry.Frame`, optional
|
|
30
|
+
The local coordinate system of the cone.
|
|
31
|
+
Default is ``None``, in which case the world coordinate system is used.
|
|
32
|
+
radius : float, optional
|
|
33
|
+
The radius of the base of the cone.
|
|
34
|
+
height : float, optional
|
|
35
|
+
The height of the cone along the z-axis of the frame.
|
|
36
|
+
The base of the cone is at the origin of the frame.
|
|
37
|
+
The entire cone is above the XY plane of the frame.
|
|
38
|
+
name : str, optional
|
|
39
|
+
The name of the shape.
|
|
40
|
+
|
|
41
|
+
Attributes
|
|
42
|
+
----------
|
|
43
|
+
area : float, read-only
|
|
44
|
+
The surface area of the cone.
|
|
45
|
+
axis : :class:`compas.geometry.Line`, read-only
|
|
46
|
+
The central axis of the cone.
|
|
47
|
+
base : :class:`compas.geometry.Point`, read-only
|
|
48
|
+
The base point of the cone.
|
|
49
|
+
The base point is at the origin of the local coordinate system.
|
|
50
|
+
circle : :class:`compas.geometry.Circle`, read-only
|
|
51
|
+
The base circle of the cone.
|
|
52
|
+
The center of the circle is at the origin of the local coordinate system.
|
|
53
|
+
diameter : float, read-only
|
|
54
|
+
The diameter of the base circle of the cone.
|
|
55
|
+
frame : :class:`compas.geometry.Frame`
|
|
56
|
+
The local coordinate system of the cone.
|
|
57
|
+
The cone is oriented along the local z-axis.
|
|
58
|
+
height : float
|
|
59
|
+
The height of the cone.
|
|
60
|
+
plane : :class:`compas.geometry.Plane`, read-only
|
|
61
|
+
The plane of the cone.
|
|
62
|
+
The base point of the plane is at the origin of the local coordinate system.
|
|
63
|
+
The normal of the plane is in the direction of the z-axis of the local coordinate system.
|
|
64
|
+
radius : float
|
|
65
|
+
The radius of the base circle of the cone.
|
|
66
|
+
transformation : :class:`compas.geometry.Transformation`
|
|
67
|
+
The transformation of the cone to global coordinates.
|
|
68
|
+
volume : float, read-only
|
|
69
|
+
The volume of the cone.
|
|
70
|
+
|
|
71
|
+
Examples
|
|
72
|
+
--------
|
|
73
|
+
>>> frame = Frame.worldXY()
|
|
74
|
+
>>> cone = Cone(frame=frame, radius=0.3, height=1.0)
|
|
75
|
+
>>> cone = Cone(radius=0.3, height=1.0)
|
|
76
|
+
>>> cone = Cone()
|
|
77
|
+
|
|
78
|
+
"""
|
|
79
|
+
|
|
80
|
+
DATASCHEMA = {
|
|
81
|
+
"type": "object",
|
|
82
|
+
"properties": {
|
|
83
|
+
"radius": {"type": "number", "minimum": 0},
|
|
84
|
+
"height": {"type": "number", "minimum": 0},
|
|
85
|
+
"frame": Frame.DATASCHEMA,
|
|
86
|
+
},
|
|
87
|
+
"required": ["radius", "height", "frame"],
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
@property
|
|
91
|
+
def __data__(self):
|
|
92
|
+
return {
|
|
93
|
+
"radius": self.radius,
|
|
94
|
+
"height": self.height,
|
|
95
|
+
"frame": self.frame.__data__,
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
@classmethod
|
|
99
|
+
def __from_data__(cls, data):
|
|
100
|
+
return cls(
|
|
101
|
+
radius=data["radius"],
|
|
102
|
+
height=data["height"],
|
|
103
|
+
frame=Frame.__from_data__(data["frame"]),
|
|
104
|
+
)
|
|
105
|
+
|
|
106
|
+
def __init__(self, radius, height, frame=None, name=None):
|
|
107
|
+
super(Cone, self).__init__(frame=frame, name=name)
|
|
108
|
+
self._radius = None
|
|
109
|
+
self._height = None
|
|
110
|
+
self.radius = radius
|
|
111
|
+
self.height = height
|
|
112
|
+
|
|
113
|
+
def __repr__(self):
|
|
114
|
+
return "{0}(radius={1}, height={2}, frame={3!r})".format(
|
|
115
|
+
type(self).__name__,
|
|
116
|
+
self.radius,
|
|
117
|
+
self.height,
|
|
118
|
+
self.frame,
|
|
119
|
+
)
|
|
120
|
+
|
|
121
|
+
# ==========================================================================
|
|
122
|
+
# properties
|
|
123
|
+
# ==========================================================================
|
|
124
|
+
|
|
125
|
+
@property
|
|
126
|
+
def radius(self):
|
|
127
|
+
if self._radius is None:
|
|
128
|
+
raise ValueError("The cone radius has not been set.")
|
|
129
|
+
return self._radius
|
|
130
|
+
|
|
131
|
+
@radius.setter
|
|
132
|
+
def radius(self, radius):
|
|
133
|
+
if radius < 0:
|
|
134
|
+
raise ValueError("The cone radius should be larger than or equal to zero.")
|
|
135
|
+
self._radius = float(radius)
|
|
136
|
+
|
|
137
|
+
@property
|
|
138
|
+
def height(self):
|
|
139
|
+
if self._height is None:
|
|
140
|
+
raise ValueError("The cone height has not been set.")
|
|
141
|
+
return self._height
|
|
142
|
+
|
|
143
|
+
@height.setter
|
|
144
|
+
def height(self, height):
|
|
145
|
+
if height < 0:
|
|
146
|
+
raise ValueError("The cone height should be larger than or equal to zero.")
|
|
147
|
+
self._height = float(height)
|
|
148
|
+
|
|
149
|
+
@property
|
|
150
|
+
def axis(self):
|
|
151
|
+
return Line(self.frame.point, self.frame.point + self.frame.normal * self.height)
|
|
152
|
+
|
|
153
|
+
@property
|
|
154
|
+
def circle(self):
|
|
155
|
+
return Circle(self.radius, self.frame)
|
|
156
|
+
|
|
157
|
+
@property
|
|
158
|
+
def diameter(self):
|
|
159
|
+
return 2 * self.radius
|
|
160
|
+
|
|
161
|
+
@property
|
|
162
|
+
def area(self):
|
|
163
|
+
r = self.radius
|
|
164
|
+
h = self.height
|
|
165
|
+
return pi * r * (r + sqrt(h**2 + r**2))
|
|
166
|
+
|
|
167
|
+
@property
|
|
168
|
+
def volume(self):
|
|
169
|
+
r = self.radius
|
|
170
|
+
h = self.height
|
|
171
|
+
return pi * r**2 * (h / 3)
|
|
172
|
+
|
|
173
|
+
# ==========================================================================
|
|
174
|
+
# Constructors
|
|
175
|
+
# ==========================================================================
|
|
176
|
+
|
|
177
|
+
@classmethod
|
|
178
|
+
def from_line_and_radius(cls, line, radius): # type: (...) -> Cone
|
|
179
|
+
"""Construct a cone from a line and a radius.
|
|
180
|
+
|
|
181
|
+
Parameters
|
|
182
|
+
----------
|
|
183
|
+
line : :class:`compas.geometry.Line`
|
|
184
|
+
The axis of the cone.
|
|
185
|
+
radius : float
|
|
186
|
+
The radius of the base circle of the cone.
|
|
187
|
+
|
|
188
|
+
Returns
|
|
189
|
+
-------
|
|
190
|
+
:class:`compas.geometry.Cone`
|
|
191
|
+
The cone.
|
|
192
|
+
|
|
193
|
+
See Also
|
|
194
|
+
--------
|
|
195
|
+
:meth:`Cone.from_circle_and_height`
|
|
196
|
+
|
|
197
|
+
Examples
|
|
198
|
+
--------
|
|
199
|
+
>>> line = Line(Point(0, 0, 0), Point(0, 0, 1))
|
|
200
|
+
>>> cone = Cone.from_line_and_radius(line, 0.3)
|
|
201
|
+
|
|
202
|
+
"""
|
|
203
|
+
frame = Frame.from_plane(Plane(line.midpoint, line.direction))
|
|
204
|
+
return cls(frame=frame, radius=radius, height=line.length)
|
|
205
|
+
|
|
206
|
+
@classmethod
|
|
207
|
+
def from_circle_and_height(cls, circle, height): # type: (...) -> Cone
|
|
208
|
+
"""Construct a cone from a circle and a height.
|
|
209
|
+
|
|
210
|
+
Parameters
|
|
211
|
+
----------
|
|
212
|
+
circle : :class:`compas.geometry.Circle`
|
|
213
|
+
The base circle of the cone.
|
|
214
|
+
height : float
|
|
215
|
+
The height of the cone.
|
|
216
|
+
|
|
217
|
+
Returns
|
|
218
|
+
-------
|
|
219
|
+
:class:`compas.geometry.Cone`
|
|
220
|
+
The cone.
|
|
221
|
+
|
|
222
|
+
See Also
|
|
223
|
+
--------
|
|
224
|
+
:meth:`Cone.from_line_and_radius`
|
|
225
|
+
|
|
226
|
+
Examples
|
|
227
|
+
--------
|
|
228
|
+
>>> circle = Circle(Frame.worldXY(), 0.3)
|
|
229
|
+
>>> cone = Cone.from_circle_and_height(circle, 1.0)
|
|
230
|
+
|
|
231
|
+
"""
|
|
232
|
+
frame = circle.frame
|
|
233
|
+
return cls(frame=frame, radius=circle.radius, height=height)
|
|
234
|
+
|
|
235
|
+
# ==========================================================================
|
|
236
|
+
# Conversions
|
|
237
|
+
# ==========================================================================
|
|
238
|
+
|
|
239
|
+
def to_vertices_and_faces(self, u=16, triangulated=False):
|
|
240
|
+
"""Returns a list of vertices and faces.
|
|
241
|
+
|
|
242
|
+
Parameters
|
|
243
|
+
----------
|
|
244
|
+
u : int, optional
|
|
245
|
+
Number of faces in the "u" direction.
|
|
246
|
+
triangulated: bool, optional
|
|
247
|
+
If True, triangulate the faces.
|
|
248
|
+
|
|
249
|
+
Returns
|
|
250
|
+
-------
|
|
251
|
+
list[list[float]], list[list[int]]
|
|
252
|
+
A list of vertex locations, and a list of faces,
|
|
253
|
+
with each face defined as a list of indices into the list of vertices.
|
|
254
|
+
|
|
255
|
+
"""
|
|
256
|
+
if u < 3:
|
|
257
|
+
raise ValueError("The value for u should be u > 3.")
|
|
258
|
+
|
|
259
|
+
vertices = [[0, 0, 0]]
|
|
260
|
+
a = 2 * pi / u
|
|
261
|
+
radius = self.circle.radius
|
|
262
|
+
for i in range(u):
|
|
263
|
+
x = radius * cos(i * a)
|
|
264
|
+
y = radius * sin(i * a)
|
|
265
|
+
vertices.append([x, y, 0]) # type: ignore
|
|
266
|
+
vertices.append([0, 0, self.height]) # type: ignore
|
|
267
|
+
|
|
268
|
+
faces = []
|
|
269
|
+
first = 0
|
|
270
|
+
last = len(vertices) - 1
|
|
271
|
+
for i, j in pairwise(range(1, last)):
|
|
272
|
+
faces.append([i, j, last])
|
|
273
|
+
faces.append([j, i, first])
|
|
274
|
+
faces.append([last - 1, 1, last])
|
|
275
|
+
faces.append([1, last - 1, first])
|
|
276
|
+
|
|
277
|
+
if triangulated:
|
|
278
|
+
triangles = []
|
|
279
|
+
for face in faces:
|
|
280
|
+
if len(face) == 4:
|
|
281
|
+
triangles.append(face[0:3])
|
|
282
|
+
triangles.append([face[0], face[2], face[3]])
|
|
283
|
+
else:
|
|
284
|
+
triangles.append(face)
|
|
285
|
+
faces = triangles
|
|
286
|
+
|
|
287
|
+
vertices = transform_points(vertices, self.transformation)
|
|
288
|
+
|
|
289
|
+
return vertices, faces
|
|
290
|
+
|
|
291
|
+
def to_brep(self):
|
|
292
|
+
"""Returns a BRep representation of the cone.
|
|
293
|
+
|
|
294
|
+
Returns
|
|
295
|
+
-------
|
|
296
|
+
:class:`compas.brep.Brep`
|
|
297
|
+
|
|
298
|
+
"""
|
|
299
|
+
from compas.geometry import Brep
|
|
300
|
+
|
|
301
|
+
return Brep.from_cone(self)
|
|
302
|
+
|
|
303
|
+
# ==========================================================================
|
|
304
|
+
# Transformations
|
|
305
|
+
# ==========================================================================
|
|
306
|
+
|
|
307
|
+
# ==========================================================================
|
|
308
|
+
# Methods
|
|
309
|
+
# ==========================================================================
|
|
@@ -0,0 +1,355 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from math import cos
|
|
6
|
+
from math import pi
|
|
7
|
+
from math import sin
|
|
8
|
+
|
|
9
|
+
from compas.geometry import Circle
|
|
10
|
+
from compas.geometry import Frame
|
|
11
|
+
from compas.geometry import Line
|
|
12
|
+
from compas.geometry import Plane
|
|
13
|
+
from compas.geometry import transform_points
|
|
14
|
+
|
|
15
|
+
from .shape import Shape
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
class Cylinder(Shape):
|
|
19
|
+
"""A cylinder is defined by a frame, radius, and height.
|
|
20
|
+
|
|
21
|
+
The cylinder is oriented along the z-axis of the frame.
|
|
22
|
+
The base point of the cylinder (i.e. the centre of the base circle) is at the origin of the frame.
|
|
23
|
+
Half of the cylinder is above the local XY plane of the frame, the other half below.
|
|
24
|
+
|
|
25
|
+
Parameters
|
|
26
|
+
----------
|
|
27
|
+
radius : float
|
|
28
|
+
The radius of the cylinder.
|
|
29
|
+
height : float
|
|
30
|
+
The height of the cylinder along the z-axis of the frame.
|
|
31
|
+
Half of the cylinder is above the XY plane of the frame, the other half below.
|
|
32
|
+
frame : :class:`compas.geometry.Frame`, optional
|
|
33
|
+
The local coordinate system, or "frame", of the cylinder.
|
|
34
|
+
Default is ``None``, in which case the world coordinate system is used.
|
|
35
|
+
name : str, optional
|
|
36
|
+
The name of the shape.
|
|
37
|
+
|
|
38
|
+
Attributes
|
|
39
|
+
----------
|
|
40
|
+
area : float, read-only
|
|
41
|
+
The surface area of the cylinder.
|
|
42
|
+
axis : :class:`compas.geometry.Line`, read-only
|
|
43
|
+
The central axis of the cylinder.
|
|
44
|
+
base : :class:`compas.geometry.Point`, read-only
|
|
45
|
+
The base point of the cylinder.
|
|
46
|
+
The base point is at the origin of the local coordinate system.
|
|
47
|
+
circle : :class:`compas.geometry.Circle`, read-only
|
|
48
|
+
The base circle of the cylinder.
|
|
49
|
+
The center of the circle is at the origin of the local coordinate system.
|
|
50
|
+
diameter : float, read-only
|
|
51
|
+
The diameter of the base circle of the cylinder.
|
|
52
|
+
frame : :class:`compas.geometry.Frame`
|
|
53
|
+
The local coordinate system of the cylinder.
|
|
54
|
+
The cylinder is oriented along the local z-axis.
|
|
55
|
+
height : float
|
|
56
|
+
The height of the cylinder.
|
|
57
|
+
plane : :class:`compas.geometry.Plane`, read-only
|
|
58
|
+
The plane of the cylinder.
|
|
59
|
+
The base point of the plane is at the origin of the local coordinate system.
|
|
60
|
+
The normal of the plane is in the direction of the z-axis of the local coordinate system.
|
|
61
|
+
radius : float
|
|
62
|
+
The radius of the base circle of the cylinder.
|
|
63
|
+
transformation : :class:`compas.geometry.Transformation`
|
|
64
|
+
The transformation of the cylinder to global coordinates.
|
|
65
|
+
volume : float, read-only
|
|
66
|
+
The volume of the cylinder.
|
|
67
|
+
|
|
68
|
+
Examples
|
|
69
|
+
--------
|
|
70
|
+
>>> frame = Frame.worldXY()
|
|
71
|
+
>>> cylinder = Cylinder(frame=frame, radius=0.3, heigth=1.0)
|
|
72
|
+
>>> cylinder = Cylinder(radius=0.3, heigth=1.0)
|
|
73
|
+
>>> cylinder = Cylinder()
|
|
74
|
+
|
|
75
|
+
"""
|
|
76
|
+
|
|
77
|
+
DATASCHEMA = {
|
|
78
|
+
"type": "object",
|
|
79
|
+
"properties": {
|
|
80
|
+
"radius": {"type": "number", "minimum": 0},
|
|
81
|
+
"height": {"type": "number", "minimum": 0},
|
|
82
|
+
"frame": Frame.DATASCHEMA,
|
|
83
|
+
},
|
|
84
|
+
"required": ["radius", "height", "frame"],
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
@property
|
|
88
|
+
def __data__(self):
|
|
89
|
+
return {
|
|
90
|
+
"radius": self.radius,
|
|
91
|
+
"height": self.height,
|
|
92
|
+
"frame": self.frame.__data__,
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
@classmethod
|
|
96
|
+
def __from_data__(cls, data):
|
|
97
|
+
return cls(
|
|
98
|
+
radius=data["radius"],
|
|
99
|
+
height=data["height"],
|
|
100
|
+
frame=Frame.__from_data__(data["frame"]),
|
|
101
|
+
)
|
|
102
|
+
|
|
103
|
+
def __init__(self, radius, height, frame=None, name=None):
|
|
104
|
+
super(Cylinder, self).__init__(frame=frame, name=name)
|
|
105
|
+
self._radius = None
|
|
106
|
+
self._height = None
|
|
107
|
+
self.radius = radius
|
|
108
|
+
self.height = height
|
|
109
|
+
|
|
110
|
+
def __repr__(self):
|
|
111
|
+
return "{0}(radius={1}, height={2}, frame={3!r})".format(
|
|
112
|
+
type(self).__name__,
|
|
113
|
+
self.radius,
|
|
114
|
+
self.height,
|
|
115
|
+
self.frame,
|
|
116
|
+
)
|
|
117
|
+
|
|
118
|
+
# ==========================================================================
|
|
119
|
+
# Properties
|
|
120
|
+
# ==========================================================================
|
|
121
|
+
|
|
122
|
+
@property
|
|
123
|
+
def radius(self):
|
|
124
|
+
if self._radius is None:
|
|
125
|
+
raise ValueError("The cylinder radius has not been set.")
|
|
126
|
+
return self._radius
|
|
127
|
+
|
|
128
|
+
@radius.setter
|
|
129
|
+
def radius(self, radius):
|
|
130
|
+
if radius < 0:
|
|
131
|
+
raise ValueError("The cylinder radius should be larger than or equal to zero.")
|
|
132
|
+
self._radius = float(radius)
|
|
133
|
+
|
|
134
|
+
@property
|
|
135
|
+
def height(self):
|
|
136
|
+
if self._height is None:
|
|
137
|
+
raise ValueError("The cylinder height has not been set.")
|
|
138
|
+
return self._height
|
|
139
|
+
|
|
140
|
+
@height.setter
|
|
141
|
+
def height(self, height):
|
|
142
|
+
if height < 0:
|
|
143
|
+
raise ValueError("The cylinder height should be larger than or equal to zero.")
|
|
144
|
+
self._height = float(height)
|
|
145
|
+
|
|
146
|
+
@property
|
|
147
|
+
def axis(self):
|
|
148
|
+
return Line(self.frame.point, self.frame.point + self.frame.normal * self.height)
|
|
149
|
+
|
|
150
|
+
@property
|
|
151
|
+
def base(self):
|
|
152
|
+
return self.frame.point.copy()
|
|
153
|
+
|
|
154
|
+
@property
|
|
155
|
+
def plane(self):
|
|
156
|
+
return Plane(self.frame.point, self.frame.normal)
|
|
157
|
+
|
|
158
|
+
@property
|
|
159
|
+
def circle(self):
|
|
160
|
+
return Circle(radius=self.radius, frame=self.frame)
|
|
161
|
+
|
|
162
|
+
@property
|
|
163
|
+
def diameter(self):
|
|
164
|
+
return 2 * self.radius
|
|
165
|
+
|
|
166
|
+
@property
|
|
167
|
+
def area(self):
|
|
168
|
+
return (self.circle.area * 2) + (self.circle.circumference * self.height)
|
|
169
|
+
|
|
170
|
+
@property
|
|
171
|
+
def volume(self):
|
|
172
|
+
return self.circle.area * self.height
|
|
173
|
+
|
|
174
|
+
# ==========================================================================
|
|
175
|
+
# Constructors
|
|
176
|
+
# ==========================================================================
|
|
177
|
+
|
|
178
|
+
@classmethod
|
|
179
|
+
def from_line_and_radius(cls, line, radius): # type: (...) -> Cylinder
|
|
180
|
+
"""Construct a cylinder from a line and a radius.
|
|
181
|
+
|
|
182
|
+
Parameters
|
|
183
|
+
----------
|
|
184
|
+
line : :class:`compas.geometry.Line`
|
|
185
|
+
The line.
|
|
186
|
+
radius : float
|
|
187
|
+
The radius.
|
|
188
|
+
|
|
189
|
+
Returns
|
|
190
|
+
-------
|
|
191
|
+
:class:`compas.geometry.Cylinder`
|
|
192
|
+
The cylinder.
|
|
193
|
+
|
|
194
|
+
Examples
|
|
195
|
+
--------
|
|
196
|
+
>>> from compas.geometry import Line
|
|
197
|
+
>>> from compas.geometry import Cylinder
|
|
198
|
+
>>> line = Line([0, 0, 0], [0, 0, 1])
|
|
199
|
+
>>> cylinder = Cylinder.from_line_and_radius(line, radius=0.3)
|
|
200
|
+
|
|
201
|
+
"""
|
|
202
|
+
frame = Frame.from_plane(Plane(line.midpoint, line.direction))
|
|
203
|
+
return cls(frame=frame, height=line.length, radius=radius)
|
|
204
|
+
|
|
205
|
+
@classmethod
|
|
206
|
+
def from_circle_and_height(cls, circle, height): # type: (...) -> Cylinder
|
|
207
|
+
"""Construct a cylinder from a circle and a height.
|
|
208
|
+
|
|
209
|
+
Parameters
|
|
210
|
+
----------
|
|
211
|
+
circle : :class:`compas.geometry.Circle`
|
|
212
|
+
The circle.
|
|
213
|
+
height : float
|
|
214
|
+
The height.
|
|
215
|
+
|
|
216
|
+
Returns
|
|
217
|
+
-------
|
|
218
|
+
:class:`compas.geometry.Cylinder`
|
|
219
|
+
The cylinder.
|
|
220
|
+
|
|
221
|
+
Examples
|
|
222
|
+
--------
|
|
223
|
+
>>> from compas.geometry import Circle
|
|
224
|
+
>>> from compas.geometry import Cylinder
|
|
225
|
+
>>> circle = Circle(radius=0.3)
|
|
226
|
+
>>> cylinder = Cylinder.from_circle_and_height(circle, height=1.0)
|
|
227
|
+
|
|
228
|
+
"""
|
|
229
|
+
return cls(frame=circle.frame, height=height, radius=circle.radius)
|
|
230
|
+
|
|
231
|
+
# =============================================================================
|
|
232
|
+
# Conversions
|
|
233
|
+
# =============================================================================
|
|
234
|
+
|
|
235
|
+
def to_vertices_and_faces(self, u=16, triangulated=False):
|
|
236
|
+
"""Returns a list of vertices and faces.
|
|
237
|
+
|
|
238
|
+
Parameters
|
|
239
|
+
----------
|
|
240
|
+
u : int, optional
|
|
241
|
+
Number of faces in the "u" direction.
|
|
242
|
+
triangulated: bool, optional
|
|
243
|
+
If True, triangulate the faces.
|
|
244
|
+
|
|
245
|
+
Returns
|
|
246
|
+
-------
|
|
247
|
+
list[list[float]]
|
|
248
|
+
A list of vertex locations.
|
|
249
|
+
list[list[int]]
|
|
250
|
+
And a list of faces,
|
|
251
|
+
with each face defined as a list of indices into the list of vertices.
|
|
252
|
+
|
|
253
|
+
"""
|
|
254
|
+
if u < 3:
|
|
255
|
+
raise ValueError("The value for u should be u > 3.")
|
|
256
|
+
|
|
257
|
+
vertices = []
|
|
258
|
+
a = 2 * pi / u
|
|
259
|
+
z = self.height / 2
|
|
260
|
+
for i in range(u):
|
|
261
|
+
x = self.circle.radius * cos(i * a)
|
|
262
|
+
y = self.circle.radius * sin(i * a)
|
|
263
|
+
vertices.append([x, y, z])
|
|
264
|
+
vertices.append([x, y, -z])
|
|
265
|
+
# add v in bottom and top's circle center
|
|
266
|
+
vertices.append([0, 0, z])
|
|
267
|
+
vertices.append([0, 0, -z])
|
|
268
|
+
|
|
269
|
+
faces = []
|
|
270
|
+
# side faces
|
|
271
|
+
for i in range(0, u * 2, 2):
|
|
272
|
+
faces.append([i, i + 1, (i + 3) % (u * 2), (i + 2) % (u * 2)])
|
|
273
|
+
# top and bottom circle faces
|
|
274
|
+
for i in range(0, u * 2, 2):
|
|
275
|
+
top = [i, (i + 2) % (u * 2), len(vertices) - 2]
|
|
276
|
+
bottom = [i + 1, (i + 3) % (u * 2), len(vertices) - 1]
|
|
277
|
+
faces.append(top)
|
|
278
|
+
faces.append(bottom[::-1])
|
|
279
|
+
|
|
280
|
+
if triangulated:
|
|
281
|
+
triangles = []
|
|
282
|
+
for face in faces:
|
|
283
|
+
if len(face) == 4:
|
|
284
|
+
triangles.append(face[0:3])
|
|
285
|
+
triangles.append([face[0], face[2], face[3]])
|
|
286
|
+
else:
|
|
287
|
+
triangles.append(face)
|
|
288
|
+
faces = triangles
|
|
289
|
+
|
|
290
|
+
vertices = transform_points(vertices, self.transformation)
|
|
291
|
+
|
|
292
|
+
return vertices, faces
|
|
293
|
+
|
|
294
|
+
def to_brep(self):
|
|
295
|
+
"""Returns a BRep representation of the cylinder.
|
|
296
|
+
|
|
297
|
+
Returns
|
|
298
|
+
-------
|
|
299
|
+
:class:`compas.brep.Brep`
|
|
300
|
+
|
|
301
|
+
"""
|
|
302
|
+
from compas.geometry import Brep
|
|
303
|
+
|
|
304
|
+
return Brep.from_cylinder(self)
|
|
305
|
+
|
|
306
|
+
# =============================================================================
|
|
307
|
+
# Transformations
|
|
308
|
+
# =============================================================================
|
|
309
|
+
|
|
310
|
+
def scale(self, factor):
|
|
311
|
+
"""Scale the cylinder by multiplying the radius and height by a factor.
|
|
312
|
+
|
|
313
|
+
Parameters
|
|
314
|
+
----------
|
|
315
|
+
factor : float
|
|
316
|
+
The scaling factor.
|
|
317
|
+
|
|
318
|
+
Returns
|
|
319
|
+
-------
|
|
320
|
+
None
|
|
321
|
+
|
|
322
|
+
"""
|
|
323
|
+
self.radius *= factor
|
|
324
|
+
self.height *= factor
|
|
325
|
+
|
|
326
|
+
# =============================================================================
|
|
327
|
+
# Methods
|
|
328
|
+
# =============================================================================
|
|
329
|
+
|
|
330
|
+
def contains_point(self, point, tol=1e-6):
|
|
331
|
+
"""Verify if a point is inside the cylinder.
|
|
332
|
+
|
|
333
|
+
Parameters
|
|
334
|
+
----------
|
|
335
|
+
point : :class:`compas.geometry.Point`
|
|
336
|
+
The point.
|
|
337
|
+
tol : float, optional
|
|
338
|
+
The tolerance for the verification.
|
|
339
|
+
|
|
340
|
+
Returns
|
|
341
|
+
-------
|
|
342
|
+
bool
|
|
343
|
+
True if the point is inside the cylinder.
|
|
344
|
+
False otherwise.
|
|
345
|
+
|
|
346
|
+
"""
|
|
347
|
+
point = self.frame.to_local_coordinates(point)
|
|
348
|
+
x, y, z = point.x, point.y, point.z # type: ignore
|
|
349
|
+
|
|
350
|
+
if z > self.height / 2 + tol:
|
|
351
|
+
return False
|
|
352
|
+
if z < -self.height / 2 - tol:
|
|
353
|
+
return False
|
|
354
|
+
|
|
355
|
+
return x**2 + y**2 <= (self.radius + tol) ** 2
|