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,1141 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ import json
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
13
+
14
+ find_object = sc.doc.Objects.Find
15
+
16
+ try:
17
+ purge_object = sc.doc.Objects.Purge
18
+ except AttributeError:
19
+ purge_object = None
20
+
21
+
22
+ # ==============================================================================
23
+ # Objects
24
+ # ==============================================================================
25
+
26
+
27
+ def get_objects(name=None, color=None, layer=None, type=None):
28
+ """Get identifiers of Rhino objects, potentially filtered by name, color, layer, or type.
29
+
30
+ Parameters
31
+ ----------
32
+ name : str, optional
33
+ Name of the objects.
34
+ color : tuple or list, optional
35
+ RGB color components in integer format (0-255).
36
+ layer : str, optional
37
+ Layer containing the objects.
38
+ type : Rhino.DocObjects.ObjectType, optional
39
+ The object type.
40
+
41
+ Returns
42
+ -------
43
+ list[System.Guid]
44
+ The System.Guids of the objects matching the filter parameters.
45
+
46
+ Examples
47
+ --------
48
+ .. code-block:: python
49
+
50
+ import compas_rhino
51
+
52
+ guids_all = compas_rhino.get_objects()
53
+ guids_compas = compas_rhino.get_objects(name="COMPAS.*")
54
+ guids_red = compas_rhino.get_objects(color=(255, 0, 0))
55
+ guids_points = compas_rhino.get_objects(type=compas_rhino.rs.filter.point)
56
+ guids_redpoints = compas_rhino.get_objects(color=(255, 0, 0), type=compas_rhino.rs.filter.point)
57
+
58
+ .. code-block:: python
59
+
60
+ guids_all = set(compas_rhino.get_objects())
61
+ guids_compas = set(compas_rhino.get_objects(name='COMPAS.*'))
62
+ guids_red = set(compas_rhino.get_objects(color=(255, 0, 0)))
63
+ guids_points = set(compas_rhino.get_objects(type=compas_rhino.rs.filter.point))
64
+ guids_redpoints = set(compas_rhino.get_objects(color=(255, 0, 0), type=compas_rhino.rs.filter.point))
65
+
66
+ print guids_compas.issubset(guids_all)
67
+ print guids_all.issubset(guids_compas)
68
+
69
+ # True, False
70
+
71
+ print guids_red.issubset(guids_all)
72
+ print guids_points.issubset(guids_all)
73
+ print guids_redpoints.issubset(guids_all)
74
+
75
+ # True, True, True
76
+
77
+ print guids_redpoints.issubset(guids_points)
78
+ print guids_redpoints.issubset(guids_red)
79
+ print guids_points.issubset(guids_red)
80
+
81
+ # True, True, False
82
+
83
+ """
84
+ guids = rs.AllObjects()
85
+ if name:
86
+ guids = list(set(guids) & set(rs.ObjectsByName(name)))
87
+ if color:
88
+ guids = list(set(guids) & set(rs.ObjectsByColor(color)))
89
+ if layer:
90
+ guids = list(set(guids) & set(rs.ObjectsByLayer(layer)))
91
+ if type:
92
+ guids = list(set(guids) & set(rs.ObjectsByType(type)))
93
+ return guids
94
+
95
+
96
+ def delete_object(guid, purge=None, redraw=True):
97
+ """Delete Rhino object.
98
+
99
+ Parameters
100
+ ----------
101
+ guid : System.Guid
102
+ Object identifier.
103
+ purge : None or bool, optional
104
+ If None, the value of the global purge setting (:obj:`compas_rhino.PURGE_ON_DELETE`) will be used.
105
+ If True, purge the object from history after deleting.
106
+ If False, delete but don't purge.
107
+ redraw : bool, optional
108
+ If True, redrawing will be enabled and enacted.
109
+ If False, redrawing will be disabled.
110
+
111
+ Returns
112
+ -------
113
+ None
114
+
115
+ """
116
+ if purge is None:
117
+ purge = compas_rhino.PURGE_ON_DELETE
118
+ if purge and purge_object:
119
+ purge_objects([guid], redraw=redraw)
120
+ else:
121
+ delete_objects([guid], purge, redraw=redraw)
122
+
123
+
124
+ def delete_objects(guids, purge=None, redraw=True):
125
+ """Delete multiple Rhino objects.
126
+
127
+ Parameters
128
+ ----------
129
+ guids : list[System.Guid]
130
+ Object identifiers.
131
+ purge : None or bool, optional
132
+ If None, the value of the global purge setting (:obj:`compas_rhino.PURGE_ON_DELETE`) will be used.
133
+ If True, purge the objects from history after deleting.
134
+ If False, delete but don't purge.
135
+ redraw : bool, optional
136
+ If True, redrawing will be enabled and enacted.
137
+ If False, redrawing will be disabled.
138
+
139
+ Returns
140
+ -------
141
+ None
142
+
143
+ """
144
+ if purge is None:
145
+ purge = compas_rhino.PURGE_ON_DELETE
146
+ if purge and purge_object:
147
+ purge_objects(guids, redraw=redraw)
148
+ else:
149
+ rs.EnableRedraw(False)
150
+ for guid in guids:
151
+ if rs.IsObjectHidden(guid):
152
+ rs.ShowObject(guid)
153
+ rs.DeleteObjects(guids)
154
+ if redraw:
155
+ rs.EnableRedraw(True)
156
+ sc.doc.Views.Redraw()
157
+
158
+
159
+ def purge_objects(guids, redraw=True):
160
+ """Purge objects from memory.
161
+
162
+ Parameters
163
+ ----------
164
+ guids : list[System.Guid]
165
+ Object identifiers.
166
+ redraw : bool, optional
167
+ If True, redrawing will be enabled and enacted.
168
+ If False, redrawing will be disabled.
169
+
170
+ Returns
171
+ -------
172
+ None
173
+
174
+ """
175
+ if not purge_object:
176
+ raise RuntimeError("Cannot purge outside Rhino script context")
177
+ rs.EnableRedraw(False)
178
+ for guid in guids:
179
+ if rs.IsObject(guid):
180
+ if rs.IsObjectHidden(guid):
181
+ rs.ShowObject(guid)
182
+ o = find_object(guid)
183
+ purge_object(o.RuntimeSerialNumber)
184
+ if redraw:
185
+ rs.EnableRedraw(True)
186
+ sc.doc.Views.Redraw()
187
+
188
+
189
+ def get_object_layers(guids):
190
+ """Get the layer names of multiple objects.
191
+
192
+ Parameters
193
+ ----------
194
+ guids : list[System.Guid]
195
+ Object identifiers.
196
+
197
+ Returns
198
+ -------
199
+ list[str]
200
+
201
+ """
202
+ return [rs.ObjectLayer(guid) for guid in guids]
203
+
204
+
205
+ def get_object_types(guids):
206
+ """Get the type of multiple objects.
207
+
208
+ Parameters
209
+ ----------
210
+ guids : list[System.Guid]
211
+ Object identifiers.
212
+
213
+ Returns
214
+ -------
215
+ list[str]
216
+
217
+ """
218
+ return [rs.ObjectType(guid) for guid in guids]
219
+
220
+
221
+ def get_object_names(guids):
222
+ """Get the names of multiple objects.
223
+
224
+ Parameters
225
+ ----------
226
+ guids : list[System.Guid]
227
+ Object identifiers.
228
+
229
+ Returns
230
+ -------
231
+ list[str]
232
+
233
+ """
234
+ return [rs.ObjectName(guid) for guid in guids]
235
+
236
+
237
+ def get_object_name(guid):
238
+ """Get the name of one object.
239
+
240
+ Parameters
241
+ ----------
242
+ guid : System.Guid
243
+ Object identifier.
244
+
245
+ Returns
246
+ -------
247
+ str
248
+
249
+ """
250
+ return rs.ObjectName(guid)
251
+
252
+
253
+ def get_object_attributes(guid):
254
+ """Get attributes from an object's user dictionary.
255
+
256
+ Parameters
257
+ ----------
258
+ guid : System.Guid
259
+ Object identifier.
260
+
261
+ Returns
262
+ -------
263
+ dict[str, Any]
264
+
265
+ """
266
+ o = find_object(guid)
267
+ u = o.Attributes.UserDictionary
268
+ a = {}
269
+ if u.Count:
270
+ for key in u.Keys:
271
+ a[key] = u.Item[key]
272
+ return a
273
+
274
+
275
+ def set_object_attributes(guid, attr):
276
+ """Set the custom attributes of a Rhino object.
277
+
278
+ Parameters
279
+ ----------
280
+ guid : System.Guid
281
+ Object identifier.
282
+ attr : dict[str, Any]
283
+ A dictionary of attributes.
284
+
285
+ Returns
286
+ -------
287
+ None
288
+
289
+ Raises
290
+ ------
291
+ Exception
292
+ If the operation fails.
293
+
294
+ """
295
+ o = find_object(guid)
296
+ u = o.Attributes.UserDictionary
297
+ for name, value in iter(attr.items()):
298
+ try:
299
+ u.Set(name, value)
300
+ except Exception:
301
+ print("The following item cannot be stored in the user dictionary of this object: {0} => {1}".format(name, value))
302
+
303
+
304
+ def get_object_attributes_from_name(guids, prefix=None):
305
+ """Get attributes from JSON parsable object names.
306
+
307
+ Parameters
308
+ ----------
309
+ guids : list[System.Guid]
310
+ Object identifiers.
311
+ prefix : str, optional
312
+ A prefix that should be removed before the name is JSON parsable.
313
+ For example, in Rhino 6 and above, names can't start with curly braces ("{").
314
+ Therefore, to make the string representation of a dict a valid name it has to be prefixed with something.
315
+ This prefix can be stripped automatically using this parameter.
316
+
317
+ Returns
318
+ -------
319
+ list[dict[str, Any]]
320
+ The attribute dicts of the objects.
321
+
322
+ """
323
+ load = json.loads
324
+ attrs = []
325
+ for name in get_object_names(guids):
326
+ try:
327
+ if prefix:
328
+ name = name.lstrip(prefix)
329
+ attr = load(name)
330
+ except (ValueError, TypeError):
331
+ attr = {}
332
+ attrs.append(attr)
333
+ return attrs
334
+
335
+
336
+ def select_object(message="Select an object."):
337
+ """Select one object in the Rhino view.
338
+
339
+ Parameters
340
+ ----------
341
+ message : str, optional
342
+ Instruction for the user.
343
+
344
+ Returns
345
+ -------
346
+ System.Guid
347
+ The identifer of the selected object.
348
+
349
+ """
350
+ return rs.GetObject(message)
351
+
352
+
353
+ def select_objects(message="Select multiple objects."):
354
+ """Select multiple objects in the Rhino view.
355
+
356
+ Parameters
357
+ ----------
358
+ message : str, optional
359
+ Instruction for the user.
360
+
361
+ Returns
362
+ -------
363
+ list[System.Guid]
364
+ The identifers of the selected objects.
365
+
366
+ """
367
+ guids = []
368
+ temp = rs.GetObjects(message)
369
+ if temp:
370
+ return temp
371
+ return guids
372
+
373
+
374
+ # ==============================================================================
375
+ # Points
376
+ # ==============================================================================
377
+
378
+
379
+ def select_point(message="Select one point."):
380
+ """Select one point in the Rhino view.
381
+
382
+ Parameters
383
+ ----------
384
+ message : str, optional
385
+ Instruction for the user.
386
+
387
+ Returns
388
+ -------
389
+ System.Guid
390
+ The identifer of the selected point.
391
+
392
+ """
393
+ return rs.GetObject(message, preselect=True, select=True, filter=rs.filter.point)
394
+
395
+
396
+ def select_points(message="Select multiple points."):
397
+ """Select multiple points in the Rhino view.
398
+
399
+ Parameters
400
+ ----------
401
+ message : str, optional
402
+ Instruction for the user.
403
+
404
+ Returns
405
+ -------
406
+ list[System.Guid]
407
+ The identifers of the selected points.
408
+
409
+ """
410
+ guids = []
411
+ temp = rs.GetObjects(message, preselect=True, select=True, group=False, filter=rs.filter.point)
412
+ if temp:
413
+ guids = temp
414
+ return guids
415
+
416
+
417
+ def get_points(layer=None):
418
+ """Get all points.
419
+
420
+ Parameters
421
+ ----------
422
+ layer : str, optional
423
+ Name of a layer containing the points.
424
+
425
+ Returns
426
+ -------
427
+ list[System.Guid]
428
+ The identifiers of the points.
429
+
430
+ """
431
+ if layer:
432
+ rs.EnableRedraw(False)
433
+ # Argument names for LayerVisible command are not the same for Rhino5 and Rhino6
434
+ # that is why we use positional instead of named arguments
435
+ visible = rs.LayerVisible(layer, True, True)
436
+ guids = rs.ObjectsByType(rs.filter.point)
437
+ guids = list(set(guids) & set(rs.ObjectsByLayer(layer)))
438
+ rs.LayerVisible(layer, visible, True)
439
+ rs.EnableRedraw(True)
440
+ else:
441
+ guids = rs.ObjectsByType(rs.filter.point)
442
+ return guids
443
+
444
+
445
+ def get_point_coordinates(guids):
446
+ """Get the coordintes of the locations of point objects.
447
+
448
+ Parameters
449
+ ----------
450
+ guids : list[System.Guid]
451
+
452
+ Returns
453
+ -------
454
+ list[[float, float, float]]
455
+ The location coordinates of the points.
456
+
457
+ """
458
+ points = []
459
+ for guid in guids:
460
+ point = rs.PointCoordinates(guid)
461
+ if point:
462
+ points.append(map(float, point))
463
+ return points
464
+
465
+
466
+ # ==============================================================================
467
+ # Curves
468
+ # ==============================================================================
469
+
470
+
471
+ def is_curve_line(guid):
472
+ """Verify that a curve is a line.
473
+
474
+ Parameters
475
+ ----------
476
+ guid : System.Guid
477
+ The identifier of the curve.
478
+
479
+ Returns
480
+ -------
481
+ bool
482
+ True if the curve is a line.
483
+ False otherwise.
484
+
485
+ """
486
+ return rs.IsCurve(guid) and rs.IsLine(guid) and rs.CurveDegree(guid) == 1 and len(rs.CurvePoints(guid)) == 2
487
+
488
+
489
+ def is_curve_polyline(guid):
490
+ return rs.IsCurve(guid) and rs.IsPolyline(guid) and rs.CurveDegree(guid) == 1 and len(rs.CurvePoints(guid)) > 2
491
+
492
+
493
+ def is_curve_polygon(guid):
494
+ return rs.IsCurve(guid) and rs.IsCurveClosed(guid) and rs.CurveDegree(guid) == 1 and len(rs.CurvePoints(guid)) > 2
495
+
496
+
497
+ def select_curve(message="Select one curve."):
498
+ """Select one curve in the Rhino view.
499
+
500
+ Parameters
501
+ ----------
502
+ message : str, optional
503
+ Instruction for the user.
504
+
505
+ Returns
506
+ -------
507
+ System.Guid
508
+ The identifer of the selected curve.
509
+
510
+ """
511
+ return rs.GetObject(message, preselect=True, select=True, filter=rs.filter.curve)
512
+
513
+
514
+ def select_curves(message="Select multiple curves."):
515
+ """Select multiple curves in the Rhino view.
516
+
517
+ Parameters
518
+ ----------
519
+ message : str, optional
520
+ Instruction for the user.
521
+
522
+ Returns
523
+ -------
524
+ list[System.Guid]
525
+ The identifers of the selected curves.
526
+
527
+ """
528
+ guids = []
529
+ temp = rs.GetObjects(message, preselect=True, select=True, group=False, filter=rs.filter.curve)
530
+ if temp:
531
+ guids = temp
532
+ return guids
533
+
534
+
535
+ def select_line(message="Select line."):
536
+ """Select one line in the Rhino view.
537
+
538
+ Parameters
539
+ ----------
540
+ message : str, optional
541
+ Instruction for the user.
542
+
543
+ Returns
544
+ -------
545
+ System.Guid
546
+ The identifer of the selected line.
547
+
548
+ """
549
+ guid = rs.GetObject(message, preselect=True, select=True, filter=rs.filter.curve)
550
+ if is_curve_line(guid):
551
+ return guid
552
+ return None
553
+
554
+
555
+ def select_lines(message="Select multiple lines."):
556
+ """Select multiple lines in the Rhino view.
557
+
558
+ Parameters
559
+ ----------
560
+ message : str, optional
561
+ Instruction for the user.
562
+
563
+ Returns
564
+ -------
565
+ list[System.Guid]
566
+ The identifers of the selected lines.
567
+
568
+ """
569
+ guids = []
570
+ temp = rs.GetObjects(message, preselect=True, select=True, group=False, filter=rs.filter.curve)
571
+ if temp:
572
+ for guid in temp:
573
+ if is_curve_line(guid):
574
+ guids.append(guid)
575
+ return guids
576
+
577
+
578
+ def select_polyline(
579
+ message="Select one polyline (curve with degree = 1, and multiple segments).",
580
+ ):
581
+ """Select one polyline in the Rhino view.
582
+
583
+ Parameters
584
+ ----------
585
+ message : str, optional
586
+ Instruction for the user.
587
+
588
+ Returns
589
+ -------
590
+ System.Guid
591
+ The identifer of the selected polyline.
592
+
593
+ """
594
+ guid = rs.GetObject(message, preselect=True, select=True, filter=rs.filter.curve)
595
+ if is_curve_polyline(guid):
596
+ return guid
597
+ return None
598
+
599
+
600
+ def select_polylines(
601
+ message="Select multiple polylines (curves with degree = 1, and multiple segments).",
602
+ ):
603
+ """Select multiple polylines in the Rhino view.
604
+
605
+ Parameters
606
+ ----------
607
+ message : str, optional
608
+ Instruction for the user.
609
+
610
+ Returns
611
+ -------
612
+ list[System.Guid]
613
+ The identifers of the selected polylines.
614
+
615
+ """
616
+ guids = []
617
+ temp = rs.GetObjects(message, preselect=True, select=True, group=False, filter=rs.filter.curve)
618
+ if temp:
619
+ for guid in temp:
620
+ if is_curve_polyline(guid):
621
+ guids.append(guid)
622
+ return guids
623
+
624
+
625
+ def select_polygon(message="Select one polygon (closed curve with degree = 1)"):
626
+ """Select one polygon in the Rhino view.
627
+
628
+ Parameters
629
+ ----------
630
+ message : str, optional
631
+ Instruction for the user.
632
+
633
+ Returns
634
+ -------
635
+ System.Guid
636
+ The identifer of the selected polygon.
637
+
638
+ """
639
+ guid = rs.GetObject(message, preselect=True, select=True, filter=rs.filter.curve)
640
+ if is_curve_polygon(guid):
641
+ return guid
642
+ return None
643
+
644
+
645
+ def select_polygons(message="Select multiple polygons (closed curves with degree = 1)"):
646
+ """Select multiple polygons in the Rhino view.
647
+
648
+ Parameters
649
+ ----------
650
+ message : str, optional
651
+ Instruction for the user.
652
+
653
+ Returns
654
+ -------
655
+ list[System.Guid]
656
+ The identifers of the selected polygons.
657
+
658
+ """
659
+ guids = []
660
+ temp = rs.GetObjects(message, preselect=True, select=True, group=False, filter=rs.filter.curve)
661
+ if temp:
662
+ for guid in temp:
663
+ if is_curve_polygon(guid):
664
+ guids.append(guid)
665
+ return guids
666
+
667
+
668
+ def get_curves(layer=None):
669
+ """Get all curves.
670
+
671
+ Parameters
672
+ ----------
673
+ layer : str, optional
674
+ Name of a layer containing the curves.
675
+
676
+ Returns
677
+ -------
678
+ list[System.Guid]
679
+ The identifiers of the curves.
680
+
681
+ """
682
+ if layer:
683
+ rs.EnableRedraw(False)
684
+ # Argument names for LayerVisible command are not the same for Rhino5 and Rhino6
685
+ # that is why we use positional instead of named arguments
686
+ visible = rs.LayerVisible(layer, True, True)
687
+ guids = rs.ObjectsByType(rs.filter.curve)
688
+ guids = list(set(guids) & set(rs.ObjectsByLayer(layer)))
689
+ rs.LayerVisible(layer, visible, True)
690
+ rs.EnableRedraw(True)
691
+ else:
692
+ guids = rs.ObjectsByType(rs.filter.curve)
693
+ return guids
694
+
695
+
696
+ def get_lines(layer=None):
697
+ """Get all lines.
698
+
699
+ Parameters
700
+ ----------
701
+ layer : str, optional
702
+ Name of a layer containing the lines.
703
+
704
+ Returns
705
+ -------
706
+ list[System.Guid]
707
+ The identifiers of the lines.
708
+
709
+ """
710
+ if layer:
711
+ rs.EnableRedraw(False)
712
+ # Argument names for LayerVisible command are not the same for Rhino5 and Rhino6
713
+ # that is why we use positional instead of named arguments
714
+ visible = rs.LayerVisible(layer, True, True)
715
+ guids = rs.ObjectsByType(rs.filter.curve)
716
+ guids = [guid for guid in guids if is_curve_line(guid)]
717
+ guids = list(set(guids) & set(rs.ObjectsByLayer(layer)))
718
+ rs.LayerVisible(layer, visible, True)
719
+ rs.EnableRedraw(True)
720
+ else:
721
+ guids = rs.ObjectsByType(rs.filter.curve)
722
+ guids = [guid for guid in guids if is_curve_line(guid)]
723
+ return guids
724
+
725
+
726
+ def get_polylines(layer=None):
727
+ """Get all polylines.
728
+
729
+ Parameters
730
+ ----------
731
+ layer : str, optional
732
+ Name of a layer containing the polylines.
733
+
734
+ Returns
735
+ -------
736
+ list[System.Guid]
737
+ The identifiers of the polylines.
738
+
739
+ """
740
+ if layer:
741
+ rs.EnableRedraw(False)
742
+ # Argument names for LayerVisible command are not the same for Rhino5 and Rhino6
743
+ # that is why we use positional instead of named arguments
744
+ visible = rs.LayerVisible(layer, True, True)
745
+ guids = rs.ObjectsByType(rs.filter.curve)
746
+ guids = [guid for guid in guids if is_curve_polyline(guid)]
747
+ guids = list(set(guids) & set(rs.ObjectsByLayer(layer)))
748
+ rs.LayerVisible(layer, visible, True)
749
+ rs.EnableRedraw(True)
750
+ else:
751
+ guids = rs.ObjectsByType(rs.filter.curve)
752
+ guids = [guid for guid in guids if is_curve_polyline(guid)]
753
+ return guids
754
+
755
+
756
+ def get_polygons(layer=None):
757
+ """Get all polygons.
758
+
759
+ Parameters
760
+ ----------
761
+ layer : str, optional
762
+ Name of a layer containing the polygons.
763
+
764
+ Returns
765
+ -------
766
+ list[System.Guid]
767
+ The identifiers of the polygons.
768
+
769
+ """
770
+ if layer:
771
+ rs.EnableRedraw(False)
772
+ # Argument names for LayerVisible command are not the same for Rhino5 and Rhino6
773
+ # that is why we use positional instead of named arguments
774
+ visible = rs.LayerVisible(layer, True, True)
775
+ guids = rs.ObjectsByType(rs.filter.curve)
776
+ guids = [guid for guid in guids if is_curve_polygon(guid)]
777
+ guids = list(set(guids) & set(rs.ObjectsByLayer(layer)))
778
+ rs.LayerVisible(layer, visible, True)
779
+ rs.EnableRedraw(True)
780
+ else:
781
+ guids = rs.ObjectsByType(rs.filter.curve)
782
+ guids = [guid for guid in guids if is_curve_polygon(guid)]
783
+ return guids
784
+
785
+
786
+ def get_line_coordinates(guids):
787
+ """Get the start and end point coordinates of line curves.
788
+
789
+ Parameters
790
+ ----------
791
+ guids : list[System.Guid]
792
+ Line curve identifiers.
793
+
794
+ Returns
795
+ -------
796
+ list[tuple[[float, float, float], [float, float, float]]]
797
+ A start and end point per line.
798
+
799
+ """
800
+ if isinstance(guids, System.Guid):
801
+ sp = map(float, rs.CurveStartPoint(guids))
802
+ ep = map(float, rs.CurveEndPoint(guids))
803
+ return sp, ep
804
+ lines = []
805
+ for guid in guids:
806
+ sp = map(float, rs.CurveStartPoint(guid))
807
+ ep = map(float, rs.CurveEndPoint(guid))
808
+ lines.append((sp, ep))
809
+ return lines
810
+
811
+
812
+ def get_polyline_coordinates(guids):
813
+ """Get the point coordinates of polylines.
814
+
815
+ Parameters
816
+ ----------
817
+ guids : list[System.Guid]
818
+ Polyline curve identifiers.
819
+
820
+ Returns
821
+ -------
822
+ list[list[[float, float, float]]]
823
+ A list of point coordinates per polyline.
824
+
825
+ """
826
+ if isinstance(guids, System.Guid):
827
+ points = rs.PolylineVertices(guids)
828
+ coords = []
829
+ if points:
830
+ coords = [map(float, point) for point in points]
831
+ return coords
832
+ polylines = []
833
+ for guid in guids:
834
+ points = rs.PolylineVertices(guid)
835
+ coords = []
836
+ if points:
837
+ coords = [map(float, point) for point in points]
838
+ polylines.append(coords)
839
+ return polylines
840
+
841
+
842
+ def get_polygon_coordinates(guids):
843
+ """Get the point coordinates of polygons.
844
+
845
+ Parameters
846
+ ----------
847
+ guids : list[System.Guid]
848
+ Polygon curve identifiers.
849
+
850
+ Returns
851
+ -------
852
+ list[list[[float, float, float]]]
853
+ A list of point coordinates per polygon.
854
+
855
+ """
856
+ if isinstance(guids, System.Guid):
857
+ points = rs.CurvePoints(guids)
858
+ coords = []
859
+ if points:
860
+ coords = [list(point) for point in points]
861
+ return coords
862
+ polygons = []
863
+ if guids:
864
+ for guid in guids:
865
+ points = rs.CurvePoints(guid)
866
+ coords = []
867
+ if points:
868
+ coords = map(list, points)
869
+ polygons.append(coords)
870
+ return polygons
871
+
872
+
873
+ # ==============================================================================
874
+ # Surfaces
875
+ # ==============================================================================
876
+
877
+
878
+ def select_surface(message="Select one surface."):
879
+ """Select one surface in the Rhino view.
880
+
881
+ Parameters
882
+ ----------
883
+ message : str, optional
884
+ Instruction for the user.
885
+
886
+ Returns
887
+ -------
888
+ System.Guid
889
+ The identifer of the selected surface.
890
+
891
+ """
892
+ return rs.GetObject(
893
+ message,
894
+ preselect=True,
895
+ select=True,
896
+ filter=rs.filter.surface | rs.filter.polysurface,
897
+ )
898
+
899
+
900
+ def select_surfaces(message="Select multiple surfaces."):
901
+ """Select multiple surfaces in the Rhino view.
902
+
903
+ Parameters
904
+ ----------
905
+ message : str, optional
906
+ Instruction for the user.
907
+
908
+ Returns
909
+ -------
910
+ list[System.Guid]
911
+ The identifers of the selected surfaces.
912
+
913
+ """
914
+ guids = []
915
+ temp = rs.GetObjects(
916
+ message,
917
+ preselect=True,
918
+ select=True,
919
+ group=False,
920
+ filter=rs.filter.surface | rs.filter.polysurface,
921
+ )
922
+ if temp:
923
+ guids = temp
924
+ return guids
925
+
926
+
927
+ # ==============================================================================
928
+ # Meshes
929
+ # ==============================================================================
930
+
931
+
932
+ def select_mesh(message="Select one mesh."):
933
+ """Select one mesh in the Rhino view.
934
+
935
+ Parameters
936
+ ----------
937
+ message : str, optional
938
+ Instruction for the user.
939
+
940
+ Returns
941
+ -------
942
+ System.Guid
943
+ The identifer of the selected mesh.
944
+
945
+ """
946
+ return rs.GetObject(message, preselect=True, select=True, filter=rs.filter.mesh)
947
+
948
+
949
+ def select_meshes(message="Select multiple meshes."):
950
+ """Select multiple meshes in the Rhino view.
951
+
952
+ Parameters
953
+ ----------
954
+ message : str, optional
955
+ Instruction for the user.
956
+
957
+ Returns
958
+ -------
959
+ list[System.Guid]
960
+ The identifers of the selected meshs.
961
+
962
+ """
963
+ guids = []
964
+ temp = rs.GetObjects(message, preselect=True, select=True, group=False, filter=rs.filter.mesh)
965
+ if temp:
966
+ guids = temp
967
+ return guids
968
+
969
+
970
+ def get_meshes(layer=None):
971
+ if layer:
972
+ rs.EnableRedraw(False)
973
+ # Argument names for LayerVisible command are not the same for Rhino5 and Rhino6
974
+ # that is why we use positional instead of named arguments
975
+ visible = rs.LayerVisible(layer, True, True)
976
+ guids = rs.ObjectsByType(rs.filter.mesh)
977
+ guids = list(set(guids) & set(rs.ObjectsByLayer(layer)))
978
+ rs.LayerVisible(layer, visible, True)
979
+ rs.EnableRedraw(True)
980
+ else:
981
+ guids = rs.ObjectsByType(rs.filter.mesh)
982
+ return guids
983
+
984
+
985
+ def get_mesh_border(guid):
986
+ return rs.DuplicateMeshBorder(guid)
987
+
988
+
989
+ def get_mesh_face_vertices(guid):
990
+ faces = []
991
+ if guid:
992
+ temp = rs.MeshFaceVertices(guid)
993
+ faces = map(list, temp)
994
+ return faces
995
+
996
+
997
+ def get_mesh_vertex_coordinates(guid):
998
+ vertices = []
999
+ if guid:
1000
+ vertices = [map(float, vertex) for vertex in rs.MeshVertices(guid)]
1001
+ return vertices
1002
+
1003
+
1004
+ def get_mesh_vertex_colors(guid):
1005
+ colors = []
1006
+ if guid:
1007
+ temp = rs.MeshVertexColors(guid)
1008
+ if temp:
1009
+ colors = map(list, temp)
1010
+ return colors
1011
+
1012
+
1013
+ def set_mesh_vertex_colors(guid, colors):
1014
+ if not guid:
1015
+ return
1016
+ return rs.MeshVertexColors(guid, colors)
1017
+
1018
+
1019
+ def get_mesh_vertices_and_faces(guid):
1020
+ if not guid:
1021
+ return
1022
+ vertices = [map(float, vertex) for vertex in rs.MeshVertices(guid)]
1023
+ faces = map(list, rs.MeshFaceVertices(guid))
1024
+ return vertices, faces
1025
+
1026
+
1027
+ def get_mesh_vertex_index(guid):
1028
+ class CustomGetObject(Rhino.Input.Custom.GetObject):
1029
+ def CustomGeometryFilter(self, rhino_object, geometry, component_index):
1030
+ return guid == rhino_object.Id
1031
+
1032
+ go = CustomGetObject()
1033
+ go.SetCommandPrompt("Select one vertex of the mesh.")
1034
+ go.GeometryFilter = Rhino.DocObjects.ObjectType.MeshVertex
1035
+ go.AcceptNothing(True)
1036
+ if go.Get() != Rhino.Input.GetResult.Object:
1037
+ return None
1038
+ objref = go.Object(0)
1039
+ if not objref:
1040
+ return None
1041
+ tvindex = objref.GeometryComponentIndex.Index
1042
+ mobj = sc.doc.Objects.Find(guid)
1043
+ mgeo = mobj.Geometry
1044
+ temp = mgeo.TopologyVertices.MeshVertexIndices(tvindex)
1045
+ vindex = temp[0]
1046
+ go.Dispose()
1047
+ return vindex
1048
+
1049
+
1050
+ def get_mesh_face_index(guid):
1051
+ class CustomGetObject(Rhino.Input.Custom.GetObject):
1052
+ def CustomGeometryFilter(self, rhino_object, geometry, component_index):
1053
+ return guid == rhino_object.Id
1054
+
1055
+ go = CustomGetObject()
1056
+ go.SetCommandPrompt("Select one face of the mesh.")
1057
+ go.GeometryFilter = Rhino.DocObjects.ObjectType.MeshFace
1058
+ go.AcceptNothing(True)
1059
+ if go.Get() != Rhino.Input.GetResult.Object:
1060
+ return None
1061
+ objref = go.Object(0)
1062
+ if not objref:
1063
+ return None
1064
+ findex = objref.GeometryComponentIndex.Index
1065
+ go.Dispose()
1066
+ return findex
1067
+
1068
+
1069
+ def get_mesh_edge_index(guid):
1070
+ class CustomGetObject(Rhino.Input.Custom.GetObject):
1071
+ def CustomGeometryFilter(self, rhino_object, geometry, component_index):
1072
+ return guid == rhino_object.Id
1073
+
1074
+ go = CustomGetObject()
1075
+ go.SetCommandPrompt("Select an edge of the mesh.")
1076
+ go.GeometryFilter = Rhino.DocObjects.ObjectType.MeshEdge
1077
+ go.AcceptNothing(True)
1078
+ if go.Get() != Rhino.Input.GetResult.Object:
1079
+ return None
1080
+ objref = go.Object(0)
1081
+ if not objref:
1082
+ return None
1083
+ eindex = objref.GeometryComponentIndex.Index
1084
+ go.Dispose()
1085
+ return eindex
1086
+
1087
+
1088
+ def get_mesh_vertex_indices(guid):
1089
+ tvindices = rs.GetMeshVertices(guid, "Select mesh vertices.")
1090
+ if not tvindices:
1091
+ return
1092
+ mobj = sc.doc.Objects.Find(guid)
1093
+ mgeo = mobj.Geometry
1094
+ vindices = []
1095
+ for tvindex in tvindices:
1096
+ temp = mgeo.TopologyVertices.MeshVertexIndices(tvindex)
1097
+ vindices.append(temp[0])
1098
+ return vindices
1099
+
1100
+
1101
+ def get_mesh_face_indices(guid):
1102
+ return rs.GetMeshFaces(guid, "Select mesh faces.")
1103
+
1104
+
1105
+ def get_mesh_vertex_face_indices(guid):
1106
+ vindex = get_mesh_vertex_index(guid)
1107
+ if vindex is None:
1108
+ return
1109
+ mobj = sc.doc.Objects.Find(guid)
1110
+ mgeo = mobj.Geometry
1111
+ findices = mgeo.TopologyVertices.ConnectedFaces(vindex)
1112
+ return findices
1113
+
1114
+
1115
+ def get_mesh_face_vertex_indices(guid):
1116
+ findex = get_mesh_face_index(guid)
1117
+ if findex is None:
1118
+ return
1119
+ mobj = sc.doc.Objects.Find(guid)
1120
+ mgeo = mobj.Geometry
1121
+ tvertices = mgeo.Faces.GetTopologicalVertices(findex)
1122
+ vindices = []
1123
+ for tvertex in tvertices:
1124
+ temp = mgeo.TopologyVertices.MeshVertexIndices(tvertex)
1125
+ vindices.append(temp[0])
1126
+ return vindices
1127
+
1128
+
1129
+ def get_mesh_edge_vertex_indices(guid):
1130
+ eindex = get_mesh_edge_index(guid)
1131
+ if eindex is None:
1132
+ return
1133
+ mobj = sc.doc.Objects.Find(guid)
1134
+ mgeo = mobj.Geometry
1135
+ temp = mgeo.TopologyEdges.GetTopologyVertices(eindex)
1136
+ tvindices = temp.I, temp.J
1137
+ vindices = []
1138
+ for tvindex in tvindices:
1139
+ temp = mgeo.TopologyVertices.MeshVertexIndices(tvindex)
1140
+ vindices.append(temp[0])
1141
+ return vindices