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,412 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from math import sqrt
|
|
6
|
+
|
|
7
|
+
from compas.geometry import Frame
|
|
8
|
+
from compas.geometry import Point
|
|
9
|
+
from compas.plugins import PluginNotInstalledError
|
|
10
|
+
from compas.plugins import pluggable
|
|
11
|
+
|
|
12
|
+
from .curve import Curve
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
@pluggable(category="factories")
|
|
16
|
+
def new_nurbscurve(cls, *args, **kwargs):
|
|
17
|
+
curve = object.__new__(NurbsCurve)
|
|
18
|
+
curve.__init__(*args, **kwargs)
|
|
19
|
+
return curve
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
@pluggable(category="factories")
|
|
23
|
+
def new_nurbscurve_from_native(cls, *args, **kwargs):
|
|
24
|
+
raise PluginNotInstalledError
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
@pluggable(category="factories")
|
|
28
|
+
def new_nurbscurve_from_parameters(cls, *args, **kwargs):
|
|
29
|
+
raise PluginNotInstalledError
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
@pluggable(category="factories")
|
|
33
|
+
def new_nurbscurve_from_points(cls, *args, **kwargs):
|
|
34
|
+
raise PluginNotInstalledError
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
@pluggable(category="factories")
|
|
38
|
+
def new_nurbscurve_from_interpolation(cls, *args, **kwargs):
|
|
39
|
+
raise PluginNotInstalledError
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
@pluggable(category="factories")
|
|
43
|
+
def new_nurbscurve_from_step(cls, *args, **kwargs):
|
|
44
|
+
raise PluginNotInstalledError
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
class NurbsCurve(Curve):
|
|
48
|
+
"""A NURBS curve is defined by control points, weights, knots, and a degree.
|
|
49
|
+
|
|
50
|
+
Parameters
|
|
51
|
+
----------
|
|
52
|
+
name : str, optional
|
|
53
|
+
The name of the curve.
|
|
54
|
+
|
|
55
|
+
Attributes
|
|
56
|
+
----------
|
|
57
|
+
points : list[:class:`compas.geometry.Point`], read-only
|
|
58
|
+
The control points.
|
|
59
|
+
weights : list[float], read-only
|
|
60
|
+
The weights of the control points.
|
|
61
|
+
knots : list[float], read-only
|
|
62
|
+
The knots, without multiplicity.
|
|
63
|
+
knotsequence : list[float], read-only
|
|
64
|
+
The complete knot vector.
|
|
65
|
+
multiplicity : list[int], read-only
|
|
66
|
+
The multiplicities of the knots.
|
|
67
|
+
continuity : int, read-only
|
|
68
|
+
The degree of continuity of the curve.
|
|
69
|
+
degree : int, read-only
|
|
70
|
+
The degree of the curve.
|
|
71
|
+
order : int, read-only
|
|
72
|
+
The order of the curve (degree + 1).
|
|
73
|
+
|
|
74
|
+
"""
|
|
75
|
+
|
|
76
|
+
def __new__(cls, *args, **kwargs):
|
|
77
|
+
return new_nurbscurve(cls, *args, **kwargs)
|
|
78
|
+
|
|
79
|
+
DATASCHEMA = {
|
|
80
|
+
"type": "object",
|
|
81
|
+
"properties": {
|
|
82
|
+
"points": {"type": "array", "minItems": 2, "items": Point.DATASCHEMA},
|
|
83
|
+
"weights": {"type": "array", "items": {"type": "number"}},
|
|
84
|
+
"knots": {"type": "array", "items": {"type": "number"}},
|
|
85
|
+
"multiplicities": {"type": "array", "items": {"type": "integer"}},
|
|
86
|
+
"degree": {"type": "integer", "exclusiveMinimum": 0},
|
|
87
|
+
"is_periodic": {"type": "boolean"},
|
|
88
|
+
},
|
|
89
|
+
"additionalProperties": False,
|
|
90
|
+
"minProperties": 6,
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
@property
|
|
94
|
+
def __dtype__(self):
|
|
95
|
+
return "compas.geometry/NurbsCurve"
|
|
96
|
+
|
|
97
|
+
@property
|
|
98
|
+
def __data__(self):
|
|
99
|
+
return {
|
|
100
|
+
"points": [point.__data__ for point in self.points],
|
|
101
|
+
"weights": self.weights,
|
|
102
|
+
"knots": self.knots,
|
|
103
|
+
"multiplicities": self.multiplicities,
|
|
104
|
+
"degree": self.degree,
|
|
105
|
+
"is_periodic": self.is_periodic,
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
@classmethod
|
|
109
|
+
def __from_data__(cls, data):
|
|
110
|
+
return cls.from_parameters(
|
|
111
|
+
data["points"],
|
|
112
|
+
data["weights"],
|
|
113
|
+
data["knots"],
|
|
114
|
+
data["multiplicities"],
|
|
115
|
+
data["degree"],
|
|
116
|
+
data["is_periodic"],
|
|
117
|
+
)
|
|
118
|
+
|
|
119
|
+
def __init__(self, name=None):
|
|
120
|
+
super(NurbsCurve, self).__init__(name=name)
|
|
121
|
+
|
|
122
|
+
def __repr__(self):
|
|
123
|
+
return "{0}(points={1!r}, weigths={2}, knots={3}, multiplicities={4}, degree={5}, is_periodic={6})".format(
|
|
124
|
+
type(self).__name__,
|
|
125
|
+
self.points,
|
|
126
|
+
self.weights,
|
|
127
|
+
self.knots,
|
|
128
|
+
self.multiplicities,
|
|
129
|
+
self.degree,
|
|
130
|
+
self.is_periodic,
|
|
131
|
+
)
|
|
132
|
+
|
|
133
|
+
# ==============================================================================
|
|
134
|
+
# Properties
|
|
135
|
+
# ==============================================================================
|
|
136
|
+
|
|
137
|
+
@property
|
|
138
|
+
def points(self):
|
|
139
|
+
raise NotImplementedError
|
|
140
|
+
|
|
141
|
+
@property
|
|
142
|
+
def weights(self):
|
|
143
|
+
raise NotImplementedError
|
|
144
|
+
|
|
145
|
+
@property
|
|
146
|
+
def knots(self):
|
|
147
|
+
raise NotImplementedError
|
|
148
|
+
|
|
149
|
+
@property
|
|
150
|
+
def multiplicities(self):
|
|
151
|
+
raise NotImplementedError
|
|
152
|
+
|
|
153
|
+
@property
|
|
154
|
+
def knotvector(self):
|
|
155
|
+
raise NotImplementedError
|
|
156
|
+
|
|
157
|
+
@property
|
|
158
|
+
def continuity(self):
|
|
159
|
+
raise NotImplementedError
|
|
160
|
+
|
|
161
|
+
@property
|
|
162
|
+
def degree(self):
|
|
163
|
+
raise NotImplementedError
|
|
164
|
+
|
|
165
|
+
@property
|
|
166
|
+
def order(self):
|
|
167
|
+
return self.degree + 1
|
|
168
|
+
|
|
169
|
+
@property
|
|
170
|
+
def is_rational(self):
|
|
171
|
+
raise NotImplementedError
|
|
172
|
+
|
|
173
|
+
# ==============================================================================
|
|
174
|
+
# Constructors
|
|
175
|
+
# ==============================================================================
|
|
176
|
+
|
|
177
|
+
@classmethod
|
|
178
|
+
def from_native(cls, curve):
|
|
179
|
+
"""Construct a NURBS curve from a curve object.
|
|
180
|
+
|
|
181
|
+
Parameters
|
|
182
|
+
----------
|
|
183
|
+
curve : :class:`Rhino.Geometry.NurbsCurve`
|
|
184
|
+
A *Rhino* curve object.
|
|
185
|
+
|
|
186
|
+
Returns
|
|
187
|
+
-------
|
|
188
|
+
:class:`compas.geometry.NurbsCurve`
|
|
189
|
+
A COMPAS NURBS curve.
|
|
190
|
+
|
|
191
|
+
"""
|
|
192
|
+
return new_nurbscurve_from_native(cls, curve)
|
|
193
|
+
|
|
194
|
+
@classmethod
|
|
195
|
+
def from_step(cls, filepath):
|
|
196
|
+
"""Load a NURBS curve from an STP file.
|
|
197
|
+
|
|
198
|
+
Parameters
|
|
199
|
+
----------
|
|
200
|
+
filepath : str
|
|
201
|
+
The path to the file.
|
|
202
|
+
|
|
203
|
+
Returns
|
|
204
|
+
-------
|
|
205
|
+
:class:`compas.geometry.NurbsCurve`
|
|
206
|
+
"""
|
|
207
|
+
return new_nurbscurve_from_step(cls, filepath)
|
|
208
|
+
|
|
209
|
+
@classmethod
|
|
210
|
+
def from_parameters(cls, points, weights, knots, multiplicities, degree, is_periodic=False):
|
|
211
|
+
"""Construct a NURBS curve from explicit curve parameters.
|
|
212
|
+
|
|
213
|
+
Parameters
|
|
214
|
+
----------
|
|
215
|
+
points : list[[float, float, float] | :class:`compas.geometry.Point`]
|
|
216
|
+
The control points.
|
|
217
|
+
weights : list[float]
|
|
218
|
+
The weights of the control points.
|
|
219
|
+
knots : list[float]
|
|
220
|
+
The curve knots, without multiplicity.
|
|
221
|
+
multiplicities : list[int]
|
|
222
|
+
Multiplicity of the knots.
|
|
223
|
+
degree : int
|
|
224
|
+
Degree of the curve.
|
|
225
|
+
is_periodic : bool, optional
|
|
226
|
+
Flag indicating that the curve is periodic.
|
|
227
|
+
|
|
228
|
+
Returns
|
|
229
|
+
-------
|
|
230
|
+
:class:`compas.geometry.NurbsCurve`
|
|
231
|
+
|
|
232
|
+
"""
|
|
233
|
+
return new_nurbscurve_from_parameters(cls, points, weights, knots, multiplicities, degree, is_periodic=False)
|
|
234
|
+
|
|
235
|
+
@classmethod
|
|
236
|
+
def from_points(cls, points, degree=3):
|
|
237
|
+
"""Construct a NURBS curve from control points.
|
|
238
|
+
|
|
239
|
+
Parameters
|
|
240
|
+
----------
|
|
241
|
+
points : list[[float, float, float] | :class:`compas.geometry.Point`]
|
|
242
|
+
The control points.
|
|
243
|
+
degree : int, optional
|
|
244
|
+
The degree of the curve.
|
|
245
|
+
|
|
246
|
+
Returns
|
|
247
|
+
-------
|
|
248
|
+
:class:`compas.geometry.NurbsCurve`
|
|
249
|
+
|
|
250
|
+
"""
|
|
251
|
+
return new_nurbscurve_from_points(cls, points, degree=degree)
|
|
252
|
+
|
|
253
|
+
@classmethod
|
|
254
|
+
def from_interpolation(cls, points, precision=1e-3):
|
|
255
|
+
"""Construct a NURBS curve by interpolating a set of points.
|
|
256
|
+
|
|
257
|
+
Parameters
|
|
258
|
+
----------
|
|
259
|
+
points : list[[float, float, float] | :class:`compas.geometry.Point`]
|
|
260
|
+
A list of interpolation points.
|
|
261
|
+
precision : int, optional
|
|
262
|
+
The desired precision of the interpolation.
|
|
263
|
+
|
|
264
|
+
Returns
|
|
265
|
+
-------
|
|
266
|
+
:class:`compas.geometry.NurbsCurve`
|
|
267
|
+
|
|
268
|
+
"""
|
|
269
|
+
return new_nurbscurve_from_interpolation(cls, points, precision=1e-3)
|
|
270
|
+
|
|
271
|
+
@classmethod
|
|
272
|
+
def from_arc(cls, arc):
|
|
273
|
+
"""Construct a NURBS curve from an arc.
|
|
274
|
+
|
|
275
|
+
Parameters
|
|
276
|
+
----------
|
|
277
|
+
arc : :class:`compas.geometry.Arc`
|
|
278
|
+
|
|
279
|
+
Returns
|
|
280
|
+
-------
|
|
281
|
+
:class:`compas.geometry.NurbsCurve`
|
|
282
|
+
|
|
283
|
+
"""
|
|
284
|
+
raise NotImplementedError
|
|
285
|
+
|
|
286
|
+
@classmethod
|
|
287
|
+
def from_circle(cls, circle):
|
|
288
|
+
"""Construct a NURBS curve from a circle.
|
|
289
|
+
|
|
290
|
+
Parameters
|
|
291
|
+
----------
|
|
292
|
+
circle : :class:`compas.geometry.Circle`
|
|
293
|
+
|
|
294
|
+
Returns
|
|
295
|
+
-------
|
|
296
|
+
:class:`compas.geometry.NurbsCurve`
|
|
297
|
+
|
|
298
|
+
"""
|
|
299
|
+
frame = Frame.from_plane(circle.plane)
|
|
300
|
+
w = 0.5 * sqrt(2)
|
|
301
|
+
dx = frame.xaxis * circle.radius
|
|
302
|
+
dy = frame.yaxis * circle.radius
|
|
303
|
+
points = [
|
|
304
|
+
frame.point - dy,
|
|
305
|
+
frame.point - dy - dx,
|
|
306
|
+
frame.point - dx,
|
|
307
|
+
frame.point + dy - dx,
|
|
308
|
+
frame.point + dy,
|
|
309
|
+
frame.point + dy + dx,
|
|
310
|
+
frame.point + dx,
|
|
311
|
+
frame.point - dy + dx,
|
|
312
|
+
frame.point - dy,
|
|
313
|
+
]
|
|
314
|
+
knots = [0, 1 / 4, 1 / 2, 3 / 4, 1]
|
|
315
|
+
mults = [3, 2, 2, 2, 3]
|
|
316
|
+
weights = [1, w, 1, w, 1, w, 1, w, 1]
|
|
317
|
+
return cls.from_parameters(points=points, weights=weights, knots=knots, multiplicities=mults, degree=2)
|
|
318
|
+
|
|
319
|
+
@classmethod
|
|
320
|
+
def from_ellipse(cls, ellipse):
|
|
321
|
+
"""Construct a NURBS curve from an ellipse.
|
|
322
|
+
|
|
323
|
+
Parameters
|
|
324
|
+
----------
|
|
325
|
+
ellipse : :class:`compas.geometry.Ellipse`
|
|
326
|
+
|
|
327
|
+
Returns
|
|
328
|
+
-------
|
|
329
|
+
:class:`compas.geometry.NurbsCurve`
|
|
330
|
+
|
|
331
|
+
"""
|
|
332
|
+
frame = Frame.from_plane(ellipse.plane)
|
|
333
|
+
frame = Frame.worldXY()
|
|
334
|
+
w = 0.5 * sqrt(2)
|
|
335
|
+
dx = frame.xaxis * ellipse.major
|
|
336
|
+
dy = frame.yaxis * ellipse.minor
|
|
337
|
+
points = [
|
|
338
|
+
frame.point - dy,
|
|
339
|
+
frame.point - dy - dx,
|
|
340
|
+
frame.point - dx,
|
|
341
|
+
frame.point + dy - dx,
|
|
342
|
+
frame.point + dy,
|
|
343
|
+
frame.point + dy + dx,
|
|
344
|
+
frame.point + dx,
|
|
345
|
+
frame.point - dy + dx,
|
|
346
|
+
frame.point - dy,
|
|
347
|
+
]
|
|
348
|
+
knots = [0, 1 / 4, 1 / 2, 3 / 4, 1]
|
|
349
|
+
mults = [3, 2, 2, 2, 3]
|
|
350
|
+
weights = [1, w, 1, w, 1, w, 1, w, 1]
|
|
351
|
+
return cls.from_parameters(points=points, weights=weights, knots=knots, multiplicities=mults, degree=2)
|
|
352
|
+
|
|
353
|
+
@classmethod
|
|
354
|
+
def from_line(cls, line):
|
|
355
|
+
"""Construct a NURBS curve from a line.
|
|
356
|
+
|
|
357
|
+
Parameters
|
|
358
|
+
----------
|
|
359
|
+
line : :class:`compas.geometry.Line`
|
|
360
|
+
|
|
361
|
+
Returns
|
|
362
|
+
-------
|
|
363
|
+
:class:`compas.geometry.NurbsCurve`
|
|
364
|
+
|
|
365
|
+
"""
|
|
366
|
+
return cls.from_parameters(
|
|
367
|
+
points=[line.start, line.end],
|
|
368
|
+
weights=[1.0, 1.0],
|
|
369
|
+
knots=[0.0, 1.0],
|
|
370
|
+
multiplicities=[2, 2],
|
|
371
|
+
degree=1,
|
|
372
|
+
)
|
|
373
|
+
|
|
374
|
+
# ==============================================================================
|
|
375
|
+
# Conversions
|
|
376
|
+
# ==============================================================================
|
|
377
|
+
|
|
378
|
+
# ==============================================================================
|
|
379
|
+
# Methods
|
|
380
|
+
# ==============================================================================
|
|
381
|
+
|
|
382
|
+
def copy(self):
|
|
383
|
+
"""Make an independent copy of the current curve.
|
|
384
|
+
|
|
385
|
+
Returns
|
|
386
|
+
-------
|
|
387
|
+
:class:`compas.geometry.NurbsCurve`
|
|
388
|
+
|
|
389
|
+
"""
|
|
390
|
+
return NurbsCurve.from_parameters(
|
|
391
|
+
self.points,
|
|
392
|
+
self.weights,
|
|
393
|
+
self.knots,
|
|
394
|
+
self.multiplicities,
|
|
395
|
+
self.degree,
|
|
396
|
+
self.is_periodic,
|
|
397
|
+
)
|
|
398
|
+
|
|
399
|
+
def insert_knot(self):
|
|
400
|
+
pass
|
|
401
|
+
|
|
402
|
+
def refine_knot(self):
|
|
403
|
+
pass
|
|
404
|
+
|
|
405
|
+
def remove_knot(self):
|
|
406
|
+
pass
|
|
407
|
+
|
|
408
|
+
def elevate_degree(self):
|
|
409
|
+
pass
|
|
410
|
+
|
|
411
|
+
def reduce_degree(self):
|
|
412
|
+
pass
|
|
@@ -0,0 +1,256 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from compas.geometry import Frame
|
|
6
|
+
from compas.geometry import Point
|
|
7
|
+
from compas.geometry import Vector
|
|
8
|
+
|
|
9
|
+
from .conic import Conic
|
|
10
|
+
from .line import Line
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
class Parabola(Conic):
|
|
14
|
+
"""
|
|
15
|
+
A parabola is defined by a plane and a major and minor axis.
|
|
16
|
+
The origin of the coordinate frame is the center of the parabola.
|
|
17
|
+
|
|
18
|
+
The parabola in this implementation is based on the equation ``y = a * x**2``.
|
|
19
|
+
Therefore it will have the y axis of the coordinate frame as its axis of symmetry.
|
|
20
|
+
|
|
21
|
+
Parameters
|
|
22
|
+
----------
|
|
23
|
+
focal : float
|
|
24
|
+
The focal length of the parabola.
|
|
25
|
+
frame : :class:`compas.geometry.Frame`
|
|
26
|
+
The coordinate frame of the parabola.
|
|
27
|
+
name : str, optional
|
|
28
|
+
The name of the parabola.
|
|
29
|
+
|
|
30
|
+
Attributes
|
|
31
|
+
----------
|
|
32
|
+
frame : :class:`compas.geometry.Frame`
|
|
33
|
+
The coordinate frame of the parabola.
|
|
34
|
+
transformation : :class:`Transformation`, read-only
|
|
35
|
+
The transformation from the local coordinate system of the parabola (:attr:`frame`) to the world coordinate system.
|
|
36
|
+
focal : float
|
|
37
|
+
The focal length of the parabola.
|
|
38
|
+
plane : :class:`compas.geometry.Plane`, read-only
|
|
39
|
+
The plane of the parabola.
|
|
40
|
+
latus : :class:`compas.geometry.Point`, read-only
|
|
41
|
+
The latus rectum of the parabola.
|
|
42
|
+
eccentricity : float, read-only
|
|
43
|
+
The eccentricity of a parabola is between 0 and 1.
|
|
44
|
+
focus : :class:`compas.geometry.Point`, read-only
|
|
45
|
+
The focus point of the parabola.
|
|
46
|
+
directix : :class:`compas.geometry.Line`, read-only
|
|
47
|
+
The directix is the line perpendicular to the y axis of the parabola frame
|
|
48
|
+
at a distance ``d = + major / eccentricity`` from the origin of the parabola frame.
|
|
49
|
+
is_closed : bool, read-only
|
|
50
|
+
False.
|
|
51
|
+
is_periodic : bool, read-only
|
|
52
|
+
False.
|
|
53
|
+
|
|
54
|
+
See Also
|
|
55
|
+
--------
|
|
56
|
+
:class:`compas.geometry.Ellipse`, :class:`compas.geometry.Hyperbola`, :class:`compas.geometry.Circle`
|
|
57
|
+
|
|
58
|
+
Examples
|
|
59
|
+
--------
|
|
60
|
+
Construct a parabola in the world XY plane.
|
|
61
|
+
|
|
62
|
+
>>> from compas.geometry import Frame, Parabola
|
|
63
|
+
>>> parabola = Parabola(focal=3, frame=Frame.worldXY())
|
|
64
|
+
>>> parabola = Parabola(focal=3)
|
|
65
|
+
|
|
66
|
+
Construct a parabola such that the Z axis of its frame aligns with a given line.
|
|
67
|
+
|
|
68
|
+
>>> from compas.geometry import Frame, Line, Parabola
|
|
69
|
+
>>> line = Line([0, 0, 0], [1, 1, 1])
|
|
70
|
+
>>> plane = Plane(line.end, line.direction)
|
|
71
|
+
>>> frame = Frame.from_plane(plane)
|
|
72
|
+
>>> parabola = Parabola(focal=3, frame=frame)
|
|
73
|
+
|
|
74
|
+
Visualize the parabola with the COMPAS viewer.
|
|
75
|
+
|
|
76
|
+
>>> from compas_viewer import Viewer # doctest: +SKIP
|
|
77
|
+
>>> viewer = Viewer() # doctest: +SKIP
|
|
78
|
+
>>> viewer.scene.add(line) # doctest: +SKIP
|
|
79
|
+
>>> viewer.scene.add(parabola) # doctest: +SKIP
|
|
80
|
+
>>> viewer.scene.add(parabola.frame) # doctest: +SKIP
|
|
81
|
+
>>> viewer.show() # doctest: +SKIP
|
|
82
|
+
|
|
83
|
+
"""
|
|
84
|
+
|
|
85
|
+
DATASCHEMA = {
|
|
86
|
+
"type": "object",
|
|
87
|
+
"properties": {
|
|
88
|
+
"focal": {"type": "number", "minimum": 0},
|
|
89
|
+
"frame": Frame.DATASCHEMA,
|
|
90
|
+
},
|
|
91
|
+
"required": ["focal", "frame"],
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
@property
|
|
95
|
+
def __data__(self):
|
|
96
|
+
return {"focal": self.focal, "frame": self.frame.__data__}
|
|
97
|
+
|
|
98
|
+
@classmethod
|
|
99
|
+
def __from_data__(cls, data):
|
|
100
|
+
return cls(
|
|
101
|
+
focal=data["focal"],
|
|
102
|
+
frame=Frame.__from_data__(data["frame"]),
|
|
103
|
+
)
|
|
104
|
+
|
|
105
|
+
def __init__(self, focal, frame=None, name=None):
|
|
106
|
+
super(Parabola, self).__init__(frame=frame, name=name)
|
|
107
|
+
self._focal = None
|
|
108
|
+
self.focal = focal
|
|
109
|
+
|
|
110
|
+
def __repr__(self):
|
|
111
|
+
return "{0}(focal={1}, frame={2!r})".format(
|
|
112
|
+
type(self).__name__,
|
|
113
|
+
self.focal,
|
|
114
|
+
self.frame,
|
|
115
|
+
)
|
|
116
|
+
|
|
117
|
+
def __eq__(self, other):
|
|
118
|
+
try:
|
|
119
|
+
return self.focal == other.focal and self.frame == other.frame
|
|
120
|
+
except AttributeError:
|
|
121
|
+
return False
|
|
122
|
+
|
|
123
|
+
# ==========================================================================
|
|
124
|
+
# properties
|
|
125
|
+
# ==========================================================================
|
|
126
|
+
|
|
127
|
+
@property
|
|
128
|
+
def focal(self):
|
|
129
|
+
if self._focal is None:
|
|
130
|
+
raise ValueError("The focal length of the parabola is not set.")
|
|
131
|
+
return self._focal
|
|
132
|
+
|
|
133
|
+
@focal.setter
|
|
134
|
+
def focal(self, focal):
|
|
135
|
+
self._focal = focal
|
|
136
|
+
|
|
137
|
+
@property
|
|
138
|
+
def a(self):
|
|
139
|
+
return 1 / (4 * self.focal)
|
|
140
|
+
|
|
141
|
+
@a.setter
|
|
142
|
+
def a(self, a):
|
|
143
|
+
self.focal = 1 / (4 * a)
|
|
144
|
+
|
|
145
|
+
@property
|
|
146
|
+
def eccentricity(self):
|
|
147
|
+
return 1
|
|
148
|
+
|
|
149
|
+
@property
|
|
150
|
+
def latus(self):
|
|
151
|
+
return 2 * self.focal
|
|
152
|
+
|
|
153
|
+
@property
|
|
154
|
+
def focus(self):
|
|
155
|
+
return self.frame.point + self.frame.yaxis * self.focal
|
|
156
|
+
|
|
157
|
+
@property
|
|
158
|
+
def vertex(self):
|
|
159
|
+
return self.frame.point
|
|
160
|
+
|
|
161
|
+
@property
|
|
162
|
+
def directix(self):
|
|
163
|
+
point = self.frame.point + self.frame.yaxis * -self.focal
|
|
164
|
+
return Line(point, point + self.frame.xaxis)
|
|
165
|
+
|
|
166
|
+
@property
|
|
167
|
+
def is_closed(self):
|
|
168
|
+
return False
|
|
169
|
+
|
|
170
|
+
@property
|
|
171
|
+
def is_periodic(self):
|
|
172
|
+
return False
|
|
173
|
+
|
|
174
|
+
# ==========================================================================
|
|
175
|
+
# Constructors
|
|
176
|
+
# ==========================================================================
|
|
177
|
+
|
|
178
|
+
# ==========================================================================
|
|
179
|
+
# Methods
|
|
180
|
+
# ==========================================================================
|
|
181
|
+
|
|
182
|
+
def point_at(self, t, world=True):
|
|
183
|
+
"""
|
|
184
|
+
Point at the parameter.
|
|
185
|
+
|
|
186
|
+
Parameters
|
|
187
|
+
----------
|
|
188
|
+
t : float
|
|
189
|
+
The curve parameter.
|
|
190
|
+
world : bool, optional
|
|
191
|
+
If ``True``, the point is returned in world coordinates.
|
|
192
|
+
|
|
193
|
+
Returns
|
|
194
|
+
-------
|
|
195
|
+
:class:`compas_future.geometry.Point`
|
|
196
|
+
|
|
197
|
+
"""
|
|
198
|
+
x = t
|
|
199
|
+
y = self.a * x**2
|
|
200
|
+
z = 0
|
|
201
|
+
point = Point(x, y, z)
|
|
202
|
+
if world:
|
|
203
|
+
point.transform(self.transformation)
|
|
204
|
+
return point
|
|
205
|
+
|
|
206
|
+
def tangent_at(self, t, world=True):
|
|
207
|
+
"""
|
|
208
|
+
Tangent vector at the parameter.
|
|
209
|
+
|
|
210
|
+
Parameters
|
|
211
|
+
----------
|
|
212
|
+
t : float
|
|
213
|
+
The curve parameter.
|
|
214
|
+
world : bool, optional
|
|
215
|
+
If ``True``, the tangent vector is returned in world coordinates.
|
|
216
|
+
|
|
217
|
+
Returns
|
|
218
|
+
-------
|
|
219
|
+
:class:`compas_future.geometry.Vector`
|
|
220
|
+
|
|
221
|
+
"""
|
|
222
|
+
x0 = t
|
|
223
|
+
y0 = self.a * t**2
|
|
224
|
+
x = 2 * t
|
|
225
|
+
y = 2 * self.a * x0 * x - y0
|
|
226
|
+
tangent = Vector(x - x0, y - y0, 0)
|
|
227
|
+
tangent.unitize()
|
|
228
|
+
if world:
|
|
229
|
+
tangent.transform(self.transformation)
|
|
230
|
+
return tangent
|
|
231
|
+
|
|
232
|
+
def normal_at(self, t, world=True):
|
|
233
|
+
"""
|
|
234
|
+
Normal at a specific normalized parameter.
|
|
235
|
+
|
|
236
|
+
Parameters
|
|
237
|
+
----------
|
|
238
|
+
t : float
|
|
239
|
+
The curve parameter.
|
|
240
|
+
world : bool, optional
|
|
241
|
+
If ``True``, the normal vector is returned in world coordinates.
|
|
242
|
+
|
|
243
|
+
Returns
|
|
244
|
+
-------
|
|
245
|
+
:class:`compas_future.geometry.Vector`
|
|
246
|
+
|
|
247
|
+
"""
|
|
248
|
+
x0 = t
|
|
249
|
+
y0 = self.a * t**2
|
|
250
|
+
x = 2 * t
|
|
251
|
+
y = 2 * self.a * x0 * x - y0
|
|
252
|
+
normal = Vector(y0 - y, x - x0, 0)
|
|
253
|
+
normal.unitize()
|
|
254
|
+
if world:
|
|
255
|
+
normal.transform(self.transformation)
|
|
256
|
+
return normal
|