wwPDB OneDep System

Frequently Asked Questions

Starting a deposition session

What information and files should I have on-hand to deposit?

The information needed for deposition is the same that is required for legacy deposition systems: Gather information about the proteins/nucleic acids in your structure from sequence databases (e.g., using UniProtKB or BLAST) and about ligands in your structure (using Ligand Expo). Instructions for depositing new ligands will be provided during deposition. Collect log file output from the programs that were used for data processing, scaling, MR, refinement, etc., and use pdb_extract to parse these files and gather sequence information for the contents of the sample.

What is the easiest way to deposit many related entries?

Deposit one entry, and then enter the deposition ID for that entry into the "Related depositions" field of the entry page when depositing any related entries. The new system will provide the option to automatically copy information (e.g., author contact information, release status, data collection information, protein name, source organism, sequence information) to the new deposition session.

How can I deposit a new entry based on a previously deposited entry?

Prior to the initial upload of coordinate and experimental data files, enter the Deposition ID (D_xxxxxxxxxx) and password of a previous submission on the File Upload page. Then select the data categories to be copied from the previous submission. Please note that once you have uploaded files and pressed the "populate" button, you will no longer have the option of selecting data from a previous submission. After this point, a new deposition session would need to be started to import information from a previous submission.

I forgot my password. How do I retrieve my password?

In order to retrieve your password, please click the "Forgot Password" button located on the left-hand panel ("Existing Deposition") of the deposition page. You will be prompted for your Deposition ID and e-mail address. When you have provided this information, your password will be e-mailed to you. In order to maintain security and confidentiality of the on-hold submissions, passwords are only sent to those email addresses that were added to the contact information at the time of deposition. The email address needs to be an exact match of what is currently present in the deposition i.e. email aliases will be treated as a different email address and hence you won't receive the password.

I did not receive an email containing my password after attempting to retrieve my password. Why might this have happened?

There are several possible reasons: (1) There was a typo in the email address or/and deposition ID that were provided; (2) the email address provided for password retrieval is not associated with the deposition session; (3) the email was filtered into the spam folder. Deposition-related email messages are sent from noreply@mail.wwpdb.org; you may need to adjust your mail settings so that this address is not filtered.

Can I reset or change my password?

At this time, deposition session passwords cannot be reset or changed. We will implement this feature in our future updates.

How do I add an author to an entry or citation author list?

Click the "+" button next to the author name after which the new author name is to be placed. This will add a new blank form for new author's name. To reorder the author list, drag the up/down arrow icons. Choose the trashcan icon to remove a name from the list.

How long will my deposition session be saved?

Un-submitted sessions will expire 3 months after last login. Un-submitted sessions and uploaded files will be removed once they expire.

Where can I designate my deposition for structure prediction competition?

At "Release Status" page, set "Y" to designate your deposition for prediction target, then select a proper development method such as CASP for the prediction if it has sequence identity to available structures below 50% or you expect it to be interesting for prediction otherwise.

Experimental methods

How do I submit hybrid method structures?

At the start of deposition, you will be asked to provide information about the experimental methods employed to determine the structure. Multiple experimental methods may be selected. For example, select both X-ray diffraction and neutron diffraction if the X-ray/neutron hybrid method was used.

All relevant accession codes will be assigned when the deposition is submitted. For example, a structure determined using a combination of X-ray diffraction and solution NMR will be assigned both PDB accession codes and BMRB accession codes upon submission.

As a deposition session proceeds, depositors will be asked to provide experimental details such as data collection and refinement information for each experimental method.

I can't find a software name in the pull-down list for data processing. How do I add information about software used for data processing?

Use the Communication page to submit the missing information. An annotator will instruct you how to proceed with your deposition and will add the software information to the list during entry processing.

File Formats

How do I collect the data from the refinement program log file necessary to generate a complete PDBx/mmCIF format file?

Pdb_extract can be used to harvest data from your fully refined coordinate file, experimental data file (e.g., structure factor file), refinement program log file, and author information template file (if available). Pdb_extract can produce fully populated coordinate and experimental data files in PDBx/mmCIF format that can then be used for validation or deposition.

How do I convert PDB format file into PDBx format file?

In the new deposition system, files uploaded in PDB format will be automatically converted to PDBx/mmCIF format. The uploaded PDB and converted PDBx/mmCIF format files will be available via the "Download files" link at the bottom of the left hand panel.

Alternatively, if you want to convert your PDB format file to PDBx format prior to deposition, you may use pdb_extract to convert and prepare the files for deposition.

