Documentation
Summary
- EMDB data model
- EMDB header data model
- EMDB segmentation data model
- Policies
- Search engine
- Chart builder
- FAQ
- Deposition
EMDB map data model
The EM Data Bank (EMDB) accepts and distributes 3D map volumes derived from several types of EM reconstruction methods, including single particle averaging, helical averaging, 2D crystallography, and tomography. Since its inception in 2002, the EMDB map distribution format has followed CCP4 definition (CCP4 map format) , which is widely recognized by software packages used by the structural biology community. CCP4 map format is closely related to the MRC map format used in the 3DEM community (MRC map format); CCP4 is slightly more restrictive, in that voxel positions are limited to a grid that includes the Cartesian coordinate origin (0,0,0). Further details can be found here.
EMDB header data model
Every EMDB entry has a header file containing meta data (e.g., sample, detector, microscope, image processing) describing the experiment. The header file is an XML file and the structure and content of the header file is described by a XSD data model. With a highly dynamic field such as cryo-EM there is a constant need to adapt and modify the schema to keep it up-to-date with the most recent developments. We consult extensively with the EM community regarding such issues and version the schema according to the policy described here.
Data model version 1.9
This has been a long-term stable version of the data model. It was be replaced in 2018 with an updated model but XML header files in version 1.9 continues to be distributed in parallel for at least one year to give EMDB users ample time to switch. It should be noted that the generation of the version 1.9 header files will be on a best effort basis but involves a back translation from recent versions that are richer in content and will therefore not contain all the information that can be found in the more recent versions.
Download schema
Browse schema documentation
Download Python code to facilitate reading and writing XML version 1.9 header files
Data model version 3.0 (current model)
This data model replaced version 1.9, however header files corresponding to both data models will be distributed in parallel with the view of stopping the distribution of the version 1.9 files in 2019 once users have had a chance to adopt version 3.0.
This version adds a number of features including:
- An improved description of direct electron detectors, specimen preparation and tomography experiments.
- A hierarchal description of the overall sample composition in combination with a low-level description of the macromolecular composition to allow the description of both molecular and cellular samples.
- Specific data items describing the half-maps and segmentations included with the entry.
Download schema
Browse schema documentation
Download Python code to facilitate reading and writing XML version 1.9 header files
EMDB segmentation data model
Segmentation is the decomposition of 3D volumes into regions that can be associated with defined objects. Following several consultations with the EM community (Patwardhan et al., 2012; Patwardhan et al., 2014; Patwardhan et al., 2017), the EMDB is in the process of developing tools to support deposition of volume segmentations with structured biological annotation which is here defined as the association of data with identifiers (e.g., accession codes from UniProt) and ontologies taken from well established bioinformatics resources. To our knowledge, none of the segmentation formats widely used in electron microscopy and related fields currently support structured biological annotation. Third party use of segmentations is further impeded by the prevalence of segmentation file formats and their lack of interoperability. EMDB therefore proposed an open segmentation file format called EMDB-SFF to capture basic segmentation data from application-specific segmentation file formats and provide the means for structured biological annotation. In this way, EMDB-SFF will not only enable depositions of segmentations but also act as a file interchange format between different applications and facilitate analysis of 3D reconstructions. Furthermore EMDB-SFF supports the description of multiple transforms for a segment, thus allowing a segment to be used to describe the placement of a sub-tomogram average onto a tomographic reconstruction.
Model
EMDB-SFF files have the follow features:
- Segmentation metadata:
- name
- version (of schema)
- details (free-form text)
- global external references, e.g. specimen scientific identifier
- bounding box
- primary descriptor contained i.e. one of ‘three_d_volume’, ‘mesh_list’, or ‘shape_primitive_list’ (see schema documentation)
- list of software used to create the segmentation (name, version, processing details)
- list of transforms referenced by segments e.g. transform to place the sub-tomogram average in the tomogram
- Hierarchical ordering of segments through the use of segment IDs and parent IDs;
- Four geometrical representations of segments (volumes, contours, meshes, shapes);
- Can store subtomogram averages and how they map into the parent tomogram through the use of transforms;
- List of associated external references per segment;
- List of associated complexes and macromolecules in a related EMDB entry
Each segment in a segmentation can consist of two types of descriptors:
- textual descriptors;
- geometric descriptors.
Textual descriptors consist of either free-form text or standardised terms. Standard terms should be provided from a [published] ontology or list of identifiers.
Geometric descriptors can take one or more of the following representations:
- ‘three_d_volume’ for 3D volumes;
- ‘mesh_list’ for lists of meshes each of which consists of a set of vertices and polygons;
- lists of shape primitives (ellipsoid, cuboid, cone, cylinder).
Documentation
Download
The current schema (version 0.8.0.dev1) is available here.
Documentation
Complete documentation of the schema is available here.
Auxiliary Tools
sfftk-rw
sfftk-rw is a Python toolkit for reading and writing EMDB-SFF files only. It is part of a family of tools designed to work with EMDB-SFF files.
sfftk-rw has the following utilities:
- convert - interconvert between XML, HDF5 and JSON file formats of the EMDB-SFF data model;
- view - view a file summary
The full documentation is available at readthedocs.
Download
The latest version runs only on Python 3 (version 0.7.1) and may be installed using pip install sfftk-rw
. Alternatively, feel free to obtain the source code from Github.
sfftk
sfftk provides a shell command and a Python API to process EMDB-SFF files.
The following utilities are available using sfftk:
- convert - Conversion of application-specific segmentation file formats to EMDB-SFF. Currently, sfftk supports the following formats:
- AmiraMesh (.am)
- Amira HyperSurface (.surf)
- Segger (.seg)
- EMDB Map masks (.map)
- Stereolithography (.stl)
- IMOD (.mod)
- notes - Annotation of EMDB-SFF files.
- view - Brief summaries of segmentation files.
Read the full documentation here.
Download
The latest development version (version 0.5.5.dev1) of sfftk may be downloaded/installed from PyPI or the source may be obtained from GitHub.
Publications
- Patwardhan, Ardan, Robert Brandt, Sarah J. Butcher, Lucy Collinson, David Gault, Kay Grünewald, Corey Hecksel et al. Building bridges between cellular and molecular structural biology. eLife 6 (2017).
- Patwardhan, Ardan, Alun Ashton, Robert Brandt, Sarah Butcher, Raffaella Carzaniga, Wah Chiu, Lucy Collinson et al. A 3D cellular context for the macromolecular world. Nature structural & molecular biology 21, no. 10 (2014): 841-845.
- Patwardhan, Ardan, José-Maria Carazo, Bridget Carragher, Richard Henderson, J. Bernard Heymann, Emma Hill, Grant J. Jensen et al. Data management challenges in three-dimensional EM. Nature structural & molecular biology 19, no. 12 (2012): 1203-1207.
Quick links
Recent Entries
(Show all)Cryo-EM reconstruction of the pseudo-helical symmetric tubular assembly of SBA/GN5GN at 32 nm diameter
Structure of Duffy Antigen Receptor for Chemokines (DARC)/ACKR1 in complex with the chemokine, CCL7 (Composite map)
Cryo-EM reconstruction of the pseudo-helical symmetric tubular assembly of SBA/GN5GN at 35 nm diameter
Cryo-EM structure of inward-open state human norepinephrine transporter NET bound with antidepressant desipramine in KCl condition.
Cryo-EM structure of CRISPR-Csm effector complex from Mycobacterium canettii
Structure of Duffy Antigen Receptor for Chemokines (DARC)/ACKR1 in complex with the chemokine, CCL7 (Receptor original map)
Structure of inactive Photosystem II associated with CAC antenna from Rhodomonas Salina
Activation mechanism and novel binding site of the BKCa channel activator CTIBD
Cryo-EM reconstruction of the helical symmetric tubular assembly of SBA/GN8GN at 33.5 nm diameter
Cryo-EM reconstruction of the pseudo-helical symmetric tubular assembly of SBA/GN8GN at 33.5 nm diameter
In situ intact PBS-PSII supercomplex from cyanobacterial Spirulina platensis
Structure determination of SBA/GN1GN tubular assembly at 18 nm diameter using cryo-EM
SARS-CoV-2 spike protein in complex with two S2H5 Fabs on NTD-1 and NTD-2
Structure determination of SBA/GN2GN tubular assembly using cryo-EM
SARS-CoV-2 spike protein in complex with two S2H5 Fabs on NTD-1 and NTD-3
Cryo-EM structure of human norepinephrine transporter NET in the presence of the antidepressant atomoxetine in an outward-open state at resolution of 3.4 angstrom.
the complex structure of the H4B6 Fab with the RBD of Omicron BA.5 S protein
Caenorhabditis elegans ACR-23 in betaine and monepantel bound state
Cryo-EM structure of Streptomyces coelicolor transcription initiation complex with the global transcription factor AfsR
Structure of the Bacteriophage PhiKZ non-virion RNA Polymerase bound to DNA and RNA
Human choline transporter-like protein 1 (hCTL1/SLC44A1) in peptidisc
Helical reconstruction of yeast eisosome protein Pil1 bound to membrane composed of lipid mixture +PIP2/+bromosterol (DOPC, DOPE, DOPS, bromo-ergosterol, PI(4,5)P2 35:20:20:15:10)
Structure of mammalian Pol II-DSIF-SPT6-PAF1-TFIIS-hexasome elongation complex
Rhinovirus A2 uncoating intermediate revealing the natural pocket factor (pH 5.8 and 4 degrees Celsius)
GluA2 flip Q in complex with TARPgamma2 at pH8, class1, structure of LBD-TMD-TARPgamma2
Rat GluN1-GluN2B NMDA receptor channel in complex with glycine, glutamate, and EU-1622-A, in nonactive1 conformation
Subtomogram average (C1) of fatty acid synthase from S.cerevisiae prepared using cryo-plasmaFIB milling
Cryo-EM structure of Thermococcus kodakarensis FttA-dependent transcription pre-termination complex containing 44 nt RNA
CryoEM structure of the TnsC(1-503)-TnsD(1-318)-DNA complex in a 7:2:1 stoichiometry from E. coli Tn7 bound to ATPgS and ADP
GluA2 flip Q in complex with TARPgamma2 at pH5, consensus structure of TMD-TARPgamma2
CryoEM structure of TnsC(1-503) bound to TnsD(1-318) from E.coli Tn7
Cryo-EM structure of PRC2 in complex with the long isoform of AEBP2
Cryo-EM structure of the HIV-1 JR-FL IDL Env trimer in complex with PGT122 Fab
Cryo-EM structure of the HIV-1 WITO IDL Env trimer in complex with PGT122 Fab
Cryo-EM structure of Thermococcus kodakarensis FttA-dependent transcription pre-termination complex containing 44 nt RNA
CRYO-EM STRUCTURE OF HIV-1 BG505DS-SOSIP.664 ENV TRIMER BOUND TO HERH-c.01 FAB
GluA2 flip Q in complex with TARPgamma2 at pH8, class12, structure of LBD-TMD-TARPgamma2
Cryo-EM structure of Thermococcus kodakarensis FttA-dependent transcription pre-termination complex containing 44 nt RNA (local refinement map)
CyoEM structure of the TnsC(1-503)-TnsD(1-318)-DNA complex in a 6:2:1 stoichiometry from E. coli Tn7 bound to ATPgS and ADP
CryoEM structure of the TnsC(1-503)-TnsD(1-318)-DNA complex in a 7:2:1 stoichiometry from E. coli Tn7
mGluR3 in the presence of the antagonist LY 341495 and positive allosteric modulator VU6023326
Rat GluN1-GluN2B NMDA receptor channel in complex with glycine, glutamate, and EU-1622-A, in open-channel conformation, C1 symmetry
GluA2 flip Q in complex with TARPgamma2 at pH5, consensus structure of LBD-TMD-TARPgamma2
Cryo-EM structure of the HIV-1 BG505 IDL Env trimer in complex with 3BNC117 and 10-1074 Fabs
mGluR3 in the presence of the antagonist LY 341495 and positive allosteric modulator VU6023326 class 2
metabotropic glutamate receptor subtype three bound to the antagonist LY 341495, class two
CRYO-EM STRUCTURE OF HIV-1 BG505DS-SOSIP.664 ENV TRIMER BOUND TO GPZ6-a.01 FAB
GluA2 flip Q in complex with TARPgamma2 at pH8, consensus structure of TMD-TARPgamma2
Cryo-EM structure of Thermococcus kodakarensis FttA-dependent transcription pre-termination complex containing 52 nt RNA
Cryo-EM structure of Thermococcus kodakarensis FttA-dependent transcription pre-termination complex containing 52 nt RNA (local refinement map)
KS-AT core of 6-deoxyerythronolide B synthase (DEBS) Module 3 crosslinked with its translocation ACP partner of Module 2
GluA2 flip Q in complex with TARPgamma2 at pH5, class23, structure of LBD-TMD-TARPgamma2
CryoEM structure of the TnsC(1-503)-TnsD(1-318)-DNA complex in a 6:2:1 stoichiometry from E. coli Tn7
GluA2 flip Q in complex with TARPgamma2 at pH8, class1, structure of NTD
GluA2 flip Q in complex with TARPgamma2 at pH8, consensus structure of LBD-TMD-TARPgamma2
Rat GluN1-GluN2B NMDA receptor channel in complex with glycine, glutamate, and EU-1622-A, in open-channel conformation
CryoEM structure of octamer assembly of Shedu nuclease domain from Bacillus cereus
GluA2 flip Q in complex with TARPgamma2 at pH8, class12, structure of NTD
Metabotropic glutamate receptor 3 class 3 bound to antagonist LY 341495
Cryo-EM structure of Thermococcus kodakarensis FttA-dependent transcription pre-termination complex containing 52 nt RNA
Structure of Duffy Antigen Receptor for Chemokines (DARC)/ACKR1 in complex with the chemokine, CCL7 (Ligand/CCL7 focused map)
Structure determination of SBA/GN1GN tubular assembly at 14 nm diameter using cryo-EM
Structure determination of SBA/GN1GN tubular assembly at 16 nm diameter using cryo-EM
Cryo-EM structure of CDCA7 bound to nucleosome including hemimethylated CpG site in Widom601 positioning sequence.
Cryo-EM reconstruction of the helical symmetric tubular assembly of SBA/GN5GN at 32 nm diameter
Cryo-EM structure of inward-open state human norepinephrine transporter NET bound with norepinephrine in nanodisc.
Cryo-EM reconstruction of the pseudo-helical symmetric tubular assembly of SBA/GN8GN at 36.5 nm diameter
In situ PBS-PSII supercomplex from cyanobacterial Spirulina platensis
Cryo-EM reconstruction of the helical symmetric tubular assembly of SBA/GN8GN at 36.5 nm diameter