Data

Tools

Indexes

Applications

Experiments

Open Source Science

felupe

:mag: finite element analysis for continuum mechanics of solid bodies

https://github.com/adtzlr/felupe

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ✓
    CITATION.cff file
    Found CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ✓
    DOI references
    Found 29 DOI reference(s) in README
  • ✓
    Academic publication links
    Links to: springer.com, zenodo.org
  • ○
    Committers with academic emails
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (14.3%) to scientific vocabulary

Keywords

3d fea fem finite-element-analysis finite-element-methods finite-elements hyperelasticity jax partial-differential-equations pde python scientific-computing solid-mechanics solid-mechanics-codes umat

Keywords from Contributors

mesh mathematics
Last synced: 4 months ago · JSON representation ·

Repository

:mag: finite element analysis for continuum mechanics of solid bodies

Basic Info
Statistics
  • Stars: 125
  • Watchers: 5
  • Forks: 14
  • Open Issues: 8
  • Releases: 80
Topics
3d fea fem finite-element-analysis finite-element-methods finite-elements hyperelasticity jax partial-differential-equations pde python scientific-computing solid-mechanics solid-mechanics-codes umat
Created over 4 years ago · Last pushed 4 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct Citation

README.md

Finite element analysis for continuum mechanics of solid bodies.

FElupe PyPI version shields.io Conda Version PyPI - Python Version Documentation Status License: GPL v3 Project Status: Active – The project has reached a stable, usable state and is being actively developed. codecov DOI Codestyle black PyPI - Downloads lite-badge Open In Colab

FElupe is a Python 3.9+ 🐍 finite element analysis package 📦 focusing on the formulation and numerical solution of nonlinear problems in continuum mechanics of solid bodies 🔧. This package is intended for scientific research 💻, but is also suitable for running nonlinear simulations 🚂 in general 🏎️. In addition to the transformation of general weak forms into sparse vectors and matrices, FElupe provides an efficient high-level abstraction layer for the simulation of the deformation of solid bodies.

Highlights

Efficient NumPy-based math is realized by element-wise operating trailing axes [1]. The finite element method, as used in FElupe, is based on [2], [3] and [4]. Related scientific articles are listed in the sections of the API reference.

[!NOTE] FElupe is a combination of FE (finite element) and the german word Lupe 🔍 (magnifying glass) as a synonym for getting an insight 📖 how a finite element analysis code 🧮 looks like under the hood 🕳️.

Installation

Install Python, fire up 🔥 a terminal and run 🏃

shell pip install felupe[all]

The documentation covers more details, like required and optional dependencies and how to install the latest development version.

Getting Started