How can I upload a file in PDB format?

Please make sure that an uploaded PDB format file meets the following requirements:

a) There must be a complete TER record after the end of each polymeric chain

ATOM   2705  CB  HIS A 337      -2.421  -9.493  35.428  1.00 30.90           C
ATOM   2707  N   ALA B   3      14.064   2.135  20.580  1.00 15.71           N

b) All the ligands/compounds present in your PDB coordinate file must have a HETATM at the start of the atom coordinate line

HETATM 1574  C1  GOL A 104      -1.268 -20.812  15.070  0.75 21.78           C

How do I convert my structure factor file to mmCIF format?

SF-tool can be used to convert your structure factor file to mmCIF format.

Can I submit an entry that has more than 99,999 ATOM lines and/or more than 62 chains (and is therefore incompatible with the PDB format)?

Large entries (>99,999 atoms and/or >62 chains) should be deposited in the PDBx/mmCIF format. A PDBx/mmCIF preparation guide is available.

For large structures generated using exact symmetry operations (e.g., strict helical, point, or non-crystallographic symmetry (NCS)), authors should deposit only those chains that were fitted and/or refined and supply a PDB file containing the operators (matrix transformations) that can be used to generate the complete assembly.

File Upload

There were problems with the file I uploaded. Where can I see a list of those problems?

Errors encountered upon file upload will be presented in two places: (1) on the diagnostic screen (headed by a graphic of pair of red gears) that appears after the "Populate" or "Repopulate" button on the file upload page is pressed, and (2) on the Upload Summary page of the deposition interface.

Why did my file upload fail?

View error messages at the "Upload Summary" page.

Error message #1: "File is not readable"

This error message can be found in the "File header check" column of the "Upload file summary" box on the "Upload Summary" page (pages are selected using the left menu in the Deposition Tool).

If the error message is "File is not readable," return to the "Replacement Upload" page. In the file list at the bottom of the page, make sure that both of the following are true:

  • Only one coordinate file is selected (check or uncheck the boxes on the left)
  • Each uploaded file has the correct file type selected

After you have done this, press the green "Repopulate deposition sections selected" button located below the file list. Please note that if you have not already done so, you will need to select your merging preference from the "Merging options" menu at the top of the page.

Error message #2: "File conversion failed"

This error message can be found in the "File header check" column of the "Upload file summary" box on the "Upload Summary" page (pages are selected using the left menu in the Deposition Tool).

File conversion failure is often the result of format errors in the uploaded file. Common errors include missing TER cards in PDB format files and cif items in PDBx/mmCIF files that do not conform to standard formatting.

Format errors will be listed in the "Upload model contents check" section on the "Upload Summary" page. Check the error list, correct your file accordingly, and re-upload the file on the "Replacement Upload" page. Be sure that your merging preference is selected in the "Merging options" menu at the top of the "Replacement Upload" page when you do so.

I am trying to upload a file, but am having a problem I cannot resolve. How do I communicate with PDB staff?

Request help from a wwPDB annotator using the Communication page within the deposition interface. Provide any details you can, and an annotator will examine your session and provide feedback via the Communication page. Please note that when you have received communication, a notification message will be sent to all contact authors whose contact information is associated with the deposition session.

Chemical Components (ligands)

How do I provide information for a new chemical component (ligand)?

The deposition interface searches the Chemical Component Dictionary (CCD) for matches between submitted ligands and the contents of the dictionary. Summary information will be displayed for any chemical components (ligands) detected in the uploaded file. Authors should review this information and note any missing data.

If no CCD match is available, authors must provide complete chemical information by uploading or sketching a 2D chemical drawing using the deposition tool, or providing the appropriate SMILES string or InCHI key.

Where can I upload a ligand image or ligand definition file prior to entry submission?

Ligand verification page will display the message "Address mismatched instances of" for ligands without matches in the CCD. After confirming the ligand type, please provide a ligand image (required) and/or a ligand definition file (optional).

Where can I upload a ligand image or ligand definition file after submission?

After an entry has been submitted for annotation, you can request that the session is unlocked using the Communication page. In your request, please inform the annotation staff that you wish to upload a ligand image or ligand definition file. Once the session has been unlocked, upload the file on the "Replacement Upload" page, select the proper file type, e.g., ligand image, and then click the "Submit" button. For a ligand definition file, you should choose "structure definition file" as the file type.

I already provided mandatory ligand information, but the interface still indicates that a ligand mismatch requires attention. What do I do?

