# Materials Project Electronic Densities of States (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/dos (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/cb4d2ab8-8944-5030-808d-93a03ef60f75
- Keywords: Chemistry & Materials, JSON, AWS Open Data

## About

Total and projected electronic densities of states from Materials Project VASP calculations, stored in materialsproject-parsed as gzip-compressed JSON serialisations of pymatgen CompleteDos objects. Each gives the total DOS per spin and the element- and orbital-projected (s, p, d, f) DOS on an energy grid, with the Fermi level, from PBE or PBE+U uniform-mesh runs with PAW potentials. MP's documentation lists about 692,000 objects and 63 GB. Typical uses are d-band centre descriptors for catalysis, training DOS prediction networks, and screening for metallicity or thermoelectric performance across inorganic crystals. 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='dos/', 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: `dos/mp-1000000.json.gz`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/cb4d2ab8-8944-5030-808d-93a03ef60f75
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/cb4d2ab8-8944-5030-808d-93a03ef60f75
- Over MCP: `get_schema_card` with id `cb4d2ab8-8944-5030-808d-93a03ef60f75` 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)
