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,554 @@
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.data import Data
15
+ from compas.geometry import basis_vectors_from_matrix
16
+ from compas.geometry import decompose_matrix
17
+ from compas.geometry import identity_matrix
18
+ from compas.geometry import matrix_determinant
19
+ from compas.geometry import matrix_from_euler_angles
20
+ from compas.geometry import matrix_from_frame
21
+ from compas.geometry import matrix_from_translation
22
+ from compas.geometry import matrix_inverse
23
+ from compas.geometry import multiply_matrices
24
+ from compas.geometry import translation_from_matrix
25
+ from compas.geometry import transpose_matrix
26
+ from compas.tolerance import TOL
27
+
28
+
29
+ class Transformation(Data):
30
+ """Class representing a general 4x4 transformation matrix.
31
+
32
+ It is the base class for transformations like :class:`Rotation`,
33
+ :class:`Translation`, :class:`Scale`, :class:`Reflection`,
34
+ :class:`Projection` and :class:`Shear`.
35
+
36
+ The class allows to concatenate Transformations by multiplication, to
37
+ calculate the inverse transformation and to decompose a transformation into
38
+ its components of rotation, translation, scale, shear, and perspective.
39
+ The matrix follows the row-major order, such that translation components
40
+ x, y, z are in the right column of the matrix, i.e. ``M[0][3], M[1][3],
41
+ M[2][3] = x, y, z``.
42
+
43
+ Parameters
44
+ ----------
45
+ matrix : list[list[float]], optional
46
+ The 4x4 transformation matrix.
47
+ name : str, optional
48
+ The name of the transformation.
49
+
50
+ Attributes
51
+ ----------
52
+ scale : :class:`compas.geometry.Scale`, read-only
53
+ The scale component of the transformation matrix.
54
+ shear : :class:`compas.geometry.Shear`, read-only
55
+ The shear component of the transformation matrix.
56
+ rotation : :class:`compas.geometry.Rotation`, read-only
57
+ The rotation component of the transformation matrix.
58
+ translation : :class:`compas.geometry.Translation`, read-only
59
+ The translation component of the transformation matrix.
60
+ projection : :class:`compas.geometry.Projection`, read-only
61
+ The projection component of the transformation matrix.
62
+ translation_vector : :class:`compas.geometry.Vector`, read-only
63
+ The translation component of the transformation matrix as a translation vector.
64
+ basis_vectors : tuple[:class:`compas.geometry.Vector`, :class:`compas.geometry.Vector`], read-only
65
+ The basis vectors from the rotation component of the transformation matrix.
66
+ list : list[float], read-only
67
+ Flattens the 4x4 transformation matrix into a list of 16 numbers.
68
+ determinant : float, read-only
69
+ The determinant of the matrix of the transformation.
70
+
71
+ Examples
72
+ --------
73
+ >>> from compas.geometry import Frame
74
+ >>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
75
+ >>> T = Transformation.from_frame(f1)
76
+ >>> Sc, Sh, R, Tl, P = T.decomposed()
77
+ >>> Tinv = T.inverse()
78
+
79
+ """
80
+
81
+ DATASCHEMA = {
82
+ "type": "object",
83
+ "properties": {
84
+ "matrix": {
85
+ "type": "array",
86
+ "items": {
87
+ "type": "array",
88
+ "items": {"type": "number"},
89
+ "minItems": 4,
90
+ "maxItems": 4,
91
+ },
92
+ "minItems": 4,
93
+ "maxItems": 4,
94
+ },
95
+ },
96
+ "required": ["matrix"],
97
+ }
98
+
99
+ @property
100
+ def __data__(self):
101
+ return {"matrix": self.matrix}
102
+
103
+ def __init__(self, matrix=None, name=None):
104
+ super(Transformation, self).__init__(name=name)
105
+ if not matrix:
106
+ matrix = identity_matrix(4)
107
+ self.matrix = matrix
108
+
109
+ def __mul__(self, other):
110
+ return self.concatenated(other)
111
+
112
+ def __imul__(self, other):
113
+ return self.concatenated(other)
114
+
115
+ def __getitem__(self, key):
116
+ i, j = key
117
+ return self.matrix[i][j]
118
+
119
+ def __setitem__(self, key, value):
120
+ i, j = key
121
+ self.matrix[i][j] = value
122
+
123
+ def __iter__(self):
124
+ return iter(self.matrix)
125
+
126
+ def __eq__(self, other, tol=None):
127
+ try:
128
+ A = self.matrix
129
+ B = other.matrix
130
+ return TOL.is_allclose(A, B, rtol=0, atol=tol)
131
+ except BaseException:
132
+ return False
133
+
134
+ def __ne__(self, other):
135
+ # this is not obvious to ironpython
136
+ return not self.__eq__(other)
137
+
138
+ def __repr__(self):
139
+ return "{0}({1!r}, check=False)".format(self.__class__.__name__, self.matrix)
140
+
141
+ def __str__(self):
142
+ s = "[[%s],\n" % ",".join([("%.4f" % n).rjust(10) for n in self.matrix[0]])
143
+ s += " [%s],\n" % ",".join([("%.4f" % n).rjust(10) for n in self.matrix[1]])
144
+ s += " [%s],\n" % ",".join([("%.4f" % n).rjust(10) for n in self.matrix[2]])
145
+ s += " [%s]]\n" % ",".join([("%.4f" % n).rjust(10) for n in self.matrix[3]])
146
+ return s
147
+
148
+ def __len__(self):
149
+ return len(self.matrix)
150
+
151
+ # ==========================================================================
152
+ # Properties
153
+ # ==========================================================================
154
+
155
+ @property
156
+ def scale(self):
157
+ S, H, R, T, P = self.decomposed()
158
+ return S
159
+
160
+ @property
161
+ def shear(self):
162
+ S, H, R, T, P = self.decomposed()
163
+ return H
164
+
165
+ @property
166
+ def rotation(self):
167
+ S, H, R, T, P = self.decomposed()
168
+ return R
169
+
170
+ @property
171
+ def translation(self):
172
+ S, H, R, T, P = self.decomposed()
173
+ return T
174
+
175
+ @property
176
+ def projection(self):
177
+ S, H, R, T, P = self.decomposed()
178
+ return P
179
+
180
+ @property
181
+ def translation_vector(self):
182
+ from compas.geometry import Vector
183
+
184
+ vector = translation_from_matrix(self.matrix)
185
+ return Vector(*vector)
186
+
187
+ @property
188
+ def basis_vectors(self):
189
+ from compas.geometry import Vector
190
+
191
+ x, y = basis_vectors_from_matrix(self.rotation.matrix)
192
+ return Vector(*x), Vector(*y)
193
+
194
+ @property
195
+ def list(self):
196
+ return [a for c in self.matrix for a in c]
197
+
198
+ @property
199
+ def determinant(self):
200
+ return matrix_determinant(self.matrix)
201
+
202
+ # ==========================================================================
203
+ # Constructors
204
+ # ==========================================================================
205
+
206
+ @classmethod
207
+ def from_matrix(cls, matrix):
208
+ """Creates a transformation from a list[list[float]] object.
209
+
210
+ Parameters
211
+ ----------
212
+ matrix : list[list[float]]
213
+ The 4x4 transformation matrix.
214
+
215
+ Returns
216
+ -------
217
+ :class:`compas.geometry.Transformation`
218
+ The transformation.
219
+
220
+ """
221
+ return cls(matrix)
222
+
223
+ @classmethod
224
+ def from_list(cls, numbers):
225
+ """Creates a transformation from a list of 16 numbers.
226
+
227
+ Parameters
228
+ ----------
229
+ numbers : list[float]
230
+ A list of 16 numbers
231
+
232
+ Returns
233
+ -------
234
+ :class:`compas.geometry.Transformation`
235
+ The transformation.
236
+
237
+ Notes
238
+ -----
239
+ Since the transformation matrix follows the row-major order, the
240
+ translational components must be at the list's indices 3, 7, 11.
241
+
242
+ Examples
243
+ --------
244
+ >>> numbers = [1, 0, 0, 3, 0, 1, 0, 4, 0, 0, 1, 5, 0, 0, 0, 1]
245
+ >>> T = Transformation.from_list(numbers)
246
+
247
+ """
248
+ matrix = identity_matrix(4)
249
+ for i in range(4):
250
+ for j in range(4):
251
+ matrix[i][j] = float(numbers[i * 4 + j])
252
+ return cls(matrix)
253
+
254
+ @classmethod
255
+ def from_euler_angles(cls, euler_angles, static=True, axes="xyz", point=[0, 0, 0]):
256
+ """Construct a transformation from a rotation represented by Euler angles.
257
+
258
+ Parameters
259
+ ----------
260
+ euler_angles : [float, float, float]
261
+ Three numbers that represent the angles of rotations about the defined axes.
262
+ static : bool, optional
263
+ If True the rotations are applied to a static frame.
264
+ If False, to a rotational.
265
+ axes : str, optional
266
+ A 3 character string specifying the order of the axes.
267
+ point : list[float], optional
268
+ The point of the frame.
269
+
270
+ Returns
271
+ -------
272
+ :class:`compas.geometry.Transformation`
273
+ The transformation.
274
+
275
+ """
276
+ R = matrix_from_euler_angles(euler_angles, static, axes)
277
+ T = matrix_from_translation(point)
278
+ M = multiply_matrices(T, R)
279
+ return cls.from_matrix(M)
280
+
281
+ # should not one of the two just have a "to" function
282
+ @classmethod
283
+ def from_frame(cls, frame):
284
+ """Construct a transformation from world XY to frame.
285
+
286
+ Parameters
287
+ ----------
288
+ frame : :class:`compas.geometry.Frame`
289
+ A frame describing the targeted Cartesian coordinate system.
290
+
291
+ Returns
292
+ -------
293
+ :class:`compas.geometry.Transformation`
294
+ The transformation.
295
+
296
+ Notes
297
+ -----
298
+ It is the same as from_frame_to_frame(Frame.worldXY(), frame).
299
+
300
+ Examples
301
+ --------
302
+ >>> from compas.geometry import Frame
303
+ >>> f1 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
304
+ >>> T = Transformation.from_frame(f1)
305
+ >>> f2 = Frame.from_transformation(T)
306
+ >>> f1 == f2
307
+ True
308
+
309
+ """
310
+ return cls(matrix_from_frame(frame))
311
+
312
+ @classmethod
313
+ def from_frame_to_frame(cls, frame_from, frame_to):
314
+ """Construct a transformation between two frames.
315
+
316
+ This transformation allows to transform geometry from one Cartesian
317
+ coordinate system defined by `frame_from` to another Cartesian
318
+ coordinate system defined by `frame_to`.
319
+
320
+ Parameters
321
+ ----------
322
+ frame_from : :class:`compas.geometry.Frame`
323
+ A frame defining the original Cartesian coordinate system.
324
+ frame_to : :class:`compas.geometry.Frame`
325
+ A frame defining the targeted Cartesian coordinate system.
326
+
327
+ Returns
328
+ -------
329
+ :class:`compas.geometry.Transformation`
330
+ The transformation.
331
+
332
+ Examples
333
+ --------
334
+ >>> from compas.geometry import Frame
335
+ >>> f1 = Frame([2, 2, 2], [0.12, 0.58, 0.81], [-0.80, 0.53, -0.26])
336
+ >>> f2 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
337
+ >>> T = Transformation.from_frame_to_frame(f1, f2)
338
+ >>> f1.transform(T)
339
+ >>> f1 == f2
340
+ True
341
+
342
+ """
343
+ T1 = cls.from_frame(frame_from)
344
+ T2 = cls.from_frame(frame_to)
345
+ return cls(multiply_matrices(T2.matrix, matrix_inverse(T1.matrix)))
346
+
347
+ @classmethod
348
+ def from_change_of_basis(cls, frame_from, frame_to):
349
+ """Construct a change of basis transformation between two frames.
350
+
351
+ A basis change is essentially a remapping of geometry from one
352
+ coordinate system to another.
353
+
354
+ Parameters
355
+ ----------
356
+ frame_from : :class:`compas.geometry.Frame`
357
+ A frame defining the original Cartesian coordinate system.
358
+ frame_to : :class:`compas.geometry.Frame`
359
+ A frame defining the targeted Cartesian coordinate system.
360
+
361
+ Returns
362
+ -------
363
+ :class:`compas.geometry.Transformation`
364
+ The transformation representing a change of basis.
365
+
366
+ Examples
367
+ --------
368
+ >>> from compas.geometry import Point, Frame
369
+ >>> f1 = Frame([2, 2, 2], [0.12, 0.58, 0.81], [-0.80, 0.53, -0.26])
370
+ >>> f2 = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
371
+ >>> T = Transformation.from_change_of_basis(f1, f2)
372
+ >>> p_f1 = Point(1, 1, 1) # point in f1
373
+ >>> p_f1.transformed(T) # point represented in f2
374
+ Point(1.395, 0.955, 1.934)
375
+ >>> Frame.local_to_local_coordinates(f1, f2, p_f1)
376
+ Point(1.395, 0.955, 1.934)
377
+
378
+ """
379
+ T1 = cls.from_frame(frame_from)
380
+ T2 = cls.from_frame(frame_to)
381
+ return cls(multiply_matrices(matrix_inverse(T2.matrix), T1.matrix))
382
+
383
+ # ==========================================================================
384
+ # Methods
385
+ # ==========================================================================
386
+
387
+ def copy(self):
388
+ """Returns a copy of the transformation.
389
+
390
+ Returns
391
+ -------
392
+ :class:`compas.geometry.Transformation`
393
+ An independent copy of the transformation.
394
+
395
+ """
396
+ cls = type(self)
397
+ matrix = [
398
+ self.matrix[0][:],
399
+ self.matrix[1][:],
400
+ self.matrix[2][:],
401
+ self.matrix[3][:],
402
+ ]
403
+ return cls(matrix)
404
+
405
+ def transpose(self):
406
+ """Transpose the matrix of this transformation.
407
+
408
+ Returns
409
+ -------
410
+ None
411
+ The transformation is transposed in-place.
412
+
413
+ """
414
+ self.matrix = transpose_matrix(self.matrix)
415
+
416
+ def transposed(self):
417
+ """Create a transposed copy of this transformation.
418
+
419
+ Returns
420
+ -------
421
+ :class:`compas.geometry.Transformation`
422
+ The transposed transformation object.
423
+
424
+ """
425
+ T = self.copy()
426
+ T.transpose()
427
+ return T
428
+
429
+ def invert(self):
430
+ """Invert this transformation.
431
+
432
+ Returns
433
+ -------
434
+ None
435
+ The transformation is transposed in-place.
436
+
437
+ """
438
+ self.matrix = matrix_inverse(self.matrix)
439
+
440
+ def inverse(self):
441
+ """Returns the inverse transformation.
442
+
443
+ Returns
444
+ -------
445
+ :class:`compas.geometry.Transformation`
446
+ The inverse transformation.
447
+
448
+ Examples
449
+ --------
450
+ >>> from compas.geometry import Frame
451
+ >>> f = Frame([1, 1, 1], [0.68, 0.68, 0.27], [-0.67, 0.73, -0.15])
452
+ >>> T = Transformation.from_frame(f)
453
+ >>> I = Transformation(identity_matrix(4))
454
+ >>> I == T * T.inverse()
455
+ True
456
+
457
+ """
458
+ T = self.copy()
459
+ T.invert()
460
+ return T
461
+
462
+ inverted = inverse
463
+
464
+ def decomposed(self):
465
+ """Decompose the `Transformation` into its components.
466
+
467
+ Returns
468
+ -------
469
+ :class:`compas.geometry.Scale`
470
+ The scale component of the current transformation.
471
+ :class:`compas.geometry.Shear`
472
+ The shear component of the current transformation.
473
+ :class:`compas.geometry.Rotation`
474
+ The rotation component of the current transformation.
475
+ :class:`compas.geometry.Translation`
476
+ The translation component of the current transformation.
477
+ :class:`compas.geometry.Projection`
478
+ The projection component of the current transformation.
479
+
480
+ Examples
481
+ --------
482
+ >>> from compas.geometry import Scale, Translation, Rotation
483
+ >>> trans1 = [1, 2, 3]
484
+ >>> angle1 = [-2.142, 1.141, -0.142]
485
+ >>> scale1 = [0.123, 2, 0.5]
486
+ >>> T1 = Translation.from_vector(trans1)
487
+ >>> R1 = Rotation.from_euler_angles(angle1)
488
+ >>> S1 = Scale.from_factors(scale1)
489
+ >>> M = T1 * R1 * S1
490
+ >>> S, H, R, T, P = M.decomposed()
491
+ >>> S1 == S
492
+ True
493
+ >>> R1 == R
494
+ True
495
+ >>> T1 == T
496
+ True
497
+
498
+ """
499
+ from compas.geometry import Projection
500
+ from compas.geometry import Rotation # noqa: F811
501
+ from compas.geometry import Scale # noqa: F811
502
+ from compas.geometry import Shear
503
+ from compas.geometry import Translation # noqa: F811
504
+
505
+ s, h, a, t, p = decompose_matrix(self.matrix)
506
+ S = Scale.from_factors(s)
507
+ H = Shear.from_entries(h)
508
+ R = Rotation.from_euler_angles(a, static=True, axes="xyz")
509
+ T = Translation.from_vector(t)
510
+ P = Projection.from_entries(p)
511
+ return S, H, R, T, P
512
+
513
+ def concatenate(self, other):
514
+ """Concatenate another transformation to this transformation.
515
+
516
+ Parameters
517
+ ----------
518
+ other: :class:`compas.geometry.Transformation`
519
+ The transformation object to concatenate.
520
+
521
+ Returns
522
+ -------
523
+ None
524
+ This transformation object is changed in-place.
525
+
526
+ Notes
527
+ -----
528
+ Rz * Ry * Rx means that Rx is first transformation, Ry second, and Rz third.
529
+
530
+ """
531
+ self.matrix = multiply_matrices(self.matrix, other.matrix)
532
+
533
+ def concatenated(self, other):
534
+ """Concatenate two transformations into one `Transformation`.
535
+
536
+ Parameters
537
+ ----------
538
+ other : :class:`compas.geometry.Transformation`
539
+ The transformation object to concatenate.
540
+
541
+ Returns
542
+ -------
543
+ :class:`compas.geometry.Transformation`
544
+ The new transformation that is the concatenation of this one and the other.
545
+
546
+ Notes
547
+ -----
548
+ Rz * Ry * Rx means that Rx is first transformation, Ry second, and Rz third.
549
+
550
+ """
551
+ cls = type(self)
552
+ if isinstance(other, cls):
553
+ return cls(multiply_matrices(self.matrix, other.matrix))
554
+ return Transformation(multiply_matrices(self.matrix, other.matrix))
@@ -0,0 +1,104 @@
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 matrix_from_translation
16
+ from compas.geometry import translation_from_matrix
17
+ from compas.itertools import flatten
18
+ from compas.tolerance import TOL
19
+
20
+
21
+ class Translation(Transformation):
22
+ """Class representing a translation transformation.
23
+
24
+ Parameters
25
+ ----------
26
+ matrix : list[list[float]], optional
27
+ A 4x4 matrix (or similar) representing a translation.
28
+ check : bool, optional
29
+ If ``True``, the provided matrix will be checked for validity.
30
+ name : str, optional
31
+ The name of the transformation.
32
+
33
+ Attributes
34
+ ----------
35
+ translation_vector : :class:`compas.geometry.Vector`
36
+ The translation vector.
37
+
38
+ Raises
39
+ ------
40
+ ValueError
41
+ If ``check`` is ``True`` and the provided transformation matrix is not a translation.
42
+
43
+ Examples
44
+ --------
45
+ >>> T = Translation.from_vector([1, 2, 3])
46
+ >>> T[0, 3] == 1
47
+ True
48
+ >>> T[1, 3] == 2
49
+ True
50
+ >>> T[2, 3] == 3
51
+ True
52
+
53
+ >>> from compas.geometry import Vector
54
+ >>> T = Translation.from_vector(Vector(1, 2, 3))
55
+ >>> T[0, 3] == 1
56
+ True
57
+ >>> T[1, 3] == 2
58
+ True
59
+ >>> T[2, 3] == 3
60
+ True
61
+
62
+ >>> T = Translation([[1, 0, 0, 1], [0, 1, 0, 2], [0, 0, 1, 3], [0, 0, 0, 1]])
63
+ >>> T[0, 3] == 1
64
+ True
65
+ >>> T[1, 3] == 2
66
+ True
67
+ >>> T[2, 3] == 3
68
+ True
69
+
70
+ """
71
+
72
+ def __init__(self, matrix=None, check=False, name=None):
73
+ if matrix and check:
74
+ translation = translation_from_matrix(matrix)
75
+ if not TOL.is_allclose(flatten(matrix), flatten(matrix_from_translation(translation))):
76
+ raise ValueError("This is not a proper translation matrix.")
77
+ super(Translation, self).__init__(matrix=matrix, name=name)
78
+
79
+ @property
80
+ def translation_vector(self):
81
+ from compas.geometry import Vector
82
+
83
+ x = self.matrix[0][3]
84
+ y = self.matrix[1][3]
85
+ z = self.matrix[2][3]
86
+ return Vector(x, y, z)
87
+
88
+ @classmethod
89
+ def from_vector(cls, vector):
90
+ """Create a translation transformation from a translation vector.
91
+
92
+ Parameters
93
+ ----------
94
+ vector : [float, float, float] | :class:`compas.geometry.Vector`
95
+ The translation vector.
96
+
97
+ Returns
98
+ -------
99
+ :class:`compas.geometry.Translation`
100
+ The translation transformation.
101
+
102
+ """
103
+ matrix = matrix_from_translation(vector)
104
+ return cls(matrix)