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,724 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ from compas.geometry import Frame
6
+ from compas.geometry import Line
7
+ from compas.geometry import Point
8
+ from compas.geometry import is_point_on_line
9
+ from compas.geometry import is_point_on_polyline
10
+ from compas.geometry import transform_points
11
+ from compas.itertools import pairwise
12
+ from compas.tolerance import TOL
13
+
14
+ from .curve import Curve
15
+
16
+
17
+ class Polyline(Curve):
18
+ """A polyline is a curve defined by a sequence of points connected by line segments.
19
+
20
+ A Polyline can be open or closed.
21
+ It can be self-intersecting.
22
+ It does not have an interior.
23
+
24
+ The parameter space is defined along the consecutive direction vectors of the line segments of the polyline.
25
+ The coordinate system of the parametrisation is the world coordinate system.
26
+ Transformations of polylines are defined as transformations of the points defining the polyline.
27
+
28
+ Parameters
29
+ ----------
30
+ points : list[[float, float, float] | :class:`compas.geometry.Point`]
31
+ An ordered list of points.
32
+ Each consecutive pair of points forms a segment of the polyline.
33
+ name : str, optional
34
+ The name of the polyline.
35
+
36
+ Attributes
37
+ ----------
38
+ frame : :class:`compas.geometry.Frame`, read-only
39
+ The frame of the spatial coordinates of the polyline.
40
+ This is always the world XY frame.
41
+ points : list[:class:`compas.geometry.Point`]
42
+ The points of the polyline.
43
+ lines : list[:class:`compas.geometry.Line`], read-only
44
+ The lines of the polyline.
45
+ length : float, read-only
46
+ The length of the polyline.
47
+ start : :class:`compas.geometry.Point`, read-only
48
+ The start point of the polyline.
49
+ end : :class:`compas.geometry.Point`, read-only
50
+ The end point of the polyline.
51
+ is_selfintersecting : bool, read-only
52
+ True if the polyline is self-intersecting.
53
+ is_closed : bool, read-only
54
+ True if the polyline is closed.
55
+
56
+ Examples
57
+ --------
58
+ >>> polyline = Polyline([[0, 0, 0], [1, 0, 0], [2, 0, 0], [3, 0, 0]])
59
+ >>> polyline.length
60
+ 3.0
61
+
62
+ >>> type(polyline.points[0]) == Point
63
+ True
64
+ >>> polyline.points[0].x
65
+ 0.0
66
+
67
+ >>> type(polyline.lines[0]) == Line
68
+ True
69
+ >>> polyline.lines[0].length
70
+ 1.0
71
+
72
+ """
73
+
74
+ # overwriting the __new__ method is necessary
75
+ # to avoid triggering the plugin mechanism of the base curve class
76
+ def __new__(cls, *args, **kwargs):
77
+ curve = object.__new__(cls)
78
+ curve.__init__(*args, **kwargs)
79
+ return curve
80
+
81
+ DATASCHEMA = {
82
+ "type": "object",
83
+ "properties": {
84
+ "points": {"type": "array", "minItems": 2, "items": Point.DATASCHEMA},
85
+ },
86
+ "required": ["points"],
87
+ }
88
+
89
+ @property
90
+ def __data__(self):
91
+ return {"points": [point.__data__ for point in self.points]}
92
+
93
+ def __init__(self, points, name=None):
94
+ super(Polyline, self).__init__(name=name)
95
+ self._points = []
96
+ self._lines = []
97
+ self.points = points
98
+
99
+ def __repr__(self):
100
+ return "{0}({1!r})".format(
101
+ type(self).__name__,
102
+ self.points,
103
+ )
104
+
105
+ def __getitem__(self, key):
106
+ return self.points[key]
107
+
108
+ def __setitem__(self, key, value):
109
+ self.points[key] = Point(*value)
110
+ self._lines = None
111
+
112
+ def __iter__(self):
113
+ return iter(self.points)
114
+
115
+ def __len__(self):
116
+ return len(self.points)
117
+
118
+ def __eq__(self, other):
119
+ if not hasattr(other, "__iter__") or not hasattr(other, "__len__") or len(self) != len(other):
120
+ return False
121
+ return TOL.is_allclose(self, other)
122
+
123
+ # ==========================================================================
124
+ # properties
125
+ # ==========================================================================
126
+
127
+ @property
128
+ def frame(self):
129
+ return Frame.worldXY()
130
+
131
+ @frame.setter
132
+ def frame(self, frame):
133
+ raise AttributeError("Setting the coordinate frame of a polyline is not supported.")
134
+
135
+ @property
136
+ def points(self):
137
+ return self._points
138
+
139
+ @points.setter
140
+ def points(self, points):
141
+ self._points = [Point(*xyz) for xyz in points]
142
+ self._lines = None
143
+
144
+ @property
145
+ def lines(self):
146
+ if self._lines is None:
147
+ self._lines = [Line(a, b) for a, b in pairwise(self.points)]
148
+ return self._lines
149
+
150
+ @property
151
+ def length(self):
152
+ return sum([line.length for line in self.lines])
153
+
154
+ @property
155
+ def start(self):
156
+ return self.points[0]
157
+
158
+ @property
159
+ def end(self):
160
+ return self.points[-1]
161
+
162
+ @property
163
+ def is_selfintersecting(self):
164
+ raise NotImplementedError
165
+
166
+ @property
167
+ def is_closed(self):
168
+ return self.points[0] == self.points[-1]
169
+
170
+ # ==========================================================================
171
+ # Constructors
172
+ # ==========================================================================
173
+
174
+ # ==========================================================================
175
+ # Transformations
176
+ # ==========================================================================
177
+
178
+ def transform(self, T):
179
+ """Transform this polyline.
180
+
181
+ Parameters
182
+ ----------
183
+ T : :class:`compas.geometry.Transformation` | list[list[float]]
184
+ The transformation.
185
+
186
+ Examples
187
+ --------
188
+ >>> from math import radians
189
+ >>> from compas.geometry import Rotation
190
+ >>> polyline = Polyline([[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0], [0.0, 1.0, 0.0], [0.0, 0.0, 0.0]])
191
+ >>> R = Rotation.from_axis_and_angle([0.0, 0.0, 1.0], radians(90))
192
+ >>> polyline.transform(R)
193
+
194
+ """
195
+ for index, point in enumerate(transform_points(self.points, T)):
196
+ self.points[index].x = point[0]
197
+ self.points[index].y = point[1]
198
+ self.points[index].z = point[2]
199
+
200
+ # ==========================================================================
201
+ # Methods
202
+ # ==========================================================================
203
+
204
+ def append(self, point):
205
+ """Append a point to the end of the polyline.
206
+
207
+ Parameters
208
+ ----------
209
+ point : [float, float, float] | :class:`compas.geometry.Point`
210
+ The point to append.
211
+
212
+ """
213
+ self.points.append(Point(*point))
214
+ self._lines = None
215
+
216
+ def insert(self, i, point):
217
+ """Insert a point at the specified index.
218
+
219
+ Parameters
220
+ ----------
221
+ i : int
222
+ The index of the insertion point.
223
+ point : [float, float, float] | :class:`compas.geometry.Point`
224
+ The point to insert.
225
+
226
+ """
227
+ self.points.insert(i, Point(*point))
228
+ self._lines = None
229
+
230
+ def point_at(self, t, snap=False):
231
+ """Point on the polyline at a specific normalized parameter.
232
+
233
+ Parameters
234
+ ----------
235
+ t : float
236
+ The parameter value.
237
+ snap : bool, optional
238
+ If True, return the closest polyline point.
239
+
240
+ Returns
241
+ -------
242
+ :class:`compas.geometry.Point`
243
+ The point on the polyline.
244
+
245
+ Examples
246
+ --------
247
+ >>> polyline = Polyline([[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0]])
248
+ >>> polyline.point(0.75)
249
+ Point(1.000, 0.500, 0.000)
250
+
251
+ """
252
+ if t < 0 or t > 1:
253
+ return None
254
+
255
+ points = self.points
256
+ if t == 0:
257
+ return points[0]
258
+ if t == 1:
259
+ return points[-1]
260
+
261
+ polyline_length = self.length
262
+
263
+ x = 0
264
+ i = 0
265
+ while x <= t:
266
+ line = Line(points[i], points[i + 1])
267
+ line_length = line.length
268
+ dx = line_length / polyline_length
269
+ if x + dx > t:
270
+ if snap:
271
+ if t - x < x + dx - t:
272
+ return line.start
273
+ else:
274
+ return line.end
275
+ return line.point_at((t - x) * polyline_length / line_length)
276
+ x += dx
277
+ i += 1
278
+
279
+ def parameter_at(self, point, tol=None):
280
+ """Parameter of the polyline at a specific point.
281
+
282
+ Parameters
283
+ ----------
284
+ point : [float, float, float] | :class:`compas.geometry.Point`
285
+ The point on the polyline.
286
+ tol : float, optional
287
+ A tolerance value for verifying that the point is on the polyline.
288
+ Default is :attr:`TOL.absolute`.
289
+
290
+ Returns
291
+ -------
292
+ float
293
+ The parameter of the polyline.
294
+
295
+ Examples
296
+ --------
297
+ >>> from compas.geometry import Point
298
+ >>> polyline = Polyline([[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0]])
299
+ >>> polyline.parameter_at(Point(0.1, 0.0, 0.0))
300
+ 0.5
301
+
302
+ """
303
+ if not is_point_on_polyline(point, self, tol):
304
+ raise Exception("{} not found!".format(point))
305
+ dx = 0
306
+ for line in self.lines:
307
+ if not is_point_on_line(point, line, tol):
308
+ dx += line.length
309
+ continue
310
+ dx += line.start.distance_to_point(point)
311
+ break
312
+ return dx / self.length
313
+
314
+ def tangent_at(self, t):
315
+ """Tangent vector at a specific normalized parameter.
316
+
317
+ Parameters
318
+ ----------
319
+ t : float
320
+ The parameter value.
321
+
322
+ Returns
323
+ -------
324
+ :class:`compas.geometry.Vector`
325
+ The tangent vector at the specified parameter.
326
+
327
+ Examples
328
+ --------
329
+ >>> polyline = Polyline([[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [1.0, 1.0, 0.0]])
330
+ >>> polyline.tangent(0.75)
331
+ Vector(0.000, 1.000, 0.000)
332
+
333
+ """
334
+ if t < 0 or t > 1:
335
+ return None
336
+
337
+ points = self.points
338
+ if t == 0:
339
+ return points[1] - points[0]
340
+ if t == 1:
341
+ return points[-1] - points[-2]
342
+
343
+ polyline_length = self.length
344
+
345
+ x = 0
346
+ i = 0
347
+ while x <= t:
348
+ line = Line(points[i], points[i + 1])
349
+ line_length = line.length
350
+ dx = line_length / polyline_length
351
+ if x + dx > t:
352
+ return line.direction
353
+ x += dx
354
+ i += 1
355
+
356
+ def tangent_at_point(self, point):
357
+ """Calculates the tangent vector of a point on a polyline
358
+
359
+ Parameters
360
+ ----------
361
+ point: [float, float, float] | :class:`compas.geometry.Point`
362
+
363
+ Returns
364
+ -------
365
+ :class:`compas.geometry.Vector`
366
+
367
+ """
368
+ for line in self.lines:
369
+ if is_point_on_line(point, line):
370
+ return line.direction
371
+ raise Exception("{} not found!".format(point))
372
+
373
+ def split_at_corners(self, angle_threshold):
374
+ """Splits a polyline at corners larger than the given angle_threshold
375
+
376
+ Parameters
377
+ ----------
378
+ angle_threshold : float
379
+ In radians.
380
+
381
+ Returns
382
+ -------
383
+ list[:class:`compas.geometry.Polyline`]
384
+
385
+ """
386
+ corner_ids = []
387
+ split_polylines = []
388
+ points = self.points
389
+ seg_ids = list(range(len(self.lines)))
390
+
391
+ if self.is_closed:
392
+ seg_ids.append(0)
393
+
394
+ for seg1, seg2 in pairwise(seg_ids):
395
+ angle = self.lines[seg2].vector.angle(-self.lines[seg1].vector)
396
+ if angle >= angle_threshold:
397
+ corner_ids.append(seg1 + 1)
398
+
399
+ if self.is_closed and len(corner_ids) > 0:
400
+ if corner_ids[-1] != len(points):
401
+ corner_ids = [corner_ids[-1]] + corner_ids
402
+ else:
403
+ corner_ids = [0] + corner_ids + [len(points)]
404
+
405
+ for id1, id2 in pairwise(corner_ids):
406
+ if id1 < id2:
407
+ split_polylines.append(Polyline(points[id1 : id2 + 1]))
408
+ else:
409
+ looped_pts = [points[i] for i in range(id1, len(points))] + points[1 : id2 + 1]
410
+ split_polylines.append(Polyline(looped_pts))
411
+
412
+ if self.is_closed and not corner_ids:
413
+ return [Polyline(self.points)]
414
+
415
+ return split_polylines
416
+
417
+ def divide_at_corners(self, angle_threshold):
418
+ """Divides a polyline at corners larger than the given angle_threshold
419
+
420
+ Parameters
421
+ ----------
422
+ angle_threshold : float
423
+ In radians.
424
+
425
+ Returns
426
+ -------
427
+ list[:class:`compas.geometry.Point`]
428
+
429
+ """
430
+ corner_ids = []
431
+ seg_ids = list(range(len(self.lines)))
432
+ if self.is_closed:
433
+ seg_ids.insert(0, seg_ids[-1])
434
+
435
+ for seg1, seg2 in pairwise(seg_ids):
436
+ angle = self.lines[seg2].vector.angle(-self.lines[seg1].vector)
437
+ if angle >= angle_threshold:
438
+ corner_ids.append(seg1 + 1)
439
+ return [self.points[i] for i in corner_ids]
440
+
441
+ def divide(self, num_segments):
442
+ """Divide a polyline in equal segments.
443
+
444
+ Parameters
445
+ ----------
446
+ num_segments : int
447
+
448
+ Returns
449
+ -------
450
+ list
451
+ list[:class:`compas.geometry.Point`]
452
+
453
+ Examples
454
+ --------
455
+ >>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
456
+ >>> divided_polylines = polyline.divide(3)
457
+ >>> divided_polyline
458
+ [Point(0.000, 0.000, 0.000), Point(1.578, 2.157, 0.000), Point(3.578, 3.789, 0.000), Point(5.000, 2.000, 0.000)]
459
+
460
+ """
461
+ segment_length = self.length / num_segments
462
+ return self.divide_by_length(segment_length, False)
463
+
464
+ def divide_by_length(self, length, strict=True, tol=1e-06):
465
+ """Divide a polyline in segments of a given length.
466
+
467
+ Parameters
468
+ ----------
469
+ length : float
470
+ Length of the segments.
471
+ strict : bool, optional
472
+ If False, the remainder segment will be added even if it is smaller than the desired length
473
+ tol : float, optional
474
+ Floating point error tolerance.
475
+
476
+ Returns
477
+ -------
478
+ list[:class:`compas.geometry.Point`]
479
+
480
+ Notes
481
+ -----
482
+ The points of the new polyline are constrained to the segments of the old polyline.
483
+ However, since the old points are not part of the new set of points, the geometry of the polyline will change.
484
+
485
+ Examples
486
+ --------
487
+ >>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
488
+ >>> divided_polylines = polyline.divide_by_length(3)
489
+ >>> divided_polyline
490
+ [Point(0.000, 0.000, 0.000), Point(1.709, 2.418, 0.000), Point(4.051, 3.898, 0.000)]
491
+
492
+ >>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
493
+ >>> divided_polylines = polyline.divide_by_length(3, strict=False)
494
+ >>> divided_polyline
495
+ [Point(0.000, 0.000, 0.000), Point(1.709, 2.418, 0.000), Point(4.051, 3.898, 0.000), Point(5.000, 2.000, 0.000)]
496
+
497
+ """
498
+ num_pts = int(self.length / length)
499
+ total_length = [0, 0]
500
+ division_pts = [self.points[0]]
501
+ new_polyline = self
502
+
503
+ for i in range(num_pts):
504
+ for i_ln, line in enumerate(new_polyline.lines):
505
+ total_length.append(total_length[-1] + line.length) # type: ignore
506
+ if total_length[-1] > length:
507
+ amp = (length - total_length[-2]) / line.length
508
+ new_pt = line.start + line.vector.scaled(amp)
509
+ division_pts.append(new_pt)
510
+ total_length = [0, 0]
511
+ remaining_pts = new_polyline.points[i_ln + 2 :]
512
+ new_polyline = Polyline([new_pt, line.end] + remaining_pts)
513
+ break
514
+ elif total_length[-1] == length:
515
+ total_length = [0, 0]
516
+ division_pts.append(line.end)
517
+
518
+ if len(division_pts) == num_pts + 1:
519
+ break
520
+
521
+ if strict is False and not self.is_closed and len(division_pts) < num_pts + 1:
522
+ division_pts.append(new_polyline.points[-1])
523
+ elif strict is False and division_pts[-1].distance_to_point(self.points[-1]) > tol:
524
+ division_pts.append(self.points[-1])
525
+
526
+ return division_pts
527
+
528
+ def split_by_length(self, length, strict=True):
529
+ """Split a polyline in segments of a given length.
530
+
531
+ Parameters
532
+ ----------
533
+ length : float
534
+ Length of the segments.
535
+ strict : bool, optional
536
+ If False, the remainder segment will be added even if it is smaller than the desired length
537
+ tol : float, optional
538
+ Floating point error tolerance.
539
+
540
+ Returns
541
+ -------
542
+ list[:class:`compas.geometry.Polyline`]
543
+
544
+ Examples
545
+ --------
546
+ >>> from compas.geometry import Polyline
547
+ >>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
548
+ >>> split_polylines = polyline.split_polyline_by_length(3)
549
+ >>> split_polylines
550
+ [Polyline([Point(0.000, 0.000, 0.000), Point(1.000, 1.000, 0.000), Point(1.709, 2.418, 0.000)]),\
551
+ Polyline([Point(1.709, 2.418, 0.000), Point(2.000, 3.000, 0.000), Point(4.000, 4.000, 0.000),\
552
+ Point(4.051, 3.898, 0.000)])]
553
+
554
+ >>> from compas.geometry import Polyline
555
+ >>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
556
+ >>> split_polylines = polyline.split_polyline_by_length(3, strict=False)
557
+ >>> split_polylines
558
+ [Polyline([Point(0.000, 0.000, 0.000), Point(1.000, 1.000, 0.000), Point(1.709, 2.418, 0.000)]),\
559
+ Polyline([Point(1.709, 2.418, 0.000), Point(2.000, 3.000, 0.000), Point(4.000, 4.000, 0.000),\
560
+ Point(4.051, 3.898, 0.000)]), Polyline([Point(4.051, 3.898, 0.000), Point(5.000, 2.000, 0.000)])]
561
+
562
+ """
563
+ if length <= 0:
564
+ raise ValueError("Length should be bigger than 0.")
565
+ elif length > self.length:
566
+ raise ValueError("Polyline length {0} is smaller than input length {1}.".format(self.length, length))
567
+ divided_polylines = []
568
+ polyline_copy = self.copy()
569
+ segment = Polyline([self[0]]) # Start a new segment
570
+ i, current_length = 0, 0
571
+ polyline_points_num = len(polyline_copy)
572
+ while i < polyline_points_num - 1:
573
+ pt1, pt2 = polyline_copy.points[i : i + 2]
574
+ line_length = pt1.distance_to_point(pt2)
575
+ current_length += line_length
576
+ if current_length <= length:
577
+ segment.points.append(pt2)
578
+ i += 1
579
+ else:
580
+ amp = 1 - ((current_length - length) / line_length)
581
+ new_pt = pt1 + (pt2 - pt1).scaled(amp)
582
+ polyline_copy.points.insert(i + 1, new_pt)
583
+ segment.points.append(new_pt)
584
+ divided_polylines.append(segment)
585
+ segment = Polyline([new_pt]) # Start a new segment
586
+ current_length = 0
587
+ i += 1
588
+ polyline_points_num = len(polyline_copy)
589
+ if not strict and len(divided_polylines):
590
+ divided_polylines.append(segment) # Add the last segment
591
+ return divided_polylines
592
+
593
+ def split(self, num_segments):
594
+ """Split a polyline in equal segments.
595
+
596
+ Parameters
597
+ ----------
598
+ num_segments : int
599
+
600
+ Returns
601
+ -------
602
+ list
603
+ list[:class:`compas.geometry.Polyline`]
604
+
605
+ Examples
606
+ --------
607
+ >>> from compas.geometry import Polyline
608
+ >>> polyline = Polyline([(0, 0, 0), (1, 1, 0), (2, 3, 0), (4, 4, 0), (5, 2, 0)])
609
+ >>> split_polylines = polyline.split_polyline(3)
610
+ >>> split_polylines
611
+ [Polyline([Point(0.000, 0.000, 0.000), Point(1.000, 1.000, 0.000), Point(1.578, 2.157, 0.000)]),\
612
+ Polyline([Point(1.578, 2.157, 0.000), Point(2.000, 3.000, 0.000), Point(3.578, 3.789, 0.000)]),\
613
+ Polyline([Point(3.578, 3.789, 0.000), Point(4.000, 4.000, 0.000), Point(5.000, 2.000, 0.000)])]
614
+ """
615
+ if num_segments < 1:
616
+ raise ValueError("Number of segments must be greater than or equal to 1.")
617
+ elif num_segments == 1:
618
+ return [self]
619
+ total_length = self.length
620
+ segment_length = total_length / num_segments
621
+ return self.split_by_length(segment_length, False)
622
+
623
+ def extend(self, length):
624
+ """Extends a polyline by a given length, by modifying the first and/or last point tangentially.
625
+
626
+ Parameters
627
+ ----------
628
+ length: float or tuple[float, float]
629
+ A single length value to extend the polyline only at the end,
630
+ or two length values to extend at both ends.
631
+
632
+ Returns
633
+ -------
634
+ None
635
+
636
+ """
637
+ try:
638
+ start, end = length
639
+ self.points[0] = self.points[0] + self.lines[0].vector.unitized().scaled(-start)
640
+ self._lines = None
641
+ except TypeError:
642
+ start = end = length
643
+ self.points[-1] = self.points[-1] + self.lines[-1].vector.unitized().scaled(end)
644
+ self._lines = None
645
+
646
+ def extended(self, length):
647
+ """Returns a copy of this polyline extended by a given length.
648
+
649
+ Parameters
650
+ ----------
651
+ length: float or tuple[float, float]
652
+ A single length value to extend the polyline only at the end,
653
+ or two length values to extend at both ends.
654
+
655
+ Returns
656
+ -------
657
+ :class:`compas.geometry.Polyline`
658
+
659
+ """
660
+ crv = self.copy()
661
+ crv.extend(length)
662
+ return crv
663
+
664
+ def shorten(self, length):
665
+ """Shortens a polyline by a given length.
666
+
667
+ Parameters
668
+ ----------
669
+ length: float or tuple[float, float]
670
+ A single length value to shorten the polyline only at the end,
671
+ or two length values to shorten at both ends.
672
+
673
+ Returns
674
+ -------
675
+ None
676
+
677
+ """
678
+ try:
679
+ start, end = length
680
+ total_length = 0
681
+ for line in self.lines:
682
+ total_length += line.length
683
+ if total_length < start:
684
+ del self.points[0]
685
+ elif total_length == start:
686
+ del self.points[0]
687
+ break
688
+ else:
689
+ self.points[0] = line.end + line.vector.unitized().scaled(-(total_length - start))
690
+ break
691
+ except TypeError:
692
+ start = end = length
693
+
694
+ total_length = 0
695
+ for i in range(len(self.lines)):
696
+ line = self.lines[-(i + 1)]
697
+ total_length += line.length
698
+ if total_length < end:
699
+ del self.points[-1]
700
+ elif total_length == end:
701
+ del self.points[-1]
702
+ break
703
+ else:
704
+ self.points[-1] = line.start + line.vector.unitized().scaled(total_length - end)
705
+ break
706
+ self._lines = None
707
+
708
+ def shortened(self, length):
709
+ """Returns a copy of this polyline shortened by a given length.
710
+
711
+ Parameters
712
+ ----------
713
+ length: float or tuple[float, float]
714
+ A single length value to shorten the polyline only at the end,
715
+ or two length values to shorten at both ends.
716
+
717
+ Returns
718
+ -------
719
+ :class:`compas.geometry.Polyline`
720
+
721
+ """
722
+ crv = self.copy()
723
+ crv.shorten(length)
724
+ return crv