A python package for the analysis of arbitrary cross-sections using the finite element method
Project description
A python package for the analysis of arbitrary cross-sections using the finite element method written by Robbie van Leeuwen. sectionproperties can be used to determine section properties to be used in structural design and visualise cross-sectional stresses resulting from combinations of applied forces and bending moments.
Subscribe to the mailing list!
Installation:
For more detailed installation instructions, refer to the documentation.
$ pip install sectionproperties
Documentation:
sectionproperties is fully documented including a user walkthrough, examples, background theory and an API guide. The documentation can find at https://sectionproperties.readthedocs.io/.
Current Capabilities:
Pre-Processor:
- Python API
- Geometry manipulation by Shapely
- Common section geometry functions
- Custom section geometry input
- Rhino .3dm import
- .dxf import
- Perimeter offset tool
- Quadratic triangular mesh generation
- Composite material definition
Cross-Section Analysis:
- Global axis geometric section properties:
- Area
- Perimeter
- Mass
- First moments of area
- Second moments of area
- Elastic centroid
- Centroidal axis geometric section properties:
- Second moments of area
- Elastic section moduli
- Yield moment
- Radii of gyration
- Plastic centroid
- Plastic section moduli
- Shape factors
- Principal axis geometric section properties:
- Second moments of area
- Elastic section moduli
- Yield moment
- Radii of gyration
- Plastic centroid
- Plastic section moduli
- Shape factors
- Warping section properties:
- Torsion constant
- Warping constant
- Monosymmetry constants
- Shear section properties:
- Shear centre (elastic method)
- Shear centre (Trefftz's method)
- Shear areas (global axis)
- Shear areas (principal axis)
- Cross-section stress analysis
- Mohr's circles for stresses at a point
Solver:
- Direct solver
- CGS iterative solver
- Sparse matrices
Post-Processor:
- Plot geometry
- Plot mesh
- Plot centroids
- Plot cross-section stresses
- Retrieve cross-section stresses
- Generate cross-section report
Disclaimer:
sectionproperties is an open source engineering tool that continues to benefit from the collaboration of many contributors. Although efforts have been made to ensure the that relevant engineering theories have been correctly implemented, it remains the user's responsibility to confirm and accept the output. Refer to the license for clarification of the conditions of use.
Changelog:
v2.0.2:
- Add circular_section_by_area() in the section library
- Add option to define reinforcement by area rather than diameter for all concrete sections in the section library
- Fix bug in super_t_girder_section() which caused type 5 to be returned in all cases
- Require matplotlib >= 3.4 for CenteredNorm
v2.0.1:
- Fix issue with library module
v2.0.0:
sectionproperties v2 incorporates significant changes to the pre-processor, which now uses the
Shapely <https://github.com/shapely/shapely>
_ package to power advanced geometry creation and
manipulation, and vastly improves the performance and robustness of the plastic section property
algorithm. v2.x.x
introduces many breaking changes from v1.x.x
when creating and manipulating
Geometry
, refer to the documentation <https://sectionproperties.readthedocs.io>
_ for more
information.
Pre-Processor: ^^^^^^^^^^^^^^
A special mention to @connorferster <https://github.com/connorferster>
_ for a majority of these
fantastic additions!
sections.py
renamed togeometry.py
- All
Geometry
objects are defined by a shapelyPolygon
- Addition of new geometry manipulation methods and geometry set operators
- Added .dxf import, thanks to
@aegis1980 <https://github.com/aegis1980>
_ - Added .3dm import, thanks to
@normanrichardson <https://github.com/normanrichardson>
_ - Introduction of a
CompoundGeometry
class for geometries with multiple regions Geometry
objects are assigned aMaterial
property object,CompoundGeometry
objects can contain multipleGeometry
objects (each with their ownMaterial
object) enabling composite analysisGeometry
andCompoundGeometry
objects contain mesh information and meshing must be performed before initialising aSection
object- Improved
.offset_perimeter()
logic - Meshing is now performed by
triangle <https://github.com/drufat/triangle>
_, meshpy is no longer a dependency Material
class now requires a.density
parameter- The section library (
sectionproperties.pre.library
) now contains the built-in sectionproperties geometries - Added
triangular_section()
andtriangular_radius_section()
to theprimitive_sections
library - Added
concrete_sections
library - containsconcrete_rectangular_section()
,concrete_tee_section()
andconcrete_circular_section()
- Added
bridge_section
library, thanks to@ccaprani <https://github.com/ccaprani>
_ - containssuper_t_girder_section()
andi_girder_section()
Analysis: ^^^^^^^^^
cross_section.py
renamed tosection.py
CrossSection
object renamed toSection
and is now initialised with only aGeometry
orCompoundGeometry
object- Added calculation of cross-section mass
- Added calculation of weighted material properties - E_eff, G_eff, nu_eff
- The plastic algorithm is now performed by shapely, improving performance and robustness
- Added calculation of principal stresses, thanks to
@ccaprani <https://github.com/ccaprani>
_ - Shape factors are no longer calculated for composite sections (irrelevant property)
Post-Processor: ^^^^^^^^^^^^^^
- Added the
plotting_context()
manager, allowing easily saving files, passing kwargs topyplot.subplots()
and much more! Many thanks to@Spectre5 <https://github.com/Spectre5>
_ - Improved contour plotting behaviour
- Added plotting of Mohr's circle of stresses for any given point, thanks to
@ccaprani <https://github.com/ccaprani>
_ .display_results()
now reports E.J and E.Iw instead of G.J and G.Iw.display_results()
now reports modulus weighted shear areas for composite sections
Misc.: ^^^^^^
- Many spelling and code style fixes, thanks to
@Spectre5 <https://github.com/Spectre5>
_ - Updated documentation to include theoretical background
- Updated examples to be performed by sphinx-gallery, thanks to
@normanrichardson <https://github.com/normanrichardson>
_ and@Spectre5 <https://github.com/Spectre5>
_
v1.0.8:
- All plots now return figure and axes objects
- Fix bug in frame_properties causing the program to crash under certain circumstances
v1.0.7:
- Fix bug with geometry cleaning algorithm resulting in an infinite loop
- Added NASTRAN sections (JohnDN90)
- Added tight_layout to plots (Nils Wagner)
- Added BoxGirderSection class
- Added cross-section perimeter calculation
- Added perimeter offset method (BETA)
- Added mesh refinement example to docs
v1.0.6:
- Fix bug with geometry cleaning algorithm resulting in an infinite loop
- Added NASTRAN sections (JohnDN90)
- Added tight_layout to plots (Nils Wagner)
- Added BoxGirderSection class
- Added cross-section perimeter calculation
- Added perimeter offset method (BETA)
- Added mesh refinement example to docs
v1.0.5:
- Added calculation of monosymmetric constants
- Added tapered flange I Section and channel sections
- Added solid elliptical and hollow elliptical sections (BenjaminFraser)
- Added polygonal section (Agent6-6-6)
- Handle zero radius for all section classes; handle r_out < t for relevant sections
- Update Cee and Zed sections to account for short lips
v1.0.4:
- Added a monosymmetric I Section class
- Extend the plastic centroid search range to the entire section
- Remove the pc_region variable from the plastic centroid calculation as it is no longer relevant
- Better verbose output for the plastic centroid calculation
v1.0.3:
- Retrieve cross-section stresses using get_stress()
v1.0.2:
- Fix returns for adding to geometry
v1.0.1:
- Added calculate_frame_properties()
- Added methods for adding points, facets and control points to geometries
- New pypi README file
v1.0.0:
- Initial release.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sectionproperties-2.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ac4b757c763b087dfa5e8c1b04eb5eb81421020724da9902a126593147267b51 |
|
MD5 | dd15bc6042645701d1bdaae722b696a6 |
|
BLAKE2b-256 | 9b4ef513c360dabcb6475d9bfb0bd5a249a0d22b54c5df8ef015b40dddeba3f1 |