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,614 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ from compas.geometry import Frame
6
+ from compas.geometry import Geometry
7
+ from compas.geometry import Plane
8
+ from compas.geometry import Transformation
9
+ from compas.itertools import linspace
10
+ from compas.plugins import pluggable
11
+
12
+
13
+ @pluggable(category="factories")
14
+ def new_curve(cls, *args, **kwargs):
15
+ curve = object.__new__(cls)
16
+ curve.__init__(*args, **kwargs)
17
+ return curve
18
+
19
+
20
+ class Curve(Geometry):
21
+ """Class representing a general parametric curve.
22
+
23
+ Parameters
24
+ ----------
25
+ frame : :class:`compas.geometry.Frame`, optional
26
+ The local coordinate system of the curve.
27
+ Default is the world coordinate system.
28
+ name : str, optional
29
+ The name of the curve.
30
+
31
+ Attributes
32
+ ----------
33
+ frame : :class:`compas.geometry.Frame`
34
+ The frame of the curve.
35
+ transformation : :class:`compas.geometry.Transformation`, read-only
36
+ The transformation from the local coordinate system of the curve (:attr:`frame`) to the world coordinate system.
37
+ plane : :class:`compas.geometry.Plane`, read-only
38
+ The plane of the curve.
39
+ dimension : int, read-only
40
+ The spatial dimension of the curve.
41
+ In most cases this will be 3.
42
+ For curves embedded on a surface, this is 2.
43
+ domain : tuple[float, float], read-only
44
+ The domain of the parameter space of the curve is the interval ``[0.0, 1.0]``.
45
+ is_closed : bool, read-only
46
+ True if the curve is closed.
47
+ is_periodic : bool, read-only
48
+ True if the curve is periodic.
49
+
50
+ See Also
51
+ --------
52
+ :class:`compas.geometry.Arc`, :class:`compas.geometry.Circle`,
53
+ :class:`compas.geometry.Ellipse`, :class:`compas.geometry.Line`,
54
+ :class:`compas.geometry.NurbsCurve`, :class:`compas.geometry.Polyline`
55
+
56
+ Notes
57
+ -----
58
+ The curve is a "pluggable". This means that it does not provide an actual implementation
59
+ of a parametric curve, but rather serves as an interface for different backends.
60
+ If a backend is available, it will be used to construct the curve and provide its functionality.
61
+ This backend is referred to as the "plugin" implementation of the curve.
62
+
63
+ To activate the plugin mechanism, the backend should provide an implementation of the :func:`new_curve` function,
64
+ and of any other function that can be implemented through the functionality available in the backend.
65
+
66
+ """
67
+
68
+ def __new__(cls, *args, **kwargs):
69
+ return new_curve(cls, *args, **kwargs)
70
+
71
+ def __init__(self, frame=None, name=None):
72
+ super(Curve, self).__init__(name=name)
73
+ self._frame = None
74
+ self._transformation = None
75
+ self._domain = None
76
+ if frame:
77
+ self.frame = frame
78
+
79
+ def __repr__(self):
80
+ return "{0}(frame={1!r}, domain={2})".format(
81
+ type(self).__name__,
82
+ self.frame,
83
+ self.domain,
84
+ )
85
+
86
+ # ==============================================================================
87
+ # Properties
88
+ # ==============================================================================
89
+
90
+ @property
91
+ def frame(self):
92
+ if not self._frame:
93
+ self._frame = Frame.worldXY()
94
+ return self._frame
95
+
96
+ @frame.setter
97
+ def frame(self, frame):
98
+ if not frame:
99
+ self._frame = None
100
+ else:
101
+ self._frame = Frame(frame[0], frame[1], frame[2])
102
+ self._transformation = None
103
+
104
+ @property
105
+ def transformation(self):
106
+ if not self._transformation:
107
+ self._transformation = Transformation.from_frame_to_frame(Frame.worldXY(), self.frame)
108
+ return self._transformation
109
+
110
+ @property
111
+ def plane(self):
112
+ return Plane(self.frame.point, self.frame.zaxis)
113
+
114
+ @property
115
+ def dimension(self):
116
+ return 3
117
+
118
+ @property
119
+ def domain(self):
120
+ return 0.0, 1.0
121
+
122
+ @property
123
+ def is_closed(self):
124
+ raise NotImplementedError
125
+
126
+ @property
127
+ def is_periodic(self):
128
+ raise NotImplementedError
129
+
130
+ # ==============================================================================
131
+ # Constructors
132
+ # ==============================================================================
133
+
134
+ @classmethod
135
+ def from_step(cls, filepath):
136
+ """Load a curve from a STP file.
137
+
138
+ Parameters
139
+ ----------
140
+ filepath : str
141
+ The path to the file.
142
+
143
+ Returns
144
+ -------
145
+ :class:`compas.geometry.Curve`
146
+
147
+ """
148
+ raise NotImplementedError
149
+
150
+ @classmethod
151
+ def from_obj(cls, filepath):
152
+ """Load a curve from an OBJ file.
153
+
154
+ Parameters
155
+ ----------
156
+ filepath : str
157
+ The path to the file.
158
+
159
+ Returns
160
+ -------
161
+ :class:`compas.geometry.Curve`
162
+
163
+ """
164
+ raise NotImplementedError
165
+
166
+ # ==============================================================================
167
+ # Conversions
168
+ # ==============================================================================
169
+
170
+ def to_step(self, filepath, schema="AP203"):
171
+ """Write the curve geometry to a STP file.
172
+
173
+ Parameters
174
+ ----------
175
+ filepath : str
176
+ The path of the output file.
177
+ schema : str, optional
178
+ The STEP schema to use. Default is ``"AP203"``.
179
+
180
+ Returns
181
+ -------
182
+ None
183
+
184
+ """
185
+ raise NotImplementedError
186
+
187
+ def to_obj(self, filepath):
188
+ """Write the curve geometry to an OBJ file.
189
+
190
+ Parameters
191
+ ----------
192
+ filepath : str
193
+ The path of the output file.
194
+
195
+ Returns
196
+ -------
197
+ None
198
+
199
+ """
200
+ raise NotImplementedError
201
+
202
+ def to_points(self, n=10, domain=None):
203
+ """Convert the curve to a list of points.
204
+
205
+ Parameters
206
+ ----------
207
+ n : int, optional
208
+ The number of points in the list.
209
+ Default is ``10``.
210
+ domain : tuple, optional
211
+ Subset of the domain to use for the discretisation.
212
+ Default is ``None``, in which case the entire curve domain is used.
213
+
214
+ Returns
215
+ -------
216
+ list[:class:`compas.geometry.Point`]
217
+
218
+ """
219
+ domain = domain or self.domain
220
+ start, end = domain
221
+ points = [self.point_at(t) for t in linspace(start, end, n)]
222
+ return points
223
+
224
+ def to_polyline(self, n=128, domain=None):
225
+ """Convert the curve to a polyline.
226
+
227
+ Parameters
228
+ ----------
229
+ n : int, optional
230
+ The number of line segments in the polyline.
231
+ Default is ``16``.
232
+ domain : tuple, optional
233
+ Subset of the domain to use for the discretisation.
234
+ Default is ``None``, in which case the entire curve domain is used.
235
+
236
+ Returns
237
+ -------
238
+ :class:`compas.geometry.Polyline`
239
+
240
+ """
241
+ from compas.geometry import Polyline
242
+
243
+ points = self.to_points(n=n + 1, domain=domain)
244
+ return Polyline(points)
245
+
246
+ def to_polygon(self, n=16):
247
+ """Convert the curve to a polygon.
248
+
249
+ Parameters
250
+ ----------
251
+ n : int, optional
252
+ The number of sides of the polygon.
253
+ Default is ``16``.
254
+
255
+ Returns
256
+ -------
257
+ :class:`compas.geometry.Polygon`
258
+
259
+ Raises
260
+ ------
261
+ ValueError
262
+ If the curve is not closed.
263
+
264
+ """
265
+ if not self.is_closed:
266
+ raise ValueError("The curve is not closed.")
267
+
268
+ from compas.geometry import Polygon
269
+
270
+ points = self.to_points(n=n + 1)
271
+ return Polygon(points[:-1])
272
+
273
+ # ==============================================================================
274
+ # Transformations
275
+ # ==============================================================================
276
+
277
+ def transform(self, T):
278
+ """Transform the local coordinate system of the curve.
279
+
280
+ Parameters
281
+ ----------
282
+ T : :class:`compas.geometry.Transformation` | list[list[float]]
283
+ The transformation.
284
+
285
+ Returns
286
+ -------
287
+ None
288
+ The (local coordinate system of the) curve is modified in-place.
289
+
290
+ Notes
291
+ -----
292
+ Transformations of frames are limited to rotations and translations.
293
+ All other transformations have no effect.
294
+ See :meth:`~compas.geometry.Frame.transform` for more info.
295
+
296
+ """
297
+ self.frame.transform(T)
298
+ self._transformation = None
299
+
300
+ # ==============================================================================
301
+ # Methods
302
+ # ==============================================================================
303
+
304
+ def point_at(self, t):
305
+ """Compute a point of the curve at a parameter.
306
+
307
+ Parameters
308
+ ----------
309
+ t : float
310
+ The value of the curve parameter. Must be between 0 and 1.
311
+
312
+ Returns
313
+ -------
314
+ :class:`compas.geometry.Point`
315
+ the corresponding point on the curve.
316
+
317
+ Raises
318
+ ------
319
+ ValueError
320
+ If the parameter is not in the curve domain.
321
+
322
+ See Also
323
+ --------
324
+ :meth:`normal_at`, :meth:`tangent_at`, :meth:`binormal_at`, :meth:`frame_at`, :meth:`curvature_at`
325
+
326
+ """
327
+ raise NotImplementedError
328
+
329
+ def normal_at(self, t):
330
+ """Compute the normal of the curve at a parameter.
331
+
332
+ Parameters
333
+ ----------
334
+ t : float
335
+ The value of the curve parameter.
336
+
337
+ Returns
338
+ -------
339
+ :class:`compas.geometry.Vector`
340
+ The corresponding normal vector.
341
+
342
+ Raises
343
+ ------
344
+ ValueError
345
+ If the parameter is not in the curve domain.
346
+
347
+ See Also
348
+ --------
349
+ :meth:`point_at`, :meth:`tangent_at`, :meth:`binormal_at`, :meth:`frame_at`, :meth:`curvature_at`
350
+
351
+ """
352
+ raise NotImplementedError
353
+
354
+ def tangent_at(self, t):
355
+ """Compute the tangent vector of the curve at a parameter.
356
+
357
+ Parameters
358
+ ----------
359
+ t : float
360
+ The value of the curve parameter.
361
+
362
+ Returns
363
+ -------
364
+ :class:`compas.geometry.Vector`
365
+ The corresponding tangent vector.
366
+
367
+ Raises
368
+ ------
369
+ ValueError
370
+ If the parameter is not in the curve domain.
371
+
372
+ See Also
373
+ --------
374
+ :meth:`point_at`, :meth:`normal_at`, :meth:`binormal_at`, :meth:`frame_at`, :meth:`curvature_at`
375
+
376
+ """
377
+ raise NotImplementedError
378
+
379
+ def frame_at(self, t):
380
+ """Compute the local frame of the curve at a parameter.
381
+
382
+ Parameters
383
+ ----------
384
+ t : float
385
+ The value of the curve parameter.
386
+
387
+ Returns
388
+ -------
389
+ :class:`compas.geometry.Frame`
390
+ The corresponding local frame.
391
+
392
+ Raises
393
+ ------
394
+ ValueError
395
+ If the parameter is not in the curve domain.
396
+
397
+ See Also
398
+ --------
399
+ :meth:`point_at`, :meth:`normal_at`, :meth:`tangent_at`, :meth:`binormal_at`, :meth:`curvature_at`
400
+
401
+ """
402
+ return Frame(self.point_at(t), self.tangent_at(t), self.normal_at(t))
403
+
404
+ def curvature_at(self, t):
405
+ """Compute the curvature vector of the curve at a parameter.
406
+
407
+ This is a vector pointing from the point on the curve at the specified parameter,
408
+ to the center of the oscillating circle of the curve at that location.
409
+
410
+ Note that this vector is parallel to the normal vector of the curve at that location.
411
+
412
+ Parameters
413
+ ----------
414
+ t : float
415
+ The value of the curve parameter.
416
+
417
+ Returns
418
+ -------
419
+ :class:`compas.geometry.Vector`
420
+ The corresponding curvature vector.
421
+
422
+ Raises
423
+ ------
424
+ ValueError
425
+ If the parameter is not in the curve domain.
426
+
427
+ See Also
428
+ --------
429
+ :meth:`point_at`, :meth:`normal_at`, :meth:`tangent_at`, :meth:`binormal_at`, :meth:`frame_at`
430
+
431
+ """
432
+ raise NotImplementedError
433
+
434
+ # ==============================================================================
435
+ # Methods continued
436
+ # ==============================================================================
437
+
438
+ def reverse(self):
439
+ """Reverse the parametrisation of the curve.
440
+
441
+ Returns
442
+ -------
443
+ None
444
+
445
+ See Also
446
+ --------
447
+ :meth:`reversed`
448
+
449
+ """
450
+ raise NotImplementedError
451
+
452
+ def reversed(self):
453
+ """Reverse a copy of the curve.
454
+
455
+ Returns
456
+ -------
457
+ :class:`compas.geometry.Curve`
458
+
459
+ See Also
460
+ --------
461
+ :meth:`reverse`
462
+
463
+ """
464
+ copy = self.copy()
465
+ copy.reverse
466
+ return copy
467
+
468
+ # def space(self, n=10):
469
+ # """Compute evenly spaced parameters over the curve domain.
470
+
471
+ # Parameters
472
+ # ----------
473
+ # n : int, optional
474
+ # The number of values in the parameter space.
475
+
476
+ # Returns
477
+ # -------
478
+ # list[float]
479
+
480
+ # See Also
481
+ # --------
482
+ # :meth:`locus`
483
+
484
+ # """
485
+ # start, end = self.domain
486
+ # return linspace(start, end, n)
487
+
488
+ # def locus(self, resolution=100):
489
+ # """Compute the locus of points on the curve.
490
+
491
+ # Parameters
492
+ # ----------
493
+ # resolution : int
494
+ # The number of intervals at which a point on the
495
+ # curve should be computed.
496
+
497
+ # Returns
498
+ # -------
499
+ # list[:class:`compas.geometry.Point`]
500
+ # Points along the curve.
501
+
502
+ # See Also
503
+ # --------
504
+ # :meth:`space`
505
+
506
+ # """
507
+ # return [self.point_at(t) for t in self.space(resolution)]
508
+
509
+ def closest_point(self, point, return_parameter=False):
510
+ """Compute the closest point on the curve to a given point.
511
+
512
+ Parameters
513
+ ----------
514
+ point : :class:`compas.geometry.Point`
515
+ The test point.
516
+ return_parameter : bool, optional
517
+ If True, the parameter corresponding to the closest point should be returned in addition to the point.
518
+
519
+ Returns
520
+ -------
521
+ :class:`compas.geometry.Point` | tuple[:class:`compas.geometry.Point`, float]
522
+ If `return_parameter` is False (default), only the closest point is returned.
523
+ If `return_parameter` is True, the closest point and the corresponding parameter are returned.
524
+
525
+ """
526
+ raise NotImplementedError
527
+
528
+ def divide_by_count(self, count, return_points=False):
529
+ """Compute the curve parameters that divide the curve into a specific number of equal length segments.
530
+
531
+ Parameters
532
+ ----------
533
+ count : int
534
+ The number of segments.
535
+ return_points : bool, optional
536
+ If True, return the list of division parameters,
537
+ and the points corresponding to those parameters.
538
+ If False, return only the list of parameters.
539
+
540
+ Returns
541
+ -------
542
+ list[float] | tuple[list[float], list[:class:`compas.geometry.Point`]]
543
+ If `return_points` is False, the parameters of the discretisation.
544
+ If `return_points` is True, a list of points in addition to the parameters of the discretisation.
545
+
546
+ See Also
547
+ --------
548
+ :meth:`divide_by_length`
549
+ :meth:`split`
550
+
551
+ """
552
+ raise NotImplementedError
553
+
554
+ def divide_by_length(self, length, return_points=False):
555
+ """Compute the curve parameters that divide the curve into segments of specified length.
556
+
557
+ Parameters
558
+ ----------
559
+ length : float
560
+ The length of the segments.
561
+ return_points : bool, optional
562
+ If True, return the list of division parameters,
563
+ and the points corresponding to those parameters.
564
+ If False, return only the list of parameters.
565
+
566
+ Returns
567
+ -------
568
+ list[float] | tuple[list[float], list[:class:`compas.geometry.Point`]]
569
+ If `return_points` is False, the parameters of the discretisation.
570
+ If `return_points` is True, a list of points in addition to the parameters of the discretisation.
571
+
572
+ See Also
573
+ --------
574
+ :meth:`divide_by_count`
575
+ :meth:`split`
576
+
577
+ """
578
+ raise NotImplementedError
579
+
580
+ def aabb(self):
581
+ """Compute the axis-aligned bounding box of the curve.
582
+
583
+ Returns
584
+ -------
585
+ :class:`compas.geometry.Box`
586
+
587
+ """
588
+ raise NotImplementedError
589
+
590
+ def length(self, tol=None):
591
+ """Compute the length of the curve.
592
+
593
+ Parameters
594
+ ----------
595
+ precision : float, optional
596
+ Required precision of the calculated length.
597
+
598
+ """
599
+ raise NotImplementedError
600
+
601
+ def fair(self, tol=None):
602
+ raise NotImplementedError
603
+
604
+ def offset(self):
605
+ raise NotImplementedError
606
+
607
+ def smooth(self):
608
+ raise NotImplementedError
609
+
610
+ def split(self):
611
+ raise NotImplementedError
612
+
613
+ def trim(self):
614
+ raise NotImplementedError