3pc-lamfail 1.0.0__py3-none-any.whl

3pc_lamfail-1.0.0.dist-info/METADATA

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: 3pc-lamfail
+Version: 1.0.0
+Summary: 3pc Python Package for Anisotropic Laminate Failure Analysis
+Author: Omprakash Seresta
+Author-email: oseresta@gmail.com
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: 3pc-material
+Requires-Dist: 3pc-ply
+Requires-Dist: 3pc-laminate
+Requires-Dist: 3pc-panel
+Requires-Dist: 3pc-loads
+Requires-Dist: 3pc-utils
+Requires-Dist: numpy
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 3pc-lamfail
+
+`3pc-lamfail` is a Python library used for ply-wise stress and strain analysis of shear deformable anisotropic laminates under hygrothermal and mechanical loads. It provides a `Lamfail` class to calculate stresses, strains, and various margins of safety (MS) based on classical and first-order shear deformation theories.
+
+## Installation
+
+Use the package manager [pip](https://pip.pypa.io/en/stable/) to install `3pc-lamfail`. Since the package and its dependencies are available on PyPI, you can install them directly:
+
+```bash
+pip install 3pc-lamfail
+```
+
+## API Reference
+
+### `Lamfail` Class
+
+The primary component of this package is the `Lamfail` class, which takes a panel and a load case to compute detailed failure metrics.
+
+```python
+from lamfail.lamfail import Lamfail
+```
+
+#### Required Parameters
+
+When initializing `Lamfail`, the following parameters are required:
+
+*   **`panel`** *(Panel)*: An instance of the `Panel` class (from `3pc-panel`) containing the laminate definition and geometry.
+*   **`loads`** *(Loads)*: An instance of the `Loads` class (from `3pc-loads`) containing the load case and environmental conditions.
+
+#### Calculated Properties
+
+The class automatically calculates the following properties lazily:
+
+*   **`NT`, `MT`**: Thermal in-plane loads and moments.
+*   **`NC`, `MC`**: Hygral in-plane loads and moments.
+*   **`ek0`**: Mid-plane strains and curvatures `[ex0, ey0, gxy0, kx0, ky0, kxy0]`.
+*   **`gT0`**: Mid-plane transverse strains `[gyz0, gxz0]`.
+*   **`tauyz`, `tauxz`**: Transverse shear stresses for each ply.
+*   **`stress`**: Total stress in reference coordinate axes (x-y-z) for each ply (bottom, mid, top).
+*   **`stressM`, `stressT`, `stressH`**: Mechanical, thermal, and hygral components of stress in reference axes.
+*   **`stress1`, `stressM1`, `stressT1`, `stressH1`**: Stresses transformed to material coordinate axes (1-2-3).
+*   **`strain`, `strainM`, `strainT`, `strainH`**: Strains in reference coordinate axes.
+*   **`strain1`, `strainM1`, `strainT1`, `strainH1`**: Strains in material coordinate axes.
+
+#### Margins of Safety (MS)
+
+The following failure theories are implemented:
+
+*   **`stress1MS`**: Max Stress theory using total stress.
+*   **`stressM1MS`**: Max Stress theory using mechanical stress.
+*   **`strain1MS`**: Max Strain theory using total strain.
+*   **`strainM1MS`**: Max Strain theory using mechanical strain.
+*   **`tsaiHill1MS`, `tsaiHillM1MS`**: Tsai-Hill failure theory (Total/Mechanical).
+*   **`tsaiWu1MS`, `tsaiWuM1MS`**: Tsai-Wu failure theory (Total/Mechanical).
+
+### Methods
+
+#### `Lamfail.fromDict(**kwargs)`
+
+Initializes a `Lamfail` instance using a dictionary of keyword arguments.
+
+---
+
+## Usage Examples
+
+### Basic Initialization
+
+Below is an example of performing a failure analysis on a panel under a specific load case.
+
+```python
+from panel.panel import Panel
+from loads.loads import Loads
+from lamfail.lamfail import Lamfail
+
+# Assuming pnl (Panel) and ld (Loads) are already defined
+lf = Lamfail(panel=pnl, loads=ld)
+
+# Access Margins of Safety for Ply 1 (bottom ply)
+print("Max Stress MS (Material Axes):", lf.stress1MS["1"]["mid"])
+print("Tsai-Wu MS:", lf.tsaiWu1MS["1"]["mid"])
+
+# Access stresses
+print("Total Stress (x-y-z):", lf.stress["1"]["top"])
+```
+
+## Commands
+
+The package provides a command-line interface entry point. After installing, you can run the application using:
+
+```bash
+lamfail input.cfg
+```
+
+*(This entry point is defined in `lamfail.__main__:main`)*
+
+### Options
+
+*   **`config`** *(positional)*: Specify the configuration file (`.cfg`) to run the analysis.
+*   **`-h, --help`**: Show the help message and exit.
+*   **`-v, --version`**: Show the version number.
+*   **`-s, --sample`**: Copy example files (materials, plies, laminates, etc.) to the current directory.

3pc_lamfail-1.0.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+3pc_lamfail-1.0.0.dist-info/licenses/LICENSE,sha256=2KMUaPkoYr_QP6rwqzCgBScHF4slPuma2kWSD24cDQo,1074
+lamfail/CONSTANTS.py,sha256=mbfFDvfqjNZkieA1BCmqhgi14k-0BSiLZwnRooM-M8s,45
+lamfail/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lamfail/__main__.py,sha256=xOKdSbE-dQbAnX5OyquQdEo_yTthZnF0AK9kQcIRr7o,138
+lamfail/expiry_wrapper.py,sha256=ljlztXSesfeCjIgrBcHdqpijIAHAKCqJstVd5Pr98hI,206
+lamfail/lamfail.py,sha256=SuaocQa99Oe_qSkbJncN18dSwU4fLyVysQlSYgLt-Ww,49489
+lamfail/lamfailIO.py,sha256=U19RbkPk2sjZIA_0BLuf4n27SrehzEKEXNFSR5A6pVY,60031
+lamfail/main.py,sha256=vwBb0lrykL4HMFxS3ym4pQbNmLw-9EDojDNcN5RheF4,2134
+lamfail/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lamfail/tests/test_lamfail.py,sha256=7_JKEmlAuPbFciFzx5IssFIW85ngZSpDAGatDoNcadg,4474
+3pc_lamfail-1.0.0.dist-info/METADATA,sha256=uZqLyqudSB7qC_2MAQivLY0NkXuIaxxvN9IjOYCvGFU,4635
+3pc_lamfail-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+3pc_lamfail-1.0.0.dist-info/entry_points.txt,sha256=ySe516FFlDU8lU7jONooLiLDx9jQCoFHi0fT5Loa0YM,46
+3pc_lamfail-1.0.0.dist-info/top_level.txt,sha256=-ikqJrClQ5v6AmHJkqTsaSS3P5q_-u7PIr0myjrB66s,8
+3pc_lamfail-1.0.0.dist-info/RECORD,,

3pc_lamfail-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

3pc_lamfail-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+lamfail = lamfail.main:main

3pc_lamfail-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omprakash Seresta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

3pc_lamfail-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+lamfail

lamfail/CONSTANTS.py

@@ -0,0 +1,3 @@
+STRESSMIN = 0.01
+STRAINMIN = 1e-6
+TOL = 0.001

lamfail/__main__.py

@@ -0,0 +1,6 @@
+from lamfail.main import main
+
+if __name__ == '__main__':
+    """Main entry point of the command line application - lamfail"""
+
+    main()

lamfail/expiry_wrapper.py

@@ -0,0 +1,8 @@
+from datetime import datetime
+import sys
+
+def check_expiry():
+    expiry_date = datetime(2025, 12, 31)
+    if datetime.now() > expiry_date:
+        print("This application has expired.")
+        sys.exit(1)