COMPAS 2.1.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (468) hide show
  1. compas/__init__.py +274 -0
  2. compas/__main__.py +31 -0
  3. compas/_iotools.py +80 -0
  4. compas/_os.py +746 -0
  5. compas/colors/__init__.py +14 -0
  6. compas/colors/cmcrameri/acton.txt +256 -0
  7. compas/colors/cmcrameri/actonS.txt +100 -0
  8. compas/colors/cmcrameri/bam.txt +256 -0
  9. compas/colors/cmcrameri/bamO.txt +256 -0
  10. compas/colors/cmcrameri/bamako.txt +256 -0
  11. compas/colors/cmcrameri/bamakoS.txt +100 -0
  12. compas/colors/cmcrameri/batlow.txt +256 -0
  13. compas/colors/cmcrameri/batlowK.txt +256 -0
  14. compas/colors/cmcrameri/batlowS.txt +100 -0
  15. compas/colors/cmcrameri/batlowW.txt +256 -0
  16. compas/colors/cmcrameri/berlin.txt +256 -0
  17. compas/colors/cmcrameri/bilbao.txt +256 -0
  18. compas/colors/cmcrameri/bilbaoS.txt +100 -0
  19. compas/colors/cmcrameri/broc.txt +256 -0
  20. compas/colors/cmcrameri/brocO.txt +256 -0
  21. compas/colors/cmcrameri/buda.txt +256 -0
  22. compas/colors/cmcrameri/budaS.txt +100 -0
  23. compas/colors/cmcrameri/bukavu.txt +256 -0
  24. compas/colors/cmcrameri/cork.txt +256 -0
  25. compas/colors/cmcrameri/corkO.txt +256 -0
  26. compas/colors/cmcrameri/davos.txt +256 -0
  27. compas/colors/cmcrameri/davosS.txt +100 -0
  28. compas/colors/cmcrameri/devon.txt +256 -0
  29. compas/colors/cmcrameri/devonS.txt +100 -0
  30. compas/colors/cmcrameri/fes.txt +256 -0
  31. compas/colors/cmcrameri/grayC.txt +256 -0
  32. compas/colors/cmcrameri/grayCS.txt +100 -0
  33. compas/colors/cmcrameri/hawaii.txt +256 -0
  34. compas/colors/cmcrameri/hawaiiS.txt +100 -0
  35. compas/colors/cmcrameri/imola.txt +256 -0
  36. compas/colors/cmcrameri/imolaS.txt +100 -0
  37. compas/colors/cmcrameri/lajolla.txt +256 -0
  38. compas/colors/cmcrameri/lajollaS.txt +100 -0
  39. compas/colors/cmcrameri/lapaz.txt +256 -0
  40. compas/colors/cmcrameri/lapazS.txt +100 -0
  41. compas/colors/cmcrameri/lisbon.txt +256 -0
  42. compas/colors/cmcrameri/nuuk.txt +256 -0
  43. compas/colors/cmcrameri/nuukS.txt +100 -0
  44. compas/colors/cmcrameri/oleron.txt +256 -0
  45. compas/colors/cmcrameri/oslo.txt +256 -0
  46. compas/colors/cmcrameri/osloS.txt +100 -0
  47. compas/colors/cmcrameri/roma.txt +256 -0
  48. compas/colors/cmcrameri/romaO.txt +256 -0
  49. compas/colors/cmcrameri/tofino.txt +256 -0
  50. compas/colors/cmcrameri/tokyo.txt +256 -0
  51. compas/colors/cmcrameri/tokyoS.txt +100 -0
  52. compas/colors/cmcrameri/turku.txt +256 -0
  53. compas/colors/cmcrameri/turkuS.txt +100 -0
  54. compas/colors/cmcrameri/vanimo.txt +256 -0
  55. compas/colors/cmcrameri/vik.txt +256 -0
  56. compas/colors/cmcrameri/vikO.txt +256 -0
  57. compas/colors/color.py +1118 -0
  58. compas/colors/colordict.py +103 -0
  59. compas/colors/colormap.py +306 -0
  60. compas/colors/html_colors.py +149 -0
  61. compas/colors/mpl_colormap.py +1064 -0
  62. compas/data/__init__.py +31 -0
  63. compas/data/coercion.py +71 -0
  64. compas/data/conftest.py +10 -0
  65. compas/data/data.py +342 -0
  66. compas/data/encoders.py +240 -0
  67. compas/data/exceptions.py +2 -0
  68. compas/data/json.py +240 -0
  69. compas/data/samples/boxes.obj +250 -0
  70. compas/data/samples/butt_model.obj +2829 -0
  71. compas/data/samples/cone.stl +0 -0
  72. compas/data/samples/cube.off +16 -0
  73. compas/data/samples/cube_ascii.stl +56114 -0
  74. compas/data/samples/cube_binary.stl +0 -0
  75. compas/data/samples/cube_binary_2.stl +0 -0
  76. compas/data/samples/doosabin.json +1 -0
  77. compas/data/samples/faces.obj +63 -0
  78. compas/data/samples/faces_big.obj +9663 -0
  79. compas/data/samples/faces_reversed.obj +63 -0
  80. compas/data/samples/fink.obj +135 -0
  81. compas/data/samples/grid_irregular.obj +303 -0
  82. compas/data/samples/hypar.obj +148 -0
  83. compas/data/samples/lines.json +1 -0
  84. compas/data/samples/lines.obj +282 -0
  85. compas/data/samples/lines_big.obj +40322 -0
  86. compas/data/samples/lines_bigger.obj +161282 -0
  87. compas/data/samples/lines_noleaves.obj +422 -0
  88. compas/data/samples/mesh.obj +874 -0
  89. compas/data/samples/mesh_100_faces.json +1893 -0
  90. compas/data/samples/mesh_110_faces.json +2081 -0
  91. compas/data/samples/open_edges.obj +424 -0
  92. compas/data/samples/point.json +1 -0
  93. compas/data/samples/quadmesh.obj +183 -0
  94. compas/data/samples/quadmesh_planar.obj +181 -0
  95. compas/data/samples/saddle.obj +314 -0
  96. compas/data/samples/spline.obj +72 -0
  97. compas/data/samples/tubemesh.json +1 -0
  98. compas/data/samples/tubemesh.obj +378 -0
  99. compas/data/samples/tubemesh.off +374 -0
  100. compas/data/samples/tubemesh.ply +551 -0
  101. compas/data/schema.py +137 -0
  102. compas/data/validators.py +243 -0
  103. compas/datastructures/__init__.py +75 -0
  104. compas/datastructures/_mutablemapping.py +148 -0
  105. compas/datastructures/assembly/__init__.py +0 -0
  106. compas/datastructures/assembly/assembly.py +234 -0
  107. compas/datastructures/assembly/exceptions.py +6 -0
  108. compas/datastructures/assembly/part.py +228 -0
  109. compas/datastructures/attributes.py +85 -0
  110. compas/datastructures/cell_network/__init__.py +0 -0
  111. compas/datastructures/cell_network/cell_network.py +4190 -0
  112. compas/datastructures/datastructure.py +309 -0
  113. compas/datastructures/graph/__init__.py +0 -0
  114. compas/datastructures/graph/duality.py +197 -0
  115. compas/datastructures/graph/graph.py +2478 -0
  116. compas/datastructures/graph/operations/__init__.py +0 -0
  117. compas/datastructures/graph/operations/join.py +124 -0
  118. compas/datastructures/graph/operations/split.py +63 -0
  119. compas/datastructures/graph/planarity.py +292 -0
  120. compas/datastructures/graph/smoothing.py +59 -0
  121. compas/datastructures/mesh/__init__.py +0 -0
  122. compas/datastructures/mesh/conway.py +553 -0
  123. compas/datastructures/mesh/duality.py +104 -0
  124. compas/datastructures/mesh/mesh.py +5103 -0
  125. compas/datastructures/mesh/operations/__init__.py +0 -0
  126. compas/datastructures/mesh/operations/collapse.py +350 -0
  127. compas/datastructures/mesh/operations/extrude.py +0 -0
  128. compas/datastructures/mesh/operations/insert.py +120 -0
  129. compas/datastructures/mesh/operations/merge.py +83 -0
  130. compas/datastructures/mesh/operations/split.py +263 -0
  131. compas/datastructures/mesh/operations/substitute.py +37 -0
  132. compas/datastructures/mesh/operations/swap.py +62 -0
  133. compas/datastructures/mesh/operations/weld.py +107 -0
  134. compas/datastructures/mesh/remesh.py +234 -0
  135. compas/datastructures/mesh/slice.py +170 -0
  136. compas/datastructures/mesh/smoothing.py +187 -0
  137. compas/datastructures/mesh/subdivision.py +754 -0
  138. compas/datastructures/tree/__init__.py +0 -0
  139. compas/datastructures/tree/tree.py +504 -0
  140. compas/datastructures/volmesh/__init__.py +0 -0
  141. compas/datastructures/volmesh/volmesh.py +4203 -0
  142. compas/files/__init__.py +27 -0
  143. compas/files/_xml/__init__.py +0 -0
  144. compas/files/_xml/xml_cli.py +213 -0
  145. compas/files/_xml/xml_cpython.py +32 -0
  146. compas/files/_xml/xml_pre_38.py +58 -0
  147. compas/files/_xml/xml_shared.py +40 -0
  148. compas/files/gltf/__init__.py +0 -0
  149. compas/files/gltf/constants.py +59 -0
  150. compas/files/gltf/data_classes.py +657 -0
  151. compas/files/gltf/extensions.py +317 -0
  152. compas/files/gltf/gltf.py +92 -0
  153. compas/files/gltf/gltf_children.py +64 -0
  154. compas/files/gltf/gltf_content.py +615 -0
  155. compas/files/gltf/gltf_exporter.py +465 -0
  156. compas/files/gltf/gltf_mesh.py +273 -0
  157. compas/files/gltf/gltf_node.py +348 -0
  158. compas/files/gltf/gltf_parser.py +115 -0
  159. compas/files/gltf/gltf_reader.py +310 -0
  160. compas/files/gltf/gltf_scene.py +125 -0
  161. compas/files/gltf/helpers.py +59 -0
  162. compas/files/obj.py +680 -0
  163. compas/files/off.py +296 -0
  164. compas/files/ply.py +697 -0
  165. compas/files/stl.py +436 -0
  166. compas/files/xml.py +328 -0
  167. compas/geometry/__init__.py +772 -0
  168. compas/geometry/_core/__init__.py +0 -0
  169. compas/geometry/_core/_algebra.py +2826 -0
  170. compas/geometry/_core/angles.py +408 -0
  171. compas/geometry/_core/centroids.py +573 -0
  172. compas/geometry/_core/distance.py +895 -0
  173. compas/geometry/_core/normals.py +149 -0
  174. compas/geometry/_core/nurbs.py +367 -0
  175. compas/geometry/_core/predicates_2.py +582 -0
  176. compas/geometry/_core/predicates_3.py +1111 -0
  177. compas/geometry/_core/quaternions.py +196 -0
  178. compas/geometry/_core/size.py +204 -0
  179. compas/geometry/_core/tangent.py +56 -0
  180. compas/geometry/_core/transformations.py +1121 -0
  181. compas/geometry/_core/transformations_numpy.py +279 -0
  182. compas/geometry/bbox.py +145 -0
  183. compas/geometry/bbox_numpy.py +306 -0
  184. compas/geometry/bestfit.py +77 -0
  185. compas/geometry/bestfit_numpy.py +259 -0
  186. compas/geometry/booleans.py +297 -0
  187. compas/geometry/booleans_shapely.py +147 -0
  188. compas/geometry/brep/__init__.py +112 -0
  189. compas/geometry/brep/brep.py +1131 -0
  190. compas/geometry/brep/edge.py +302 -0
  191. compas/geometry/brep/errors.py +22 -0
  192. compas/geometry/brep/face.py +329 -0
  193. compas/geometry/brep/loop.py +87 -0
  194. compas/geometry/brep/trim.py +46 -0
  195. compas/geometry/brep/vertex.py +46 -0
  196. compas/geometry/contours.py +32 -0
  197. compas/geometry/curves/__init__.py +0 -0
  198. compas/geometry/curves/arc.py +429 -0
  199. compas/geometry/curves/bezier.py +345 -0
  200. compas/geometry/curves/circle.py +500 -0
  201. compas/geometry/curves/conic.py +16 -0
  202. compas/geometry/curves/curve.py +614 -0
  203. compas/geometry/curves/ellipse.py +408 -0
  204. compas/geometry/curves/hyperbola.py +336 -0
  205. compas/geometry/curves/line.py +431 -0
  206. compas/geometry/curves/nurbs.py +412 -0
  207. compas/geometry/curves/parabola.py +256 -0
  208. compas/geometry/curves/polyline.py +724 -0
  209. compas/geometry/frame.py +769 -0
  210. compas/geometry/geometry.py +296 -0
  211. compas/geometry/hull.py +146 -0
  212. compas/geometry/hull_numpy.py +82 -0
  213. compas/geometry/icp_numpy.py +104 -0
  214. compas/geometry/interpolation_barycentric.py +38 -0
  215. compas/geometry/interpolation_coons.py +102 -0
  216. compas/geometry/interpolation_tweening.py +87 -0
  217. compas/geometry/intersection.py +121 -0
  218. compas/geometry/intersections.py +1105 -0
  219. compas/geometry/kdtree.py +153 -0
  220. compas/geometry/offset.py +208 -0
  221. compas/geometry/pca_numpy.py +87 -0
  222. compas/geometry/plane.py +657 -0
  223. compas/geometry/point.py +664 -0
  224. compas/geometry/pointcloud.py +409 -0
  225. compas/geometry/polygon.py +473 -0
  226. compas/geometry/polyhedron.py +650 -0
  227. compas/geometry/projection.py +155 -0
  228. compas/geometry/quadmesh_planarize.py +30 -0
  229. compas/geometry/quadmesh_planarize_none.py +114 -0
  230. compas/geometry/quaternion.py +544 -0
  231. compas/geometry/reflection.py +102 -0
  232. compas/geometry/rotation.py +354 -0
  233. compas/geometry/scale.py +100 -0
  234. compas/geometry/shapes/__init__.py +0 -0
  235. compas/geometry/shapes/box.py +747 -0
  236. compas/geometry/shapes/capsule.py +472 -0
  237. compas/geometry/shapes/cone.py +309 -0
  238. compas/geometry/shapes/cylinder.py +355 -0
  239. compas/geometry/shapes/shape.py +300 -0
  240. compas/geometry/shapes/sphere.py +362 -0
  241. compas/geometry/shapes/torus.py +294 -0
  242. compas/geometry/shear.py +115 -0
  243. compas/geometry/surfaces/__init__.py +0 -0
  244. compas/geometry/surfaces/conical.py +166 -0
  245. compas/geometry/surfaces/cylindrical.py +251 -0
  246. compas/geometry/surfaces/extrusion.py +0 -0
  247. compas/geometry/surfaces/nurbs.py +380 -0
  248. compas/geometry/surfaces/planar.py +223 -0
  249. compas/geometry/surfaces/revolution.py +0 -0
  250. compas/geometry/surfaces/spherical.py +259 -0
  251. compas/geometry/surfaces/surface.py +689 -0
  252. compas/geometry/surfaces/toroidal.py +198 -0
  253. compas/geometry/transformation.py +554 -0
  254. compas/geometry/translation.py +104 -0
  255. compas/geometry/triangulation_delaunay.py +102 -0
  256. compas/geometry/triangulation_earclip.py +300 -0
  257. compas/geometry/trimesh_curvature.py +113 -0
  258. compas/geometry/trimesh_descent_numpy.py +26 -0
  259. compas/geometry/trimesh_geodistance.py +35 -0
  260. compas/geometry/trimesh_gradient_numpy.py +74 -0
  261. compas/geometry/trimesh_isolines.py +41 -0
  262. compas/geometry/trimesh_matrices.py +31 -0
  263. compas/geometry/trimesh_matrices_numpy.py +191 -0
  264. compas/geometry/trimesh_parametrisation.py +55 -0
  265. compas/geometry/trimesh_pull_points_numpy.py +216 -0
  266. compas/geometry/trimesh_remeshing.py +97 -0
  267. compas/geometry/trimesh_samplepoints_numpy.py +108 -0
  268. compas/geometry/trimesh_slicing.py +28 -0
  269. compas/geometry/trimesh_smoothing_numpy.py +34 -0
  270. compas/geometry/vector.py +889 -0
  271. compas/itertools.py +441 -0
  272. compas/linalg.py +634 -0
  273. compas/matrices.py +314 -0
  274. compas/plugins.py +488 -0
  275. compas/rpc/__init__.py +20 -0
  276. compas/rpc/__main__.py +77 -0
  277. compas/rpc/dispatcher.py +181 -0
  278. compas/rpc/errors.py +11 -0
  279. compas/rpc/proxy.py +437 -0
  280. compas/rpc/server.py +79 -0
  281. compas/rpc/services/__init__.py +0 -0
  282. compas/rpc/services/default.py +87 -0
  283. compas/rpc/services/watcher.py +43 -0
  284. compas/scene/__init__.py +56 -0
  285. compas/scene/assemblyobject.py +3 -0
  286. compas/scene/context.py +154 -0
  287. compas/scene/descriptors/__init__.py +0 -0
  288. compas/scene/descriptors/attribute.py +30 -0
  289. compas/scene/descriptors/color.py +91 -0
  290. compas/scene/descriptors/colordict.py +101 -0
  291. compas/scene/descriptors/protocol.py +12 -0
  292. compas/scene/exceptions.py +7 -0
  293. compas/scene/geometryobject.py +58 -0
  294. compas/scene/graphobject.py +173 -0
  295. compas/scene/meshobject.py +238 -0
  296. compas/scene/scene.py +144 -0
  297. compas/scene/sceneobject.py +253 -0
  298. compas/scene/volmeshobject.py +252 -0
  299. compas/tolerance.py +879 -0
  300. compas/topology/__init__.py +45 -0
  301. compas/topology/combinatorics.py +108 -0
  302. compas/topology/connectivity.py +129 -0
  303. compas/topology/orientation.py +204 -0
  304. compas/topology/traversal.py +567 -0
  305. compas/utilities/__init__.py +25 -0
  306. compas/utilities/azync.py +155 -0
  307. compas/utilities/datetime.py +40 -0
  308. compas/utilities/decorators.py +136 -0
  309. compas/utilities/remote.py +54 -0
  310. compas/utilities/ssh.py +169 -0
  311. compas-2.1.1.dist-info/AUTHORS.md +42 -0
  312. compas-2.1.1.dist-info/LICENSE +21 -0
  313. compas-2.1.1.dist-info/METADATA +132 -0
  314. compas-2.1.1.dist-info/RECORD +468 -0
  315. compas-2.1.1.dist-info/WHEEL +5 -0
  316. compas-2.1.1.dist-info/entry_points.txt +2 -0
  317. compas-2.1.1.dist-info/top_level.txt +4 -0
  318. compas_blender/__init__.py +250 -0
  319. compas_blender/collections.py +130 -0
  320. compas_blender/conversions/__init__.py +48 -0
  321. compas_blender/conversions/breps.py +0 -0
  322. compas_blender/conversions/colors.py +23 -0
  323. compas_blender/conversions/curves.py +125 -0
  324. compas_blender/conversions/geometry.py +161 -0
  325. compas_blender/conversions/meshes.py +148 -0
  326. compas_blender/conversions/surfaces.py +48 -0
  327. compas_blender/conversions/transformations.py +46 -0
  328. compas_blender/data.py +30 -0
  329. compas_blender/geometry/__init__.py +14 -0
  330. compas_blender/geometry/booleans.py +100 -0
  331. compas_blender/install.py +338 -0
  332. compas_blender/objects.py +326 -0
  333. compas_blender/print_python_path.py +18 -0
  334. compas_blender/scene/__init__.py +116 -0
  335. compas_blender/scene/boxobject.py +64 -0
  336. compas_blender/scene/capsuleobject.py +73 -0
  337. compas_blender/scene/circleobject.py +53 -0
  338. compas_blender/scene/coneobject.py +70 -0
  339. compas_blender/scene/curveobject.py +58 -0
  340. compas_blender/scene/cylinderobject.py +70 -0
  341. compas_blender/scene/frameobject.py +105 -0
  342. compas_blender/scene/graphobject.py +257 -0
  343. compas_blender/scene/lineobject.py +60 -0
  344. compas_blender/scene/meshobject.py +508 -0
  345. compas_blender/scene/planeobject.py +81 -0
  346. compas_blender/scene/pointcloudobject.py +67 -0
  347. compas_blender/scene/pointobject.py +71 -0
  348. compas_blender/scene/polygonobject.py +57 -0
  349. compas_blender/scene/polyhedronobject.py +57 -0
  350. compas_blender/scene/polylineobject.py +54 -0
  351. compas_blender/scene/sceneobject.py +249 -0
  352. compas_blender/scene/sphereobject.py +72 -0
  353. compas_blender/scene/surfaceobject.py +54 -0
  354. compas_blender/scene/torusobject.py +73 -0
  355. compas_blender/scene/vectorobject.py +69 -0
  356. compas_blender/scene/volmeshobject.py +475 -0
  357. compas_blender/utilities/__init__.py +38 -0
  358. compas_blender/utilities/drawing.py +768 -0
  359. compas_ghpython/__init__.py +124 -0
  360. compas_ghpython/components/Compas_FromJson/code.py +18 -0
  361. compas_ghpython/components/Compas_Info/code.py +15 -0
  362. compas_ghpython/components/Compas_RpcCall/code.py +31 -0
  363. compas_ghpython/components/Compas_ToJson/code.py +19 -0
  364. compas_ghpython/components/Compas_ToRhinoGeometry/code.py +15 -0
  365. compas_ghpython/components/__init__.py +99 -0
  366. compas_ghpython/install.py +29 -0
  367. compas_ghpython/scene/__init__.py +115 -0
  368. compas_ghpython/scene/boxobject.py +40 -0
  369. compas_ghpython/scene/brepobject.py +40 -0
  370. compas_ghpython/scene/capsuleobject.py +41 -0
  371. compas_ghpython/scene/circleobject.py +40 -0
  372. compas_ghpython/scene/coneobject.py +40 -0
  373. compas_ghpython/scene/curveobject.py +42 -0
  374. compas_ghpython/scene/cylinderobject.py +38 -0
  375. compas_ghpython/scene/ellipseobject.py +40 -0
  376. compas_ghpython/scene/frameobject.py +67 -0
  377. compas_ghpython/scene/graphobject.py +77 -0
  378. compas_ghpython/scene/lineobject.py +39 -0
  379. compas_ghpython/scene/meshobject.py +137 -0
  380. compas_ghpython/scene/planeobject.py +61 -0
  381. compas_ghpython/scene/pointobject.py +38 -0
  382. compas_ghpython/scene/polygonobject.py +48 -0
  383. compas_ghpython/scene/polyhedronobject.py +48 -0
  384. compas_ghpython/scene/polylineobject.py +39 -0
  385. compas_ghpython/scene/sceneobject.py +12 -0
  386. compas_ghpython/scene/sphereobject.py +39 -0
  387. compas_ghpython/scene/surfaceobject.py +42 -0
  388. compas_ghpython/scene/torusobject.py +39 -0
  389. compas_ghpython/scene/vectorobject.py +51 -0
  390. compas_ghpython/scene/volmeshobject.py +154 -0
  391. compas_ghpython/sets.py +83 -0
  392. compas_ghpython/timer.py +36 -0
  393. compas_ghpython/uninstall.py +31 -0
  394. compas_ghpython/utilities/__init__.py +33 -0
  395. compas_ghpython/utilities/drawing.py +457 -0
  396. compas_rhino/__init__.py +607 -0
  397. compas_rhino/conduits/__init__.py +16 -0
  398. compas_rhino/conduits/base.py +121 -0
  399. compas_rhino/conduits/faces.py +91 -0
  400. compas_rhino/conduits/labels.py +102 -0
  401. compas_rhino/conduits/lines.py +109 -0
  402. compas_rhino/conduits/points.py +111 -0
  403. compas_rhino/conversions/__init__.py +168 -0
  404. compas_rhino/conversions/breps.py +122 -0
  405. compas_rhino/conversions/curves.py +453 -0
  406. compas_rhino/conversions/docobjects.py +0 -0
  407. compas_rhino/conversions/exceptions.py +7 -0
  408. compas_rhino/conversions/extrusions.py +80 -0
  409. compas_rhino/conversions/geometry.py +187 -0
  410. compas_rhino/conversions/meshes.py +281 -0
  411. compas_rhino/conversions/shapes.py +291 -0
  412. compas_rhino/conversions/surfaces.py +355 -0
  413. compas_rhino/conversions/transformations.py +45 -0
  414. compas_rhino/geometry/__init__.py +44 -0
  415. compas_rhino/geometry/booleans.py +118 -0
  416. compas_rhino/geometry/brep/__init__.py +40 -0
  417. compas_rhino/geometry/brep/brep.py +554 -0
  418. compas_rhino/geometry/brep/builder.py +184 -0
  419. compas_rhino/geometry/brep/edge.py +202 -0
  420. compas_rhino/geometry/brep/face.py +285 -0
  421. compas_rhino/geometry/brep/loop.py +129 -0
  422. compas_rhino/geometry/brep/trim.py +99 -0
  423. compas_rhino/geometry/brep/vertex.py +76 -0
  424. compas_rhino/geometry/curves/__init__.py +43 -0
  425. compas_rhino/geometry/curves/curve.py +382 -0
  426. compas_rhino/geometry/curves/nurbs.py +298 -0
  427. compas_rhino/geometry/surfaces/__init__.py +50 -0
  428. compas_rhino/geometry/surfaces/nurbs.py +370 -0
  429. compas_rhino/geometry/surfaces/surface.py +407 -0
  430. compas_rhino/geometry/trimesh_curvature.py +344 -0
  431. compas_rhino/geometry/trimesh_slicing.py +65 -0
  432. compas_rhino/install.py +382 -0
  433. compas_rhino/install_plugin.py +169 -0
  434. compas_rhino/install_with_pip.py +20 -0
  435. compas_rhino/layers.py +347 -0
  436. compas_rhino/objects.py +1141 -0
  437. compas_rhino/print_python_path.py +18 -0
  438. compas_rhino/scene/__init__.py +123 -0
  439. compas_rhino/scene/boxobject.py +44 -0
  440. compas_rhino/scene/brepobject.py +41 -0
  441. compas_rhino/scene/capsuleobject.py +45 -0
  442. compas_rhino/scene/circleobject.py +43 -0
  443. compas_rhino/scene/coneobject.py +43 -0
  444. compas_rhino/scene/curveobject.py +43 -0
  445. compas_rhino/scene/cylinderobject.py +43 -0
  446. compas_rhino/scene/ellipseobject.py +44 -0
  447. compas_rhino/scene/frameobject.py +99 -0
  448. compas_rhino/scene/graphobject.py +364 -0
  449. compas_rhino/scene/helpers.py +33 -0
  450. compas_rhino/scene/lineobject.py +43 -0
  451. compas_rhino/scene/meshobject.py +673 -0
  452. compas_rhino/scene/planeobject.py +71 -0
  453. compas_rhino/scene/pointobject.py +43 -0
  454. compas_rhino/scene/polygonobject.py +45 -0
  455. compas_rhino/scene/polyhedronobject.py +45 -0
  456. compas_rhino/scene/polylineobject.py +43 -0
  457. compas_rhino/scene/sceneobject.py +123 -0
  458. compas_rhino/scene/sphereobject.py +43 -0
  459. compas_rhino/scene/surfaceobject.py +42 -0
  460. compas_rhino/scene/torusobject.py +43 -0
  461. compas_rhino/scene/vectorobject.py +49 -0
  462. compas_rhino/scene/volmeshobject.py +518 -0
  463. compas_rhino/ui.py +114 -0
  464. compas_rhino/uninstall.py +243 -0
  465. compas_rhino/uninstall_plugin.py +91 -0
  466. compas_rhino/utilities/__init__.py +37 -0
  467. compas_rhino/utilities/constructors.py +71 -0
  468. compas_rhino/utilities/drawing.py +1081 -0
