Atomic Level of Detail and Data Precision

C-alpha atoms only for polypeptides P-backbone atoms only for polynucleotides All atom representation for all other residue types 0.1Å coordinate precision, 0.1 B-factor and occupancy precision.

The reduced representation is up to a factor of 10 smaller than the full representation. It is useful for the efficient visualization of ribbon diagrams or for calculations that only use C-alpha atoms.

Versioning

The version number is embedded in the base URLshttps://mmtf.rcsb.org/v{version}

For example, https://mmtf.rcsb.org/v1.0 points to API version v1.0.*.
Minor versions will be backward compatibile. For changes in the major version number you need to update your code to point to the new version of the API.

The current major version of the API is v1

RESTful Services

The RESTful service returns a response as a MessagePack container with MMTF data.

For example to access the PDB structure 4HHB in the all atom (full) representation use: https://mmtf.rcsb.org/v1.0/full/4HHB

Download

MMTF Files

Individual MMTF files can be downloaded in gzipped format with command line utilties such as wget or curl:

$ wget https://mmtf.rcsb.org/v1.0/full/4HHB.mmtf.gz

or

$ curl -O https://mmtf.rcsb.org/v1.0/full/4HHB.mmtf.gz

Hadoop Sequence File

Downloading and processing many individual files is inefficient. For large scale calculations with distributed parallel frameworks such as
Apache Hadoop or
Apache Spark
we recommend the use of Hadoop Sequence Files.
The entire PDB archive can be downloaded in the full and reduced representations:

https://mmtf.rcsb.org/v1.0/hadoopfiles/full.tar and https://mmtf.rcsb.org/v1.0/hadoopfiles/reduced.tar