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

# Data overview

> Organize, upload, and explore experimental battery cycling data in Ionworks Studio

Ionworks Studio provides an end-to-end toolkit for experimental battery data —
from ingesting raw cycler files, to organizing measurements against cell
specifications, to exploring results in the browser or via the Python API.

## Data hierarchy

Your experimental data is organized hierarchically within your organization:

```
Organization
└── Cell Specification (blueprint for a cell type)
    └── Cell Instance (specific physical cell)
        └── Cell Measurement
            ├── Time series  (high-resolution cycling data with steps and cycles)
            ├── Properties   (key-value measurements like thickness or weight)
            └── File         (images, PDFs, or other attached files)
```

<CardGroup cols={2}>
  <Card title="Cell Specification" icon="file-lines" href="/core-concepts/cells">
    The blueprint defining cell properties — materials, capacity, voltage
    limits. Shared across cells with identical specifications.
  </Card>

  <Card title="Cell Instance" icon="battery-full">
    A specific physical cell you're testing. Each instance has a unique
    identifier within your organization.
  </Card>

  <Card title="Cell Measurement" icon="flask" href="/data/measurements">
    A single experiment or test run on a cell instance. Each measurement has
    a type that determines what data it stores.
  </Card>

  <Card title="Data files" icon="file-waveform">
    Raw time-series data and computed summaries stored in optimized formats
    for fast visualization and analysis.
  </Card>
</CardGroup>

## Measurement types

Every cell measurement has a `measurement_type` — `time_series`, `properties`,
or `file` — that determines what data it stores. See
[measurements](/data/measurements) for the full table of types with their
fields, creation examples, and when to use each.

## Data workflow

<Steps>
  <Step title="Prepare your data">
    Convert raw cycler files into the Ionworks format using the
    [`ionworksdata`](https://data.docs.ionworks.com/) library. See
    [preparing data](/data/preparing-data).
  </Step>

  <Step title="Upload">
    Create cell specs, instances, and measurements via the Python API. See
    [uploading data](/data/uploading).
  </Step>

  <Step title="Read and analyze">
    Retrieve data back, filter, and plot with the Python client — see
    [reading data](/data/reading) — or explore interactively in the browser
    via [visualizing data](/data/visualizing).
  </Step>
</Steps>

## Browsing data tables

When you navigate to a cell specification or cell instance in Ionworks
Studio, data is displayed in sortable tables. Click any column header to
sort — once for ascending, again for descending, a third time to clear.
This works across cell measurement tables and pipeline tables alike.

## Next steps

<CardGroup cols={2}>
  <Card title="Data format" icon="file-code" href="/data/format">
    Recognized columns, units, and sign conventions.
  </Card>

  <Card title="Preparing data" icon="file-import" href="/data/preparing-data">
    Read cycler files with the ionworksdata library.
  </Card>

  <Card title="Uploading data" icon="upload" href="/data/uploading">
    Upload cell specs, instances, and measurements via the Python API.
  </Card>

  <Card title="Visualizing data" icon="chart-line" href="/data/visualizing">
    Explore uploaded data with the interactive viewer.
  </Card>

  <Card title="Raw data" icon="file-arrow-up" href="/data/raw-data">
    Archive original cycler files and link them to the measurements they
    produced for full provenance.
  </Card>

  <Card title="Lab view" icon="flask-vial" href="/data/lab">
    Register sites, cyclers, and channels, link each measurement to the
    physical channel it ran on, and see channel occupancy at a glance.
  </Card>
</CardGroup>
