Schema Reference — rosetta_v0.1
metadata required
| Field | Type | Required | Description |
|---|---|---|---|
| experiment_id | string | req | Unique experiment identifier. Pattern: [A-Za-z0-9_\-]+ |
| date | string | req | Experiment start date, ISO 8601 YYYY-MM-DD |
| cell_type | const | req | Fixed value: "HC_Li_Cu". HC = Half-Cell (not Hard Carbon) |
| operator | string | opt | Researcher name or ID |
| electrolyte.name | string | req* | Formulation name, e.g. "1M LiTFSI in DOL:DME" |
| electrolyte.concentration_M | number | opt | Salt concentration in mol/L |
| electrolyte.solvent | string | opt | Solvent system, e.g. "DOL:DME 1:1 v/v" |
| electrolyte.additive | string | opt | Additive, e.g. "2 wt% LiNO3" |
| current_collector | const | opt | Fixed value: "Cu" |
| capacity_mAh_cm2 | number | opt | Areal capacity target (mAh/cm²) |
| area_cm2 | number | opt | Electrode geometric area (cm²) |
| current_density_mA_cm2 | number | opt | Applied current density (mA/cm²) |
| temperature_C | number | opt | Experiment temperature (°C) |
| notes | string | opt | Free-text notes |
electrolyte object is presentcycles[] required · array · minItems: 1
| Field | Type | Required | Description |
|---|---|---|---|
| cycle_number | integer | req | Sequential cycle index ≥ 1 |
| CE | number | req | Coulombic efficiency ∈ [0, 1]. CE = Q_discharge / Q_charge |
| capacity_charge_mAh_cm2 | number | req | Li plating areal capacity (mAh/cm²) |
| capacity_discharge_mAh_cm2 | number | req | Li stripping areal capacity (mAh/cm²) |
| voltage_plateau_V | number | opt | Average stripping plateau vs Li/Li⁺ (V) |
| timestamp | date-time | opt | ISO 8601 datetime when cycle completed |
| overpotential_mV | number | opt | Nucleation overpotential (mV), typically negative |
characterization optional
| Field | Type | Required | Description |
|---|---|---|---|
| EIS.frequency_Hz | number[] | req* | Frequency sweep array (Hz) |
| EIS.Z_real | number[] | req* | Impedance real part array (Ω) |
| EIS.Z_imag | number[] | req* | Impedance imaginary part array (Ω) |
| EIS.cycle_after | integer | opt | Cycle index after which EIS was taken (0 = before cycling) |
| dQ_dV.voltage | number[] | req* | Voltage array (V) |
| dQ_dV.dQdV | number[] | req* | Differential capacity array (mAh/V) |
| dQ_dV.cycle_number | integer | opt | Source cycle for dQ/dV derivation |
Online Validator
Drop a JSON file to validate it against Rosetta v0.1. Validation runs entirely in-browser — no data is uploaded.
Drop JSON file here or click to browse
Accepts: .json
CE vs Cycle Number
About Rosetta
Rosetta is the AtomGrid data standardization layer for battery cycling experiments. v0.1 targets the most common anode characterization setup: the lithium–copper half-cell (HC), used to benchmark Coulombic efficiency and Li deposition morphology in lithium metal batteries (LMB) and anode-free LMBs (AF-LMB).
Terminology note: in this schema, HC always means Half-Cell (Li-Cu cell configuration),
never Hard Carbon. cell_type: "HC_Li_Cu" is the canonical identifier.
The schema is built on JSON Schema Draft 2020-12 and validated with AJV (browser) and jsonschema (Python CLI).
Links
- github.com/AtomRearch/AtomGrid
- Raw Schema Viewer
- Validator CLI:
python validator/validate.py data.json
Roadmap
- v0.2 — Full-cell (cathode + anode paired) schema
- v0.3 — DEIS (dynamic EIS) time-series extension
- v0.4 — Multi-experiment batch container