fibernet 4.0.0__tar.gz → 4.0.2__tar.gz

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 (277) hide show
  1. {fibernet-4.0.0 → fibernet-4.0.2}/CHANGELOG.md +22 -0
  2. fibernet-4.0.2/PKG-INFO +629 -0
  3. fibernet-4.0.2/README.md +550 -0
  4. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/__init__.py +20 -4
  5. fibernet-4.0.2/fibernet/analysis/graph_features_3d.py +619 -0
  6. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/easy.py +154 -0
  7. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/pattern.py +975 -84
  8. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/rl/__init__.py +7 -0
  9. fibernet-4.0.2/fibernet/rl/parametric.py +242 -0
  10. fibernet-4.0.2/fibernet/scripts/validate_3d_units.py +212 -0
  11. fibernet-4.0.2/fibernet/scripts/validate_3d_v2.py +223 -0
  12. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/accelerated.py +76 -29
  13. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/version.py +1 -1
  14. fibernet-4.0.2/fibernet/viz/render.py +1482 -0
  15. fibernet-4.0.2/fibernet/viz/render3d.py +327 -0
  16. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet.egg-info/SOURCES.txt +73 -68
  17. {fibernet-4.0.0 → fibernet-4.0.2}/pyproject.toml +4 -1
  18. fibernet-4.0.2/tests/conftest.py +4 -0
  19. fibernet-4.0.2/tests/test_3d_units.py +298 -0
  20. {fibernet-4.0.0 → fibernet-4.0.2}/tests/test_ml_rl_utils.py +3 -0
  21. fibernet-4.0.0/PKG-INFO +0 -705
  22. fibernet-4.0.0/README.md +0 -629
  23. fibernet-4.0.0/fibernet/viz/render.py +0 -696
  24. fibernet-4.0.0/fibernet/viz/render3d.py +0 -165
  25. fibernet-4.0.0/tests/conftest.py +0 -35
  26. {fibernet-4.0.0 → fibernet-4.0.2}/CONTRIBUTING.md +0 -0
  27. {fibernet-4.0.0 → fibernet-4.0.2}/LICENSE +0 -0
  28. {fibernet-4.0.0 → fibernet-4.0.2}/MANIFEST.in +0 -0
  29. {fibernet-4.0.0 → fibernet-4.0.2}/docs/api/index.rst +0 -0
  30. {fibernet-4.0.0 → fibernet-4.0.2}/docs/changelog.rst +0 -0
  31. {fibernet-4.0.0 → fibernet-4.0.2}/docs/conf.py +0 -0
  32. {fibernet-4.0.0 → fibernet-4.0.2}/docs/contributing.rst +0 -0
  33. {fibernet-4.0.0 → fibernet-4.0.2}/docs/getting_started.rst +0 -0
  34. {fibernet-4.0.0 → fibernet-4.0.2}/docs/index.rst +0 -0
  35. {fibernet-4.0.0 → fibernet-4.0.2}/docs/quickstart.rst +0 -0
  36. {fibernet-4.0.0 → fibernet-4.0.2}/docs/tutorials.rst +0 -0
  37. {fibernet-4.0.0 → fibernet-4.0.2}/examples/01_mechanical_analysis.py +0 -0
  38. {fibernet-4.0.0 → fibernet-4.0.2}/examples/02_structure_comparison.py +0 -0
  39. {fibernet-4.0.0 → fibernet-4.0.2}/examples/03_thermal_analysis.py +0 -0
  40. {fibernet-4.0.0 → fibernet-4.0.2}/examples/04_buckling_analysis.py +0 -0
  41. {fibernet-4.0.0 → fibernet-4.0.2}/examples/05_chiral_braided_structures.py +0 -0
  42. {fibernet-4.0.0 → fibernet-4.0.2}/examples/06_uncertainty_quantification.py +0 -0
  43. {fibernet-4.0.0 → fibernet-4.0.2}/examples/07_electromagnetic_analysis.py +0 -0
  44. {fibernet-4.0.0 → fibernet-4.0.2}/examples/08_fatigue_analysis.py +0 -0
  45. {fibernet-4.0.0 → fibernet-4.0.2}/examples/09_creep_analysis.py +0 -0
  46. {fibernet-4.0.0 → fibernet-4.0.2}/examples/10_diffusion_transport.py +0 -0
  47. {fibernet-4.0.0 → fibernet-4.0.2}/examples/11_parameter_sweep.py +0 -0
  48. {fibernet-4.0.0 → fibernet-4.0.2}/examples/12_topology_analysis.py +0 -0
  49. {fibernet-4.0.0 → fibernet-4.0.2}/examples/13_publication_workflow.py +0 -0
  50. {fibernet-4.0.0 → fibernet-4.0.2}/examples/14_advanced_analysis.py +0 -0
  51. {fibernet-4.0.0 → fibernet-4.0.2}/examples/15_ml_property_prediction.py +0 -0
  52. {fibernet-4.0.0 → fibernet-4.0.2}/examples/16_fiber_bundles.py +0 -0
  53. {fibernet-4.0.0 → fibernet-4.0.2}/examples/17_composite_laminates.py +0 -0
  54. {fibernet-4.0.0 → fibernet-4.0.2}/examples/18_pyvista_visualization.py +0 -0
  55. {fibernet-4.0.0 → fibernet-4.0.2}/examples/19_optimization.py +0 -0
  56. {fibernet-4.0.0 → fibernet-4.0.2}/examples/__init__.py +0 -0
  57. {fibernet-4.0.0 → fibernet-4.0.2}/examples/advanced_generators.py +0 -0
  58. {fibernet-4.0.0 → fibernet-4.0.2}/examples/comprehensive_demo.py +0 -0
  59. {fibernet-4.0.0 → fibernet-4.0.2}/examples/full_workflow.py +0 -0
  60. {fibernet-4.0.0 → fibernet-4.0.2}/examples/integration_examples.py +0 -0
  61. {fibernet-4.0.0 → fibernet-4.0.2}/examples/ml_example.py +0 -0
  62. {fibernet-4.0.0 → fibernet-4.0.2}/examples/nonlinear_mechanics.py +0 -0
  63. {fibernet-4.0.0 → fibernet-4.0.2}/examples/research_case_study.py +0 -0
  64. {fibernet-4.0.0 → fibernet-4.0.2}/examples/transformations.py +0 -0
  65. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/__init__.py +0 -0
  66. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/_archived/advanced.py +0 -0
  67. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/_archived/comparison.py +0 -0
  68. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/_archived/homogenization.py +0 -0
  69. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/_archived/morphology.py +0 -0
  70. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/_archived/networkx_integration.py +0 -0
  71. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/_archived/percolation.py +0 -0
  72. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/_archived/properties.py +0 -0
  73. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/_archived/spatial.py +0 -0
  74. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/_archived/statistics.py +0 -0
  75. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/_archived/stress_strain.py +0 -0
  76. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/_archived/topology.py +0 -0
  77. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/analysis/graph_features.py +0 -0
  78. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/api.py +0 -0
  79. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/core/__init__.py +0 -0
  80. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/core/copy_utils.py +0 -0
  81. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/core/crosslinks.py +0 -0
  82. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/core/fiber.py +0 -0
  83. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/core/material.py +0 -0
  84. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/core/network.py +0 -0
  85. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/core/pbc.py +0 -0
  86. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/core/structure_graph.py +0 -0
  87. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/core/tiling.py +0 -0
  88. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/core/transform.py +0 -0
  89. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/core/transforms.py +0 -0
  90. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/doe.py +0 -0
  91. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/examples/__init__.py +0 -0
  92. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/examples/basic_usage.py +0 -0
  93. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/__init__.py +0 -0
  94. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/_fixes.py +0 -0
  95. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/_graph_builder.py +0 -0
  96. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/advanced.py +0 -0
  97. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/bundles.py +0 -0
  98. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/chiral.py +0 -0
  99. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/curved.py +0 -0
  100. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/disordered.py +0 -0
  101. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/field_guided.py +0 -0
  102. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/fractal.py +0 -0
  103. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/gradient.py +0 -0
  104. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/hierarchical.py +0 -0
  105. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/laminates.py +0 -0
  106. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/metamaterials.py +0 -0
  107. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/ordered.py +0 -0
  108. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/regular.py +0 -0
  109. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/specialized.py +0 -0
  110. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/tpms.py +0 -0
  111. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/unified.py +0 -0
  112. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/variants.py +0 -0
  113. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/woven.py +0 -0
  114. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/gen/zigzag.py +0 -0
  115. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/graph/__init__.py +0 -0
  116. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/graph/io.py +0 -0
  117. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/graph/weld.py +0 -0
  118. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/integrations/__init__.py +0 -0
  119. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/integrations/lammps_integration.py +0 -0
  120. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/integrations/mdanalysis_integration.py +0 -0
  121. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/integrations/networkx_integration.py +0 -0
  122. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/integrations/ovito_integration.py +0 -0
  123. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/io/__init__.py +0 -0
  124. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/io/fea_export.py +0 -0
  125. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/io/gmsh.py +0 -0
  126. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/io/lammps.py +0 -0
  127. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/io/mesh_export.py +0 -0
  128. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/io/pandas_io.py +0 -0
  129. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/io/pdb.py +0 -0
  130. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/io/vtk.py +0 -0
  131. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/io/xyz.py +0 -0
  132. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/materials.py +0 -0
  133. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/ml/__init__.py +0 -0
  134. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/ml/_archived/dataset.py +0 -0
  135. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/ml/_archived/dataset_v2.py +0 -0
  136. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/ml/_archived/graph_neural_network.py +0 -0
  137. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/ml/_archived/predictor.py +0 -0
  138. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/ml/features.py +0 -0
  139. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/ml/utils.py +0 -0
  140. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/py.typed +0 -0
  141. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/pyvista_viz.py +0 -0
  142. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/rl/utils.py +0 -0
  143. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/__init__.py +0 -0
  144. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/acoustic.py +0 -0
  145. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/buckling_analysis.py +0 -0
  146. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/coupled.py +0 -0
  147. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/coupling.py +0 -0
  148. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/creep.py +0 -0
  149. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/cte.py +0 -0
  150. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/damage.py +0 -0
  151. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/diffusion.py +0 -0
  152. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/dma.py +0 -0
  153. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/dynamics.py +0 -0
  154. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/electromagnetic.py +0 -0
  155. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/fatigue.py +0 -0
  156. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/fluid.py +0 -0
  157. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/fracture.py +0 -0
  158. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/fracture_mechanics.py +0 -0
  159. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/incremental_fem.py +0 -0
  160. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/mechanical.py +0 -0
  161. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/molecular_dynamics.py +0 -0
  162. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/multiscale.py +0 -0
  163. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/nonlinear.py +0 -0
  164. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/optimization.py +0 -0
  165. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/periodic.py +0 -0
  166. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/permeability.py +0 -0
  167. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/rheology.py +0 -0
  168. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/rl_environment.py +0 -0
  169. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/thermal.py +0 -0
  170. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/uncertainty.py +0 -0
  171. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/validation.py +0 -0
  172. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived/viscoelastic.py +0 -0
  173. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived_fem/__init__.py +0 -0
  174. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_archived_fem/taichi_fem.py +0 -0
  175. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/_fem_archive.py +0 -0
  176. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/fem.py +0 -0
  177. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/sim/rl_env.py +0 -0
  178. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/trimesh_integration.py +0 -0
  179. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/units.py +0 -0
  180. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/utils/__init__.py +0 -0
  181. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/utils/batch.py +0 -0
  182. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/utils/config.py +0 -0
  183. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/utils/ensemble.py +0 -0
  184. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/utils/exceptions.py +0 -0
  185. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/utils/geometry.py +0 -0
  186. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/utils/io.py +0 -0
  187. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/utils/parametric.py +0 -0
  188. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/utils/units.py +0 -0
  189. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/utils/validation.py +0 -0
  190. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/visualization.py +0 -0
  191. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/viz/__init__.py +0 -0
  192. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/viz/advanced.py +0 -0
  193. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/viz/animate.py +0 -0
  194. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/viz/graph_plot.py +0 -0
  195. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/viz/plot2d.py +0 -0
  196. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/viz/plotly_viz.py +0 -0
  197. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/viz/renderer.py +0 -0
  198. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/viz/showcase.py +0 -0
  199. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/viz/showcase_renderer.py +0 -0
  200. {fibernet-4.0.0 → fibernet-4.0.2}/fibernet/viz/visualization.py +0 -0
  201. {fibernet-4.0.0 → fibernet-4.0.2}/requirements-dev.txt +0 -0
  202. {fibernet-4.0.0 → fibernet-4.0.2}/requirements.txt +0 -0
  203. {fibernet-4.0.0 → fibernet-4.0.2}/setup.cfg +0 -0
  204. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_accelerated.py +0 -0
  205. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_acoustic.py +0 -0
  206. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_advanced.py +0 -0
  207. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_advanced_statistics.py +0 -0
  208. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_api.py +0 -0
  209. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_benchmark.py +0 -0
  210. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_buckling_analysis.py +0 -0
  211. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_bundles.py +0 -0
  212. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_comparison.py +0 -0
  213. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_copy.py +0 -0
  214. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_coupled.py +0 -0
  215. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_creep.py +0 -0
  216. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_cte.py +0 -0
  217. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_curved.py +0 -0
  218. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_damage.py +0 -0
  219. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_diffusion.py +0 -0
  220. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_dma.py +0 -0
  221. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_dynamics.py +0 -0
  222. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_edge_cases.py +0 -0
  223. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_effective_properties.py +0 -0
  224. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_electromagnetic.py +0 -0
  225. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_ensemble.py +0 -0
  226. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_fatigue.py +0 -0
  227. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_fea_export.py +0 -0
  228. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_field_guided.py +0 -0
  229. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_fluid_acoustic.py +0 -0
  230. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_fractal.py +0 -0
  231. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_fracture_mechanics.py +0 -0
  232. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_generators.py +0 -0
  233. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_gnn.py +0 -0
  234. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_gradient.py +0 -0
  235. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_graph_api.py +0 -0
  236. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_graph_neural_network.py +0 -0
  237. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_homogenization.py +0 -0
  238. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_incremental_fem.py +0 -0
  239. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_integration.py +0 -0
  240. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_integration_v3.py +0 -0
  241. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_integrations.py +0 -0
  242. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_io.py +0 -0
  243. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_laminates.py +0 -0
  244. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_mesh_export.py +0 -0
  245. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_metamaterial_workflow.py +0 -0
  246. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_metamaterials.py +0 -0
  247. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_ml.py +0 -0
  248. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_molecular_dynamics.py +0 -0
  249. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_multiscale.py +0 -0
  250. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_nonlinear.py +0 -0
  251. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_optimization.py +0 -0
  252. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_pandas_io.py +0 -0
  253. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_parametric.py +0 -0
  254. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_pbc.py +0 -0
  255. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_percolation.py +0 -0
  256. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_periodic.py +0 -0
  257. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_permeability.py +0 -0
  258. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_pyvista.py +0 -0
  259. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_rl_environment.py +0 -0
  260. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_simulation.py +0 -0
  261. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_specialized.py +0 -0
  262. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_stress_strain.py +0 -0
  263. {fibernet-4.0.0 → fibernet-4.0.2}/tests/_archived/test_taichi_fem.py +0 -0
  264. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_topology.py +0 -0
  265. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_tpms.py +0 -0
  266. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_transforms.py +0 -0
  267. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_trimesh.py +0 -0
  268. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_uncertainty.py +0 -0
  269. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_validation.py +0 -0
  270. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_viscoelastic.py +0 -0
  271. {fibernet-4.0.0/tests → fibernet-4.0.2/tests/_archived}/test_visualization.py +0 -0
  272. {fibernet-4.0.0 → fibernet-4.0.2}/tests/test_config.py +0 -0
  273. {fibernet-4.0.0 → fibernet-4.0.2}/tests/test_core.py +0 -0
  274. {fibernet-4.0.0 → fibernet-4.0.2}/tests/test_crosslinks.py +0 -0
  275. {fibernet-4.0.0 → fibernet-4.0.2}/tests/test_doe.py +0 -0
  276. {fibernet-4.0.0 → fibernet-4.0.2}/tests/test_materials.py +0 -0
  277. {fibernet-4.0.0 → fibernet-4.0.2}/tests/test_units.py +0 -0
