Tutorial
This tutorial shows how to use FilaSitus programs in conjunction with VMD 1.7 to greate actin filaments at low resolution in a triangular bundle and side-by-side arrangement. The created files can be compared with precomputed files provided in the FilaSitus solutions directory. More documentation is also available in the User Guide, the Methodology page of Situs, the VMD user guide, and in the published Situs articles.
Content
Creating Atomic Structures of Actin Filament Bundles with filabuild

The filabuild tool generates multiple copies of the input PDB file in the z-direction according to a user-specified helical symmetry, and in the (x,y) direction, according to a specified offset. All helical parameters, the start angle, flipping of filaments, etc., can be adjusted by the user in the configuration files.

Here we show how this is done with some of the provided input files. At the shell prompt, enter (you can cut and paste this):

./filabuild nohy_start_sd1.pdb configure_36_17_bundle.dat 13_sd1_bundle.pdb
./filabuild nohy_start_sd1.pdb configure_36_17_sidebyside.dat 13_sd1_sidebyside.pdb
./filabuild nohy_start.pdb configure_36_17_bundle.dat 13_bundle.pdb
./filabuild nohy_start.pdb configure_36_17_sidebyside.dat 13_sidebyside.pdb

The first two commands create filaments from actin's subdomain 1 (SD1) only, whereas the last two generate the full structures. You can inpect the resulting stuctures with any molecular graphics program. Explore the appearance of the structures depending on the specified parameters that are documented in the configuration files to learn the functionality of the program. This should all be self-explanatory and easy to understand.

We have now created structures of full actin and SD1, both as a triangular bundle, and side-by-side. Note that the angle (phase) offsets must be adjusted between bundle and side-by-side to reflect the correct orientation of the filaments when the triangular bundle is "folded" open to show the interior contacts.

Creating Low-Resolution Volumetric (Simulated EM) Data with kercon

To create a visually appealing low-resolution representation of the atomic structures we use the kercon tool to project them to a cubic lattice and convolve the resulting 3D density with a Gaussian blurring kernel at a user-specified resolution. Here, we take the 4 structures created above and blur them to a resolution of 20A, although lower values can be entered to reveal more spatial detail. The choice of resolution is up to the user.

Here we show how this is done with one of the structures. At the shell prompt, enter:

./kercon 13_bundle.pdb 13_bundle.situs

Next, at the program prompt, enter 2 (mass density blurring), the desired voxel spacing of the lattice: 6 (A), the desired kernel: 1 (Gaussian), target resolution: 20 (A), kernel amplitude: 1 (this is arbitrary, different values give a different scaling of the 3D density), sigma correction: 1. Here is the complete output of this run:

./kercon 13_bundle.pdb 13_bundle.situs
pdbio> 124404 atoms read.
kercon> What kind of 3D density function do you want to create:
kercon>
kercon> 1: Charge density (atom charges will be read from PDB occupancy field)
kercon> 2: Mass density (atom masses are assigned automatically)
kercon> 2
kercon> There are 124404 non-hydrogen atoms, represented by 125370 equally weighted input atoms
kercon>
kercon> The input structure measures 174.508 x 163.790 x 420.297 Angstrom
kercon>
kercon> Please enter the desired voxel spacing for the output map (in Angstrom): 6
kercon>
kercon> Please select the type of kernel:
kercon>
kercon> 1: Gaussian: A exp(-1.5 r^2 / sigma^2),
kercon> useful for resolution-lowering of atomic structures.
kercon>
kercon> 2: Hard Sphere: 0 (outside) or A (inside),
kercon> useful for bead-modeling at reduced complexity:
kercon> - sphere radii are read from input PDB file (B-factor field).
kercon> - sphere boundaries are anti-aliased 1-voxel wide
kercon> 1
kercon> Kernel width. Please enter (in Angstrom):
kercon> (as pos. value) target resolution (== 2 sigma) or
kercon> (as neg. value) kernel half-max radius
kercon> Now enter (signed) value: 20
kercon>
kercon> The Gaussian kernel has the following properties:
kercon>
kercon> Gaussian, A exp(-1.5 r^2 / sigma^2)
kercon> sigma = 10.000A, r-half = 6.798A, r-cut = 17.321A
kercon>
kercon> Please enter the desired kernel amplitude A: 1
kercon>
kercon> Do you want to correct sigma for spreading introduced by tri-linear projection to lattice?
kercon>
kercon> 1: Yes (slightly lowers the kernel width to maintain target resolution)
kercon> 2: No
kercon> 1
kercon> Projecting atom masses to cubic lattice by tri-linear interpolation...
kercon> ... done. Lattice spread (rmsd): 4.244 Angstrom
kercon>
kercon> Computing Gaussian kernel (correcting sigma for lattice smoothing)...
kercon> ... done. Kernel map extent 7 x 7 x 7 voxels
kercon>
kercon> Convolving lattice with kernel...
kercon> ... done. Spatial resolution (2 sigma) of output map: 20.000A
kercon>
volio> Writing density data...
volio> Volumetric data written to file 13_bundle.situs
volio> File 13_bundle.situs - Header information:
volio> Columns, rows, and sections: x=1-41, y=1-39, z=1-82
volio> 3D coordinates of first voxel (1,1,1): (-78.000000,-78.000000,-66.000000)
volio> Voxel size in Angstrom: 6.000000

Again, the user can change some of the program parameters if desired. In the case at hand one would probably only be interested in the effect of changing resolution. As an exercise, repeat the same procedure for the input structures 13_sidebyside.pdb, 13_sd1_bundle.pdb, and 13_sd1_sidebyside.pdb, creating the corresponding output maps in Situs format: 13_sidebyside.situs, 13_sd1_bundle.situs, and 13_sd1_sidebyside.situs, respectively.

