01
Where it fits and where it does not
Use these four checks before committing implementation time.
- Use it when
- Deposition, validation, exchange, parsing, and reuse of experimentally determined macromolecular structures across wwPDB and structural-biology toolchains.
- Limits
- The living dictionary is large and revisions can affect parsers, extensions, and optional categories. Syntactic conformance does not establish model quality, biological relevance, or comparability.
- Best for
- Structural biology and Discovery and Omics teams working across Acquire → Harmonize → Exchange → Learn + reuse.
- Maturity
- EstablishedSuitable for production assessment. Pin the exact release and any implementation profile.
02
See it in the workflow
This view shows the input, the change the standard introduces, and the resulting output.
- InputWhat starts
Structural biology and Discovery and Omics source data, metadata, and local mappings
- PDBx/mmCIFWhat changes
Use PDBx/mmCIF as a pinned data model / schema across Acquire → Harmonize → Exchange → Learn + reuse
- OutputWhat becomes possible
A handoff the next system or team can validate against the same release
03
A concrete example
A structural pipeline writes files against dictionary revision 5.415, validates categories and identifiers, preserves experimental and software provenance, and retains the wwPDB accession and validation evidence.
Why it matters: Provides typed atom-level structures and experimental context for feature generation, while structure quality, redundancy, biological assemblies, label construction, and train-test separation need independent controls.
04
What it fits with
The PDB archive uses the PDBx/mmCIF exchange dictionary; companion wwPDB dictionaries cover chemical components and validation reports, while specialized extensions address additional structure-data use cases.
- Metadata profileExpmeta
Both support Omics and Discovery work and meet around Acquire, Harmonize, Exchange, Learn + reuse. Compare their roles before treating them as interchangeable.
Explore relationship - StandardSAM/BAM · CRAM · VCF/BCF
Both support Omics work and meet around Acquire, Harmonize, Exchange, Learn + reuse. Compare their roles before treating them as interchangeable.
Explore relationship - Metadata profileSDRF-Proteomics
Both support Omics work and meet around Acquire, Harmonize, Exchange, Learn + reuse. Compare their roles before treating them as interchangeable.
Explore relationship - Metadata vocabularyDPV
Both support Omics work and meet around Acquire, Harmonize, Exchange, Learn + reuse. Compare their roles before treating them as interchangeable.
Explore relationship
05
Implementation starter
Start with one bounded handoff. Pin, test, and review it before scaling.
Define one handoff, its accountable owner, and the decision PDBx/mmCIF must support.
Pin the exact version and companion artifacts: PDB Exchange Dictionary 5.415 · 2026-06-03.
Map one representative input to the required data model / schema artifacts.
Test the result against the canonical source and record every exception.
Preserve the source data, mappings, and review evidence before scaling.
06
Test the main limitation
The living dictionary is large and revisions can affect parsers, extensions, and optional categories. Syntactic conformance does not establish model quality, biological relevance, or comparability.
Run one representative end-to-end pilot and record exactly where PDBx/mmCIF loses context, needs an extension, or depends on another standard.
Machine-readable output may still be unfit for analysis or ML.
Test the output for missing context, provenance, terminology alignment, time leakage, and the intended downstream decision. Provides typed atom-level structures and experimental context for feature generation, while structure quality, redundancy, biological assemblies, label construction, and train-test separation need independent controls.
07
Official resources
Specifications, diagrams, examples, and guides from the organizations that maintain them.
Current wwPDB PDBx/mmCIF dictionary
Official publisher or steward guidance for this data model / schema profile.
- Publisher
- Worldwide Protein Data Bank