Skip to main content

Crate section_properties

Crate section_properties 

Source
Expand description

§section-properties

Rust crate for structural cross-section analysis: geometric properties, plastic classification, warping/torsion constants, stress analysis, and section-level FEM.

For 2D beam/frame structural analysis, see the structural-analysis crate.

§Quick start — section properties

use section_properties::{Point, Polygon, Section, SectionProperties};

// Build a rectangle 10 × 5
let outer = Polygon::new(vec![
    Point::new(0.0, 0.0),
    Point::new(10.0, 0.0),
    Point::new(10.0, 5.0),
    Point::new(0.0, 5.0),
]);
let section = Section::new(outer, Vec::new());
let props = SectionProperties::from_section(&section);

assert!((props.area - 50.0).abs() < 1e-10);
assert!((props.centroid.x - 5.0).abs() < 1e-10);
assert!((props.centroid.y - 2.5).abs() < 1e-10);

§Module overview

ModulePurpose
geometryPolygons, boolean ops, compound geometry
sectionSection (outer + holes), frame properties
section_propertiesArea, moments, principal axes, section moduli
compositeMulti-material elastic transformed-section analysis
feaFEM core: elements, solvers, numerical infrastructure
plasticPlastic section analysis, warping, classification
materialIsotropic linear-elastic material
stressCross-section stress analysis
section_libraryStandard section shapes (I, channel, tube, …)

§Error handling conventions

  • Fallible constructors use try_new / new_validated returning Result<Self, E>.
  • Fallible computations use try_* returning Result<T, E> or Option<T>.
  • Panicking APIs delegate to the try_* variant and expect() — they document the panic condition in a # Panics section.

Re-exports§

pub use crate::cold_formed_analysis::BucklingCurve;
pub use crate::cold_formed_analysis::ColdFormedElement;
pub use crate::cold_formed_analysis::ColdFormedSection;
pub use crate::cold_formed_analysis::EdgeSupport;
pub use crate::cold_formed_analysis::EffectiveSectionProperties;
pub use crate::cold_formed_analysis::EffectiveWidthParams;
pub use crate::cold_formed_analysis::ElementReduction;
pub use crate::cold_formed_analysis::Stiffener;
pub use crate::cold_formed_analysis::StiffenerType;
pub use crate::database::SearchFilter;
pub use crate::database::SearchResult;
pub use crate::database::SectionDatabase;
pub use crate::database::SectionEntry;
pub use crate::database::build_standard_database;
pub use crate::fire::FireAnalysis;
pub use crate::fire::FireExposure;
pub use crate::fire::FireProtection;
pub use crate::fire::FireResistanceResult;
pub use crate::fire::MaterialPropertiesAtTemp;
pub use crate::fire::ProtectionType;
pub use crate::fire::SectionFactor;
pub use crate::fire::TemperatureProfile;
pub use crate::fire::composite as fire_composite;
pub use crate::geometry::Axis;
pub use crate::geometry::BoundaryExtrema;
pub use crate::geometry::CompoundError;
pub use crate::geometry::CompoundGeometry;
pub use crate::geometry::Geometry;
pub use crate::geometry::JoinStyle;
pub use crate::geometry::Point;
pub use crate::geometry::Polygon;
pub use crate::geometry::Transform;
pub use crate::io::CsvExportOptions;
pub use crate::io::DxfColor;
pub use crate::io::DxfExportOptions;
pub use crate::io::ExportFormat;
pub use crate::io::JsonMaterial;
pub use crate::io::JsonSection;
pub use crate::io::SectionExporter;
pub use crate::io::SectionImporter;
pub use crate::io::SvgExportOptions;
pub use crate::io::export_section_library;
pub use crate::io::from_csv;
pub use crate::io::from_json;
pub use crate::io::plot_centroids;
pub use crate::io::section_from_composite;
pub use crate::io::section_from_parametric;
pub use crate::io::to_csv;
pub use crate::io::to_dxf;
pub use crate::io::to_json;
pub use crate::io::to_nastran;
pub use crate::io::to_svg;
pub use crate::io::to_vtk;
pub use crate::composite::ComponentAnalysis;
pub use crate::composite::CompositeAnalysisResult;
pub use crate::composite::CompositeComponent;
pub use crate::composite::CompositeError;
pub use crate::composite::ElasticComposite;
pub use crate::fea::FemError;
pub use crate::fea::solver;
pub use crate::fea::solver::SelectionReason;
pub use crate::fea::solver::SolverCapabilities;
pub use crate::fea::solver::SolverError;
pub use crate::fea::solver::SolverRegistry;
pub use crate::fea::solver::SolverSelection;
pub use crate::io::to_interactive_html as to_html;
pub use crate::material::Material;
pub use crate::mesh::FemCompositeAnalysis;
pub use crate::mesh::FemGeometricProperties;
pub use crate::mesh::FemSectionAnalysis;
pub use crate::mesh::FemWarpingProperties;
pub use crate::mesh::Mesh;
pub use crate::mesh::MeshParams;
pub use crate::mesh::PropertyComparison;
pub use crate::mesh::StressPlotData;
pub use crate::mesh::StressPost;
pub use crate::plastic::warping_fem::warping_svg;
pub use crate::plastic::CapacityCheck;
pub use crate::plastic::ClassLimit;
pub use crate::plastic::InteractionDiagram;
pub use crate::plastic::InteractionPoint;
pub use crate::plastic::LoadCase3D;
pub use crate::plastic::PlasticAnalysis;
pub use crate::plastic::PlasticProperties;
pub use crate::plastic::PlasticSection;
pub use crate::plastic::SectionClass;
pub use crate::plastic::SectionClassification;
pub use crate::plastic::StressDistribution;
pub use crate::plastic::TorsionAnalysis;
pub use crate::plastic::WarpingProperties;
pub use crate::plastic::aisc360;
pub use crate::plastic::classify_section;
pub use crate::plastic::effective;
pub use crate::plastic::en1993;
pub use crate::section::FrameProperties;
pub use crate::section::MaterialError;
pub use crate::section::Section;
pub use crate::section::TransformedFrameProperties;
pub use crate::section_library::CompositeSection;
pub use crate::section_library::ParametricSection;
pub use crate::section_properties::GeometricProperties;
pub use crate::section_properties::GyrationProperties;
pub use crate::section_properties::PrincipalProperties;
pub use crate::section_properties::SectionProperties;
pub use crate::stress::SectionLoads;
pub use crate::stress::StressAnalysis;
pub use crate::stress::StressAnalysisResult;
pub use crate::stress::StressAtPoint;
pub use crate::stress::YieldCheckResult;

Modules§

cold_formed_analysis
Cold-formed steel design per EN 1993-1-3, AS 4600, AISI S100.
composite
Elastic composite section analysis using the modular-ratio (transformed- section) method.
database
Section database for managing and querying section libraries.
fea
Finite element analysis core — Tri6 (six-noded quadratic triangular) element.
fire
Fire resistance analysis per EN 1993-1-2, EN 1994-1-2, EN 1992-1-2.
geometry
io
Input/Output module for section data exchange.
material
Isotropic linear-elastic material definition.
mesh
Mesh generation and FEM analysis core.
plastic
Plastic and advanced analysis module.
post
Post-processing utilities mirroring Python sectionproperties.post.
section
section_library
Pre-defined section library (mirrors Python sectionproperties.pre.library)
section_properties
stress
Cross-section stress analysis.
stress_fem
FEM stress analysis using Tri6 elements.