How To Use ConSurf Colab
with FirstGlance in Jmol, April, 2026.

Overview:

Step By Step:
  1. Since Colabs are a free service operated by Google, you must be logged in to a Google account in order to use ConSurf Colab. You can get a free Google account at accounts.google.com.

  2. Once you submit your job, don't close the browser tab/window, or you will likely lose your job and need to start over.

  3. Familiarize yourself with the protein structure of interest by exploring it in FirstGlance in Jmol. In particular, note the single character ID of the protein chain whose evolutionary conservation you wish to visualize. (If more than one chain of different sequences, you will need to run a separate ConSurf job for each.)

  4. At ConSurf Colab, enter a title for your job (1) and be sure to set the mode to "PDB" (2).
  5. Run the Colab by clicking on the triangle (3). It may take 5-10 minutes for Colab to initialize the first time you run it. Additional runs started a short time after completion of the first run will not have this delay, but runs started hours later will have the delay. After all the ConSurf Colab code is initialized, you complete the following easy form for PDB ID codes. (If you have an unpublished model, such as an AlphaFold predicted structure, see step 6 below.)



  6. If you have an AlphaFold-predicted model or other unpublished model, you can upload it to ConSurf Colab. You can upload either .pdb or .cif files. (Version 4.7 of FirstGlance can process AlphaFold .cif files, but NOT .cif files from the wwPDB.)



  7. When the job is completed, colored ribbon cartoons of your molecule will appear. You may need to scroll down to see them, so try scrolling down periodically. Below the colored images, click the Download link a to download the PDB file for use in FirstGlance. It is also wise to download the zip b that contains all files created by the job.

  8. Additional jobs: Now you can start a new job. If you do this shortly after completion of your first job of the day, you will not need to wait for all the code to load again. Sometimes, the slot for answering a question does not appear. If that happens, reload the page and the slot will appear.







  9. Insufficient Data:
    ConSurf is uniquely powerful in indicating when the multiple protein sequence alignment does not have sufficient information to calculate a meaningful conservation value for a given amino acid. When the confidence interval for the conservation score is excessive, the calculated conservation score for that residue is meaningless, and it is given conservation grade 10: insufficient data. This is obviously important to know. The only acceptable reason for hiding which amino acids have insufficient information would be if they are few, and not relevant to the point being made. "Hiding" means that the meaningless conservation grades for those amino acids will be shown. This can be accomplished by downloading a separate ConSurf result PDB or CIF file that omits insufficient data grades. When hidden, that fact must be disclosed.

    Conservation grades assigned by ConSurf are integers from 1 (highly variable) to 9 (highly conserved), with 10 (or 0) indicating insufficient data. The original ConSurf color scheme is below. Two alternative color schemes are also offered by FirstGlance when viewing ConSurf Colab results.


  10. Visualization of Conservation: Drag your downloaded ConSurf-Colab PDB file and drop it onto the Front Door to FirstGlance in Jmol. The protein chain processed by ConSurf will be automatically colored with the above scheme. You can color by evolutionary conservation all salt bridges, non-covalent contacts to any ligand or moiety that you specify, amino acids covalently linked to sugar glycosides, cysteines in disulfide bonds, amino acids forming crosslinks between chains, etc. Instructions and demonstrations:
  11. Examples:
    The following links display ConSurf Colab-processed PDB files in FirstGlance:


Feedback to