Skip to content

faberorg/FatPy

FatPy

Build Status Documentation Code Coverage PyPI Version Python Version License

A Python package for fatigue life evaluation of materials.

Features

Core Modules

  • Stress-Life - Stress-based fatigue assessment methods for estimating fatigue damage with corrections for various effects (stress concentration, size, surface quality, etc.)
  • Strain-Life - Fatigue analysis using strain amplitude and cycles to failure relationships (ε-N approaches) such as Coffin-Manson and Basquin laws, suited for low-cycle and transitional fatigue regimes
  • Energy-Life - Fatigue analysis methods based on the relationship between strain energy density and number of cycles to failure
  • Damage Cumulation - Various fatigue damage accumulation rules for variable amplitude loading, including linear models (Palmgren-Miner) and advanced non-linear approaches accounting for load sequence effects
  • Decompositions - Methods for breaking down complex load signals into cycles, containing both uniaxial and multiaxial procedures
  • Plane-Based Methods - Methods for processing stress tensor paths on material planes, providing infrastructure for critical-plane and integral prediction approaches

Supporting Modules

  • Material Laws - Functions dealing with various material constitutive laws and behavior models
  • Structural Mechanics - Stress, strain analysis and transformation utilities
  • Utils - General utilities for mesh handling, signal processing, and data manipulation

Quick Links

Installation

pip install fatpy

For development installation and more options, see our detailed installation guide.

Documentation

The documentation includes:

Building Documentation Locally

# Install development dependencies
pip install -e .

# Build and serve documentation
mkdocs serve

Visit http://127.0.0.1:8000 to view the documentation locally.

Contributing

We welcome contributions. Please see our Contributing Guide for:

  • Setting up your development environment
  • Code quality guidelines and standards
  • Testing procedures
  • Documentation requirement
  • Pull request process

Testing

FatPy uses pytest for testing:

# Run all tests
pytest

# Run with coverage
pytest --cov=src/fatpy

The FABER Project

FatPy is a key initiative of Working Group 6 (WG6) within the FABER (Fatigue Benchmark Repository) project, operating under COST Action CA23109.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

Jan Vyborny - jan.vyborny2@gmail.com Project Link: github.com/faberorg/fatpy

Packages

No packages published

Contributors 2

  •  
  •  

Languages