@@ -1,3 +1,25 @@
1
+ ## [4.0.2] - 2026-07-16
2
+
3
+ ### Performance
4
+ - **16x speedup** in simulation trajectory saving
5
+ - Vectorized edge length computation in `dynamics()` method
6
+ - Replaced Python list comprehension with NumPy vectorized operation
7
+ - Before: ~93s per structure (30000 steps, save_interval=500)
8
+ - After: ~27s per structure with same parameters
9
+ - With recommended parameters (8000 steps): ~5.8s per structure
10
+
11
+ ### Fixed
12
+ - Simulation appearing to "hang" with many structures
13
+ - Root cause: excessive overhead in trajectory save loop
14
+ - Each save took ~1.17s due to Python loop over all edges
15
+ - Now <1ms per save with vectorized computation
16
+
17
+ ### Technical Details
18
+ - File: `fibernet/sim/accelerated.py`
19
+ - Change: `np.array([np.linalg.norm(...) for e in range(n)])` → `np.linalg.norm(..., axis=1)`
20
+ - Impact: Pure performance optimization, no API or numerical changes
21
+ - All 118 existing tests pass
22
+
1
23
  # Changelog
2
24
 
3
25
  All notable changes to this project will be documented in this file.
@@ -0,0 +1,629 @@
1
+ Metadata-Version: 2.4
2
+ Name: fibernet
3
+ Version: 4.0.2
4
+ Summary: A comprehensive fiber network generation, simulation, and ML toolkit for materials science research
5
+ Author: FiberNet Contributors
6
+ License-Expression: MIT
7
+ Project-URL: Homepage, https://github.com/GellmanSparrowS/fibernet
8
+ Project-URL: Documentation, https://fibernet.readthedocs.io
9
+ Project-URL: Repository, https://github.com/GellmanSparrowS/fibernet
10
+ Project-URL: Issues, https://github.com/GellmanSparrowS/fibernet/issues
11
+ Keywords: fiber networks,materials science,finite element method,simulation,mechanical properties,computational materials,machine learning,reinforcement learning,polymer physics,biomechanics
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: Intended Audience :: Science/Research
14
+ Classifier: Topic :: Scientific/Engineering :: Physics
15
+ Classifier: Topic :: Scientific/Engineering :: Chemistry
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.9
18
+ Classifier: Programming Language :: Python :: 3.10
19
+ Classifier: Programming Language :: Python :: 3.11
20
+ Classifier: Programming Language :: Python :: 3.12
21
+ Classifier: Operating System :: OS Independent
22
+ Requires-Python: >=3.9
23
+ Description-Content-Type: text/markdown
24
+ License-File: LICENSE
25
+ Requires-Dist: numpy>=1.21
26
+ Requires-Dist: scipy>=1.7
27
+ Requires-Dist: networkx>=3.0
28
+ Requires-Dist: matplotlib>=3.5
29
+ Provides-Extra: viz
30
+ Requires-Dist: pyvista>=0.37; extra == "viz"
31
+ Provides-Extra: mesh
32
+ Requires-Dist: trimesh>=3.20; extra == "mesh"
33
+ Provides-Extra: io
34
+ Requires-Dist: h5py>=3.7; extra == "io"
35
+ Provides-Extra: accel
36
+ Requires-Dist: taichi>=1.6; extra == "accel"
37
+ Provides-Extra: ml
38
+ Requires-Dist: scikit-learn>=1.0; extra == "ml"
39
+ Requires-Dist: pandas>=1.5; extra == "ml"
40
+ Requires-Dist: tqdm>=4.60; extra == "ml"
41
+ Provides-Extra: rl
42
+ Requires-Dist: gymnasium>=0.26; extra == "rl"
43
+ Requires-Dist: scikit-optimize>=0.9; extra == "rl"
44
+ Requires-Dist: stable-baselines3>=2.0; extra == "rl"
45
+ Provides-Extra: graph
46
+ Requires-Dist: networkx>=3.0; extra == "graph"
47
+ Provides-Extra: full
48
+ Requires-Dist: pyvista>=0.37; extra == "full"
49
+ Requires-Dist: trimesh>=3.20; extra == "full"
50
+ Requires-Dist: h5py>=3.7; extra == "full"
51
+ Requires-Dist: taichi>=1.6; extra == "full"
52
+ Requires-Dist: scikit-learn>=1.0; extra == "full"
53
+ Requires-Dist: pandas>=1.5; extra == "full"
54
+ Requires-Dist: networkx>=3.0; extra == "full"
55
+ Requires-Dist: tqdm>=4.60; extra == "full"
56
+ Requires-Dist: pyyaml>=6.0; extra == "full"
57
+ Requires-Dist: gymnasium>=0.26; extra == "full"
58
+ Requires-Dist: scikit-optimize>=0.9; extra == "full"
59
+ Requires-Dist: matplotlib>=3.5; extra == "full"
60
+ Provides-Extra: dev
61
+ Requires-Dist: pytest>=7.0; extra == "dev"
62
+ Requires-Dist: pytest-cov>=4.0; extra == "dev"
63
+ Requires-Dist: matplotlib>=3.5; extra == "dev"
64
+ Requires-Dist: networkx>=3.0; extra == "dev"
65
+ Requires-Dist: pandas>=1.5; extra == "dev"
66
+ Requires-Dist: scikit-learn>=1.0; extra == "dev"
67
+ Requires-Dist: pyyaml>=6.0; extra == "dev"
68
+ Requires-Dist: sphinx>=7.0; extra == "dev"
69
+ Requires-Dist: sphinx-rtd-theme>=2.0; extra == "dev"
70
+ Requires-Dist: black>=23.0; extra == "dev"
71
+ Requires-Dist: flake8>=6.0; extra == "dev"
72
+ Requires-Dist: scikit-image>=0.19; extra == "dev"
73
+ Requires-Dist: taichi>=1.6; extra == "dev"
74
+ Provides-Extra: docs
75
+ Requires-Dist: sphinx>=7.0; extra == "docs"
76
+ Requires-Dist: sphinx-rtd-theme>=2.0; extra == "docs"
77
+ Requires-Dist: nbsphinx>=0.9; extra == "docs"
78
+ Dynamic: license-file
79
+
80
+ <div align="center">
81
+
82
+ # 🧬 FiberNet v4.0
83
+
84
+ ### Python Toolkit for Fiber Network Design, Simulation & Intelligent Optimization
85
+ ### 纤维网络结构生成、力学模拟与智能优化 Python 工具包
86
+
87
+ ---
88
+
89
+ [![PyPI version](https://img.shields.io/pypi/v/fibernet.svg?logo=pypi&logoColor=white&label=PyPI)](https://pypi.org/project/fibernet/4.0.2/)
90
+ [![Python](https://img.shields.io/badge/Python-3.9%2B-blue?logo=python&logoColor=white)](https://www.python.org/)
91
+ [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
92
+ [![Downloads](https://img.shields.io/pypi/dm/fibernet.svg?label=Downloads&color=brightgreen)](https://pypi.org/project/fibernet/)
93
+
94
+ **[Installation](#-installation--安装)** · **[Quick Start](#-quick-start--快速开始)** · **[API Reference](#-api-reference--api-参考)** · **[Tutorial](#-tutorial--教程)** · **[中文](#-中文说明)**
95
+
96
+ *Developed by [ML-BioMat Lab](https://ml-biomat.com/) @ [BMG-FDU](https://github.com/BMG-FDU)*
97
+
98
+ ---
99
+
100
+ </div>
101
+
102
+ ## 📖 Overview
103
+
104
+ FiberNet is a research-grade Python toolkit for **computational design of fiber network structures** — from periodic unit cells to complex metamaterials. It provides a complete closed-loop workflow:
105
+
106
+ ```
107
+ Generation → Simulation → Feature Extraction → Machine Learning → Reinforcement Learning
108
+ ```
109
+
110
+ **FiberNet 是一个面向材料科学的研究级 Python 工具包,用于纤维网络结构的计算设计。** 提供从结构生成到力学模拟再到智能优化的完整闭环工作流。
111
+
112
+ ### ✨ Core Capabilities / 核心能力
113
+
114
+ | Feature | Description | 说明 |
115
+ |---------|-------------|------|
116
+ | **12 Unit Types** | square, triangle, hexagon, honeycomb, kagome, voronoi, chiral, reentrant, star, cross, diamond, missing_rib | 12种基元 |
117
+ | **Parametric Control** | Internal point displacements for RL-ready continuous action spaces | 参数化内部点位移控制 |
118
+ | **Taichi Simulation** | Mass-spring dynamics with auto-relaxation, trajectory recording | Taichi质点弹簧动力学 |
119
+ | **94-Dim Features** | Structural + pore + contact feature extraction | 94维特征提取 |
120
+ | **One-Line ML** | `predict_from_csv()` → train, evaluate, visualize, save | 一行ML训练 |
121
+ | **One-Line RL** | `run_bayesian_optimization()` → optimize structure parameters | 一行RL优化 |
122
+ | **Stress Visualization** | Multi-frame trajectory with edge stretch coloring | 多帧应力可视化 |
123
+
124
+ ---
125
+
126
+
127
+ ### 🖼️ Showcase / 展示
128
+
129
+ <div align="center">
130
+ <img src="docs/images/01_2d_gallery.png" width="80%" alt="2D Structure Gallery" />
131
+ </div>
132
+
133
+ *2D Structure Gallery: 12 unit types (square, triangle, hexagon, honeycomb, kagome, voronoi, chiral, reentrant, star, cross, diamond, missing_rib).*
134
+
135
+ <div align="center">
136
+ <img src="docs/images/voronoi_1.5x_auto.png" width="80%" alt="Voronoi 1.5x Stretch" />
137
+ </div>
138
+
139
+ *Voronoi structure under 1.5× uniaxial stretch — showing deformation and stress distribution.*
140
+
141
+ *Left: 2D structure gallery (12 unit types). Right: Voronoi structure under 1.5× uniaxial stretch.*
142
+ *2D结构画廊:12种基元(正方形、三角形、六边形、蜂窝、kagome、Voronoi、手性、凹角、星形、十字、钻石、缺肋)。*
143
+
144
+ *Voronoi结构在1.5倍单轴拉伸下的变形 — 显示形变和应力分布。*
145
+
146
+ ---
147
+
148
+
149
+ ### 📐 Structure Catalog / 结构目录
150
+
151
+ FiberNet supports **12 built-in unit types** across **6 architecture families**:
152
+
153
+ | Family | Units | Description | 描述 |
154
+ |--------|-------|-------------|------|
155
+ | **Regular Lattices** | square, triangle, hexagon | Classic periodic tessellations | 经典周期镶嵌 |
156
+ | **Honeycomb Variants** | honeycomb, reentrant, missing_rib | Auxetic and cellular solid models | 凹角与胞状固体 |
157
+ | **Auxetic/Chiral** | chiral, star | Negative Poisson's ratio structures | 负泊松比结构 |
158
+ | **Cross/Diamond** | cross, diamond | Cross-braced and diamond patterns | 交叉与钻石图案 |
159
+ | **Kagome** | kagome | Tri-hexagonal lattice | 三六边形晶格 |
160
+ | **Disordered** | voronoi | Voronoi tessellation (random topology) | Voronoi镶嵌(随机拓扑) |
161
+
162
+ **Combinatorial space** (grid × pts_per_side × seed):
163
+ - Fixed parameters: **~91,800** unique structures
164
+ - With parametric displacement control: **7.98 × 10¹⁶** (discretized) to **∞** (continuous)
165
+ - With post-generation node manipulation: **368-dimensional** continuous action space (square 3×3, pts=5)
166
+
167
+ ---
168
+
169
+ ## 🚀 Installation / 安装
170
+
171
+ ```bash
172
+ # Core installation / 核心安装
173
+ pip install fibernet
174
+
175
+ # Full installation (ML + RL + viz + simulation) / 完整安装
176
+ pip install fibernet[full]
177
+
178
+ # ML only / 仅ML
179
+ pip install fibernet[ml]
180
+
181
+ # RL only / 仅RL
182
+ pip install fibernet[rl]
183
+ ```
184
+
185
+ ### Optional Dependencies / 可选依赖
186
+
187
+ | Group | Packages | Install |
188
+ |-------|----------|---------|
189
+ | `ml` | scikit-learn, pandas, tqdm | `pip install fibernet[ml]` |
190
+ | `rl` | gymnasium, scikit-optimize, stable-baselines3 | `pip install fibernet[rl]` |
191
+ | `accel` | taichi (GPU acceleration) | `pip install fibernet[accel]` |
192
+ | `viz` | pyvista (3D visualization) | `pip install fibernet[viz]` |
193
+ | `full` | All of the above | `pip install fibernet[full]` |
194
+
195
+ ---
196
+
197
+ ## ⚡ Quick Start / 快速开始
198
+
199
+ ### One-Line API / 一行代码
200
+
201
+ ```python
202
+ import fibernet as fn
203
+
204
+ # Generate structure / 生成结构
205
+ g = fn.pattern_2d(unit="honeycomb", box=(10, 10), grid=(4, 4))
206
+
207
+ # Visualize / 可视化
208
+ fn.show(g) # One line! / 一行出图
209
+
210
+ # Simulate / 模拟
211
+ r = fn.simulate(g, mode="stretch", strain=1.5, backend="spring") # One line! / 一行模拟
212
+ print(f"max_force={r.max_force:.0f}, max_stretch={r.max_stretch:.3f}")
213
+
214
+ # ML prediction / ML预测
215
+ result = fn.predict_from_csv("data.csv", target="max_force", output_dir="ml_out/") # One line! / 一行ML
216
+
217
+ # RL optimization / RL优化
218
+ best = fn.run_bayesian_optimization(objective_fn, param_space, n_iter=50) # One line! / 一行RL
219
+ ```
220
+
221
+ ### Complete Pipeline / 完整流水线
222
+
223
+ ```python
224
+ import fibernet as fn
225
+ from fibernet.ml import train_predictor, plot_predictions
226
+ from fibernet.rl import plot_reward_curve, run_bayesian_optimization
227
+ import numpy as np
228
+
229
+ # ─── 1. Generate Parametric Structures ───
230
+ # Each structure has 20 displacement parameters (4 sides × 5 points)
231
+ displacements = [(np.random.uniform(-0.3, 0.3), np.random.uniform(-0.3, 0.3))
232
+ for _ in range(20)]
233
+ g = fn.pattern_2d(
234
+ unit="square", box=(10, 10), grid=(3, 3),
235
+ n_pts_per_side=5, # 5 internal points per edge
236
+ point_displacements=displacements, # parametric control
237
+ )
238
+
239
+ # ─── 2. Simulate ───
240
+ engine = fn.TaichiEngine()
241
+ r = engine.stretch_test(
242
+ g,
243
+ target_stretch=1.5, # stretch to 1.5× length
244
+ stiffness=1e5, # spring stiffness
245
+ damping=0.3, # damping ratio
246
+ num_steps=1000, # simulation steps
247
+ save_interval=200, # save trajectory every 200 steps
248
+ )
249
+ print(f"max_force={r.max_force:.0f}, max_stretch={r.max_stretch:.3f}")
250
+
251
+ # ─── 3. Visualize Deformation with Stress ───
252
+ fig = fn.render_trajectory(
253
+ g, r.positions_trajectory, r.edge_stretches,
254
+ n_frames=6, title="Stretch Process",
255
+ )
256
+ fig.savefig("deformation.png", dpi=150)
257
+
258
+ # ─── 4. Extract Features ───
259
+ ext = fn.GraphFeatureExtractor()
260
+ features = ext.extract(g) # 94-dimensional feature vector
261
+
262
+ # ─── 5. Node Manipulation (for RL) ───
263
+ internal_nodes = g.get_internal_nodes() # nodes available for RL actions
264
+ g.displace_node(internal_nodes[0], [0.1, 0.2]) # move node by (dx, dy)
265
+ ```
266
+
267
+ ---
268
+
269
+
270
+ ### 🎯 RL Parametric Control / RL 参数化控制
271
+
272
+ FiberNet exposes **direct (dx, dy) displacement parameters** for each internal point on every edge, enabling continuous action spaces for reinforcement learning — equivalent to the `move_AB(G, num, dx, dy)` approach in research code, but more general.
273
+
274
+ ```python
275
+ # Method 1: Displacement at generation time
276
+ # Agent outputs 20-dim continuous action vector
277
+ action = agent.act(observation) # shape: (20,) values in [-0.3, 0.3]
278
+ displacements = [(action[2*i], action[2*i+1]) for i in range(10)]
279
+ g = fn.pattern_2d("square", grid=(3,3), n_pts_per_side=5,
280
+ point_displacements=displacements)
281
+
282
+ # Method 2: Post-generation refinement
283
+ internal_nodes = g.get_internal_nodes() # 184 nodes for square 3×3 pts=5
284
+ for node_id in internal_nodes:
285
+ g.displace_node(node_id, agent.refinement_action(node_id))
286
+ ```
287
+
288
+ FiberNet 为每条边上的每个内部点暴露了 **(dx, dy) 位移参数**,为强化学习提供连续动作空间。
289
+ 支持生成时位移控制和生成后逐节点微调两种方式。
290
+
291
+ ---
292
+
293
+ ## 📚 API Reference / API 参考
294
+
295
+ ### Structure Generation / 结构生成
296
+
297
+ ```python
298
+ # Generate 2D structure / 生成2D结构
299
+ g = fn.pattern_2d(
300
+ unit="square", # unit type / 基元类型
301
+ box=(10, 10), # cell size / 单元格尺寸
302
+ grid=(3, 3), # tiling grid / 铺排网格
303
+ n_pts_per_side=5, # internal points per edge / 每边内部点数
304
+ point_displacements=disps, # [(dx,dy), ...] displacements / 位移向量
305
+ seed=42, # random seed / 随机种子
306
+ )
307
+
308
+ # Available units / 可用基元
309
+ print(fn.list_units())
310
+ # ['chiral', 'cross', 'diamond', 'hexagon', 'honeycomb', 'kagome',
311
+ # 'missing_rib', 'reentrant', 'square', 'star', 'triangle', 'voronoi']
312
+ ```
313
+
314
+ ### Node Manipulation / 节点操控 (for RL)
315
+
316
+ ```python
317
+ # Displace a node / 移动节点
318
+ g.displace_node(node_id, [dx, dy])
319
+
320
+ # Set absolute position / 设置绝对位置
321
+ g.set_node_position(node_id, [x, y])
322
+
323
+ # Batch set / 批量设置
324
+ g.set_node_positions({1: [2.5, 0.5], 3: [7.5, 1.0]})
325
+
326
+ # Get internal (non-boundary) nodes → RL action targets
327
+ internal = g.get_internal_nodes()
328
+
329
+ # Get boundary nodes
330
+ boundary = g.get_boundary_nodes()
331
+ ```
332
+
333
+ ### Simulation / 模拟
334
+
335
+ ```python
336
+ engine = fn.TaichiEngine()
337
+
338
+ # Uniaxial stretch test / 单轴拉伸
339
+ r = engine.stretch_test(
340
+ graph,
341
+ target_stretch=1.5, # stretch ratio / 拉伸倍数
342
+ stiffness=1e5, # spring constant / 弹簧刚度
343
+ damping=0.3, # damping ratio / 阻尼比
344
+ num_steps=1000, # total steps / 总步数
345
+ save_interval=200, # trajectory save interval / 轨迹保存间隔
346
+ auto_steps=True, # auto-calculate steps from graph diameter / 自动计算步数
347
+ )
348
+
349
+ # Result fields / 结果字段
350
+ r.max_force # maximum edge force / 最大边力
351
+ r.max_stretch # maximum edge stretch ratio / 最大边拉伸比
352
+ r.mean_stretch # mean stretch / 平均拉伸
353
+ r.edge_forces # per-edge forces (N,) / 每边力
354
+ r.edge_stretches # per-edge stretch ratios (N,) / 每边拉伸比
355
+ r.positions_trajectory # list of (N,3) arrays / 位置轨迹列表
356
+
357
+ # Save/Load / 保存/加载
358
+ r.save("result.json", detailed=True) # with trajectory / 含轨迹
359
+ r2 = fn.SimResult.load("result.json") # restore / 恢复
360
+ ```
361
+
362
+ ### Visualization / 可视化
363
+
364
+ ```python
365
+ # Render structure / 渲染结构
366
+ fig = fn.render_graph(g, theme="dark") # dark purple / 暗紫
367
+ fig = fn.render_graph(g, theme="light") # white background / 白底
368
+ fig = fn.render_graph(g, theme="blueprint") # blueprint style / 蓝图风格
369
+
370
+ # Deformation comparison / 形变对比
371
+ fig = fn.render_deformation(g_original, g_deformed, color_by="stress")
372
+
373
+ # Multi-frame trajectory with stress / 多帧轨迹+应力
374
+ fig = fn.render_trajectory(
375
+ g, r.positions_trajectory, r.edge_stretches,
376
+ n_frames=6, title="Stretch Process",
377
+ )
378
+
379
+ # Themes / 主题
380
+ print(list(fn.THEMES.keys())) # ['dark', 'light', 'blueprint', 'publication']
381
+ ```
382
+
383
+ ### Machine Learning / 机器学习
384
+
385
+ ```python
386
+ from fibernet.ml import (
387
+ train_predictor, # Train model → (model, metrics)
388
+ cross_validate, # K-fold cross-validation
389
+ compare_models, # Compare multiple models
390
+ predict_from_csv, # One-line: CSV → train → save
391
+ plot_predictions, # Scatter: predicted vs actual
392
+ plot_feature_importance, # Bar chart: feature importance
393
+ plot_residuals, # Residual analysis
394
+ plot_learning_curve, # Learning curve
395
+ )
396
+
397
+ # One-line ML / 一行ML
398
+ result = predict_from_csv(
399
+ "simulation_results.csv",
400
+ target="max_force",
401
+ model_type="rf", # rf, ridge, gb, svm, mlp
402
+ output_dir="ml_output/",
403
+ )
404
+
405
+ # Manual training / 手动训练
406
+ model, metrics = train_predictor(X_train, y_train, model_type="rf")
407
+ print(f"R² = {metrics['r2']:.3f}")
408
+
409
+ # Cross-validation / 交叉验证
410
+ cv = cross_validate(X, y, model_type="ridge", cv=5)
411
+ print(f"CV R² = {cv['mean_r2']:.3f} ± {cv['std_r2']:.3f}")
412
+ ```
413
+
414
+ ### Reinforcement Learning / 强化学习
415
+
416
+ ```python
417
+ from fibernet.rl import (
418
+ plot_reward_curve, # Reward curve with moving average
419
+ plot_convergence, # Optimization convergence
420
+ plot_action_distribution, # Action histogram
421
+ evaluate_agent, # Multi-episode evaluation
422
+ save_agent, load_agent, # Serialization
423
+ run_bayesian_optimization, # One-line Bayesian opt
424
+ )
425
+
426
+ # Bayesian optimization / 贝叶斯优化
427
+ param_space = {
428
+ "grid_x": (2, 5), # integer range / 整数范围
429
+ "grid_y": (2, 5),
430
+ "stiffness": (1e4, 1e6), # continuous range / 连续范围
431
+ }
432
+
433
+ result = run_bayesian_optimization(
434
+ objective_fn, # fn(params) → scalar to minimize
435
+ param_space,
436
+ n_iter=50,
437
+ )
438
+ print(f"Best: {result['best_params']}, value={result['best_value']:.0f}")
439
+
440
+ # RL reward visualization / RL奖励可视化
441
+ plot_reward_curve(rewards, window=20, save_path="reward.png")
442
+ plot_convergence(objective_values, minimize=True, save_path="convergence.png")
443
+ ```
444
+
445
+ ---
446
+
447
+ ## 🎓 Tutorial / 教程
448
+
449
+ A complete end-to-end tutorial is available as a Jupyter notebook:
450
+
451
+ ```
452
+ tutorials/v4_tutorial/fibernet_v4_tutorial.ipynb
453
+ ```
454
+
455
+ This tutorial covers:
456
+ 1. **Structure Generation** — base + parametric variants with naming convention
457
+ 2. **Batch Simulation** — stretch tests with trajectory recording + checkpoint resume
458
+ 3. **Deformation Visualization** — multi-frame stress distribution
459
+ 4. **Feature Extraction** — 94-dimensional structural features
460
+ 5. **Machine Learning** — train/test split, nested CV (no data leakage), model comparison
461
+ 6. **Reinforcement Learning** — Bayesian optimization of displacement parameters
462
+
463
+ To run the tutorial with a small test dataset first:
464
+
465
+ ```bash
466
+ python3 tutorials/v4_tutorial/test_pipeline.py # 5 samples (test)
467
+ python3 tutorials/v4_tutorial/test_pipeline.py --full # 2000 samples (full)
468
+ ```
469
+
470
+ **完整教程覆盖**: 结构生成 → 批量模拟 → 形变可视化 → 特征提取 → 机器学习 → 强化学习。先用5个样本测试,再扩展到2000个。
471
+
472
+ ---
473
+
474
+ ## 📁 Project Structure / 项目结构
475
+
476
+ ```
477
+ fibernet/
478
+ ├── fibernet/
479
+ │ ├── core/ # StructureGraph, Material, transforms
480
+ │ ├── gen/ # pattern_2d/3d, unit factories
481
+ │ ├── sim/ # TaichiEngine (mass-spring), SimResult
482
+ │ ├── viz/ # render_graph, render_trajectory, themes
483
+ │ ├── analysis/ # GraphFeatureExtractor (94-dim)
484
+ │ ├── ml/ # train_predictor, cross_validate, plots
485
+ │ ├── rl/ # Bayesian opt, reward curves, agent eval
486
+ │ └── easy.py # show(), simulate(), batch_simulate()
487
+ ├── tutorials/
488
+ │ └── v4_tutorial/ # Jupyter notebook + test pipeline
489
+ ├── tests/ # Unit tests
490
+ └── pyproject.toml # Build configuration
491
+ ```
492
+
493
+ ---
494
+
495
+ ## 🔬 How It Works / 工作原理
496
+
497
+ ### Mass-Spring Model (Taichi)
498
+
499
+ FiberNet uses a **mass-spring dynamics model** implemented in Taichi for GPU-accelerated simulation:
500
+
501
+ 1. **Nodes** are treated as point masses with position and velocity
502
+ 2. **Edges** are linear springs with configurable stiffness and rest length
503
+ 3. **Boundary nodes** are fixed (Dirichlet BC) during stretch tests
504
+ 4. **Relaxation**: initial energy minimization before loading
505
+ 5. **Loading**: controlled displacement of boundary nodes to target stretch ratio
506
+
507
+ ```
508
+ F_spring = k × (current_length - rest_length)
509
+ F_damping = -c × velocity
510
+ F_drag = -γ × velocity (dashpot)
511
+ ```
512
+
513
+ ### Parametric Structure Control (for RL)
514
+
515
+ Each unit cell edge can have `n_pts_per_side` internal nodes, each with a programmable `(dx, dy)` displacement. This creates a continuous action space for reinforcement learning:
516
+
517
+ ```
518
+ Action = [dx₁, dy₁, dx₂, dy₂, ..., dxₙ, dyₙ] ∈ [-0.3, 0.3]^(2n)
519
+ ```
520
+
521
+ For a square unit with `n_pts_per_side=5`, this gives **20 continuous parameters** — enough for complex beam geometries.
522
+
523
+ ---
524
+
525
+ ## 📊 Performance / 性能
526
+
527
+ | Task | Time (per structure) | Hardware |
528
+ |------|---------------------|----------|
529
+ | Generation (square 3×3, 5 pts/side) | ~0.1s | CPU |
530
+ | Stretch simulation (1000 steps) | ~2.5s | CPU (Taichi x64) |
531
+ | Feature extraction (94-dim) | ~0.5s | CPU |
532
+ | ML training (RF, 100 samples) | ~1s | CPU |
533
+ | Bayesian opt (30 iterations) | ~90s | CPU |
534
+
535
+ ---
536
+
537
+ ## 📝 Citation / 引用
538
+
539
+ If you use FiberNet in your research, please cite:
540
+
541
+ ```bibtex
542
+ @software{fibernet2024,
543
+ title = {FiberNet: Python Toolkit for Fiber Network Design and Optimization},
544
+ author = {ML-BioMat Lab, BMG-FDU},
545
+ year = {2026},
546
+ url = {https://github.com/GellmanSparrowS/fibernet},
547
+ version = {4.0.0},
548
+ }
549
+ ```
550
+
551
+ ---
552
+
553
+ ## 📄 License
554
+
555
+ MIT License. See [LICENSE](LICENSE) for details.
556
+
557
+ ---
558
+
559
+ ## 🇨🇳 中文说明
560
+
561
+ ### 概述
562
+
563
+ FiberNet 是一个面向材料科学的 Python 工具包,提供纤维网络结构的完整工作流:
564
+
565
+ - **12种基元生成**: 正方形、三角形、六边形、蜂窝、kagome、Voronoi 等
566
+ - **参数化控制**: 每个边上的内部点可以独立位移,支持RL连续动作空间
567
+ - **Taichi模拟**: 质点弹簧动力学,自动弛豫,轨迹记录
568
+ - **94维特征**: 结构+孔隙+接触特征提取
569
+ - **一行ML**: `predict_from_csv()` 自动训练、评估、可视化、保存
570
+ - **一行RL**: `run_bayesian_optimization()` 优化结构参数
571
+
572
+ ### 安装
573
+
574
+ ```bash
575
+ pip install fibernet # 核心
576
+ pip install fibernet[full] # 完整 (ML + RL + 可视化 + 模拟)
577
+ ```
578
+
579
+ ### 快速开始
580
+
581
+ ```python
582
+ import fibernet as fn
583
+
584
+ # 生成
585
+ g = fn.pattern_2d(unit="honeycomb", box=(10,10), grid=(4,4))
586
+
587
+ # 可视化(一行)
588
+ fn.show(g)
589
+
590
+ # 模拟(一行)
591
+ r = fn.simulate(g, mode="stretch", strain=1.5, backend="spring")
592
+
593
+ # ML(一行)
594
+ result = fn.predict_from_csv("data.csv", target="max_force")
595
+
596
+ # RL(一行)
597
+ best = fn.run_bayesian_optimization(objective_fn, param_space, n_iter=50)
598
+ ```
599
+
600
+ ### 节点操控(RL动作空间)
601
+
602
+ ```python
603
+ # 移动节点
604
+ g.displace_node(node_id, [dx, dy])
605
+
606
+ # 获取可优化节点
607
+ internal = g.get_internal_nodes()
608
+
609
+ # 批量设置
610
+ g.set_node_positions({1: [2.5, 0.5], 3: [7.5, 1.0]})
611
+ ```
612
+
613
+ ### 教程
614
+
615
+ 完整教程:`tutorials/v4_tutorial/fibernet_v4_tutorial.ipynb`
616
+
617
+ 测试运行(5个样本):
618
+ ```bash
619
+ python3 tutorials/v4_tutorial/test_pipeline.py
620
+ ```
621
+
622
+ 全量运行(2000个样本):
623
+ ```bash
624
+ python3 tutorials/v4_tutorial/test_pipeline.py --full
625
+ ```
626
+
627
+ ---
628
+
629
+ *FiberNet v4.0.0 | [PyPI](https://pypi.org/project/fibernet/4.0.2/) | [GitHub](https://github.com/GellmanSparrowS/fibernet)*