Skip to main content

A python package for the analysis of arbitrary cross-sections using the finite element method

Project description

Logo Dark Logo Light

Run Tests Lint with Black Documentation Status codecov PyPI version Python versions GitHub license

A python package for the analysis of arbitrary cross-sections using the finite element method. 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 found 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.1.0:

  • Add bulb_section() to steel sections library, thanks to @zmpulse <https://github.com/zmpulse>_
  • Add progress bar and pretty output using rich <https://github.com/Textualize/rich>_
  • Fix logic of generating holes in CompoundGeometry using the subtraction method, thanks to @connorferster <https://github.com/connorferster>_
  • Expand testing suite and documentation, thanks to @czarified <https://github.com/czarified>_
  • Fix bug with plastic calculation when material properties are specified
  • Add warning message for disconnected geometries when trying to calculate warping properties, thanks to @connorferster <https://github.com/connorferster>_
  • Fix bug with material properties not being assigned when using the CompoundGeometry.from_points() method, thanks to @connorferster <https://github.com/connorferster>_

Full changelog: 2.0.3...2.1.0 <https://github.com/robbievanleeuwen/section-properties/compare/2.0.3...2.1.0>_

v2.0.3:

  • Add top reinforcement to concrete section library sections
  • Add option to specify concrete circle area to concrete_circular_section()
  • Update concrete section library to prevent overlapping geometries
  • Fix implementation of Geometry and CompoundGeometry .__sub__() method
  • Add method to detect overlapping geometry errors and generate warning
  • Add option to create coarse mesh (no angle or area constraints)
  • Update rhino-shapley-interop and cad_to_shapely requirements

Full changelog: 2.0.2...2.0.3 <https://github.com/robbievanleeuwen/section-properties/compare/2.0.2...2.0.3>_

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

Full changelog: 2.0.1...2.0.2 <https://github.com/robbievanleeuwen/section-properties/compare/2.0.1...2.0.2>_

v2.0.1:

  • Fix issue with library module

Full changelog: 2.0.0...2.0.1 <https://github.com/robbievanleeuwen/section-properties/compare/2.0.0...2.0.1>_

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 to geometry.py
  • All Geometry objects are defined by a shapely Polygon
  • 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 a Material property object, CompoundGeometry objects can contain multiple Geometry objects (each with their own Material object) enabling composite analysis
  • Geometry and CompoundGeometry objects contain mesh information and meshing must be performed before initialising a Section 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() and triangular_radius_section() to the primitive_sections library
  • Added concrete_sections library - contains concrete_rectangular_section(), concrete_tee_section() and concrete_circular_section()
  • Added bridge_section library, thanks to @ccaprani <https://github.com/ccaprani>_ - contains super_t_girder_section() and i_girder_section()

Analysis: ^^^^^^^^^

  • cross_section.py renamed to section.py
  • CrossSection object renamed to Section and is now initialised with only a Geometry or CompoundGeometry 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 to pyplot.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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sectionproperties-2.1.0.tar.gz (261.2 kB view hashes)

Uploaded source

Built Distribution

sectionproperties-2.1.0-py3-none-any.whl (198.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page