Return to the instance-level verification page (click the "Inspect Selected Ligands" button on the ligand summary page) and make sure that the "Save" button near the bottom of the page has been clicked. When this button is clicked, it should change from a "Save" button to an "Undo" button and all mismatched instances of the ligand should switch from a yellow header to a light blue header that reads "Mismatch(es) now addressed." Make sure that all the ligands that require attention have been addressed by visiting all of the available tabs (one ligand type per tab). You will need to press the "Finish (all issues addressed)" button after you have pressed the "Save" button. If there are any additional problems, you can use the Communication page to contact the wwPDB annotation staff for assistance.

Sequence Information

How do I provide a polymer sequence containing non-standard or modified residues?

When providing a protein or nucleic acid sequence, depositors should provide the full sequence that was present in the experimental sample. This sequence should contain any expression tags or other unobserved regions that were not modeled in the final coordinate file.

For polypeptide chains containing standard amino acids, please provide the sample sequence using one-letter codes for all standard amino acid residues present in the polymer chain (e.g., Y for tyrosine).

Similarly, for nucleic acid chains, provide the one letter codes for standard nucleotides present in the polymer chain (e.g., U for uracil). Please refer to the list of standard amino acid and nucleic acid one-letter codes.

If the polymer chain contains non-standard amino acids or nucleotides, please provide the three-letter code of the residue as it appears in your coordinate file in parentheses. For instance, use "(MSE)" in the sample sequence if it contains selenomethionine.

Example of a sample sequence containing modified residue:

I have two (or more) copies of the same protein in the coordinates, but the deposition interface displays two (or more) macromolecules. How do I correct the number of unique polymers and/or chain IDs on the Macromolecules pages?

If sample sequences were not provided in the uploaded coordinate file, the deposition system automatically generates unique polymer entities based on sequences extracted directly from the coordinates themselves. As different instances of the same polymer might have different subsets of their sequences modeled, multiple entities might be generated for a single polymer.

To associate these entities (each of which will have a different page under the "Macromolecules" header) so that they can be identified as the same polymer during processing, go to the page for one of the polymer entities, e.g., "Molecule 1." Provide any information available for the polymer, including molecule type, provenance, and source (and host, if applicable) information. Most importantly, provide the full polymer sequence that was used for the experiment. This sequence should include any expression tags and any residues that were present but may not have been modeled in the coordinates.

Then, on each page under the "Macromolecules" header for a polymer entity that is the same polymer as the one just identified, you can enter the molecule number at the top of the page and click the "Copy every field from Molecule" button to copy all of the entered information from that entity, including the sequence.

During the annotation process, identical polymers identified in this manner will be consolidated from multiple entities into a single entity encompassing multiple chains. No further action on the part of the depositor should be necessary.

An example:

An X-ray crystal structure of lysozyme is deposited. There are two molecules of lysozyme modeled in the asymmetric unit in the coordinates. Because of poor electron density, a loop that is modeled in the first molecule is not modeled in the second molecule. The uploaded coordinate file did not happen to contain the sequence of the experimental lysozyme construct that was crystallized, so the deposition system extracts the sequences from the coordinates. Because of the un-modeled loop in the second molecule, different sequences are extracted for the two molecules and they are identified as different polymer entities, Molecule 1 and Molecule 2, in the Macromolecules section.

On the Molecule 1 page, the depositor provides all of the required information for the polymer including the experimental sequence, which includes not only the problematic loop, but also some N-terminal residues present in the sequence that were not modeled in either instance of the polymer. The depositor then moves to the Molecule 2 page. He or she enters "1" in the box at the top of the page and clicks the "Copy every field from Molecule" button.

The depositor has now done what is necessary. During annotation, Molecule 1 and Molecule 2 will be consolidated into a Molecule 1 that includes both molecules of lysozyme.

Where can I provide details about a polymer or sequence?

Each unique macromolecule in a submission will have its own page under the Macromolecules header in the left-side menu. Any particular details regarding the nature or sequence of the macromolecule that do not fit in any of the other available data fields can be included in the "Compound details" box located under the sequence alignment.

I got a mismatch error during sequence alignment. How I do fix this problem?

To correct a mismatch error in the sequence alignment, it is necessary to determine whether the error is in the provided sequence or in the uploaded coordinate file. If the error is in the sequence, then the corrected sequence can be entered in the appropriate field and the alignment refreshed. If the error is in the uploaded coordinate file, a corrected coordinate file must be uploaded on the Replacement Upload page.

Finishing a Deposition Session

How will I know when all mandatory data have been submitted?

