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/data/__init__.py
ADDED
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
"""
|
|
2
|
+
This package defines the core infrastructure for data serialisation in the COMPAS framework.
|
|
3
|
+
It provides a base class for data objects, a JSON encoder and decoder, serialisers and deserialisers, and schema validation.
|
|
4
|
+
"""
|
|
5
|
+
|
|
6
|
+
from __future__ import absolute_import
|
|
7
|
+
|
|
8
|
+
from .exceptions import DecoderError
|
|
9
|
+
from .encoders import DataEncoder
|
|
10
|
+
from .encoders import DataDecoder
|
|
11
|
+
from .data import Data
|
|
12
|
+
from .json import json_load, json_loads, json_loadz, json_dump, json_dumps, json_dumpz
|
|
13
|
+
from .schema import dataclass_dataschema, dataclass_typeschema, dataclass_jsonschema
|
|
14
|
+
from .schema import compas_dataclasses
|
|
15
|
+
|
|
16
|
+
__all__ = [
|
|
17
|
+
"Data",
|
|
18
|
+
"DataEncoder",
|
|
19
|
+
"DataDecoder",
|
|
20
|
+
"DecoderError",
|
|
21
|
+
"json_load",
|
|
22
|
+
"json_loads",
|
|
23
|
+
"json_loadz",
|
|
24
|
+
"json_dump",
|
|
25
|
+
"json_dumps",
|
|
26
|
+
"json_dumpz",
|
|
27
|
+
"dataclass_dataschema",
|
|
28
|
+
"dataclass_typeschema",
|
|
29
|
+
"dataclass_jsonschema",
|
|
30
|
+
"compas_dataclasses",
|
|
31
|
+
]
|
compas/data/coercion.py
ADDED
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
from .validators import is_item_iterable
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
def coerce_sequence_of_tuple(sequence):
|
|
9
|
+
"""Make sure all items of a sequence are of type tuple.
|
|
10
|
+
|
|
11
|
+
Parameters
|
|
12
|
+
----------
|
|
13
|
+
sequence : sequence
|
|
14
|
+
A sequence of items.
|
|
15
|
+
|
|
16
|
+
Returns
|
|
17
|
+
-------
|
|
18
|
+
list[tuple]
|
|
19
|
+
A list containing the items of the original sequence,
|
|
20
|
+
with each iterable item converted to a tuple,
|
|
21
|
+
and non-iterable items wrapped in a tuple.
|
|
22
|
+
|
|
23
|
+
Examples
|
|
24
|
+
--------
|
|
25
|
+
>>> items = coerce_sequence_of_tuple(["a", 1, (None,), [2.0, 3.0]])
|
|
26
|
+
>>> is_sequence_of_tuple(items)
|
|
27
|
+
True
|
|
28
|
+
|
|
29
|
+
"""
|
|
30
|
+
items = []
|
|
31
|
+
for item in sequence:
|
|
32
|
+
if not isinstance(item, tuple):
|
|
33
|
+
if not is_item_iterable(item):
|
|
34
|
+
item = (item,)
|
|
35
|
+
else:
|
|
36
|
+
item = tuple(item)
|
|
37
|
+
items.append(item)
|
|
38
|
+
return items
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
def coerce_sequence_of_list(sequence):
|
|
42
|
+
"""Make sure all items of a sequence are of type list.
|
|
43
|
+
|
|
44
|
+
Parameters
|
|
45
|
+
----------
|
|
46
|
+
sequence : sequence
|
|
47
|
+
A sequence of items.
|
|
48
|
+
|
|
49
|
+
Returns
|
|
50
|
+
-------
|
|
51
|
+
list[list]
|
|
52
|
+
A list containing the items of the original sequence,
|
|
53
|
+
with each iterable item converted to a list,
|
|
54
|
+
and non-iterable items wrapped in a list.
|
|
55
|
+
|
|
56
|
+
Examples
|
|
57
|
+
--------
|
|
58
|
+
>>> items = coerce_sequence_of_list(["a", 1, (None,), [2.0, 3.0]])
|
|
59
|
+
>>> is_sequence_of_list(items)
|
|
60
|
+
True
|
|
61
|
+
|
|
62
|
+
"""
|
|
63
|
+
items = []
|
|
64
|
+
for item in sequence:
|
|
65
|
+
if not isinstance(item, list):
|
|
66
|
+
if not is_item_iterable(item):
|
|
67
|
+
item = [item]
|
|
68
|
+
else:
|
|
69
|
+
item = list(item)
|
|
70
|
+
items.append(item)
|
|
71
|
+
return items
|
compas/data/conftest.py
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import pytest
|
|
2
|
+
|
|
3
|
+
from .validators import is_sequence_of_list
|
|
4
|
+
from .validators import is_sequence_of_tuple
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
@pytest.fixture(autouse=True)
|
|
8
|
+
def add_is_sequence_of(doctest_namespace):
|
|
9
|
+
doctest_namespace["is_sequence_of_list"] = is_sequence_of_list
|
|
10
|
+
doctest_namespace["is_sequence_of_tuple"] = is_sequence_of_tuple
|
compas/data/data.py
ADDED
|
@@ -0,0 +1,342 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
try:
|
|
6
|
+
from typing import TypeVar # noqa: F401
|
|
7
|
+
|
|
8
|
+
D = TypeVar("D", bound="Data")
|
|
9
|
+
except ImportError:
|
|
10
|
+
pass
|
|
11
|
+
|
|
12
|
+
import hashlib
|
|
13
|
+
from copy import deepcopy
|
|
14
|
+
from uuid import UUID
|
|
15
|
+
from uuid import uuid4
|
|
16
|
+
|
|
17
|
+
import compas
|
|
18
|
+
|
|
19
|
+
# ==============================================================================
|
|
20
|
+
# If you ever feel tempted to use ABCMeta in your code: don't, just DON'T.
|
|
21
|
+
# Assigning __metaclass__ = ABCMeta to a class causes a severe memory leak/performance
|
|
22
|
+
# degradation on IronPython 2.7.
|
|
23
|
+
|
|
24
|
+
# See these issues for more details:
|
|
25
|
+
# - https://github.com/compas-dev/compas/issues/562
|
|
26
|
+
# - https://github.com/compas-dev/compas/issues/649
|
|
27
|
+
|
|
28
|
+
# ==============================================================================
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
class Data(object):
|
|
32
|
+
"""Abstract base class for all COMPAS data objects.
|
|
33
|
+
|
|
34
|
+
Parameters
|
|
35
|
+
----------
|
|
36
|
+
name : str, optional
|
|
37
|
+
The name of the object.
|
|
38
|
+
|
|
39
|
+
Attributes
|
|
40
|
+
----------
|
|
41
|
+
guid : str, read-only
|
|
42
|
+
The globally unique identifier of the object.
|
|
43
|
+
The guid is generated with ``uuid.uuid4()``.
|
|
44
|
+
name : str
|
|
45
|
+
The name of the object.
|
|
46
|
+
This name is not necessarily unique and can be set by the user.
|
|
47
|
+
The default value is the object's class name: ``self.__class__.__name__``.
|
|
48
|
+
|
|
49
|
+
See Also
|
|
50
|
+
--------
|
|
51
|
+
:class:`compas.data.DataEncoder`
|
|
52
|
+
:class:`compas.data.DataDecoder`
|
|
53
|
+
|
|
54
|
+
Notes
|
|
55
|
+
-----
|
|
56
|
+
Objects created from classes that implement this data class
|
|
57
|
+
can be serialized to JSON and unserialized without loss of information using:
|
|
58
|
+
|
|
59
|
+
* :func:`compas.data.json_dump`
|
|
60
|
+
* :func:`compas.data.json_dumps`
|
|
61
|
+
* :func:`compas.data.json_load`
|
|
62
|
+
* :func:`compas.data.json_loads`
|
|
63
|
+
|
|
64
|
+
"""
|
|
65
|
+
|
|
66
|
+
DATASCHEMA = {}
|
|
67
|
+
|
|
68
|
+
def __init__(self, name=None):
|
|
69
|
+
self._guid = None
|
|
70
|
+
self._name = None
|
|
71
|
+
if name:
|
|
72
|
+
self.name = name
|
|
73
|
+
|
|
74
|
+
@property
|
|
75
|
+
def __dtype__(self):
|
|
76
|
+
return "{}/{}".format(".".join(self.__class__.__module__.split(".")[:2]), self.__class__.__name__)
|
|
77
|
+
|
|
78
|
+
@property
|
|
79
|
+
def __data__(self):
|
|
80
|
+
raise NotImplementedError
|
|
81
|
+
|
|
82
|
+
def __jsondump__(self, minimal=False):
|
|
83
|
+
"""Return the required information for serialization with the COMPAS JSON serializer.
|
|
84
|
+
|
|
85
|
+
Parameters
|
|
86
|
+
----------
|
|
87
|
+
minimal : bool, optional
|
|
88
|
+
If True, exclude the GUID from the dump dict.
|
|
89
|
+
|
|
90
|
+
Returns
|
|
91
|
+
-------
|
|
92
|
+
dict
|
|
93
|
+
|
|
94
|
+
"""
|
|
95
|
+
state = {
|
|
96
|
+
"dtype": self.__dtype__,
|
|
97
|
+
"data": self.__data__,
|
|
98
|
+
}
|
|
99
|
+
if minimal:
|
|
100
|
+
return state
|
|
101
|
+
if self._name is not None:
|
|
102
|
+
state["name"] = self._name
|
|
103
|
+
state["guid"] = str(self.guid)
|
|
104
|
+
return state
|
|
105
|
+
|
|
106
|
+
@classmethod
|
|
107
|
+
def __jsonload__(cls, data, guid=None, name=None):
|
|
108
|
+
"""Construct an object of this type from the provided data to support COMPAS JSON serialization.
|
|
109
|
+
|
|
110
|
+
Parameters
|
|
111
|
+
----------
|
|
112
|
+
data : dict
|
|
113
|
+
The raw Python data representing the object.
|
|
114
|
+
guid : str, optional
|
|
115
|
+
The GUID of the object.
|
|
116
|
+
name : str, optional
|
|
117
|
+
The name of the object.
|
|
118
|
+
|
|
119
|
+
Returns
|
|
120
|
+
-------
|
|
121
|
+
object
|
|
122
|
+
|
|
123
|
+
"""
|
|
124
|
+
obj = cls.__from_data__(data)
|
|
125
|
+
if guid is not None:
|
|
126
|
+
obj._guid = UUID(guid)
|
|
127
|
+
if name is not None:
|
|
128
|
+
obj.name = name
|
|
129
|
+
return obj
|
|
130
|
+
|
|
131
|
+
def __getstate__(self):
|
|
132
|
+
state = self.__jsondump__()
|
|
133
|
+
state["__dict__"] = self.__dict__
|
|
134
|
+
return state
|
|
135
|
+
|
|
136
|
+
def __setstate__(self, state):
|
|
137
|
+
self.__dict__.update(state["__dict__"])
|
|
138
|
+
if "guid" in state:
|
|
139
|
+
self._guid = UUID(state["guid"])
|
|
140
|
+
if "name" in state:
|
|
141
|
+
self.name = state["name"]
|
|
142
|
+
|
|
143
|
+
@classmethod
|
|
144
|
+
def __from_data__(cls, data): # type: (dict) -> Data
|
|
145
|
+
"""Construct an object of this type from the provided data.
|
|
146
|
+
|
|
147
|
+
Parameters
|
|
148
|
+
----------
|
|
149
|
+
data : dict
|
|
150
|
+
The data dictionary.
|
|
151
|
+
|
|
152
|
+
Returns
|
|
153
|
+
-------
|
|
154
|
+
:class:`compas.data.Data`
|
|
155
|
+
An instance of this object type if the data contained in the dict has the correct schema.
|
|
156
|
+
|
|
157
|
+
"""
|
|
158
|
+
return cls(**data)
|
|
159
|
+
|
|
160
|
+
def ToString(self):
|
|
161
|
+
"""Converts the instance to a string.
|
|
162
|
+
|
|
163
|
+
This method exists for .NET compatibility. When using IronPython,
|
|
164
|
+
the implicit string conversion that usually takes place in CPython
|
|
165
|
+
will not kick-in, and in its place, IronPython will default to
|
|
166
|
+
printing self.GetType().FullName or similar. Overriding the `ToString`
|
|
167
|
+
method of .NET object class fixes that and makes Rhino/Grasshopper
|
|
168
|
+
display proper string representations when the objects are printed or
|
|
169
|
+
connected to a panel or other type of string output.
|
|
170
|
+
|
|
171
|
+
"""
|
|
172
|
+
return str(self)
|
|
173
|
+
|
|
174
|
+
@property
|
|
175
|
+
def guid(self):
|
|
176
|
+
if not self._guid:
|
|
177
|
+
self._guid = uuid4()
|
|
178
|
+
return self._guid
|
|
179
|
+
|
|
180
|
+
@property
|
|
181
|
+
def name(self):
|
|
182
|
+
return self._name or self.__class__.__name__
|
|
183
|
+
|
|
184
|
+
@name.setter
|
|
185
|
+
def name(self, name):
|
|
186
|
+
self._name = name
|
|
187
|
+
|
|
188
|
+
@classmethod
|
|
189
|
+
def from_json(cls, filepath): # type: (...) -> Data
|
|
190
|
+
"""Construct an object of this type from a JSON file.
|
|
191
|
+
|
|
192
|
+
Parameters
|
|
193
|
+
----------
|
|
194
|
+
filepath : str
|
|
195
|
+
The path to the JSON file.
|
|
196
|
+
|
|
197
|
+
Returns
|
|
198
|
+
-------
|
|
199
|
+
:class:`compas.data.Data`
|
|
200
|
+
An instance of this object type if the data contained in the file has the correct schema.
|
|
201
|
+
|
|
202
|
+
Raises
|
|
203
|
+
------
|
|
204
|
+
TypeError
|
|
205
|
+
If the data in the file is not a :class:`compas.data.Data`.
|
|
206
|
+
|
|
207
|
+
"""
|
|
208
|
+
data = compas.json_load(filepath)
|
|
209
|
+
if not isinstance(data, cls):
|
|
210
|
+
raise TypeError("The data in the file is not a {}.".format(cls))
|
|
211
|
+
return data
|
|
212
|
+
|
|
213
|
+
def to_json(self, filepath, pretty=False):
|
|
214
|
+
"""Convert an object to its native data representation and save it to a JSON file.
|
|
215
|
+
|
|
216
|
+
Parameters
|
|
217
|
+
----------
|
|
218
|
+
filepath : str
|
|
219
|
+
The path to the JSON file.
|
|
220
|
+
pretty : bool, optional
|
|
221
|
+
If True, the JSON file will be pretty printed.
|
|
222
|
+
Defaults to False.
|
|
223
|
+
|
|
224
|
+
"""
|
|
225
|
+
compas.json_dump(self, filepath, pretty=pretty)
|
|
226
|
+
|
|
227
|
+
@classmethod
|
|
228
|
+
def from_jsonstring(cls, string): # type: (...) -> Data
|
|
229
|
+
"""Construct an object of this type from a JSON string.
|
|
230
|
+
|
|
231
|
+
Parameters
|
|
232
|
+
----------
|
|
233
|
+
string : str
|
|
234
|
+
The JSON string.
|
|
235
|
+
|
|
236
|
+
Returns
|
|
237
|
+
-------
|
|
238
|
+
:class:`compas.data.Data`
|
|
239
|
+
An instance of this object type if the data contained in the string has the correct schema.
|
|
240
|
+
|
|
241
|
+
Raises
|
|
242
|
+
------
|
|
243
|
+
TypeError
|
|
244
|
+
If the data in the string is not a :class:`compas.data.Data`.
|
|
245
|
+
|
|
246
|
+
"""
|
|
247
|
+
data = compas.json_loads(string)
|
|
248
|
+
if not isinstance(data, cls):
|
|
249
|
+
raise TypeError("The data in the string is not a {}.".format(cls))
|
|
250
|
+
return data
|
|
251
|
+
|
|
252
|
+
def to_jsonstring(self, pretty=False):
|
|
253
|
+
"""Convert an object to its native data representation and save it to a JSON string.
|
|
254
|
+
|
|
255
|
+
Parameters
|
|
256
|
+
----------
|
|
257
|
+
pretty : bool, optional
|
|
258
|
+
If True, the JSON string will be pretty printed.
|
|
259
|
+
Defaults to False.
|
|
260
|
+
|
|
261
|
+
Returns
|
|
262
|
+
-------
|
|
263
|
+
str
|
|
264
|
+
The JSON string.
|
|
265
|
+
|
|
266
|
+
"""
|
|
267
|
+
return compas.json_dumps(self, pretty=pretty)
|
|
268
|
+
|
|
269
|
+
def copy(self, cls=None): # type: (...) -> D
|
|
270
|
+
"""Make an independent copy of the data object.
|
|
271
|
+
|
|
272
|
+
Parameters
|
|
273
|
+
----------
|
|
274
|
+
cls : Type[:class:`compas.data.Data`], optional
|
|
275
|
+
The type of data object to return.
|
|
276
|
+
Defaults to the type of the current data object.
|
|
277
|
+
|
|
278
|
+
Returns
|
|
279
|
+
-------
|
|
280
|
+
:class:`compas.data.Data`
|
|
281
|
+
An independent copy of this object.
|
|
282
|
+
|
|
283
|
+
"""
|
|
284
|
+
if not cls:
|
|
285
|
+
cls = type(self)
|
|
286
|
+
obj = cls.__from_data__(deepcopy(self.__data__))
|
|
287
|
+
obj.name = self.name
|
|
288
|
+
return obj # type: ignore
|
|
289
|
+
|
|
290
|
+
def sha256(self, as_string=False):
|
|
291
|
+
"""Compute a hash of the data for comparison during version control using the sha256 algorithm.
|
|
292
|
+
|
|
293
|
+
Parameters
|
|
294
|
+
----------
|
|
295
|
+
as_string : bool, optional
|
|
296
|
+
If True, return the digest in hexadecimal format rather than as bytes.
|
|
297
|
+
|
|
298
|
+
Returns
|
|
299
|
+
-------
|
|
300
|
+
bytes | str
|
|
301
|
+
|
|
302
|
+
Examples
|
|
303
|
+
--------
|
|
304
|
+
>>> from compas.datastructures import Mesh
|
|
305
|
+
>>> mesh = Mesh.from_obj(compas.get("faces.obj"))
|
|
306
|
+
>>> v1 = mesh.sha256()
|
|
307
|
+
>>> v2 = mesh.sha256()
|
|
308
|
+
>>> mesh.vertex_attribute(mesh.vertex_sample(1)[0], "z", 1)
|
|
309
|
+
>>> v3 = mesh.sha256()
|
|
310
|
+
>>> v1 == v2
|
|
311
|
+
True
|
|
312
|
+
>>> v2 == v3
|
|
313
|
+
False
|
|
314
|
+
|
|
315
|
+
"""
|
|
316
|
+
h = hashlib.sha256()
|
|
317
|
+
h.update(compas.json_dumps(self).encode())
|
|
318
|
+
if as_string:
|
|
319
|
+
return h.hexdigest()
|
|
320
|
+
return h.digest()
|
|
321
|
+
|
|
322
|
+
@classmethod
|
|
323
|
+
def validate_data(cls, data):
|
|
324
|
+
"""Validate the data against the object's data schema.
|
|
325
|
+
|
|
326
|
+
The data is the raw data that can be used to construct an object of this type with the classmethod ``__from_data__``.
|
|
327
|
+
|
|
328
|
+
Parameters
|
|
329
|
+
----------
|
|
330
|
+
data : Any
|
|
331
|
+
The data for validation.
|
|
332
|
+
|
|
333
|
+
Returns
|
|
334
|
+
-------
|
|
335
|
+
Any
|
|
336
|
+
|
|
337
|
+
"""
|
|
338
|
+
from jsonschema import Draft202012Validator
|
|
339
|
+
|
|
340
|
+
validator = Draft202012Validator(cls.DATASCHEMA) # type: ignore
|
|
341
|
+
validator.validate(data)
|
|
342
|
+
return data
|
compas/data/encoders.py
ADDED
|
@@ -0,0 +1,240 @@
|
|
|
1
|
+
from __future__ import absolute_import
|
|
2
|
+
from __future__ import division
|
|
3
|
+
from __future__ import print_function
|
|
4
|
+
|
|
5
|
+
try:
|
|
6
|
+
from typing import Type # noqa: F401
|
|
7
|
+
except ImportError:
|
|
8
|
+
pass
|
|
9
|
+
|
|
10
|
+
import json
|
|
11
|
+
import platform
|
|
12
|
+
|
|
13
|
+
from .data import Data # noqa: F401
|
|
14
|
+
from .exceptions import DecoderError
|
|
15
|
+
|
|
16
|
+
IDictionary = None
|
|
17
|
+
numpy_support = False
|
|
18
|
+
dotnet_support = False
|
|
19
|
+
|
|
20
|
+
# We don't do this from `compas.IPY` to avoid circular imports
|
|
21
|
+
if "ironpython" == platform.python_implementation().lower():
|
|
22
|
+
dotnet_support = True
|
|
23
|
+
|
|
24
|
+
try:
|
|
25
|
+
import System # type: ignore
|
|
26
|
+
from System.Collections.Generic import IDictionary # type: ignore
|
|
27
|
+
except: # noqa: E722
|
|
28
|
+
pass
|
|
29
|
+
|
|
30
|
+
try:
|
|
31
|
+
import numpy as np
|
|
32
|
+
|
|
33
|
+
numpy_support = True
|
|
34
|
+
except (ImportError, SyntaxError):
|
|
35
|
+
numpy_support = False
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
def cls_from_dtype(dtype): # type: (...) -> Type[Data]
|
|
39
|
+
"""Get the class object corresponding to a COMPAS data type specification.
|
|
40
|
+
|
|
41
|
+
Parameters
|
|
42
|
+
----------
|
|
43
|
+
dtype : str
|
|
44
|
+
The data type of the COMPAS object in the following format:
|
|
45
|
+
'{}/{}'.format(o.__class__.__module__, o.__class__.__name__).
|
|
46
|
+
|
|
47
|
+
Returns
|
|
48
|
+
-------
|
|
49
|
+
:class:`compas.data.Data`
|
|
50
|
+
|
|
51
|
+
Raises
|
|
52
|
+
------
|
|
53
|
+
ValueError
|
|
54
|
+
If the data type is not in the correct format.
|
|
55
|
+
ImportError
|
|
56
|
+
If the module can't be imported.
|
|
57
|
+
AttributeError
|
|
58
|
+
If the module doesn't contain the specified data type.
|
|
59
|
+
|
|
60
|
+
"""
|
|
61
|
+
mod_name, attr_name = dtype.split("/")
|
|
62
|
+
module = __import__(mod_name, fromlist=[attr_name])
|
|
63
|
+
return getattr(module, attr_name)
|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
class DataEncoder(json.JSONEncoder):
|
|
67
|
+
"""Data encoder for custom JSON serialization with support for COMPAS data structures and geometric primitives.
|
|
68
|
+
|
|
69
|
+
The encoder adds the following conversions to the JSON serialisation process:
|
|
70
|
+
|
|
71
|
+
* Numpy objects to their Python equivalents;
|
|
72
|
+
* iterables to lists; and
|
|
73
|
+
* :class:`compas.data.Data` objects,
|
|
74
|
+
such as geometric primitives and shapes, data structures, robots, ...,
|
|
75
|
+
to a dict with the following structure: ``{'dtype': o.__dtype__, 'data': o.__data__}``
|
|
76
|
+
|
|
77
|
+
See Also
|
|
78
|
+
--------
|
|
79
|
+
compas.data.Data
|
|
80
|
+
compas.data.DataDecoder
|
|
81
|
+
|
|
82
|
+
Examples
|
|
83
|
+
--------
|
|
84
|
+
Explicit use case.
|
|
85
|
+
|
|
86
|
+
>>> import json
|
|
87
|
+
>>> from compas.data import DataEncoder
|
|
88
|
+
>>> from compas.geometry import Point
|
|
89
|
+
>>> point = Point(0, 0, 0)
|
|
90
|
+
>>> with open("point.json", "w") as f:
|
|
91
|
+
... json.dump(point, f, cls=DataEncoder)
|
|
92
|
+
|
|
93
|
+
Implicit use case.
|
|
94
|
+
|
|
95
|
+
>>> from compas.data import json_dump
|
|
96
|
+
>>> from compas.geometry import Point
|
|
97
|
+
>>> point = Point(0, 0, 0)
|
|
98
|
+
>>> json_dump(point, "point.json")
|
|
99
|
+
|
|
100
|
+
"""
|
|
101
|
+
|
|
102
|
+
minimal = False
|
|
103
|
+
|
|
104
|
+
def default(self, o):
|
|
105
|
+
"""Return an object in serialized form.
|
|
106
|
+
|
|
107
|
+
Parameters
|
|
108
|
+
----------
|
|
109
|
+
o : object
|
|
110
|
+
The object to serialize.
|
|
111
|
+
|
|
112
|
+
Returns
|
|
113
|
+
-------
|
|
114
|
+
str
|
|
115
|
+
The serialized object.
|
|
116
|
+
|
|
117
|
+
"""
|
|
118
|
+
|
|
119
|
+
if hasattr(o, "__jsondump__"):
|
|
120
|
+
return o.__jsondump__(minimal=DataEncoder.minimal)
|
|
121
|
+
|
|
122
|
+
if hasattr(o, "__next__"):
|
|
123
|
+
return list(o)
|
|
124
|
+
|
|
125
|
+
if numpy_support:
|
|
126
|
+
if isinstance(o, np.ndarray):
|
|
127
|
+
return o.tolist()
|
|
128
|
+
if isinstance(
|
|
129
|
+
o,
|
|
130
|
+
(
|
|
131
|
+
np.int_,
|
|
132
|
+
np.intc,
|
|
133
|
+
np.intp,
|
|
134
|
+
np.int8,
|
|
135
|
+
np.int16,
|
|
136
|
+
np.int32,
|
|
137
|
+
np.int64,
|
|
138
|
+
np.uint8,
|
|
139
|
+
np.uint16,
|
|
140
|
+
np.uint32,
|
|
141
|
+
np.uint64,
|
|
142
|
+
), # type: ignore
|
|
143
|
+
):
|
|
144
|
+
return int(o)
|
|
145
|
+
if isinstance(o, (np.float_, np.float16, np.float32, np.float64)): # type: ignore
|
|
146
|
+
return float(o)
|
|
147
|
+
if isinstance(o, np.bool_):
|
|
148
|
+
return bool(o)
|
|
149
|
+
if isinstance(o, np.void):
|
|
150
|
+
return None
|
|
151
|
+
|
|
152
|
+
if dotnet_support:
|
|
153
|
+
if isinstance(o, (System.Decimal, System.Double, System.Single)):
|
|
154
|
+
return float(o)
|
|
155
|
+
|
|
156
|
+
return super(DataEncoder, self).default(o)
|
|
157
|
+
|
|
158
|
+
|
|
159
|
+
class DataDecoder(json.JSONDecoder):
|
|
160
|
+
"""Data decoder for custom JSON serialization with support for COMPAS data structures and geometric primitives.
|
|
161
|
+
|
|
162
|
+
The decoder hooks into the JSON deserialisation process
|
|
163
|
+
to reconstruct :class:`compas.data.Data` objects,
|
|
164
|
+
such as geometric primitives and shapes, data structures, robots, ...,
|
|
165
|
+
from the serialized data when possible.
|
|
166
|
+
|
|
167
|
+
The reconstruction is possible if
|
|
168
|
+
|
|
169
|
+
* the serialized data has the following structure: ``{"dtype": "...", 'data': {...}}``;
|
|
170
|
+
* a class can be imported into the current scope from the info in ``o["dtype"]``; and
|
|
171
|
+
* the imported class has a method ``__from_data__``.
|
|
172
|
+
|
|
173
|
+
See Also
|
|
174
|
+
--------
|
|
175
|
+
compas.data.Data
|
|
176
|
+
compas.data.DataEncoder
|
|
177
|
+
|
|
178
|
+
Examples
|
|
179
|
+
--------
|
|
180
|
+
Explicit use case.
|
|
181
|
+
|
|
182
|
+
>>> import json
|
|
183
|
+
>>> from compas.data import DataDecoder
|
|
184
|
+
>>> with open("point.json", "r") as f:
|
|
185
|
+
... point = json.load(f, cls=DataDecoder)
|
|
186
|
+
|
|
187
|
+
Implicit use case.
|
|
188
|
+
|
|
189
|
+
>>> from compas.data import json_load
|
|
190
|
+
>>> point = json_load("point.json")
|
|
191
|
+
|
|
192
|
+
"""
|
|
193
|
+
|
|
194
|
+
def __init__(self, *args, **kwargs):
|
|
195
|
+
super(DataDecoder, self).__init__(object_hook=self.object_hook, *args, **kwargs)
|
|
196
|
+
|
|
197
|
+
def object_hook(self, o):
|
|
198
|
+
"""Reconstruct a deserialized object.
|
|
199
|
+
|
|
200
|
+
Parameters
|
|
201
|
+
----------
|
|
202
|
+
o : object
|
|
203
|
+
|
|
204
|
+
Returns
|
|
205
|
+
-------
|
|
206
|
+
object
|
|
207
|
+
A (reconstructed), deserialized object.
|
|
208
|
+
|
|
209
|
+
"""
|
|
210
|
+
if "dtype" not in o:
|
|
211
|
+
return o
|
|
212
|
+
|
|
213
|
+
try:
|
|
214
|
+
cls = cls_from_dtype(o["dtype"])
|
|
215
|
+
|
|
216
|
+
except ValueError:
|
|
217
|
+
raise DecoderError(
|
|
218
|
+
"The data type of the object should be in the following format: '{}/{}'".format(
|
|
219
|
+
o.__class__.__module__,
|
|
220
|
+
o.__class__.__name__,
|
|
221
|
+
)
|
|
222
|
+
)
|
|
223
|
+
|
|
224
|
+
except ImportError:
|
|
225
|
+
raise DecoderError("The module of the data type can't be found: {}.".format(o["dtype"]))
|
|
226
|
+
|
|
227
|
+
except AttributeError:
|
|
228
|
+
raise DecoderError("The data type can't be found in the specified module: {}.".format(o["dtype"]))
|
|
229
|
+
|
|
230
|
+
data = o["data"]
|
|
231
|
+
guid = o.get("guid")
|
|
232
|
+
name = o.get("name")
|
|
233
|
+
|
|
234
|
+
# Kick-off __from_data__ from a rebuilt Python dictionary instead of the C# data type
|
|
235
|
+
if IDictionary and isinstance(o, IDictionary[str, object]):
|
|
236
|
+
data = {key: data[key] for key in data.Keys}
|
|
237
|
+
|
|
238
|
+
obj = cls.__jsonload__(data, guid=guid, name=name)
|
|
239
|
+
|
|
240
|
+
return obj
|