section-properties
A Rust library for computing structural cross-section properties of two-dimensional sections — geometric and principal moments of area, section moduli, radii of gyration, torsion and warping properties, plastic capacity, and cold-formed / fire analysis.
It reimplements the functionality of the Python
sectionproperties
library in a single, dependency-light Rust crate.
Features
- Geometric properties (
SectionProperties): area, centroid, second moments of area (Ix,Iy,Ixy), principal moments and orientation (i11,i22,phi), section moduli (Z), radii of gyration, perimeter, and first moments. Supports compound (multi-region) sections, holes, and affine transforms. - Geometry toolkit (
geometry): polygons, boolean operations (union / intersection / difference via Greiner–Hormann), offsets, and compound-geometry validation. - Finite-element warping analysis (
mesh,fea,plastic::warping_fem): TRI3/TRI6 meshing, sparse direct and iterative solvers (sparse LU, skyline LDLᵀ, CG, ICCG, optional Intel MKL PARDISO), and warping/torsion constants. - Plastic analysis (
plastic): section classification (EN 1993-1-1 / AISC 360), plastic section moduli, interaction diagrams, and torsion analysis. - Cold-formed steel (
cold_formed_analysis): effective width method, direct strength method, and distortional buckling. - Fire engineering (
fire): section factors, temperature profiles, protection, and fire resistance. - Section library (
section_library): parametric steel (IPE/HE/etc.), cold-formed, concrete, timber, and composite sections. - Beam FEM (
beam_fem): 2D Euler–Bernoulli frame analysis — nodes and elements, distributed/point loads, applied moments, static-condensation boundary conditions, element end forces, section resultantsN(x)/V(x)/M(x), and pluggableLinearSolverbackends (dense, skyline LDLᵀ, sparse LU, CG/ICCG). Seedocs/beam_fem.mdfor the full contract. - Database (
database): in-memory, filterable/searchable section database. - I/O (
io): JSON, CSV, DXF, SVG, VTK and Nastran export/import.
Quick start
use ;
let isection = from_designation.unwrap;
let section = isection.build;
let props = from_section;
println!;
println!;
println!;
For invalid input that must not panic, use the fallible constructors:
use ;
let outer = new;
let section = new;
let result: =
try_from_section;
Building and testing
Requires Rust 1.85+ (edition 2024).
PARDISO backend (optional)
To use the Intel MKL PARDISO direct solver, enable the feature and run within a full oneAPI/MKL environment:
See docs/PARDISO.md for details and known limitations.
Documentation
Generate API docs with:
Beam FEM conventions (DOF ordering, coordinate systems, sign conventions,
load ownership, boundary conditions, model snapshot semantics, solver
selection and error behaviour) are documented in
docs/beam_fem.md. End-to-end usage is shown by the
beam_* examples in examples/.