Creating VMD 1.7-Readable Isocontour Surfaces with volcube

Using volcube, we generate isocontour surfaces of the simulated low-resolution densities which can be visualized with VMD version 1.7 (the currently recommended version). At the shell prompt, enter:

./volcube 13_bundle.situs 13_bundle.vmd

Next, at the program prompt, enter the voxel size for rendering: 6 (A), the desired isocontour level: 40, and the rendering mode: 3 (solid trinorm surface).

Here is the complete output of this run:

./volcube 13_bundle.situs 13_bundle.vmd
volcube> File 13_bundle.situs - Header information:
volcube> Columns, rows, and sections: x=1-41, y=1-39, z=1-82
volcube> 3D coordinates of first voxel (1,1,1): (-78.00,-78.00,-66.00)
volcube> Voxel size in Angstrom: 6.000000
volcube> Enter desired voxel size for rendering (in Angstrom): 6
volcube> Reading density data...
volcube> Volumetric data read from file 13_bundle.situs
volcube> Min. / max. density values: 0.000 / 110.235
volcube> Enter desired surface contour level for rendering: 40
volcube> Choose one of the following three VMD rendering options -
volcube> 1: Lines (wireframe)
volcube> 2: Triangles (solid)
volcube> 3: Trinorms (solid, smooth shading)
volcube> 3
volcube> Found cube intersection patterns:
volcube> 0: 128218
volcube> 1: 3179
volcube> 2: 3516
volcube> 3a: 6
volcube> 3 or 4: 13
volcube> 5: 2389
volcube> 6a: 3
volcube> 6: 3
volcube> 7a: 0
volcube> 7: 0
volcube> 8: 1714
volcube> 9: 366
volcube> 10: 0
volcube> 11 or 14: 33
volcube> 12: 0
volcube> 13: 2113
volcube> Total number of patterns 1-14 (excluding 4a): 141553
volcube> Pattern types according to W. Heiden, T. Goetze, and J. Brickmann,
volcube> J. Comp. Chem. 14 (1993), 246-250.
volcube> Number of ambiguous triangle orientations: 15
volcube> Graphics objects written to file 13_bundle.vmd. Normal Termination...

Note that the program returns the range of density values in the data file. You can use this to estimate the proper isocontour threshold value. We choose a value of 40 because the resulting surfaces appear similar (see below) to the molecular surface of the actin filaments. Likewise, we process the other three volumetric maps: 13_sidebyside.situs, 13_sd1_bundle.situs, and 13_sd1_sidebyside.situs, and create the corresponding VMD files: 13_sidebyside.vmd, 13_sd1_bundle.vmd, and 13_sd1_sidebyside.vmd, respectively. However, it is important to choose a slightly lower cutoff (35) for the SD1 surfaces, so that they later occlude the surfaces of the full actin filaments (see below).

Visualizing Isocontours with VMD 1.7

Now we can load the isocontour surfaces into VMD. For convenience, the following VMD commands can be pasted directly into the VMD 1.7 command console:

source 13_bundle.vmd
draw color red
source 13_sd1_bundle.vmd
display resetview

Here is the view created by this representation (note that you van make snapshots with the VMD 1.7 "Render" menu):

Likewise, we can visualize the side-by-side representation:

draw delete all
source 13_sidebyside.vmd
draw color red
source 13_sd1_sidebyside.vmd
display resetview

Here is the view created by this representation:

Cropping Maps with pindown

The surfaces created in the above manner are somewhat uneven at the ends of the filament, due to the effect of the blurring on the finite-size structures. One may wish to crop the density files to trim off the filament ends to create a cleaner look. This has to be done on the Situs formatted files, i.e. before the isocontours are created. The suitable map cropping tool is pindown, which allows one to extract a box of interest based on an enumeration of the lattice points. We enter one caveat here: Since the Situs formatted maps may differ in their size and origin (3D coordinates of the [1,1,1] voxel), one has to do the math at which lattice index to crop to create similar cropping in two related files (e.g. in full actin and SD1 only). Fortunately, the pindown program displays the map origin and the number of x,y,and z increments in a map which is all the information needed.

To do a clean cropping of the ends on the data at hand we suggest the following: At the UNIX shell prompt enter e.g. (similar for the other files):

./pindown 13_sd1_bundle.situs 13_sd1_bundle_crop.situs

And at the pindown prompt enter the following crop regions: 1-41,1-39,15-67 (13_bundle_crop.situs), 1-41,1-39,13-65 (13_sd1_bundle_crop.situs), 1-61,1-27,15-67 (13_sidebyside_crop.situs), and 1-61,1-27,13-65 (13_sd1_sidebyside_crop.situs). After generating the corresponding ".vmd files" (as above) we can visualize the cropped density data (detail view):

Creative Use of the VMD Clipping Plane

The side-by-side representation is useful as it allows one to clip away any unwanted parts of the molecular surfaces with the VMD clipping plane. To test this, source again 13_sidebyside.vmd, change the color to red, and source 13_sd1_sidebyside.vmd. and reset the view (e.g. VMD Mouse menu). Now use the VMD "Far Clip" plane (VMD Display Menu) and bring it closer to the front. Take a snapshot. Next enter "draw delete all" and "source 13_sidebyside.vmd" into the VMD command console and set the clipping plane behind the scene. Take a second snapshot. In graphics programs like Adobe Photoshop you can make the black background of the first snapshot transparent and superimpose the colored pixels as a layer onto the second snapshot. This should look as follows:

+ =

This is a quick way to viualize the SD1 contacts in the center of the triangular bundle, if the phase offset angles of the side-by-side representation were chosen accordingly.

Return to the front page.