# Crystallography Open Database (COD) Full Snapshot with CIF Text, Parquet

## Facts

- Provider: Crystallography Open Database (Grazulis et al.); snapshot by LMucko
- License: CC0-1.0 (https://www.crystallography.net/cod/)
- Size: 3 files
- Format: Parquet (in sampled files)
- Stored at: Hugging Face, https://huggingface.co/datasets/LMucko/crystallography-open-database
- Access: public, readable without an account
- Category: Chemistry & Materials
- Source: https://doi.org/10.1107/S0021889809016690
- Page: https://scigantic.com/archive/a620f028-ecb2-51fa-9e53-ac0378fa0d52
- Keywords: Chemistry & Materials, Parquet, Hugging Face

## About

A complete snapshot of the Crystallography Open Database (COD), the open-access collection of experimentally determined crystal structures of organic, inorganic, metal-organic compounds and minerals, taken on 2026-07-06. The single file cod_full.parquet (zstd, about 30 GB, measured 2026-11-15) has 533,486 rows (on-hold entries excluded), one per COD entry, with 74 COD metadata columns and the raw CIF text in a cif_text column. Metadata cover unit cell parameters and their uncertainties, cell volume, measurement temperature and pressure, space group in Hermann-Mauguin and Hall notation and number, Z and Z', chemical, mineral and common names, sum and cell formulas, determination method, radiation and wavelength, and the bibliographic source (authors, title, journal, year, DOI). Query with DuckDB, polars or pandas and parse cif_text with pymatgen, ASE or gemmi. Used for crystal structure search, simulated powder XRD, structure-property datasets and training crystal generative and language models. All COD data are dedicated to the public domain under CC0; acknowledge the original authors of each structure and cite Grazulis et al., J. Appl. Cryst. 2009 and Nucleic Acids Res. 2012.

## Load the data

```python
from datasets import load_dataset
ds = load_dataset("LMucko/crystallography-open-database")
print(ds)
```

## Data structure

File types in sampled files: Parquet

Example file: `cod_full.parquet`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/a620f028-ecb2-51fa-9e53-ac0378fa0d52
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/a620f028-ecb2-51fa-9e53-ac0378fa0d52
- Over MCP: `get_schema_card` with id `a620f028-ecb2-51fa-9e53-ac0378fa0d52` at https://api.scigantic.com/mcp

## Related topics

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