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/files/stl.py ADDED
@@ -0,0 +1,436 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ import struct
6
+
7
+ from compas import _iotools
8
+ from compas.geometry import Translation
9
+ from compas.tolerance import TOL
10
+
11
+
12
+ class STL(object):
13
+ """Class for working with STL files.
14
+
15
+ Parameters
16
+ ----------
17
+ filepath : path string | file-like object | URL string
18
+ A path, a file-like object or a URL pointing to a file.
19
+ precision : int, optional
20
+ Precision for converting numbers to strings.
21
+ Default is :attr:`TOL.precision`.
22
+
23
+ Attributes
24
+ ----------
25
+ reader : :class:`STLReader`
26
+ A STL file reader.
27
+ parser : :class:`STLParser`
28
+ A STL file parser.
29
+
30
+ """
31
+
32
+ def __init__(self, filepath, precision=None):
33
+ self.filepath = filepath
34
+ self.precision = precision
35
+ self._is_parsed = False
36
+ self._reader = None
37
+ self._parser = None
38
+ self._writer = None
39
+
40
+ @property
41
+ def reader(self):
42
+ if not self._is_parsed:
43
+ self.read()
44
+ return self._reader
45
+
46
+ @property
47
+ def parser(self):
48
+ if not self._is_parsed:
49
+ self.read()
50
+ return self._parser
51
+
52
+ def read(self):
53
+ """Read and parse the contents of the file.
54
+
55
+ Returns
56
+ -------
57
+ None
58
+
59
+ """
60
+ self._reader = STLReader(self.filepath)
61
+ self._parser = STLParser(self._reader, precision=self.precision)
62
+ self._is_parsed = True
63
+
64
+ def write(self, mesh, **kwargs):
65
+ """Write a mesh to the file.
66
+
67
+ Parameters
68
+ ----------
69
+ mesh : :class:`compas.datastructures.Mesh`
70
+ The mesh.
71
+ binary : bool, optional
72
+ Flag indicating that the file should be written in binary format.
73
+ solid_name : str, optional
74
+ The name of the solid.
75
+ Defaults to the name of the mesh.
76
+ precision : str, optional
77
+ COMPAS precision specification for parsing geometric data.
78
+
79
+ Returns
80
+ -------
81
+ None
82
+
83
+ """
84
+ self._writer = STLWriter(self.filepath, mesh, **kwargs)
85
+ self._writer.write()
86
+
87
+
88
+ class STLReader(object):
89
+ """Class for reading raw geometric data from STL files.
90
+
91
+ Parameters
92
+ ----------
93
+ filepath : path string | file-like object | URL string
94
+ A path, a file-like object or a URL pointing to a file.
95
+
96
+ References
97
+ ----------
98
+ * http://paulbourke.net/dataformats/stl/
99
+
100
+ """
101
+
102
+ def __init__(self, filepath):
103
+ self.filepath = filepath
104
+ self.file = None
105
+ self.header = None
106
+ self.facets = []
107
+ self.read()
108
+
109
+ def read(self):
110
+ """Read the data.
111
+
112
+ Returns
113
+ -------
114
+ None
115
+
116
+ """
117
+ is_binary = False
118
+ with _iotools.open_file(self.filepath, "rb") as file:
119
+ line = file.readline().strip()
120
+ if b"solid" in line:
121
+ is_binary = False
122
+ else:
123
+ is_binary = True
124
+ try:
125
+ if not is_binary:
126
+ self._read_ascii()
127
+ else:
128
+ self._read_binary()
129
+ except Exception:
130
+ # raise if it was already detected as binary, but failed anyway
131
+ if is_binary:
132
+ raise
133
+ # else, ascii parsing failed, try binary
134
+ is_binary = True
135
+ self._read_binary()
136
+
137
+ # ==========================================================================
138
+ # ascii
139
+ #
140
+ # @see: https://en.wikipedia.org/wiki/STL_(file_format)
141
+ #
142
+ # solid name
143
+ # facet normal ni nj nk
144
+ # outer loop
145
+ # vertex v1x v1y v1z
146
+ # vertex v2x v2y v2z
147
+ # vertex v3x v3y v3z
148
+ # endloop
149
+ # endfacet
150
+ # endsolid name
151
+ #
152
+ # ==========================================================================
153
+
154
+ def _read_ascii(self):
155
+ with _iotools.open_file(self.filepath, "r") as file:
156
+ self.file = file
157
+ self.file.seek(0)
158
+ self.facets = self._read_solids_ascii()
159
+
160
+ def _read_solids_ascii(self):
161
+ if not self.file:
162
+ return
163
+
164
+ solids = {}
165
+ facets = []
166
+
167
+ while True:
168
+ line = self.file.readline().strip()
169
+
170
+ if not line:
171
+ break
172
+
173
+ parts = line.split()
174
+
175
+ if parts[0] == "solid":
176
+ if len(parts) == 2:
177
+ name = parts[1]
178
+ else:
179
+ name = "solid"
180
+ solids[name] = []
181
+
182
+ elif parts[0] == "endsolid":
183
+ name = None
184
+
185
+ elif parts[0] == "facet":
186
+ facet = {"normal": None, "vertices": None}
187
+ if parts[1] == "normal":
188
+ facet["normal"] = [float(parts[i]) for i in range(2, 5)]
189
+
190
+ elif parts[0] == "outer" and parts[1] == "loop":
191
+ vertices = []
192
+
193
+ elif parts[0] == "vertex":
194
+ xyz = [float(parts[i]) for i in range(1, 4)]
195
+ vertices.append(xyz)
196
+
197
+ elif parts[0] == "endloop":
198
+ facet["vertices"] = vertices
199
+
200
+ elif parts[0] == "endfacet":
201
+ solids[name].append(facet)
202
+ facets.append(facet)
203
+
204
+ # no known line start matches, maybe not ascii
205
+ elif not parts[0].isalnum():
206
+ raise RuntimeError("File is not ASCII")
207
+
208
+ return facets
209
+
210
+ # ==========================================================================
211
+ # binary
212
+ #
213
+ # @see: https://en.wikipedia.org/wiki/STL_(file_format)
214
+ #
215
+ # UINT8[80] - Header
216
+ # UINT32 - Number of triangles
217
+ #
218
+ # foreach triangle
219
+ # REAL32[3] - Normal vector
220
+ # REAL32[3] - Vertex 1
221
+ # REAL32[3] - Vertex 2
222
+ # REAL32[3] - Vertex 3
223
+ # UINT16 - Attribute byte count
224
+ # end
225
+ #
226
+ # ==========================================================================
227
+
228
+ def _read_uint16(self):
229
+ bytes_ = self.file.read(2)
230
+ return struct.unpack("<H", bytes_)[0]
231
+
232
+ def _read_uint32(self):
233
+ bytes_ = self.file.read(4)
234
+ return struct.unpack("<I", bytes_)[0]
235
+
236
+ def _read_binary(self):
237
+ with _iotools.open_file(self.filepath, "rb") as file:
238
+ self.file = file
239
+ self.file.seek(0)
240
+ self.header = self._read_header_binary()
241
+ self.facets = self._read_facets_binary()
242
+
243
+ def _read_header_binary(self):
244
+ bytes_ = self.file.read(80)
245
+ return struct.unpack("80s", bytes_)[0]
246
+
247
+ def _read_number_of_facets_binary(self):
248
+ return self._read_uint32()
249
+
250
+ def _read_facet_binary(self):
251
+ # Read full facet at once
252
+ # 4 bytes per float * 3 floats per vector/vertex * 4 items (1 vector + 3 vertices)
253
+ bytes_ = self.file.read(48)
254
+ floats_ = struct.unpack("<12f", bytes_)
255
+
256
+ normal = floats_[0:3]
257
+ vertices = (floats_[3:6], floats_[6:9], floats_[9:12])
258
+ keys = (bytes_[12:24], bytes_[24:36], bytes_[36:48])
259
+
260
+ # Skip two-byte attributes, it's not used anywhere (by anyone - on this planet)
261
+ self.file.seek(2, 1)
262
+
263
+ return {"normal": normal, "vertices": vertices, "keys": keys}
264
+
265
+ def _read_facets_binary(self):
266
+ facets = []
267
+ n = self._read_number_of_facets_binary()
268
+ for i in range(n):
269
+ facets.append(self._read_facet_binary())
270
+ return facets
271
+
272
+
273
+ class STLParser(object):
274
+ """Class for parsing data from a STL file.
275
+
276
+ The parser converts the raw geometric data of the file
277
+ into corresponding COMPAS geometry objects and data structures.
278
+
279
+ Parameters
280
+ ----------
281
+ reader : :class:`STLReader`
282
+ A STL file reader.
283
+ precision : str, optional
284
+ COMPAS precision specification for parsing geometric data.
285
+
286
+ Attributes
287
+ ----------
288
+ vertices : list[list[float]]
289
+ The vertex coordinates.
290
+ faces : list[list[int]]
291
+ The faces as lists of vertex indices.
292
+
293
+ """
294
+
295
+ def __init__(self, reader, precision=None):
296
+ self.precision = precision
297
+ self.reader = reader
298
+ self.vertices = None
299
+ self.faces = None
300
+ self.parse()
301
+
302
+ def parse(self):
303
+ """Parse the the data found by the reader.
304
+
305
+ Returns
306
+ -------
307
+ None
308
+
309
+ """
310
+ gkey_index = {}
311
+ vertices = []
312
+ faces = []
313
+ for facet in self.reader.facets:
314
+ face = []
315
+ facet_vertices = facet["vertices"]
316
+ for i in range(3):
317
+ xyz = facet_vertices[i]
318
+ if "keys" in facet:
319
+ gkey = facet["keys"][i]
320
+ else:
321
+ gkey = TOL.geometric_key(xyz, self.precision)
322
+ if gkey not in gkey_index:
323
+ gkey_index[gkey] = len(vertices)
324
+ vertices.append(xyz)
325
+ face.append(gkey_index[gkey])
326
+ faces.append(face)
327
+ self.vertices = vertices
328
+ self.faces = faces
329
+
330
+
331
+ class STLWriter(object):
332
+ """Class for writing geometric data to a STL file.
333
+
334
+ Parameters
335
+ ----------
336
+ filepath : path string | file-like object | URL string
337
+ A path, a file-like object or a URL pointing to a file.
338
+ mesh : :class:`compas.datastructures.Mesh`
339
+ The mesh.
340
+ binary : bool, optional
341
+ Flag indicating that the file should be written in binary format.
342
+ solid_name : str, optional
343
+ The name of the solid.
344
+ Defaults to the name of the mesh.
345
+ precision : str, optional
346
+ COMPAS precision specification for parsing geometric data.
347
+
348
+ """
349
+
350
+ def __init__(self, filepath, mesh, binary=False, solid_name=None, precision=None):
351
+ self.filepath = filepath
352
+ self.mesh = mesh
353
+ self.solid_name = solid_name or mesh.name
354
+ self.precision = precision
355
+ self.file = None
356
+ self.binary = binary
357
+
358
+ @property
359
+ def _vertex_xyz(self):
360
+ bbox = self.mesh.aabb()
361
+ xmin, ymin, zmin = bbox.xmin, bbox.ymin, bbox.zmin
362
+ if not self.binary and (xmin < 0 or ymin < 0 or zmin < 0):
363
+ T = Translation.from_vector([-xmin, -ymin, -zmin])
364
+ mesh = self.mesh.transformed(T)
365
+ else:
366
+ mesh = self.mesh
367
+ return {vertex: mesh.vertex_attributes(vertex, "xyz") for vertex in mesh.vertices()}
368
+
369
+ def write(self):
370
+ """Write the data to a file.
371
+
372
+ Returns
373
+ -------
374
+ None
375
+
376
+ """
377
+ if not self.mesh.is_trimesh():
378
+ raise ValueError("Mesh must be triangular to be encoded in STL.")
379
+ if not self.binary:
380
+ with _iotools.open_file(self.filepath, "w") as self.file:
381
+ self._write_header()
382
+ self._write_faces()
383
+ self._write_footer()
384
+ else:
385
+ with _iotools.open_file(self.filepath, "wb") as self.file:
386
+ self.file.seek(0)
387
+ self._write_binary_header()
388
+ self._write_binary_num_faces()
389
+ self._write_binary_faces()
390
+
391
+ def _write_header(self):
392
+ if not self.file:
393
+ return
394
+ self.file.write("solid {}\n".format(self.solid_name))
395
+
396
+ def _write_footer(self):
397
+ if not self.file:
398
+ return
399
+ self.file.write("endsolid {}\n".format(self.solid_name))
400
+
401
+ def _write_faces(self):
402
+ if not self.file:
403
+ return
404
+ vertex_xyz = self._vertex_xyz
405
+ for face in self.mesh.faces():
406
+ normal = list(self.mesh.face_normal(face))
407
+ self.file.write("facet normal {0} {1} {2}\n".format(*normal))
408
+ self.file.write(" outer loop\n")
409
+ for vertex in self.mesh.face_vertices(face):
410
+ self.file.write(" vertex {0} {1} {2}\n".format(*vertex_xyz[vertex]))
411
+ self.file.write(" endloop\n")
412
+ self.file.write("endfacet\n")
413
+
414
+ def _write_binary_header(self):
415
+ if not self.file:
416
+ return
417
+ self.file.write(b"\0" * 80)
418
+
419
+ def _write_binary_num_faces(self):
420
+ if not self.file:
421
+ return
422
+ try:
423
+ self.file.write(struct.pack("<L", self.mesh.number_of_faces()))
424
+ except struct.error:
425
+ raise ValueError("Mesh must have fewer than 4294967295 faces to be written to binary STL.")
426
+
427
+ def _write_binary_faces(self):
428
+ if not self.file:
429
+ return
430
+ vertex_xyz = self._vertex_xyz
431
+ for face in self.mesh.faces():
432
+ normal = list(self.mesh.face_normal(face))
433
+ self.file.write(struct.pack("<3f", *normal))
434
+ for vertex in self.mesh.face_vertices(face):
435
+ self.file.write(struct.pack("<3f", *vertex_xyz[vertex]))
436
+ self.file.write(b"\0\0")