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,1081 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ from functools import wraps
6
+
7
+ import Rhino # type: ignore
8
+ import rhinoscriptsyntax as rs # type: ignore
9
+ import scriptcontext as sc # type: ignore
10
+ import System # type: ignore
11
+
12
+ import compas_rhino.objects
13
+ from compas.geometry import centroid_polygon
14
+ from compas_rhino.conversions import vertices_and_faces_to_rhino
15
+ from compas_rhino.layers import clear_current_layer
16
+ from compas_rhino.layers import clear_layer
17
+ from compas_rhino.layers import create_layers_from_path
18
+
19
+ find_object = sc.doc.Objects.Find
20
+ add_point = sc.doc.Objects.AddPoint
21
+ add_line = sc.doc.Objects.AddLine
22
+ add_dot = sc.doc.Objects.AddTextDot
23
+ add_curve = sc.doc.Objects.AddCurve
24
+ add_polyline = sc.doc.Objects.AddPolyline
25
+ add_brep = sc.doc.Objects.AddBrep
26
+ add_sphere = sc.doc.Objects.AddSphere
27
+ add_mesh = sc.doc.Objects.AddMesh
28
+ add_circle = sc.doc.Objects.AddCircle
29
+ add_surface = sc.doc.Objects.AddSurface
30
+
31
+ TOL = sc.doc.ModelAbsoluteTolerance
32
+
33
+ try:
34
+ find_layer_by_fullpath = sc.doc.Layers.FindByFullPath
35
+ except SystemError:
36
+ find_layer_by_fullpath = None
37
+
38
+
39
+ def wrap_drawfunc(f):
40
+ """Wraps all ``draw_`` functions with support for recurring keyword arguments."""
41
+
42
+ @wraps(f)
43
+ def wrapper(*args, **kwargs):
44
+ layer = kwargs.get("layer", None)
45
+ clear = kwargs.get("clear", False)
46
+ redraw = kwargs.get("redraw", False)
47
+ if layer:
48
+ if not rs.IsLayer(layer):
49
+ create_layers_from_path(layer)
50
+ previous = rs.CurrentLayer(layer)
51
+ if clear:
52
+ if not layer:
53
+ clear_current_layer()
54
+ else:
55
+ clear_layer(layer)
56
+ rs.EnableRedraw(False)
57
+ res = f(*args, **kwargs)
58
+ if redraw:
59
+ rs.EnableRedraw(True)
60
+ if layer:
61
+ rs.CurrentLayer(previous) # type: ignore
62
+ return res
63
+
64
+ return wrapper
65
+
66
+
67
+ @wrap_drawfunc
68
+ def draw_labels(labels, **kwargs):
69
+ """Draw labels as text dots and optionally set individual font, fontsize, name, layer and color.
70
+
71
+ Parameters
72
+ ----------
73
+ labels : list[dict]
74
+ A list of labels dictionaries.
75
+ See Notes, for more information about the structure of the dict.
76
+
77
+ Returns
78
+ -------
79
+ list[System.Guid]
80
+
81
+ Notes
82
+ -----
83
+ A label dict has the following schema:
84
+
85
+ .. code-block:: python
86
+
87
+ Schema(
88
+ {
89
+ "pos": And(list, lambda x: len(x) == 3),
90
+ "text": And(str, len),
91
+ Optional("name", default=""): str,
92
+ Optional("color", default=None): (lambda x: len(x) == 3 and all(0 <= y <= 255 for y in x)),
93
+ Optional("layer", default=None): str,
94
+ Optional("fontsize", default=10): Or(int, float),
95
+ Optional("font", default="Arial Regular"): str,
96
+ }
97
+ )
98
+
99
+ """
100
+ guids = []
101
+ for label in iter(labels):
102
+ pos = label["pos"]
103
+ text = label["text"]
104
+ name = label.get("name", "")
105
+ color = label.get("color", None)
106
+ layer = label.get("layer")
107
+ size = label.get("fontsize", 10)
108
+ font = label.get("font", "Arial Regular")
109
+ dot = Rhino.Geometry.TextDot(str(text), Rhino.Geometry.Point3d(*pos))
110
+ dot.FontHeight = size
111
+ dot.FontFace = font
112
+ guid = add_dot(dot)
113
+ if not guid:
114
+ continue
115
+ obj = find_object(guid)
116
+ if not obj:
117
+ continue
118
+ attr = obj.Attributes
119
+ if color:
120
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
121
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
122
+ else:
123
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
124
+ if layer and find_layer_by_fullpath:
125
+ index = find_layer_by_fullpath(layer, True)
126
+ if index >= 0:
127
+ attr.LayerIndex = index
128
+ attr.Name = name
129
+ obj.CommitChanges()
130
+ guids.append(guid)
131
+ return guids
132
+
133
+
134
+ @wrap_drawfunc
135
+ def draw_points(points, **kwargs):
136
+ """Draw points and optionally set individual name, layer, and color properties.
137
+
138
+ Parameters
139
+ ----------
140
+ labels : list[dict]
141
+ A list of point dictionaries.
142
+ See Notes, for more information about the structure of the dict.
143
+
144
+ Returns
145
+ -------
146
+ list[System.Guid]
147
+
148
+ Notes
149
+ -----
150
+ A point dict has the following schema:
151
+
152
+ .. code-block:: python
153
+
154
+ Schema(
155
+ {
156
+ "pos": And(list, lambda x: len(x) == 3),
157
+ Optional("name", default=""): str,
158
+ Optional("color", default=None): (lambda x: len(x) == 3 and all(0 <= y <= 255 for y in x)),
159
+ Optional("layer", default=None): str,
160
+ }
161
+ )
162
+
163
+ """
164
+ guids = []
165
+ for p in iter(points):
166
+ pos = p["pos"]
167
+ name = p.get("name", "")
168
+ color = p.get("color")
169
+ layer = p.get("layer")
170
+ guid = add_point(Rhino.Geometry.Point3d(*pos))
171
+ if not guid:
172
+ continue
173
+ obj = find_object(guid)
174
+ if not obj:
175
+ continue
176
+ attr = obj.Attributes
177
+ if color:
178
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
179
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
180
+ else:
181
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
182
+ if layer and find_layer_by_fullpath:
183
+ index = find_layer_by_fullpath(layer, True)
184
+ if index >= 0:
185
+ attr.LayerIndex = index
186
+ attr.Name = name
187
+ obj.CommitChanges()
188
+ guids.append(guid)
189
+ return guids
190
+
191
+
192
+ @wrap_drawfunc
193
+ def draw_lines(lines, **kwargs):
194
+ """Draw lines and optionally set individual name, color, arrow, layer, and
195
+ width properties.
196
+
197
+ Parameters
198
+ ----------
199
+ labels : list[dict]
200
+ A list of line dictionaries.
201
+ See Notes, for more information about the structure of the dict.
202
+
203
+ Returns
204
+ -------
205
+ list[System.Guid]
206
+
207
+ Notes
208
+ -----
209
+ A line dict has the following schema:
210
+
211
+ .. code-block:: python
212
+
213
+ Schema(
214
+ {
215
+ "start": And(list, lambda x: len(x) == 3),
216
+ "end": And(list, lambda x: len(x) == 3),
217
+ Optional("name", default=""): str,
218
+ Optional("color", default=None): (lambda x: len(x) == 3 and all(0 <= y <= 255 for y in x)),
219
+ Optional("layer", default=None): str,
220
+ Optional("arrow", default=None): str,
221
+ Optional("width", default=None): Or(int, float),
222
+ }
223
+ )
224
+
225
+ """
226
+ guids = []
227
+ for line in iter(lines):
228
+ sp = line["start"]
229
+ ep = line["end"]
230
+ name = line.get("name", "")
231
+ color = line.get("color")
232
+ arrow = line.get("arrow")
233
+ layer = line.get("layer")
234
+ width = line.get("width")
235
+ guid = add_line(Rhino.Geometry.Point3d(*sp), Rhino.Geometry.Point3d(*ep))
236
+ if not guid:
237
+ continue
238
+ obj = find_object(guid)
239
+ if not obj:
240
+ continue
241
+ attr = obj.Attributes
242
+ if color:
243
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
244
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
245
+ else:
246
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
247
+ if arrow == "end":
248
+ attr.ObjectDecoration = Rhino.DocObjects.ObjectColorSource.EndArrowhead
249
+ if arrow == "start":
250
+ attr.ObjectDecoration = Rhino.DocObjects.ObjectColorSource.StartArrowhead
251
+ if layer and find_layer_by_fullpath:
252
+ index = find_layer_by_fullpath(layer, True)
253
+ if index >= 0:
254
+ attr.LayerIndex = index
255
+ if width:
256
+ attr.PlotWeight = width
257
+ attr.PlotWeightSource = Rhino.DocObjects.ObjectPlotWeightSource.PlotWeightFromObject
258
+ attr.Name = name
259
+ obj.CommitChanges()
260
+ guids.append(guid)
261
+ return guids
262
+
263
+
264
+ @wrap_drawfunc
265
+ def draw_geodesics(geodesics, **kwargs):
266
+ """Draw geodesic lines on specified surfaces, and optionally set individual
267
+ name, color, arrow, and layer properties.
268
+
269
+ Parameters
270
+ ----------
271
+ labels : list[dict]
272
+ A list of geodesic dictionaries.
273
+ See Notes, for more information about the structure of the dict.
274
+
275
+ Returns
276
+ -------
277
+ list[System.Guid]
278
+
279
+ Notes
280
+ -----
281
+ A geodesic dict has the following schema:
282
+
283
+ .. code-block:: python
284
+
285
+ Schema(
286
+ {
287
+ "start": And(list, lambda x: len(x) == 3),
288
+ "end": And(list, lambda x: len(x) == 3),
289
+ "srf": Or(str, System.Guid),
290
+ Optional("name", default=""): str,
291
+ Optional("color", default=None): (lambda x: len(x) == 3 and all(0 <= y <= 255 for y in x)),
292
+ Optional("layer", default=None): str,
293
+ Optional("arrow", default=None): str,
294
+ }
295
+ )
296
+
297
+ """
298
+ guids = []
299
+ for g in iter(geodesics):
300
+ sp = g["start"]
301
+ ep = g["end"]
302
+ srf = g["srf"]
303
+ name = g.get("name", "")
304
+ color = g.get("color")
305
+ arrow = g.get("arrow")
306
+ layer = g.get("layer")
307
+ # replace this by a proper rhinocommon call
308
+ guid = rs.ShortPath(srf, Rhino.Geometry.Point3d(*sp), Rhino.Geometry.Point3d(*ep))
309
+ if not guid:
310
+ continue
311
+ obj = find_object(guid)
312
+ if not obj:
313
+ continue
314
+ attr = obj.Attributes
315
+ if color:
316
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
317
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
318
+ else:
319
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
320
+ if arrow == "end":
321
+ attr.ObjectDecoration = Rhino.DocObjects.ObjectColorSource.EndArrowhead
322
+ if arrow == "start":
323
+ attr.ObjectDecoration = Rhino.DocObjects.ObjectColorSource.StartArrowhead
324
+ if layer and find_layer_by_fullpath:
325
+ index = find_layer_by_fullpath(layer, True)
326
+ if index >= 0:
327
+ attr.LayerIndex = index
328
+ attr.Name = name
329
+ obj.CommitChanges()
330
+ guids.append(guid)
331
+ return guids
332
+
333
+
334
+ @wrap_drawfunc
335
+ def draw_polylines(polylines, **kwargs):
336
+ """Draw polylines, and optionally set individual name, color, arrow, and
337
+ layer properties.
338
+
339
+ Parameters
340
+ ----------
341
+ labels : list[dict]
342
+ A list of polyline dictionaries.
343
+ See Notes, for more information about the structure of the dict.
344
+
345
+ Returns
346
+ -------
347
+ list[System.Guid]
348
+
349
+ Notes
350
+ -----
351
+ A polyline dict has the following schema:
352
+
353
+ .. code-block:: python
354
+
355
+ Schema({
356
+ 'points': And(list, lambda x: all(len(point) == 3 for point in x),
357
+ Optional('name', default=''): str,
358
+ Optional('color', default=None): (lambda x: len(x) == 3 and all(0 <= y <= 255 for y in x)),
359
+ Optional('layer', default=None): str,
360
+ Optional('arrow', default=None): str
361
+ })
362
+
363
+ """
364
+ guids = []
365
+ for p in iter(polylines):
366
+ points = p["points"]
367
+ name = p.get("name", "")
368
+ color = p.get("color")
369
+ arrow = p.get("arrow")
370
+ layer = p.get("layer")
371
+ poly = Rhino.Geometry.Polyline([Rhino.Geometry.Point3d(*xyz) for xyz in points])
372
+ poly.DeleteShortSegments(TOL)
373
+ guid = add_polyline(poly)
374
+ if not guid:
375
+ continue
376
+ obj = find_object(guid)
377
+ if not obj:
378
+ continue
379
+ attr = obj.Attributes
380
+ if color:
381
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
382
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
383
+ else:
384
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
385
+ if arrow == "end":
386
+ attr.ObjectDecoration = Rhino.DocObjects.ObjectColorSource.EndArrowhead
387
+ if arrow == "start":
388
+ attr.ObjectDecoration = Rhino.DocObjects.ObjectColorSource.StartArrowhead
389
+ if layer and find_layer_by_fullpath:
390
+ index = find_layer_by_fullpath(layer, True)
391
+ if index >= 0:
392
+ attr.LayerIndex = index
393
+ attr.Name = name
394
+ obj.CommitChanges()
395
+ guids.append(guid)
396
+ return guids
397
+
398
+
399
+ @wrap_drawfunc
400
+ def draw_breps(faces, u=10, v=10, join=False, **kwargs):
401
+ """Draw polygonal faces as Rhino.Geometry.Breps, and optionally set individual name, color,
402
+ and layer properties.
403
+
404
+ Parameters
405
+ ----------
406
+ faces : list[dict]
407
+ A list of brep dictionaries.
408
+ See Notes, for more information about the structure of the dict.
409
+ u : int, optional
410
+ Number of spans in the U direction.
411
+ v : int, optional
412
+ Number of spans in the V direction.
413
+ join : bool, optional
414
+ If True, join the individual faces as polysurfaces
415
+
416
+ Returns
417
+ -------
418
+ list[System.Guid]
419
+
420
+ Notes
421
+ -----
422
+ A brep dict has the following schema:
423
+
424
+ .. code-block:: python
425
+
426
+ Schema({
427
+ 'points': And(list, lambda x: len(x) > 3 and all(len(point) == 3 for point in x),
428
+ Optional('name', default=''): str,
429
+ Optional('color', default=None): (lambda x: len(x) == 3 and all(0 <= y <= 255 for y in x)),
430
+ Optional('layer', default=None): str,
431
+ })
432
+
433
+ Examples
434
+ --------
435
+ Using a compas Mesh as an example:
436
+
437
+ >>> from compas.datastructures import Mesh
438
+ >>> from compas.geometry import Box, Frame
439
+ >>> from compas_rhino.utilities import draw_breps
440
+ >>> box = Box(Frame.worldXY(), 1.0, 2.0, 3.0)
441
+ >>> mesh = Mesh.from_shape(box)
442
+
443
+ Draw convert each mesh face to brep dict schema:
444
+
445
+ >>> vertices = mesh.vertices_attributes("xyz")
446
+ >>> breps = [{"points": mesh.face_coordinates(face)} for face in mesh.faces()]
447
+
448
+ Draw brep faces as one joined brep.
449
+
450
+ >>> guids = draw_breps(breps, join=True)
451
+
452
+ """
453
+ breps = []
454
+ for f in iter(faces):
455
+ points = f["points"]
456
+ name = f.get("name", "")
457
+ color = f.get("color")
458
+ layer = f.get("layer")
459
+ corners = [Rhino.Geometry.Point3d(*point) for point in points + points[:1]]
460
+ pcurve = Rhino.Geometry.PolylineCurve(corners)
461
+ geo = System.Collections.Generic.List[Rhino.Geometry.GeometryBase](1)
462
+ geo.Add(pcurve)
463
+ p = len(points)
464
+ if p == 3:
465
+ brep = Rhino.Geometry.Brep.CreateFromCornerPoints(
466
+ Rhino.Geometry.Point3d(*points[0]),
467
+ Rhino.Geometry.Point3d(*points[1]),
468
+ Rhino.Geometry.Point3d(*points[2]),
469
+ TOL,
470
+ )
471
+ elif p == 4:
472
+ brep = Rhino.Geometry.Brep.CreateFromCornerPoints(
473
+ Rhino.Geometry.Point3d(*points[0]),
474
+ Rhino.Geometry.Point3d(*points[1]),
475
+ Rhino.Geometry.Point3d(*points[2]),
476
+ Rhino.Geometry.Point3d(*points[3]),
477
+ TOL,
478
+ )
479
+ else:
480
+ brep = Rhino.Geometry.Brep.CreatePatch(geo, u, v, TOL)
481
+ if brep:
482
+ breps.append(brep)
483
+
484
+ if join:
485
+ breps = Rhino.Geometry.Brep.JoinRhino.Geometry.Breps(breps, TOL)
486
+
487
+ guids = []
488
+ for brep in breps:
489
+ guid = add_brep(brep)
490
+ if not guid:
491
+ continue
492
+ obj = find_object(guid)
493
+ if not obj:
494
+ continue
495
+ attr = obj.Attributes
496
+ if color:
497
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
498
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
499
+ else:
500
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
501
+ if layer and find_layer_by_fullpath:
502
+ index = find_layer_by_fullpath(layer, True)
503
+ if index >= 0:
504
+ attr.LayerIndex = index
505
+ attr.Name = name
506
+ attr.WireDensity = -1
507
+ obj.CommitChanges()
508
+ guids.append(guid)
509
+ return guids
510
+
511
+
512
+ @wrap_drawfunc
513
+ def draw_cylinders(cylinders, cap=False, **kwargs):
514
+ """Draw cylinders and optionally set individual name, color, and layer properties.
515
+
516
+ Parameters
517
+ ----------
518
+ cylinders : list[dict]
519
+ A list of cylinder dictionaries.
520
+ See Notes, for more information about the structure of the dict.
521
+ cap : bool, optional
522
+ If True, add caps.
523
+
524
+ Returns
525
+ -------
526
+ list[System.Guid]
527
+
528
+ Notes
529
+ -----
530
+ A cylinder dict has the following schema:
531
+
532
+ .. code-block:: python
533
+
534
+ Schema(
535
+ {
536
+ "start": And(list, lambda x: len(x) == 3),
537
+ "end": And(list, lambda x: len(x) == 3),
538
+ "radius": And(Or(int, float), lambda x: x > 0.0),
539
+ Optional("name", default=""): str,
540
+ Optional("color", default=None): (lambda x: len(x) == 3 and all(0 <= y <= 255 for y in x)),
541
+ Optional("layer", default=None): str,
542
+ }
543
+ )
544
+
545
+ """
546
+ guids = []
547
+ for c in iter(cylinders):
548
+ start = c["start"]
549
+ end = c["end"]
550
+ radius = c["radius"]
551
+ name = c.get("name", "")
552
+ color = c.get("color")
553
+ layer = c.get("layer")
554
+ if radius < TOL:
555
+ continue
556
+ base = Rhino.Geometry.Point3d(*start)
557
+ normal = Rhino.Geometry.Point3d(*end) - base
558
+ height = normal.Length
559
+ if height < TOL:
560
+ continue
561
+ plane = Rhino.Geometry.Plane(base, normal)
562
+ circle = Rhino.Geometry.Circle(plane, radius)
563
+ cylinder = Rhino.Geometry.Cylinder(circle, height)
564
+ brep = cylinder.ToRhino.Geometry.Brep(cap, cap)
565
+ if not brep:
566
+ continue
567
+ guid = add_brep(brep)
568
+ if not guid:
569
+ continue
570
+ obj = find_object(guid)
571
+ if not obj:
572
+ continue
573
+ attr = obj.Attributes
574
+ if color:
575
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
576
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
577
+ else:
578
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
579
+ if layer and find_layer_by_fullpath:
580
+ index = find_layer_by_fullpath(layer, True)
581
+ if index >= 0:
582
+ attr.LayerIndex = index
583
+ attr.Name = name
584
+ attr.WireDensity = -1
585
+ obj.CommitChanges()
586
+ guids.append(guid)
587
+ return guids
588
+
589
+
590
+ @wrap_drawfunc
591
+ def draw_pipes(pipes, cap=2, fit=1.0, **kwargs):
592
+ """Draw pipes and optionally set individual name, color, and layer properties.
593
+
594
+ Parameters
595
+ ----------
596
+ pipes : list[dict]
597
+ A list of pipe dictionaries.
598
+ See Notes, for more information about the structure of the dict.
599
+
600
+ Other Parameters
601
+ ----------------
602
+ cap : {0, 1, 2}, optional
603
+ fit : float, optional
604
+
605
+ Returns
606
+ -------
607
+ list[System.Guid]
608
+
609
+ Notes
610
+ -----
611
+ A pipe dict has the following schema:
612
+
613
+ .. code-block:: python
614
+
615
+ Schema(
616
+ {
617
+ "points": And(list, lambda x: all(len(y) == 3 for y in x)),
618
+ "radius": And(Or(int, float), lambda x: x > 0.0),
619
+ Optional("name", default=""): str,
620
+ Optional("color", default=None): And(lambda x: len(x) == 3, all(0 <= y <= 255 for y in x)),
621
+ Optional("layer", default=None): str,
622
+ }
623
+ )
624
+
625
+ """
626
+ guids = []
627
+ abs_tol = TOL
628
+ ang_tol = sc.doc.ModelAngleToleranceRadians
629
+ for p in pipes:
630
+ points = p["points"]
631
+ radius = p["radius"]
632
+ name = p.get("name", "")
633
+ color = p.get("color")
634
+ layer = p.get("layer")
635
+ params = [0.0, 1.0]
636
+ cap = System.Enum.ToObject(Rhino.Geometry.PipeCapMode, cap)
637
+ if type(radius) in (int, float):
638
+ radius = [radius] * 2
639
+ radius = [float(r) for r in radius]
640
+ rail = Rhino.Geometry.Curve.CreateControlPointRhino.Geometry.Curve([Rhino.Geometry.Point3d(*xyz) for xyz in points])
641
+ breps = Rhino.Geometry.Brep.CreatePipe(rail, params, radius, 1, cap, fit, abs_tol, ang_tol)
642
+ temp = [add_brep(brep) for brep in breps]
643
+ for guid in temp:
644
+ if not guid:
645
+ continue
646
+ obj = find_object(guid)
647
+ if not obj:
648
+ continue
649
+ attr = obj.Attributes
650
+ if color:
651
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
652
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
653
+ else:
654
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
655
+ if layer and find_layer_by_fullpath:
656
+ index = find_layer_by_fullpath(layer, True)
657
+ if index >= 0:
658
+ attr.LayerIndex = index
659
+ attr.Name = name
660
+ attr.WireDensity = -1
661
+ obj.CommitChanges()
662
+ guids.append(guid)
663
+ return guids
664
+
665
+
666
+ @wrap_drawfunc
667
+ def draw_spheres(spheres, **kwargs):
668
+ """Draw spheres and optionally set individual name, color, and layer properties.
669
+
670
+ Parameters
671
+ ----------
672
+ spheres : list[dict]
673
+ A list of sphere dictionaries.
674
+ See Notes, for more information about the structure of the dict.
675
+
676
+ Returns
677
+ -------
678
+ list[System.Guid]
679
+
680
+ Notes
681
+ -----
682
+ A sphere dict has the following schema:
683
+
684
+ .. code-block:: python
685
+
686
+ Schema(
687
+ {
688
+ "pos": And(list, lambda x: len(x) == 3),
689
+ "radius": And(Or(int, float), lambda x: x > 0.0),
690
+ Optional("name", default=""): str,
691
+ Optional("color", default=None): And(lambda x: len(x) == 3, all(0 <= y <= 255 for y in x)),
692
+ Optional("layer", default=None): str,
693
+ }
694
+ )
695
+
696
+ """
697
+ guids = []
698
+ for s in iter(spheres):
699
+ pos = s["pos"]
700
+ radius = s["radius"]
701
+ name = s.get("name", "")
702
+ color = s.get("color")
703
+ layer = s.get("layer")
704
+ sphere = Rhino.Geometry.Sphere(Rhino.Geometry.Point3d(*pos), radius)
705
+ guid = add_sphere(sphere)
706
+ if not guid:
707
+ continue
708
+ obj = find_object(guid)
709
+ if not obj:
710
+ continue
711
+ attr = obj.Attributes
712
+ if color:
713
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
714
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
715
+ else:
716
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
717
+ if layer and find_layer_by_fullpath:
718
+ index = find_layer_by_fullpath(layer, True)
719
+ if index >= 0:
720
+ attr.LayerIndex = index
721
+ attr.Name = name
722
+ attr.WireDensity = -1
723
+ obj.CommitChanges()
724
+ guids.append(guid)
725
+ return guids
726
+
727
+
728
+ @wrap_drawfunc
729
+ def draw_mesh(vertices, faces, name=None, color=None, vertex_color=None, disjoint=False, **kwargs):
730
+ """Draw a mesh and optionally set individual name, color, and layer properties.
731
+
732
+ Parameters
733
+ ----------
734
+ vertices : list[[float, float, float] | :class:`compas.geometry.Point`]
735
+ A list of point locations.
736
+ faces : list[list[int]]
737
+ A list of faces as lists of indices into `vertices`.
738
+ name : str, optional
739
+ The name of the mesh object in Rhino.
740
+ color : tuple[[int, int, int]], optional
741
+ The base color of the mesh.
742
+ vertex_color : dict[int, tuple[int, int, int]], optional
743
+ A color per vertex of the mesh.
744
+ Vertices without a color specification in this mapping, will receive the base color.
745
+ For example: ``vertex_color = {vertex: Color.from_i(random.random()).rgb255 for face in faces for vertex in face}``
746
+ disjoint : bool, optional
747
+ If True, draw the mesh with disjoint faces.
748
+
749
+ Returns
750
+ -------
751
+ System.Guid
752
+
753
+ """
754
+
755
+ def average_color(colors):
756
+ c = len(colors)
757
+ r, g, b = zip(*colors)
758
+ r = sum(r) / c
759
+ g = sum(g) / c
760
+ b = sum(b) / c
761
+ return int(r), int(g), int(b)
762
+
763
+ vertex_color = vertex_color or {}
764
+ vertexcolors = []
765
+
766
+ def populate_vertexcolors(face):
767
+ v_count = len(face)
768
+ facecolors = [vertex_color.get(vertex, color) for vertex in face]
769
+ if v_count > 4:
770
+ facecolors.append(average_color(facecolors))
771
+ vertexcolors.extend(facecolors)
772
+
773
+ if not disjoint:
774
+ rhino_mesh = vertices_and_faces_to_rhino(vertices, faces, disjoint)
775
+ vertexcolors = [vertex_color.get(vertex, color) for vertex in vertices]
776
+ else:
777
+ rhino_mesh = vertices_and_faces_to_rhino(vertices, faces, disjoint, face_callback=populate_vertexcolors)
778
+
779
+ guid = add_mesh(rhino_mesh)
780
+
781
+ if guid != System.Guid.Empty:
782
+ if vertexcolors:
783
+ try:
784
+ compas_rhino.objects.set_mesh_vertex_colors(guid, vertexcolors)
785
+ except Exception:
786
+ pass
787
+
788
+ obj = find_object(guid)
789
+ if obj:
790
+ attr = obj.Attributes
791
+ if color:
792
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
793
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
794
+ else:
795
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
796
+ if name:
797
+ attr.Name = name
798
+ obj.CommitChanges()
799
+ return guid
800
+
801
+
802
+ @wrap_drawfunc
803
+ def draw_faces(faces, **kwargs):
804
+ """Draw faces as individual meshes and optionally set individual name, color, and layer properties.
805
+
806
+ Parameters
807
+ ----------
808
+ faces : list[dict]
809
+ A list of face dictionaries.
810
+ See Notes, for more information about the structure of the dict.
811
+
812
+ Returns
813
+ -------
814
+ list[System.Guid]
815
+
816
+ Notes
817
+ -----
818
+ A face dict has the following schema:
819
+
820
+ .. code-block:: python
821
+
822
+ Schema(
823
+ {
824
+ "points": And(len, lambda x: all(len(y) == 3 for y in x)),
825
+ Optional("name", default=""): str,
826
+ Optional("color", default=None): And(lambda x: len(x) == 3, all(0 <= y <= 255 for y in x)),
827
+ Optional("vertexcolors", default=None): And(len, lambda x: all(0 <= y <= 255 for y in x)),
828
+ }
829
+ )
830
+
831
+ """
832
+ guids = []
833
+ for face in iter(faces):
834
+ points = face["points"][:]
835
+ name = face.get("name")
836
+ color = face.get("color")
837
+ vertexcolors = face.get("vertexcolors")
838
+
839
+ v = len(points)
840
+
841
+ if v < 3:
842
+ continue
843
+ elif v == 3:
844
+ mfaces = [[0, 1, 2, 2]]
845
+ elif v == 4:
846
+ mfaces = [[0, 1, 2, 3]]
847
+ else:
848
+ mfaces = [list(range(v))]
849
+
850
+ guid = draw_mesh(
851
+ points,
852
+ mfaces,
853
+ color=color,
854
+ name=name,
855
+ clear=False,
856
+ redraw=False,
857
+ layer=None,
858
+ )
859
+
860
+ if vertexcolors:
861
+ try:
862
+ compas_rhino.objects.set_mesh_vertex_colors(guid, vertexcolors)
863
+ except Exception:
864
+ pass
865
+
866
+ guids.append(guid)
867
+
868
+ return guids
869
+
870
+
871
+ def _face_to_max_quad(points, face):
872
+ faces = []
873
+ c = len(points)
874
+ points.append(centroid_polygon(points))
875
+ for i in range(-1, len(face) - 1):
876
+ a = face[i]
877
+ b = face[i + 1]
878
+ faces.append([c, a, b, b])
879
+ return faces
880
+
881
+
882
+ @wrap_drawfunc
883
+ def draw_circles(circles, **kwargs):
884
+ """Draw circles and optionally set individual name, color, and layer properties.
885
+
886
+ Parameters
887
+ ----------
888
+ circles : list[dict]
889
+ A list of circle dictionaries.
890
+ See Notes, for more information about the structure of the dict.
891
+
892
+ Returns
893
+ -------
894
+ list[System.Guid]
895
+
896
+ Notes
897
+ -----
898
+ A circle dict has the following schema:
899
+
900
+ .. code-block:: python
901
+
902
+ Schema(
903
+ {
904
+ "plane": lambda x: len(x[0]) == 3 and len(x[1]) == 3,
905
+ "radius": And(Or(int, float), lambda x: x > 0),
906
+ Optional("name", default=""): str,
907
+ Optional("color", default=None): And(lambda x: len(x) == 3, all(0 <= y <= 255 for y in x)),
908
+ Optional("layer", default=None): str,
909
+ }
910
+ )
911
+
912
+ """
913
+ guids = []
914
+ for data in iter(circles):
915
+ point, normal = data["plane"]
916
+ radius = data["radius"]
917
+ name = data.get("name", "")
918
+ color = data.get("color")
919
+ layer = data.get("layer")
920
+ circle = Rhino.Geometry.Circle(Rhino.Geometry.Plane(Rhino.Geometry.Point3d(*point), Rhino.Geometry.Vector3d(*normal)), radius)
921
+ guid = add_circle(circle)
922
+ if not guid:
923
+ continue
924
+ obj = find_object(guid)
925
+ if not obj:
926
+ continue
927
+ attr = obj.Attributes
928
+ if color:
929
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
930
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
931
+ else:
932
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
933
+ if layer and find_layer_by_fullpath:
934
+ index = find_layer_by_fullpath(layer, True)
935
+ if index >= 0:
936
+ attr.LayerIndex = index
937
+ attr.Name = name
938
+ attr.WireDensity = -1
939
+ obj.CommitChanges()
940
+ guids.append(guid)
941
+ return guids
942
+
943
+
944
+ @wrap_drawfunc
945
+ def draw_curves(curves, **kwargs):
946
+ """Draw curves and optionally set individual name, color, and layer properties.
947
+
948
+ Parameters
949
+ ----------
950
+ curves : list[dict]
951
+ A list of curve dictionaries.
952
+ See Notes, for more information about the structure of the dict.
953
+
954
+ Returns
955
+ -------
956
+ list[System.Guid]
957
+
958
+ Notes
959
+ -----
960
+ A curve dict has the following schema:
961
+
962
+ .. code-block:: python
963
+
964
+ Schema(
965
+ {
966
+ "curve": compas.geometry.Rhino.Geometry.Curve,
967
+ Optional("name", default=""): str,
968
+ Optional("color", default=None): And(lambda x: len(x) == 3, all(0 <= y <= 255 for y in x)),
969
+ Optional("layer", default=None): str,
970
+ }
971
+ )
972
+
973
+ """
974
+ guids = []
975
+ for data in iter(curves):
976
+ curve = data["curve"]
977
+ name = data.get("name", "")
978
+ color = data.get("color")
979
+ layer = data.get("layer")
980
+ guid = add_curve(curve.rhino_curve)
981
+ if not guid:
982
+ continue
983
+ obj = find_object(guid)
984
+ if not obj:
985
+ continue
986
+ attr = obj.Attributes
987
+ if color:
988
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
989
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
990
+ else:
991
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
992
+ if layer and find_layer_by_fullpath:
993
+ index = find_layer_by_fullpath(layer, True)
994
+ if index >= 0:
995
+ attr.LayerIndex = index
996
+ attr.Name = name
997
+ obj.CommitChanges()
998
+ guids.append(guid)
999
+ return guids
1000
+
1001
+
1002
+ @wrap_drawfunc
1003
+ def draw_surfaces(surfaces, **kwargs):
1004
+ """Draw surfaces and optionally set individual name, color, and layer properties.
1005
+
1006
+ Parameters
1007
+ ----------
1008
+ surfaces : list[dict]
1009
+ A list of surface dictionaries.
1010
+ See Notes, for more information about the structure of the dict.
1011
+
1012
+ Returns
1013
+ -------
1014
+ list[System.Guid]
1015
+
1016
+ Notes
1017
+ -----
1018
+ A surface dict has the following schema:
1019
+
1020
+ .. code-block:: python
1021
+
1022
+ Schema(
1023
+ {
1024
+ "surface": compas.geometry.Surface,
1025
+ Optional("name", default=""): str,
1026
+ Optional("color", default=None): And(lambda x: len(x) == 3, all(0 <= y <= 255 for y in x)),
1027
+ Optional("layer", default=None): str,
1028
+ }
1029
+ )
1030
+
1031
+ """
1032
+ guids = []
1033
+ for data in iter(surfaces):
1034
+ surface = data["surface"]
1035
+ name = data.get("name", "")
1036
+ color = data.get("color")
1037
+ layer = data.get("layer")
1038
+ guid = add_surface(surface.rhino_surface)
1039
+ if not guid:
1040
+ continue
1041
+ obj = find_object(guid)
1042
+ if not obj:
1043
+ continue
1044
+ attr = obj.Attributes
1045
+ if color:
1046
+ attr.ObjectColor = System.Drawing.Color.FromArgb(*color)
1047
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromObject
1048
+ else:
1049
+ attr.ColorSource = Rhino.DocObjects.ObjectColorSource.ColorFromLayer
1050
+ if layer and find_layer_by_fullpath:
1051
+ index = find_layer_by_fullpath(layer, True)
1052
+ if index >= 0:
1053
+ attr.LayerIndex = index
1054
+ attr.Name = name
1055
+ obj.CommitChanges()
1056
+ guids.append(guid)
1057
+ return guids
1058
+
1059
+
1060
+ @wrap_drawfunc
1061
+ def draw_brep(brep, color=None, **kwargs):
1062
+ """Draw a brep to the Rhino document.
1063
+
1064
+ Parameters
1065
+ ----------
1066
+ brep : :class:`compas_rhino.geometry.RhinoRhino.Geometry.Brep`
1067
+ The brep to draw.
1068
+ color : tuple[int, int, int] | tuple[float, float, float], optional
1069
+ The color to draw the brep with.
1070
+
1071
+ Returns
1072
+ -------
1073
+ :rhino:`System.Guid`
1074
+ The Rhino document GUID of the drawn Rhino.Geometry.Brep.
1075
+
1076
+ """
1077
+ native_brep = brep.native_brep
1078
+ if color:
1079
+ for face in native_brep.Faces:
1080
+ face.PerFaceColor = System.Drawing.Color.FromArgb(*color)
1081
+ return add_brep(native_brep)