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
@@ -0,0 +1,554 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ import Rhino # type: ignore
6
+
7
+ from compas.geometry import Brep
8
+ from compas.geometry import BrepError
9
+ from compas.geometry import BrepTrimmingError
10
+ from compas.geometry import Frame
11
+ from compas.geometry import Plane
12
+ from compas.geometry import Point
13
+ from compas.tolerance import TOL
14
+ from compas_rhino.conversions import box_to_rhino
15
+ from compas_rhino.conversions import curve_to_compas
16
+ from compas_rhino.conversions import curve_to_rhino
17
+ from compas_rhino.conversions import cylinder_to_rhino
18
+ from compas_rhino.conversions import mesh_to_compas
19
+ from compas_rhino.conversions import mesh_to_rhino
20
+ from compas_rhino.conversions import plane_to_rhino
21
+ from compas_rhino.conversions import point_to_rhino
22
+ from compas_rhino.conversions import sphere_to_rhino
23
+ from compas_rhino.conversions import transformation_to_rhino
24
+ from compas_rhino.conversions import vector_to_rhino
25
+
26
+ from .builder import _RhinoBrepBuilder
27
+ from .edge import RhinoBrepEdge
28
+ from .face import RhinoBrepFace
29
+ from .loop import RhinoBrepLoop
30
+ from .vertex import RhinoBrepVertex
31
+
32
+
33
+ class RhinoBrep(Brep):
34
+ """Rhino Brep backend class.
35
+
36
+ Wraps around and allows serialization and de-serialization of a :class:`Rhino.Geometry.Brep`.
37
+
38
+ Attributes
39
+ ----------
40
+ native_brep : :class:`Rhino.Geometry.Brep`
41
+ The underlying Rhino Brep instance.
42
+ vertices : list[:class:`compas_rhino.geometry.RhinoBrepVertex`], read-only
43
+ The list of vertices which comprise this Brep.
44
+ points : list[:class:`compas.geometry.Point`], read-only
45
+ The list of vertex geometries as points in 3D space.
46
+ edges : list[:class:`compas_rhino.geometry.RhinoBrepEdge`], read-only
47
+ The list of edges which comprise this brep.
48
+ trims : list[:class:`compas_rhino.geometry.RhinoBrepTrim`], read-only
49
+ The list of trims which comprise this brep.
50
+ loops : list[:class:`compas_rhino.geometry.RhinoBrepLoop`], read-only
51
+ The list of loops which comprise this brep.
52
+ faces : list[:class:`compas_rhino.geometry.RhinoBrepFace`], read-only
53
+ The list of faces which comprise this brep.
54
+ frame : :class:`compas.geometry.Frame`, read-only
55
+ The brep's origin (Frame.worldXY()).
56
+ area : float, read-only
57
+ The calculated area of this brep.
58
+ volume : float, read-only
59
+ The calculated volume of this brep.
60
+
61
+ """
62
+
63
+ def __init__(self):
64
+ super(RhinoBrep, self).__init__()
65
+ self._brep = Rhino.Geometry.Brep()
66
+
67
+ def __deepcopy__(self, *args, **kwargs):
68
+ return self.copy()
69
+
70
+ # ==============================================================================
71
+ # Data
72
+ # ==============================================================================
73
+
74
+ @property
75
+ def __data__(self):
76
+ return {
77
+ "vertices": [v.__data__ for v in self.vertices], # type: ignore
78
+ "edges": [e.__data__ for e in self.edges], # type: ignore
79
+ "faces": [f.__data__ for f in self.faces], # type: ignore
80
+ }
81
+
82
+ @classmethod
83
+ def __from_data__(cls, data):
84
+ """Construct a RhinoBrep from its data representation.
85
+
86
+ Parameters
87
+ ----------
88
+ data : :obj:`dict`
89
+ The data dictionary.
90
+
91
+ Returns
92
+ -------
93
+ :class:`compas_rhino.geometry.RhinoBrep`
94
+
95
+ """
96
+ instance = cls()
97
+ builder = _RhinoBrepBuilder()
98
+ for v_data in data["vertices"]:
99
+ RhinoBrepVertex.__from_data__(v_data, builder)
100
+ for e_data in data["edges"]:
101
+ RhinoBrepEdge.__from_data__(e_data, builder)
102
+ for f_data in data["faces"]:
103
+ RhinoBrepFace.__from_data__(f_data, builder)
104
+ instance.native_brep = builder.result
105
+ return instance
106
+
107
+ def copy(self, cls=None):
108
+ """Creates a deep-copy of this Brep using the native Rhino.Geometry.Brep copying mechanism.
109
+
110
+ Returns
111
+ -------
112
+ :class:`compas_rhino.geometry.RhinoBrep`
113
+
114
+ """
115
+ # Avoid reconstruction when just copying. for sake of efficiency and stability
116
+ return RhinoBrep.from_native(self._brep.DuplicateBrep())
117
+
118
+ # ==============================================================================
119
+ # Properties
120
+ # ==============================================================================
121
+
122
+ @property
123
+ def is_manifold(self):
124
+ return self._brep.IsManifold
125
+
126
+ @property
127
+ def is_solid(self):
128
+ return self._brep.IsSolid
129
+
130
+ @property
131
+ def native_brep(self):
132
+ return self._brep
133
+
134
+ @native_brep.setter
135
+ def native_brep(self, rhino_brep):
136
+ self._brep = rhino_brep
137
+
138
+ @property
139
+ def vertices(self):
140
+ return self.points
141
+
142
+ @property
143
+ def points(self):
144
+ if self._brep:
145
+ return [RhinoBrepVertex(vertex) for vertex in self._brep.Vertices]
146
+
147
+ @property
148
+ def edges(self):
149
+ if self._brep:
150
+ return [RhinoBrepEdge(edge) for edge in self._brep.Edges]
151
+
152
+ @property
153
+ def trims(self):
154
+ if self._brep:
155
+ return [RhinoBrepEdge(trim) for trim in self._brep.Trims]
156
+
157
+ @property
158
+ def loops(self):
159
+ if self._brep:
160
+ return [RhinoBrepLoop(loop) for loop in self._brep.Loops]
161
+
162
+ @property
163
+ def faces(self):
164
+ if self._brep:
165
+ return [RhinoBrepFace(face) for face in self._brep.Faces]
166
+
167
+ @property
168
+ def frame(self):
169
+ return Frame.worldXY()
170
+
171
+ @property
172
+ def area(self):
173
+ if self._brep:
174
+ return self._brep.GetArea()
175
+
176
+ @property
177
+ def volume(self):
178
+ if self._brep:
179
+ return self._brep.GetVolume()
180
+
181
+ # ==============================================================================
182
+ # Constructors
183
+ # ==============================================================================
184
+
185
+ @classmethod
186
+ def from_native(cls, rhino_brep):
187
+ """Constructs a RhinoBrep from an instance of a Rhino.Geometry.Brep.
188
+
189
+ Parameters
190
+ ----------
191
+ rhino_brep : :class:`Rhino.Geometry.Brep`
192
+ The instance of Rhino brep to wrap.
193
+
194
+ Returns
195
+ -------
196
+ :class:`compas_rhino.geometry.RhinoBrep`
197
+
198
+ """
199
+ brep = cls()
200
+ brep._brep = rhino_brep
201
+ return brep
202
+
203
+ @classmethod
204
+ def from_box(cls, box):
205
+ """Create a RhinoBrep from a box.
206
+
207
+ Parameters
208
+ ----------
209
+ box : :class:`compas.geometry.Box`
210
+ The box geometry of the brep.
211
+
212
+ Returns
213
+ -------
214
+ :class:`compas_rhino.geometry.RhinoBrep`
215
+
216
+ """
217
+ rhino_box = box_to_rhino(box)
218
+ return cls.from_native(rhino_box.ToBrep())
219
+
220
+ @classmethod
221
+ def from_extrusion(cls, curve, vector, cap_ends=True):
222
+ """Create a RhinoBrep from an extrusion.
223
+
224
+ Parameters
225
+ ----------
226
+ curve : :class:`~compas.geometry.Curve`
227
+ The curve to extrude.
228
+ vector : :class:`~compas.geometry.Vector`
229
+ The vector to extrude the curve along.
230
+ cap_ends : bool, optional
231
+ If True, the plannar ends of the extrusion will be capped, if possible.
232
+
233
+ Returns
234
+ -------
235
+ :class:`~compas_rhino.geometry.RhinoBrep`
236
+
237
+ """
238
+ extrusion = Rhino.Geometry.Surface.CreateExtrusion(curve_to_rhino(curve), vector_to_rhino(vector))
239
+ if extrusion is None:
240
+ raise BrepError("Failed to create extrusion from curve: {} and vector: {}".format(curve, vector))
241
+ rhino_brep = extrusion.ToBrep()
242
+ if cap_ends:
243
+ capped = rhino_brep.CapPlanarHoles(TOL.absolute)
244
+ if capped:
245
+ rhino_brep = capped
246
+ return cls.from_native(rhino_brep)
247
+
248
+ @classmethod
249
+ def from_sphere(cls, sphere):
250
+ """Create a RhinoBrep from a sphere.
251
+
252
+ Parameters
253
+ ----------
254
+ sphere : :class:`compas.geometry.Sphere`
255
+ The source sphere.
256
+
257
+ Returns
258
+ -------
259
+ :class:`compas_rhino.geometry.RhinoBrep`
260
+
261
+ """
262
+ rhino_sphere = sphere_to_rhino(sphere)
263
+ return cls.from_native(rhino_sphere.ToBrep())
264
+
265
+ @classmethod
266
+ def from_cylinder(cls, cylinder):
267
+ """Create a RhinoBrep from a box.
268
+
269
+ Parameters
270
+ ----------
271
+ box : :class:`compas.geometry.Box`
272
+ The box geometry of the brep.
273
+
274
+ Returns
275
+ -------
276
+ :class:`compas_rhino.geometry.RhinoBrep`
277
+
278
+ """
279
+ rhino_cylinder = cylinder_to_rhino(cylinder)
280
+ return cls.from_native(rhino_cylinder.ToBrep(True, True))
281
+
282
+ @classmethod
283
+ def from_mesh(cls, mesh):
284
+ """Create a RhinoBrep from a mesh.
285
+
286
+ Parameters
287
+ ----------
288
+ mesh : :class:`compas.datastructures.Mesh`
289
+ The source mesh.
290
+
291
+ Returns
292
+ -------
293
+ :class:`compas_rhino.geometry.RhinoBrep`
294
+
295
+ """
296
+ rhino_mesh = mesh_to_rhino(mesh)
297
+ return cls.from_native(Rhino.Geometry.Brep.CreateFromMesh(rhino_mesh, True))
298
+
299
+ # ==============================================================================
300
+ # Methods
301
+ # ==============================================================================
302
+
303
+ def contains(self, object):
304
+ """Check if the Brep contains a given geometric primitive.
305
+
306
+ Only closed and manifold breps can be checked for containment.
307
+
308
+ Parameters
309
+ ----------
310
+ object : :class:`~compas.geometry.Point`, :class:`~compas.geometry.Curve`, :class:`~compas.geometry.Surface`
311
+ The object to check for containment.
312
+
313
+ Raises
314
+ ------
315
+ BrepError
316
+ If the Brep is not solid.
317
+
318
+ Returns
319
+ -------
320
+ bool
321
+ True if the object is contained in the Brep, False otherwise.
322
+
323
+ """
324
+ if not self.is_solid:
325
+ raise BrepError("Cannot check for containment if brep is not manifold or is not closed")
326
+
327
+ if isinstance(object, Point):
328
+ return self._brep.IsPointInside(point_to_rhino(object), TOL.absolute, False)
329
+ else:
330
+ raise NotImplementedError
331
+
332
+ def to_meshes(self, u=16, v=16):
333
+ """Convert the faces of this Brep shape to meshes.
334
+
335
+ Parameters
336
+ ----------
337
+ u : int, optional
338
+ The number of mesh faces in the U direction of the underlying surface geometry of every face of the Brep.
339
+ v : int, optional
340
+ The number of mesh faces in the V direction of the underlying surface geometry of every face of the Brep.
341
+
342
+ Returns
343
+ -------
344
+ list[:class:`~compas.datastructures.Mesh`]
345
+
346
+ """
347
+ rg_meshes = Rhino.Geometry.Mesh.CreateFromBrep(self._brep, Rhino.Geometry.MeshingParameters.Default)
348
+ meshes = [mesh_to_compas(m) for m in rg_meshes]
349
+ return meshes
350
+
351
+ def transform(self, matrix):
352
+ """Transform this Brep by given transformation matrix
353
+
354
+ Parameters
355
+ ----------
356
+ matrix: :class:`compas.geometry.Transformation`
357
+ The transformation matrix by which to transform this Brep.
358
+
359
+ Returns
360
+ -------
361
+ None
362
+
363
+ """
364
+ self._brep.Transform(transformation_to_rhino(matrix))
365
+
366
+ def trim(self, plane, tolerance=None):
367
+ """Trim this brep by the given trimming plane.
368
+
369
+ Parameters
370
+ ----------
371
+ plane : :class:`compas.geometry.Frame` or :class:`compas.geometry.Plane`
372
+ The frame or plane to use when trimming. The discarded bit is in the direction of the frame's normal.
373
+ tolerance : float, optional
374
+ The precision to use for the trimming operation. Defaults to `TOL.absolute`.
375
+
376
+ Notes
377
+ -----
378
+ Trimming operation may result in multiple results (breps). When trimming, only one is used.
379
+ The used bit is the one on the opposite side of the cutting plane's normal.
380
+
381
+ Returns
382
+ -------
383
+ None
384
+
385
+ Raises
386
+ ------
387
+ BrepTrimmingError
388
+ If the trimming operation ended with no result.
389
+
390
+ See Also
391
+ --------
392
+ :meth:`compas_rhino.geometry.RhinoBrep.trimmed`
393
+
394
+ """
395
+ result = self.trimmed(plane, tolerance)
396
+ self._brep = result.native_brep
397
+
398
+ def trimmed(self, plane, tolerance=None):
399
+ """Returns a trimmed copy of this brep by the given trimming plane.
400
+
401
+ Parameters
402
+ ----------
403
+ plane : :class:`compas.geometry.Frame` or :class:`compas.geometry.Plane`
404
+ The frame or plane to use when trimming. The discarded bit is in the direction of the plane's normal.
405
+ tolerance : float, optional
406
+ The precision to use for the trimming operation. Defaults to `TOL.absolute`.
407
+
408
+ Notes
409
+ -----
410
+ Trimming operation may result in multiple results (breps). When trimming, only one is used.
411
+ The used bit is the one on the opposite side of the cutting plane's normal.
412
+
413
+ Returns
414
+ -------
415
+ :class:`~compas_rhino.geometry.RhinoBrep`
416
+
417
+ Raises
418
+ ------
419
+ BrepTrimmingError
420
+ If the trimming operation ended with no result.
421
+
422
+ See Also
423
+ --------
424
+ :meth:`compas_rhino.geometry.RhinoBrep.trim`
425
+
426
+ """
427
+ tolerance = tolerance or TOL.absolute
428
+ if isinstance(plane, Frame):
429
+ plane = Plane.from_frame(plane)
430
+ results = self._brep.Trim(plane_to_rhino(plane), tolerance)
431
+ if not results:
432
+ raise BrepTrimmingError("Trim operation ended with no result")
433
+ result = results[0]
434
+ capped = result.CapPlanarHoles(tolerance)
435
+ if capped:
436
+ result = capped
437
+ return RhinoBrep.from_native(result)
438
+
439
+ @classmethod
440
+ def from_boolean_difference(cls, breps_a, breps_b):
441
+ """Construct a Brep from the boolean difference of two groups of Breps.
442
+
443
+ Parameters
444
+ ----------
445
+ breps_a : :class:`compas_rhino.geometry.RhinoBrep` or list(:class:`compas_rhino.geometry.RhinoBrep`)
446
+ One or more Breps from which to substract.
447
+ breps_b : :class:`compas_rhino.geometry.RhinoBrep` or list(:class:`compas_rhino.geometry.RhinoBrep`)
448
+ One or more Breps to substract.
449
+
450
+ Returns
451
+ -------
452
+ list(:class:`compas_rhino.geometry.RhinoBrep`)
453
+ list of one or more resulting Breps.
454
+
455
+ """
456
+ if not isinstance(breps_a, list):
457
+ breps_a = [breps_a]
458
+ if not isinstance(breps_b, list):
459
+ breps_b = [breps_b]
460
+ resulting_breps = Rhino.Geometry.Brep.CreateBooleanDifference(
461
+ [b.native_brep for b in breps_a],
462
+ [b.native_brep for b in breps_b],
463
+ TOL.absolute,
464
+ )
465
+ return [RhinoBrep.from_native(brep) for brep in resulting_breps]
466
+
467
+ @classmethod
468
+ def from_boolean_union(cls, breps_a, breps_b):
469
+ """Construct a Brep from the boolean union of two groups of Breps.
470
+
471
+ Parameters
472
+ ----------
473
+ breps_a : :class:`compas_rhino.geometry.RhinoBrep` or list(:class:`compas_rhino.geometry.RhinoBrep`)
474
+ One of more breps to join.
475
+ breps_b : :class:`compas_rhino.geometry.RhinoBrep` or list(:class:`compas_rhino.geometry.RhinoBrep`)
476
+ Another one of more breps to join.
477
+
478
+ Returns
479
+ -------
480
+ list(:class:`compas_rhino.geometry.RhinoBrep`)
481
+ list of one or more resulting Breps.
482
+
483
+ """
484
+ if not isinstance(breps_a, list):
485
+ breps_a = [breps_a]
486
+ if not isinstance(breps_b, list):
487
+ breps_b = [breps_b]
488
+
489
+ resulting_breps = Rhino.Geometry.Brep.CreateBooleanUnion([b.native_brep for b in breps_a + breps_b], TOL.absolute)
490
+ return [RhinoBrep.from_native(brep) for brep in resulting_breps]
491
+
492
+ @classmethod
493
+ def from_boolean_intersection(cls, breps_a, breps_b):
494
+ """Construct a Brep from the boolean intersection of two groups of Breps.
495
+
496
+ Parameters
497
+ ----------
498
+ breps_a : :class:`compas_rhino.geometry.RhinoBrep` or list(:class:`compas_rhino.geometry.RhinoBrep`)
499
+ One or more Breps to instrsect.
500
+ breps_b : :class:`compas_rhino.geometry.RhinoBrep` or list(:class:`compas_rhino.geometry.RhinoBrep`)
501
+ Another one or more Breps to intersect.
502
+
503
+ Returns
504
+ -------
505
+ list(:class:`compas_rhino.geometry.RhinoBrep`)
506
+ list of one or more resulting Breps.
507
+
508
+ """
509
+ if not isinstance(breps_a, list):
510
+ breps_a = [breps_a]
511
+ if not isinstance(breps_b, list):
512
+ breps_b = [breps_b]
513
+ resulting_breps = Rhino.Geometry.Brep.CreateBooleanIntersection(
514
+ [b.native_brep for b in breps_a],
515
+ [b.native_brep for b in breps_b],
516
+ TOL.absolute,
517
+ )
518
+ return [RhinoBrep.from_native(brep) for brep in resulting_breps]
519
+
520
+ def slice(self, plane):
521
+ """Slice through the Brep with a plane.
522
+
523
+ Parameters
524
+ ----------
525
+ plane : :class:`~compas.geometry.Plane` or :class:`~compas.geometry.Frame`
526
+ The plane to slice through the brep.
527
+
528
+ Returns
529
+ -------
530
+ list(:class:`~compas.geometry.Curve`)
531
+ Zero or more curves which represent the intersection(s) between the brep and the plane.
532
+
533
+ """
534
+ if isinstance(plane, Frame):
535
+ plane = Plane.from_frame(plane)
536
+ curves = Rhino.Geometry.Brep.CreateContourCurves(self._brep, plane_to_rhino(plane))
537
+ return [curve_to_compas(curve) for curve in curves]
538
+
539
+ def split(self, cutter):
540
+ """Splits a Brep into pieces using a Brep as a cutter.
541
+
542
+ Parameters
543
+ ----------
544
+ cutter : :class:`compas_rhino.geometry.RhinoBrep`
545
+ Another Brep to use as a cutter.
546
+
547
+ Returns
548
+ -------
549
+ list(:class:`compas_rhino.geometry.RhinoBrep`)
550
+ list of zero or more resulting Breps.
551
+
552
+ """
553
+ resulting_breps = self._brep.Split(cutter.native_brep, TOL.absolute)
554
+ return [RhinoBrep.from_native(brep) for brep in resulting_breps]