# Materials Project Electrostatic Potentials (VASP LOCPOT)

## 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/locpots (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/966b1e7b-6060-56b5-b603-1c52b82cd600
- Keywords: Chemistry & Materials, JSON, AWS Open Data

## About

Local electrostatic potentials (VASP LOCPOT) from Materials Project calculations, stored in materialsproject-parsed as compressed pymatgen Locpot serialisations, each holding the structure and the potential on the real-space FFT grid from PBE or PBE+U runs. MP's documentation lists about 158,000 objects and 2.5 TB. Planar-averaged LOCPOTs give work functions and band alignment of surfaces and slabs, and are the input for finite-size charged-defect corrections (Freysoldt, Kumagai) in point defect calculations. 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='locpots/', 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: `locpots/mp-2300954.json.gz`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/966b1e7b-6060-56b5-b603-1c52b82cd600
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/966b1e7b-6060-56b5-b603-1c52b82cd600
- Over MCP: `get_schema_card` with id `966b1e7b-6060-56b5-b603-1c52b82cd600` 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)
