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,408 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ from math import cos
6
+ from math import pi
7
+ from math import sin
8
+ from math import sqrt
9
+
10
+ from compas.geometry import Frame
11
+ from compas.geometry import Point
12
+ from compas.geometry import Vector
13
+
14
+ from .conic import Conic
15
+ from .line import Line
16
+
17
+ PI2 = 2 * pi
18
+
19
+
20
+ class Ellipse(Conic):
21
+ """An ellipse is a curve defined by a coordinate system and a major and minor axis.
22
+
23
+ The centre of the ellipse is at the origin of the coordinate system.
24
+ The major axis is parallel to the local x-axis.
25
+ The minor axis is parallel to the local y-axis.
26
+ The parameter domain of an ellipse is ``[0, 2*pi]``.
27
+ Moving along the ellipse in the parameter direction corresponds to moving counter-clockwise around the origin of the local coordinate system.
28
+
29
+ Parameters
30
+ ----------
31
+ major : float
32
+ The major of the ellipse.
33
+ minor : float
34
+ The minor of the ellipse.
35
+ frame : :class:`compas.geometry.Frame`, optional
36
+ The local coordinate system of the ellipse.
37
+ The default value is ``None``, in which case the ellipse is constructed in the XY plane of the world coordinate system.
38
+ name : str, optional
39
+ The name of the ellipse.
40
+
41
+ Attributes
42
+ ----------
43
+ frame : :class:`compas.geometry.Frame`
44
+ The coordinate frame of the ellipse.
45
+ transformation : :class:`Transformation`, read-only
46
+ The transformation from the local coordinate system of the ellipse (:attr:`frame`) to the world coordinate system.
47
+ major : float
48
+ The major of the ellipse.
49
+ minor : float
50
+ The minor of the ellipse.
51
+ plane : :class:`compas.geometry.Plane`, read-only
52
+ The plane of the ellipse.
53
+ area : float, read-only
54
+ The area of the ellipse.
55
+ circumference : float, read-only
56
+ The length of the circumference of the ellipse.
57
+ semifocal : float, read-only
58
+ The semi-focal distance of the ellipse.
59
+ This is the distance from the center of the ellipse to the focus points.
60
+ focal : float, read-only
61
+ The distance between the two focus points.
62
+ eccentricity : float, read-only
63
+ The eccentricity of the ellipse.
64
+ This is the ratio between the semifocal length to the length of the semi-major axis.
65
+ focus1 : :class:`compas.geometry.Point`, read-only
66
+ The first focus point of the ellipse.
67
+ focus2 : :class:`compas.geometry.Point`, read-only
68
+ The second focus point of the ellipse.
69
+ directix1 : :class:`compas.geometry.Line`, read-only
70
+ The first directix of the ellipse.
71
+ The directix is perpendicular to the major axis
72
+ and passes through a point at a distance ``major **2 / semifocal`` along the positive xaxis from the center of the ellipse.
73
+ directix2 : :class:`compas.geometry.Line`, read-only
74
+ The second directix of the ellipse.
75
+ The directix is perpendicular to the major axis
76
+ and passes through a point at a distance ``major **2 / semifocal`` along the negative xaxis from the center of the ellipse.
77
+ is_closed : bool, read-only
78
+ True.
79
+ is_periodic : bool, read-only
80
+ True.
81
+ is_circle : bool, read-only
82
+ True if the ellipse is a circle.
83
+
84
+ See Also
85
+ --------
86
+ :class:`compas.geometry.Circle`, :class:`compas.geometry.Hyperbola`, :class:`compas.geometry.Parabola`
87
+
88
+ Examples
89
+ --------
90
+ Construct an ellipse in the world XY plane.
91
+
92
+ >>> from compas.geometry import Frame, Ellipse
93
+ >>> ellipse = Ellipse(major=3, minor=2, frame=Frame.worldXY())
94
+ >>> ellipse = Ellipse(major=3, minor=2)
95
+
96
+ Construct an ellipse such that its normal aligns with a given line.
97
+
98
+ >>> from compas.geometry import Line, Frame, Plane, Ellipse
99
+ >>> line = Line([0, 0, 0], [1, 1, 1])
100
+ >>> plane = Plane(line.end, line.direction)
101
+ >>> ellipse = Ellipse.from_plane_major_minor(plane, 3, 2)
102
+ >>> ellipse = Ellipse(major=3, minor=2, frame=Frame.from_plane(plane))
103
+
104
+ Visualise the line, ellipse, and frame of the ellipse with the COMPAS viewer.
105
+
106
+ >>> from compas_viewer import Viewer # doctest: +SKIP
107
+ >>> viewer = Viewer() # doctest: +SKIP
108
+ >>> viewer.scene.add(line) # doctest: +SKIP
109
+ >>> viewer.scene.add(ellipse) # doctest: +SKIP
110
+ >>> viewer.scene.add(ellipse.frame) # doctest: +SKIP
111
+ >>> viewer.show() # doctest: +SKIP
112
+
113
+ """
114
+
115
+ DATASCHEMA = {
116
+ "type": "object",
117
+ "properties": {
118
+ "major": {"type": "number", "minimum": 0},
119
+ "minor": {"type": "number", "minimum": 0},
120
+ "frame": Frame.DATASCHEMA,
121
+ },
122
+ "required": ["major", "minor", "frame"],
123
+ }
124
+
125
+ @property
126
+ def __data__(self):
127
+ return {
128
+ "major": self.major,
129
+ "minor": self.minor,
130
+ "frame": self.frame.__data__,
131
+ }
132
+
133
+ @classmethod
134
+ def __from_data__(cls, data):
135
+ return cls(
136
+ major=data["major"],
137
+ minor=data["minor"],
138
+ frame=Frame.__from_data__(data["frame"]),
139
+ )
140
+
141
+ def __init__(self, major=1.0, minor=1.0, frame=None, name=None):
142
+ super(Ellipse, self).__init__(frame=frame, name=name)
143
+ self._major = None
144
+ self._minor = None
145
+ self.major = major
146
+ self.minor = minor
147
+
148
+ def __repr__(self):
149
+ return "{0}(major={1!r}, minor={2}, frame={3!r})".format(
150
+ type(self).__name__,
151
+ self.major,
152
+ self.minor,
153
+ self.frame,
154
+ )
155
+
156
+ def __eq__(self, other):
157
+ try:
158
+ other_frame = other.frame
159
+ other_major = other.major
160
+ other_minor = other.minor
161
+ except Exception:
162
+ return False
163
+ return self.major == other_major and self.minor == other_minor, self.frame == other_frame
164
+
165
+ # ==========================================================================
166
+ # Properties
167
+ # ==========================================================================
168
+
169
+ @property
170
+ def center(self):
171
+ return self.frame.point
172
+
173
+ @center.setter
174
+ def center(self, point):
175
+ self.frame.point = point
176
+
177
+ @property
178
+ def major(self):
179
+ if self._major is None:
180
+ raise ValueError("Length of major axis is not set.")
181
+ return self._major
182
+
183
+ @major.setter
184
+ def major(self, major):
185
+ if major < 0:
186
+ raise ValueError("Major axis length cannot be negative.")
187
+ self._major = float(major)
188
+
189
+ @property
190
+ def minor(self):
191
+ if self._minor is None:
192
+ raise ValueError("Length of minor axis is not set.")
193
+ return self._minor
194
+
195
+ @minor.setter
196
+ def minor(self, minor):
197
+ if minor < 0:
198
+ raise ValueError("Minor axis length cannot be negative.")
199
+ self._minor = float(minor)
200
+
201
+ @property
202
+ def semifocal(self):
203
+ return sqrt(self.major**2 - self.minor**2)
204
+
205
+ @property
206
+ def focal(self):
207
+ return 2 * self.semifocal
208
+
209
+ @property
210
+ def eccentricity(self):
211
+ return self.semifocal / self.major
212
+
213
+ @property
214
+ def focus1(self):
215
+ return self.frame.point + self.frame.xaxis * +self.semifocal
216
+
217
+ @property
218
+ def focus2(self):
219
+ return self.frame.point + self.frame.xaxis * -self.semifocal
220
+
221
+ @property
222
+ def vertex1(self):
223
+ return self.frame.point + self.frame.xaxis * self.major
224
+
225
+ @property
226
+ def vertex2(self):
227
+ return self.frame.point + self.frame.xaxis * -self.major
228
+
229
+ @property
230
+ def directix1(self):
231
+ d1 = self.major**2 / self.semifocal
232
+ p1 = self.frame.point + self.frame.xaxis * +d1
233
+ return Line.from_point_and_vector(p1, self.frame.yaxis)
234
+
235
+ @property
236
+ def directix2(self):
237
+ d2 = self.major**2 / self.semifocal
238
+ p2 = self.frame.point + self.frame.xaxis * -d2
239
+ return Line.from_point_and_vector(p2, self.frame.yaxis)
240
+
241
+ @property
242
+ def area(self):
243
+ return pi * self.major * self.minor
244
+
245
+ @property
246
+ def circumference(self):
247
+ raise NotImplementedError
248
+
249
+ @property
250
+ def is_circle(self):
251
+ return self.major == self.minor
252
+
253
+ @property
254
+ def is_closed(self):
255
+ return True
256
+
257
+ @property
258
+ def is_periodic(self):
259
+ return True
260
+
261
+ # ==========================================================================
262
+ # Constructors
263
+ # ==========================================================================
264
+
265
+ @classmethod
266
+ def from_point_major_minor(cls, point, major, minor):
267
+ """Construct a ellipse from a point and major and minor axis lengths.
268
+
269
+ Parameters
270
+ ----------
271
+ point : :class:`compas.geometry.Point`
272
+ The center point of the ellipse.
273
+ major : float
274
+ The major axis length.
275
+ minor : float
276
+ The minor axis length.
277
+
278
+ Returns
279
+ -------
280
+ :class:`Ellipse`
281
+ The constructed ellipse.
282
+
283
+ """
284
+ frame = Frame(point, [1, 0, 0], [0, 1, 0])
285
+ return cls(major=major, minor=minor, frame=frame)
286
+
287
+ @classmethod
288
+ def from_plane_major_minor(cls, plane, major, minor):
289
+ """Construct a ellipse from a point and major and minor axis lengths.
290
+
291
+ Parameters
292
+ ----------
293
+ plane : :class:`compas.geometry.Plane`
294
+ The plane of the ellipse.
295
+ major : float
296
+ The major axis length.
297
+ minor : float
298
+ The minor axis length.
299
+
300
+ Returns
301
+ -------
302
+ :class:`Ellipse`
303
+ The constructed ellipse.
304
+
305
+ """
306
+ frame = Frame.from_plane(plane)
307
+ return cls(major=major, minor=minor, frame=frame)
308
+
309
+ # ==========================================================================
310
+ # Methods
311
+ # ==========================================================================
312
+
313
+ def point_at(self, t, world=True):
314
+ """Compute the point at a specific parameter.
315
+
316
+ Parameters
317
+ ----------
318
+ t : float
319
+ The parameter value.
320
+ world : bool, optional
321
+ If ``True``, the point is returned in world coordinates.
322
+
323
+ Returns
324
+ -------
325
+ :class:`compas.geometry.Point`
326
+ The point at the parameter.
327
+
328
+ See Also
329
+ --------
330
+ :meth:`normal_at`, :meth:`tangent_at`
331
+
332
+ Notes
333
+ -----
334
+ The location of the point is expressed with respect to the world coordinate system.
335
+
336
+ """
337
+ t = t * PI2
338
+ x = self.major * cos(t)
339
+ y = self.minor * sin(t)
340
+ point = Point(x, y, 0)
341
+ if world:
342
+ point.transform(self.transformation)
343
+ return point
344
+
345
+ def tangent_at(self, t, world=True):
346
+ """Compute the tangent at a specific parameter.
347
+
348
+ Parameters
349
+ ----------
350
+ t : float
351
+ The parameter value.
352
+ world : bool, optional
353
+ If ``True``, the tangent is returned in world coordinates.
354
+
355
+ Returns
356
+ -------
357
+ :class:`compas.geometry.Vector`
358
+ The tangent vector at the parameter.
359
+
360
+ See Also
361
+ --------
362
+ :meth:`point_at`, :meth:`normal_at`
363
+
364
+ Notes
365
+ -----
366
+ The orientation of the vector is expressed with respect to the world coordinate system.
367
+
368
+ """
369
+ normal = self.normal_at(t, world=False)
370
+ zaxis = Vector(0, 0, 1)
371
+ tangent = normal.cross(zaxis)
372
+ tangent.unitize()
373
+ if world:
374
+ tangent.transform(self.transformation)
375
+ return tangent
376
+
377
+ def normal_at(self, t, world=True):
378
+ """Compute the normal at a specific parameter.
379
+
380
+ Parameters
381
+ ----------
382
+ t : float
383
+ The parameter value.
384
+ world : bool, optional
385
+ If ``True``, the normal is returned in world coordinates.
386
+
387
+ Returns
388
+ -------
389
+ :class:`compas.geometry.Vector`
390
+ The normal vector at the parameter.
391
+
392
+ See Also
393
+ --------
394
+ :meth:`point_at`, :meth:`tangent_at`
395
+
396
+ Notes
397
+ -----
398
+ The orientation of the vector is expressed with respect to the world coordinate system.
399
+
400
+ """
401
+ point = self.point_at(t, world=False)
402
+ f1 = Point(+self.semifocal, 0, 0)
403
+ f2 = Point(-self.semifocal, 0, 0)
404
+ normal = (f1 - point).unitized() + (f2 - point).unitized()
405
+ normal.unitize()
406
+ if world:
407
+ normal.transform(self.transformation)
408
+ return normal