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,500 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ from math import cos
6
+ from math import pi
7
+ from math import sin
8
+
9
+ from compas.geometry import Frame
10
+ from compas.geometry import Plane
11
+ from compas.geometry import Point
12
+ from compas.geometry import Vector
13
+
14
+ from .conic import Conic
15
+
16
+ PI2 = 2 * pi
17
+
18
+
19
+ class Circle(Conic):
20
+ """A circle is a curve defined by a coordinate system and a radius.
21
+
22
+ The centre of the circle is at the origin of the coordinate system.
23
+ The z-axis of the coordinate system defines the normal of the circle plane.
24
+ The parameter domain is normalized with respect to the polar angle.
25
+ A parameter value of ``t = 0`` corresponds to the point on the circle at angle ``0``.
26
+ A parameter value of ``t = 1`` corresponds to the point on the circle at angle ``2 * pi``.
27
+ Moving along the circle in the parameter direction corresponds to moving counter-clockwise around the origin of the local coordinate system.
28
+
29
+ Parameters
30
+ ----------
31
+ radius : float
32
+ The radius of the circle.
33
+ frame : :class:`compas.geometry.Frame`, optional
34
+ The coordinate frame of the circle.
35
+ The default value is ``None``, in which case the world coordinate system is used.
36
+ name : str, optional
37
+ The name of the circle.
38
+
39
+ Attributes
40
+ ----------
41
+ frame : :class:`compas.geometry.Frame`
42
+ The coordinate frame of the circle.
43
+ transformation : :class:`Transformation`, read-only
44
+ The transformation from the local coordinate system of the circle (:attr:`frame`) to the world coordinate system.
45
+ center : :class:`compas.geometry.Point`
46
+ The center of the circle.
47
+ radius : float
48
+ The radius of the circle.
49
+ diameter : float, read-only
50
+ The diameter of the circle.
51
+ area : float, read-only
52
+ The area of the circle.
53
+ circumference : float, read-only
54
+ The circumference of the circle.
55
+ eccentricity : float, read-only
56
+ The eccentricity of the circle is zero.
57
+ is_closed : bool, read-only
58
+ True.
59
+ is_periodic : bool, read-only
60
+ True.
61
+
62
+ See Also
63
+ --------
64
+ :class:`compas.geometry.Ellipse`, :class:`compas.geometry.Arc`
65
+
66
+ Examples
67
+ --------
68
+ Construct a circle in the world XY plane.
69
+
70
+ >>> from compas.geometry import Frame, Circle
71
+ >>> circle = Circle(radius=5, frame=Frame.worldXY())
72
+ >>> circle = Circle(radius=5)
73
+
74
+ Construct a circle such that the Z axis of its frame such that it aligns with a given line.
75
+
76
+ >>> from compas.geometry import Line, Frame, Plane, Circle
77
+ >>> line = Line([0, 0, 0], [1, 1, 1])
78
+ >>> plane = Plane(line.end, line.direction)
79
+ >>> circle = Circle.from_plane_and_radius(plane, 5)
80
+ >>> circle = Circle(radius=5, frame=Frame.from_plane(plane))
81
+
82
+ Visualise the line, circle, and frame of the circle with the COMPAS viewer.
83
+
84
+ >>> from compas_viewer import Viewer # doctest: +SKIP
85
+ >>> viewer = Viewer() # doctest: +SKIP
86
+ >>> viewer.scene.add(line) # doctest: +SKIP
87
+ >>> viewer.scene.add(circle) # doctest: +SKIP
88
+ >>> viewer.scene.add(circle.frame) # doctest: +SKIP
89
+ >>> viewer.show() # doctest: +SKIP
90
+
91
+ """
92
+
93
+ DATASCHEMA = {
94
+ "type": "object",
95
+ "properties": {
96
+ "radius": {"type": "number", "minimum": 0},
97
+ "frame": Frame.DATASCHEMA,
98
+ },
99
+ "required": ["radius", "frame"],
100
+ }
101
+
102
+ @property
103
+ def __data__(self):
104
+ return {"radius": self.radius, "frame": self.frame.__data__}
105
+
106
+ @classmethod
107
+ def __from_data__(cls, data):
108
+ return cls(radius=data["radius"], frame=Frame.__from_data__(data["frame"]))
109
+
110
+ def __init__(self, radius, frame=None, name=None):
111
+ super(Circle, self).__init__(frame=frame, name=name)
112
+ self._radius = None
113
+ self.radius = radius
114
+
115
+ def __repr__(self):
116
+ return "{0}(radius={1!r}, frame={2!r})".format(
117
+ type(self).__name__,
118
+ self.radius,
119
+ self.frame,
120
+ )
121
+
122
+ def __eq__(self, other):
123
+ try:
124
+ other_frame = other.frame
125
+ other_radius = other.radius
126
+ except Exception:
127
+ return False
128
+ return self.frame == other_frame and self.radius == other_radius
129
+
130
+ # ==========================================================================
131
+ # Properties
132
+ # ==========================================================================
133
+
134
+ @property
135
+ def center(self):
136
+ return self.frame.point
137
+
138
+ @center.setter
139
+ def center(self, point):
140
+ self.frame.point = point
141
+
142
+ @property
143
+ def radius(self):
144
+ if self._radius is None:
145
+ raise ValueError("The radius of the circle has not been set yet.")
146
+ return self._radius
147
+
148
+ @radius.setter
149
+ def radius(self, radius):
150
+ if radius < 0:
151
+ raise ValueError("The radius of a circle should be larger than or equal to zero.")
152
+ self._radius = float(radius)
153
+
154
+ @property
155
+ def diameter(self):
156
+ return 2 * self.radius
157
+
158
+ @property
159
+ def area(self):
160
+ return pi * (self.radius**2)
161
+
162
+ @property
163
+ def circumference(self):
164
+ return 2 * pi * self.radius
165
+
166
+ @property
167
+ def eccentricity(self):
168
+ return 0
169
+
170
+ @property
171
+ def is_closed(self):
172
+ return True
173
+
174
+ @property
175
+ def is_periodic(self):
176
+ return True
177
+
178
+ # ==========================================================================
179
+ # Constructors
180
+ # ==========================================================================
181
+
182
+ @classmethod
183
+ def from_point_and_radius(cls, point, radius):
184
+ """Construct a circle from a point and a radius.
185
+
186
+ Parameters
187
+ ----------
188
+ point : :class:`compas.geometry.Point`
189
+ The center of the circle.
190
+ radius : float
191
+ The radius of the circle.
192
+
193
+ Returns
194
+ -------
195
+ :class:`compas.geometry.Circle`
196
+ The constructed circle.
197
+
198
+ See Also
199
+ --------
200
+ :meth:`from_plane_and_radius`, :meth:`from_three_points`, :meth:`from_points`
201
+
202
+ """
203
+ frame = Frame(point, [1, 0, 0], [0, 1, 0])
204
+ return cls(frame=frame, radius=radius)
205
+
206
+ @classmethod
207
+ def from_plane_and_radius(cls, plane, radius):
208
+ """Construct a circle from a plane and a radius.
209
+
210
+ Parameters
211
+ ----------
212
+ plane : :class:`compas.geometry.Plane`
213
+ The plane of the circle.
214
+ radius : float
215
+ The radius of the circle.
216
+
217
+ Returns
218
+ -------
219
+ :class:`compas.geometry.Circle`
220
+ The constructed circle.
221
+
222
+ See Also
223
+ --------
224
+ :meth:`from_point_and_radius`, :meth:`from_three_points`, :meth:`from_points`
225
+
226
+ Examples
227
+ --------
228
+ >>> from compas.geometry import Plane
229
+ >>> from compas.geometry import Circle
230
+ >>> plane = Plane([0, 0, 0], [0, 0, 1])
231
+ >>> circle = Circle.from_plane_and_radius(plane, 5)
232
+
233
+ """
234
+ frame = Frame.from_plane(plane)
235
+ return cls(frame=frame, radius=radius)
236
+
237
+ @classmethod
238
+ def from_three_points(cls, a, b, c):
239
+ """Construct a circle from three points.
240
+
241
+ Parameters
242
+ ----------
243
+ a : :class:`compas.geometry.Point`
244
+ The first point.
245
+ b : :class:`compas.geometry.Point`
246
+ The second point.
247
+ c : :class:`compas.geometry.Point`
248
+ The third point.
249
+
250
+ Returns
251
+ -------
252
+ :class:`compas.geometry.Circle`
253
+ The constructed circle.
254
+
255
+ See Also
256
+ --------
257
+ :meth:`from_point_and_radius`, :meth:`from_plane_and_radius`, :meth:`from_points`
258
+
259
+ """
260
+ from compas.geometry import Plane
261
+
262
+ a = Point(*a)
263
+ b = Point(*b)
264
+ c = Point(*c)
265
+
266
+ ab = b - a
267
+ cb = b - c
268
+ ba = a - b
269
+ ca = a - c
270
+ ac = c - a
271
+ bc = c - b
272
+
273
+ normal = ab.cross(ac).unitized()
274
+
275
+ d = 2 * ba.cross(cb).length ** 2
276
+
277
+ A = cb.length**2 * ba.dot(ca) / d
278
+ B = ca.length**2 * ab.dot(cb) / d
279
+ C = ba.length**2 * ac.dot(bc) / d
280
+ Aa = a.scaled(A)
281
+ Bb = b.scaled(B)
282
+ Cc = c.scaled(C)
283
+
284
+ point = Aa + Bb + Cc
285
+ radius = (a - point).length
286
+ plane = Plane(point, normal)
287
+
288
+ return cls.from_plane_and_radius(plane, radius)
289
+
290
+ @classmethod
291
+ def from_points(cls, points):
292
+ """Construct a circle from a list of at least three points.
293
+
294
+ Parameters
295
+ ----------
296
+ points : list of :class:`compas.geometry.Point`
297
+ A list of three points defining the circle.
298
+
299
+ Returns
300
+ -------
301
+ :class:`compas.geometry.Circle`
302
+ The constructed circle.
303
+
304
+ Raises
305
+ ------
306
+ ValueError
307
+ If the list of points contains less than three points.
308
+
309
+ See Also
310
+ --------
311
+ :meth:`from_point_and_radius`, :meth:`from_plane_and_radius`, :meth:`from_three_points`
312
+
313
+ Notes
314
+ -----
315
+ If more than three points are provided,
316
+ the constructed cicrle is the one that best fits the points in the least squares sense.
317
+
318
+ """
319
+ if len(points) < 3:
320
+ raise ValueError("At least three points are required to define a circle.")
321
+
322
+ if len(points) == 3:
323
+ return cls.from_three_points(*points)
324
+
325
+ # not sure if this makes sense
326
+ # but it will only throw an error if the bestfit is actually needed
327
+ from compas.geometry import bestfit_circle_numpy
328
+
329
+ point, normal, radius = bestfit_circle_numpy(points)
330
+ plane = Plane(point, normal)
331
+ return cls.from_plane_and_radius(plane, radius)
332
+
333
+ # =============================================================================
334
+ # Methods
335
+ # =============================================================================
336
+
337
+ def point_at(self, t, world=True):
338
+ """Construct a point on the circle at a specific parameter.
339
+
340
+ Parameters
341
+ ----------
342
+ t : float
343
+ The parameter of the point.
344
+ The parameter is expected to be normalized,
345
+ and will be mapped to the corresponding angle in the interval ``[0, 2 * pi]``.
346
+ world : bool, optional
347
+ If ``True``, the point is returned in world coordinates.
348
+
349
+ Returns
350
+ -------
351
+ :class:`compas.geometry.Point`
352
+ The point on the circle at the specified parameter.
353
+
354
+ See Also
355
+ --------
356
+ :meth:`normal_at`, :meth:`tangent_at`, :meth:`binormal_at`
357
+
358
+ Notes
359
+ -----
360
+ The location of the point is expressed with respect to the world coordinate system.
361
+
362
+ """
363
+ t = t * PI2
364
+ x = self.radius * cos(t)
365
+ y = self.radius * sin(t)
366
+ point = Point(x, y, 0)
367
+ if world:
368
+ point.transform(self.transformation)
369
+ return point
370
+
371
+ def normal_at(self, t, world=True):
372
+ """Construct a normal on the circle at a specific parameter.
373
+
374
+ Parameters
375
+ ----------
376
+ t : float
377
+ The parameter of the normal vector.
378
+ The parameter is expected to be normalized,
379
+ and will be mapped to the corresponding angle in the interval ``[0, 2 * pi]``.
380
+ world : bool, optional
381
+ If ``True``, the normal is returned in world coordinates.
382
+
383
+ Returns
384
+ -------
385
+ :class:`compas.geometry.Vector`
386
+ The normal on the circle at the specified parameter.
387
+
388
+ See Also
389
+ --------
390
+ :meth:`point_at`, :meth:`tangent_at`, :meth:`binormal_at`
391
+
392
+ Notes
393
+ -----
394
+ The orientation of the vector is expressed with respect to the world coordinate system.
395
+
396
+ """
397
+ if world:
398
+ normal = self.center - self.point_at(t, world=True)
399
+ normal.unitize()
400
+ return normal
401
+ point = self.point_at(t, world=False)
402
+ return Vector(-point.x, -point.y, 0)
403
+
404
+ def tangent_at(self, t, world=True):
405
+ """Construct a tangent on the circle at a specific parameter.
406
+
407
+ Parameters
408
+ ----------
409
+ t : float
410
+ The parameter of the tangent vector.
411
+ The parameter is expected to be normalized,
412
+ and will be mapped to the corresponding angle in the interval ``[0, 2 * pi]``.
413
+ world : bool, optional
414
+ If ``True``, the tangent is returned in world coordinates.
415
+
416
+ Returns
417
+ -------
418
+ :class:`compas.geometry.Vector`
419
+ The tangent on the circle at the specified parameter.
420
+
421
+ See Also
422
+ --------
423
+ :meth:`point_at`, :meth:`normal_at`, :meth:`binormal_at`
424
+
425
+ Notes
426
+ -----
427
+ The orientation of the vector is expressed with respect to the world coordinate system.
428
+
429
+ """
430
+ t = t * PI2
431
+ x = -self.radius * sin(t)
432
+ y = +self.radius * cos(t)
433
+ vector = Vector(x, y, 0)
434
+ vector.unitize()
435
+ if world:
436
+ vector.transform(self.transformation)
437
+ return vector
438
+
439
+ def closest_point(self, point, return_parameter=False):
440
+ """Compute the closest point on the circle to a given point.
441
+
442
+ Parameters
443
+ ----------
444
+ point : :class:`compas.geometry.Point`
445
+ A point.
446
+ return_parameter : bool, optional
447
+ Return the parameter of the closest point as well.
448
+
449
+ Returns
450
+ -------
451
+ :class:`compas.geometry.Point`
452
+ The closest point on the circle.
453
+
454
+ Notes
455
+ -----
456
+ The location of the point is expressed with respect to the world coordinate system.
457
+
458
+ """
459
+ from compas.geometry import Vector
460
+
461
+ projected = self.plane.closest_point(point)
462
+ vector = Vector.from_start_end(self.center, projected)
463
+ vector.unitize()
464
+ vector *= self.radius
465
+
466
+ if return_parameter:
467
+ raise NotImplementedError
468
+
469
+ return self.center + vector
470
+
471
+ def contains_point(self, point, tol=1e-6, dmax=1e-6):
472
+ """Verify that the circle contains a given point.
473
+
474
+ Parameters
475
+ ----------
476
+ point : :class:`compas.geometry.Point`
477
+ The point.
478
+ tol : float, optional
479
+ The tolerance for the verification.
480
+ dmax : float, optional
481
+ The maximum allowed distance between the plane of the circle and the point.
482
+
483
+ Returns
484
+ -------
485
+ bool
486
+ True if the point is on the circle.
487
+ False otherwise.
488
+
489
+ Notes
490
+ -----
491
+ By default, the verification will fail if the point is not exactly in the plane of the circle.
492
+ To allow for a certain tolerance, use the ``dmax`` parameter.
493
+ Like with apparent intersections, using a ``dmax`` higher than zero, allows for "apparent containment" checks
494
+
495
+ """
496
+ point = self.frame.to_local_coordinates(point)
497
+ x, y, z = point.x, point.y, point.z # type: ignore
498
+ if abs(z) > dmax:
499
+ return False
500
+ return x**2 + y**2 <= (self.radius + tol) ** 2
@@ -0,0 +1,16 @@
1
+ from __future__ import absolute_import
2
+ from __future__ import division
3
+ from __future__ import print_function
4
+
5
+ from .curve import Curve
6
+
7
+
8
+ class Conic(Curve):
9
+ """Base class for curves that are conic sections."""
10
+
11
+ # overwriting the __new__ method is necessary
12
+ # to avoid triggering the plugin mechanism of the base curve class
13
+ def __new__(cls, *args, **kwargs):
14
+ curve = object.__new__(cls)
15
+ curve.__init__(*args, **kwargs)
16
+ return curve