> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adaptyvbio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Binding Data Package

> What arrives in your downloadable binding data bundle and how to work with it.

<Callout>
  When a kinetics experiment is pushed to the portal, we generate a new archive that captures the exact data version customers can download.
</Callout>

<img src="https://mintcdn.com/adaptyv-a4917ef6/uhrjjj4lpKZSQwxv/images/data-package.png?fit=max&auto=format&n=uhrjjj4lpKZSQwxv&q=85&s=50c856b97692518c4e8148e461d6e12d" alt="Download additional raw data button" width="1580" height="358" data-path="images/data-package.png" />

## Getting Started

1. Download the `package.zip` archive from the Foundry Portal (`Download Data` → `Download additional raw data`).
2. Unzip and open the extracted `package/` directory.
3. Use the sections below as a field guide while browsing.

All contents are safe to share publicly and ready for downstream analysis or visual inspection.

## Folder Overview

### `kinetics/`

PNG sensorgrams for each sample replicate, named `<name>_<replicate>.png`.

Use these plots for quick visual QC without loading raw data.

### `raw_data/`

CSV exports of the instrument readouts, using `<name>_<replicate>_<concentration>.csv`.

Columns:

* `t`: time in seconds
* `y`: instrument response in nanometers

Additional notes:

* Values are rounded to three decimals to reduce package size.
* Neutralisation controls follow `control_<index>_<concentration>.csv` and share the same schema.

### `fit_data/`

Modelled sensorgrams for replicates with approved fits (`t`, `y` columns), matching the `raw_data/` filename convention. Overlay these with the raw traces to reproduce kinetics calculations.

### `aux/`

Metadata lives in `replicate_info.csv`:

* `name`: OS-safe protein identifier
* `replicate`: replicate index
* `method`: `BLI` or `SPR`
* `MAE`: mean absolute error (two decimals)
* `rel_MAE`: MAE normalized by maximum signal
* `rmax_estimate`: estimated Rmax value

### `blanks/` (when provided)

Background and reference material for the experiment.

* `raw_data/`
  * `<blank_run>_<index>.csv`: blank curves (`t`, `y`)
  * `read_data.csv`: metadata with `read`, `run`, `concentration_nM`, `filename`
* `figures/`
  * `blank_<run>.png`: visualizations of blank sensorgrams
* `run_mapping.csv`
  * Columns: `name`, `replicate`, `runs` — shows blank runs tied to each replicate.

## Additional Notes

* Filenames replace spaces and special characters with underscores for compatibility.
* Folder structure is machine-readable and works well with automated pipelines.
* Each archive reflects the current data version; redownload after updates to stay in sync.