The progress bar in the upper left-hand corner of the deposition interface tracks mandatory data items. Click on the progress bar at any time to view any missing mandatory data items.

Once all mandatory data items have been provided, the progress bar will become the Submit button.

When a deposition is complete and the Submit button is clicked, PDB/EMDB/BMRB accession code(s) will be issued and the entry will be submitted for wwPDB annotation and processing.

I have already provided complete contact author information for the PI and corresponding author, but the navigation panel still indicates that the data on the page are still incomplete. Why?

By default, the deposition system provides extra blanks for additional contact author information. If there are no additional contact authors, select "N" as the answer to the question "Are there other authors you wish to add?" This will remove the extra blanks and complete the page, providing principal investigator and corresponding author information has been properly filled in.

All of the indicators on the navigation panel are green and the "Submit" button is available, but when I click the "Submit" button, it tells me that I have not clicked on the validation report. Why?

The deposition interface requires that the wwPDB validation report be downloaded before a deposition session can be completed. You are expected to read the validation report and correct any obvious errors before submission. When the report has been generated, you will receive an email notification. You can then return to the Validation Reports page within the deposition interface and click on the link for the PDF validation report. After the report has been downloaded and accepted, you will be permitted to complete the deposition process.

Replacing Data

How do I replace an uploaded file?

An uploaded file can be replaced either pre-submission (before a four-character PDB accession code has been issued for the deposition) or post-submission (after a PDB accession code has been issued and the entry is either being processed or has been processed by PDB annotation staff).

Pre-submission replacement of an uploaded file:

Coordinate files can be replaced at any time prior to submission using the "Replacement Upload" page. Upload the new coordinate file and specify its data type. Be sure to select the new coordinate file within the list and deselect any previously uploaded coordinate files. Choose your desired merging option from the list at the top of the page and press the "Re-populate" button at the bottom of the page to initiate the upload and incorporation of the new coordinate file.

If you encounter any error messages, please check the "Upload Summary" page and read the answer to the question "Why did my file upload fail?" in this FAQ if necessary.

Post-submission replacement of an uploaded file:

After a submission has been completed, most of your deposition session (including the Replacement Upload page) will be locked. To upload a new coordinate file, go to the Communication page within the deposition interface. There you can send a request to a wwPDB annotator to unlock the deposition session. After you have received a message from an annotator confirming that the session has been unlocked, you will be able to upload the new file. After you have uploaded the new file and selected the correct file type, be sure to click the "Submit" button to complete the submission.

I want to replace only a coordinate file, but the available replacement options involve replacing both the coordinate and structure factor files. How can I replace only the coordinates?

If a new experimental data file (e.g., structure factor file) has not been uploaded, the system will simply read the previously provided experimental data file that is selected in the list at the bottom of the Replacement Upload page.

When I replaced a coordinate file, I got an error message saying "The model coordinate merge process was aborted due to change in number of polymer chains. Please try it again by selecting reset all data option." But my coordinate file contains the same protein structure as before and the only changes I made were to the XYZ coordinates and to the refinement statistics.

The deposition system tries to group polymer chains with equivalent sequences into one molecule type. What has likely happened is that the coordinates have changed relative to the previously uploaded coordinates such that two or more previously identical polymer sequences (as extracted from your model) are now different. In this case, if there is no error in the uploaded file, you will need to reset the information currently in place (the "Replace coordinates AND replace experimental data AND reset all input values at the User Interface" merge option) to complete the re-upload.

I just submitted my deposition. How do I make further changes to it?

To make changes to a deposition session after it has been submitted, use the Communication page to contact the wwPDB annotation staff and let them know what you would like to make changes. Depending on the nature of the corrections, a wwPDB annotator will either unlock the deposition interface so that you can make the corrections, or incorporate your corrections for you during annotation.

An annotator unlocked my deposition session, but some parts of my session that I need to correct are still locked. What do I do?

Some parts of a deposition session remain locked even when the rest of the session has been unlocked. If you need to make a change or correction to one of these locked values, please use the Communication page to inform wwPDB annotation staff of the change you wish to make and an annotator will incorporate it for you.


How do I get help during and after deposition?

If you have any questions about deposition, you can log in to your deposition session and use the Communication page to communicate with wwPDB annotation staff. The Communication page is available toward the bottom of the left menu in the Deposition Tool.

How can I provide feedback about the system in general?

We welcome your feedback on the Deposition System and on the information provided in the FAQ. Use "Communication" web form at deposition interface to let us know if the available instructions need clarification or if you have encountered any problems during deposition.