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,664 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ from compas.geometry import centroid_points
6
+ from compas.geometry import distance_point_line
7
+ from compas.geometry import distance_point_plane
8
+ from compas.geometry import distance_point_point
9
+ from compas.geometry import is_point_behind_plane
10
+ from compas.geometry import is_point_in_circle
11
+ from compas.geometry import is_point_in_convex_polygon_xy
12
+ from compas.geometry import is_point_in_polygon_xy
13
+ from compas.geometry import is_point_in_triangle
14
+ from compas.geometry import is_point_on_polyline
15
+ from compas.geometry import is_point_on_segment
16
+ from compas.geometry import normal_polygon
17
+ from compas.geometry import transform_points
18
+ from compas.tolerance import TOL
19
+
20
+ from .geometry import Geometry
21
+ from .vector import Vector
22
+
23
+
24
+ class Point(Geometry):
25
+ """A point is defined by XYZ coordinates.
26
+
27
+ Parameters
28
+ ----------
29
+ x : float
30
+ The X coordinate of the point.
31
+ y : float
32
+ The Y coordinate of the point.
33
+ z : float, optional
34
+ The Z coordinate of the point.
35
+ name : str, optional
36
+ The name of the point.
37
+
38
+ Attributes
39
+ ----------
40
+ x : float
41
+ The X coordinate of the point.
42
+ y : float
43
+ The Y coordinate of the point.
44
+ z : float
45
+ The Z coordinate of the point.
46
+
47
+ Notes
48
+ -----
49
+ A `Point` object supports direct access to its xyz coordinates through
50
+ the dot notation, as well list-style access using indices. Indexed
51
+ access is implemented such that the `Point` behaves like a circular
52
+ list [1]_.
53
+
54
+ References
55
+ ----------
56
+ .. [1] Stack Overflow. *Pythonic Circular List*.
57
+ Available at: https://stackoverflow.com/questions/8951020/pythonic-circular-list.
58
+
59
+ Examples
60
+ --------
61
+ >>> p1 = Point(1, 2, 3)
62
+ >>> p2 = Point(4, 5, 6)
63
+
64
+ The XYZ coordinates of point objects can be accessed as object attributes or by trating the points as lists.
65
+
66
+ >>> p1.x
67
+ 1.0
68
+ >>> p1.y
69
+ 2.0
70
+ >>> p1.z
71
+ 3.0
72
+ >>> p1[0]
73
+ 1.0
74
+ >>> p1[1]
75
+ 2.0
76
+ >>> p1[2]
77
+ 3.0
78
+
79
+ Point objects support basic arithmetic operations.
80
+
81
+ >>> p1 + p2
82
+ Point(5.000, 7.000, 9.000)
83
+ >>> p1 * 2
84
+ Point(2.000, 4.000, 6.000)
85
+ >>> p1**2
86
+ Point(1.000, 4.000, 9.000)
87
+ >>> p1
88
+ Point(1.000, 2.000, 3.000)
89
+
90
+ Points and lists can be used interchangeably.
91
+
92
+ >>> p1 + [4, 5, 6]
93
+ Point(5.000, 7.000, 9.000)
94
+
95
+ Arithmetic operations can also be applied to modify a point object in-place.
96
+
97
+ >>> p1 += p2
98
+ >>> p1 *= 2
99
+ >>> p1 **= 2
100
+ >>> p1
101
+ Point(100.000, 196.000, 324.000)
102
+
103
+ """
104
+
105
+ DATASCHEMA = {
106
+ "type": "array",
107
+ "minItems": 3,
108
+ "maxItems": 3,
109
+ "items": {"type": "number"},
110
+ }
111
+
112
+ @property
113
+ def __data__(self):
114
+ return list(self)
115
+
116
+ @classmethod
117
+ def __from_data__(cls, data):
118
+ return cls(*data)
119
+
120
+ def __init__(self, x, y, z=0.0, name=None):
121
+ super(Point, self).__init__(name=name)
122
+ self._x = 0.0
123
+ self._y = 0.0
124
+ self._z = 0.0
125
+ self.x = x
126
+ self.y = y
127
+ self.z = z
128
+
129
+ def __repr__(self):
130
+ return "{0}(x={1}, y={2}, z={3})".format(
131
+ type(self).__name__,
132
+ self.x,
133
+ self.y,
134
+ self.z,
135
+ )
136
+
137
+ def __str__(self):
138
+ return "{0}(x={1}, y={2}, z={3})".format(
139
+ type(self).__name__,
140
+ TOL.format_number(self.x),
141
+ TOL.format_number(self.y),
142
+ TOL.format_number(self.z),
143
+ )
144
+
145
+ def __len__(self):
146
+ return 3
147
+
148
+ def __getitem__(self, key):
149
+ if isinstance(key, slice):
150
+ return [self[i] for i in range(*key.indices(len(self)))]
151
+ i = key % 3
152
+ if i == 0:
153
+ return self.x
154
+ if i == 1:
155
+ return self.y
156
+ if i == 2:
157
+ return self.z
158
+ raise KeyError
159
+
160
+ def __setitem__(self, key, value):
161
+ i = key % 3
162
+ if i == 0:
163
+ self.x = value
164
+ return
165
+ if i == 1:
166
+ self.y = value
167
+ return
168
+ if i == 2:
169
+ self.z = value
170
+ return
171
+ raise KeyError
172
+
173
+ def __iter__(self):
174
+ return iter([self.x, self.y, self.z])
175
+
176
+ def __eq__(self, other):
177
+ return self.x == other[0] and self.y == other[1] and self.z == other[2]
178
+
179
+ def __add__(self, other):
180
+ return Point(self.x + other[0], self.y + other[1], self.z + other[2])
181
+
182
+ def __sub__(self, other):
183
+ x = self.x - other[0]
184
+ y = self.y - other[1]
185
+ z = self.z - other[2]
186
+ return Vector(x, y, z)
187
+
188
+ def __mul__(self, n):
189
+ return Point(n * self.x, n * self.y, n * self.z)
190
+
191
+ def __truediv__(self, n):
192
+ return Point(self.x / n, self.y / n, self.z / n)
193
+
194
+ def __pow__(self, n):
195
+ return Point(self.x**n, self.y**n, self.z**n)
196
+
197
+ def __iadd__(self, other):
198
+ self.x += other[0]
199
+ self.y += other[1]
200
+ self.z += other[2]
201
+ return self
202
+
203
+ def __isub__(self, other):
204
+ self.x -= other[0]
205
+ self.y -= other[1]
206
+ self.z -= other[2]
207
+ return self
208
+
209
+ def __imul__(self, n):
210
+ self.x *= n
211
+ self.y *= n
212
+ self.z *= n
213
+ return self
214
+
215
+ def __itruediv__(self, n):
216
+ self.x /= n
217
+ self.y /= n
218
+ self.z /= n
219
+ return self
220
+
221
+ def __ipow__(self, n):
222
+ self.x **= n
223
+ self.y **= n
224
+ self.z **= n
225
+ return self
226
+
227
+ # ==========================================================================
228
+ # Properties
229
+ # ==========================================================================
230
+
231
+ @property
232
+ def x(self):
233
+ return self._x
234
+
235
+ @x.setter
236
+ def x(self, x):
237
+ self._x = float(x)
238
+
239
+ @property
240
+ def y(self):
241
+ return self._y
242
+
243
+ @y.setter
244
+ def y(self, y):
245
+ self._y = float(y)
246
+
247
+ @property
248
+ def z(self):
249
+ return self._z
250
+
251
+ @z.setter
252
+ def z(self, z):
253
+ self._z = float(z)
254
+
255
+ # ==========================================================================
256
+ # Methods
257
+ # ==========================================================================
258
+
259
+ def distance_to_point(self, point):
260
+ """Compute the distance to another point.
261
+
262
+ Parameters
263
+ ----------
264
+ point : [float, float, float] | :class:`compas.geometry.Point`
265
+ The other point.
266
+
267
+ Returns
268
+ -------
269
+ float
270
+ The distance.
271
+
272
+ Examples
273
+ --------
274
+ >>> a = Point(0.0, 0.0, 0.0)
275
+ >>> b = Point(1.0, 0.0, 0.0)
276
+ >>> a.distance_to_point(b)
277
+ 1.0
278
+
279
+ """
280
+ return distance_point_point(self, point)
281
+
282
+ def distance_to_line(self, line):
283
+ """Compute the distance to a line.
284
+
285
+ Parameters
286
+ ----------
287
+ line : [point, point] | :class:`compas.geometry.Line`
288
+ The line.
289
+
290
+ Returns
291
+ -------
292
+ float
293
+ The distance.
294
+
295
+ Examples
296
+ --------
297
+ >>> from compas.geometry import Line
298
+ >>> point = Point(0.0, 0.0, 0.0)
299
+ >>> line = Line(Point(1.0, 0.0, 0.0), Point(1.0, 1.0, 0.0))
300
+ >>> point.distance_to_line(line)
301
+ 1.0
302
+
303
+ """
304
+ return distance_point_line(self, line)
305
+
306
+ def distance_to_plane(self, plane):
307
+ """Compute the distance to a plane.
308
+
309
+ Parameters
310
+ ----------
311
+ plane : [point, vector] | :class:`compas.geometry.Plane`
312
+ The plane.
313
+
314
+ Returns
315
+ -------
316
+ float
317
+ The distance.
318
+
319
+ Examples
320
+ --------
321
+ >>> from compas.geometry import Plane
322
+ >>> from compas.geometry import Vector
323
+ >>> point = Point(0.0, 0.0, 0.0)
324
+ >>> plane = Plane(Point(1.0, 0.0, 0.0), Vector(1.0, 0.0, 0.0))
325
+ >>> point.distance_to_plane(plane)
326
+ 1.0
327
+
328
+ """
329
+ return distance_point_plane(self, plane)
330
+
331
+ # ==========================================================================
332
+ # 2D predicates
333
+ # ==========================================================================
334
+
335
+ def in_polygon(self, polygon):
336
+ """Determine if the point lies inside the given polygon.
337
+
338
+ For this test, the point and polygon are assumed to lie in the XY plane.
339
+ The Z coordinates of the point and of the points of the polygon are ignored.
340
+ If the point and/or polygon do not lie in the XY plane, the result of this test is meaningless.
341
+ It is up to the user to apply the necessary transformations beforehand.
342
+
343
+ The polygon can be convex or concave.
344
+
345
+ Parameters
346
+ ----------
347
+ polygon : sequence[point] | :class:`compas.geometry.Polygon`
348
+ The polygon.
349
+
350
+ Returns
351
+ -------
352
+ bool
353
+ True, if the point lies in the polygon.
354
+ False, otherwise.
355
+
356
+ See Also
357
+ --------
358
+ :meth:`in_convex_polygon`
359
+
360
+ Examples
361
+ --------
362
+ >>> from compas.geometry import Polygon
363
+ >>> poly = Polygon([Point(0.0, 0.0, 0.0), Point(1.0, 0.0, 0.0), Point(1.0, 1.0, 0.0), Point(0.0, 1.0, 0.0)])
364
+ >>> point = Point(0.5, 0.5, 0.0)
365
+ >>> point.in_polygon(poly)
366
+ True
367
+
368
+ """
369
+ return is_point_in_polygon_xy(self, polygon)
370
+
371
+ def in_convex_polygon(self, polygon):
372
+ """Determine if the point lies inside the given convex polygon.
373
+
374
+ For this test, the point and polygon are assumed to lie in the XY plane.
375
+ The Z coordinates of the point and of the points of the polygon are ignored.
376
+ If the point and/or polygon do not lie in the XY plane, the result of this test is meaningless.
377
+ It is up to the user to apply the necessary transformations beforehand.
378
+
379
+ The polygon must be convex.
380
+ However, the method will not check that this is indeed the case.
381
+
382
+ Parameters
383
+ ----------
384
+ polygon : sequence[point] | :class:`compas.geometry.Polygon`
385
+ The polygon.
386
+
387
+ Returns
388
+ -------
389
+ bool
390
+ True, if the point lies in the polygon.
391
+ False, otherwise.
392
+
393
+ See Also
394
+ --------
395
+ :meth:`in_polygon`
396
+
397
+ Examples
398
+ --------
399
+ >>> from compas.geometry import Polygon
400
+ >>> poly = Polygon([Point(0.0, 0.0, 0.0), Point(1.0, 0.0, 0.0), Point(1.0, 1.0, 0.0), Point(0.0, 1.0, 0.0)])
401
+ >>> point = Point(0.5, 0.5, 0.0)
402
+ >>> point.in_convex_polygon(poly)
403
+ True
404
+
405
+ """
406
+ return is_point_in_convex_polygon_xy(self, polygon)
407
+
408
+ # ==========================================================================
409
+ # 3D predicates
410
+ # ==========================================================================
411
+
412
+ def on_line(self, line, tol=None):
413
+ """Determine if the point lies on the given line.
414
+
415
+ Parameters
416
+ ----------
417
+ line : [point, point] | :class:`compas.geometry.Line`
418
+ The line.
419
+ tol : float, optional
420
+ A tolerance value for the distance between the point and the line.
421
+ Default is :attr:`TOL.absolute`.
422
+
423
+ Returns
424
+ -------
425
+ bool
426
+ True, if the point lies on the line.
427
+ False, otherwise.
428
+
429
+ Examples
430
+ --------
431
+ >>> from compas.geometry import Line
432
+ >>> line = Line(Point(1.0, 0.0, 0.0), Point(1.0, 1.0, 0.0))
433
+ >>> point = line.point(1.5)
434
+ >>> point.on_line(line)
435
+ True
436
+
437
+ """
438
+ return TOL.is_zero(self.distance_to_line(line), tol)
439
+
440
+ def on_segment(self, segment, tol=None):
441
+ """Determine if the point lies on the given segment.
442
+
443
+ Parameters
444
+ ----------
445
+ segment : [point, point] | :class:`compas.geometry.Line`
446
+ The segment.
447
+ tol : float, optional
448
+ A tolerance value for the distance between the point and the segment.
449
+ Default is :attr:`TOL.absolute`.
450
+
451
+ Returns
452
+ -------
453
+ bool
454
+ True, if the point lies on the segment.
455
+ False, otherwise.
456
+
457
+ Examples
458
+ --------
459
+ >>> from compas.geometry import Line
460
+ >>> line = Line(Point(1.0, 0.0, 0.0), Point(1.0, 1.0, 0.0))
461
+ >>> point = line.point(1.5)
462
+ >>> point.on_segment(line)
463
+ False
464
+
465
+ """
466
+ return is_point_on_segment(self, segment, tol=tol)
467
+
468
+ def on_polyline(self, polyline):
469
+ """Determine if the point lies on the given polyline.
470
+
471
+ Parameters
472
+ ----------
473
+ polyline : sequence[point] | :class:`compas.geometry.Polyline`
474
+ The polyline.
475
+
476
+ Returns
477
+ -------
478
+ bool
479
+ True, if the point lies on the polyline.
480
+ False, otherwise.
481
+
482
+ Examples
483
+ --------
484
+ >>> from compas.geometry import Polyline
485
+ >>> poly = Polyline([Point(0.0, 0.0, 0.0), Point(1.0, 0.0, 0.0), Point(2.0, 0.0, 0.0)])
486
+ >>> point = poly.point(0.5)
487
+ >>> point.on_polyline(poly)
488
+ True
489
+
490
+ """
491
+ return is_point_on_polyline(self, polyline)
492
+
493
+ def on_plane(self, plane, tol=None):
494
+ """Determine if the point lies on the given plane.
495
+
496
+ Parameters
497
+ ----------
498
+ plane : :class:`compas.geometry.Plane`
499
+ The plane.
500
+ tol : float, optional
501
+ A tolerance value for the distance between the point and the plane.
502
+ Default is :attr:`TOL.absolute`.
503
+
504
+ Returns
505
+ -------
506
+ bool
507
+ True, if the point lies on the plane.
508
+ False, otherwise.
509
+
510
+ Examples
511
+ --------
512
+ >>> from compas.geometry import Plane
513
+ >>> from compas.geometry import Vector
514
+ >>> plane = Plane(Point(0.0, 0.0, 0.0), Vector(0.0, 0.0, 1.0))
515
+ >>> point = Point(0.5, 0.5, 0.0)
516
+ >>> point.on_plane(plane)
517
+ True
518
+
519
+ """
520
+ return TOL.is_zero(self.distance_to_plane(plane), tol)
521
+
522
+ def on_circle(self, circle, tol=None):
523
+ """Determine if the point lies on the given circle.
524
+
525
+ Parameters
526
+ ----------
527
+ circle : :class:`compas.geometry.Circle`
528
+ The circle.
529
+ tol : float, optional
530
+ A tolerance value for the distance between the point and the circle.
531
+ Default is :attr:`TOL.absolute`.
532
+
533
+ Returns
534
+ -------
535
+ bool
536
+ True, if the point lies on the circle.
537
+ False, otherwise.
538
+
539
+ """
540
+ if not self.on_plane(circle.plane, tol):
541
+ return False
542
+ return TOL.is_close(self.distance_to_point(circle.center), circle.radius, rtol=0, atol=tol)
543
+
544
+ def on_curve(self, curve, tol=None):
545
+ """Determine if the point lies on the given curve.
546
+
547
+ Parameters
548
+ ----------
549
+ curve : :class:`compas.geometry.Curve`
550
+ The curve.
551
+ tol : float, optional
552
+ A tolerance value for the distance between the point and the curve.
553
+
554
+ Returns
555
+ -------
556
+ bool
557
+ True, if the point lies on the curve.
558
+ False, otherwise.
559
+
560
+ """
561
+ return TOL.is_zero(self.distance_to_point(curve.closest_point(self)), tol)
562
+
563
+ def in_triangle(self, triangle):
564
+ """Determine if the point lies inside the given triangle.
565
+
566
+ Parameters
567
+ ----------
568
+ triangle : [point, point, point] | :class:`compas.geometry.Polygon`
569
+ The triangle.
570
+
571
+ Returns
572
+ -------
573
+ bool
574
+ True, if the point lies in the triangle.
575
+ False, otherwise.
576
+
577
+ Examples
578
+ --------
579
+ >>> from compas.geometry import Polygon
580
+ >>> tri = Polygon([Point(0.0, 0.0, 0.0), Point(1.0, 0.0, 0.0), Point(0.5, 1.0, 0.0)])
581
+ >>> point = Point(0.5, 0.5, 0.0)
582
+ >>> point.in_triangle(tri)
583
+ True
584
+
585
+ """
586
+ return is_point_in_triangle(self, triangle)
587
+
588
+ def in_circle(self, circle):
589
+ """Determine if the point lies inside the given circle.
590
+
591
+ Parameters
592
+ ----------
593
+ circle : :class:`compas.geometry.Circle`
594
+ The circle.
595
+
596
+ Returns
597
+ -------
598
+ bool
599
+ True, if the point lies inside the circle.
600
+ False, otherwise.
601
+
602
+ Examples
603
+ --------
604
+ >>> from compas.geometry import Vector
605
+ >>> from compas.geometry import Plane
606
+ >>> from compas.geometry import Circle
607
+ >>> circle = Circle(Plane(Point(0.0, 0.0, 0.0), Vector(0.0, 0.0, 1.0)), 1.0)
608
+ >>> point = Point(0.5, 0.0, 0.0)
609
+ >>> point.in_circle(circle)
610
+ True
611
+
612
+ """
613
+ return is_point_in_circle(self, (circle.plane, circle.radius))
614
+
615
+ def in_polyhedron(self, polyhedron):
616
+ """Determine if the point lies inside the given polyhedron.
617
+
618
+ This method verifies that the point lies behind the planes of all the faces of the polyhedron.
619
+ Therefore, if the polyhedron is not convex, or if the faces are not planar, the result of this test is meaningless.
620
+ Convexity and planarity are not checked.
621
+
622
+ Parameters
623
+ ----------
624
+ polyhedron : [vertices, faces] | :class:`compas.geometry.Polyhedron`
625
+ The polyhedron.
626
+
627
+ Returns
628
+ -------
629
+ bool
630
+ True, if the point lies on the polyline.
631
+ False, otherwise.
632
+
633
+ """
634
+ vertices, faces = polyhedron
635
+ polygons = [[vertices[index] for index in face] for face in faces]
636
+ planes = [[centroid_points(polygon), normal_polygon(polygon)] for polygon in polygons]
637
+ return all(is_point_behind_plane(self, plane) for plane in planes)
638
+
639
+ # ==========================================================================
640
+ # Transformations
641
+ # ==========================================================================
642
+
643
+ def transform(self, T):
644
+ """Transform this point.
645
+
646
+ Parameters
647
+ ----------
648
+ T : :class:`compas.geometry.Transformation` | list[list[float]]
649
+ The transformation matrix.
650
+
651
+ Examples
652
+ --------
653
+ >>> from compas.geometry import Translation
654
+ >>> point = Point(0.0, 0.0, 0.0)
655
+ >>> T = Translation.from_vector([1.0, 1.0, 1.0])
656
+ >>> point.transform(T)
657
+ >>> point.x == 1.0
658
+ True
659
+
660
+ """
661
+ point = transform_points([self], T)[0]
662
+ self.x = point[0]
663
+ self.y = point[1]
664
+ self.z = point[2]