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,354 @@
1
+ """
2
+ This library for transformations partly derived and was re-implemented from the
3
+ following online resources:
4
+
5
+ * http://www.lfd.uci.edu/~gohlke/code/transformations.py.html
6
+ * http://www.euclideanspace.com/maths/geometry/rotations/
7
+ * http://code.activestate.com/recipes/578108-determinant-of-matrix-of-any-order/
8
+ * http://blog.acipo.com/matrix-inversion-in-javascript/
9
+
10
+ Many thanks to Christoph Gohlke, Martin John Baker, Sachin Joglekar and Andrew
11
+ Ippoliti for providing code and documentation.
12
+ """
13
+
14
+ from compas.geometry import Transformation
15
+ from compas.geometry import axis_and_angle_from_matrix
16
+ from compas.geometry import basis_vectors_from_matrix
17
+ from compas.geometry import cross_vectors
18
+ from compas.geometry import decompose_matrix
19
+ from compas.geometry import euler_angles_from_matrix
20
+ from compas.geometry import length_vector
21
+ from compas.geometry import matrix_from_axis_and_angle
22
+ from compas.geometry import matrix_from_euler_angles
23
+ from compas.geometry import matrix_from_frame
24
+ from compas.geometry import matrix_from_quaternion
25
+ from compas.geometry import normalize_vector
26
+ from compas.itertools import flatten
27
+ from compas.tolerance import TOL
28
+
29
+
30
+ class Rotation(Transformation):
31
+ """Class representing a rotation transformation.
32
+
33
+ The class contains methods for converting rotation matrices to axis-angle
34
+ representations, Euler angles, quaternion and basis vectors.
35
+
36
+ Parameters
37
+ ----------
38
+ matrix : list[list[float]], optional
39
+ A 4x4 matrix (or similar) representing a rotation.
40
+ check : bool, optional
41
+ If ``True``, the provided matrix will be checked for validity.
42
+ name : str, optional
43
+ The name of the transformation.
44
+
45
+ Attributes
46
+ ----------
47
+ quaternion : :class:`compas.geometry.Quaternion`, read-only
48
+ The quaternion from the rotation.
49
+ axis_and_angle : tuple[:class:`compas.geometry.Vector`, float], read-only
50
+ The axis and the angle of the rotation.
51
+ axis_angle_vector : :class:`compas.geometry.Vector`, read-only
52
+ The axis-angle vector of the rotation.
53
+ basis_vectors : tuple[:class:`compas.geometry.Vector`, :class:`compas.geometry.Vector`], read-only
54
+ The basis vectors of the rotation.
55
+
56
+ Raises
57
+ ------
58
+ ValueError
59
+ If ``check`` is ``True`` and the provided transformation matrix is not a rotation.
60
+
61
+ Examples
62
+ --------
63
+ >>> from compas.geometry import Frame
64
+ >>> f1 = Frame([0, 0, 0], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
65
+ >>> R = Rotation.from_frame(f1)
66
+ >>> args = False, "xyz"
67
+ >>> alpha, beta, gamma = R.euler_angles(*args)
68
+ >>> xaxis, yaxis, zaxis = [1, 0, 0], [0, 1, 0], [0, 0, 1]
69
+ >>> Rx = Rotation.from_axis_and_angle(xaxis, alpha)
70
+ >>> Ry = Rotation.from_axis_and_angle(yaxis, beta)
71
+ >>> Rz = Rotation.from_axis_and_angle(zaxis, gamma)
72
+ >>> f2 = Frame.worldXY()
73
+ >>> f1 == f2.transformed(Rx * Ry * Rz)
74
+ True
75
+
76
+ """
77
+
78
+ def __init__(self, matrix=None, check=False, name=None):
79
+ if matrix and check:
80
+ _, _, angles, _, _ = decompose_matrix(matrix)
81
+ if not TOL.is_allclose(flatten(matrix), flatten(matrix_from_euler_angles(angles))):
82
+ raise ValueError("This is not a proper rotation matrix.")
83
+ super(Rotation, self).__init__(matrix=matrix, name=name)
84
+
85
+ @property
86
+ def quaternion(self):
87
+ from compas.geometry import Quaternion
88
+
89
+ return Quaternion.from_matrix(self.matrix)
90
+
91
+ @property
92
+ def axis_and_angle(self):
93
+ from compas.geometry import Vector
94
+
95
+ axis, angle = axis_and_angle_from_matrix(self.matrix)
96
+ return Vector(*axis), angle
97
+
98
+ @property
99
+ def axis_angle_vector(self):
100
+ axis, angle = self.axis_and_angle
101
+ return axis.scaled(angle)
102
+
103
+ @property
104
+ def basis_vectors(self):
105
+ from compas.geometry import Vector
106
+
107
+ xaxis, yaxis = basis_vectors_from_matrix(self.matrix)
108
+ return Vector(*xaxis), Vector(*yaxis)
109
+
110
+ @classmethod
111
+ def from_axis_and_angle(cls, axis, angle, point=[0, 0, 0]):
112
+ """Construct a rotation transformation from a rotation axis and an angle and an optional point of rotation.
113
+
114
+ The rotation is based on the right hand rule, i.e. anti-clockwise if the
115
+ axis of rotation points towards the observer.
116
+
117
+ Parameters
118
+ ----------
119
+ axis : [float, float, float] | :class:`compas.geometry.Vector`
120
+ Three numbers that represent the axis of rotation.
121
+ angle : float
122
+ The rotation angle in radians.
123
+ point : [float, float, float] | :class:`compas.geometry.Point`
124
+ A point to perform a rotation around an origin other than [0, 0, 0].
125
+
126
+ Returns
127
+ -------
128
+ :class:`compas.geometry.Rotation`
129
+
130
+ Notes
131
+ -----
132
+ The rotation is based on the right hand rule, i.e. anti-clockwise
133
+ if the axis of rotation points towards the observer.
134
+
135
+ Examples
136
+ --------
137
+ >>> axis1 = normalize_vector([-0.043, -0.254, 0.617])
138
+ >>> angle1 = 0.1
139
+ >>> R = Rotation.from_axis_and_angle(axis1, angle1)
140
+ >>> axis2, angle2 = R.axis_and_angle
141
+ >>> allclose(axis1, axis2)
142
+ True
143
+ >>> allclose([angle1], [angle2])
144
+ True
145
+
146
+ """
147
+ matrix = matrix_from_axis_and_angle(axis, angle, point=point)
148
+ return cls(matrix)
149
+
150
+ @classmethod
151
+ def from_basis_vectors(cls, xaxis, yaxis):
152
+ """Construct a rotation transformation from basis vectors (= orthonormal vectors).
153
+
154
+ Parameters
155
+ ----------
156
+ xaxis : [float, float, float] | :class:`compas.geometry.Vector`
157
+ The x-axis of the frame.
158
+ yaxis : [float, float, float] | :class:`compas.geometry.Vector`
159
+ The y-axis of the frame.
160
+
161
+ Returns
162
+ -------
163
+ :class:`compas.geometry.Rotation`
164
+
165
+ Examples
166
+ --------
167
+ >>> xaxis = [0.68, 0.68, 0.27]
168
+ >>> yaxis = [-0.67, 0.73, -0.15]
169
+ >>> R = Rotation.from_basis_vectors(xaxis, yaxis)
170
+
171
+ """
172
+ xaxis = normalize_vector(list(xaxis))
173
+ yaxis = normalize_vector(list(yaxis))
174
+ zaxis = cross_vectors(xaxis, yaxis)
175
+ yaxis = cross_vectors(zaxis, xaxis)
176
+ matrix = [
177
+ [xaxis[0], yaxis[0], zaxis[0], 0],
178
+ [xaxis[1], yaxis[1], zaxis[1], 0],
179
+ [xaxis[2], yaxis[2], zaxis[2], 0],
180
+ [0, 0, 0, 1],
181
+ ]
182
+ return cls(matrix)
183
+
184
+ @classmethod
185
+ def from_frame(cls, frame):
186
+ """Construct a rotation transformationn from world XY to frame.
187
+
188
+ Parameters
189
+ ----------
190
+ frame : [point, vector, vector] | :class:`compas.geometry.Frame`
191
+ A frame describing the targeted Cartesian coordinate system.
192
+
193
+ Returns
194
+ -------
195
+ :class:`compas.geometry.Rotation`
196
+
197
+ Notes
198
+ -----
199
+ Creating a rotation from a frame means that we omit all translational
200
+ components. If that is unwanted, use ``Transformation.from_frame(frame)``.
201
+
202
+ Examples
203
+ --------
204
+ >>> from compas.geometry import Frame
205
+ >>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
206
+ >>> T = Transformation.from_frame(f1)
207
+ >>> f2 = Frame.from_transformation(T)
208
+ >>> f1 == f2
209
+ True
210
+
211
+ """
212
+ matrix = matrix_from_frame(frame)
213
+ matrix[0][3] = 0.0
214
+ matrix[1][3] = 0.0
215
+ matrix[2][3] = 0.0
216
+ return cls(matrix)
217
+
218
+ @classmethod
219
+ def from_quaternion(cls, quaternion):
220
+ """Construct a rotation transformation` from quaternion coefficients.
221
+
222
+ Parameters
223
+ ----------
224
+ quaternion : [float, float, float, float] | :class:`compas.geometry.Quaternion`
225
+ Four numbers that represents the four coefficient values of a quaternion.
226
+
227
+ Returns
228
+ -------
229
+ :class:`compas.geometry.Rotation`
230
+
231
+ Examples
232
+ --------
233
+ >>> from compas.tolerance import TOL
234
+ >>> q1 = [0.945, -0.021, -0.125, 0.303]
235
+ >>> R = Rotation.from_quaternion(q1)
236
+ >>> q2 = R.quaternion
237
+ >>> TOL.is_allclose(q1, q2)
238
+ True
239
+
240
+ """
241
+ matrix = matrix_from_quaternion(quaternion)
242
+ return cls(matrix)
243
+
244
+ @classmethod
245
+ def from_axis_angle_vector(cls, axis_angle_vector, point=[0, 0, 0]):
246
+ """Construct a rotation transformation from an axis-angle vector.
247
+
248
+ Parameters
249
+ ----------
250
+ axis_angle_vector : [float, float, float] | :class:`compas.geometry.Vector`
251
+ Three numbers that represent the axis of rotation and angle of rotation through the vector's magnitude.
252
+ point : [float, float, float] | :class:`compas.geometry.Point`, optional
253
+ A point to perform a rotation around an origin other than [0, 0, 0].
254
+
255
+ Returns
256
+ -------
257
+ :class:`compas.geometry.Rotation`
258
+
259
+ Examples
260
+ --------
261
+ >>> from compas.tolerance import TOL
262
+ >>> aav1 = [-0.043, -0.254, 0.617]
263
+ >>> R = Rotation.from_axis_angle_vector(aav1)
264
+ >>> aav2 = R.axis_angle_vector
265
+ >>> TOL.is_allclose(aav1, aav2)
266
+ True
267
+
268
+ """
269
+ angle = length_vector(axis_angle_vector)
270
+ return cls.from_axis_and_angle(axis_angle_vector, angle, point)
271
+
272
+ # why is this repeated here?
273
+ @classmethod
274
+ def from_euler_angles(cls, euler_angles, static=True, axes="xyz", **kwargs):
275
+ """Construct a rotation transformation from Euler angles.
276
+
277
+ In 3D space any orientation can be achieved by composing three
278
+ elemental rotations, rotations about the axes (x,y,z) of a coordinate
279
+ system. A triple of Euler angles can be interpreted in 24 ways, which
280
+ depends on if the rotations are applied to a static (extrinsic) or
281
+ rotating (intrinsic) frame and the order of axes.
282
+
283
+ Parameters
284
+ ----------
285
+ euler_angles: [float, float, float]
286
+ Three numbers that represent the angles of rotations about the
287
+ defined axes.
288
+ static: bool, optional
289
+ If True the rotations are applied to a static frame.
290
+ If False, to a rotational.
291
+ axes: str, optional
292
+ A 3 character string specifying order of the axes.
293
+
294
+ Returns
295
+ -------
296
+ :class:`compas.geometry.Rotation`
297
+
298
+ Examples
299
+ --------
300
+ >>> from compas.tolerance import TOL
301
+ >>> ea1 = 1.4, 0.5, 2.3
302
+ >>> args = False, "xyz"
303
+ >>> R1 = Rotation.from_euler_angles(ea1, *args)
304
+ >>> ea2 = R1.euler_angles(*args)
305
+ >>> TOL.is_allclose(ea1, ea2)
306
+ True
307
+
308
+ >>> alpha, beta, gamma = ea1
309
+ >>> xaxis, yaxis, zaxis = [1, 0, 0], [0, 1, 0], [0, 0, 1]
310
+ >>> Rx = Rotation.from_axis_and_angle(xaxis, alpha)
311
+ >>> Ry = Rotation.from_axis_and_angle(yaxis, beta)
312
+ >>> Rz = Rotation.from_axis_and_angle(zaxis, gamma)
313
+ >>> R2 = Rx * Ry * Rz
314
+ >>> R1 == R2
315
+ True
316
+
317
+ """
318
+ return super(Rotation, cls).from_euler_angles(euler_angles, static, axes)
319
+
320
+ # split up into two properties
321
+ # euler_angles
322
+ # rotating_euler_angles
323
+ # xyz seems irelevant
324
+ # could be added to base Transformation
325
+ # always relevant
326
+ def euler_angles(self, static=True, axes="xyz"):
327
+ """Returns Euler angles from the rotation according to specified
328
+ axis sequence and rotation type.
329
+
330
+ Parameters
331
+ ----------
332
+ static : bool, optional
333
+ If True the rotations are applied to a static frame.
334
+ If False, to a rotational.
335
+ axes : str, optional
336
+ A 3 character string specifying the order of the axes.
337
+
338
+ Returns
339
+ -------
340
+ [float, float, float]
341
+ The 3 Euler angles.
342
+
343
+ Examples
344
+ --------
345
+ >>> from compas.tolerance import TOL
346
+ >>> ea1 = 1.4, 0.5, 2.3
347
+ >>> args = False, "xyz"
348
+ >>> R1 = Rotation.from_euler_angles(ea1, *args)
349
+ >>> ea2 = R1.euler_angles(*args)
350
+ >>> TOL.is_allclose(ea1, ea2)
351
+ True
352
+
353
+ """
354
+ return euler_angles_from_matrix(self.matrix, static, axes)
@@ -0,0 +1,100 @@
1
+ """
2
+ This library for transformations partly derived and was re-implemented from the
3
+ following online resources:
4
+
5
+ * http://www.lfd.uci.edu/~gohlke/code/transformations.py.html
6
+ * http://www.euclideanspace.com/maths/geometry/rotations/
7
+ * http://code.activestate.com/recipes/578108-determinant-of-matrix-of-any-order/
8
+ * http://blog.acipo.com/matrix-inversion-in-javascript/
9
+
10
+ Many thanks to Christoph Gohlke, Martin John Baker, Sachin Joglekar and Andrew
11
+ Ippoliti for providing code and documentation.
12
+ """
13
+
14
+ from compas.geometry import Transformation
15
+ from compas.geometry import decompose_matrix
16
+ from compas.geometry import matrix_from_frame
17
+ from compas.geometry import matrix_from_scale_factors
18
+ from compas.geometry import matrix_inverse
19
+ from compas.geometry import multiply_matrices
20
+ from compas.itertools import flatten
21
+ from compas.tolerance import TOL
22
+
23
+
24
+ class Scale(Transformation):
25
+ """Class representing a scale transformation.
26
+
27
+ Parameters
28
+ ----------
29
+ matrix : list[list[float]], optional
30
+ A 4x4 matrix (or similar) representing a scaling.
31
+ check : bool, optional
32
+ If ``True``, the provided matrix will be checked for validity.
33
+ name : str, optional
34
+ The name of the transformation.
35
+
36
+ Raises
37
+ ------
38
+ ValueError
39
+ If ``check`` is ``True`` and the provided transformation matrix is not a scale matrix.
40
+
41
+ Examples
42
+ --------
43
+ >>> S = Scale.from_factors([1, 2, 3])
44
+ >>> S[0, 0] == 1
45
+ True
46
+ >>> S[1, 1] == 2
47
+ True
48
+ >>> S[2, 2] == 3
49
+ True
50
+
51
+ >>> from compas.geometry import Point, Frame
52
+ >>> point = Point(2, 5, 0)
53
+ >>> frame = Frame(point, (1, 0, 0), (0, 1, 0))
54
+ >>> points = [point, Point(2, 10, 0)]
55
+ >>> S = Scale.from_factors([2.0] * 3, frame)
56
+ >>> [p.transformed(S) for p in points]
57
+ [Point(2.000, 5.000, 0.000), Point(2.000, 15.000, 0.000)]
58
+
59
+ """
60
+
61
+ def __init__(self, matrix=None, check=False, name=None):
62
+ if matrix and check:
63
+ scale, _, _, _, _ = decompose_matrix(matrix)
64
+ if not TOL.is_allclose(flatten(matrix), flatten(matrix_from_scale_factors(scale))):
65
+ raise ValueError("This is not a proper scale matrix.")
66
+ super(Scale, self).__init__(matrix=matrix, name=name)
67
+
68
+ @classmethod
69
+ def from_factors(cls, factors, frame=None):
70
+ """Construct a scale transformation from scale factors.
71
+
72
+ Parameters
73
+ ----------
74
+ factors : [float, float, float]
75
+ The scale factors along X, Y, Z.
76
+ frame : [point, vector, vector] | :class:`compas.geometry.Frame`, optional
77
+ The anchor frame for the scaling transformation.
78
+
79
+ Returns
80
+ -------
81
+ :class:`compas.geometry.Scale`
82
+ A scale transformation.
83
+
84
+ Examples
85
+ --------
86
+ >>> from compas.geometry import Point, Frame
87
+ >>> point = Point(2, 5, 0)
88
+ >>> frame = Frame(point, (1, 0, 0), (0, 1, 0))
89
+ >>> points = [point, Point(2, 10, 0)]
90
+ >>> S = Scale.from_factors([2.0] * 3, frame)
91
+ >>> [p.transformed(S) for p in points]
92
+ [Point(2.000, 5.000, 0.000), Point(2.000, 15.000, 0.000)]
93
+
94
+ """
95
+ matrix = matrix_from_scale_factors(factors)
96
+ if frame:
97
+ Tw = matrix_from_frame(frame)
98
+ Tl = matrix_inverse(Tw)
99
+ matrix = multiply_matrices(multiply_matrices(Tw, matrix), Tl)
100
+ return cls(matrix)
File without changes