Chimera Commands Index

Usage:
vop operation arguments options

The vop command edits volume data to create a new volume data set. The original map is undisplayed and the new map is displayed with the same threshold and color as the original. Map display can be adjusted and the map saved to a file using Volume Viewer or the command volume. See also: mask, Volume Filter, Segment Map

Examples:

vop add #1-25 onGrid #0
vop add #1,2,5 onGrid #5 inPlace true
vop add #1,2 boundingGrid false
vop gaussian #3 sd 5
vop subtract #2 #4 modelId #5
vop unbend #0 #1 z 200 200

The operation can be:

Volume models (maps) are specified by a comma-separated list of model numbers or ranges of model numbers preceded by #. Operation keywords and their sub-keywords described below can be truncated to unique strings, and their case does not matter. Synonyms for true: True, 1. Synonyms for false: False, 0. A vertical bar "|" designates mutually exclusive options, and default settings are indicated with bold.

vop add volume-specscaleFactors f1,f2,... ] [ onGrid gridmap ] [ boundingGrid true|false ] [ gridStep N | Nx,Ny,Nz ] [ gridSubregion name | i1,j1,k1,i2,j2,k2 | all ] general-options

Add two or more maps to create a new map. The scaleFactors keyword specifies a multiplier for each map (default 1.0); as many values as input maps must be supplied, separated by commas but not spaces.

The new map can be created on the grid of another, where gridmap is a model number preceded by #. If gridmap is not specified, it defaults to the first in volume-spec (the first of the maps being added). The input maps are resampled on the grid by trilinear interpolation, and the resulting values summed for each grid point. Further options related to gridmap:

If the new map is large, for example a whole tomogram, the command may fail for lack of memory. The whole new map must fit in memory.

vop bin volume-specbinSize N | Nx,Ny,Nz ] general-options
Average over cells of multiple grid points in the original map to produce a smaller map. Supplying a single integer N (default 2) indicates partitioning the map into bins of NxNxN grid points and averaging the N3 values per bin to produce a new map with 1/N as many points in each dimension. Cells with different numbers of grid points in each dimension can be specified by supplying three integers Nx,Ny,Nz separated by commas only. See also: segment
vop boxes volume-spec atom-spec  size d  [ useMarkerSize true|false ] general-options
For each marker or atom in atom-spec, extract a surrounding cube of data. The edge length of each cube is the size d plus (if useMarkerSize is true) the diameter of its central marker or atom. The size is specified in physical units of length and can be omitted (default d=0.0) only when useMarkerSize is true.
vop cover volume-specatomBox  atom-spec [ pad d ]] [ box x1,y1,z1,x2,y2,z2 ] [ x x1,x2 ] [ y y1,y2 ] [ z z1,z2 ] [ fbox a1,b1,c1,a2,b2,c2 ] [ fx a1,a2 ] [ fy b1,b2 ] [ fz c1,c2 ] [ ibox i1,j1,k1,i2,j2,k2 ] [ ix i1,i2 ] [ iy j1,j2 ] [ iz k1,k2 ] general-options
Extend a map to cover specified atoms or to fill a rectangular box. It is assumed that the input map is periodic along all three axes. The output dimensions can be specified as: Unspecified dimensions will be kept the same as the input map.
vop flatten volume-spec general-options
Scale data values by factor (1 + a*i + b*j + c*k) where i,j,k are the grid indices and a,b,c are calculated to zero out the first moments of the resulting map (make its mass balance at the center of the grid).
vop fourier volume-spec general-options
Calculate the 3D Fourier transform.
vop gaussian volume-specsDev σ ] [ valueType value-type ] general-options
Perform Gaussian filtering with half-width σ. The half-width is one standard deviation of the 3D isotropic Gaussian function, specified in physical units such as Å (default 1.0). The value-type defaults to the current type and can be 8-, 16-, or 32-bit signed integer (int8, int16, or int32), 8-, 16-, or 32-bit unsigned integer (uint8, uint16, or uint32), or 32- or 64-bit floating-point (float32 or float64).
vop laplacian volume-spec general-options
Perform Laplacian filtering.
vop median volume-specbinSize N | Nx,Ny,Nz ] [ iterations M ] general-options
Smooth the data by setting each value to the median of the values in a box centered at that point. Values at points for which the surrounding box extends outside the data are simply set to zero. Box dimensions are specified in grid units with binSize and must be odd integers. Supplying a single integer N (default 3) indicates a box size of NxNxN grid points. Boxes with different numbers of grid points in each dimension can be specified by supplying three integers Nx,Ny,Nz separated by commas only. The iterations option indicates how many cycles of smoothing to perform (default 1).
vop morph volume-specstart start-fraction ] [ playStep increment ] [ frames N ] [ playDirection 1 | –1 ] [ playRange low-fraction,high-fraction ] [ scaleFactors f1,f2,... ] [ constantVolume true|false ] [ addMode true|false ] [ hideOriginalMaps true|false ] general-options
Morph between two or more maps (this is the command-line implementation of Morph Map, except that more than two maps can be handled). For a reasonable result, the input maps should have the same grid dimensions, spacing, and numbers of points. A morphing fraction of 0.0 corresponds to the first map and a fraction of 1.0 corresponds to the last, with intermediate maps evenly spaced within that range. There is smooth interpolation between each adjacent pair of maps.

