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
compas/tolerance.py
ADDED
|
@@ -0,0 +1,879 @@
|
|
|
1
|
+
"""
|
|
2
|
+
The tolerance module provides functionality to deal with tolerances consistently across all other COMPAS packages.
|
|
3
|
+
"""
|
|
4
|
+
|
|
5
|
+
from __future__ import absolute_import
|
|
6
|
+
from __future__ import division
|
|
7
|
+
from __future__ import print_function
|
|
8
|
+
|
|
9
|
+
from decimal import Decimal
|
|
10
|
+
|
|
11
|
+
import compas
|
|
12
|
+
from compas.data import Data
|
|
13
|
+
|
|
14
|
+
__all__ = ["Tolerance", "TOL"]
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
class Tolerance(Data):
|
|
18
|
+
"""Tolerance settings for geometric operations.
|
|
19
|
+
|
|
20
|
+
Parameters
|
|
21
|
+
----------
|
|
22
|
+
unit : {"M", "MM"}, optional
|
|
23
|
+
The unit of the tolerance settings.
|
|
24
|
+
name : str, optional
|
|
25
|
+
The name of the tolerance settings.
|
|
26
|
+
|
|
27
|
+
Attributes
|
|
28
|
+
----------
|
|
29
|
+
unit : {"M", "MM"}
|
|
30
|
+
The unit of the tolerance settings.
|
|
31
|
+
absolute : float
|
|
32
|
+
The absolute tolerance.
|
|
33
|
+
relative : float
|
|
34
|
+
The relative tolerance.
|
|
35
|
+
angular : float
|
|
36
|
+
The angular tolerance.
|
|
37
|
+
approximation : float
|
|
38
|
+
The tolerance used in approximation processes.
|
|
39
|
+
precision : int
|
|
40
|
+
The precision used when converting numbers to strings.
|
|
41
|
+
Positive numbers correspond to the number of digits after the decimal point.
|
|
42
|
+
Negative numbers correspond to the number of digits before the decimal point.
|
|
43
|
+
Zero corresponds to integer precision.
|
|
44
|
+
Therefore, the higher the number the higher the precision.
|
|
45
|
+
lineardeflection : float
|
|
46
|
+
The maximum distance between a curve or surface and its polygonal approximation.
|
|
47
|
+
|
|
48
|
+
Notes
|
|
49
|
+
-----
|
|
50
|
+
The absolute tolerance is used to determine when a number is small enough to be considered zero.
|
|
51
|
+
The relative tolerance determines the allowable deviation between two values for the values to be considered equal.
|
|
52
|
+
The relative tolerance is defined as a fraction of one of the two values.
|
|
53
|
+
This value is called the "true value".
|
|
54
|
+
By convention, the second value is considered the "true value" by the comparison functions of this class.
|
|
55
|
+
|
|
56
|
+
The :class:`compas.tolerance.Tolerance` class is implemented using a "singleton" pattern and can therefore have only 1 (one) instance per context.
|
|
57
|
+
Usage of :attr:`compas.tolerance.TOL` outside of :mod:`compas` internals is therefore deprecated.
|
|
58
|
+
|
|
59
|
+
Examples
|
|
60
|
+
--------
|
|
61
|
+
>>> tol = Tolerance()
|
|
62
|
+
>>> tol.unit
|
|
63
|
+
'M'
|
|
64
|
+
>>> tol.absolute
|
|
65
|
+
1e-09
|
|
66
|
+
>>> tol.relative
|
|
67
|
+
1e-06
|
|
68
|
+
>>> tol.angular
|
|
69
|
+
1e-06
|
|
70
|
+
|
|
71
|
+
"""
|
|
72
|
+
|
|
73
|
+
_instance = None
|
|
74
|
+
_is_inited = False
|
|
75
|
+
|
|
76
|
+
SUPPORTED_UNITS = ["M", "MM"]
|
|
77
|
+
"""{"M", "MM"}: Default tolerances are defined in relation to length units.
|
|
78
|
+
|
|
79
|
+
Currently, only meters ("M") and millimeters ("MM") are supported.
|
|
80
|
+
|
|
81
|
+
"""
|
|
82
|
+
|
|
83
|
+
ABSOLUTE = 1e-9
|
|
84
|
+
"""float: Determines when a number is small enough to be considered zero.
|
|
85
|
+
"""
|
|
86
|
+
|
|
87
|
+
RELATIVE = 1e-6
|
|
88
|
+
"""float: Determines the accuracy of comparing a "computed value" to a "true value", as a fraction of the "true value".
|
|
89
|
+
"""
|
|
90
|
+
|
|
91
|
+
ANGULAR = 1e-6
|
|
92
|
+
"""float: An absolute value that determines when the difference between two angles is small enough to be considered zero.
|
|
93
|
+
"""
|
|
94
|
+
|
|
95
|
+
APPROXIMATION = 1e-3
|
|
96
|
+
"""float: The tolerance used in approximation processes.
|
|
97
|
+
"""
|
|
98
|
+
|
|
99
|
+
PRECISION = 3
|
|
100
|
+
"""int: The precision used when converting numbers to strings.
|
|
101
|
+
|
|
102
|
+
The precision used when converting numbers to strings.
|
|
103
|
+
Positive numbers correspond to the number of digits after the decimal point.
|
|
104
|
+
Negative numbers correspond to the number of digits before the decimal point.
|
|
105
|
+
Zero precision is not allowed.
|
|
106
|
+
|
|
107
|
+
"""
|
|
108
|
+
|
|
109
|
+
LINEARDEFLECTION = 1e-3
|
|
110
|
+
"""float: The maximum "distance" deviation between a curve or surface and its polygonal approximation.
|
|
111
|
+
|
|
112
|
+
This is used by the viewer to determine the mesh and polyline resolution of curves and surfaces for visualisation.
|
|
113
|
+
|
|
114
|
+
"""
|
|
115
|
+
|
|
116
|
+
ANGULARDEFLECTION = 1e-1
|
|
117
|
+
"""float: The maximum "curvature" deviation between a curve or surface and its polygonal approximation.
|
|
118
|
+
|
|
119
|
+
This is used by the viewer to determine the mesh and polyline resolution of curves and surfaces for visualisation.
|
|
120
|
+
|
|
121
|
+
"""
|
|
122
|
+
|
|
123
|
+
def __new__(cls, *args, **kwargs):
|
|
124
|
+
if not cls._instance:
|
|
125
|
+
cls._instance = object.__new__(cls, *args, **kwargs)
|
|
126
|
+
cls._is_inited = False
|
|
127
|
+
return cls._instance
|
|
128
|
+
|
|
129
|
+
@property
|
|
130
|
+
def __data__(self):
|
|
131
|
+
return {
|
|
132
|
+
"unit": self.unit,
|
|
133
|
+
"absolute": self.absolute,
|
|
134
|
+
"relative": self.relative,
|
|
135
|
+
"angular": self.angular,
|
|
136
|
+
"approximation": self.approximation,
|
|
137
|
+
"precision": self.precision,
|
|
138
|
+
"lineardeflection": self.lineardeflection,
|
|
139
|
+
"angulardeflection": self.angulardeflection,
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
@classmethod
|
|
143
|
+
def __from_data__(cls, data):
|
|
144
|
+
tol = cls()
|
|
145
|
+
tol.unit = data["unit"]
|
|
146
|
+
tol.absolute = data["absolute"]
|
|
147
|
+
tol.relative = data["relative"]
|
|
148
|
+
tol.angular = data["angular"]
|
|
149
|
+
tol.approximation = data["approximation"]
|
|
150
|
+
tol.precision = data["precision"]
|
|
151
|
+
tol.lineardeflection = data["lineardeflection"]
|
|
152
|
+
tol.angulardeflection = data["angulardeflection"]
|
|
153
|
+
return tol
|
|
154
|
+
|
|
155
|
+
def __init__(
|
|
156
|
+
self,
|
|
157
|
+
unit="M",
|
|
158
|
+
absolute=None,
|
|
159
|
+
relative=None,
|
|
160
|
+
angular=None,
|
|
161
|
+
approximation=None,
|
|
162
|
+
precision=None,
|
|
163
|
+
lineardflection=None,
|
|
164
|
+
angulardflection=None,
|
|
165
|
+
name=None,
|
|
166
|
+
):
|
|
167
|
+
super(Tolerance, self).__init__(name=name)
|
|
168
|
+
if not self._is_inited:
|
|
169
|
+
self._unit = None
|
|
170
|
+
self._absolute = None
|
|
171
|
+
self._relative = None
|
|
172
|
+
self._angular = None
|
|
173
|
+
self._approximation = None
|
|
174
|
+
self._precision = None
|
|
175
|
+
self._lineardeflection = None
|
|
176
|
+
self._angulardeflection = None
|
|
177
|
+
|
|
178
|
+
self._is_inited = True
|
|
179
|
+
|
|
180
|
+
if unit is not None:
|
|
181
|
+
self.unit = unit
|
|
182
|
+
if absolute is not None:
|
|
183
|
+
self.absolute = absolute
|
|
184
|
+
if relative is not None:
|
|
185
|
+
self.relative = relative
|
|
186
|
+
if angular is not None:
|
|
187
|
+
self.angular = angular
|
|
188
|
+
if approximation is not None:
|
|
189
|
+
self.approximation = approximation
|
|
190
|
+
if precision is not None:
|
|
191
|
+
self.precision = precision
|
|
192
|
+
if lineardflection is not None:
|
|
193
|
+
self.lineardeflection = lineardflection
|
|
194
|
+
if angulardflection is not None:
|
|
195
|
+
self.angulardeflection = angulardflection
|
|
196
|
+
|
|
197
|
+
# this can be autogenerated if we use slots
|
|
198
|
+
# __repr__: return f"{__class__.__name__}({', '.join(f'{k}={v!r}' for k, v in self.__dict__.items())})}"
|
|
199
|
+
|
|
200
|
+
def __repr__(self):
|
|
201
|
+
return "Tolerance(unit='{}', absolute={}, relative={}, angular={}, approximation={}, precision={}, lineardeflection={}, angulardeflection={})".format(
|
|
202
|
+
self.unit,
|
|
203
|
+
self.absolute,
|
|
204
|
+
self.relative,
|
|
205
|
+
self.angular,
|
|
206
|
+
self.approximation,
|
|
207
|
+
self.precision,
|
|
208
|
+
self.lineardeflection,
|
|
209
|
+
self.angulardeflection,
|
|
210
|
+
)
|
|
211
|
+
|
|
212
|
+
def reset(self):
|
|
213
|
+
"""Reset all precision settings to their default values."""
|
|
214
|
+
self._absolute = None
|
|
215
|
+
self._relative = None
|
|
216
|
+
self._angular = None
|
|
217
|
+
self._approximation = None
|
|
218
|
+
self._precision = None
|
|
219
|
+
self._lineardeflection = None
|
|
220
|
+
self._angulardeflection = None
|
|
221
|
+
|
|
222
|
+
def update_from_dict(self, tolerance):
|
|
223
|
+
"""Update the tolerance singleton from the key-value pairs found in a dict.
|
|
224
|
+
|
|
225
|
+
Parameters
|
|
226
|
+
----------
|
|
227
|
+
tolerance : dict
|
|
228
|
+
A dictionary containing named tolerance values.
|
|
229
|
+
|
|
230
|
+
Returns
|
|
231
|
+
-------
|
|
232
|
+
None
|
|
233
|
+
|
|
234
|
+
"""
|
|
235
|
+
for name in tolerance:
|
|
236
|
+
if hasattr(self, name):
|
|
237
|
+
setattr(self, name, tolerance[name])
|
|
238
|
+
|
|
239
|
+
@property
|
|
240
|
+
def units(self):
|
|
241
|
+
return self._unit
|
|
242
|
+
|
|
243
|
+
@units.setter
|
|
244
|
+
def units(self, value):
|
|
245
|
+
if value not in ["M", "MM"]:
|
|
246
|
+
raise ValueError("Invalid unit: {}".format(value))
|
|
247
|
+
self._unit = value
|
|
248
|
+
|
|
249
|
+
@property
|
|
250
|
+
def absolute(self):
|
|
251
|
+
if not self._absolute:
|
|
252
|
+
return self.ABSOLUTE
|
|
253
|
+
return self._absolute
|
|
254
|
+
|
|
255
|
+
@absolute.setter
|
|
256
|
+
def absolute(self, value):
|
|
257
|
+
self._absolute = value
|
|
258
|
+
|
|
259
|
+
@property
|
|
260
|
+
def relative(self):
|
|
261
|
+
if not self._relative:
|
|
262
|
+
return self.RELATIVE
|
|
263
|
+
return self._relative
|
|
264
|
+
|
|
265
|
+
@relative.setter
|
|
266
|
+
def relative(self, value):
|
|
267
|
+
self._relative = value
|
|
268
|
+
|
|
269
|
+
@property
|
|
270
|
+
def angular(self):
|
|
271
|
+
if not self._angular:
|
|
272
|
+
return self.ANGULAR
|
|
273
|
+
return self._angular
|
|
274
|
+
|
|
275
|
+
@angular.setter
|
|
276
|
+
def angular(self, value):
|
|
277
|
+
self._angular = value
|
|
278
|
+
|
|
279
|
+
@property
|
|
280
|
+
def approximation(self):
|
|
281
|
+
if not self._approximation:
|
|
282
|
+
return self.APPROXIMATION
|
|
283
|
+
return self._approximation
|
|
284
|
+
|
|
285
|
+
@approximation.setter
|
|
286
|
+
def approximation(self, value):
|
|
287
|
+
self._approximation = value
|
|
288
|
+
|
|
289
|
+
@property
|
|
290
|
+
def precision(self):
|
|
291
|
+
if not self._precision:
|
|
292
|
+
return self.PRECISION
|
|
293
|
+
return self._precision
|
|
294
|
+
|
|
295
|
+
@precision.setter
|
|
296
|
+
def precision(self, value):
|
|
297
|
+
if value == 0:
|
|
298
|
+
raise ValueError("Precision cannot be zero.")
|
|
299
|
+
self._precision = value
|
|
300
|
+
|
|
301
|
+
@property
|
|
302
|
+
def lineardeflection(self):
|
|
303
|
+
if not self._lineardeflection:
|
|
304
|
+
return self.LINEARDEFLECTION
|
|
305
|
+
return self._lineardeflection
|
|
306
|
+
|
|
307
|
+
@lineardeflection.setter
|
|
308
|
+
def lineardeflection(self, value):
|
|
309
|
+
self._lineardeflection = value
|
|
310
|
+
|
|
311
|
+
@property
|
|
312
|
+
def angulardeflection(self):
|
|
313
|
+
if not self._angulardeflection:
|
|
314
|
+
return self.ANGULARDEFLECTION
|
|
315
|
+
return self._angulardeflection
|
|
316
|
+
|
|
317
|
+
@angulardeflection.setter
|
|
318
|
+
def angulardeflection(self, value):
|
|
319
|
+
self._angulardeflection = value
|
|
320
|
+
|
|
321
|
+
def tolerance(self, truevalue, rtol, atol):
|
|
322
|
+
"""Compute the tolerance for a comparison.
|
|
323
|
+
|
|
324
|
+
Parameters
|
|
325
|
+
----------
|
|
326
|
+
truevalue : float
|
|
327
|
+
The true value of the comparison.
|
|
328
|
+
rtol : float
|
|
329
|
+
The relative tolerance.
|
|
330
|
+
atol : float
|
|
331
|
+
The absolute tolerance.
|
|
332
|
+
|
|
333
|
+
Returns
|
|
334
|
+
-------
|
|
335
|
+
float
|
|
336
|
+
The tolerance.
|
|
337
|
+
|
|
338
|
+
Examples
|
|
339
|
+
--------
|
|
340
|
+
>>> tol = Tolerance()
|
|
341
|
+
>>> tol.tolerance(1.0, 0.001, 1e-06)
|
|
342
|
+
0.001001
|
|
343
|
+
>>> tol.tolerance(10.0, 0.001, 1e-06)
|
|
344
|
+
0.010001
|
|
345
|
+
>>> tol.tolerance(10.0, 0.001, 1e-08)
|
|
346
|
+
0.01000001
|
|
347
|
+
|
|
348
|
+
"""
|
|
349
|
+
return rtol * abs(truevalue) + atol
|
|
350
|
+
|
|
351
|
+
def compare(self, a, b, rtol, atol):
|
|
352
|
+
"""Compare two values.
|
|
353
|
+
|
|
354
|
+
Parameters
|
|
355
|
+
----------
|
|
356
|
+
a : float
|
|
357
|
+
The first value.
|
|
358
|
+
b : float
|
|
359
|
+
The second value.
|
|
360
|
+
rtol : float
|
|
361
|
+
The relative tolerance.
|
|
362
|
+
atol : float
|
|
363
|
+
The absolute tolerance.
|
|
364
|
+
|
|
365
|
+
Returns
|
|
366
|
+
-------
|
|
367
|
+
bool
|
|
368
|
+
``True`` if the values are close enough to be considered equal.
|
|
369
|
+
``False`` otherwise.
|
|
370
|
+
|
|
371
|
+
Notes
|
|
372
|
+
-----
|
|
373
|
+
In this comparison, ``b`` is considered the "true value".
|
|
374
|
+
This means that the relative part of the tolerance is computed as a fraction of ``b``.
|
|
375
|
+
|
|
376
|
+
Examples
|
|
377
|
+
--------
|
|
378
|
+
>>> tol = Tolerance()
|
|
379
|
+
>>> tol.compare(1.0, 1.001, 0.001, 1e-06)
|
|
380
|
+
True
|
|
381
|
+
>>> tol.compare(1.0, 1.001, 0.0001, 1e-06)
|
|
382
|
+
False
|
|
383
|
+
|
|
384
|
+
"""
|
|
385
|
+
return abs(a - b) <= self.tolerance(b, rtol, atol)
|
|
386
|
+
|
|
387
|
+
def is_zero(self, a, tol=None):
|
|
388
|
+
"""Check if a value is close enough to zero to be considered zero.
|
|
389
|
+
|
|
390
|
+
Parameters
|
|
391
|
+
----------
|
|
392
|
+
a : float
|
|
393
|
+
The value.
|
|
394
|
+
tol : float, optional
|
|
395
|
+
The absolute tolerance.
|
|
396
|
+
Default is ``None``, in which case ``self.absolute`` is used.
|
|
397
|
+
|
|
398
|
+
Returns
|
|
399
|
+
-------
|
|
400
|
+
bool
|
|
401
|
+
``True`` if the value is small enough to be considered zero.
|
|
402
|
+
``False`` otherwise.
|
|
403
|
+
|
|
404
|
+
Examples
|
|
405
|
+
--------
|
|
406
|
+
>>> tol = Tolerance()
|
|
407
|
+
>>> tol.is_zero(1e-10)
|
|
408
|
+
True
|
|
409
|
+
>>> tol.is_zero(1e-05)
|
|
410
|
+
False
|
|
411
|
+
|
|
412
|
+
"""
|
|
413
|
+
tol = tol or self.absolute
|
|
414
|
+
return abs(a) <= tol
|
|
415
|
+
|
|
416
|
+
def is_positive(self, a, tol=None):
|
|
417
|
+
"""Check if a value can be considered a strictly positive number.
|
|
418
|
+
|
|
419
|
+
Parameters
|
|
420
|
+
----------
|
|
421
|
+
a : float
|
|
422
|
+
The value.
|
|
423
|
+
tol : float, optional
|
|
424
|
+
The absolute tolerance.
|
|
425
|
+
Default is ``None``, in which case ``self.absolute`` is used.
|
|
426
|
+
|
|
427
|
+
Returns
|
|
428
|
+
-------
|
|
429
|
+
bool
|
|
430
|
+
``True`` if the value is small enough to be considered zero.
|
|
431
|
+
``False`` otherwise.
|
|
432
|
+
|
|
433
|
+
Examples
|
|
434
|
+
--------
|
|
435
|
+
>>> tol = Tolerance()
|
|
436
|
+
>>> tol.is_positive(1e-07)
|
|
437
|
+
True
|
|
438
|
+
>>> tol.is_positive(1e-10)
|
|
439
|
+
False
|
|
440
|
+
|
|
441
|
+
"""
|
|
442
|
+
tol = tol or self.absolute
|
|
443
|
+
return a > tol
|
|
444
|
+
|
|
445
|
+
def is_negative(self, a, tol=None):
|
|
446
|
+
"""Check if a value can be considered a strictly negative number.
|
|
447
|
+
|
|
448
|
+
Parameters
|
|
449
|
+
----------
|
|
450
|
+
a : float
|
|
451
|
+
The value.
|
|
452
|
+
tol : float, optional
|
|
453
|
+
The absolute tolerance.
|
|
454
|
+
Default is ``None``, in which case ``self.absolute`` is used.
|
|
455
|
+
|
|
456
|
+
Returns
|
|
457
|
+
-------
|
|
458
|
+
bool
|
|
459
|
+
``True`` if the value is small enough to be considered zero.
|
|
460
|
+
``False`` otherwise.
|
|
461
|
+
|
|
462
|
+
Examples
|
|
463
|
+
--------
|
|
464
|
+
>>> tol = Tolerance()
|
|
465
|
+
>>> tol.is_negative(-1e-07)
|
|
466
|
+
True
|
|
467
|
+
>>> tol.is_negative(-1e-10)
|
|
468
|
+
False
|
|
469
|
+
|
|
470
|
+
"""
|
|
471
|
+
tol = tol or self.absolute
|
|
472
|
+
return a < -tol
|
|
473
|
+
|
|
474
|
+
def is_between(self, value, minval, maxval, atol=None):
|
|
475
|
+
"""Check if a value is between two other values.
|
|
476
|
+
|
|
477
|
+
Parameters
|
|
478
|
+
----------
|
|
479
|
+
value : float
|
|
480
|
+
The value.
|
|
481
|
+
minval : float
|
|
482
|
+
The minimum value.
|
|
483
|
+
maxval : float
|
|
484
|
+
The maximum value.
|
|
485
|
+
atol : float, optional
|
|
486
|
+
The absolute tolerance.
|
|
487
|
+
Default is ``None``, in which case ``self.absolute`` is used.
|
|
488
|
+
|
|
489
|
+
Returns
|
|
490
|
+
-------
|
|
491
|
+
bool
|
|
492
|
+
``True`` if the value is between the two other values.
|
|
493
|
+
``False`` otherwise.
|
|
494
|
+
|
|
495
|
+
Examples
|
|
496
|
+
--------
|
|
497
|
+
>>> tol = Tolerance()
|
|
498
|
+
>>> tol.is_between(0.5, 0.0, 1.0)
|
|
499
|
+
True
|
|
500
|
+
>>> tol.is_between(1.5, 0.0, 1.0)
|
|
501
|
+
False
|
|
502
|
+
|
|
503
|
+
"""
|
|
504
|
+
atol = atol or self.absolute
|
|
505
|
+
return minval - atol <= value <= maxval + atol
|
|
506
|
+
|
|
507
|
+
def is_close(self, a, b, rtol=None, atol=None):
|
|
508
|
+
"""Check if two values are close enough to be considered equal.
|
|
509
|
+
|
|
510
|
+
Parameters
|
|
511
|
+
----------
|
|
512
|
+
a : float
|
|
513
|
+
The first value.
|
|
514
|
+
b : float
|
|
515
|
+
The second value.
|
|
516
|
+
rtol : float, optional
|
|
517
|
+
The relative tolerance.
|
|
518
|
+
Default is ``None``, in which case ``self.relative`` is used.
|
|
519
|
+
atol : float, optional
|
|
520
|
+
The absolute tolerance.
|
|
521
|
+
Default is ``None``, in which case ``self.absolute`` is used.
|
|
522
|
+
|
|
523
|
+
Returns
|
|
524
|
+
-------
|
|
525
|
+
bool
|
|
526
|
+
``True`` if the values are close enough to be considered equal.
|
|
527
|
+
``False`` otherwise.
|
|
528
|
+
|
|
529
|
+
Examples
|
|
530
|
+
--------
|
|
531
|
+
>>> tol = Tolerance()
|
|
532
|
+
>>> tol.is_close(1.0, 1.000001)
|
|
533
|
+
True
|
|
534
|
+
>>> tol.is_close(1.0, 1.00001)
|
|
535
|
+
True
|
|
536
|
+
>>> tol.is_close(1.0, 1.0001)
|
|
537
|
+
True
|
|
538
|
+
>>> tol.is_close(1.0, 1.001)
|
|
539
|
+
True
|
|
540
|
+
>>> tol.is_close(1.0, 1.01)
|
|
541
|
+
False
|
|
542
|
+
|
|
543
|
+
"""
|
|
544
|
+
rtol = rtol or self.relative
|
|
545
|
+
atol = atol or self.absolute
|
|
546
|
+
return self.compare(a, b, rtol, atol)
|
|
547
|
+
|
|
548
|
+
def is_allclose(self, A, B, rtol=None, atol=None):
|
|
549
|
+
"""Check if two lists of values are element-wise close enough to be considered equal.
|
|
550
|
+
|
|
551
|
+
Parameters
|
|
552
|
+
----------
|
|
553
|
+
A : list of float
|
|
554
|
+
The first list of values.
|
|
555
|
+
B : list of float
|
|
556
|
+
The second list of values.
|
|
557
|
+
rtol : float, optional
|
|
558
|
+
The relative tolerance.
|
|
559
|
+
Default is ``None``, in which case ``self.relative`` is used.
|
|
560
|
+
atol : float, optional
|
|
561
|
+
The absolute tolerance.
|
|
562
|
+
Default is ``None``, in which case ``self.absolute`` is used.
|
|
563
|
+
|
|
564
|
+
Returns
|
|
565
|
+
-------
|
|
566
|
+
bool
|
|
567
|
+
``True`` if the values are close enough to be considered equal.
|
|
568
|
+
``False`` otherwise.
|
|
569
|
+
|
|
570
|
+
Examples
|
|
571
|
+
--------
|
|
572
|
+
>>> tol = Tolerance()
|
|
573
|
+
>>> tol.is_allclose([0.0, 0.0], [1e-7, 1e-7])
|
|
574
|
+
True
|
|
575
|
+
>>> tol.is_allclose([0.0, 0.0], [1e-6, 1e-6])
|
|
576
|
+
True
|
|
577
|
+
>>> tol.is_allclose([0.0, 0.0], [1e-6, 1e-5])
|
|
578
|
+
False
|
|
579
|
+
|
|
580
|
+
"""
|
|
581
|
+
rtol = rtol or self.relative
|
|
582
|
+
atol = atol or self.absolute
|
|
583
|
+
return all(self.is_allclose(a, b, rtol, atol) if hasattr(a, "__iter__") else self.compare(a, b, rtol, atol) for a, b in zip(A, B))
|
|
584
|
+
|
|
585
|
+
def is_angle_zero(self, a, tol=None):
|
|
586
|
+
"""Check if an angle is close enough to zero to be considered zero.
|
|
587
|
+
|
|
588
|
+
Parameters
|
|
589
|
+
----------
|
|
590
|
+
a : float
|
|
591
|
+
The angle in radians.
|
|
592
|
+
tol : float, optional
|
|
593
|
+
The absolute tolerance.
|
|
594
|
+
Default is ``None``, in which case ``self.angular`` is used.
|
|
595
|
+
|
|
596
|
+
Returns
|
|
597
|
+
-------
|
|
598
|
+
bool
|
|
599
|
+
``True`` if the angle is small enough to be considered zero.
|
|
600
|
+
``False`` otherwise.
|
|
601
|
+
|
|
602
|
+
Examples
|
|
603
|
+
--------
|
|
604
|
+
>>> tol = Tolerance()
|
|
605
|
+
>>> tol.is_zero_angle(1e-07)
|
|
606
|
+
True
|
|
607
|
+
>>> tol.is_zero_angle(1e-05)
|
|
608
|
+
False
|
|
609
|
+
|
|
610
|
+
"""
|
|
611
|
+
tol = tol or self.angular
|
|
612
|
+
return abs(a) <= tol
|
|
613
|
+
|
|
614
|
+
def is_angles_close(self, a, b, tol=None):
|
|
615
|
+
"""Check if two angles are close enough to be considered equal.
|
|
616
|
+
|
|
617
|
+
Parameters
|
|
618
|
+
----------
|
|
619
|
+
a : float
|
|
620
|
+
The first angle in radians.
|
|
621
|
+
b : float
|
|
622
|
+
The second angle in radians.
|
|
623
|
+
tol : float, optional
|
|
624
|
+
The absolute tolerance.
|
|
625
|
+
Default is ``None``, in which case ``self.angular`` is used.
|
|
626
|
+
|
|
627
|
+
Returns
|
|
628
|
+
-------
|
|
629
|
+
bool
|
|
630
|
+
``True`` if the angles are close enough to be considered equal.
|
|
631
|
+
``False`` otherwise.
|
|
632
|
+
|
|
633
|
+
Examples
|
|
634
|
+
--------
|
|
635
|
+
>>> tol = Tolerance()
|
|
636
|
+
>>> tol.is_angles_close(0.0, 1e-07)
|
|
637
|
+
True
|
|
638
|
+
>>> tol.is_angles_close(0.0, 1e-05)
|
|
639
|
+
False
|
|
640
|
+
|
|
641
|
+
"""
|
|
642
|
+
tol = tol or self.angular
|
|
643
|
+
return abs(a - b) <= tol
|
|
644
|
+
|
|
645
|
+
def geometric_key(self, xyz, precision=None, sanitize=True):
|
|
646
|
+
"""Compute the geometric key of a point.
|
|
647
|
+
|
|
648
|
+
Parameters
|
|
649
|
+
----------
|
|
650
|
+
xyz : list of float
|
|
651
|
+
The XYZ coordinates of the point.
|
|
652
|
+
precision : int, optional
|
|
653
|
+
The precision used when converting numbers to strings.
|
|
654
|
+
Default is ``None``, in which case ``self.precision`` is used.
|
|
655
|
+
sanitize : bool, optional
|
|
656
|
+
If ``True``, minus signs ("-") will be removed from values that are equal to zero up to the given precision.
|
|
657
|
+
|
|
658
|
+
Returns
|
|
659
|
+
-------
|
|
660
|
+
str
|
|
661
|
+
The geometric key.
|
|
662
|
+
|
|
663
|
+
Raises
|
|
664
|
+
------
|
|
665
|
+
ValueError
|
|
666
|
+
If the precision is zero.
|
|
667
|
+
|
|
668
|
+
Examples
|
|
669
|
+
--------
|
|
670
|
+
>>> tol = Tolerance()
|
|
671
|
+
>>> tol.geometric_key([1.0, 2.0, 3.0])
|
|
672
|
+
'1.000,2.000,3.000'
|
|
673
|
+
|
|
674
|
+
>>> tol = Tolerance()
|
|
675
|
+
>>> tol.geometric_key([1.05725, 2.0195, 3.001], precision=3)
|
|
676
|
+
'1.057,2.019,3.001'
|
|
677
|
+
|
|
678
|
+
>>> tol = Tolerance()
|
|
679
|
+
>>> tol.geometric_key([1.0, 2.0, 3.0], precision=-1)
|
|
680
|
+
'1,2,3'
|
|
681
|
+
|
|
682
|
+
>>> tol = Tolerance()
|
|
683
|
+
>>> tol.geometric_key([1.0, 2.0, 3.0], precision=-3)
|
|
684
|
+
'0,0,0'
|
|
685
|
+
|
|
686
|
+
>>> tol = Tolerance()
|
|
687
|
+
>>> tol.geometric_key([1103, 205, 30145], precision=-3)
|
|
688
|
+
'1100,200,30100'
|
|
689
|
+
|
|
690
|
+
"""
|
|
691
|
+
x, y, z = xyz
|
|
692
|
+
if not precision:
|
|
693
|
+
precision = self.precision
|
|
694
|
+
|
|
695
|
+
if precision == 0:
|
|
696
|
+
raise ValueError("Precision cannot be zero.")
|
|
697
|
+
|
|
698
|
+
if precision == -1:
|
|
699
|
+
return "{:d},{:d},{:d}".format(int(x), int(y), int(z))
|
|
700
|
+
|
|
701
|
+
if precision < -1:
|
|
702
|
+
precision = -precision - 1
|
|
703
|
+
factor = 10**precision
|
|
704
|
+
return "{:d},{:d},{:d}".format(
|
|
705
|
+
int(round(x / factor) * factor),
|
|
706
|
+
int(round(y / factor) * factor),
|
|
707
|
+
int(round(z / factor) * factor),
|
|
708
|
+
)
|
|
709
|
+
|
|
710
|
+
if sanitize:
|
|
711
|
+
minzero = "-{0:.{1}f}".format(0.0, precision)
|
|
712
|
+
if "{0:.{1}f}".format(x, precision) == minzero:
|
|
713
|
+
x = 0.0
|
|
714
|
+
if "{0:.{1}f}".format(y, precision) == minzero:
|
|
715
|
+
y = 0.0
|
|
716
|
+
if "{0:.{1}f}".format(z, precision) == minzero:
|
|
717
|
+
z = 0.0
|
|
718
|
+
|
|
719
|
+
return "{0:.{3}f},{1:.{3}f},{2:.{3}f}".format(x, y, z, precision)
|
|
720
|
+
|
|
721
|
+
def geometric_key_xy(self, xy, precision=None, sanitize=True):
|
|
722
|
+
"""Compute the geometric key of a point in the XY plane.
|
|
723
|
+
|
|
724
|
+
Parameters
|
|
725
|
+
----------
|
|
726
|
+
xy : list of float
|
|
727
|
+
The XY coordinates of the point.
|
|
728
|
+
precision : int, optional
|
|
729
|
+
The precision used when converting numbers to strings.
|
|
730
|
+
Default is ``None``, in which case ``self.precision`` is used.
|
|
731
|
+
sanitize : bool, optional
|
|
732
|
+
If ``True``, minus signs ("-") will be removed from values that are equal to zero up to the given precision.
|
|
733
|
+
|
|
734
|
+
Returns
|
|
735
|
+
-------
|
|
736
|
+
str
|
|
737
|
+
The geometric key in XY.
|
|
738
|
+
|
|
739
|
+
Raises
|
|
740
|
+
------
|
|
741
|
+
ValueError
|
|
742
|
+
If the precision is zero.
|
|
743
|
+
|
|
744
|
+
Examples
|
|
745
|
+
--------
|
|
746
|
+
>>> tol = Tolerance()
|
|
747
|
+
>>> tol.geometric_key_xy([1.0, 2.0])
|
|
748
|
+
'1.000,2.000'
|
|
749
|
+
|
|
750
|
+
>>> tol = Tolerance()
|
|
751
|
+
>>> tol.geometric_key_xy([1.05725, 2.0195], precision=3)
|
|
752
|
+
'1.057,2.019'
|
|
753
|
+
|
|
754
|
+
>>> tol = Tolerance()
|
|
755
|
+
>>> tol.geometric_key_xy([1.0, 2.0], precision=-1)
|
|
756
|
+
'1,2'
|
|
757
|
+
|
|
758
|
+
>>> tol = Tolerance()
|
|
759
|
+
>>> tol.geometric_key_xy([1.0, 2.0], precision=-3)
|
|
760
|
+
'0,0'
|
|
761
|
+
|
|
762
|
+
>>> tol = Tolerance()
|
|
763
|
+
>>> tol.geometric_key_xy([1103, 205], precision=-3)
|
|
764
|
+
'1100,200'
|
|
765
|
+
|
|
766
|
+
"""
|
|
767
|
+
x = xy[0]
|
|
768
|
+
y = xy[1]
|
|
769
|
+
|
|
770
|
+
if not precision:
|
|
771
|
+
precision = self.precision
|
|
772
|
+
|
|
773
|
+
if precision == 0:
|
|
774
|
+
raise ValueError("Precision cannot be zero.")
|
|
775
|
+
|
|
776
|
+
if precision == -1:
|
|
777
|
+
return "{:d},{:d}".format(int(x), int(y))
|
|
778
|
+
|
|
779
|
+
if precision < -1:
|
|
780
|
+
precision = -precision - 1
|
|
781
|
+
factor = 10**precision
|
|
782
|
+
return "{:d},{:d}".format(
|
|
783
|
+
int(round(x / factor) * factor),
|
|
784
|
+
int(round(y / factor) * factor),
|
|
785
|
+
)
|
|
786
|
+
|
|
787
|
+
if sanitize:
|
|
788
|
+
minzero = "-{0:.{1}f}".format(0.0, precision)
|
|
789
|
+
if "{0:.{1}f}".format(x, precision) == minzero:
|
|
790
|
+
x = 0.0
|
|
791
|
+
if "{0:.{1}f}".format(y, precision) == minzero:
|
|
792
|
+
y = 0.0
|
|
793
|
+
|
|
794
|
+
return "{0:.{2}f},{1:.{2}f}".format(x, y, precision)
|
|
795
|
+
|
|
796
|
+
def format_number(self, number, precision=None):
|
|
797
|
+
"""Format a number as a string.
|
|
798
|
+
|
|
799
|
+
Parameters
|
|
800
|
+
----------
|
|
801
|
+
number : float
|
|
802
|
+
The number.
|
|
803
|
+
precision : int, optional
|
|
804
|
+
The precision used when converting numbers to strings.
|
|
805
|
+
Default is ``None``, in which case ``self.precision`` is used.
|
|
806
|
+
|
|
807
|
+
Returns
|
|
808
|
+
-------
|
|
809
|
+
str
|
|
810
|
+
The formatted number.
|
|
811
|
+
|
|
812
|
+
Examples
|
|
813
|
+
--------
|
|
814
|
+
>>> tol = Tolerance()
|
|
815
|
+
>>> tol.format_number(1.0)
|
|
816
|
+
'1.000'
|
|
817
|
+
>>> tol.format_number(1.0, precision=3)
|
|
818
|
+
'1.000'
|
|
819
|
+
>>> tol.format_number(1.0, precision=-1)
|
|
820
|
+
'1'
|
|
821
|
+
>>> tol.format_number(1.0, precision=-3)
|
|
822
|
+
'0'
|
|
823
|
+
>>> tol.format_number(12345, precision=-3)
|
|
824
|
+
'12300'
|
|
825
|
+
|
|
826
|
+
"""
|
|
827
|
+
if compas.IPY:
|
|
828
|
+
number = float(number)
|
|
829
|
+
|
|
830
|
+
if not precision:
|
|
831
|
+
precision = self.precision
|
|
832
|
+
|
|
833
|
+
if precision == 0:
|
|
834
|
+
raise ValueError("Precision cannot be zero.")
|
|
835
|
+
|
|
836
|
+
if precision == -1:
|
|
837
|
+
return "{:d}".format(int(round(number)))
|
|
838
|
+
|
|
839
|
+
if precision < -1:
|
|
840
|
+
precision = -precision - 1
|
|
841
|
+
factor = 10**precision
|
|
842
|
+
return "{:d}".format(int(round(number / factor) * factor))
|
|
843
|
+
|
|
844
|
+
return "{0:.{1}f}".format(number, precision)
|
|
845
|
+
|
|
846
|
+
def precision_from_tolerance(self, tol=None):
|
|
847
|
+
"""Compute the precision from a given tolerance.
|
|
848
|
+
|
|
849
|
+
Parameters
|
|
850
|
+
----------
|
|
851
|
+
tol : float, optional
|
|
852
|
+
The tolerance.
|
|
853
|
+
Default is ``None``, in which case ``self.absolute`` is used.
|
|
854
|
+
|
|
855
|
+
Returns
|
|
856
|
+
-------
|
|
857
|
+
int
|
|
858
|
+
The precision.
|
|
859
|
+
|
|
860
|
+
Examples
|
|
861
|
+
--------
|
|
862
|
+
>>> tol = Tolerance()
|
|
863
|
+
>>> tol.precision_from_tolerance(1e-07)
|
|
864
|
+
7
|
|
865
|
+
>>> tol.precision_from_tolerance(1e-05)
|
|
866
|
+
5
|
|
867
|
+
>>> tol.precision_from_tolerance(1e-03)
|
|
868
|
+
3
|
|
869
|
+
>>> tol.precision_from_tolerance(1e-01)
|
|
870
|
+
1
|
|
871
|
+
|
|
872
|
+
"""
|
|
873
|
+
tol = tol or self.absolute
|
|
874
|
+
if tol < 1:
|
|
875
|
+
return abs(int(Decimal(str(tol)).as_tuple().exponent))
|
|
876
|
+
raise NotImplementedError
|
|
877
|
+
|
|
878
|
+
|
|
879
|
+
TOL = Tolerance()
|