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.
Files changed (468) hide show
  1. compas/__init__.py +274 -0
  2. compas/__main__.py +31 -0
  3. compas/_iotools.py +80 -0
  4. compas/_os.py +746 -0
  5. compas/colors/__init__.py +14 -0
  6. compas/colors/cmcrameri/acton.txt +256 -0
  7. compas/colors/cmcrameri/actonS.txt +100 -0
  8. compas/colors/cmcrameri/bam.txt +256 -0
  9. compas/colors/cmcrameri/bamO.txt +256 -0
  10. compas/colors/cmcrameri/bamako.txt +256 -0
  11. compas/colors/cmcrameri/bamakoS.txt +100 -0
  12. compas/colors/cmcrameri/batlow.txt +256 -0
  13. compas/colors/cmcrameri/batlowK.txt +256 -0
  14. compas/colors/cmcrameri/batlowS.txt +100 -0
  15. compas/colors/cmcrameri/batlowW.txt +256 -0
  16. compas/colors/cmcrameri/berlin.txt +256 -0
  17. compas/colors/cmcrameri/bilbao.txt +256 -0
  18. compas/colors/cmcrameri/bilbaoS.txt +100 -0
  19. compas/colors/cmcrameri/broc.txt +256 -0
  20. compas/colors/cmcrameri/brocO.txt +256 -0
  21. compas/colors/cmcrameri/buda.txt +256 -0
  22. compas/colors/cmcrameri/budaS.txt +100 -0
  23. compas/colors/cmcrameri/bukavu.txt +256 -0
  24. compas/colors/cmcrameri/cork.txt +256 -0
  25. compas/colors/cmcrameri/corkO.txt +256 -0
  26. compas/colors/cmcrameri/davos.txt +256 -0
  27. compas/colors/cmcrameri/davosS.txt +100 -0
  28. compas/colors/cmcrameri/devon.txt +256 -0
  29. compas/colors/cmcrameri/devonS.txt +100 -0
  30. compas/colors/cmcrameri/fes.txt +256 -0
  31. compas/colors/cmcrameri/grayC.txt +256 -0
  32. compas/colors/cmcrameri/grayCS.txt +100 -0
  33. compas/colors/cmcrameri/hawaii.txt +256 -0
  34. compas/colors/cmcrameri/hawaiiS.txt +100 -0
  35. compas/colors/cmcrameri/imola.txt +256 -0
  36. compas/colors/cmcrameri/imolaS.txt +100 -0
  37. compas/colors/cmcrameri/lajolla.txt +256 -0
  38. compas/colors/cmcrameri/lajollaS.txt +100 -0
  39. compas/colors/cmcrameri/lapaz.txt +256 -0
  40. compas/colors/cmcrameri/lapazS.txt +100 -0
  41. compas/colors/cmcrameri/lisbon.txt +256 -0
  42. compas/colors/cmcrameri/nuuk.txt +256 -0
  43. compas/colors/cmcrameri/nuukS.txt +100 -0
  44. compas/colors/cmcrameri/oleron.txt +256 -0
  45. compas/colors/cmcrameri/oslo.txt +256 -0
  46. compas/colors/cmcrameri/osloS.txt +100 -0
  47. compas/colors/cmcrameri/roma.txt +256 -0
  48. compas/colors/cmcrameri/romaO.txt +256 -0
  49. compas/colors/cmcrameri/tofino.txt +256 -0
  50. compas/colors/cmcrameri/tokyo.txt +256 -0
  51. compas/colors/cmcrameri/tokyoS.txt +100 -0
  52. compas/colors/cmcrameri/turku.txt +256 -0
  53. compas/colors/cmcrameri/turkuS.txt +100 -0
  54. compas/colors/cmcrameri/vanimo.txt +256 -0
  55. compas/colors/cmcrameri/vik.txt +256 -0
  56. compas/colors/cmcrameri/vikO.txt +256 -0
  57. compas/colors/color.py +1118 -0
  58. compas/colors/colordict.py +103 -0
  59. compas/colors/colormap.py +306 -0
  60. compas/colors/html_colors.py +149 -0
  61. compas/colors/mpl_colormap.py +1064 -0
  62. compas/data/__init__.py +31 -0
  63. compas/data/coercion.py +71 -0
  64. compas/data/conftest.py +10 -0
  65. compas/data/data.py +342 -0
  66. compas/data/encoders.py +240 -0
  67. compas/data/exceptions.py +2 -0
  68. compas/data/json.py +240 -0
  69. compas/data/samples/boxes.obj +250 -0
  70. compas/data/samples/butt_model.obj +2829 -0
  71. compas/data/samples/cone.stl +0 -0
  72. compas/data/samples/cube.off +16 -0
  73. compas/data/samples/cube_ascii.stl +56114 -0
  74. compas/data/samples/cube_binary.stl +0 -0
  75. compas/data/samples/cube_binary_2.stl +0 -0
  76. compas/data/samples/doosabin.json +1 -0
  77. compas/data/samples/faces.obj +63 -0
  78. compas/data/samples/faces_big.obj +9663 -0
  79. compas/data/samples/faces_reversed.obj +63 -0
  80. compas/data/samples/fink.obj +135 -0
  81. compas/data/samples/grid_irregular.obj +303 -0
  82. compas/data/samples/hypar.obj +148 -0
  83. compas/data/samples/lines.json +1 -0
  84. compas/data/samples/lines.obj +282 -0
  85. compas/data/samples/lines_big.obj +40322 -0
  86. compas/data/samples/lines_bigger.obj +161282 -0
  87. compas/data/samples/lines_noleaves.obj +422 -0
  88. compas/data/samples/mesh.obj +874 -0
  89. compas/data/samples/mesh_100_faces.json +1893 -0
  90. compas/data/samples/mesh_110_faces.json +2081 -0
  91. compas/data/samples/open_edges.obj +424 -0
  92. compas/data/samples/point.json +1 -0
  93. compas/data/samples/quadmesh.obj +183 -0
  94. compas/data/samples/quadmesh_planar.obj +181 -0
  95. compas/data/samples/saddle.obj +314 -0
  96. compas/data/samples/spline.obj +72 -0
  97. compas/data/samples/tubemesh.json +1 -0
  98. compas/data/samples/tubemesh.obj +378 -0
  99. compas/data/samples/tubemesh.off +374 -0
  100. compas/data/samples/tubemesh.ply +551 -0
  101. compas/data/schema.py +137 -0
  102. compas/data/validators.py +243 -0
  103. compas/datastructures/__init__.py +75 -0
  104. compas/datastructures/_mutablemapping.py +148 -0
  105. compas/datastructures/assembly/__init__.py +0 -0
  106. compas/datastructures/assembly/assembly.py +234 -0
  107. compas/datastructures/assembly/exceptions.py +6 -0
  108. compas/datastructures/assembly/part.py +228 -0
  109. compas/datastructures/attributes.py +85 -0
  110. compas/datastructures/cell_network/__init__.py +0 -0
  111. compas/datastructures/cell_network/cell_network.py +4190 -0
  112. compas/datastructures/datastructure.py +309 -0
  113. compas/datastructures/graph/__init__.py +0 -0
  114. compas/datastructures/graph/duality.py +197 -0
  115. compas/datastructures/graph/graph.py +2478 -0
  116. compas/datastructures/graph/operations/__init__.py +0 -0
  117. compas/datastructures/graph/operations/join.py +124 -0
  118. compas/datastructures/graph/operations/split.py +63 -0
  119. compas/datastructures/graph/planarity.py +292 -0
  120. compas/datastructures/graph/smoothing.py +59 -0
  121. compas/datastructures/mesh/__init__.py +0 -0
  122. compas/datastructures/mesh/conway.py +553 -0
  123. compas/datastructures/mesh/duality.py +104 -0
  124. compas/datastructures/mesh/mesh.py +5103 -0
  125. compas/datastructures/mesh/operations/__init__.py +0 -0
  126. compas/datastructures/mesh/operations/collapse.py +350 -0
  127. compas/datastructures/mesh/operations/extrude.py +0 -0
  128. compas/datastructures/mesh/operations/insert.py +120 -0
  129. compas/datastructures/mesh/operations/merge.py +83 -0
  130. compas/datastructures/mesh/operations/split.py +263 -0
  131. compas/datastructures/mesh/operations/substitute.py +37 -0
  132. compas/datastructures/mesh/operations/swap.py +62 -0
  133. compas/datastructures/mesh/operations/weld.py +107 -0
  134. compas/datastructures/mesh/remesh.py +234 -0
  135. compas/datastructures/mesh/slice.py +170 -0
  136. compas/datastructures/mesh/smoothing.py +187 -0
  137. compas/datastructures/mesh/subdivision.py +754 -0
  138. compas/datastructures/tree/__init__.py +0 -0
  139. compas/datastructures/tree/tree.py +504 -0
  140. compas/datastructures/volmesh/__init__.py +0 -0
  141. compas/datastructures/volmesh/volmesh.py +4203 -0
  142. compas/files/__init__.py +27 -0
  143. compas/files/_xml/__init__.py +0 -0
  144. compas/files/_xml/xml_cli.py +213 -0
  145. compas/files/_xml/xml_cpython.py +32 -0
  146. compas/files/_xml/xml_pre_38.py +58 -0
  147. compas/files/_xml/xml_shared.py +40 -0
  148. compas/files/gltf/__init__.py +0 -0
  149. compas/files/gltf/constants.py +59 -0
  150. compas/files/gltf/data_classes.py +657 -0
  151. compas/files/gltf/extensions.py +317 -0
  152. compas/files/gltf/gltf.py +92 -0
  153. compas/files/gltf/gltf_children.py +64 -0
  154. compas/files/gltf/gltf_content.py +615 -0
  155. compas/files/gltf/gltf_exporter.py +465 -0
  156. compas/files/gltf/gltf_mesh.py +273 -0
  157. compas/files/gltf/gltf_node.py +348 -0
  158. compas/files/gltf/gltf_parser.py +115 -0
  159. compas/files/gltf/gltf_reader.py +310 -0
  160. compas/files/gltf/gltf_scene.py +125 -0
  161. compas/files/gltf/helpers.py +59 -0
  162. compas/files/obj.py +680 -0
  163. compas/files/off.py +296 -0
  164. compas/files/ply.py +697 -0
  165. compas/files/stl.py +436 -0
  166. compas/files/xml.py +328 -0
  167. compas/geometry/__init__.py +772 -0
  168. compas/geometry/_core/__init__.py +0 -0
  169. compas/geometry/_core/_algebra.py +2826 -0
  170. compas/geometry/_core/angles.py +408 -0
  171. compas/geometry/_core/centroids.py +573 -0
  172. compas/geometry/_core/distance.py +895 -0
  173. compas/geometry/_core/normals.py +149 -0
  174. compas/geometry/_core/nurbs.py +367 -0
  175. compas/geometry/_core/predicates_2.py +582 -0
  176. compas/geometry/_core/predicates_3.py +1111 -0
  177. compas/geometry/_core/quaternions.py +196 -0
  178. compas/geometry/_core/size.py +204 -0
  179. compas/geometry/_core/tangent.py +56 -0
  180. compas/geometry/_core/transformations.py +1121 -0
  181. compas/geometry/_core/transformations_numpy.py +279 -0
  182. compas/geometry/bbox.py +145 -0
  183. compas/geometry/bbox_numpy.py +306 -0
  184. compas/geometry/bestfit.py +77 -0
  185. compas/geometry/bestfit_numpy.py +259 -0
  186. compas/geometry/booleans.py +297 -0
  187. compas/geometry/booleans_shapely.py +147 -0
  188. compas/geometry/brep/__init__.py +112 -0
  189. compas/geometry/brep/brep.py +1131 -0
  190. compas/geometry/brep/edge.py +302 -0
  191. compas/geometry/brep/errors.py +22 -0
  192. compas/geometry/brep/face.py +329 -0
  193. compas/geometry/brep/loop.py +87 -0
  194. compas/geometry/brep/trim.py +46 -0
  195. compas/geometry/brep/vertex.py +46 -0
  196. compas/geometry/contours.py +32 -0
  197. compas/geometry/curves/__init__.py +0 -0
  198. compas/geometry/curves/arc.py +429 -0
  199. compas/geometry/curves/bezier.py +345 -0
  200. compas/geometry/curves/circle.py +500 -0
  201. compas/geometry/curves/conic.py +16 -0
  202. compas/geometry/curves/curve.py +614 -0
  203. compas/geometry/curves/ellipse.py +408 -0
  204. compas/geometry/curves/hyperbola.py +336 -0
  205. compas/geometry/curves/line.py +431 -0
  206. compas/geometry/curves/nurbs.py +412 -0
  207. compas/geometry/curves/parabola.py +256 -0
  208. compas/geometry/curves/polyline.py +724 -0
  209. compas/geometry/frame.py +769 -0
  210. compas/geometry/geometry.py +296 -0
  211. compas/geometry/hull.py +146 -0
  212. compas/geometry/hull_numpy.py +82 -0
  213. compas/geometry/icp_numpy.py +104 -0
  214. compas/geometry/interpolation_barycentric.py +38 -0
  215. compas/geometry/interpolation_coons.py +102 -0
  216. compas/geometry/interpolation_tweening.py +87 -0
  217. compas/geometry/intersection.py +121 -0
  218. compas/geometry/intersections.py +1105 -0
  219. compas/geometry/kdtree.py +153 -0
  220. compas/geometry/offset.py +208 -0
  221. compas/geometry/pca_numpy.py +87 -0
  222. compas/geometry/plane.py +657 -0
  223. compas/geometry/point.py +664 -0
  224. compas/geometry/pointcloud.py +409 -0
  225. compas/geometry/polygon.py +473 -0
  226. compas/geometry/polyhedron.py +650 -0
  227. compas/geometry/projection.py +155 -0
  228. compas/geometry/quadmesh_planarize.py +30 -0
  229. compas/geometry/quadmesh_planarize_none.py +114 -0
  230. compas/geometry/quaternion.py +544 -0
  231. compas/geometry/reflection.py +102 -0
  232. compas/geometry/rotation.py +354 -0
  233. compas/geometry/scale.py +100 -0
  234. compas/geometry/shapes/__init__.py +0 -0
  235. compas/geometry/shapes/box.py +747 -0
  236. compas/geometry/shapes/capsule.py +472 -0
  237. compas/geometry/shapes/cone.py +309 -0
  238. compas/geometry/shapes/cylinder.py +355 -0
  239. compas/geometry/shapes/shape.py +300 -0
  240. compas/geometry/shapes/sphere.py +362 -0
  241. compas/geometry/shapes/torus.py +294 -0
  242. compas/geometry/shear.py +115 -0
  243. compas/geometry/surfaces/__init__.py +0 -0
  244. compas/geometry/surfaces/conical.py +166 -0
  245. compas/geometry/surfaces/cylindrical.py +251 -0
  246. compas/geometry/surfaces/extrusion.py +0 -0
  247. compas/geometry/surfaces/nurbs.py +380 -0
  248. compas/geometry/surfaces/planar.py +223 -0
  249. compas/geometry/surfaces/revolution.py +0 -0
  250. compas/geometry/surfaces/spherical.py +259 -0
  251. compas/geometry/surfaces/surface.py +689 -0
  252. compas/geometry/surfaces/toroidal.py +198 -0
  253. compas/geometry/transformation.py +554 -0
  254. compas/geometry/translation.py +104 -0
  255. compas/geometry/triangulation_delaunay.py +102 -0
  256. compas/geometry/triangulation_earclip.py +300 -0
  257. compas/geometry/trimesh_curvature.py +113 -0
  258. compas/geometry/trimesh_descent_numpy.py +26 -0
  259. compas/geometry/trimesh_geodistance.py +35 -0
  260. compas/geometry/trimesh_gradient_numpy.py +74 -0
  261. compas/geometry/trimesh_isolines.py +41 -0
  262. compas/geometry/trimesh_matrices.py +31 -0
  263. compas/geometry/trimesh_matrices_numpy.py +191 -0
  264. compas/geometry/trimesh_parametrisation.py +55 -0
  265. compas/geometry/trimesh_pull_points_numpy.py +216 -0
  266. compas/geometry/trimesh_remeshing.py +97 -0
  267. compas/geometry/trimesh_samplepoints_numpy.py +108 -0
  268. compas/geometry/trimesh_slicing.py +28 -0
  269. compas/geometry/trimesh_smoothing_numpy.py +34 -0
  270. compas/geometry/vector.py +889 -0
  271. compas/itertools.py +441 -0
  272. compas/linalg.py +634 -0
  273. compas/matrices.py +314 -0
  274. compas/plugins.py +488 -0
  275. compas/rpc/__init__.py +20 -0
  276. compas/rpc/__main__.py +77 -0
  277. compas/rpc/dispatcher.py +181 -0
  278. compas/rpc/errors.py +11 -0
  279. compas/rpc/proxy.py +437 -0
  280. compas/rpc/server.py +79 -0
  281. compas/rpc/services/__init__.py +0 -0
  282. compas/rpc/services/default.py +87 -0
  283. compas/rpc/services/watcher.py +43 -0
  284. compas/scene/__init__.py +56 -0
  285. compas/scene/assemblyobject.py +3 -0
  286. compas/scene/context.py +154 -0
  287. compas/scene/descriptors/__init__.py +0 -0
  288. compas/scene/descriptors/attribute.py +30 -0
  289. compas/scene/descriptors/color.py +91 -0
  290. compas/scene/descriptors/colordict.py +101 -0
  291. compas/scene/descriptors/protocol.py +12 -0
  292. compas/scene/exceptions.py +7 -0
  293. compas/scene/geometryobject.py +58 -0
  294. compas/scene/graphobject.py +173 -0
  295. compas/scene/meshobject.py +238 -0
  296. compas/scene/scene.py +144 -0
  297. compas/scene/sceneobject.py +253 -0
  298. compas/scene/volmeshobject.py +252 -0
  299. compas/tolerance.py +879 -0
  300. compas/topology/__init__.py +45 -0
  301. compas/topology/combinatorics.py +108 -0
  302. compas/topology/connectivity.py +129 -0
  303. compas/topology/orientation.py +204 -0
  304. compas/topology/traversal.py +567 -0
  305. compas/utilities/__init__.py +25 -0
  306. compas/utilities/azync.py +155 -0
  307. compas/utilities/datetime.py +40 -0
  308. compas/utilities/decorators.py +136 -0
  309. compas/utilities/remote.py +54 -0
  310. compas/utilities/ssh.py +169 -0
  311. compas-2.1.1.dist-info/AUTHORS.md +42 -0
  312. compas-2.1.1.dist-info/LICENSE +21 -0
  313. compas-2.1.1.dist-info/METADATA +132 -0
  314. compas-2.1.1.dist-info/RECORD +468 -0
  315. compas-2.1.1.dist-info/WHEEL +5 -0
  316. compas-2.1.1.dist-info/entry_points.txt +2 -0
  317. compas-2.1.1.dist-info/top_level.txt +4 -0
  318. compas_blender/__init__.py +250 -0
  319. compas_blender/collections.py +130 -0
  320. compas_blender/conversions/__init__.py +48 -0
  321. compas_blender/conversions/breps.py +0 -0
  322. compas_blender/conversions/colors.py +23 -0
  323. compas_blender/conversions/curves.py +125 -0
  324. compas_blender/conversions/geometry.py +161 -0
  325. compas_blender/conversions/meshes.py +148 -0
  326. compas_blender/conversions/surfaces.py +48 -0
  327. compas_blender/conversions/transformations.py +46 -0
  328. compas_blender/data.py +30 -0
  329. compas_blender/geometry/__init__.py +14 -0
  330. compas_blender/geometry/booleans.py +100 -0
  331. compas_blender/install.py +338 -0
  332. compas_blender/objects.py +326 -0
  333. compas_blender/print_python_path.py +18 -0
  334. compas_blender/scene/__init__.py +116 -0
  335. compas_blender/scene/boxobject.py +64 -0
  336. compas_blender/scene/capsuleobject.py +73 -0
  337. compas_blender/scene/circleobject.py +53 -0
  338. compas_blender/scene/coneobject.py +70 -0
  339. compas_blender/scene/curveobject.py +58 -0
  340. compas_blender/scene/cylinderobject.py +70 -0
  341. compas_blender/scene/frameobject.py +105 -0
  342. compas_blender/scene/graphobject.py +257 -0
  343. compas_blender/scene/lineobject.py +60 -0
  344. compas_blender/scene/meshobject.py +508 -0
  345. compas_blender/scene/planeobject.py +81 -0
  346. compas_blender/scene/pointcloudobject.py +67 -0
  347. compas_blender/scene/pointobject.py +71 -0
  348. compas_blender/scene/polygonobject.py +57 -0
  349. compas_blender/scene/polyhedronobject.py +57 -0
  350. compas_blender/scene/polylineobject.py +54 -0
  351. compas_blender/scene/sceneobject.py +249 -0
  352. compas_blender/scene/sphereobject.py +72 -0
  353. compas_blender/scene/surfaceobject.py +54 -0
  354. compas_blender/scene/torusobject.py +73 -0
  355. compas_blender/scene/vectorobject.py +69 -0
  356. compas_blender/scene/volmeshobject.py +475 -0
  357. compas_blender/utilities/__init__.py +38 -0
  358. compas_blender/utilities/drawing.py +768 -0
  359. compas_ghpython/__init__.py +124 -0
  360. compas_ghpython/components/Compas_FromJson/code.py +18 -0
  361. compas_ghpython/components/Compas_Info/code.py +15 -0
  362. compas_ghpython/components/Compas_RpcCall/code.py +31 -0
  363. compas_ghpython/components/Compas_ToJson/code.py +19 -0
  364. compas_ghpython/components/Compas_ToRhinoGeometry/code.py +15 -0
  365. compas_ghpython/components/__init__.py +99 -0
  366. compas_ghpython/install.py +29 -0
  367. compas_ghpython/scene/__init__.py +115 -0
  368. compas_ghpython/scene/boxobject.py +40 -0
  369. compas_ghpython/scene/brepobject.py +40 -0
  370. compas_ghpython/scene/capsuleobject.py +41 -0
  371. compas_ghpython/scene/circleobject.py +40 -0
  372. compas_ghpython/scene/coneobject.py +40 -0
  373. compas_ghpython/scene/curveobject.py +42 -0
  374. compas_ghpython/scene/cylinderobject.py +38 -0
  375. compas_ghpython/scene/ellipseobject.py +40 -0
  376. compas_ghpython/scene/frameobject.py +67 -0
  377. compas_ghpython/scene/graphobject.py +77 -0
  378. compas_ghpython/scene/lineobject.py +39 -0
  379. compas_ghpython/scene/meshobject.py +137 -0
  380. compas_ghpython/scene/planeobject.py +61 -0
  381. compas_ghpython/scene/pointobject.py +38 -0
  382. compas_ghpython/scene/polygonobject.py +48 -0
  383. compas_ghpython/scene/polyhedronobject.py +48 -0
  384. compas_ghpython/scene/polylineobject.py +39 -0
  385. compas_ghpython/scene/sceneobject.py +12 -0
  386. compas_ghpython/scene/sphereobject.py +39 -0
  387. compas_ghpython/scene/surfaceobject.py +42 -0
  388. compas_ghpython/scene/torusobject.py +39 -0
  389. compas_ghpython/scene/vectorobject.py +51 -0
  390. compas_ghpython/scene/volmeshobject.py +154 -0
  391. compas_ghpython/sets.py +83 -0
  392. compas_ghpython/timer.py +36 -0
  393. compas_ghpython/uninstall.py +31 -0
  394. compas_ghpython/utilities/__init__.py +33 -0
  395. compas_ghpython/utilities/drawing.py +457 -0
  396. compas_rhino/__init__.py +607 -0
  397. compas_rhino/conduits/__init__.py +16 -0
  398. compas_rhino/conduits/base.py +121 -0
  399. compas_rhino/conduits/faces.py +91 -0
  400. compas_rhino/conduits/labels.py +102 -0
  401. compas_rhino/conduits/lines.py +109 -0
  402. compas_rhino/conduits/points.py +111 -0
  403. compas_rhino/conversions/__init__.py +168 -0
  404. compas_rhino/conversions/breps.py +122 -0
  405. compas_rhino/conversions/curves.py +453 -0
  406. compas_rhino/conversions/docobjects.py +0 -0
  407. compas_rhino/conversions/exceptions.py +7 -0
  408. compas_rhino/conversions/extrusions.py +80 -0
  409. compas_rhino/conversions/geometry.py +187 -0
  410. compas_rhino/conversions/meshes.py +281 -0
  411. compas_rhino/conversions/shapes.py +291 -0
  412. compas_rhino/conversions/surfaces.py +355 -0
  413. compas_rhino/conversions/transformations.py +45 -0
  414. compas_rhino/geometry/__init__.py +44 -0
  415. compas_rhino/geometry/booleans.py +118 -0
  416. compas_rhino/geometry/brep/__init__.py +40 -0
  417. compas_rhino/geometry/brep/brep.py +554 -0
  418. compas_rhino/geometry/brep/builder.py +184 -0
  419. compas_rhino/geometry/brep/edge.py +202 -0
  420. compas_rhino/geometry/brep/face.py +285 -0
  421. compas_rhino/geometry/brep/loop.py +129 -0
  422. compas_rhino/geometry/brep/trim.py +99 -0
  423. compas_rhino/geometry/brep/vertex.py +76 -0
  424. compas_rhino/geometry/curves/__init__.py +43 -0
  425. compas_rhino/geometry/curves/curve.py +382 -0
  426. compas_rhino/geometry/curves/nurbs.py +298 -0
  427. compas_rhino/geometry/surfaces/__init__.py +50 -0
  428. compas_rhino/geometry/surfaces/nurbs.py +370 -0
  429. compas_rhino/geometry/surfaces/surface.py +407 -0
  430. compas_rhino/geometry/trimesh_curvature.py +344 -0
  431. compas_rhino/geometry/trimesh_slicing.py +65 -0
  432. compas_rhino/install.py +382 -0
  433. compas_rhino/install_plugin.py +169 -0
  434. compas_rhino/install_with_pip.py +20 -0
  435. compas_rhino/layers.py +347 -0
  436. compas_rhino/objects.py +1141 -0
  437. compas_rhino/print_python_path.py +18 -0
  438. compas_rhino/scene/__init__.py +123 -0
  439. compas_rhino/scene/boxobject.py +44 -0
  440. compas_rhino/scene/brepobject.py +41 -0
  441. compas_rhino/scene/capsuleobject.py +45 -0
  442. compas_rhino/scene/circleobject.py +43 -0
  443. compas_rhino/scene/coneobject.py +43 -0
  444. compas_rhino/scene/curveobject.py +43 -0
  445. compas_rhino/scene/cylinderobject.py +43 -0
  446. compas_rhino/scene/ellipseobject.py +44 -0
  447. compas_rhino/scene/frameobject.py +99 -0
  448. compas_rhino/scene/graphobject.py +364 -0
  449. compas_rhino/scene/helpers.py +33 -0
  450. compas_rhino/scene/lineobject.py +43 -0
  451. compas_rhino/scene/meshobject.py +673 -0
  452. compas_rhino/scene/planeobject.py +71 -0
  453. compas_rhino/scene/pointobject.py +43 -0
  454. compas_rhino/scene/polygonobject.py +45 -0
  455. compas_rhino/scene/polyhedronobject.py +45 -0
  456. compas_rhino/scene/polylineobject.py +43 -0
  457. compas_rhino/scene/sceneobject.py +123 -0
  458. compas_rhino/scene/sphereobject.py +43 -0
  459. compas_rhino/scene/surfaceobject.py +42 -0
  460. compas_rhino/scene/torusobject.py +43 -0
  461. compas_rhino/scene/vectorobject.py +49 -0
  462. compas_rhino/scene/volmeshobject.py +518 -0
  463. compas_rhino/ui.py +114 -0
  464. compas_rhino/uninstall.py +243 -0
  465. compas_rhino/uninstall_plugin.py +91 -0
  466. compas_rhino/utilities/__init__.py +37 -0
  467. compas_rhino/utilities/constructors.py +71 -0
  468. 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()