compas/plugins.py ADDED
@@ -0,0 +1,488 @@
1
+ """
2
+ COMPAS has an extensible architecture based on plugins that allows to
3
+ customize and extend the functionality of the core framework.
4
+ """
5
+
6
+ # The COMPAS plugin system owes a lot to pluggy, the pytest plugin framework
7
+ # There are portions of code loosely based on pluggy's
8
+ # and while it is not strictly derivative work, we include
9
+ # their license and copyright notice to give credit where credit is due.
10
+ #
11
+ # MIT license
12
+ # Copyright (c) 2015 holger krekel (rather uses bitbucket/hpk42)
13
+ #
14
+ # https://github.com/pytest-dev/pluggy
15
+
16
+ from __future__ import absolute_import
17
+ from __future__ import division
18
+ from __future__ import print_function
19
+
20
+ import functools
21
+ import inspect
22
+ import pkgutil
23
+ import threading
24
+
25
+ __all__ = [
26
+ "pluggable",
27
+ "plugin",
28
+ "plugin_manager",
29
+ "IncompletePluginImplError",
30
+ "PluginManager",
31
+ "PluginNotInstalledError",
32
+ "PluginValidator",
33
+ "PluginDefaultNotAvailableError",
34
+ ]
35
+
36
+
37
+ class PluginNotInstalledError(Exception):
38
+ """Exception raised when an extension point is invoked but no plugin is available."""
39
+
40
+ pass
41
+
42
+
43
+ class PluginDefaultNotAvailableError(Exception):
44
+ """Exception raised when an extension point is invoked but no plugin is available, and the default implementation is also not available.
45
+
46
+ The most likely circumstance for this error is when the default implementation is based on Numpy, Scipy, or similar,
47
+ and the pluggable is invoked in a context where these packages are not available.
48
+
49
+ """
50
+
51
+ pass
52
+
53
+
54
+ def _get_extension_point_url_from_name(domain, category, pluggable_name):
55
+ """Get the extension point URL based on a pluggable method name"""
56
+ return "{}/{}/{}".format(domain, category, pluggable_name).replace("//", "/")
57
+
58
+
59
+ def _get_extension_point_url_from_method(domain, category, plugin_method):
60
+ """Get the extension point URL based on a method instance"""
61
+ name = getattr(plugin_method, "__name__", None) or str(id(plugin_method))
62
+ return "{}/{}/{}".format(domain, category, name).replace("//", "/")
63
+
64
+
65
+ class IncompletePluginImplError(Exception):
66
+ """Exception raised when a plugin does not have implementations for all abstract methods of its base class."""
67
+
68
+ pass
69
+
70
+
71
+ class PluginImpl(object):
72
+ """Internal data class to keep track of a loaded plugin implementation.
73
+
74
+ Parameters
75
+ ----------
76
+ plugin : module
77
+ Instance of the module containing one or more plugin implementations.
78
+ method : method
79
+ Method implementing the a plugin's behavior.
80
+ plugin_opts : dict
81
+ Dictionary containing plugin options.
82
+
83
+ """
84
+
85
+ def __init__(self, plugin, method, plugin_opts):
86
+ self.plugin = plugin
87
+ self.method = method
88
+ self.opts = plugin_opts
89
+
90
+ if plugin_opts["tryfirst"]:
91
+ self.key = 1
92
+ elif plugin_opts["trylast"]:
93
+ self.key = 3
94
+ else:
95
+ self.key = 2
96
+
97
+ @property
98
+ def id(self):
99
+ """Identifier of the plugin implementation."""
100
+ return "{}.{}".format(self.plugin.__name__, self.method.__name__)
101
+
102
+ def __repr__(self):
103
+ return "<PluginImpl id={}, plugin_module={}>".format(self.id, self.plugin)
104
+
105
+
106
+ class PluginManager(object):
107
+ """Plugin Manager handles discovery and registry of plugins.
108
+
109
+ Usually there is only one instance of a plugin manager per host.
110
+
111
+ """
112
+
113
+ DEBUG = False
114
+
115
+ def __init__(self):
116
+ self.importer = Importer()
117
+ self._registry = {}
118
+ self._discovery_done = False
119
+ self._discovery_lock = threading.Lock()
120
+
121
+ @property
122
+ def registry(self):
123
+ """Plugin registry.
124
+
125
+ Lazy-loaded dictionary of all plugins available in the system.
126
+
127
+ Returns
128
+ -------
129
+ dict
130
+ Dictionary of available plugins. The keys are extension point URLs
131
+ and the values are instances of :class:`PluginImpl`.
132
+
133
+ """
134
+ if not self._discovery_done:
135
+ self.load_plugins()
136
+
137
+ return self._registry
138
+
139
+ def load_plugins(self):
140
+ """Load available plugin modules.
141
+
142
+ Returns
143
+ -------
144
+ int
145
+ Number of loaded plugins.
146
+
147
+ """
148
+ # Since we modify global state,
149
+ # let's lock around this.
150
+ with self._discovery_lock:
151
+ count = 0
152
+
153
+ modules = [module_name for _importer, module_name, is_pkg in pkgutil.iter_modules() if is_pkg and module_name.startswith("compas")]
154
+
155
+ modules_to_inspect = dict()
156
+
157
+ for module_name in modules:
158
+ module = self.importer.try_import(module_name)
159
+ if module:
160
+ modules_to_inspect[module_name] = module
161
+ else:
162
+ if self.DEBUG:
163
+ print("Error importing module {}, skipping entire package.".format(module_name))
164
+ continue
165
+
166
+ if "__all_plugins__" in dir(module):
167
+ for plugin_module_name in module.__all_plugins__:
168
+ plugin_module = self.importer.try_import(plugin_module_name)
169
+ if plugin_module:
170
+ modules_to_inspect[plugin_module_name] = plugin_module
171
+ else:
172
+ if self.DEBUG:
173
+ print("Error importing plugin {}, skipping.".format(plugin_module_name))
174
+
175
+ if self.DEBUG:
176
+ print("Will inspect modules: {}".format(list(modules_to_inspect.keys())))
177
+
178
+ for plugin_module in modules_to_inspect.values():
179
+ count += self.register_module(plugin_module)
180
+
181
+ self._discovery_done = True
182
+
183
+ return count
184
+
185
+ def register_module(self, plugin_module):
186
+ """Register a module that potentially contains plugin implementations.
187
+
188
+ Parameters
189
+ ----------
190
+ plugin_module : module
191
+ Module instance to inspect for plugins.
192
+
193
+ Returns
194
+ -------
195
+ int
196
+ Count of successfully registered plugins in the module.
197
+ """
198
+ count = 0
199
+
200
+ # Iterate over the plugin to locate specific @plugin decorated methods
201
+ for name in dir(plugin_module):
202
+ plugin_method = getattr(plugin_module, name)
203
+ plugin_opts = self._parse_plugin_opts(plugin_method)
204
+
205
+ if plugin_opts is not None:
206
+ plugin_impl = PluginImpl(plugin_module, plugin_method, plugin_opts)
207
+ plugins_list = self._registry.setdefault(plugin_opts["extension_point_url"], [])
208
+ plugins_list.append(plugin_impl)
209
+ plugins_list.sort(key=lambda p: p.key)
210
+
211
+ if self.DEBUG:
212
+ print('Registered plugin with ID "{}" for extension point: {}'.format(plugin_impl.id, plugin_opts["extension_point_url"]))
213
+ count += 1
214
+
215
+ return count
216
+
217
+ def _parse_plugin_opts(self, plugin_method):
218
+ if not inspect.isroutine(plugin_method):
219
+ return
220
+ try:
221
+ res = getattr(plugin_method, "__plugin_spec__", None)
222
+ except Exception:
223
+ res = {}
224
+ if res is not None and not isinstance(res, dict):
225
+ # false positive
226
+ res = None
227
+ return res
228
+
229
+
230
+ def pluggable(
231
+ pluggable_method=None,
232
+ category=None,
233
+ selector="first_match",
234
+ domain="https://plugins.compas.dev/",
235
+ ):
236
+ """Decorator to mark a method as a pluggable extension point.
237
+
238
+ A pluggable interface is uniquely identifiable/locatable via a URL
239
+ derived from the parameters ``domain``, ``category`` and name ``pluggable_method``.
240
+ In the example below, the URL of the pluggable definition is::
241
+
242
+ https://plugins.compas.dev/triangulation/triangulate_mesh
243
+
244
+ Parameters
245
+ ----------
246
+ pluggable_method : callable
247
+ The method to decorate as ``pluggable``.
248
+ category : str, optional
249
+ An optional string to group or categorize extension points.
250
+ selector : str, optional
251
+ String that determines the selection mode of extension points.
252
+
253
+ - ``"first_match"``: (str) Execute the first matching implementation.
254
+ - ``"collect_all"``: (str) Executes all matching implementations and return list of its return values.
255
+
256
+ domain : str, optional
257
+ Domain name that "owns" the pluggable extension point.
258
+ This is useful to avoid name collisions between extension points
259
+ of different packages.
260
+
261
+ Examples
262
+ --------
263
+ >>> @pluggable(category="triangulation")
264
+ ... def triangulate_mesh(mesh):
265
+ ... pass
266
+
267
+ """
268
+
269
+ def pluggable_decorator(func):
270
+ @functools.wraps(func)
271
+ def wrapper(*args, **kwargs):
272
+ extension_point_url = _get_extension_point_url_from_method(domain, category, func)
273
+
274
+ # Select first matching plugin
275
+ if selector == "first_match":
276
+ plugin_impl = _select_plugin(extension_point_url)
277
+ if plugin_impl is None:
278
+ try:
279
+ return func(*args, **kwargs)
280
+ except NotImplementedError:
281
+ raise PluginNotInstalledError("Plugin not found and no default implementation for extension point URL: {}".format(extension_point_url))
282
+ except ImportError:
283
+ raise PluginDefaultNotAvailableError(
284
+ "Plugin not found and the default implementation is not available in your environment for extension point URL: {}".format(extension_point_url)
285
+ )
286
+
287
+ # Invoke plugin
288
+ return plugin_impl.method(*args, **kwargs)
289
+
290
+ # Collect all matching plugins
291
+ elif selector == "collect_all":
292
+ results = []
293
+
294
+ for plugin_impl in _collect_plugins(extension_point_url):
295
+ try:
296
+ result = plugin_impl.method(*args, **kwargs)
297
+ results.append(result)
298
+ except Exception as e:
299
+ results.append(e)
300
+
301
+ return results
302
+ else:
303
+ raise ValueError("Unexpected selector type. Must be either: first_match or collect_all")
304
+
305
+ return wrapper
306
+
307
+ if pluggable_method is None:
308
+ return pluggable_decorator
309
+ else:
310
+ return pluggable_decorator(pluggable_method)
311
+
312
+
313
+ def plugin(
314
+ method=None,
315
+ category=None,
316
+ requires=None,
317
+ tryfirst=False,
318
+ trylast=False,
319
+ pluggable_name=None,
320
+ domain="https://plugins.compas.dev/",
321
+ ):
322
+ """Decorator to declare a plugin.
323
+
324
+ A plugin decorator marks a method as a plugin for a specified
325
+ :meth:`pluggable` extension point. Plugins are matched to their pluggable
326
+ counterparts by a combination of the name of the plugin method, the category
327
+ and the domain specified. These 3 parts form the **extension point URL** used
328
+ for matching.
329
+
330
+ Parameters
331
+ ----------
332
+ method : callable
333
+ The method to decorate as ``plugin``.
334
+ category : str, optional
335
+ An optional string to group or categorize plugins.
336
+ requires : list, optional
337
+ Optionally defines a list of requirements that should be fulfilled
338
+ for this plugin to be used. The requirement can either be a package
339
+ name (``str``) or a ``callable`` with a boolean return value,
340
+ in which any arbitrary check can be implemented.
341
+ tryfirst : bool, optional
342
+ Plugins can declare a preferred priority by setting this to ``True``.
343
+ By default ``False``.
344
+ trylast : bool, optional
345
+ Alternatively, a plugin can demote itself to be least preferable
346
+ setting ``trylast`` to ``True``. By default ``False``.
347
+ pluggable_name : str, optional
348
+ Usually, the name of the decorated plugin method matches that of the
349
+ pluggable interface. When that is not the case, the pluggable name can be
350
+ specified via this parameter.
351
+ domain : str, optional
352
+ Domain name that "owns" the pluggable extension point.
353
+ This is useful to disambiguate name collisions between extension points
354
+ of different packages.
355
+ """
356
+
357
+ def setattr_hookspec_opts(func):
358
+ if tryfirst and trylast:
359
+ raise ValueError("You cannot set a plugin to try first and last at the same time.")
360
+
361
+ name = pluggable_name or getattr(func, "__name__", None)
362
+ extension_point_url = _get_extension_point_url_from_name(domain, category, name)
363
+
364
+ setattr(
365
+ func,
366
+ "__plugin_spec__",
367
+ dict(
368
+ extension_point_url=extension_point_url,
369
+ pluggable_name=name,
370
+ requires=requires,
371
+ tryfirst=tryfirst,
372
+ trylast=trylast,
373
+ ),
374
+ )
375
+ return func
376
+
377
+ if method is not None:
378
+ return setattr_hookspec_opts(method)
379
+ else:
380
+ return setattr_hookspec_opts
381
+
382
+
383
+ class Importer(object):
384
+ """Internal class to help importing modules."""
385
+
386
+ def __init__(self):
387
+ # dictionary of module_name => bool (importable yes/no)
388
+ self._cache = {}
389
+
390
+ def try_import(self, module_name):
391
+ """Attempt to import a module, but do not raise in case of error.
392
+
393
+ Parameters
394
+ ----------
395
+ module_name : str
396
+ Module to try to import.
397
+
398
+ Returns
399
+ -------
400
+ module
401
+ If importable, it returns the imported module, otherwise ``None``.
402
+ """
403
+ module = None
404
+
405
+ try:
406
+ module = __import__(module_name, fromlist=["__name__"], level=0)
407
+ self._cache[module_name] = True
408
+
409
+ # There are two types of possible failure modes:
410
+ # 1) cannot be imported, or
411
+ # 2) is a python 3 module and we're in IPY, which causes a SyntaxError
412
+ except (ImportError, SyntaxError):
413
+ self._cache[module_name] = False
414
+
415
+ return module
416
+
417
+ def check_importable(self, module_name):
418
+ """Check if a module is importable.
419
+
420
+ Parameters
421
+ ----------
422
+ module_name : str
423
+ Name of the module to check for importability.
424
+
425
+ Returns
426
+ -------
427
+ bool
428
+ ``True`` if the module can be imported correctly, otherwise ``False``.
429
+ """
430
+ if module_name not in self._cache:
431
+ self.try_import(module_name)
432
+
433
+ return self._cache[module_name]
434
+
435
+
436
+ class PluginValidator(object):
437
+ """Plugin Validator handles validation of plugins."""
438
+
439
+ def __init__(self, manager):
440
+ self.manager = manager
441
+
442
+ def verify_requirement(self, requirement):
443
+ if callable(requirement):
444
+ return requirement()
445
+
446
+ return self.manager.importer.check_importable(requirement)
447
+
448
+ def is_plugin_selectable(self, plugin):
449
+ if plugin.opts["requires"]:
450
+ importable_requirements = (self.verify_requirement(requirement) for requirement in plugin.opts["requires"])
451
+
452
+ if not all(importable_requirements):
453
+ if self.manager.DEBUG:
454
+ print("Requirements not satisfied. Plugin will not be used: {}".format(plugin.id))
455
+ return False
456
+
457
+ return True
458
+
459
+ def select_plugin(self, extension_point_url):
460
+ if self.manager.DEBUG:
461
+ print("Extension Point URL {} invoked. Will select a matching plugin".format(extension_point_url))
462
+
463
+ plugins = self.manager.registry.get(extension_point_url) or []
464
+ for plugin in plugins:
465
+ if self.is_plugin_selectable(plugin):
466
+ return plugin
467
+
468
+ # Nothing found, raise
469
+ # raise PluginNotInstalledError("Plugin not found for extension point URL: {}".format(extension_point_url))
470
+
471
+ def collect_plugins(self, extension_point_url):
472
+ if self.manager.DEBUG:
473
+ print("Extension Point URL {} invoked. Will select a matching plugin".format(extension_point_url))
474
+
475
+ plugins = self.manager.registry.get(extension_point_url) or []
476
+ return [plugin for plugin in plugins if self.is_plugin_selectable(plugin)]
477
+
478
+ @staticmethod
479
+ def ensure_implementations(cls):
480
+ for name, value in inspect.getmembers(cls):
481
+ if inspect.isfunction(value) or inspect.ismethod(value):
482
+ if hasattr(value, "__isabstractmethod__"):
483
+ raise IncompletePluginImplError("Abstract method not implemented: {}".format(value))
484
+
485
+
486
+ plugin_manager = PluginManager()
487
+ _select_plugin = PluginValidator(plugin_manager).select_plugin
488
+ _collect_plugins = PluginValidator(plugin_manager).collect_plugins
compas/rpc/__init__.py ADDED
@@ -0,0 +1,20 @@
1
+ """
2
+ COMPAS runs in many different environments, but in some environments the availablity of libraries is limited.
3
+ For example, when running COMPAS in an IronPython-based environment like Rhino/Grasshopper,
4
+ plenty of CPython libraries such as `numpy` and `scipy` are not available.
5
+ To workaround this limitation, COMPAS provides a mechanisms to access the functionality of a CPython environment
6
+ seemlessly from any other Python environment through a "Remote Procedure Call" or RPC.
7
+ Through RPC, COMPAS can be used as a server for remote clients, and as a client for remote servers.
8
+ A typical use case is to run algorithms that require packages like ``numpy`` or ``scipy`` on a remote server,
9
+ when working in Rhino. Or to use COMPAS in a browser application.
10
+ """
11
+
12
+ from __future__ import absolute_import
13
+
14
+ from .errors import RPCClientError, RPCServerError
15
+ from .proxy import Proxy
16
+ from .server import Server
17
+ from .dispatcher import Dispatcher
18
+
19
+
20
+ __all__ = ["RPCClientError", "RPCServerError", "Proxy", "Server", "Dispatcher"]
compas/rpc/__main__.py ADDED
@@ -0,0 +1,77 @@
1
+ import time
2
+
3
+ from compas.rpc.services.default import start_service
4
+
5
+ try:
6
+ from xmlrpclib import ServerProxy # type: ignore
7
+ except ImportError:
8
+ from xmlrpc.client import ServerProxy
9
+
10
+
11
+ def start(port, autoreload, **kwargs):
12
+ start_service(port, autoreload)
13
+
14
+
15
+ def stop(port, **kwargs):
16
+ print("Trying to stop remote RPC proxy...")
17
+ server = ServerProxy("http://127.0.0.1:{}".format(port))
18
+
19
+ success = False
20
+ count = 5
21
+ while count:
22
+ try:
23
+ server.ping()
24
+ except Exception:
25
+ time.sleep(0.1)
26
+ count -= 1
27
+ print(" {} attempts left.".format(count))
28
+ else:
29
+ success = True
30
+ break
31
+
32
+ if not success:
33
+ print("RPC server did not respond. Maybe already stopped.")
34
+ else:
35
+ server.remote_shutdown()
36
+ print("RPC server stopped")
37
+
38
+
39
+ def main():
40
+ import argparse
41
+
42
+ parser = argparse.ArgumentParser(description="COMPAS RPC command-line utility")
43
+
44
+ commands = parser.add_subparsers(help="Valid RPC commands")
45
+
46
+ # Command: start
47
+ start_command = commands.add_parser("start", help="Start RPC server")
48
+ start_command.add_argument("--port", "-p", action="store", default=1753, type=int, help="RPC port number")
49
+ start_command.add_argument(
50
+ "--autoreload",
51
+ dest="autoreload",
52
+ action="store_true",
53
+ help="Autoreload modules",
54
+ )
55
+ start_command.add_argument(
56
+ "--no-autoreload",
57
+ dest="autoreload",
58
+ action="store_false",
59
+ help="Do not autoreload modules",
60
+ )
61
+ start_command.set_defaults(autoreload=True, func=start)
62
+
63
+ # Command: stop
64
+ stop_command = commands.add_parser("stop", help="Try to stop a remote RPC server")
65
+ stop_command.add_argument("--port", "-p", action="store", default=1753, type=int, help="RPC port number")
66
+ stop_command.set_defaults(func=stop)
67
+
68
+ # Invoke
69
+ args = parser.parse_args()
70
+ if hasattr(args, "func"):
71
+ args.func(**vars(args))
72
+ else:
73
+ parser.print_help()
74
+
75
+
76
+ if __name__ == "__main__":
77
+ main()