# Materials Project Electronic Band Structures (VASP)

## Facts

- Provider: Materials Project, Lawrence Berkeley National Laboratory
- License: CC-BY-4.0 (https://next-gen.materialsproject.org/about/terms)
- Format: JSON (in sampled files)
- Stored at: Amazon S3, s3://materialsproject-parsed/bandstructures (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/b641df66-d271-53e5-98f1-65238617737f
- Keywords: Chemistry & Materials, JSON, AWS Open Data

## About

Electronic band structures from Materials Project non-self-consistent VASP calculations along high-symmetry k-paths (Setyawan-Curtarolo and Hinuma conventions) and on uniform grids, stored in materialsproject-parsed as gzip-compressed JSON serialisations of pymatgen BandStructure objects keyed by task id. Each object gives eigenvalues per k-point and spin, the Fermi level, band gap data and projections where computed, from PBE or PBE+U with PAW potentials. MP's documentation lists about 705,000 objects and 1.5 TB. Load them with pymatgen (BandStructureSymmLine.from_dict) to plot dispersions, extract effective masses or train band-structure prediction models. 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-parsed', Prefix='bandstructures/', Delimiter='/')
```

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

## Data structure

File types in sampled files: JSON

Example file: `bandstructures/mp-1000000.json.gz`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/b641df66-d271-53e5-98f1-65238617737f
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/b641df66-d271-53e5-98f1-65238617737f
- Over MCP: `get_schema_card` with id `b641df66-d271-53e5-98f1-65238617737f` at https://api.scigantic.com/mcp

## Related topics

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