Expand the description... This tutorial covers the essential high-level parts of creating and solving problems with FElupe. As an introductory example 👨‍🏫, a quarter model of a solid cube with hyperelastic material behaviour is subjected to a uniaxial elongation applied at a clamped end-face. First, let’s import FElupe and create a meshed cube out of hexahedron cells with a given number of points per axis. A numeric region, pre-defined for hexahedrons, is created on the mesh. A vector-valued displacement field is initiated on the region. Next, a field container is created on top of this field. A uniaxial load case is applied on the displacement field stored inside the field container. This involves setting up symmetry planes as well as the absolute value of the prescribed displacement at the mesh-points on the right-end face of the cube. The right-end face is *clamped* 🛠️: only displacements in direction *x* are allowed. The dict of boundary conditions for this pre-defined load case are returned as `boundaries` and the partitioned degrees of freedom as well as the external displacements are stored within the returned dict `loadcase`. An isotropic pseudo-elastic Ogden-Roxburgh Mullins-softening model formulation in combination with an isotropic hyperelastic Neo-Hookean material formulation is applied on the displacement field of a nearly-incompressible solid body. A step generates the consecutive substep-movements of a given boundary condition. The step is further added to a list of steps of a job 👩‍💻 (here, a characteristic-curve 📈 job is used). During evaluation ⏳, each substep of each step is solved by an iterative Newton-Rhapson procedure ⚖️. The solution is exported after each completed substep as a time-series ⌚ XDMF file. Finally, the result of the last completed substep is plotted. For more details beside this high-level code snippet, please have a look at the 📝 [documentation](https://felupe.readthedocs.io/en/stable/).

```python import felupe as fem

mesh = fem.Cube(n=6) region = fem.RegionHexahedron(mesh) field = fem.FieldContainer([fem.Field(region, dim=3)])

boundaries, loadcase = fem.dof.uniaxial(field, clamped=True)

umat = fem.OgdenRoxburgh(material=fem.NeoHooke(mu=1), r=3, m=1, beta=0.1) solid = fem.SolidBodyNearlyIncompressible(umat, field, bulk=5000)

move = fem.math.linsteps([0, 1, 0, 1, 2, 1], num=5) step = fem.Step(items=[solid], ramp={boundaries["move"]: move}, boundaries=boundaries)

job = fem.CharacteristicCurve(steps=[step], boundary=boundaries["move"]) job.evaluate(filename="result.xdmf") fig, ax = job.plot( xlabel="Displacement $u$ in mm $\longrightarrow$", ylabel="Normal Force $F$ in N $\longrightarrow$", )

solid.plot("Principal Values of Cauchy Stress").show() ```

Curve Solid Body

Documentation

The documentation is located here.

Extension Packages

The capabilities of FElupe may be enhanced with extension packages created by the community.

| Package | Description | |:-------------------------------------------------------:|:-------------------------------------------------------:| | hyperelastic | Constitutive hyperelastic material formulations | | matadi | Material Definition with Automatic Differentiation (AD) | | tensortrax | Differentiable Tensors based on NumPy Arrays | | feplot | A visualization tool for FElupe |

Testing

To run the FElupe unit tests, check out this repository and type

tox

Scientific Publications

A list of articles in which FElupe is involved. If you use FElupe in your scientific work, please star this repository, cite it DOI and add your publication to this list.

Expand the list... - A. Dutzler, C. Buzzi, and M. Leitner, "Nondimensional translational characteristics of elastomer components", [Journal of Applied Engineering Design and Simulation](https://jaeds.uitm.edu.my/index.php/jaeds), vol. 1, no. 1. UiTM Press, Universiti Teknologi MARA, Sep. 21, 2021. doi: [10.24191/jaeds.v1i1.20](https://doi.org/10.24191/jaeds.v1i1.20). [![medium-story](https://img.shields.io/badge/medium-story-white)](https://medium.com/@adtzlr/nonlinear-force-displacement-curves-of-rubber-metal-parts-ab7c48448e96) - C. Buzzi, A. Dutzler, T. Faethe, J. Lassacher, M. Leitner, and F.-J. Weber, "Development of a tool for estimating the characteristic curves of rubber-metal parts", in Proceedings of the [12th International Conference on Railway Bogies and Running Gears](https://transportation.bme.hu/2022/11/30/bogie22/), 2022 (ISBN 978-963-9058-46-0). - J. Torggler, A. Dutzler, B. Oberdorfer, T. Faethe, H. Müller, C. Buzzi, and M. Leitner, "Investigating Damage Mechanisms in Cord-Rubber Composite Air Spring Bellows of Rail Vehicles and Representative Specimen Design", [Applied Composite Materials](https://www.springer.com/journal/10443). Springer Science and Business Media LLC, Aug. 22, 2023. doi: [10.1007/s10443-023-10157-1](https://link.springer.com/article/10.1007/s10443-023-10157-1). Simulation-related Python scripts are available on GitHub at [adtzlr/fiberreinforcedrubber](https://github.com/adtzlr/fiberreinforcedrubber). Open In Colab

Changelog

All notable changes to this project will be documented in this file. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

References

[1] T. Gustafsson and G. McBain, "scikit-fem: A Python package for finite element assembly", Journal of Open Source Software, vol. 5, no. 52. The Open Journal, p. 2369, Aug. 21, 2020. DOI:10.21105/joss.02369.

[2] J. Bonet and R. D. Wood, "Nonlinear Continuum Mechanics for Finite Element Analysis". Cambridge University Press, Mar. 13, 2008. DOI:10.1017/cbo9780511755446.

[3] K. J. Bathe, "Finite Element Procedures". 2006, isbn: 978-0-9790049-0-2.

[4] O. C. Zienkiewicz, R. L. Taylor and J. Z. Zhu, "The Finite Element Method: its Basis and Fundamentals". Elsevier, 2013. DOI:10.1016/c2009-0-24909-9.

License

FElupe - finite element analysis (C) 2021-2025 Andreas Dutzler, Graz (Austria).

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Owner

  • Name: Andreas Dutzler
  • Login: adtzlr
  • Kind: user
  • Location: Graz, Austria
  • Company: Graz University of Technology

PhD Candidate in Mechanical Engineering @ TU Graz. Development Engineer in the Railway Industry. Opinions related to this account are my own.

JOSS Publication

FElupe: Finite element analysis for continuum mechanics of solid bodies
Published
October 07, 2025
DOI
Volume 10, Issue 114, Page 9160
Authors
Andreas Dutzler ORCID
Institute of Structural Durability and Railway Technology, Graz University of Technology, Austria, Siemens Mobility Austria GmbH, Austria
Martin Leitner ORCID
Institute of Structural Durability and Railway Technology, Graz University of Technology, Austria
Editor
Kyle Niemeyer ORCID
Tags
python finite-elements hyperelasticity computational-mechanics scientific-computing
View PDF Review Thread Software Archive

Citation (CITATION.cff) 

authors:
- family-names: "Dutzler"
  given-names: "Andreas"
  orcid: "https://orcid.org/0000-0002-9383-9686"
cff-version: 1.2.0
message: "If you use this software, please cite it using these metadata."
title: "FElupe: Finite Element Analysis"
type: software
doi: 10.5281/zenodo.4817406
url: https://github.com/adtzlr/felupe
license: GPL-3.0

GitHub Events

Total
  • Create event: 61
  • Release event: 3
  • Issues event: 65
  • Watch event: 45
  • Delete event: 66
  • Issue comment event: 100
  • Push event: 266
  • Pull request event: 119
  • Fork event: 3
Last Year
  • Create event: 61
  • Release event: 3
  • Issues event: 65
  • Watch event: 45
  • Delete event: 66
  • Issue comment event: 100
  • Push event: 266
  • Pull request event: 119
  • Fork event: 3

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 3,902
  • Total Committers: 3
  • Avg Commits per committer: 1,300.667
  • Development Distribution Score (DDS): 0.002
Past Year
  • Commits: 370
  • Committers: 3
  • Avg Commits per committer: 123.333
  • Development Distribution Score (DDS): 0.016
Top Committers
Name Email Commits
Andreas Dutzler a****r@g****m 3,896
Tetsuo Koyama t****0@g****m 3
Bhavesh Shrimali b****i@g****m 3

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • Total issues: 244
  • Total pull requests: 473
  • Average time to close issues: about 1 month
  • Average time to close pull requests: about 24 hours
  • Total issue authors: 8
  • Total pull request authors: 3
  • Average comments per issue: 0.44
  • Average comments per pull request: 0.87
  • Merged pull requests: 435
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 41
  • Pull requests: 130
  • Average time to close issues: 2 days
  • Average time to close pull requests: about 9 hours
  • Issue authors: 6
  • Pull request authors: 2
  • Average comments per issue: 0.68
  • Average comments per pull request: 0.95
  • Merged pull requests: 118
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • adtzlr (231)
  • yvanblanchard (6)
  • tkoyama010 (2)
  • nicoguaro (1)
  • abhiawasthi1993 (1)
  • KosVla (1)
  • AleVaghi (1)
  • crhea93 (1)
Pull Request Authors
  • adtzlr (465)
  • tkoyama010 (6)
  • bhaveshshrimali (2)
Top Labels
Issue Labels
enhancement (121) bug (63) documentation (31) consistency (6) wontfix (6) help wanted (6) plotting (6) question (5) performance (3)
Pull Request Labels
enhancement (378) bug (69) documentation (45) plotting (21) consistency (12)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 2,461 last-month
  • Total dependent packages: 2
  • Total dependent repositories: 1
  • Total versions: 79
  • Total maintainers: 1
pypi.org: felupe

Finite Element Analysis

  • Versions: 79
  • Dependent Packages: 2
  • Dependent Repositories: 1
  • Downloads: 2,461 Last month
Rankings
Dependent packages count: 3.2%
Stargazers count: 11.6%
Downloads: 12.9%
Average: 12.9%
Forks count: 15.4%
Dependent repos count: 21.6%
Maintainers (1)
adtzlr
Last synced: 4 months ago

Dependencies

.github/workflows/publish-to-pypi.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • pypa/gh-action-pypi-publish release/v1 composite
pyproject.toml pypi
  • numpy *
  • scipy *
.github/workflows/upload-codecov.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • codecov/codecov-action v4 composite