User:Karsten Theis/AI tutorial
From Proteopedia
This is a tutorial for AI how to help with making 3D figures in Jmol. If it helps humans too, so much the better.
|
Contents |
My take on high-quality figures
This is paraphrased from Image:Proteopedia rubrics.pdf.
A 3D figure should be content-rich, visually clear, fun to explore, and understandable. If it is part of a series of figures, they should work together well.
- Content-rich: If you can, tell a complete story in a single figure rather than having to click through multiple figures. Journal articles sometimes limit the number of figures to as low as 5, and so they are information-packed.
- Visually clear: There should be a clear sense of what the focus of the figure is (the foreground), and how this focal point connects to the whole (the background). There are multiple aspects that can help achieve a clear image (choice of initial zoom level, color, of representation, slabbing and fogging, line widths, initial orientation and center of rotation)
- Fun to explore: The viewer should be invited to rotate the figure and to zoom in and out. Interactive elements (hiding and displaying structural features, buttons to get back to the original view or to other standard views, animation, morphs) can guide this exploration, as well as reminders about Proteopedia's and Jmol's built-in features (measure distances and angles, invitation to view in stereo, pop-out the image to maximize viewing area).
- Understandable: The viewer should be able to understand the visual elements (color coding, which representation for what) and the source of the data (PDB ID, typically) through the caption, legends on the viewing window, permanent and hover labels, and the text around the green link.
Annotated scripts
Here are some scripts. If you click on the title, you can see the resulting figure in the Jmol window above.
Detailed views
These have a focal point which should be centered and visible in the foreground. The focal point could be a ligand, an (empty) ligand binding site, an interface (e.g. dimer interface), a single interaction (e.g. disulfide bridge), or a single molecule. The background could be the entire remainder of the structure, or carefully selected parts of it, or blank (e.g. for a single molecule).
Typically, the foreground is shown at the detail of single atoms (represented by wireframe, spacefill, both "ball-and-stick", surfaces), and it is the center of rotation. Often, the background is shown with thinner lines, uniform color, or not showing single atoms but groups (represented by backbone, cartoon, meshribbon, ribbon, strand, trace, or surface). If the viewer is encouraged to rotate 360 degrees, the background should not interfere with seeing the foreground (use thin lines, slabbing, fading/fogging "zshade"). Transparency should be used with caution in Jmol because it can add visual clutter (spacefill and thick wireframe as well as cartoons add clutter, strands of constant thickness work well).
The initial scene: Chymotrypsin active site
load =7GCH # Chymotrypsin with covalently bound inhibitor
restrict none # clean slate
define ~focal 57, 102, 195, LPF # foreground: catalytic triad and inhibitor
select LPF.C2 or 195.CB; bondOrder single; # ensure covalent bond
select ~focal; Spacefill 25%; wireframe 0.36 # ball-and-stick for foreground
center selected; zoom 300; #
select LPF.CP1, LPF.CP2, LPF.CP3, LPF.CP4, LPF.CP5, LPF.CP6; # aromatic ring of inhibitor
color atoms opaque [xda70d6]; # magenta
select LPF and not selected; color atoms opaque [xe6e6fa]; # rest of inhibitor: lavender???
select not ~focal; color chain; # default chain colors (pastel tones)
select protein and not ~focal; Spacefill 100%; # background as spacefill
select 57.CD2, 102.OD1, 195.CB; label "%n %r"; # labelled atoms
color label [x000000]; font label 13 SansSerif Bold; # white labels, chose font
select 57.CD2; set labelOffset -4 4; # each label has a different offset
select 102.OD1; set labelOffset 1 1; #
select 195.CB; set labelOffset 0 -1; #
background black; set zshade on # the background is almost not visible affects zshade
moveto 0.0 { -97 855 -510 89.56} 300.0 0.0 0.0 {38.343720000000005 74.45217999999998 85.45410000000003} 34.78371098010064 {0 0 0} 0 0 0 3.0 0.0 0.0;
load files "=3H54" "=3LX9" # load 2 files, they are selected as 1.1 and 2.1 below
restrict none # display is cleared
define ~act2 2.1 and (47,92,93,134,142,168,170,172,203,206,207,227,231) and *:A # active site residues of 3LX9
define ~act1 1.1 and (33,78,79,119,127,154,156,158,188,191,192,213,217) and *:A # active site residues of 3H54
compare {2.1} {1.1} SUBSET{*.CA} ATOMS{~act2}{~act1} ROTATE TRANSLATE # superposition (different sequences, so use alpha carbon)
set ssbonds SIDECHAIN # disulfide bonds are anchored on SG, not on CA
# drawing 3H54 active site
select 1.1 and ~act1 and (sidechain or *.CA); wireframe 60; # show the active site as wireframe
color bonds cornflowerblue # 3H54 is shown in blue (just the bonds)
select selected and not _C; spacefill 80; color cpk # spacefill, atoms other than carbon shown using CPK color scheme
select 1.1 and (32-34, 77-80, 118-120, 126-128, 153-159, 187-193, 212-218) and *:A.CA;# some main chain context for the active site residues
trace 10; color cornflowerblue # show as trace in blue
select 1.1 and 1000:A; wireframe 60; # selecting the sugar in 3H54
select selected and _C; color skyblue; # carbons in skyblue
# drawing 3LX9 active site
select 2.1 and ~act2 and (sidechain or *.CA); wireframe 60; # show the active site as wireframe
color bonds yellow # 3LX9 is shown in yellow (just the bonds)
select selected and not _C; spacefill 80; color cpk # spacefill, atoms other than carbon shown using CPK color scheme
select 2.1 and (46-48, 91-94, 133-135, 141-143, 169-173, 202-208, 226-232) and *:A.CA;# some main chain context for the active site residues
trace 10; color yellow # show as trace in yellow
select 2.1 and 1000:A; wireframe 60;; # selecting the sugar in 3LX9
select selected and _C; color beige; # carbons in beige
center selected; zoom 300 # center and zoom in
Overall views
These don't have a focal point. They should be centered on everything displayed. If using a representation you can look through (e.g. backbone or cartoon rather than surface or spacefill), fading/fogging "zshade" may be helpful to distinguish front and back.
