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,1131 @@
1
+ from compas.geometry import Geometry
2
+
3
+ from . import from_boolean_difference
4
+ from . import from_boolean_intersection
5
+ from . import from_boolean_union
6
+ from . import from_box
7
+ from . import from_brepfaces
8
+ from . import from_cone
9
+ from . import from_curves
10
+ from . import from_cylinder
11
+ from . import from_extrusion
12
+ from . import from_iges
13
+ from . import from_loft
14
+ from . import from_mesh
15
+ from . import from_native
16
+ from . import from_pipe
17
+ from . import from_plane
18
+ from . import from_planes
19
+ from . import from_polygons
20
+ from . import from_sphere
21
+ from . import from_step
22
+ from . import from_sweep
23
+ from . import from_torus
24
+ from . import new_brep
25
+
26
+
27
+ class BrepType(object):
28
+ """Possible types of a Brep
29
+
30
+ Attributes
31
+ ----------
32
+ COMPOUND
33
+ COMPSOLID
34
+ SHELL
35
+ FACE
36
+ WIRE
37
+ EDGE
38
+ VERTEX
39
+ SHAPE
40
+
41
+ """
42
+
43
+ COMPOUND = 0
44
+ COMPSOLID = 1
45
+ SHELL = 2
46
+ FACE = 3
47
+ WIRE = 4
48
+ EDGE = 5
49
+ VERTEX = 6
50
+ SHAPE = 7
51
+
52
+
53
+ class BrepOrientation(object):
54
+ """Possible orientations of a Brep
55
+
56
+ Attributes
57
+ ----------
58
+ FORWARD
59
+ REVERSED
60
+ INTERNAL
61
+ EXTERNAL
62
+
63
+ """
64
+
65
+ FORWARD = 0
66
+ REVERSED = 1
67
+ INTERNAL = 2
68
+ EXTERNAL = 3
69
+
70
+
71
+ class Brep(Geometry):
72
+ """Contains the topological and geometrical information of a Brep shape.
73
+
74
+ This class serves as an interface for a Brep and allows instantiating a Brep object depending on the available Backend.
75
+ Note: this is not a full implementation of Brep and rather relies on COMPAS's plugin system for actual implementation.
76
+
77
+ Attributes
78
+ ----------
79
+ area : float, read-only
80
+ The surface area of the Brep.
81
+ centroid : :class:`compas.geometry.Point`, read-only
82
+ The centroid of this brep.
83
+ curves : list[:class:`~compas.geometry.Curve`], read-only
84
+ The edge curves of this brep.
85
+ edges : list[:class:`compas.geometry.BrepEdge`], read-only
86
+ The edges of the Brep.
87
+ faces : list[:class:`compas.geometry.BrepFace`], read-only
88
+ The faces of the Brep.
89
+ frame : :class:`compas.geometry.Frame`, read-only
90
+ The local coordinate system of the Brep.
91
+ is_closed : bool, read-only
92
+ True if this brep is closed, False otherwise.
93
+ is_compound : bool, read-only
94
+ True if this brep's type is a compound, False otherwise.
95
+ is_compoundsolid : bool, read-only
96
+ True if this brep's type is a compoundsolid, False otherwise.
97
+ is_convex : bool, read-only
98
+ True if this brep is convex, False otherwise.
99
+ is_infinite : bool, read-only
100
+ True if this brep is infinite, False otherwise.
101
+ is_manifold : bool, read-only
102
+ True if this brep is a manifold, False otherwise.
103
+ is_orientable : bool, read-only
104
+ True if this brep is orientable, False otherwise.
105
+ is_shell : bool, read-only
106
+ True if this brep is a shell, False otherwise.
107
+ is_solid : bool, read-only
108
+ True if this brep is a solid, False otherwise.
109
+ is_surface : bool, read-only
110
+ True if this brep is a surface, False otherwise.
111
+ is_valid : bool, read-only
112
+ True if this brep is valid, False otherwise
113
+ loops : list[:class:`compas.geometry.BrepLoop`], read-only
114
+ The loops of the Brep.
115
+ native_brep : Any
116
+ The backend specific brep object.
117
+ orientation : literal(:class:`~compas.geometry.BrepOrientation`)
118
+ One of [FORWARD, REVERSE, INTERNAL, EXTERNAL], read-only
119
+ points : list[:class:`compas.geometry.Point`], read-only
120
+ The points of this brep.
121
+ shells : list[:class:`compas.geometry.Brep`], read-only
122
+ The shells of this brep.
123
+ solids : list[:class:`compas.geometry.Brep`], read-only
124
+ The solids of this brep.
125
+ surfaces : list[:class:`~compas.geometry.Surface`], read-only
126
+ The face surfaces of this brep.
127
+ trims : list[:class:`compas.geometry.BrepTrim`], read-only
128
+ The trims of the Brep.
129
+ type : literal(:class:`~compas.geometry.BrepType`), read-only
130
+ One of [COMPOUND, COMPSOLID, SHELL, FACE, WIRE, EDGE, VERTEX, SHAPE]
131
+ vertices : list[:class:`compas.geometry.BrepVertex`], read-only
132
+ The vertices of the Brep.
133
+ volume : float, read-only
134
+ The volume of the regions contained by the Brep.
135
+
136
+ """
137
+
138
+ @property
139
+ def __dtype__(self):
140
+ return "compas.geometry/Brep"
141
+
142
+ @classmethod
143
+ def __from_data__(cls, data):
144
+ cls = new_brep(cls)
145
+ return cls.__from_data__(data)
146
+
147
+ def __new__(cls, *args, **kwargs):
148
+ return new_brep(cls, *args, **kwargs)
149
+
150
+ def __init__(self, *args, **kwargs):
151
+ super(Brep, self).__init__(*args, **kwargs)
152
+
153
+ def __str__(self):
154
+ lines = [
155
+ "Brep",
156
+ "-----",
157
+ "Vertices: {}".format(len(self.vertices)),
158
+ "Edges: {}".format(len(self.edges)),
159
+ "Loops: {}".format(len(self.loops)),
160
+ "Faces: {}".format(len(self.faces)),
161
+ "Frame: {}".format(self.frame),
162
+ "Area: {}".format(self.area),
163
+ "Volume: {}".format(self.volume),
164
+ ]
165
+ return "\n".join(lines)
166
+
167
+ # ==============================================================================
168
+ # Properties
169
+ # ==============================================================================
170
+
171
+ @property
172
+ def native_brep(self):
173
+ raise NotImplementedError
174
+
175
+ @property
176
+ def orientation(self):
177
+ raise NotImplementedError
178
+
179
+ @property
180
+ def type(self):
181
+ raise NotImplementedError
182
+
183
+ @property
184
+ def is_valid(self):
185
+ raise NotImplementedError
186
+
187
+ @property
188
+ def is_shell(self):
189
+ raise NotImplementedError
190
+
191
+ @property
192
+ def is_solid(self):
193
+ raise NotImplementedError
194
+
195
+ @property
196
+ def is_compound(self):
197
+ raise NotImplementedError
198
+
199
+ @property
200
+ def is_compoundsolid(self):
201
+ raise NotImplementedError
202
+
203
+ @property
204
+ def is_orientable(self):
205
+ raise NotImplementedError
206
+
207
+ @property
208
+ def is_closed(self):
209
+ raise NotImplementedError
210
+
211
+ @property
212
+ def is_infinite(self):
213
+ raise NotImplementedError
214
+
215
+ @property
216
+ def is_convex(self):
217
+ raise NotImplementedError
218
+
219
+ @property
220
+ def is_manifold(self):
221
+ raise NotImplementedError
222
+
223
+ @property
224
+ def is_surface(self):
225
+ raise NotImplementedError
226
+
227
+ # ==============================================================================
228
+ # Geometric Components
229
+ # ==============================================================================
230
+
231
+ @property
232
+ def points(self):
233
+ raise NotImplementedError
234
+
235
+ @property
236
+ def curves(self):
237
+ raise NotImplementedError
238
+
239
+ @property
240
+ def surfaces(self):
241
+ raise NotImplementedError
242
+
243
+ # ==============================================================================
244
+ # Topological Components
245
+ # ==============================================================================
246
+
247
+ @property
248
+ def vertices(self):
249
+ raise NotImplementedError
250
+
251
+ @property
252
+ def edges(self):
253
+ raise NotImplementedError
254
+
255
+ @property
256
+ def trims(self):
257
+ raise NotImplementedError
258
+
259
+ @property
260
+ def loops(self):
261
+ raise NotImplementedError
262
+
263
+ @property
264
+ def faces(self):
265
+ raise NotImplementedError
266
+
267
+ @property
268
+ def shells(self):
269
+ raise NotImplementedError
270
+
271
+ @property
272
+ def solids(self):
273
+ raise NotImplementedError
274
+
275
+ # ==============================================================================
276
+ # Geometric Properties
277
+ # ==============================================================================
278
+
279
+ @property
280
+ def frame(self):
281
+ raise NotImplementedError
282
+
283
+ @property
284
+ def area(self):
285
+ raise NotImplementedError
286
+
287
+ @property
288
+ def volume(self):
289
+ raise NotImplementedError
290
+
291
+ @property
292
+ def centroid(self):
293
+ raise NotImplementedError
294
+
295
+ # ==============================================================================
296
+ # Constructors
297
+ # ==============================================================================
298
+
299
+ @classmethod
300
+ def from_box(cls, box):
301
+ """Construct a Brep from a COMPAS box.
302
+
303
+ Parameters
304
+ ----------
305
+ box : :class:`compas.geometry.Box`
306
+
307
+ Returns
308
+ -------
309
+ :class:`compas.geometry.Brep`
310
+
311
+ """
312
+ return from_box(box)
313
+
314
+ @classmethod
315
+ def from_brepfaces(cls, faces):
316
+ """Make a Brep from a list of Brep faces forming an open or closed shell.
317
+
318
+ Parameters
319
+ ----------
320
+ faces : list[:class:`compas.geometry.BrepFace`]
321
+
322
+ Returns
323
+ -------
324
+ :class:`compas.geometry.Brep`
325
+
326
+ """
327
+ return from_brepfaces(faces)
328
+
329
+ @classmethod
330
+ def from_breps(cls, breps):
331
+ """Construct one compound Brep from a list of other Breps.
332
+
333
+ Parameters
334
+ ----------
335
+ breps : list[:class:`compas.geometry.Brep`]
336
+
337
+ Returns
338
+ -------
339
+ :class:`compas.geometry.Brep`
340
+
341
+ """
342
+ raise NotImplementedError
343
+
344
+ @classmethod
345
+ def from_cone(cls, cone):
346
+ """Construct a Brep from a COMPAS cone.
347
+
348
+ Parameters
349
+ ----------
350
+ cone : :class:`compas.geometry.Cone`
351
+
352
+ Returns
353
+ -------
354
+ :class:`compas.geometry.Brep`
355
+
356
+ """
357
+ return from_cone(cone)
358
+
359
+ @classmethod
360
+ def from_curves(cls, curves):
361
+ """Construct a Brep from a set of curves.
362
+
363
+ Parameters
364
+ ----------
365
+ curves : list[:class:`compas.geometry.NurbsCurve`]
366
+
367
+ Returns
368
+ -------
369
+ :class:`compas.geometry.Brep`
370
+
371
+ """
372
+ return from_curves(curves)
373
+
374
+ @classmethod
375
+ def from_cylinder(cls, cylinder):
376
+ """Construct a Brep from a COMPAS cylinder.
377
+
378
+ Parameters
379
+ ----------
380
+ cylinder : :class:`compas.geometry.Cylinder`
381
+
382
+ Returns
383
+ -------
384
+ :class:`compas.geometry.Brep`
385
+
386
+ """
387
+ return from_cylinder(cylinder)
388
+
389
+ @classmethod
390
+ def from_extrusion(cls, curve, vector, cap_ends=True):
391
+ """Construct a Brep by extruding a closed curve along a direction vector.
392
+
393
+ Parameters
394
+ ----------
395
+ curve : :class:`compas.geometry.Curve`
396
+ The curve to extrude
397
+ vector : :class:`compas.geometry.Vector`
398
+ The vector to extrude the curve by
399
+ cap_ends : bool, optional
400
+ If True, the plannar ends of the extrusion will be capped, if possible.
401
+
402
+ Returns
403
+ -------
404
+ :class:`compas.geometry.Brep`
405
+
406
+ """
407
+ return from_extrusion(curve, vector, cap_ends)
408
+
409
+ @classmethod
410
+ def from_iges(cls, filename):
411
+ """Construct a Brep from the data contained in an IGES file.
412
+
413
+ Parameters
414
+ ----------
415
+ filename : str
416
+
417
+ Returns
418
+ -------
419
+ :class:`compas.geometry.Brep`
420
+
421
+ """
422
+ return from_iges(filename)
423
+
424
+ @classmethod
425
+ def from_loft(cls, curves):
426
+ """Construct a Brep by lofting a set of curves.
427
+
428
+ Parameters
429
+ ----------
430
+ curves : list[:class:`compas.geometry.Curve`]
431
+
432
+ Returns
433
+ -------
434
+ :class:`compas.geometry.Brep`
435
+
436
+ """
437
+ return from_loft(curves)
438
+
439
+ @classmethod
440
+ def from_mesh(cls, mesh):
441
+ """Construct a Brep from a COMPAS mesh.
442
+
443
+ Parameters
444
+ ----------
445
+ mesh : :class:`compas.datastructures.Mesh`
446
+
447
+ Returns
448
+ -------
449
+ :class:`compas.geometry.Brep`
450
+
451
+ """
452
+ return from_mesh(mesh)
453
+
454
+ @classmethod
455
+ def from_native(cls, native_brep):
456
+ """Creates a Brep from an instance of a native backend Brep type.
457
+
458
+ Parameters
459
+ ----------
460
+ brep : an instance of a Brep from a supported Brep backend
461
+ e.g. Rhino.Geometry.Brep
462
+
463
+ Returns
464
+ -------
465
+ :class:`compas.geometry.Brep`
466
+ """
467
+ return from_native(native_brep)
468
+
469
+ @classmethod
470
+ def from_pipe(cls, curve, radius, thickness=None):
471
+ """Construct a Brep by extruding a closed curve along a path curve.
472
+
473
+ Parameters
474
+ ----------
475
+ curve : :class:`compas.geometry.Curve`
476
+ The curve to extrude
477
+ radius : float
478
+ The radius of the pipe.
479
+ thickness : float, optional
480
+ The thickness of the pipe.
481
+ The thickness should be smaller than the radius.
482
+
483
+ Returns
484
+ -------
485
+ :class:`compas.geometry.Brep`
486
+
487
+ """
488
+ return from_pipe(curve, radius, thickness=thickness)
489
+
490
+ @classmethod
491
+ def from_plane(cls, plane, domain_u=(-1, +1), domain_v=(-1, +1)):
492
+ """Construct a Brep from one plane and its u and v domains.
493
+
494
+ Parameters
495
+ ----------
496
+ plane : :class:`~compas.geometry.Plane`
497
+ A plane.
498
+ domain_u : tuple[float, float], optional
499
+ The surface domain in the u direction.
500
+ domain_v : tuple[float, float], optional
501
+ The surface domain in the v direction.
502
+
503
+ Returns
504
+ -------
505
+ :class:`compas.geometry.Brep`
506
+
507
+ """
508
+ return from_plane(plane, domain_u=domain_u, domain_v=domain_v)
509
+
510
+ @classmethod
511
+ def from_planes(cls, planes):
512
+ """Construct a Brep from a set of planes.
513
+
514
+ Parameters
515
+ ----------
516
+ planes : list[:class:`~compas.geometry.Plane`]
517
+ A list of planes.
518
+
519
+ Returns
520
+ -------
521
+ :class:`compas.geometry.Brep`
522
+
523
+ """
524
+ return from_planes(planes)
525
+
526
+ @classmethod
527
+ def from_polygons(cls, polygons):
528
+ """Construct a Brep from a set of polygons.
529
+
530
+ Parameters
531
+ ----------
532
+ polygons : list[:class:`compas.geometry.Polygon`]
533
+
534
+ Returns
535
+ -------
536
+ :class:`compas.geometry.Brep`
537
+
538
+ """
539
+ return from_polygons(polygons)
540
+
541
+ @classmethod
542
+ def from_sphere(cls, sphere):
543
+ """Construct a Brep from a COMPAS sphere.
544
+
545
+ Parameters
546
+ ----------
547
+ sphere : :class:`compas.geometry.Sphere`
548
+
549
+ Returns
550
+ -------
551
+ :class:`compas.geometry.Brep`
552
+
553
+ """
554
+ return from_sphere(sphere)
555
+
556
+ @classmethod
557
+ def from_step(cls, filename):
558
+ """Conctruct a Brep from the data contained in a STEP file.
559
+
560
+ Parameters
561
+ ----------
562
+ filename : str
563
+
564
+ Returns
565
+ -------
566
+ :class:`compas.geometry.Brep`
567
+
568
+ """
569
+ return from_step(filename)
570
+
571
+ @classmethod
572
+ def from_sweep(cls, profile, path):
573
+ """Construct a BRep by sweeping a profile along a path.
574
+
575
+ Parameters
576
+ ----------
577
+ profile : :class:`compas.geometry.BrepEdge` or :class:`compas.geometry.BrepFace`
578
+ the profile to sweep. Either an edge or a face.
579
+ path : :class:`compas.geometry.BrepLoop`
580
+ the path to sweep along
581
+
582
+ Returns
583
+ -------
584
+ :class:`compas.geometry.Brep`
585
+
586
+ """
587
+ return from_sweep(profile, path)
588
+
589
+ @classmethod
590
+ def from_torus(cls, torus):
591
+ """Construct a Brep from a COMPAS torus.
592
+
593
+ Parameters
594
+ ----------
595
+ torus : :class:`compas.geometry.Torus`
596
+
597
+ Returns
598
+ -------
599
+ :class:`compas.geometry.BRep`
600
+
601
+ """
602
+ return from_torus(torus)
603
+
604
+ # ==============================================================================
605
+ # Boolean Constructors
606
+ # ==============================================================================
607
+
608
+ @classmethod
609
+ def from_boolean_difference(cls, brep_a, brep_b):
610
+ """Construct a Brep from the boolean difference of two other Breps.
611
+
612
+ Parameters
613
+ ----------
614
+ brep_a : :class:`compas.geometry.Brep`
615
+ brep_b : :class:`compas.geometry.Brep`
616
+
617
+ Returns
618
+ -------
619
+ :class:`compas.geometry.Brep`
620
+
621
+ """
622
+ return from_boolean_difference(brep_a, brep_b)
623
+
624
+ @classmethod
625
+ def from_boolean_intersection(cls, brep_a, brep_b):
626
+ """Construct a BRep from the boolean intersection of two other Breps.
627
+
628
+ Parameters
629
+ ----------
630
+ brep_a : :class:`compas.geometry.Brep`
631
+ brep_b : :class:`compas.geometry.Brep`
632
+
633
+ Returns
634
+ -------
635
+ :class:`compas.geometry.Brep`
636
+
637
+ """
638
+ return from_boolean_intersection(brep_a, brep_b)
639
+
640
+ @classmethod
641
+ def from_boolean_union(cls, brep_a, brep_b):
642
+ """Construct a Brep from the boolean union of two other Breps.
643
+
644
+ Parameters
645
+ ----------
646
+ brep_a : :class:`compas.geometry.Brep`
647
+ brep_b : :class:`compas.geometry.Brep`
648
+
649
+ Returns
650
+ -------
651
+ :class:`compas.geometry.Brep`
652
+
653
+ """
654
+ return from_boolean_union(brep_a, brep_b)
655
+
656
+ def __sub__(self, other):
657
+ """Compute the boolean difference using the "-" operator of this shape and another.
658
+
659
+ Parameters
660
+ ----------
661
+ other : :class:`compas.geometry.Brep`
662
+ The other Brep to create a union with.
663
+
664
+ Returns
665
+ -------
666
+ :class:`compas.geometry.Brep`
667
+ The Brep resulting from the difference operation.
668
+
669
+ """
670
+ results = type(self).from_boolean_difference(self, other)
671
+ if isinstance(results, list):
672
+ results = results[0]
673
+ return results
674
+
675
+ def __and__(self, other):
676
+ """Compute the boolean intersection using the "&" operator of this shape and another.
677
+
678
+ Parameters
679
+ ----------
680
+ other : :class:`compas.geometry.Brep`
681
+ The other Brep to create a union with.
682
+
683
+ Returns
684
+ -------
685
+ :class:`compas.geometry.Brep`
686
+ The Brep resulting from the intersection operation.
687
+
688
+ """
689
+ results = type(self).from_boolean_intersection(self, other)
690
+ if isinstance(results, list):
691
+ results = results[0]
692
+ return results
693
+
694
+ def __add__(self, other):
695
+ """Compute the boolean union using the "+" operator of this Brep and another.
696
+
697
+ Parameters
698
+ ----------
699
+ other : :class:`compas.geometry.Brep`
700
+ The other Brep to create a union with.
701
+
702
+ Returns
703
+ -------
704
+ :class:`compas.geometry.Brep`
705
+ The Brep resulting from the union operation.
706
+
707
+ """
708
+ results = type(self).from_boolean_union(self, other)
709
+ if isinstance(results, list):
710
+ results = results[0]
711
+ return results
712
+
713
+ # ==============================================================================
714
+ # Converters
715
+ # ==============================================================================
716
+
717
+ def to_iges(self, filepath):
718
+ """Write the Brep shape to an IGES file.
719
+
720
+ Parameters
721
+ ----------
722
+ filepath : str
723
+ Location of the file.
724
+
725
+ Returns
726
+ -------
727
+ None
728
+
729
+ """
730
+ raise NotImplementedError
731
+
732
+ def to_meshes(self, u=16, v=16):
733
+ """Convert the faces of this Brep shape to meshes.
734
+
735
+ Parameters
736
+ ----------
737
+ u : int, optional
738
+ The number of mesh faces in the U direction of the underlying surface geometry of every face of the Brep.
739
+ v : int, optional
740
+ The number of mesh faces in the V direction of the underlying surface geometry of every face of the Brep.
741
+
742
+ Returns
743
+ -------
744
+ list[:class:`compas.datastructures.Mesh`]
745
+
746
+ """
747
+ raise NotImplementedError
748
+
749
+ def to_polygons(self):
750
+ """Convert the faces of this Brep shape to polygons.
751
+
752
+ Returns
753
+ -------
754
+ list[:class:`compas.geometry.Polygon`]
755
+
756
+ """
757
+ raise NotImplementedError
758
+
759
+ def to_step(self, filepath):
760
+ """Write the Brep shape to a STEP file.
761
+
762
+ Parameters
763
+ ----------
764
+ filepath : str
765
+ Location of the file.
766
+
767
+ Returns
768
+ -------
769
+ None
770
+
771
+ """
772
+ raise NotImplementedError
773
+
774
+ def to_stl(self, filepath):
775
+ """Write the Brep shape to an STL file.
776
+
777
+ Parameters
778
+ ----------
779
+ filepath : str
780
+ Location of the file.
781
+
782
+ Returns
783
+ -------
784
+ None
785
+
786
+ """
787
+ raise NotImplementedError
788
+
789
+ def to_tesselation(self, linear_deflection=None):
790
+ """Create a tesselation of the shape for visualisation.
791
+
792
+ Parameters
793
+ ----------
794
+ linear_deflection : float, optional
795
+ Allowable deviation between curved geometry and mesh discretisation.
796
+
797
+ Returns
798
+ -------
799
+ :class:`compas.datastructures.Mesh`
800
+
801
+ """
802
+ raise NotImplementedError
803
+
804
+ def to_viewmesh(self, precision):
805
+ """Convert this Brep to a view mesh.
806
+
807
+ Parameters
808
+ ----------
809
+ precision : float
810
+ The presicion by which the mesh is estimated
811
+
812
+ Returns
813
+ -------
814
+ :class:`compas.datastructure.Mesh`
815
+
816
+ """
817
+ raise NotImplementedError
818
+
819
+ # ==============================================================================
820
+ # Relationships
821
+ # ==============================================================================
822
+
823
+ def vertex_neighbors(self, vertex):
824
+ """Identify the neighbouring vertices of a given vertex.
825
+
826
+ Parameters
827
+ ----------
828
+ vertex : :class:`compas.geometry.BrepVertex`
829
+
830
+ Returns
831
+ -------
832
+ list[:class:`compas.geometry.BrepVertex`]
833
+
834
+ """
835
+ raise NotImplementedError
836
+
837
+ def vertex_edges(self, vertex):
838
+ """Identify the edges connected to a given vertex.
839
+
840
+ Parameters
841
+ ----------
842
+ vertex : :class:`compas.geometry.BrepVertex`
843
+
844
+ Returns
845
+ -------
846
+ list[:class:`compas.geometry.BrepEdge`]
847
+
848
+ """
849
+ raise NotImplementedError
850
+
851
+ def vertex_faces(self, vertex):
852
+ """Identify the faces connected to a vertex.
853
+
854
+ Parameters
855
+ ----------
856
+ vertex : :class:`compas.geometry.BrepVertex`
857
+
858
+ Returns
859
+ -------
860
+ list[:class:`compas.geometry.BrepFace`]
861
+
862
+ """
863
+ raise NotImplementedError
864
+
865
+ # ==============================================================================
866
+ # Other Methods
867
+ # ==============================================================================
868
+
869
+ def contains(self, object):
870
+ """Check if the Brep contains a given geometric primitive.
871
+
872
+ Parameters
873
+ ----------
874
+ object : :class:`compas.geometry.Point`, :class:`compas.geometry.Curve`, :class:`compas.geometry.Surface`
875
+ The object to check for containment.
876
+
877
+ Returns
878
+ -------
879
+ bool
880
+ True if the object is contained in the Brep, False otherwise.
881
+
882
+ """
883
+ raise NotImplementedError
884
+
885
+ def trim(self, plane, tolerance):
886
+ """Trim this Brep using the given trimming plane.
887
+
888
+ Parameters
889
+ ----------
890
+ plane : :class:`~compas.geometry.Plane` or :class:`~compas.geometry.Frame`
891
+ Defines the trimming plane.
892
+ tolerance: float
893
+ The tolerance to use when trimming.
894
+
895
+ Returns
896
+ -------
897
+ None
898
+
899
+ """
900
+ raise NotImplementedError
901
+
902
+ def trimmed(self, plane, tolerance):
903
+ """Returns a trimmed copy of this Brep using the given trimming plane.
904
+
905
+ Parameters
906
+ ----------
907
+ plane : :class:`~compas.geometry.Plane` or :class:`~compas.geometry.Frame`
908
+ Defines the trimming plane.
909
+ tolerance: float
910
+ The tolerance to use when trimming.
911
+
912
+ Returns
913
+ -------
914
+ :class:`compas.geometry.Brep`
915
+
916
+ """
917
+ raise NotImplementedError
918
+
919
+ def make_solid(self):
920
+ """Convert the current shape to a solid if it is a shell.
921
+
922
+ Returns
923
+ -------
924
+ None
925
+
926
+ """
927
+ raise NotImplementedError
928
+
929
+ def sew(self):
930
+ """Sew together the individual parts of the shape.
931
+
932
+ Returns
933
+ -------
934
+ None
935
+
936
+ """
937
+ raise NotImplementedError
938
+
939
+ def fix(self):
940
+ """Fix the shell.
941
+
942
+ Returns
943
+ -------
944
+ None
945
+
946
+ """
947
+ raise NotImplementedError
948
+
949
+ def heal(self):
950
+ """Heal the shape.
951
+
952
+ Returns
953
+ -------
954
+ None
955
+
956
+ """
957
+ raise NotImplementedError
958
+
959
+ def cull_unused_vertices(self):
960
+ """Remove all unused vertices.
961
+
962
+ Returns
963
+ -------
964
+ None
965
+
966
+ """
967
+ raise NotImplementedError
968
+
969
+ def cull_unused_edges(self):
970
+ """Remove all unused edges.
971
+
972
+ Returns
973
+ -------
974
+ None
975
+
976
+ """
977
+ raise NotImplementedError
978
+
979
+ def cull_unused_loops(self):
980
+ """Remove all unused loops.
981
+
982
+ Returns
983
+ -------
984
+ None
985
+
986
+ """
987
+ raise NotImplementedError
988
+
989
+ def cull_unused_faces(self):
990
+ """Remove all unused faces.
991
+
992
+ Returns
993
+ -------
994
+ None
995
+
996
+ """
997
+ raise NotImplementedError
998
+
999
+ def contours(self, planes):
1000
+ """Generate contour lines by slicing the Brep shape with a series of planes.
1001
+
1002
+ Parameters
1003
+ ----------
1004
+ planes : list[:class:`compas.geometry.Plane`]
1005
+ The slicing planes.
1006
+
1007
+ Returns
1008
+ -------
1009
+ list[list[:class:`compas.geometry.Polyline`]]
1010
+ A list of polylines per plane.
1011
+
1012
+ """
1013
+ raise NotImplementedError
1014
+
1015
+ def edge_faces(self, edge):
1016
+ """Identify the faces connected to a given edge.
1017
+
1018
+ Parameters
1019
+ ----------
1020
+ edge : :class:`~compas.geometry.BrepEdge`
1021
+
1022
+ Returns
1023
+ -------
1024
+ list[:class:`~compas.geometry.BrepFace`]
1025
+
1026
+ """
1027
+ raise NotImplementedError
1028
+
1029
+ def edge_loop(self, edge):
1030
+ """Identify the parent loops of the a given edge.
1031
+
1032
+ Parameters
1033
+ ----------
1034
+ edge : :class:`~compas.geometry.BrepEdge`
1035
+
1036
+ Returns
1037
+ -------
1038
+ :class:`~compas.geometry.BrepLoop`
1039
+
1040
+ """
1041
+ raise NotImplementedError
1042
+
1043
+ def fillet(self, radius, edges=None):
1044
+ """Fillet the edges of the Brep.
1045
+
1046
+ Parameters
1047
+ ----------
1048
+ radius : float
1049
+ The radius of the fillet.
1050
+ edges : list[:class:`~compas.geometry.BrepEdge`], optional
1051
+ List of edges to exclude from the operation. When `None` all edges are included.
1052
+
1053
+ Raises
1054
+ ------
1055
+ :class:`~compas.geometry.BrepFilletError`
1056
+ If the fillet operation fails.
1057
+
1058
+ """
1059
+ raise NotImplementedError
1060
+
1061
+ def filleted(self, radius, edges=None):
1062
+ """Construct a filleted copy of the Brep.
1063
+
1064
+ Parameters
1065
+ ----------
1066
+ radius : float
1067
+ The radius of the fillet.
1068
+ edges : list[:class:`~compas.geometry.BrepEdge`], optional
1069
+ List of edges to exclude from the operation. When `None` all edges are included.
1070
+
1071
+ Raises
1072
+ ------
1073
+ :class:`~compas.geometry.BrepFilletError`
1074
+ If the fillet operation fails.
1075
+
1076
+ Returns
1077
+ -------
1078
+ :class:`~compas.geometry.Brep`
1079
+
1080
+ """
1081
+ raise NotImplementedError
1082
+
1083
+ def slice(self, plane):
1084
+ """Slice through the BRep with a plane.
1085
+
1086
+ Parameters
1087
+ ----------
1088
+ plane : :class:`~compas.geometry.Plane` or :class:`~compas.geometry.Frame`
1089
+ Defines the slicing plane.
1090
+
1091
+ Returns
1092
+ -------
1093
+ list(:class:`~compas.geometry.Curve`)
1094
+ Zero or more curves which represent the intersection(s) between the brep and the plane.
1095
+
1096
+ """
1097
+ raise NotImplementedError
1098
+
1099
+ def split(self, cutter):
1100
+ """Slice through the BRep with a plane.
1101
+
1102
+ Parameters
1103
+ ----------
1104
+ cutter : :class:`compas.geomtery.Brep`
1105
+ Another Brep to use as a cutter.
1106
+
1107
+ Returns
1108
+ -------
1109
+ list[:class:`compas.geometry.Brep`]
1110
+
1111
+ """
1112
+ raise NotImplementedError
1113
+
1114
+ def overlap(self, other, deflection=None, tolerance=0.0):
1115
+ """Compute the overlap between this BRep and another.
1116
+
1117
+ Parameters
1118
+ ----------
1119
+ other : :class:`compas.geometry.Brep`
1120
+ The other Brep.
1121
+ deflection : float, optional
1122
+ Allowable deflection for mesh generation used for proximity detection.
1123
+ tolerance : float, optional
1124
+ Tolerance for overlap calculation.
1125
+
1126
+ Returns
1127
+ -------
1128
+ tuple[list[:class:`compas.geometry.BrepFace`]]
1129
+
1130
+ """
1131
+ raise NotImplementedError