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,31 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ from compas.plugins import pluggable
6
+
7
+
8
+ @pluggable(category="trimesh")
9
+ def trimesh_massmatrix(M):
10
+ """Compute massmatrix on a triangle mesh using a scalarfield of data points
11
+ assigned to its vertices.
12
+
13
+ Parameters
14
+ ----------
15
+ M : tuple[sequence[[float, float, float] | :class:`compas.geometry.Point`], sequence[[int, int, int]]]
16
+ A mesh represented by a list of vertices and a list of faces.
17
+
18
+ Returns
19
+ -------
20
+ list[float]
21
+ The mass per vertex.
22
+
23
+ Examples
24
+ --------
25
+ >>>
26
+
27
+ """
28
+ raise NotImplementedError
29
+
30
+
31
+ trimesh_massmatrix.__pluggable__ = True
@@ -0,0 +1,191 @@
1
+ from numpy import asarray
2
+ from numpy import bincount
3
+ from numpy import cross
4
+ from numpy import zeros
5
+ from scipy.sparse import coo_matrix
6
+ from scipy.sparse import spdiags
7
+
8
+ from compas.geometry import cross_vectors
9
+ from compas.geometry import dot_vectors
10
+ from compas.geometry import length_vector
11
+ from compas.linalg import normrow
12
+
13
+
14
+ def trimesh_edge_cotangent(mesh, edge):
15
+ """Compute the cotangent of the angle opposite a halfedge of the triangle mesh.
16
+
17
+ Parameters
18
+ ----------
19
+ mesh : :class:`compas.datastructures.Mesh`
20
+ Instance of mesh.
21
+ edge : tuple[int, int]
22
+ The identifier of the halfedge.
23
+
24
+ Returns
25
+ -------
26
+ float
27
+ The edge cotangent.
28
+
29
+ """
30
+ u, v = edge
31
+ face = mesh.halfedge[u][v]
32
+ cotangent = 0.0
33
+ if face is not None:
34
+ w = mesh.face_vertex_ancestor(face, u)
35
+ wu = mesh.edge_vector((w, u))
36
+ wv = mesh.edge_vector((w, v))
37
+ length = length_vector(cross_vectors(wu, wv))
38
+ if length:
39
+ cotangent = dot_vectors(wu, wv) / length
40
+ return cotangent
41
+
42
+
43
+ def trimesh_edge_cotangents(mesh, edge):
44
+ """Compute the cotangents of the angles opposite both sides of an edge of the triangle mesh.
45
+
46
+ Parameters
47
+ ----------
48
+ mesh : :class:`compas.datastructures.Mesh`
49
+ Instance of mesh.
50
+ edge : tuple[int, int]
51
+ The identifier of the edge.
52
+
53
+ Returns
54
+ -------
55
+ tuple[float, float]
56
+ The two edge cotangents.
57
+
58
+ """
59
+ u, v = edge
60
+ a = trimesh_edge_cotangent(mesh, (u, v))
61
+ b = trimesh_edge_cotangent(mesh, (v, u))
62
+ return a, b
63
+
64
+
65
+ def trimesh_cotangent_laplacian_matrix(mesh, rtype="csr"):
66
+ r"""Construct the Laplacian of a triangular mesh with cotangent weights.
67
+
68
+ Parameters
69
+ ----------
70
+ mesh : :class:`compas.datastructures.Mesh`
71
+ Instance of mesh.
72
+
73
+ Returns
74
+ -------
75
+ array_like
76
+ The Laplacian matrix with cotangent weights.
77
+
78
+ Notes
79
+ -----
80
+ The cotangent laplacian of a vertex :math:`\mathbf{v}_{i}` points from the vertex
81
+ to the projection of the vertex into the 1-ring plane.
82
+ The cotangent laplacian vectors of a mesh thus provide an approximation of the
83
+ per-vertex normals.
84
+
85
+ The :math:`n \times n` cotangent Laplacian matrix :math:`\mathbf{L}` of a mesh
86
+ with vertices :math:`\mathbf{V}` and edges :math:`\mathbf{E}` is defined as
87
+ follows [1]_
88
+
89
+ .. math::
90
+
91
+ \mathbf{L}_{ij} =
92
+ \begin{cases}
93
+ -1 & \text{if i = j} \\
94
+ w_{ij} & \text{if (i, j) \in \mathbf{E}} \\
95
+ 0 & \text{otherwise}
96
+ \end{cases}
97
+
98
+ with
99
+
100
+ .. math::
101
+
102
+ w_{ij} = \frac{\omega_{ij}}{\sum_{(i, k) \in \mathbf{E}_{i}} \omega_{ik}}
103
+
104
+ References
105
+ ----------
106
+ .. [1] Nealen A., Igarashi T., Sorkine O. and Alexa M.
107
+ `Laplacian Mesh Optimization <https://igl.ethz.ch/projects/Laplacian-mesh-processing/Laplacian-mesh-optimization/lmo.pdf>`_.
108
+
109
+ """
110
+ vertex_index = mesh.vertex_index()
111
+ n = mesh.number_of_vertices()
112
+ data = []
113
+ rows = []
114
+ cols = []
115
+
116
+ for vertex in mesh.vertices():
117
+ nbrs = mesh.vertex_neighbors(vertex)
118
+ i = vertex_index[vertex]
119
+ data.append(-1.0)
120
+ rows.append(i)
121
+ cols.append(i)
122
+
123
+ W = 0
124
+ for nbr in nbrs:
125
+ a, b = trimesh_edge_cotangents(mesh, (vertex, nbr))
126
+ w = a + b
127
+ W += w
128
+
129
+ for nbr in nbrs:
130
+ j = vertex_index[nbr]
131
+ a, b = trimesh_edge_cotangents(mesh, (vertex, nbr))
132
+ w = a + b
133
+ data.append(w / W)
134
+ rows.append(i)
135
+ cols.append(j)
136
+
137
+ L = coo_matrix((data, (rows, cols)), shape=(n, n))
138
+
139
+ if rtype == "csr":
140
+ return L.tocsr()
141
+ if rtype == "csc":
142
+ return L.tocsc()
143
+ if rtype == "array":
144
+ return L.toarray()
145
+ if rtype == "list":
146
+ return L.toarray().tolist()
147
+ return L
148
+
149
+
150
+ def trimesh_positive_cotangent_laplacian_matrix(mesh):
151
+ raise NotImplementedError
152
+
153
+
154
+ def trimesh_vertexarea_matrix(mesh):
155
+ """Compute the n x n diagonal matrix of per-vertex voronoi areas.
156
+
157
+ Parameters
158
+ ----------
159
+ mesh : :class:`compas.datastructures.Mesh`
160
+ The triangle mesh data structure.
161
+
162
+ Returns
163
+ -------
164
+ sparse matrix
165
+ The diagonal voronoi area matrix.
166
+
167
+ Examples
168
+ --------
169
+ >>> from compas.datastructures import Mesh
170
+ >>> mesh = Mesh.from_polygons([[[0, 0, 0], [1, 0, 0], [0, 1, 0]]])
171
+ >>> A = trimesh_vertexarea_matrix(mesh)
172
+ >>> A.diagonal().tolist()
173
+ [0.1666, 0.1666, 0.1666]
174
+
175
+ """
176
+ vertex_index = mesh.vertex_index()
177
+ xyz = asarray(mesh.vertices_attributes("xyz"), dtype=float)
178
+ tris = asarray(
179
+ [[vertex_index[vertex] for vertex in mesh.face_vertices(face)] for face in mesh.faces()],
180
+ dtype=int,
181
+ )
182
+ e1 = xyz[tris[:, 1]] - xyz[tris[:, 0]]
183
+ e2 = xyz[tris[:, 2]] - xyz[tris[:, 0]]
184
+ n = cross(e1, e2)
185
+ a = 0.5 * normrow(n).ravel()
186
+ a3 = a / 3.0
187
+ area = zeros(xyz.shape[0])
188
+ for i in (0, 1, 2):
189
+ b = bincount(tris[:, i], a3)
190
+ area[: len(b)] += b
191
+ return spdiags(area, 0, xyz.shape[0], xyz.shape[0])
@@ -0,0 +1,55 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ from compas.plugins import pluggable
6
+
7
+
8
+ @pluggable(category="trimesh")
9
+ def trimesh_harmonic(M):
10
+ """Compute the harmonic parametrisation of a triangle mesh within a fixed circular boundary.
11
+
12
+ Parameters
13
+ ----------
14
+ M : tuple[sequence[[float, float, float] | :class:`compas.geometry.Point`], sequence[[int, int, int]]]
15
+ A mesh represented by a list of vertices and a list of faces.
16
+
17
+ Returns
18
+ -------
19
+ list[[int, int]]
20
+ The u, v parameters per vertex.
21
+
22
+ Examples
23
+ --------
24
+ >>>
25
+
26
+ """
27
+ raise NotImplementedError
28
+
29
+
30
+ trimesh_harmonic.__pluggable__ = True
31
+
32
+
33
+ @pluggable(category="trimesh")
34
+ def trimesh_lscm(M):
35
+ """Compute the least squares conformal map of a triangle mesh.
36
+
37
+ Parameters
38
+ ----------
39
+ M : tuple[sequence[[float, float, float] | :class:`compas.geometry.Point`], sequence[[int, int, int]]]
40
+ A mesh represented by a list of vertices and a list of faces.
41
+
42
+ Returns
43
+ -------
44
+ list[[int, int]]
45
+ The u, v parameters per vertex.
46
+
47
+ Examples
48
+ --------
49
+ >>>
50
+
51
+ """
52
+ raise NotImplementedError
53
+
54
+
55
+ trimesh_lscm.__pluggable__ = True
@@ -0,0 +1,216 @@
1
+ import numpy as np
2
+ from scipy.linalg import solve
3
+ from scipy.spatial import distance_matrix
4
+
5
+ from compas.geometry import cross_vectors
6
+ from compas.geometry import is_ccw_xy
7
+ from compas.geometry import is_point_in_triangle
8
+ from compas.linalg import normalizerow
9
+
10
+
11
+ def trimesh_pull_points_numpy(M, points):
12
+ """Pull points onto a mesh by computing the closest point on the mesh for each of the points.
13
+
14
+ Parameters
15
+ ----------
16
+ M : tuple[sequence[[float, float, float] | :class:`compas.geometry.Point`], sequence[[int, int, int]]]
17
+ A mesh represented by a list of vertices and a list of faces.
18
+ points : sequence[[float, float, float] | :class:`compas.geometry.Point`]
19
+ The input points.
20
+
21
+ Returns
22
+ -------
23
+ list[[float, float, float]]
24
+ The points on the mesh.
25
+
26
+ Notes
27
+ -----
28
+ It will not be verified that the input mesh is a triangle mesh.
29
+ It will just be treated as if it is...
30
+
31
+ """
32
+ vertices, faces = M
33
+ # preprocess
34
+ vertices = np.array(vertices, dtype=np.float64).reshape((-1, 3))
35
+ triangles = np.array(faces, dtype=np.float64).reshape((-1, 3))
36
+ points = np.array(points, dtype=np.float64).reshape((-1, 3))
37
+ closest_vis = np.argmin(distance_matrix(points, vertices), axis=1)
38
+ # vertex triangles
39
+ vertex_triangles = [[] for _ in range(vertices.shape[0])]
40
+ for i, triangle in enumerate(triangles):
41
+ for j in triangle:
42
+ vertex_triangles[j].append(i)
43
+ # transformation matrices
44
+ # ?
45
+ pulled_points = []
46
+ # pull every point onto the mesh
47
+ for i in range(points.shape[0]):
48
+ point = points[i]
49
+ closest_vi = closest_vis[i]
50
+ closest_tris = vertex_triangles[closest_vi]
51
+ # process the connected triangles
52
+ d, p, c = _find_closest_component(point, vertices, triangles, closest_tris, closest_vi)
53
+ pulled_points.append(p)
54
+ return pulled_points
55
+
56
+
57
+ # ==============================================================================
58
+ # helpers
59
+ # ==============================================================================
60
+
61
+
62
+ def _is_point_in_edgezone(p, p0, p1):
63
+ n = cross_vectors(p1 - p0, [0, 0, 1.0])
64
+ return is_ccw_xy(p0 - p0, n, p - p0) and not is_ccw_xy(p0 - p0, p1 - p0, p - p0) and not is_ccw_xy(p1 - p1, n, p - p1)
65
+
66
+
67
+ def _compute_point_on_segment(p, p0, p1):
68
+ a = p1[1] - p0[1]
69
+ b = p0[0] - p1[0]
70
+ c = p1[0] * p0[1] - p1[1] * p0[0]
71
+ r = (b * (b * p[0] - a * p[1]) - a * c) / (a**2 + b**2)
72
+ s = (a * (-b * p[0] + a * p[1]) - b * c) / (a**2 + b**2)
73
+ t = 0
74
+ return np.array([[r, s, t]]) # type: ignore
75
+
76
+
77
+ def _triangle_xform(triangle):
78
+ o = triangle[0]
79
+ u = triangle[1] - o
80
+ v = triangle[2] - o
81
+ w = cross_vectors(u, v)
82
+ v = cross_vectors(w, u)
83
+ A = normalizerow(np.array([u, v, w])).T
84
+ return o, A
85
+
86
+
87
+ def _find_closest_component(point, vertices, triangles, closest_tris, closest_vi):
88
+ distance = None
89
+ projection = None
90
+ component = None
91
+
92
+ for tri in closest_tris:
93
+ # the triangle to process
94
+ triangle = triangles[tri]
95
+ # the local triangle frame
96
+ o, A = _triangle_xform(triangle)
97
+ # local coordinates
98
+ b = point - o
99
+ p = solve(A, b.T).T
100
+ b = triangle - o
101
+ t = solve(A, b.T).T
102
+
103
+ # find closest component of triangle
104
+ # compute distance to closest component
105
+ if is_point_in_triangle(p, t):
106
+ p[2] = 0
107
+ xyz = A.dot(p[:, None]).T + o
108
+ distance = 0
109
+ # why to list?
110
+ projection = xyz[0].tolist()
111
+ component = "face", tri
112
+ break
113
+
114
+ if _is_point_in_edgezone(p, t[0], t[1]):
115
+ rst = _compute_point_on_segment(p, t[0], t[1])
116
+ xyz = A.dot(rst.T).T + o
117
+ d = np.sqrt(sum((rst - p[None, :]) ** 2))
118
+ if distance is None or d < distance:
119
+ distance = d
120
+ # why to list?
121
+ projection = xyz[0].tolist()
122
+ component = "edge", (None, None)
123
+
124
+ elif _is_point_in_edgezone(p, t[1], t[2]):
125
+ rst = _compute_point_on_segment(p, t[1], t[2])
126
+ xyz = A.dot(rst.T).T + o
127
+ d = np.sqrt(sum((rst - p[None, :]) ** 2))
128
+ if distance is None or d < distance:
129
+ distance = d
130
+ # why to list?
131
+ projection = xyz[0].tolist()
132
+ component = "edge", (None, None)
133
+
134
+ elif _is_point_in_edgezone(p, t[2], t[0]):
135
+ rst = _compute_point_on_segment(p, t[2], t[0])
136
+ xyz = A.dot(rst.T).T + o
137
+ d = np.sqrt(sum((rst - p[None, :]) ** 2))
138
+ if distance is None or d < distance:
139
+ distance = d
140
+ # why to list?
141
+ projection = xyz[0].tolist()
142
+ component = "edge", (None, None)
143
+
144
+ else:
145
+ xyz = vertices[closest_vi]
146
+ d = np.sqrt(sum((xyz - point) ** 2))
147
+ if distance is None or d < distance:
148
+ distance = d
149
+ # why to list?
150
+ projection = xyz.tolist()
151
+ component = "vertex", closest_vi
152
+
153
+ return distance, projection, component
154
+
155
+
156
+ # def compute_local_frame(mesh, point):
157
+ # # mesh = mesh.copy()
158
+ # # mesh.unify_cycles()
159
+ # # if not mesh.is_trimesh():
160
+ # # for fkey in mesh.faces():
161
+ # # mesh.insert_vertex(fkey)
162
+ # # avoid the previous step
163
+ # i_k = mesh.index_key()
164
+ # fk_fi = dict((fkey, index) for index, fkey in mesh.faces_enum())
165
+ # fi_fk = dict((index, fkey) for index, fkey in mesh.faces_enum())
166
+ # vertices = array([mesh.vertex_coordinates(key) for key in mesh], dtype=float64).reshape((-1, 3))
167
+ # triangles = array([mesh.face_coordinates(fkey) for fkey in mesh.face], dtype=float64)
168
+ # closest_vis = argmin(distance_matrix(array([point, ]), vertices), axis=1)
169
+ # closest_vi = closest_vis[0]
170
+ # closest_vk = i_k[closest_vi]
171
+ # closest_tris = [fk_fi[fk] for fk in mesh.vertex_faces(closest_vk, ordered=True) if fk is not None]
172
+ # # closest component
173
+ # cdist, cpoint, ccomp = _find_closest_component(
174
+ # point,
175
+ # vertices,
176
+ # triangles,
177
+ # closest_tris,
178
+ # closest_vi
179
+ # )
180
+ # # compute normal and tangent plane
181
+ # if ccomp[0] == 'face':
182
+ # fkey = fi_fk[ccomp[1]]
183
+ # n = mesh.face_normal(fkey)
184
+ # return cpoint, n
185
+ # if ccomp[0] == 'vertex':
186
+ # key = i_k[ccomp[1]]
187
+ # n = mesh.vertex_normal(key)
188
+ # return cpoint, n
189
+ # if ccomp[0] == 'edge':
190
+ # u, v = ccomp[1]
191
+ # n1 = [0, 0, 0]
192
+ # n2 = [0, 0, 0]
193
+ # f1 = mesh.halfedge[u][v]
194
+ # if f1 is not None:
195
+ # n1 = mesh.face_normal(f1)
196
+ # f2 = mesh.halfedge[v][u]
197
+ # if f2 is not None:
198
+ # n2 = mesh.face_normal(f2)
199
+ # n = 0.5 * (n1[0] + n2[0]), 0.5 * (n1[1] + n2[1]), 0.5 * (n1[2] + n2[2])
200
+ # return cpoint, n
201
+ # return None, None
202
+
203
+
204
+ # def compute_tangential_components(mesh, points, residuals):
205
+ # # pre-compute face normals
206
+ # # pre-compute vertex normals
207
+ # # pre-compute edge normals
208
+ # # find closest components
209
+ # # if cc is vertex => use corresponding vertex normal
210
+ # # if cc is edge => use corresponding edge normal
211
+ # # if cc is face => use corresponding face normal
212
+ # # tangent space:
213
+ # # - n
214
+ # # - u = normalizerow(cross(cross(n, r), n))
215
+ # # - t = dot(u, r) * u
216
+ # pass
@@ -0,0 +1,97 @@
1
+ from compas.plugins import pluggable
2
+
3
+
4
+ @pluggable(category="trimesh")
5
+ def trimesh_remesh(mesh, target_edge_length, number_of_iterations=10, do_project=True):
6
+ """Remeshing of a triangle mesh.
7
+
8
+ Parameters
9
+ ----------
10
+ mesh : tuple[sequence[[float, float, float] | :class:`compas.geometry.Point`], sequence[[int, int, int]]]
11
+ A mesh represented by a list of vertices and a list of faces.
12
+ target_edge_length : float
13
+ The target edge length.
14
+ number_of_iterations : int, optional
15
+ Number of remeshing iterations.
16
+ do_project : bool, optional
17
+ Reproject vertices onto the input surface when they are created or displaced.
18
+
19
+ Returns
20
+ -------
21
+ list[[float, float, float]]
22
+ Vertices of the remeshed mesh.
23
+ list[[int, int, int]]
24
+ Faces of the remeshed mesh.
25
+
26
+ Notes
27
+ -----
28
+ This remeshing function only constrains the edges on the boundary of the mesh.
29
+ To protect specific features or edges, please use :func:`remesh_constrained`.
30
+
31
+ """
32
+ raise NotImplementedError
33
+
34
+
35
+ trimesh_remesh.__pluggable__ = True
36
+
37
+
38
+ @pluggable(category="trimesh")
39
+ def trimesh_remesh_constrained(mesh, target_edge_length, protected_edges, number_of_iterations=10, do_project=True):
40
+ """Constrained remeshing of a triangle mesh.
41
+
42
+ Parameters
43
+ ----------
44
+ mesh : tuple[sequence[[float, float, float] | :class:`compas.geometry.Point`], sequence[[int, int, int]]]
45
+ A mesh represented by a list of vertices and a list of faces.
46
+ target_edge_length : float
47
+ The target edge length.
48
+ protected_edges : list[[int, int]]
49
+ A list of vertex pairs that identify protected edges of the mesh.
50
+ number_of_iterations : int, optional
51
+ Number of remeshing iterations.
52
+ do_project : bool, optional
53
+ Reproject vertices onto the input surface when they are created or displaced.
54
+
55
+ Returns
56
+ -------
57
+ list[[float, float, float]]
58
+ Vertices of the remeshed mesh.
59
+ list[[int, int, int]]
60
+ Faces of the remeshed mesh.
61
+
62
+ """
63
+ raise NotImplementedError
64
+
65
+
66
+ trimesh_remesh_constrained.__pluggable__ = True
67
+
68
+
69
+ @pluggable(category="trimesh")
70
+ def trimesh_remesh_along_isoline(mesh, scalarfield, scalar):
71
+ """Remesh a mesh along an isoline of a scalarfield over the vertices.
72
+
73
+ Parameters
74
+ ----------
75
+ mesh : tuple[sequence[[float, float, float] | :class:`compas.geometry.Point`], sequence[[int, int, int]]]
76
+ A mesh represented by a list of vertices and a list of faces.
77
+ scalarfield : sequence[float]
78
+ A scalar value per vertex of the mesh.
79
+ scalar : float
80
+ A value within the range of the scalarfield.
81
+
82
+ Returns
83
+ -------
84
+ list[[float, float, float]]
85
+ Vertices of the remeshed mesh.
86
+ list[[int, int, int]]
87
+ Faces of the remeshed mesh.
88
+
89
+ Examples
90
+ --------
91
+ >>>
92
+
93
+ """
94
+ raise NotImplementedError
95
+
96
+
97
+ trimesh_remesh_along_isoline.__pluggable__ = True
@@ -0,0 +1,108 @@
1
+ from numpy import array
2
+ from numpy import clip
3
+ from numpy import cross
4
+ from numpy import finfo
5
+ from numpy import float64
6
+ from numpy import sqrt
7
+ from numpy.linalg import norm
8
+ from numpy.random import choice
9
+ from numpy.random import rand
10
+
11
+
12
+ def trimesh_samplepoints_numpy(M, num_points=1000, return_normals=False):
13
+ """Compute sample points on a triangle mesh surface.
14
+
15
+ Parameters
16
+ ----------
17
+ M : tuple[sequence[[float, float, float] | :class:`compas.geometry.Point`], sequence[[int, int, int]]]
18
+ A mesh represented by a list of vertices and a list of faces.
19
+ num_points : int, optional
20
+ The number of sample points.
21
+ return_normals : bool, optional
22
+ If True, return the normals in addition to the sample points.
23
+
24
+ Returns
25
+ -------
26
+ ndarray | tuple[ndarray, ndarray]
27
+ If `return_normals` is False, a numpy ndarray representing sampled points with dim = [num_points, 3].
28
+ If `return_normals` is True, the sample points and the normals.
29
+
30
+ References
31
+ ----------
32
+ .. [1] Barycentric coordinate system, Available at https://en.wikipedia.org/wiki/Barycentric_coordinate_system
33
+ .. [2] Efficient barycentric point sampling on meshes, arXiv:1708.07559
34
+
35
+ Examples
36
+ --------
37
+ Make a triangle mesh.
38
+
39
+ >>> from compas.datastructures import Mesh
40
+ >>> hypar = Mesh.from_obj(compas.get("hypar.obj"))
41
+ >>> hypar.is_trimesh()
42
+ False
43
+ >>> hypar.quads_to_triangles()
44
+
45
+ Compute sample points.
46
+
47
+ >>> samples_pts, pts_normals = trimesh_samplepoints_numpy(hypar.to_vertices_and_faces(), 1000, True)
48
+ >>> # the x,y,z of sample points would be the following
49
+ >>> x, y, z = samples_pts[:, 0], samples_pts[:, 1], samples_pts[:, 2]
50
+ >>> # the sample points added normal vector would be the following
51
+ >>> X, Y, Z = x + pts_normals[:, 0], y + pts_normals[:, 1], z + pts_normals[:, 2]
52
+
53
+ """
54
+ # if mesh.is_empty():
55
+ # raise ValueError("Mesh is empty.")
56
+ # if not mesh.is_trimesh():
57
+ # raise ValueError("Mesh is not trimesh.")
58
+ # if not mesh.is_valid():
59
+ # raise ValueError("Mesh is invalid.")
60
+
61
+ # (1) Prepare data for computing
62
+ # vertex_index = mesh.vertex_index()
63
+ # vertices = mesh.vertices_attributes("xyz")
64
+ # faces = [[vertex_index[vertex] for vertex in mesh.face_vertices(face)] for face in mesh.faces()]
65
+
66
+ vertices, faces = M
67
+
68
+ V = array(vertices, dtype=float64)
69
+ F = array(faces, dtype=int)
70
+
71
+ e01 = V[F[:, 1]] - V[F[:, 0]]
72
+ e12 = V[F[:, 2]] - V[F[:, 1]]
73
+
74
+ normal = cross(e01, e12)
75
+ area_list = 0.5 * norm(normal, axis=1)
76
+ area_list_norm = area_list / area_list.sum()
77
+
78
+ # (2) Sample num_points of times on a mesh face regarding its weight of area
79
+ faces_idx = list(range(F.shape[0]))
80
+ samples_faces_idx = choice(faces_idx, num_points, p=area_list_norm) # type: ignore
81
+
82
+ # (3) Barycentric Coordinate for Surface Sampling
83
+ faces_vertices = V[F]
84
+ v0, v1, v2 = faces_vertices[:, 0], faces_vertices[:, 1], faces_vertices[:, 2]
85
+ r1_r2 = rand(2, num_points)
86
+ r1, r2 = r1_r2[0], r1_r2[1] # r1, r2 uniformly distributed from 0 to 1
87
+ r1_sqrt = sqrt(r1)
88
+ w0 = 1.0 - r1_sqrt
89
+ w1 = r1_sqrt * (1.0 - r2)
90
+ w2 = r1_sqrt * r2
91
+ a = v0[samples_faces_idx]
92
+ b = v1[samples_faces_idx]
93
+ c = v2[samples_faces_idx]
94
+
95
+ # (4) return sample points in the format of ndarray
96
+ samples_points = w0[:, None] * a + w1[:, None] * b + w2[:, None] * c
97
+
98
+ # (5) (if True) Return the normal vector of the sampled points
99
+ if return_normals:
100
+ samples_points_normals = cross((v1 - v0), (v2 - v1), axis=1)
101
+ samples_points_normals_norm = norm(samples_points_normals, ord=2, axis=1, keepdims=True)
102
+ samples_points_normals = samples_points_normals / samples_points_normals_norm
103
+ samples_points_normals = clip(samples_points_normals, a_min=finfo(float64).eps, a_max=None)
104
+ samples_points_normals = samples_points_normals[samples_faces_idx]
105
+
106
+ return samples_points, samples_points_normals
107
+
108
+ return samples_points