# Model Datasheet: OverloadModel

## General Information
- **Model Name:** OverloadModel
- **Current Version:** v4.0
- **Model file extension:** .pt
- **Datasource:**
  - **Wellness:**
    - `athleteId`
    - `sleepQuality`
    - `fatigueLevel`
    - `muscleSoreness`
  - **Sprint:**
    - `totalPlayerLoadAu`
    - `highIntensityRunningM`
- **Training Required:** True

### Description
Multi-table analytics model that predicts acute athlete injury risk and physical overload. It cross-references external GPS load data (totalPlayerLoadAu, highIntensityRunningM) from the sprints db with the athlete's structural lean mass foundation (ffm) from the inbody db to detect if the training volume exceeds the individual's structural tissue capacity.

## Training Metadata & Configuration

### Metadata
- **Dataset Name:** OverLoadDataset
- **Dataset Size Samples:** 85000
- **Epochs Trained:** 32
- **Framework Version:** PyTorch 2.3.0

### Training Parameters
> **Note:** The use of these parameters is optional and primarily intended for filtering or narrowing down the dataset.

- **fromDate & toDate:** These parameters are used exclusively for filtering the dataset based on the `createdAt` timestamp of the records.
- **uuids:** This field accepts a list of specific UUIDs. It is used when you want to restrict the model training to a targeted subset of UUIDs only.

Any other domain-specific filtering (e.g., sprintFilters, bloodTestFilters, fitnessFilters, inbodyFilters) must follow a structured format where you define the target field, the comparison operator, and the threshold value.

#### Expected Filter Structure:
{
  "field": "<table_field_name>",
  "operator": "<filter_operator>",
  "value": "<threshold_value>"
}
#### Allowed Filter Operators:
The `operator` field strictly accepts one of the following operations:
- eq: Equal to
- neq: Not equal to
- gt: Greater than
- gte: Greater than or equal to
- lt: Less than
- lte: Less than or equal to
- in: Value is present within a specified list
- contains: String contains a specific substring (case-insensitive)

## Training Data & Execution Ledger

### Run History Table
| Run ID | Execution Date | Training Parameters | Hyperparameters | Status / Result |
| :--- | :--- | :--- | :--- | :--- |
| v1.0 | 2026-08-26 12:21:58 | None | **a**: a | Uploaded |
| v2.0 | 2026-08-26 12:22:14 | None | **epochs**: 1 <br> **device**: cpu <br> **workers**: 1 | Completed |
| v3.0 | 2026-08-26 13:37:11 | None | **epochs**: 1 <br> **device**: cpu <br> **workers**: 1 | Completed |
| v4.0 | 2026-08-27 08:56:12 | None | **epochs**: 1 <br> **device**: cpu <br> **workers**: 1 | Completed |

### Training Results
| Training ID | Loss | Accuracy | Epochs Completed | Status |
| :--- | :--- | :--- | :--- | :--- |
| Training v2.0 | 0.0 | 1.0 | 1 | completed |
| v3.0 | 0.0 | 1.0 | 1 | completed |
| v4.0 | 0.0 | 1.0 | 1 | completed |