bstart-trb 0.2.0__tar.gz → 0.2.1__tar.gz

bstart_trb-0.2.1/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.4
+Name: bstart-trb
+Version: 0.2.1
+Summary: Add your description here
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: numpy>=2.0.0
+Provides-Extra: demo
+Requires-Dist: openpyxl>=3.1.5; extra == 'demo'
+Requires-Dist: pandas>=2.0.0; extra == 'demo'
+Requires-Dist: plotly>=5.0.0; extra == 'demo'
+Description-Content-Type: text/markdown
+
+# BSTART-TRB
+
+**Cylindrical/Tapered Roller Bearing Slice Stress Calculation Module**
+
+A high-performance Python package for calculating contact stress distribution in roller bearings using the slice method with Fortran computational core.
+
+## Features
+
+- 🚀 **Fast Fortran Core**: Compiled Fortran code via f2py for optimal performance
+- 📦 **Pre-compiled Binary**: No Fortran compiler required for installation
+- 🎯 **Type-Safe**: Complete type hints and IDE support
+- 🔬 **Accurate**: Uses influence coefficient method based on elastic contact theory
+- 📊 **Flexible**: Supports various crown types (linear, circular, logarithmic)
+
+## Installation
+
+```bash
+pip install bstart-trb
+```
+
+**Note**: This package includes pre-compiled binaries for Windows (x64). Support for other platforms coming soon.
+
+## Quick Start
+
+```python
+from bstart_trb import (
+    slice_stress,
+    RollerParams,
+    RacewayParams,
+    CrownType,
+    RacewayType,
+)
+
+# Define cylindrical roller parameters
+roller = RollerParams(
+    d1=10.0,              # Small end diameter (mm)
+    d2=10.0,              # Large end diameter (mm)
+    length=9.6,           # Effective length (mm)
+    alfa=0.0,             # Half cone angle (degrees)
+    tilt=0.0,             # Tilt angle (degrees)
+    crown_type=CrownType.LOGARITHMIC,
+    curve_q=14100.0,      # Design load (N)
+)
+
+# Define outer ring raceway parameters
+raceway = RacewayParams(
+    diameter=-150.0,      # Negative for concave surface (mm)
+    raceway_type=RacewayType.OUTER,
+    fai=0.0,              # Half cone angle (degrees)
+)
+
+# Calculate slice stress distribution
+result = slice_stress(roller, raceway, load=1340.86, n_slice=30)
+
+# Access results
+print(f"Max stress: {result.max_stress:.0f} MPa")
+print(f"Contact deflection: {result.deflection:.6f} mm")
+print(f"Stress uniformity: {result.stress_uniformity:.2%}")
+print(f"Contact slices: {result.contact_slices}/{result.n_slice}")
+```
+
+## What is Slice Calculation?
+
+The slice method divides the roller-raceway contact into multiple slices along the roller length to accurately calculate stress distribution. This is essential for:
+
+- Capturing edge stress concentration effects
+- Analyzing the impact of crown modifications
+- Predicting bearing life more accurately
+- Understanding load distribution along roller length
+
+## Key Parameters
+
+### Roller Parameters
+
+- `d1`, `d2`: Roller diameters (mm) - equal for cylindrical rollers
+- `length`: Effective roller length (mm)
+- `alfa`: Half cone angle (degrees) - 0 for cylindrical rollers
+- `tilt`: Roller tilt angle (degrees)
+- `crown_type`: Crown modification type
+  - `STRAIGHT`: No crown modification
+  - `CIRCULAR`: Circular crown
+  - `LOGARITHMIC`: Logarithmic crown (recommended)
+- `curve_q`: Design load (N) for optimal stress distribution
+
+### Raceway Parameters
+
+- `diameter`: Raceway diameter (mm) - negative for outer ring (concave)
+- `raceway_type`: `INNER` or `OUTER`
+- `fai`: Raceway cone angle (degrees)
+
+### Calculation Parameters
+
+- `load`: Applied load on roller (N)
+- `n_slice`: Number of slices (default 30, max 50)
+
+## Theory
+
+This package implements the **influence coefficient method** based on elastic half-space contact theory:
+
+1. Discretizes roller into slices
+2. Calculates elastic coupling between slices (influence coefficient matrix)
+3. Solves linear system using Gaussian elimination
+4. Iterates to convergence for contact area and load balance
+
+The method is more accurate than simplified Hertz formulas as it accounts for:
+- Elastic coupling between slices
+- Dynamic contact area determination
+- Edge loading effects
+- Crown modification influence
+
+## Requirements
+
+- Python >= 3.11
+- NumPy >= 2.0.0
+
+## Platform Support
+
+| Platform | Status |
+|----------|--------|
+| Windows (x64) | ✅ Supported |
+| Linux | 🚧 Coming soon |
+| macOS | 🚧 Coming soon |
+
+## License
+
+MIT License - See LICENSE file for details.
+
+## Author
+
+Gu Lei
+
+## References
+
+- Harris, T.A., Kotzalas, M.N. - *Rolling Bearing Analysis*, 5th Edition
+- Johnson, K.L. - *Contact Mechanics*
+- ISO/TS 16281:2008 - Rolling bearings calculation methods
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit issues or pull requests.

{bstart_trb-0.2.0 → bstart_trb-0.2.1}/README_PYPI.md

@@ -23,7 +23,7 @@ pip install bstart-trb
 ## Quick Start
 
 ```python
-from slice_wrapper import (
+from bstart_trb import (
     slice_stress,
     RollerParams,
     RacewayParams,
@@ -110,7 +110,7 @@ The method is more accurate than simplified Hertz formulas as it accounts for:
 
 ## Requirements
 
-- Python >= 3.12
+- Python >= 3.11
 - NumPy >= 2.0.0
 
 ## Platform Support

{bstart_trb-0.2.0 → bstart_trb-0.2.1}/bstart_trb/__init__.py

@@ -60,4 +60,4 @@ __all__ = [
     "is_fortran_available",
 ]
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"

{bstart_trb-0.2.0 → bstart_trb-0.2.1}/pyproject.toml

@@ -1,14 +1,18 @@
 [project]
 name = "bstart-trb"
-version = "0.2.0"
+version = "0.2.1"
 description = "Add your description here"
-readme = "README.md"
+readme = "README_PYPI.md"
 requires-python = ">=3.11"
 dependencies = [
-    "numpy>=2.4.2",
+    "numpy>=2.0.0",
+]
+
+[project.optional-dependencies]
+demo = [
     "openpyxl>=3.1.5",
-    "pandas>=3.0.0",
-    "plotly>=6.5.2",
+    "pandas>=2.0.0",
+    "plotly>=5.0.0",
 ]
 
 [build-system]
@@ -42,3 +46,8 @@ exclude = [
     "bstart_trb/_taper_slice/**",
     "bstart_trb/__pycache__/**",
 ]
+
+[dependency-groups]
+dev = [
+    "twine>=6.2.0",
+]