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,431 @@
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 Point
7
+ from compas.geometry import Vector
8
+ from compas.geometry import add_vectors
9
+
10
+ from .curve import Curve
11
+
12
+
13
+ class Line(Curve):
14
+ """A line is a curve defined by two points.
15
+
16
+ The first point is the start point of the line.
17
+ The second point is the end point of the line.
18
+ The vector between the two points defines the direction of the line.
19
+ The length of the vector is the length of the line.
20
+ The direction vector is the unit vector of the vector between start and end.
21
+ The parameterisation of the line is such that the start point corresponds to ``t = 0`` and the end point to ``t = 1``.
22
+
23
+ The coordinate system of a line is always the world coordinate system (WCS).
24
+ Transformation of a line is performed by transforming the start and end point.
25
+
26
+ Parameters
27
+ ----------
28
+ start : [float, float, float] | :class:`compas.geometry.Point`
29
+ The first point.
30
+ end : [float, float, float] | :class:`compas.geometry.Point`
31
+ The second point.
32
+ name : str, optional
33
+ The name of the line.
34
+
35
+ Attributes
36
+ ----------
37
+ start : :class:`compas.geometry.Point`
38
+ The start point of the line.
39
+ end : :class:`compas.geometry.Point`
40
+ The end point of the line.
41
+ vector : :class:`compas.geometry.Vector`, read-only
42
+ A vector pointing from start to end.
43
+ length : float, read-only
44
+ The length of the vector from start to end.
45
+ direction : :class:`compas.geometry.Vector`, read-only
46
+ A unit vector parallel to the line vector.
47
+ midpoint : :class:`compas.geometry.Point`, read-only
48
+ The midpoint between start and end.
49
+ frame : :class:`compas.geometry.Frame`, read-only
50
+ The frame of the line.
51
+ This is alsways the world XY frame.
52
+ transformation : :class:`compas.geometry.Transformation`, read-only
53
+ This is always the identity transformation.
54
+
55
+ Examples
56
+ --------
57
+ >>> line = Line([0, 0, 0], [1, 1, 1])
58
+ >>> line
59
+ Line(Point(0.000, 0.000, 0.000), Point(1.000, 1.000, 1.000))
60
+ >>> line.start
61
+ Point(0.000, 0.000, 0.000)
62
+ >>> line.midpoint
63
+ Point(0.500, 0.500, 0.500)
64
+ >>> line.length == math.sqrt(line.dx**2 + line.dy**2 + line.dz**2)
65
+ True
66
+ >>> line.direction
67
+ Vector(0.577, 0.577, 0.577)
68
+
69
+ """
70
+
71
+ # overwriting the __new__ method is necessary
72
+ # to avoid triggering the plugin mechanism of the base curve class
73
+ def __new__(cls, *args, **kwargs):
74
+ curve = object.__new__(cls)
75
+ curve.__init__(*args, **kwargs)
76
+ return curve
77
+
78
+ DATASCHEMA = {
79
+ "type": "object",
80
+ "properties": {
81
+ "start": Point.DATASCHEMA,
82
+ "end": Point.DATASCHEMA,
83
+ },
84
+ "required": ["start", "end"],
85
+ }
86
+
87
+ @property
88
+ def __data__(self):
89
+ return {"start": self.start.__data__, "end": self.end.__data__}
90
+
91
+ def __init__(self, start, end, name=None):
92
+ super(Line, self).__init__(name=name)
93
+ self._point = None
94
+ self._vector = None
95
+ self._direction = None
96
+ self.start = start
97
+ self.end = end
98
+
99
+ def __repr__(self):
100
+ return "{0}({1!r}, {2!r})".format(
101
+ type(self).__name__,
102
+ self.start,
103
+ self.end,
104
+ )
105
+
106
+ def __getitem__(self, key):
107
+ if key == 0:
108
+ return self.start
109
+ if key == 1:
110
+ return self.end
111
+ raise KeyError
112
+
113
+ def __setitem__(self, key, value):
114
+ if key == 0:
115
+ self.start = value
116
+ elif key == 1:
117
+ self.end = value
118
+ else:
119
+ raise KeyError
120
+
121
+ def __iter__(self):
122
+ return iter([self.start, self.end])
123
+
124
+ def __len__(self):
125
+ return 2
126
+
127
+ def __eq__(self, other):
128
+ try:
129
+ return self.start == other[0] and self.end == other[1]
130
+ except Exception:
131
+ return False
132
+
133
+ # ==========================================================================
134
+ # properties
135
+ # ==========================================================================
136
+
137
+ @property
138
+ def frame(self):
139
+ return Frame.worldXY()
140
+
141
+ @frame.setter
142
+ def frame(self, frame):
143
+ raise AttributeError("Setting the coordinate frame of a line is not supported.")
144
+
145
+ @property
146
+ def point(self):
147
+ if not self._point:
148
+ raise ValueError("The line has no base point.")
149
+ return self._point
150
+
151
+ @point.setter
152
+ def point(self, point):
153
+ self._point = Point(*point)
154
+
155
+ @property
156
+ def vector(self):
157
+ if not self._vector:
158
+ raise ValueError("The line has no direction vector.")
159
+ return self._vector
160
+
161
+ @vector.setter
162
+ def vector(self, vector):
163
+ self._vector = Vector(*vector)
164
+ self._direction = None
165
+
166
+ @property
167
+ def length(self):
168
+ return self.vector.length
169
+
170
+ @property
171
+ def direction(self):
172
+ if not self._direction:
173
+ self._direction = self.vector.unitized()
174
+ return self._direction
175
+
176
+ @property
177
+ def start(self):
178
+ return self.point
179
+
180
+ @start.setter
181
+ def start(self, point):
182
+ self.point = point
183
+
184
+ @property
185
+ def end(self):
186
+ return self.start + self.vector
187
+
188
+ @end.setter
189
+ def end(self, point):
190
+ self._vector = Vector.from_start_end(self.start, point)
191
+ self._direction = None
192
+
193
+ @property
194
+ def midpoint(self):
195
+ return self.point_at(0.5)
196
+
197
+ # ==========================================================================
198
+ # Constructors
199
+ # ==========================================================================
200
+
201
+ @classmethod
202
+ def from_point_and_vector(cls, point, vector):
203
+ """Construct a line from a point and a vector.
204
+
205
+ Parameters
206
+ ----------
207
+ point : :class:`compas.geometry.Point`
208
+ The start point of the line.
209
+ vector : :class:`compas.geometry.Vector`
210
+ The vector of the line.
211
+
212
+ Returns
213
+ -------
214
+ :class:`Line`
215
+ The constructed line.
216
+
217
+ See Also
218
+ --------
219
+ :meth:`Line.from_point_direction_length`
220
+
221
+ Examples
222
+ --------
223
+ >>> from compas.geometry import Point, Vector
224
+ >>> line = Line.from_point_and_vector(Point(0, 0, 0), Vector(1, 1, 1))
225
+ >>> line
226
+ Line(Point(0.000, 0.000, 0.000), Point(1.000, 1.000, 1.000))
227
+
228
+ """
229
+ return cls(point, add_vectors(point, vector))
230
+
231
+ @classmethod
232
+ def from_point_direction_length(cls, point, direction, length):
233
+ """Construct a line from a point, a direction and a length.
234
+
235
+ Parameters
236
+ ----------
237
+ point : :class:`compas.geometry.Point`
238
+ The start point of the line.
239
+ direction : :class:`compas.geometry.Vector`
240
+ The direction of the line.
241
+ length : float
242
+ The length of the line.
243
+
244
+ Returns
245
+ -------
246
+ :class:`Line`
247
+ The constructed line.
248
+
249
+ See Also
250
+ --------
251
+ :meth:`Line.from_point_and_vector`
252
+
253
+ Examples
254
+ --------
255
+ >>> from compas.geometry import Point, Vector
256
+ >>> line = Line.from_point_direction_length(Point(0, 0, 0), Vector(1, 1, 1), 1)
257
+ >>> line
258
+ Line(Point(0.000, 0.000, 0.000), Point(0.577, 0.577, 0.577))
259
+
260
+ """
261
+ direction = Vector(*direction)
262
+ direction.unitize()
263
+ return cls(point, add_vectors(point, direction * length))
264
+
265
+ # ==========================================================================
266
+ # Transformations
267
+ # ==========================================================================
268
+
269
+ def transform(self, T):
270
+ """Transform this line.
271
+
272
+ Parameters
273
+ ----------
274
+ T : :class:`compas.geometry.Transformation`
275
+ The transformation.
276
+
277
+ Returns
278
+ -------
279
+ None
280
+
281
+ Examples
282
+ --------
283
+ >>> from math import radians
284
+ >>> from compas.geometry import Rotation
285
+ >>> line = Line([0.0, 0.0, 0.0], [1.0, 0.0, 0.0])
286
+ >>> R = Rotation.from_axis_and_angle([0.0, 0.0, 1.0], radians(90))
287
+ >>> line.transform(R)
288
+ >>> line.end
289
+ Point(0.000, 1.000, 0.000)
290
+
291
+ """
292
+ self.point.transform(T)
293
+ self.vector.transform(T)
294
+
295
+ # ==========================================================================
296
+ # Methods
297
+ # ==========================================================================
298
+
299
+ def point_at(self, t):
300
+ """Construct a point along the line at a fractional position.
301
+
302
+ Parameters
303
+ ----------
304
+ t : float
305
+ The relative position along the line as a fraction of the length of the line.
306
+ 0.0 corresponds to the start point and 1.0 corresponds to the end point.
307
+ Numbers outside of this range are also valid and correspond to points beyond the start and end point.
308
+
309
+ Returns
310
+ -------
311
+ :class:`compas.geometry.Point`
312
+ The point at the specified position.
313
+
314
+ See Also
315
+ --------
316
+ :meth:`tangent_at`
317
+
318
+ Examples
319
+ --------
320
+ >>> line = Line([0, 0, 0], [1, 1, 1])
321
+ >>> line.point_at(0.5)
322
+ Point(0.500, 0.500, 0.500)
323
+
324
+ """
325
+ point = self.point + self.vector * t
326
+ return point
327
+
328
+ def point_from_start(self, distance):
329
+ """Construct a point along the line at a distance from the start point.
330
+
331
+ Parameters
332
+ ----------
333
+ distance : float
334
+ The distance along the line from the start point towards the end point.
335
+ If the distance is negative, the point is constructed in the opposite direction of the end point.
336
+ If the distance is larger than the length of the line, the point is constructed beyond the end point.
337
+
338
+ Returns
339
+ -------
340
+ :class:`compas.geometry.Point`
341
+ The point at the specified distance.
342
+
343
+ """
344
+ point = self.point + self.direction * distance
345
+ return point
346
+
347
+ def point_from_end(self, distance):
348
+ """Construct a point along the line at a distance from the end point.
349
+
350
+ Parameters
351
+ ----------
352
+ distance : float
353
+ The distance along the line from the end point towards the start point.
354
+ If the distance is negative, the point is constructed in the opposite direction of the start point.
355
+ If the distance is larger than the length of the line, the point is constructed beyond the start point.
356
+
357
+ Returns
358
+ -------
359
+ :class:`compas.geometry.Point`
360
+ The point at the specified distance.
361
+
362
+ """
363
+ point = self.end - self.direction * distance
364
+ return point
365
+
366
+ def closest_point(self, point, return_parameter=False):
367
+ """Compute the closest point on the line to a given point.
368
+
369
+ Parameters
370
+ ----------
371
+ point : :class:`compas.geometry.Point`
372
+ The point.
373
+ return_parameter : bool, optional
374
+ Return the parameter of the closest point on the line.
375
+ Default is ``False``.
376
+
377
+ Returns
378
+ -------
379
+ :class:`compas.geometry.Point`
380
+ The closest point on the line.
381
+ float
382
+ The parameter of the closest point on the line.
383
+ Only if ``return_parameter`` is ``True``.
384
+
385
+ """
386
+ vector = point - self.start
387
+ t = vector.dot(self.vector) / self.length**2
388
+ closest = self.start + self.vector * t
389
+ if return_parameter:
390
+ return closest, t
391
+ return closest
392
+
393
+ def flip(self):
394
+ """Flip the direction of the line.
395
+
396
+ Returns
397
+ -------
398
+ None
399
+
400
+ Examples
401
+ --------
402
+ >>> line = Line([0, 0, 0], [1, 2, 3])
403
+ >>> line
404
+ Line(Point(x=0.0, y=0.0, z=0.0), Point(x=1.0, y=2.0, z=3.0))
405
+ >>> line.flip()
406
+ >>> line
407
+ Line(Point(x=1.0, y=2.0, z=3.0), Point(x=0.0, y=0.0, z=0.0))
408
+
409
+ """
410
+ new_vector = self.vector.inverted()
411
+ self.start = self.end
412
+ self.vector = new_vector
413
+
414
+ def flipped(self):
415
+ """Return a new line with the direction flipped.
416
+
417
+ Returns
418
+ -------
419
+ :class:`Line`
420
+ A new line.
421
+
422
+ Examples
423
+ --------
424
+ >>> line = Line([0, 0, 0], [1, 2, 3])
425
+ >>> line
426
+ Line(Point(x=0.0, y=0.0, z=0.0), Point(x=1.0, y=2.0, z=3.0))
427
+ >>> line.flipped()
428
+ Line(Point(x=1.0, y=2.0, z=3.0), Point(x=0.0, y=0.0, z=0.0))
429
+
430
+ """
431
+ return Line(self.end, self.start)