The morph display will proceed from start-fraction (default 0.0) in steps of increment (default 0.04) for N frames (default 25). By default (playDirection 1), the initial direction of play is from low to high fractions. If the number of frames and step increment are more than needed to reach the playRange bounds (default is the entire range: 0.0,1.0), the morph display will "bounce" back and forth. The scaleFactors keyword specifies a multiplier for each map (default 1.0); as many values as input maps must be supplied. The constantVolume option specifies adjusting the threshold (contour level) automatically to keep the enclosed volume constant. The addMode option specifies treating the second map as a delta to be added to the first instead of linearly interpolating between the two. It is not recommended for inputs of >2 maps. The hideOriginalMaps option specifies hiding the input maps.

vop ~octant volume-speccenter x,y,z | iCenter i,j,k ] [ fillValue value ] general-options
Erase values inside the positive octant (all grid points with X,Y,Z coordinates greater than the center). The center can be specified in physical units (such as Å) with center or in grid units with iCenter. The default is the center of the volume data box. The coordinates should be separated by commas but not spaces, and the values can be fractional. iCenter overrides center if both are given. The values in the erased regions will be set to value (default 0). A different value may improve contour surface appearance; for example, large negative values produce flatter surfaces where an octant has been cut away from a map of positive values.
vop octant volume-speccenter x,y,z | iCenter i,j,k ] [ fillValue value ] general-options
Erase values outside the positive octant. Options are as described for ~octant above.
vop permuteAxes volume-specaxisOrder order ] general-options
Permute grid axes to the specified order, which can be any of the 6 ordered combinations of x, y, and z. The original order is xyz.
vop resample volume-spec onGrid gridmapboundingGrid true|false ] [ gridStep N | Nx,Ny,Nz ] [ gridSubregion name | i1,j1,k1,i2,j2,k2 | all ] general-options
Resample values on the grid of another map, where gridmap is a model number preceded by #. Values on the grid are obtained by trilinear interpolation of the input map. The other arguments are as described above for add.
vop scale volume-specfactor f ] [ shift constant ] [ valueType value-type ] general-options
Scale values by a multiplicative factor f (default 1.0), shift values by adding a constant (default 0.0), and/or cast them to a different data value type. When values are both shifted and scaled, the shift is applied first. The value-type defaults to the current type and can be 8-, 16-, or 32-bit signed integer (int8, int16, or int32), 8-, 16-, or 32-bit unsigned integer (uint8, uint16, or uint32), or 32- or 64-bit floating-point (float32 or float64).
vop subtract map othermapscaleFactors f1,f2 ] [ minRMS true|false ] [ onGrid gridmap ] [ boundingGrid true|false ] [ gridStep N | Nx,Ny,Nz ] [ gridSubregion name | i1,j1,k1,i2,j2,k2 | all ] general-options
Subtract the values of othermap from map, both specified by model number preceded by #. The scaleFactors keyword specifies multipliers f1 and f2 for map and othermap, respectively; two values must be supplied, separated by a comma but not spaces. Alternatively, the minRMS option can be used to scale othermap automatically to minimize the root-mean-square sum of the resulting (subtracted) values at grid points within the lowest contour of othermap.

The new map can be created on the grid of another, where gridmap is a model number preceded by #. If gridmap is not specified, it defaults to map. The input maps are resampled on the grid by trilinear interpolation, and the resulting values subtracted for each grid point. The remaining arguments are as described above for add, except that boundingGrid always defaults to false.

vop unbend volume-spec  path-spec  new-y  xsize  ysizegridSpacing s ] general-options
Unbend a map near a path formed by markers/links or equivalently, atoms/bonds. The path-spec should be an atom-spec that specifies a single chain of atoms (markers) connected by bonds (links). The path will be mapped to the Z axis of the result. The new-y parameter defines what axis in the existing volume will be mapped to the Y axis of the result, and can be given as: The xsize and ysize parameters give the X and Y dimensions of the new map in physical units (typically Å). The gridSpacing s is the separation between grid points in the new map (default is the minimum spacing along the three axes of the input map). A cubic spline is placed through the path points and the input volume is interpolated on planes perpendicular to the splined path.
vop zFlip volume-spec general-options
Reverse the order of the Z planes.

General Options

modelId N
Open the new data set as model number N (an integer, optionally preceded by #). The default is the lowest unused number.
step N | Nx,Ny,Nz
Whether to use the full resolution of the data (step size 1, default) or a specified subsample (step size > 1). Step sizes must be integers. A step size of 1 indicates all data points, 2 indicates every other data point, 3 every third point, etc. If a single number is supplied, it is used along all three axes; if three numbers are supplied (separated by commas but not spaces), they are used along the X, Y, and Z axes, respectively.
subregion name | i1,j1,k1,i2,j2,k2 | all
Whether to use the full extents of the data (all, default) or a specified subregion. A subregion can be specified by:
inPlace true|false
Whether to overwrite the existing data set in Chimera instead of creating a new one. Not all operations accept this option. Regardless of this setting, the existing data will only be overwritten if it was created in Chimera (for example with a previous vop command) rather than read from a file. In the case of map addition, the model to overwrite is the gridmap (the model whose grid will be used for the result).