lamkit 0.1.3

Toolkit for stress analysis and failure prediction of composite laminates with holes and joints.

lamkit

lamkit is a Python toolkit for composite laminate analysis, focused on:

• Laminate stress/strain response based on Classical Lamination Theory (CLT)
• LaRC05 failure index evaluation
• Lekhnitskii open-hole infinite-plate analytical solution
• Open-hole plate's effective (homogenisation) properties
• Linear buckling analysis of laminates
• Objective/constraint evaluation for laminate optimization tasks
• Layup engineering-requirement checks and feasibility rating against a layup attribute database

Installation

Requirements

• Python >=3.9
• Core dependencies: numpy, pandas, matplotlib
• Optional: scipy (linear buckling and layup feasibility rating)

Install from PyPI

pip install lamkit

Install for local development

pip install -e .[dev,docs]

Quick Start

The following example creates a laminate and evaluates ply-surface fields under membrane loading:

import numpy as np
from lamkit import Laminate, Ply
from lamkit.analysis.material import IM7_8551_7

ply = Ply(IM7_8551_7, thickness=0.125)  # mm
stacking = [45, -45, 0, 90, 90, 0, -45, 45]
laminate = Laminate(stacking=stacking, plies=ply)

# N = [Nxx, Nyy, Nxy, Mxx, Myy, Mxy]
N = np.array([80.0, 0.0, 0.0, 0.0, 0.0, 0.0])
field = laminate.evaluate_laminate(N)

print(field[["index_ply", "index_surface", "z", "sigma_1", "sigma_2", "tau_12", "FI_max"]].head())

Examples

The example/ directory contains runnable scripts:

1. Laminate response (CLT + LaRC05)
   example/1-laminate/example_laminate.py
   Computes through-thickness stress/strain and LaRC05 index distributions with plots.

2. Lekhnitskii unloaded-hole solution
   example/2-lekhnitskii-solution/example_unloaded_hole.py
   Solves and visualizes open-hole stress fields.

3. Laminate open-hole field analysis
   example/3-open-hole/example_open_hole.py
   Couples laminate equivalent compliance with open-hole fields and generates failure envelopes/boundary maps.

4. Effective stiffness with hole homogenization
   example/4-effective-stiffness/example_effective_stiffness.py
   Compares laminate stiffness A (without hole) and homogenized stiffness A_eff (with hole).

5. Laminate linear buckling
   example/5-laminate-buckling/example_buckling.py
   Computes buckling eigenvalues and saves buckling mode plots.

6. Optimization objective/constraint evaluation
   example/6-laminate-optimization-task/example_laminate_opt_function.py
   Demonstrates combined displacement, failure, and buckling constraint evaluation for design tasks.

7. Layup feasibility rating
   example/7-layup-feasibility/example_layup_feasibility.py
   Scores a candidate stacking (ply counts, bending lamination parameters) by distance to the nearest layups in a CSV database.

Common Development Commands

Run tests

pytest

Build distribution package

python -m build

Build documentation

cd docs
sphinx-build -b html . _build/html