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,473 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ import math
6
+
7
+ from compas.geometry import Frame
8
+ from compas.geometry import Geometry
9
+ from compas.geometry import Line
10
+ from compas.geometry import Plane
11
+ from compas.geometry import Point
12
+ from compas.geometry import Transformation
13
+ from compas.geometry import area_polygon
14
+ from compas.geometry import bounding_box
15
+ from compas.geometry import centroid_polygon
16
+ from compas.geometry import earclip_polygon
17
+ from compas.geometry import is_coplanar
18
+ from compas.geometry import is_polygon_convex
19
+ from compas.geometry import transform_points
20
+ from compas.itertools import pairwise
21
+ from compas.tolerance import TOL
22
+
23
+
24
+ class Polygon(Geometry):
25
+ """A polygon is a geometric object defined by a sequence of points forming a closed loop.
26
+
27
+ A polygon is defined by a sequence of points connected by line segments
28
+ forming a closed boundary that separates its interior from the exterior.
29
+
30
+ In the sequence of points, the first and last element are not the same.
31
+ The existence of the closing edge is implied.
32
+ The boundary should not intersect itself.
33
+
34
+ Polygons are not necessarily planar by construction; they can be warped or skewed.
35
+
36
+ The polygon does not have a coordinate frame.
37
+ Its geometry is always defined with respect to the world coordinate system.
38
+
39
+ Polygons can be constructed parametrically by the number of sides and a radius,
40
+ but the geometry of the resulting object is defined by a list of explicit point locations.
41
+
42
+ Parameters
43
+ ----------
44
+ points : list[[float, float, float] | :class:`compas.geometry.Point`]
45
+ An ordered list of points.
46
+ name : str, optional
47
+ The name of the polygon.
48
+
49
+ Attributes
50
+ ----------
51
+ points : list of :class:`compas.geometry.Point`
52
+ The points of the polygon.
53
+ lines : list of :class:`compas.geometry.Line`, read-only
54
+ The lines of the polygon.
55
+ length : float, read-only
56
+ The length of the boundary.
57
+ centroid : :class:`compas.geometry.Point`, read-only
58
+ The centroid of the polygon.
59
+ normal : :class:`compas.geometry.Vector`, read-only
60
+ The (average) normal of the polygon.
61
+ area : float, read-only
62
+ The area of the polygon.
63
+ is_convex : bool, read-only
64
+ True if the polygon is convex.
65
+ is_planar : bool, read-only
66
+ True if the polygon is planar.
67
+
68
+ See Also
69
+ --------
70
+ :func:`compas.geometry.centroid_polygon`,
71
+ :func:`compas.geometry.area_polygon`,
72
+ :func:`compas.geometry.is_polygon_convex`,
73
+ :func:`earclip_polygon`
74
+
75
+ Examples
76
+ --------
77
+ >>> polygon = Polygon([[0, 0, 0], [1, 0, 0], [1, 1, 0], [0, 1, 0]])
78
+ >>> polygon.centroid
79
+ Point(0.500, 0.500, 0.000)
80
+ >>> polygon.area
81
+ 1.0
82
+
83
+ """
84
+
85
+ DATASCHEMA = {
86
+ "type": "object",
87
+ "properties": {"points": {"type": "array", "minItems": 2, "items": Point.DATASCHEMA}},
88
+ "required": ["points"],
89
+ }
90
+
91
+ @property
92
+ def __data__(self):
93
+ return {"points": [point.__data__ for point in self.points]}
94
+
95
+ def __init__(self, points, name=None):
96
+ super(Polygon, self).__init__(name=name)
97
+ self._points = []
98
+ self._lines = []
99
+ self._vertices = []
100
+ self._faces = []
101
+ self.points = points
102
+
103
+ def __repr__(self):
104
+ return "{0}(points={1!r})".format(type(self).__name__, self.points)
105
+
106
+ def __len__(self):
107
+ return len(self.points)
108
+
109
+ def __getitem__(self, key):
110
+ return self.points[key]
111
+
112
+ def __setitem__(self, key, value):
113
+ self.points[key] = Point(*value)
114
+ self._lines = None
115
+
116
+ def __iter__(self):
117
+ return iter(self.points)
118
+
119
+ def __eq__(self, other):
120
+ if not hasattr(other, "__iter__") or not hasattr(other, "__len__") or len(self) != len(other):
121
+ return False
122
+ return TOL.is_allclose(self, other)
123
+
124
+ # ==========================================================================
125
+ # Properties
126
+ # ==========================================================================
127
+
128
+ @property
129
+ def points(self):
130
+ return self._points
131
+
132
+ @points.setter
133
+ def points(self, points):
134
+ if points[-1] == points[0]:
135
+ points = points[:-1]
136
+ self._points = [Point(*xyz) for xyz in points]
137
+ self._lines = None
138
+
139
+ @property
140
+ def lines(self):
141
+ if not self._lines:
142
+ self._lines = [Line(a, b) for a, b in pairwise(self.points + self.points[:1])]
143
+ return self._lines
144
+
145
+ @property
146
+ def vertices(self):
147
+ if not self._vertices:
148
+ return self.points
149
+ return self._vertices
150
+
151
+ @property
152
+ def faces(self):
153
+ if not self._faces:
154
+ return [list(range(len(self.points)))]
155
+ return self._faces
156
+
157
+ @property
158
+ def length(self):
159
+ return sum(line.length for line in self.lines)
160
+
161
+ @property
162
+ def centroid(self):
163
+ point = centroid_polygon(self.points)
164
+ return Point(*point)
165
+
166
+ @property
167
+ def normal(self):
168
+ return self.plane.normal
169
+
170
+ @property
171
+ def plane(self):
172
+ return Plane.from_points(self.points)
173
+
174
+ @property
175
+ def frame(self):
176
+ return Frame.from_plane(self.plane)
177
+
178
+ @property
179
+ def area(self):
180
+ return area_polygon(self.points)
181
+
182
+ @property
183
+ def is_convex(self):
184
+ return is_polygon_convex(self.points)
185
+
186
+ @property
187
+ def is_planar(self):
188
+ return is_coplanar(self.points)
189
+
190
+ @property
191
+ def bounding_box(self):
192
+ from compas.geometry import Box
193
+
194
+ return Box.from_bounding_box(bounding_box(self.points))
195
+
196
+ # ==========================================================================
197
+ # Constructors
198
+ # ==========================================================================
199
+
200
+ @classmethod
201
+ def from_rectangle(cls, point, width, height):
202
+ """Construct a rectangle.
203
+
204
+ Parameters
205
+ ----------
206
+ point : :class:`compas.geometry.Point`
207
+ The lower left corner of the rectangle.
208
+ width : float
209
+ The width of the rectangle.
210
+ height : float
211
+ The height of the rectangle.
212
+
213
+ Returns
214
+ -------
215
+ :class:`compas.geometry.Polygon`
216
+ A rectangle.
217
+
218
+ """
219
+ x, y, z = point
220
+ points = [
221
+ [x, y, z],
222
+ [x + width, y, z],
223
+ [x + width, y + height, z],
224
+ [x, y + height, z],
225
+ ]
226
+ return cls(points)
227
+
228
+ @classmethod
229
+ def from_sides_and_radius_xy(cls, n, radius):
230
+ """Construct a polygon from a number of sides and a radius.
231
+ The resulting polygon is planar, equilateral and equiangular.
232
+
233
+ Parameters
234
+ ----------
235
+ n : int
236
+ The number of sides.
237
+ radius : float
238
+ The radius of the circle the polygon will be circumscribed to.
239
+
240
+ Returns
241
+ -------
242
+ :class:`compas.geometry.Polygon`
243
+ The constructed polygon.
244
+
245
+ Raises
246
+ ------
247
+ ValueError
248
+ If the number of sides is smaller than 3.
249
+
250
+ Notes
251
+ -----
252
+ The first point of the polygon aligns with the Y-axis.
253
+ The order of the polygon's points is counterclockwise.
254
+
255
+ Examples
256
+ --------
257
+ >>> from compas.geometry import dot_vectors
258
+ >>> from compas.geometry import subtract_vectors
259
+ >>> pentagon = Polygon.from_sides_and_radius_xy(5, 1.0)
260
+ >>> len(pentagon.lines) == 5
261
+ True
262
+ >>> len({round(line.length, 6) for line in pentagon.lines}) == 1
263
+ True
264
+ >>> dot_vectors(pentagon.normal, [0.0, 0.0, 1.0]) == 1
265
+ True
266
+ >>> centertofirst = subtract_vectors(pentagon.points[0], pentagon.centroid)
267
+ >>> dot_vectors(centertofirst, [0.0, 1.0, 0.0]) == 1
268
+ True
269
+
270
+ """
271
+ if n < 3:
272
+ raise ValueError("Supplied number of sides must be at least 3!")
273
+
274
+ points = []
275
+ side = math.pi * 2 / n
276
+ for i in range(n):
277
+ point = [
278
+ math.sin(side * (n - i)) * radius,
279
+ math.cos(side * (n - i)) * radius,
280
+ 0.0,
281
+ ]
282
+ points.append(point)
283
+ return cls(points)
284
+
285
+ # =============================================================================
286
+ # Conversions
287
+ # =============================================================================
288
+
289
+ def to_vertices_and_faces(self, earclip=False):
290
+ """Returns a list of vertices and faces.
291
+
292
+ Parameters
293
+ ----------
294
+ earclip : bool, optional
295
+ Earclip the polygon before returning the vertices and faces.
296
+
297
+ Returns
298
+ -------
299
+ list[list[float]], list[list[int]]
300
+ A list of vertex locations, and a list of faces,
301
+ with each face defined as a list of indices into the list of vertices.
302
+
303
+ """
304
+ if earclip:
305
+ T = Transformation.from_change_of_basis(Frame.worldXY(), self.frame)
306
+ points = transform_points(self.points, T)
307
+ self._faces = earclip_polygon(points)
308
+ return self.vertices, self.faces
309
+
310
+ def to_mesh(self, earclip=False):
311
+ """Returns a mesh representation of the polygon.
312
+
313
+ Parameters
314
+ ----------
315
+ earclip : bool, optional
316
+ Earclip the polygon before converting to a mesh.
317
+
318
+ Returns
319
+ -------
320
+ :class:`compas.datastructures.Mesh`
321
+ A mesh object.
322
+
323
+ """
324
+ from compas.datastructures import Mesh
325
+
326
+ vertices, faces = self.to_vertices_and_faces(earclip=earclip)
327
+ return Mesh.from_vertices_and_faces(vertices, faces)
328
+
329
+ def to_brep(self):
330
+ """Returns a brep representation of the polygon.
331
+
332
+ Returns
333
+ -------
334
+ :class:`compas.geometry.Brep`
335
+ A boundary representation of the polygon.
336
+
337
+ """
338
+ from compas.geometry import Brep
339
+
340
+ return Brep.from_polygons([self])
341
+
342
+ # =============================================================================
343
+ # Transformations
344
+ # =============================================================================
345
+
346
+ def transform(self, T):
347
+ """Transform this polygon.
348
+
349
+ Parameters
350
+ ----------
351
+ T : :class:`compas.geometry.Transformation` | list[list[float]]
352
+ The transformation.
353
+
354
+ Returns
355
+ -------
356
+ None
357
+
358
+ Examples
359
+ --------
360
+ >>> from math import radians
361
+ >>> from compas.geometry import Rotation
362
+ >>> polygon = Polygon.from_sides_and_radius_xy(4, 1.0)
363
+ >>> R = Rotation.from_axis_and_angle([0.0, 0.0, 1.0], radians(45))
364
+ >>> polygon.transform(R)
365
+ >>> polygon.points[0]
366
+ Point(-0.707, 0.707, 0.000)
367
+
368
+ """
369
+ for index, point in enumerate(transform_points(self.points, T)):
370
+ self.points[index].x = point[0]
371
+ self.points[index].y = point[1]
372
+ self.points[index].z = point[2]
373
+
374
+ # =============================================================================
375
+ # Methods
376
+ # =============================================================================
377
+
378
+ def boolean_union(self, other):
379
+ """Compute the boolean union of this polygon and another polygon.
380
+
381
+ For this operation, both polygons are assumed to lie in the XY plane.
382
+ Therefore, the Z components of the points defining the polygons are simply ignored.
383
+ If the polygons are not in the XY plane, it is the responibility of the user to transform them accordingly.
384
+ Otherwise the results are meaningless.
385
+
386
+ Parameters
387
+ ----------
388
+ other : :class:`compas.geometry.Polygon`
389
+ The other polygon.
390
+
391
+ Returns
392
+ -------
393
+ :class:`compas.geometry.Polygon`
394
+ The union polygon.
395
+
396
+ """
397
+ from compas.geometry import boolean_union_polygon_polygon
398
+
399
+ coords = boolean_union_polygon_polygon(self, other)
400
+ return Polygon([[x, y, 0] for x, y in coords]) # type: ignore
401
+
402
+ def boolean_difference(self, other):
403
+ """Compute the boolean difference of this polygon and another polygon.
404
+
405
+ For this operation, both polygons are assumed to lie in the XY plane.
406
+ Therefore, the Z components of the points defining the polygons are simply ignored.
407
+ If the polygons are not in the XY plane, it is the responibility of the user to transform them accordingly.
408
+ Otherwise the results are meaningless.
409
+
410
+ Parameters
411
+ ----------
412
+ other : :class:`compas.geometry.Polygon`
413
+ The other polygon.
414
+
415
+ Returns
416
+ -------
417
+ :class:`compas.geometry.Polygon`
418
+ The difference polygon.
419
+
420
+ """
421
+ from compas.geometry import boolean_difference_polygon_polygon
422
+
423
+ coords = boolean_difference_polygon_polygon(self, other)
424
+ return Polygon([[x, y, 0] for x, y in coords]) # type: ignore
425
+
426
+ def boolean_symmetric_difference(self, other):
427
+ """Compute the boolean symmetric difference of this polygon and another polygon.
428
+
429
+ For this operation, both polygons are assumed to lie in the XY plane.
430
+ Therefore, the Z components of the points defining the polygons are simply ignored.
431
+ If the polygons are not in the XY plane, it is the responibility of the user to transform them accordingly.
432
+ Otherwise the results are meaningless.
433
+
434
+ Parameters
435
+ ----------
436
+ other : :class:`compas.geometry.Polygon`
437
+ The other polygon.
438
+
439
+ Returns
440
+ -------
441
+ list[:class:`compas.geometry.Polygon`]
442
+ The resulting polygons.
443
+
444
+ """
445
+ from compas.geometry import boolean_symmetric_difference_polygon_polygon
446
+
447
+ coordsets = boolean_symmetric_difference_polygon_polygon(self, other)
448
+ polygons = [Polygon([[x, y, 0] for x, y in coords]) for coords in coordsets] # type: ignore
449
+ return polygons
450
+
451
+ def boolean_intersection(self, other):
452
+ """Compute the boolean intersection of this polygon and another polygon.
453
+
454
+ For this operation, both polygons are assumed to lie in the XY plane.
455
+ Therefore, the Z components of the points defining the polygons are simply ignored.
456
+ If the polygons are not in the XY plane, it is the responibility of the user to transform them accordingly.
457
+ Otherwise the results are meaningless.
458
+
459
+ Parameters
460
+ ----------
461
+ other : :class:`compas.geometry.Polygon`
462
+ The other polygon.
463
+
464
+ Returns
465
+ -------
466
+ :class:`compas.geometry.Polygon`
467
+ The intersection polygon.
468
+
469
+ """
470
+ from compas.geometry import boolean_intersection_polygon_polygon
471
+
472
+ coords = boolean_intersection_polygon_polygon(self, other)
473
+ return Polygon([[x, y, 0] for x, y in coords]) # type: ignore