# Materials Project Insertion Battery Electrodes (2024-11-14 Release)

## Facts

- Provider: Materials Project, Lawrence Berkeley National Laboratory
- License: CC-BY-4.0 (https://next-gen.materialsproject.org/about/terms)
- Format: JSON Lines (in sampled files)
- Stored at: Amazon S3, s3://materialsproject-build/collections/2024-11-14/insertion-electrodes (us-east-1)
- Access: public, readable without an account
- Category: Chemistry & Materials
- Source: https://doi.org/10.1063/1.4812323
- Page: https://scigantic.com/archive/bb92f1a2-7ee3-5384-ad5c-d0b55600cfcd
- Keywords: Chemistry & Materials, DFT, JSON Lines, AWS Open Data

## About

The Materials Project insertion electrode collection from release 2024-11-14: 5,605 intercalation electrode systems according to the manifest, each grouping framework structures at different working-ion contents with DFT (GGA/GGA+U) average voltages, voltage profiles, gravimetric and volumetric capacity, energy density, volume change, and stability of charged and discharged states. Working ions are Li (2,437 systems), Mg (1,440), Ca (549), Zn (390), Na (314), Y, Al, K, Cs and Rb. Documents are gzip-compressed JSON Lines partitioned by nelements=1 to 6 with manifest.parquet listing battery_id, working_ion and path. Used for cathode screening for Li-ion and multivalent batteries. Read anonymously with the AWS CLI (--no-sign-request), boto3 or the mp-api client, which uses these buckets internally; Materials Project releases its data under CC-BY-4.0 (GNoME-derived entries in other collections are CC-BY-NC and are not part of this folder). Cite Jain et al., APL Materials 1, 011002 (2013).

## Load the data

```python
import boto3
from botocore import UNSIGNED
from botocore.client import Config
s3 = boto3.client('s3', region_name='us-east-1', config=Config(signature_version=UNSIGNED))
s3.list_objects_v2(Bucket='materialsproject-build', Prefix='collections/2024-11-14/insertion-electrodes/', Delimiter='/')
```

Lists the files with anonymous access. Runs on any machine, with no cloud account.

## Data structure

File types in sampled files: JSON Lines

Example file: `collections/2024-11-14/insertion-electrodes/nelements=1/working_ion=Al.jsonl.gz`

Path pattern: `{prefix}/{YYYY-MM-DD}/{seg2}/{seg3}/{filename}`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/bb92f1a2-7ee3-5384-ad5c-d0b55600cfcd
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/bb92f1a2-7ee3-5384-ad5c-d0b55600cfcd
- Over MCP: `get_schema_card` with id `bb92f1a2-7ee3-5384-ad5c-d0b55600cfcd` at https://api.scigantic.com/mcp

## Related topics

- [Chemistry & Materials datasets](https://scigantic.com/topics/chemistry-and-materials)
- [DFT datasets](https://scigantic.com/topics/dft)
- [JSON Lines datasets](https://scigantic.com/topics/json-lines)
