Output Format
=============

This page describes the structure and content of all output artifacts produced by the LoS Estimator.

Directory Structure
-------------------

Results are saved to the ``results/`` directory with the following structure:

::

    results/
    └── <YYYYMMDD_HHMM>_dev_step<N>_train<N>_test<N>_fit_admissions_<error_fn>/
        ├── run.log                           # Detailed run log
        ├── run_configurations.toml           # Configuration snapshot
        ├── model_data/
        │   ├── series_data.pkl               # Loaded time series (binary)
        │   ├── all_fit_results.pkl           # All fit results (binary)
        │   ├── visualization_context.pkl     # Visualization metadata (binary)
        │   └── <distro>_models.csv           # Model parameters per window for each distribution function
        ├── figures/
        │   ├── error_comparison.png          # Bar plot of mean and median test and train errors
        │   ├── prediction_all_distros.png    # All distribution and time point predictions overlaid
        │   ├── prediction_error_all_distros.png    # All distribution and time point predictions overlaid with errors.
        │   ├── prediction_error<distro>_fit.png    # Predictions and errors for a specific distribution at all time points
        │   ├── test_error_boxplot.png
        │   ├── test_error_boxplot_no_outliers.png
        │   ├── test_error_boxplot_no_outliers.png
        │   ├── train_error_boxplot.png
        │   ├── train_error_boxplot_no_outliers.png
        │   └── train_vs_test_error.png
        ├── animation/
        │   ├── <distro>fit_<day>.png         # Individual frames
        │   └── <distro>combined_video.gif    # Combined animation
        └── metrics/
            ├── <metric>_test.png             # Metric for each distribution function at each time point
            ├── metrics_train.csv             # Metric values for training data
            └── metrics_test.csv              # Metric values for test data