Data hierarchy
Your experimental data is organized hierarchically within your organization:Cell Specification
The blueprint defining cell properties — materials, capacity, voltage
limits. Shared across cells with identical specifications.
Cell Instance
A specific physical cell you’re testing. Each instance has a unique
identifier within your organization.
Cell Measurement
A single experiment or test run on a cell instance. Each measurement has
a type that determines what data it stores.
Data files
Raw time-series data and computed summaries stored in optimized formats
for fast visualization and analysis.
Measurement types
Every cell measurement has ameasurement_type — time_series, properties,
or file — that determines what data it stores. See
measurements for the full table of types with their
fields, creation examples, and when to use each.
Data workflow
1
Prepare your data
Convert raw cycler files into the Ionworks format using the
ionworksdata library. See
preparing data.2
Upload
Create cell specs, instances, and measurements via the Python API. See
uploading data.
3
Read and analyze
Retrieve data back, filter, and plot with the Python client — see
reading data — or explore interactively in the browser
via visualizing data.
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
Data format
Recognized columns, units, and sign conventions.
Preparing data
Read cycler files with the ionworksdata library.
Uploading data
Upload cell specs, instances, and measurements via the Python API.
Visualizing data
Explore uploaded data with the interactive viewer.
Raw data
Archive original cycler files and link them to the measurements they
produced for full provenance.
Lab view
Register sites, cyclers, and channels, link each measurement to the
physical channel it ran on, and see channel occupancy at a glance.