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,895 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ from math import fabs
6
+ from math import sqrt
7
+
8
+ from compas.itertools import pairwise
9
+ from compas.tolerance import TOL
10
+
11
+ from ._algebra import add_vectors
12
+ from ._algebra import add_vectors_xy
13
+ from ._algebra import cross_vectors
14
+ from ._algebra import cross_vectors_xy
15
+ from ._algebra import dot_vectors
16
+ from ._algebra import length_vector
17
+ from ._algebra import length_vector_sqrd
18
+ from ._algebra import length_vector_sqrd_xy
19
+ from ._algebra import length_vector_xy
20
+ from ._algebra import normalize_vector
21
+ from ._algebra import scale_vector
22
+ from ._algebra import subtract_vectors
23
+ from ._algebra import subtract_vectors_xy
24
+ from ._algebra import vector_component
25
+ from ._algebra import vector_component_xy
26
+
27
+
28
+ def distance_point_point(a, b):
29
+ """Compute the distance bewteen a and b.
30
+
31
+ Parameters
32
+ ----------
33
+ a : [float, float, float] | :class:`compas.geometry.Point`
34
+ XYZ coordinates of point a.
35
+ b : [float, float, float] | :class:`compas.geometry.Point`
36
+ XYZ coordinates of point b.
37
+
38
+ Returns
39
+ -------
40
+ float
41
+ Distance bewteen a and b.
42
+
43
+ Examples
44
+ --------
45
+ >>> distance_point_point([0.0, 0.0, 0.0], [2.0, 0.0, 0.0])
46
+ 2.0
47
+
48
+ See Also
49
+ --------
50
+ distance_point_point_xy
51
+
52
+ """
53
+ ab = subtract_vectors(b, a)
54
+ return length_vector(ab)
55
+
56
+
57
+ def distance_point_point_xy(a, b):
58
+ """Compute the distance between points a and b, assuming they lie in the XY plane.
59
+
60
+ Parameters
61
+ ----------
62
+ a : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
63
+ XY(Z) coordinates of a 2D or 3D point (Z will be ignored).
64
+ b : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
65
+ XY(Z) coordinates of a 2D or 3D point (Z will be ignored).
66
+
67
+ Returns
68
+ -------
69
+ float
70
+ Distance between a and b in the XY-plane.
71
+
72
+ Examples
73
+ --------
74
+ >>> distance_point_point_xy([0.0, 0.0], [2.0, 0.0])
75
+ 2.0
76
+
77
+ >>> distance_point_point_xy([0.0, 0.0, 0.0], [2.0, 0.0, 0.0])
78
+ 2.0
79
+
80
+ >>> distance_point_point_xy([0.0, 0.0, 1.0], [2.0, 0.0, 1.0])
81
+ 2.0
82
+
83
+ """
84
+ ab = subtract_vectors_xy(b, a)
85
+ return length_vector_xy(ab)
86
+
87
+
88
+ def distance_point_point_sqrd(a, b):
89
+ """Compute the squared distance bewteen points a and b.
90
+
91
+ Parameters
92
+ ----------
93
+ a : [float, float, float] | :class:`compas.geometry.Point`
94
+ XYZ coordinates of point a.
95
+ b : [float, float, float] | :class:`compas.geometry.Point`
96
+ XYZ coordinates of point b.
97
+
98
+ Returns
99
+ -------
100
+ float
101
+ Squared distance bewteen a and b.
102
+
103
+ Examples
104
+ --------
105
+ >>> distance_point_point_sqrd([0.0, 0.0, 0.0], [2.0, 0.0, 0.0])
106
+ 4.0
107
+
108
+ See Also
109
+ --------
110
+ distance_point_point_sqrd_xy
111
+
112
+ """
113
+ ab = subtract_vectors(b, a)
114
+ return length_vector_sqrd(ab)
115
+
116
+
117
+ def distance_point_point_sqrd_xy(a, b):
118
+ """Compute the squared distance between points a and b lying in the XY plane.
119
+
120
+ Parameters
121
+ ----------
122
+ a : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
123
+ XY(Z) coordinates of the first point.
124
+ b : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
125
+ XY(Z) coordinates of the second point.
126
+
127
+ Returns
128
+ -------
129
+ float
130
+ Squared distance between a and b in the XY-plane.
131
+
132
+ Examples
133
+ --------
134
+ >>> distance_point_point_sqrd_xy([0.0, 0.0], [2.0, 0.0])
135
+ 4.0
136
+
137
+ >>> distance_point_point_sqrd_xy([0.0, 0.0, 0.0], [2.0, 0.0, 0.0])
138
+ 4.0
139
+
140
+ >>> distance_point_point_sqrd_xy([0.0, 0.0, 1.0], [2.0, 0.0, 1.0])
141
+ 4.0
142
+
143
+ """
144
+ ab = subtract_vectors_xy(b, a)
145
+ return length_vector_sqrd_xy(ab)
146
+
147
+
148
+ def distance_point_line(point, line):
149
+ """Compute the distance between a point and a line.
150
+
151
+ Parameters
152
+ ----------
153
+ point : [float, float, float] | :class:`compas.geometry.Point`
154
+ Point location.
155
+ line : [point, point] | :class:`compas.geometry.Line`
156
+ Line defined by two points.
157
+
158
+ Returns
159
+ -------
160
+ float
161
+ The distance between the point and the line.
162
+
163
+ Notes
164
+ -----
165
+ This implementation computes the *right angle distance* from a point P to a
166
+ line defined by points A and B as twice the area of the triangle ABP divided
167
+ by the length of AB [1]_.
168
+
169
+ References
170
+ ----------
171
+ .. [1] Wikipedia. *Distance from a point to a line*.
172
+ Available at: https://en.wikipedia.org/wiki/Distance_from_a_point_to_a_line
173
+
174
+ Examples
175
+ --------
176
+ >>>
177
+
178
+ """
179
+ a, b = line
180
+ ab = subtract_vectors(b, a)
181
+ pa = subtract_vectors(a, point)
182
+ pb = subtract_vectors(b, point)
183
+ length = length_vector(cross_vectors(pa, pb))
184
+ length_ab = length_vector(ab)
185
+ return length / length_ab
186
+
187
+
188
+ def distance_point_line_xy(point, line):
189
+ """Compute the distance between a point and a line, assuming they lie in the XY-plane.
190
+
191
+ Parameters
192
+ ----------
193
+ point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
194
+ XY(Z) coordinates of the point.
195
+ line : [point, point] | :class:`compas.geometry.Line`
196
+ Line defined by two points.
197
+
198
+ Returns
199
+ -------
200
+ float
201
+ The distance between the point and the line.
202
+
203
+ Notes
204
+ -----
205
+ This implementation computes the orthogonal distance from a point P to a
206
+ line defined by points A and B as twice the area of the triangle ABP divided
207
+ by the length of AB [1]_.
208
+
209
+ References
210
+ ----------
211
+ .. [1] Wikipedia. *Distance from a point to a line*.
212
+ Available at: https://en.wikipedia.org/wiki/Distance_from_a_point_to_a_line.
213
+
214
+ """
215
+ a, b = line
216
+ ab = subtract_vectors_xy(b, a)
217
+ pa = subtract_vectors_xy(a, point)
218
+ pb = subtract_vectors_xy(b, point)
219
+ length = fabs(cross_vectors_xy(pa, pb)[2])
220
+ length_ab = length_vector_xy(ab)
221
+ return length / length_ab
222
+
223
+
224
+ def distance_point_line_sqrd(point, line):
225
+ """Compute the squared distance between a point and a line.
226
+
227
+ Parameters
228
+ ----------
229
+ point : [float, float, float] | :class:`compas.geometry.Point`
230
+ XYZ coordinates of the point.
231
+ line : [point, point] | :class:`compas.geometry.Line`
232
+ Line defined by two points.
233
+
234
+ Returns
235
+ -------
236
+ float
237
+ The squared distance between the point and the line.
238
+
239
+ Notes
240
+ -----
241
+ For more info, see [1]_.
242
+
243
+ References
244
+ ----------
245
+ .. [1] Wikipedia. *Distance from a point to a line*.
246
+ Available at: https://en.wikipedia.org/wiki/Distance_from_a_point_to_a_line.
247
+
248
+ """
249
+ a, b = line
250
+ ab = subtract_vectors(b, a)
251
+ pa = subtract_vectors(a, point)
252
+ pb = subtract_vectors(b, point)
253
+ length = length_vector_sqrd(cross_vectors(pa, pb))
254
+ length_ab = length_vector_sqrd(ab)
255
+ return length / length_ab
256
+
257
+
258
+ def distance_point_line_sqrd_xy(point, line):
259
+ """Compute the squared distance between a point and a line lying in the XY-plane.
260
+
261
+ Parameters
262
+ ----------
263
+ point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
264
+ XY(Z) coordinates of a 2D or 3D point (Z will be ignored).
265
+ line : [point, point] | :class:`compas.geometry.Line`
266
+ Line defined by two points.
267
+
268
+ Returns
269
+ -------
270
+ float
271
+ The squared distance between the point and the line.
272
+
273
+ Notes
274
+ -----
275
+ This implementation computes the orthogonal squared distance from a point P to a
276
+ line defined by points A and B as twice the area of the triangle ABP divided
277
+ by the length of AB [1]_.
278
+
279
+ References
280
+ ----------
281
+ .. [1] Wikipedia. *Distance from a point to a line*.
282
+ Available at: https://en.wikipedia.org/wiki/Distance_from_a_point_to_a_line.
283
+
284
+ """
285
+ a, b = line
286
+ ab = subtract_vectors_xy(b, a)
287
+ pa = subtract_vectors_xy(a, point)
288
+ pb = subtract_vectors_xy(b, point)
289
+ length = cross_vectors_xy(pa, pb)[2] ** 2
290
+ length_ab = length_vector_sqrd_xy(ab)
291
+ return length / length_ab
292
+
293
+
294
+ def distance_point_plane(point, plane):
295
+ r"""Compute the distance from a point to a plane defined by origin point and normal.
296
+
297
+ Parameters
298
+ ----------
299
+ point : [float, float, float] | :class:`compas.geometry.Point`
300
+ Point coordinates.
301
+ plane : [point, vector]
302
+ A point and a vector defining a plane.
303
+
304
+ Returns
305
+ -------
306
+ float
307
+ Distance between point and plane.
308
+
309
+ Notes
310
+ -----
311
+ The distance from a point to a plane can be computed from the coefficients
312
+ of the equation of the plane and the coordinates of the point [1]_.
313
+
314
+ The equation of a plane is
315
+
316
+ .. math::
317
+
318
+ Ax + By + Cz + D = 0
319
+
320
+ where
321
+
322
+ .. math::
323
+ :nowrap:
324
+
325
+ \begin{align}
326
+ D &= - Ax_0 - Bx_0 - Cz_0 \\
327
+ Q &= (x_0, y_0, z_0) \\
328
+ N &= (A, B, C)
329
+ \end{align}
330
+
331
+ with :math:`Q` a point on the plane, and :math:`N` the normal vector at
332
+ that point. The distance of any point :math:`P` to a plane is the
333
+ absolute value of the dot product of the vector from :math:`Q` to :math:`P`
334
+ and the normal at :math:`Q`.
335
+
336
+ References
337
+ ----------
338
+ .. [1] Nykamp, D. *Distance from point to plane*.
339
+ Available at: http://mathinsight.org/distance_point_plane.
340
+
341
+ Examples
342
+ --------
343
+ >>>
344
+
345
+ """
346
+ return fabs(distance_point_plane_signed(point, plane))
347
+
348
+
349
+ def distance_point_plane_signed(point, plane):
350
+ r"""Compute the signed distance from a point to a plane defined by origin point and normal.
351
+
352
+ Parameters
353
+ ----------
354
+ point : [float, float, float] | :class:`compas.geometry.Point`
355
+ Point coordinates.
356
+ plane : [point, vector]
357
+ A point and a vector defining a plane.
358
+
359
+ Returns
360
+ -------
361
+ float
362
+ Distance between point and plane.
363
+
364
+ Notes
365
+ -----
366
+ The distance from a point to a plane can be computed from the coefficients
367
+ of the equation of the plane and the coordinates of the point [1]_.
368
+
369
+ The equation of a plane is
370
+
371
+ .. math::
372
+
373
+ Ax + By + Cz + D = 0
374
+
375
+ where
376
+
377
+ .. math::
378
+ :nowrap:
379
+
380
+ \begin{align}
381
+ D &= - Ax_0 - Bx_0 - Cz_0 \\
382
+ Q &= (x_0, y_0, z_0) \\
383
+ N &= (A, B, C)
384
+ \end{align}
385
+
386
+ with :math:`Q` a point on the plane, and :math:`N` the normal vector at
387
+ that point. The distance of any point :math:`P` to a plane is the
388
+ value of the dot product of the vector from :math:`Q` to :math:`P`
389
+ and the normal at :math:`Q`.
390
+
391
+ References
392
+ ----------
393
+ .. [1] Nykamp, D. *Distance from point to plane*.
394
+ Available at: http://mathinsight.org/distance_point_plane.
395
+
396
+ Examples
397
+ --------
398
+ >>>
399
+
400
+ """
401
+ base, normal = plane
402
+ vector = subtract_vectors(point, base)
403
+ return dot_vectors(vector, normal)
404
+
405
+
406
+ def distance_line_line(l1, l2, tol=None):
407
+ r"""Compute the shortest distance between two lines.
408
+
409
+ Parameters
410
+ ----------
411
+ l1 : [point, point] | :class:`compas.geometry.Line`
412
+ Two points defining a line.
413
+ l2 : [point, point] | :class:`compas.geometry.Line`
414
+ Two points defining a line.
415
+ tol : float, optional
416
+ The tolerance for comparing values to zero.
417
+ Default is :attr:`TOL.absolute`.
418
+
419
+ Returns
420
+ -------
421
+ float
422
+ The distance between the two lines.
423
+
424
+ Notes
425
+ -----
426
+ The distance is the absolute value of the dot product of a unit vector that
427
+ is perpendicular to the two lines, and the vector between two points on the lines ([1]_, [2]_).
428
+
429
+ If each of the lines is defined by two points (:math:`l_1 = (\mathbf{x_1}, \mathbf{x_2})`,
430
+ :math:`l_2 = (\mathbf{x_3}, \mathbf{x_4})`), then the unit vector that is
431
+ perpendicular to both lines is...
432
+
433
+ References
434
+ ----------
435
+ .. [1] Weisstein, E.W. *Line-line Distance*.
436
+ Available at: http://mathworld.wolfram.com/Line-LineDistance.html.
437
+ .. [2] Wikipedia. *Skew lines Distance*.
438
+ Available at: https://en.wikipedia.org/wiki/Skew_lines#Distance.
439
+
440
+ Examples
441
+ --------
442
+ >>>
443
+
444
+ """
445
+ a, b = l1
446
+ c, d = l2
447
+ ab = subtract_vectors(b, a)
448
+ cd = subtract_vectors(d, c)
449
+ ac = subtract_vectors(c, a)
450
+ n = cross_vectors(ab, cd)
451
+ length = length_vector(n)
452
+ if TOL.is_zero(length, tol):
453
+ return distance_point_point(closest_point_on_line(l1[0], l2), l1[0])
454
+ n = scale_vector(n, 1.0 / length)
455
+ return fabs(dot_vectors(n, ac))
456
+
457
+
458
+ # ==============================================================================
459
+ # closest
460
+ # ==============================================================================
461
+
462
+
463
+ def sort_points(point, cloud):
464
+ """Sorts points of a pointcloud based on their distance from a given point.
465
+
466
+ Parameters
467
+ ----------
468
+ point : [float, float, float] | :class:`compas.geometry.Point`
469
+ The XYZ coordinates of the base point.
470
+ cloud : sequence[[float, float, float] | :class:`compas.geometry.Point`]
471
+ A sequence locations in three-dimensional space.
472
+
473
+ Returns
474
+ -------
475
+ list[[float, [float, float, float], int]]
476
+ A list containing the points of the cloud sorted by their squared distance to the base points.
477
+ Each item in the list contains the squared distance to the base point, the XYZ coordinates
478
+ of the point in the cloud, and the index of the point in the original cloud.
479
+
480
+ Notes
481
+ -----
482
+ Check kdTree class for an optimized implementation (MR).
483
+
484
+ Examples
485
+ --------
486
+ >>>
487
+
488
+ """
489
+ minsq = [distance_point_point_sqrd(p, point) for p in cloud]
490
+ return sorted(zip(minsq, cloud, range(len(cloud))), key=lambda x: x[0])
491
+
492
+
493
+ def sort_points_xy(point, cloud):
494
+ """Sorts points of a pointcloud based on their distance from a given point,
495
+ assuming all points lie in the XY plane.
496
+
497
+ Parameters
498
+ ----------
499
+ point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
500
+ XY(Z) coordinates of a point.
501
+ cloud : sequence[[float, float] or [float, float, float] | :class:`compas.geometry.Point`]
502
+ A list of points represented by their XY(Z) coordinates.
503
+
504
+ Returns
505
+ -------
506
+ list[[float, [float, float, 0.0], int]]
507
+ A list containing the points of the cloud sorted by their squared distance to the base points.
508
+ Each item in the list contains the squared distance to the base point, the XYZ coordinates
509
+ of the point in the cloud in the XY plane, and the index of the point in the original cloud.
510
+
511
+ Notes
512
+ -----
513
+ Check kdTree class for an optimized implementation (MR).
514
+
515
+ Examples
516
+ --------
517
+ >>>
518
+
519
+ """
520
+ minsq = [distance_point_point_sqrd_xy(p, point) for p in cloud]
521
+ return sorted(zip(minsq, cloud, range(len(cloud))), key=lambda x: x[0])
522
+
523
+
524
+ def closest_point_in_cloud(point, cloud):
525
+ """Calculates the closest point in a pointcloud.
526
+
527
+ Parameters
528
+ ----------
529
+ point : [float, float, float] | :class:`compas.geometry.Point`
530
+ XYZ coordinates of the base point.
531
+ cloud : sequence[[float, float, float] | :class:`compas.geometry.Point`]
532
+ A sequence locations in three-dimensional space.
533
+
534
+ Returns
535
+ -------
536
+ float
537
+ The distance to the closest point.
538
+ [float, float, float]
539
+ XYZ coordinates of the closest point.
540
+ int
541
+ The index of the closest point in the original list.
542
+
543
+ Notes
544
+ -----
545
+ Check kdTree class for an optimized implementation.
546
+
547
+ Examples
548
+ --------
549
+ >>>
550
+
551
+ """
552
+ data = sort_points(point, cloud)
553
+ d, xyz, index = data[0]
554
+ return sqrt(d), xyz, index
555
+
556
+
557
+ def closest_points_in_cloud_numpy(points, cloud, threshold=10**7, distances=True, num_nbrs=1):
558
+ """Find the closest points in a point cloud to a set of sample points.
559
+
560
+ Parameters
561
+ ----------
562
+ points : array_like [n x 3]
563
+ The sample points.
564
+ cloud : array_like [n x 3]
565
+ The cloud points to compare to.
566
+ threshold : float, optional
567
+ Only points within this distance are checked.
568
+ distances : bool, optional
569
+ If True, return the distance matrix in addition to the indices of the closest points.
570
+ num_nbrs : int, optional
571
+ The number of nearest neighbors to include in the result.
572
+
573
+ Returns
574
+ -------
575
+ list or tuple[list, array]
576
+ If `distances` is False, indices of the closest points in the cloud per point in points.
577
+ If `distances` is True, indices of the closest points in the cloud per point in points
578
+ and distances between points and closest points in cloud (n x n).
579
+
580
+ Notes
581
+ -----
582
+ Items in cloud further from items in points than threshold return zero
583
+ distance and will affect the indices returned if not set suitably high.
584
+
585
+ Examples
586
+ --------
587
+ >>> from numpy import allclose
588
+ >>> points = [[0, 0, 0], [1, 0, 0], [1, 1, 0], [0, 1, 0]]
589
+ >>> cloud = [[0, 0, 0], [1, 0, 0], [1, 1, 0], [0, 1, 0]]
590
+ >>> cp = closest_points_in_cloud_numpy(points, cloud, distances=True)
591
+ >>> allclose(cp[1], [[0, 1, 1.4142, 1], [1, 0, 1, 1.4142], [1.4142, 1, 0, 1], [1, 1.4142, 1, 0]])
592
+ True
593
+
594
+ """
595
+ from numpy import argmin
596
+ from numpy import argpartition
597
+ from numpy import asarray
598
+ from scipy.spatial import distance_matrix
599
+
600
+ points = asarray(points).reshape((-1, 3))
601
+ cloud = asarray(cloud).reshape((-1, 3))
602
+ d_matrix = distance_matrix(points, cloud, threshold=threshold)
603
+ if num_nbrs == 1:
604
+ indices = argmin(d_matrix, axis=1)
605
+ else:
606
+ indices = argpartition(d_matrix, num_nbrs, axis=1)
607
+ if distances:
608
+ return indices, d_matrix
609
+ return indices
610
+
611
+
612
+ def closest_point_in_cloud_xy(point, cloud):
613
+ """Calculates the closest point in a list of points in the XY-plane.
614
+
615
+ Parameters
616
+ ----------
617
+ point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
618
+ XY(Z) coordinates of a the base point.
619
+ cloud : sequence[[float, float] or [float, float, float] | :class:`compas.geometry.Point`]
620
+ A list of points forming the cloud, with each point represented by its XY(Z) coordinates.
621
+
622
+ Returns
623
+ -------
624
+ float
625
+ The distance to the closest point.
626
+ [float, float, 0.0]
627
+ The XYZ coordinates of the closest point in the XY plane.
628
+ int
629
+ The index of the closest point in the cloud.
630
+
631
+ Notes
632
+ -----
633
+ Check kdTree class for an optimized implementation (MR).
634
+
635
+ """
636
+ data = sort_points_xy(point, cloud)
637
+ d, xyz, index = data[0]
638
+ return sqrt(d), xyz, index
639
+
640
+
641
+ def closest_point_on_line(point, line):
642
+ """Computes closest point on line to a given point.
643
+
644
+ Parameters
645
+ ----------
646
+ point : [float, float, float] | :class:`compas.geometry.Point`
647
+ XYZ coordinates.
648
+ line : [point, point] | :class:`compas.geometry.Line`
649
+ Two points defining the line.
650
+
651
+ Returns
652
+ -------
653
+ [float, float, float]
654
+ XYZ coordinates of closest point.
655
+
656
+ Examples
657
+ --------
658
+ >>>
659
+
660
+ See Also
661
+ --------
662
+ :func:`basic.transformations.project_point_line`
663
+
664
+ """
665
+ a, b = line
666
+ ab = subtract_vectors(b, a)
667
+ ap = subtract_vectors(point, a)
668
+ c = vector_component(ap, ab)
669
+ return add_vectors(a, c)
670
+
671
+
672
+ def closest_point_on_line_xy(point, line):
673
+ """Compute closest point on line (continuous) to a given point lying in the XY-plane.
674
+
675
+ Parameters
676
+ ----------
677
+ point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
678
+ XY(Z) coordinates of a point.
679
+ line : [point, point] | :class:`compas.geometry.Line`
680
+ Two XY(Z) points defining a line.
681
+
682
+ Returns
683
+ -------
684
+ [float, float, 0.0]
685
+ XYZ coordinates of the closest point in the XY plane.
686
+
687
+ """
688
+ a, b = line
689
+ ab = subtract_vectors_xy(b, a)
690
+ ap = subtract_vectors_xy(point, a)
691
+ c = vector_component_xy(ap, ab)
692
+ return add_vectors_xy(a, c)
693
+
694
+
695
+ def closest_point_on_segment(point, segment):
696
+ """Computes closest point on line segment (p1, p2) to test point.
697
+
698
+ Parameters
699
+ ----------
700
+ point : [float, float, float] | :class:`compas.geometry.Point`
701
+ XYZ coordinates.
702
+ segment : [point, point] | :class:`compas.geometry.Line`
703
+ Two points defining the segment.
704
+
705
+ Returns
706
+ -------
707
+ [float, float, float]
708
+ XYZ coordinates of closest point.
709
+
710
+ Examples
711
+ --------
712
+ >>>
713
+
714
+ """
715
+ a, b = segment
716
+ p = closest_point_on_line(point, segment)
717
+ d = distance_point_point_sqrd(a, b)
718
+ d1 = distance_point_point_sqrd(a, p)
719
+ d2 = distance_point_point_sqrd(b, p)
720
+ if d1 > d or d2 > d:
721
+ if d1 < d2:
722
+ return a
723
+ return b
724
+ return p
725
+
726
+
727
+ def closest_point_on_segment_xy(point, segment):
728
+ """Compute closest point on a line segment to a given point lying in the XY-plane.
729
+
730
+ Parameters
731
+ ----------
732
+ point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
733
+ XY(Z) coordinates of a point.
734
+ segment : [point, point] | :class:`compas.geometry.Line`
735
+ Two 2D or 3D points defining the line segment (Z components will be ignored).
736
+
737
+ Returns
738
+ -------
739
+ [float, float, 0.0]
740
+ XYZ coordinates of closest point in the XY plane.
741
+
742
+ """
743
+ a, b = segment
744
+ p = closest_point_on_line_xy(point, segment)
745
+ d = distance_point_point_sqrd_xy(a, b)
746
+ d1 = distance_point_point_sqrd_xy(a, p)
747
+ d2 = distance_point_point_sqrd_xy(b, p)
748
+ if d1 > d or d2 > d:
749
+ if d1 < d2:
750
+ return [a[0], a[1], 0.0]
751
+ return [b[0], b[1], 0.0]
752
+ return p
753
+
754
+
755
+ def closest_point_on_polyline(point, polyline):
756
+ """Find the closest point on a polyline to a given point.
757
+
758
+ Parameters
759
+ ----------
760
+ point : [float, float, float] | :class:`compas.geometry.Point`
761
+ XYZ coordinates of a 2D or 3D point (Z will be ignored).
762
+ polyline : sequence[point] | :class:`compas.geometry.Polyline`
763
+ A sequence of XYZ coordinates representing the locations of the corners of a polyline.
764
+ The vertices are assumed to be in order.
765
+
766
+ Returns
767
+ -------
768
+ [float, float, float]
769
+ XYZ coordinates of closest point.
770
+
771
+ """
772
+ cloud = []
773
+
774
+ for segment in pairwise(polyline):
775
+ cloud.append(closest_point_on_segment(point, segment))
776
+
777
+ return closest_point_in_cloud(point, cloud)[1]
778
+
779
+
780
+ def closest_point_on_polyline_xy(point, polyline):
781
+ """Compute closest point on a polyline to a given point,
782
+ assuming they both lie in the XY-plane.
783
+
784
+ Parameters
785
+ ----------
786
+ point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
787
+ XY(Z) coordinates of a 2D or 3D point (Z will be ignored).
788
+ polyline : sequence[point] | :class:`compas.geometry.Polyline`
789
+ A sequence of XY(Z) coordinates of 2D or 3D points (Z will be ignored)
790
+ representing the locations of the corners of a polyline.
791
+ The vertices are assumed to be in order.
792
+
793
+ Returns
794
+ -------
795
+ [float, float, 0.0]
796
+ XYZ coordinates of closest point in the XY plane.
797
+
798
+ """
799
+ cloud = []
800
+
801
+ for segment in pairwise(polyline):
802
+ cloud.append(closest_point_on_segment_xy(point, segment))
803
+
804
+ return closest_point_in_cloud_xy(point, cloud)[1]
805
+
806
+
807
+ def closest_point_on_polygon_xy(point, polygon):
808
+ """Compute closest point on a polygon to a given point lying in the XY-plane.
809
+
810
+ Parameters
811
+ ----------
812
+ point : [float, float] or [float, float, float] | :class:`compas.geometry.Point`
813
+ XY(Z) coordinates of a 2D or 3D point (Z will be ignored).
814
+ polygon : sequence[point] | :class:`compas.geometry.Polygon`
815
+ A sequence of XY(Z) coordinates of 2D or 3D points
816
+ (Z will be ignored) representing the locations of the corners of a polygon.
817
+ The vertices are assumed to be in order. The polygon is assumed to be closed:
818
+ the first and last vertex in the sequence should not be the same.
819
+
820
+ Returns
821
+ -------
822
+ [float, float, 0.0]
823
+ XYZ coordinates of closest point in the XY plane.
824
+
825
+ """
826
+ points = []
827
+ for i in range(len(polygon)):
828
+ segment = polygon[i - 1], polygon[i]
829
+ points.append(closest_point_on_segment_xy(point, segment))
830
+
831
+ return closest_point_in_cloud_xy(point, points)[1]
832
+
833
+
834
+ def closest_point_on_plane(point, plane):
835
+ """Compute closest point on a plane to a given point.
836
+
837
+ Parameters
838
+ ----------
839
+ point : [float, float, float] | :class:`compas.geometry.Point`
840
+ XYZ coordinates of point.
841
+ plane : [point, vector]
842
+ The base point and normal defining the plane.
843
+
844
+ Returns
845
+ -------
846
+ [float, float, float]
847
+ XYZ coordinates of the closest point.
848
+
849
+ Notes
850
+ -----
851
+ For more info, see [1]_.
852
+
853
+ References
854
+ ----------
855
+ .. [1] Wikipedia. *Distance from a point to a plane*.
856
+ Available at: https://en.wikipedia.org/wiki/Distance_from_a_point_to_a_plane
857
+
858
+ Examples
859
+ --------
860
+ >>> plane = ([0.0, 0.0, 0.0], [0.0, 0.0, 1.0])
861
+ >>> point = [1.0, 2.0, 3.0]
862
+ >>> closest_point_on_plane(point, plane)
863
+ [1.0, 2.0, 0.0]
864
+
865
+ """
866
+ base, normal = plane
867
+ x, y, z = base
868
+ a, b, c = normalize_vector(normal)
869
+ x1, y1, z1 = point
870
+ d = a * x + b * y + c * z
871
+ k = (a * x1 + b * y1 + c * z1 - d) / (a**2 + b**2 + c**2)
872
+ return [x1 - k * a, y1 - k * b, z1 - k * c]
873
+
874
+
875
+ def closest_line_to_point(point, lines):
876
+ """Compute closest line to a point from a list of lines.
877
+
878
+ Parameters
879
+ ----------
880
+ point : [float, float, float] | :class:`compas.geometry.Point`
881
+ XYZ coordinates of point.
882
+ lines : sequence[[point, point] | :class:`compas.geometry.Line`].
883
+ The lines to be checked for distance.
884
+
885
+ Returns
886
+ -------
887
+ tuple[point, point]
888
+ The closest line.
889
+ """
890
+ cloud = []
891
+
892
+ for segment in lines:
893
+ cloud.append(closest_point_on_segment(point, segment))
894
+
895
+ return lines[closest_point_in_cloud(point, cloud)[2]]