FiberNet

A comprehensive Python toolkit for fiber network generation, simulation, and analysis / 纤维网络结构生成、模拟与分析 Python 工具包

What is FiberNet?

FiberNet is a research-grade Python toolkit for computational study of fiber network structures. It provides a unified framework for generating, simulating, analyzing, and visualizing diverse fiber architectures — from simple random networks to complex hierarchical, chiral, woven, and metamaterial structures. Built for materials scientists, biomechanics researchers, and computational mechanicians.

FiberNet 是什么？

FiberNet 是一个面向纤维网络结构计算研究的 Python 工具包。它提供从结构生成、力学模拟到统计分析与可视化的统一框架，覆盖随机网络、层级手性结构、编织复合材料和力学超材料等多种纤维构型。专为材料科学、生物力学和计算力学研究者设计。

Core Capabilities

79+ Generators: Random, ordered, chiral, woven, hierarchical, bundles, curved, fractal, gradient, laminates, metamaterials (auxetic, octet, diamond, gyroid)
22+ Simulation Modules: FEM mechanics, nonlinear, dynamics, fracture, damage, fatigue, creep, thermal, electromagnetic, acoustic, fluid, rheology, DMA, viscoelastic, multiscale
Analysis Suite: Morphology, topology, statistics, percolation, homogenization, stress-strain, spatial, Poisson's ratio
ML Integration: Feature extraction, dataset creation, GNN, property prediction
I/O: JSON, YAML, LAMMPS, VTK, GMSH, PDB, XYZ, HDF5, pandas
Visualization: PyVista 3D, matplotlib 2D, Plotly interactive, animations

Installation

pip install git+https://github.com/GellmanSparrowS/fibernet.git

# Full install with visualization and ML deps
pip install "git+https://github.com/GellmanSparrowS/fibernet.git#egg=fibernet[full]"

# Requirements: Python 3.9+, NumPy, SciPy

Quick Example

from fibernet import gen
from fibernet.sim.mechanical import FiberFEM, compute_effective_properties

# Generate a re-entrant auxetic honeycomb
net = gen.reentrant_honeycomb_2d(
    reentrant_angle=150,    # >120° = auxetic
    grid_size=(8, 8),
    cell_height=10, cell_width=10,
)

# Compute effective properties
props = compute_effective_properties(net, strain=0.001)
print(props.summary())

Platforms

Ubuntu	Python 3.9–3.12	All tests pass
macOS (ARM64)	Python 3.9–3.12	All tests pass
Windows	Python 3.9–3.12	All tests pass

Status

FiberNet is under active development at BMG-FDU (Fudan University). The API is stabilizing, and full documentation is available on Read the Docs. Tutorials and detailed usage guides are coming soon — this page will be updated as the library matures.

FiberNet 正在复旦大学 BMG 课题组积极开发中。API 趋于稳定，完整文档见 Read the Docs。教程与详细使用指南即将发布，本页面将随库的成熟持续更新。