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,769 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ from compas.geometry import Geometry
6
+ from compas.geometry import Transformation
7
+ from compas.geometry import argmax
8
+ from compas.geometry import axis_angle_vector_from_matrix
9
+ from compas.geometry import basis_vectors_from_matrix
10
+ from compas.geometry import cross_vectors
11
+ from compas.geometry import decompose_matrix
12
+ from compas.geometry import euler_angles_from_matrix
13
+ from compas.geometry import matrix_from_axis_angle_vector
14
+ from compas.geometry import matrix_from_basis_vectors
15
+ from compas.geometry import matrix_from_euler_angles
16
+ from compas.geometry import matrix_from_quaternion
17
+ from compas.geometry import quaternion_from_matrix
18
+ from compas.geometry import subtract_vectors
19
+ from compas.itertools import linspace
20
+ from compas.tolerance import TOL
21
+
22
+ from .point import Point
23
+ from .quaternion import Quaternion
24
+ from .vector import Vector
25
+
26
+
27
+ class Frame(Geometry):
28
+ """A frame is defined by a base point and two orthonormal base vectors.
29
+
30
+ Parameters
31
+ ----------
32
+ point : [float, float, float] | :class:`compas.geometry.Point`
33
+ The origin of the frame.
34
+ xaxis : [float, float, float] | :class:`compas.geometry.Vector`, optional
35
+ The x-axis of the frame. Defaults to the unit X vector.
36
+ yaxis : [float, float, float] | :class:`compas.geometry.Vector`, optional
37
+ The y-axis of the frame. Defaults to the unit Y vector.
38
+ name : str, optional
39
+ The name of the frame.
40
+
41
+ Attributes
42
+ ----------
43
+ axes : list of :class:`compas.geometry.Vector`, read-only
44
+ The XYZ axes of the frame.
45
+ axis_angle_vector : :class:`compas.geometry.Vector`, read-only
46
+ The axis-angle vector representing the rotation of the frame.
47
+ normal : :class:`compas.geometry.Vector`, read-only
48
+ The normal of the base plane of the frame.
49
+ point : :class:`compas.geometry.Point`
50
+ The base point of the frame.
51
+ quaternion : :class:`compas.geometry.Quaternion`, read-only
52
+ The quaternion from the rotation given by the frame.
53
+ xaxis : :class:`compas.geometry.Vector`
54
+ The local X axis of the frame.
55
+ yaxis : :class:`compas.geometry.Vector`
56
+ The local Y axis of the frame.
57
+ zaxis : :class:`compas.geometry.Vector`, read-only
58
+ The Z axis of the frame.
59
+
60
+ Notes
61
+ -----
62
+ All input vectors are orthonormalized when creating a frame, with the first
63
+ vector as starting point.
64
+
65
+ Examples
66
+ --------
67
+ >>> from compas.geometry import Point
68
+ >>> from compas.geometry import Vector
69
+ >>> f = Frame([0, 0, 0], [1, 0, 0], [0, 1, 0])
70
+ >>> f = Frame(Point(0, 0, 0), Vector(1, 0, 0), Vector(0, 1, 0))
71
+ >>> f = Frame([0, 0, 0])
72
+
73
+ """
74
+
75
+ DATASCHEMA = {
76
+ "type": "object",
77
+ "properties": {
78
+ "point": Point.DATASCHEMA,
79
+ "xaxis": Vector.DATASCHEMA,
80
+ "yaxis": Vector.DATASCHEMA,
81
+ },
82
+ "required": ["point", "xaxis", "yaxis"],
83
+ }
84
+
85
+ @property
86
+ def __data__(self):
87
+ return {
88
+ "point": self.point.__data__,
89
+ "xaxis": self.xaxis.__data__,
90
+ "yaxis": self.yaxis.__data__,
91
+ }
92
+
93
+ def __init__(self, point, xaxis=None, yaxis=None, name=None):
94
+ super(Frame, self).__init__(name=name)
95
+ self._point = None
96
+ self._xaxis = None
97
+ self._yaxis = None
98
+ self._zaxis = None
99
+ self.point = point
100
+ self.xaxis = Vector(1, 0, 0) if xaxis is None else xaxis
101
+ self.yaxis = Vector(0, 1, 0) if yaxis is None else yaxis
102
+
103
+ def __repr__(self):
104
+ return "{0}(point={1!r}, xaxis={2!r}, yaxis={3!r})".format(
105
+ type(self).__name__,
106
+ self.point,
107
+ self.xaxis,
108
+ self.yaxis,
109
+ )
110
+
111
+ def __len__(self):
112
+ return 3
113
+
114
+ def __getitem__(self, key):
115
+ if key == 0:
116
+ return self.point
117
+ if key == 1:
118
+ return self.xaxis
119
+ if key == 2:
120
+ return self.yaxis
121
+ raise KeyError
122
+
123
+ def __setitem__(self, key, value):
124
+ if key == 0:
125
+ self.point = value
126
+ return
127
+ if key == 1:
128
+ self.xaxis = value
129
+ return
130
+ if key == 2:
131
+ self.yaxis = value
132
+ raise KeyError
133
+
134
+ def __iter__(self):
135
+ return iter([self.point, self.xaxis, self.yaxis])
136
+
137
+ def __eq__(self, other, tol=None):
138
+ if not hasattr(other, "__iter__") or not hasattr(other, "__len__") or len(self) != len(other):
139
+ return False
140
+ return TOL.is_allclose(self, other, atol=tol)
141
+
142
+ # ==========================================================================
143
+ # Properties
144
+ # ==========================================================================
145
+
146
+ @property
147
+ def point(self):
148
+ if not self._point:
149
+ raise ValueError("The frame has no origin.")
150
+ return self._point
151
+
152
+ @point.setter
153
+ def point(self, point):
154
+ self._point = Point(*point)
155
+
156
+ @property
157
+ def xaxis(self):
158
+ if not self._xaxis:
159
+ raise ValueError("The frame has no x-axis.")
160
+ return self._xaxis
161
+
162
+ @xaxis.setter
163
+ def xaxis(self, vector):
164
+ xaxis = Vector(*vector)
165
+ xaxis.unitize()
166
+ self._xaxis = xaxis
167
+ self._zaxis = None
168
+
169
+ @property
170
+ def yaxis(self):
171
+ if not self._yaxis:
172
+ raise ValueError("The frame has no y-axis.")
173
+ return self._yaxis
174
+
175
+ @yaxis.setter
176
+ def yaxis(self, vector):
177
+ yaxis = Vector(*vector)
178
+ yaxis.unitize()
179
+ zaxis = self.xaxis.cross(yaxis)
180
+ zaxis.unitize()
181
+ self._yaxis = zaxis.cross(self.xaxis)
182
+ self._zaxis = None
183
+
184
+ @property
185
+ def normal(self):
186
+ return self.zaxis
187
+
188
+ @property
189
+ def zaxis(self):
190
+ if not self._zaxis:
191
+ self._zaxis = self.xaxis.cross(self.yaxis)
192
+ return self._zaxis
193
+
194
+ def axes(self):
195
+ return [self.xaxis, self.yaxis, self.zaxis]
196
+
197
+ @property
198
+ def quaternion(self):
199
+ R = matrix_from_basis_vectors(self.xaxis, self.yaxis)
200
+ return Quaternion(*quaternion_from_matrix(R))
201
+
202
+ @property
203
+ def axis_angle_vector(self):
204
+ R = matrix_from_basis_vectors(self.xaxis, self.yaxis)
205
+ return Vector(*axis_angle_vector_from_matrix(R))
206
+
207
+ # ==========================================================================
208
+ # Constructors
209
+ # ==========================================================================
210
+
211
+ @classmethod
212
+ def worldXY(cls): # type: () -> Frame
213
+ """Construct the world XY frame.
214
+
215
+ Returns
216
+ -------
217
+ :class:`compas.geometry.Frame`
218
+ The world XY frame.
219
+
220
+ Examples
221
+ --------
222
+ >>> frame = Frame.worldXY()
223
+ >>> frame.point
224
+ Point(0.000, 0.000, 0.000)
225
+ >>> frame.xaxis
226
+ Vector(1.000, 0.000, 0.000)
227
+ >>> frame.yaxis
228
+ Vector(0.000, 1.000, 0.000)
229
+
230
+ """
231
+ return cls([0, 0, 0], [1, 0, 0], [0, 1, 0])
232
+
233
+ @classmethod
234
+ def worldZX(cls): # type: () -> Frame
235
+ """Construct the world ZX frame.
236
+
237
+ Returns
238
+ -------
239
+ :class:`compas.geometry.Frame`
240
+ The world ZX frame.
241
+
242
+ Examples
243
+ --------
244
+ >>> frame = Frame.worldZX()
245
+ >>> frame.point
246
+ Point(0.000, 0.000, 0.000)
247
+ >>> frame.xaxis
248
+ Vector(0.000, 0.000, 1.000)
249
+ >>> frame.yaxis
250
+ Vector(1.000, 0.000, 0.000)
251
+
252
+ """
253
+ return cls([0, 0, 0], [0, 0, 1], [1, 0, 0])
254
+
255
+ @classmethod
256
+ def worldYZ(cls): # type: () -> Frame
257
+ """Construct the world YZ frame.
258
+
259
+ Returns
260
+ -------
261
+ :class:`compas.geometry.Frame`
262
+ The world YZ frame.
263
+
264
+ Examples
265
+ --------
266
+ >>> frame = Frame.worldYZ()
267
+ >>> frame.point
268
+ Point(0.000, 0.000, 0.000)
269
+ >>> frame.xaxis
270
+ Vector(0.000, 1.000, 0.000)
271
+ >>> frame.yaxis
272
+ Vector(0.000, 0.000, 1.000)
273
+
274
+ """
275
+ return cls([0, 0, 0], [0, 1, 0], [0, 0, 1])
276
+
277
+ @classmethod
278
+ def from_points(cls, point, point_xaxis, point_xyplane): # type: (...) -> Frame
279
+ """Constructs a frame from 3 points.
280
+
281
+ Parameters
282
+ ----------
283
+ point : [float, float, float] | :class:`compas.geometry.Point`
284
+ The origin of the frame.
285
+ point_xaxis : [float, float, float] | :class:`compas.geometry.Point`
286
+ A point on the x-axis of the frame.
287
+ point_xyplane : [float, float, float] | :class:`compas.geometry.Point`
288
+ A point within the xy-plane of the frame.
289
+
290
+ Returns
291
+ -------
292
+ :class:`compas.geometry.Frame`
293
+ The constructed frame.
294
+
295
+ Examples
296
+ --------
297
+ >>> frame = Frame.from_points([0, 0, 0], [1, 0, 0], [0, 1, 0])
298
+ >>> frame.point
299
+ Point(0.000, 0.000, 0.000)
300
+ >>> frame.xaxis
301
+ Vector(1.000, 0.000, 0.000)
302
+ >>> frame.yaxis
303
+ Vector(0.000, 1.000, 0.000)
304
+
305
+ """
306
+ xaxis = subtract_vectors(point_xaxis, point)
307
+ xyvec = subtract_vectors(point_xyplane, point)
308
+ yaxis = cross_vectors(cross_vectors(xaxis, xyvec), xaxis)
309
+ return cls(point, xaxis, yaxis)
310
+
311
+ @classmethod
312
+ def from_rotation(cls, rotation, point=[0, 0, 0]): # type: (...) -> Frame
313
+ """Constructs a frame from a Rotation.
314
+
315
+ Parameters
316
+ ----------
317
+ rotation : :class:`compas.geometry.Rotation`
318
+ The rotation defines the orientation of the frame.
319
+ point : [float, float, float] | :class:`compas.geometry.Point`, optional
320
+ The origin of the frame.
321
+
322
+ Returns
323
+ -------
324
+ :class:`compas.geometry.Frame`
325
+ The constructed frame.
326
+
327
+ Examples
328
+ --------
329
+ >>> from compas.geometry import Rotation
330
+ >>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
331
+ >>> R = Rotation.from_frame(f1)
332
+ >>> f2 = Frame.from_rotation(R, point=f1.point)
333
+ >>> f1 == f2
334
+ True
335
+
336
+ """
337
+ xaxis, yaxis = rotation.basis_vectors
338
+ return cls(point, xaxis, yaxis)
339
+
340
+ @classmethod
341
+ def from_transformation(cls, transformation): # type: (...) -> Frame
342
+ """Constructs a frame from a Transformation.
343
+
344
+ Parameters
345
+ ----------
346
+ transformation : :class:`compas.geometry.Transformation`
347
+ The transformation defines the orientation of the frame through the
348
+ rotation and the origin through the translation.
349
+
350
+ Returns
351
+ -------
352
+ :class:`compas.geometry.Frame`
353
+ The constructed frame.
354
+
355
+ Examples
356
+ --------
357
+ >>> from compas.geometry import Transformation
358
+ >>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
359
+ >>> T = Transformation.from_frame(f1)
360
+ >>> f2 = Frame.from_transformation(T)
361
+ >>> f1 == f2
362
+ True
363
+
364
+ """
365
+ xaxis, yaxis = transformation.basis_vectors
366
+ point = transformation.translation_vector
367
+ return cls(point, xaxis, yaxis)
368
+
369
+ @classmethod
370
+ def from_matrix(cls, matrix): # type: (...) -> Frame
371
+ """Construct a frame from a matrix.
372
+
373
+ Parameters
374
+ ----------
375
+ matrix : list[list[float]]
376
+ The 4x4 transformation matrix in row-major order.
377
+
378
+ Returns
379
+ -------
380
+ :class:`compas.geometry.Frame`
381
+ The constructed frame.
382
+
383
+ Examples
384
+ --------
385
+ >>> from compas.geometry import matrix_from_euler_angles
386
+ >>> ea1 = [0.5, 0.4, 0.8]
387
+ >>> M = matrix_from_euler_angles(ea1)
388
+ >>> f = Frame.from_matrix(M)
389
+ >>> ea2 = f.euler_angles()
390
+ >>> allclose(ea1, ea2)
391
+ True
392
+
393
+ """
394
+ _, _, angles, point, _ = decompose_matrix(matrix)
395
+ R = matrix_from_euler_angles(angles, static=True, axes="xyz")
396
+ xaxis, yaxis = basis_vectors_from_matrix(R)
397
+ return cls(point, xaxis, yaxis)
398
+
399
+ @classmethod
400
+ def from_list(cls, values): # type: (...) -> Frame
401
+ """Construct a frame from a list of 12 or 16 float values.
402
+
403
+ Parameters
404
+ ----------
405
+ values : list[float]
406
+ The list of 12 or 16 values representing a 4x4 matrix.
407
+
408
+ Returns
409
+ -------
410
+ :class:`compas.geometry.Frame`
411
+ The constructed frame.
412
+
413
+ Raises
414
+ ------
415
+ ValueError
416
+ If the length of the list is neither 12 nor 16.
417
+
418
+ Notes
419
+ -----
420
+ Since the transformation matrix follows the row-major order, the
421
+ translational components must be at the list's indices 3, 7, 11.
422
+
423
+ Examples
424
+ --------
425
+ >>> l = [-1.0, 0.0, 0.0, 8110, 0.0, 0.0, -1.0, 7020, 0.0, -1.0, 0.0, 1810]
426
+ >>> f = Frame.from_list(l)
427
+
428
+ """
429
+ if len(values) == 12:
430
+ values.extend([0.0, 0.0, 0.0, 1.0])
431
+ if len(values) != 16:
432
+ raise ValueError("Expected 12 or 16 floats but got %d" % len(values))
433
+
434
+ matrix = [[0.0 for i in range(4)] for j in range(4)]
435
+ for i in range(4):
436
+ for j in range(4):
437
+ matrix[i][j] = float(values[i * 4 + j])
438
+
439
+ return cls.from_matrix(matrix)
440
+
441
+ @classmethod
442
+ def from_quaternion(cls, quaternion, point=[0, 0, 0]): # type: (...) -> Frame
443
+ """Construct a frame from a rotation represented by quaternion coefficients.
444
+
445
+ Parameters
446
+ ----------
447
+ quaternion : [float, float, float, float] | :class:`compas.geometry.Quaternion`
448
+ Four numbers that represent the four coefficient values of a quaternion.
449
+ point : [float, float, float] | :class:`compas.geometry.Point`, optional
450
+ The point of the frame.
451
+
452
+ Returns
453
+ -------
454
+ :class:`compas.geometry.Frame`
455
+ The constructed frame.
456
+
457
+ Examples
458
+ --------
459
+ >>> q1 = [0.945, -0.021, -0.125, 0.303]
460
+ >>> f = Frame.from_quaternion(q1, point=[1.0, 1.0, 1.0])
461
+ >>> q2 = f.quaternion
462
+ >>> allclose(q1, q2)
463
+ True
464
+
465
+ """
466
+ R = matrix_from_quaternion(quaternion)
467
+ xaxis, yaxis = basis_vectors_from_matrix(R)
468
+ return cls(point, xaxis, yaxis)
469
+
470
+ @classmethod
471
+ def from_axis_angle_vector(cls, axis_angle_vector, point=[0, 0, 0]): # type: (...) -> Frame
472
+ """Construct a frame from an axis-angle vector representing the rotation.
473
+
474
+ Parameters
475
+ ----------
476
+ axis_angle_vector : [float, float, float]
477
+ Three numbers that represent the axis of rotation and angle of
478
+ rotation by its magnitude.
479
+ point : [float, float, float] | :class:`compas.geometry.Point`, optional
480
+ The point of the frame.
481
+
482
+ Returns
483
+ -------
484
+ :class:`compas.geometry.Frame`
485
+ The constructed frame.
486
+
487
+ Examples
488
+ --------
489
+ >>> aav1 = [-0.043, -0.254, 0.617]
490
+ >>> f = Frame.from_axis_angle_vector(aav1, point=[0, 0, 0])
491
+ >>> aav2 = f.axis_angle_vector
492
+ >>> allclose(aav1, aav2)
493
+ True
494
+
495
+ """
496
+ R = matrix_from_axis_angle_vector(axis_angle_vector)
497
+ xaxis, yaxis = basis_vectors_from_matrix(R)
498
+ return cls(point, xaxis, yaxis)
499
+
500
+ @classmethod
501
+ def from_euler_angles(cls, euler_angles, static=True, axes="xyz", point=[0, 0, 0]): # type: (...) -> Frame
502
+ """Construct a frame from a rotation represented by Euler angles.
503
+
504
+ Parameters
505
+ ----------
506
+ euler_angles : [float, float, float]
507
+ Three numbers that represent the angles of rotations about the defined axes.
508
+ static : bool, optional
509
+ If True, the rotations are applied to a static frame.
510
+ If False, to a rotational.
511
+ axes : str, optional
512
+ A 3 character string specifying the order of the axes.
513
+ point : [float, float, float] | :class:`compas.geometry.Point`, optional
514
+ The point of the frame.
515
+
516
+ Returns
517
+ -------
518
+ :class:`compas.geometry.Frame`
519
+ The constructed frame.
520
+
521
+ Examples
522
+ --------
523
+ >>> ea1 = 1.4, 0.5, 2.3
524
+ >>> f = Frame.from_euler_angles(ea1, static=True, axes="xyz")
525
+ >>> ea2 = f.euler_angles(static=True, axes="xyz")
526
+ >>> allclose(ea1, ea2)
527
+ True
528
+
529
+ """
530
+ R = matrix_from_euler_angles(euler_angles, static, axes)
531
+ xaxis, yaxis = basis_vectors_from_matrix(R)
532
+ return cls(point, xaxis, yaxis)
533
+
534
+ @classmethod
535
+ def from_plane(cls, plane): # type: (...) -> Frame
536
+ """Constructs a frame from a plane.
537
+
538
+ Xaxis and yaxis are arbitrarily selected based on the plane's normal.
539
+
540
+ Parameters
541
+ ----------
542
+ plane : [point, vector] | :class:`compas.geometry.Plane`
543
+ A plane.
544
+
545
+ Returns
546
+ -------
547
+ :class:`compas.geometry.Frame`
548
+ The constructed frame.
549
+
550
+ Examples
551
+ --------
552
+ >>> from compas.geometry import Plane
553
+ >>> plane = Plane([0, 0, 0], [0, 0, 1])
554
+ >>> frame = Frame.from_plane(plane)
555
+ >>> allclose(frame.normal, plane.normal)
556
+ True
557
+
558
+ """
559
+ point, normal = plane
560
+ # To construct a frame we need to find a vector v that is perpendicular
561
+ # to the plane's normal. This means that the dot-product of v with the
562
+ # normal must be equal to 0, which is true for the following vectors:
563
+ vectors = [
564
+ Vector(-normal[1], normal[0], 0),
565
+ Vector(0, -normal[2], normal[1]),
566
+ Vector(normal[2], 0, -normal[0]),
567
+ ]
568
+ # But if we are unlucky, one of these vectors is (0, 0, 0), so we
569
+ # choose the vector with the longest length as xaxis.
570
+ idx = argmax([v.length for v in vectors])
571
+ xaxis = vectors[idx]
572
+ yaxis = cross_vectors(normal, xaxis)
573
+ return cls(point, xaxis, yaxis)
574
+
575
+ # ==========================================================================
576
+ # Conversions
577
+ # ==========================================================================
578
+
579
+ def to_transformation(self):
580
+ """Convert the frame to a transformation.
581
+
582
+ Returns
583
+ -------
584
+ :class:`compas.geometry.Transformation`
585
+ The transformation.
586
+
587
+ """
588
+ return Transformation.from_frame(self)
589
+
590
+ # ==========================================================================
591
+ # Methods
592
+ # ==========================================================================
593
+
594
+ def interpolate_frame(self, other, t):
595
+ """Interpolates between two frames at a given parameter t in the range [0, 1]
596
+
597
+ Parameters
598
+ ----------
599
+ other : :class:`compas.geometry.Frame`
600
+ t : float
601
+ A parameter in the range [0-1].
602
+
603
+ Returns
604
+ -------
605
+ :class:`compas.geometry.Frame`
606
+ A list of the interpolated :class:`compas.geometry.Frame` instances.
607
+
608
+ Examples
609
+ --------
610
+ >>> frame1 = Frame(Point(0, 0, 0), Vector(1, 0, 0), Vector(0, 1, 0))
611
+ >>> frame2 = Frame(Point(1, 1, 1), Vector(0, 0, 1), Vector(0, 1, 0))
612
+ >>> start_frame = frame1.interpolate_frame(frame2, 0)
613
+ >>> allclose(start_frame.point, frame1.point) and allclose(start_frame.quaternion, frame1.quaternion)
614
+ True
615
+ """
616
+ quat1 = Quaternion.from_frame(self)
617
+ quat2 = Quaternion.from_frame(other)
618
+
619
+ # Interpolate origin
620
+ origin_interpolated = (self.point * (1.0 - t)) + other.point * t
621
+
622
+ rot_interpolated = quat1.slerp(quat2, t)
623
+
624
+ # Create a new frame with the interpolated position and orientation
625
+ interpolated_frame = Frame.from_quaternion(rot_interpolated, point=origin_interpolated)
626
+
627
+ return interpolated_frame
628
+
629
+ def interpolate_frames(self, other, steps):
630
+ """Generates a specified number of interpolated frames between two given frames
631
+
632
+ Parameters
633
+ ----------
634
+ other : :class:`compas.geometry.Frame`
635
+ steps : int
636
+ The number of interpolated frames to return.
637
+
638
+ Returns
639
+ -------
640
+ list of :class:`compas.geometry.Frame`
641
+
642
+ Examples
643
+ --------
644
+ >>> frame1 = Frame(Point(0, 0, 0), Vector(1, 0, 0), Vector(0, 1, 0))
645
+ >>> frame2 = Frame(Point(1, 1, 1), Vector(0, 0, 1), Vector(0, 1, 0))
646
+ >>> steps = 5
647
+ >>> frames = frame1.interpolate_frames(frame2, steps)
648
+ >>> assert len(frames) == steps
649
+ True
650
+ """
651
+ return [self.interpolate_frame(other, t) for t in linspace(0, 1, steps)]
652
+
653
+ def euler_angles(self, static=True, axes="xyz"):
654
+ """The Euler angles from the rotation given by the frame.
655
+
656
+ Parameters
657
+ ----------
658
+ static : bool, optional
659
+ If True the rotations are applied to a static frame.
660
+ If False, to a rotational.
661
+ axes : str, optional
662
+ A 3 character string specifying the order of the axes.
663
+
664
+ Returns
665
+ -------
666
+ list[float]
667
+ Three numbers that represent the angles of rotations about the defined axes.
668
+
669
+ Examples
670
+ --------
671
+ >>> ea1 = 1.4, 0.5, 2.3
672
+ >>> f = Frame.from_euler_angles(ea1, static=True, axes="xyz")
673
+ >>> ea2 = f.euler_angles(static=True, axes="xyz")
674
+ >>> allclose(ea1, ea2)
675
+ True
676
+
677
+ """
678
+ R = matrix_from_basis_vectors(self.xaxis, self.yaxis)
679
+ return euler_angles_from_matrix(R, static, axes)
680
+
681
+ def to_local_coordinates(self, obj_in_wcf):
682
+ """Returns the object's coordinates in the local coordinate system of the frame.
683
+
684
+ Parameters
685
+ ----------
686
+ obj_in_wcf : [float, float, float] | :class:`compas.geometry.Geometry`
687
+ An object in the world coordinate frame.
688
+
689
+ Returns
690
+ -------
691
+ :class:`compas.geometry.Geometry`
692
+ The object in the local coordinate system of the frame.
693
+
694
+ Notes
695
+ -----
696
+ If you pass a list of floats, it is assumed to represent a point.
697
+
698
+ Examples
699
+ --------
700
+ >>> from compas.geometry import Point
701
+ >>> frame = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
702
+ >>> pw = Point(2, 2, 2) # point in wcf
703
+ >>> pl = frame.to_local_coordinates(pw) # point in frame
704
+ >>> frame.to_world_coordinates(pl)
705
+ Point(2.000, 2.000, 2.000)
706
+
707
+ """
708
+ T = Transformation.from_change_of_basis(Frame.worldXY(), self)
709
+ if isinstance(obj_in_wcf, (list, tuple)):
710
+ return Point(*obj_in_wcf).transformed(T)
711
+ return obj_in_wcf.transformed(T)
712
+
713
+ def to_world_coordinates(self, obj_in_lcf):
714
+ """Returns the object's coordinates in the global coordinate frame.
715
+
716
+ Parameters
717
+ ----------
718
+ obj_in_lcf : [float, float, float] | :class:`compas.geometry.Geometry`
719
+ An object in local coordinate system of the frame.
720
+
721
+ Returns
722
+ -------
723
+ :class:`compas.geometry.Geometry`
724
+ The object in the world coordinate frame.
725
+
726
+ Notes
727
+ -----
728
+ If you pass a list of floats, it is assumed to represent a point.
729
+
730
+ Examples
731
+ --------
732
+ >>> from compas.geometry import Point
733
+ >>> frame = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
734
+ >>> pl = Point(1.632, -0.090, 0.573) # point in frame
735
+ >>> pw = frame.to_world_coordinates(pl) # point in wcf
736
+ >>> frame.to_local_coordinates(pw)
737
+ Point(1.632, -0.090, 0.573)
738
+
739
+ """
740
+ T = Transformation.from_change_of_basis(self, Frame.worldXY())
741
+ if isinstance(obj_in_lcf, list):
742
+ return Point(*obj_in_lcf).transformed(T)
743
+ return obj_in_lcf.transformed(T)
744
+
745
+ def transform(self, T):
746
+ """Transform the frame.
747
+
748
+ Parameters
749
+ ----------
750
+ T : :class:`compas.geometry.Transformation`
751
+ The transformation.
752
+
753
+ Examples
754
+ --------
755
+ >>> from compas.geometry import Transformation
756
+ >>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
757
+ >>> T = Transformation.from_frame(f1)
758
+ >>> f2 = Frame.worldXY()
759
+ >>> f2.transform(T)
760
+ >>> f1 == f2
761
+ True
762
+
763
+ """
764
+ X = T * Transformation.from_frame(self)
765
+ point = X.translation_vector
766
+ xaxis, yaxis = X.basis_vectors
767
+ self.point = point
768
+ self.xaxis = xaxis
769
+ self.yaxis = yaxis