Installation Guide

Requirements

Tensile requires Python 3.8 or later.

Dependencies

Core Dependencies (Required)

These packages are essential for basic functionality:

Package	Version	Purpose
pandas	≥1.3.0	Data manipulation and CSV I/O
numpy	≥1.21.0	Numerical computations
scipy	≥1.7.0	Statistical analysis and regression
openpyxl	≥3.0.0	Excel file export
piecewise-regression	≥1.0.0	Automated elastic region detection

Optional Dependencies

These packages enable additional features:

Package	Version	Purpose
plotly	≥5.0.0	Interactive visualizations
kaleido	≥0.2.0	Export plots to PNG/SVG
statsmodels	≥0.13.0	Advanced statistical models
pykalman	≥0.9.0	Kalman filtering

Installation Methods

Option 1: Minimal Installation

Install only core dependencies for basic analysis:

pip install pandas numpy scipy openpyxl piecewise-regression

Option 2: Full Installation (Recommended)

Install all dependencies including visualization:

pip install pandas numpy scipy openpyxl piecewise-regression plotly kaleido

Option 3: Additional Features

Install everything including additional reconstruction methods:

pip install pandas numpy scipy openpyxl piecewise-regression plotly kaleido statsmodels pykalman

Installation from Source

Clone the Repository

git clone [link will be provided later when published]
cd tensile

Check Version

python -c "import tensile; print(f'Tensile version: {tensile.__version__}')"

Check Optional Features

python -c "import tensile; print(f'Visualization available: {tensile.PHASE4_AVAILABLE}')"

Virtual Environments

We strongly recommend using a virtual environment to avoid dependency conflicts:

Using venv

# Create virtual environment
python -m venv tensile-env

# Activate (Linux/macOS)
source tensile-env/bin/activate

# Activate (Windows)
tensile-env\Scripts\activate

# Install tensile
pip install pandas numpy scipy openpyxl piecewise-regression plotly

Using conda

# Create conda environment
conda create -n tensile python=3.10

# Activate environment
conda activate tensile

# Install dependencies
conda install pandas numpy scipy openpyxl plotly
pip install piecewise-regression