# Materials Project VASP Charge Densities (CHGCAR)

## Facts

- Provider: Materials Project, Lawrence Berkeley National Laboratory
- License: CC-BY-4.0 (https://next-gen.materialsproject.org/about/terms)
- Stored at: Amazon S3, s3://materialsproject-parsed/chgcars (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/690ad5d3-d300-535c-8384-7b20e0b716b7
- Keywords: Chemistry & Materials, AWS Open Data

## About

Total electron charge densities from Materials Project VASP static calculations, stored in the materialsproject-parsed bucket as gzip-compressed JSON serialisations of pymatgen Chgcar objects, one per calculation. Each holds the crystal structure and the valence charge density on a real-space FFT grid from PBE or PBE+U (and newer r2SCAN) runs with PAW potentials. MP's documentation lists about 415,000 objects and 7.7 TB. Charge densities are used to train electron density models (ChargE3Net, DeepDFT, equivariant density networks), for Bader charge analysis and to restart non-self-consistent band structure calculations. Companion folders aeccar0s/1s/2s hold the core and valence parts needed for Bader partitioning. 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='chgcars/', Delimiter='/')
```

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

## Data structure

Example file: `chgcars/.cache_materialsproject-parsed_chgcars`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/690ad5d3-d300-535c-8384-7b20e0b716b7
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/690ad5d3-d300-535c-8384-7b20e0b716b7
- Over MCP: `get_schema_card` with id `690ad5d3-d300-535c-8384-7b20e0b716b7` at https://api.scigantic.com/mcp

## Related topics

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