Usage:
( scolor | scolour ) surf-model method options

Scolor colors surface models and their caps. It is the command-line implementation of Surface Color and Color Zone. See also: color, colorkey, rangecolor, rainbow, transparency, coulombic, apbs, sop, volume, msc

Examples:

scolor #0 geometry cylindrical
scolor #0 geom radial cmap 100,gray:150,blue:200,purple
scolor #0 volume #1 cmap -10,red:0,white:10,blue
scolor #1 zone @ca range 5

• color - a single color (can also be done with the color command)
• zone - to match the colors of nearby atoms or markers
• volume - by volume data such as electron density or electrostatic potential
• gradient - by volume data gradient
• geometry radial - by distance from a point
• geometry cylindrical - by distance from an axis
• geometry height - by distance from a plane

Simply use the specified color, where color_name can be any color name that specifies a single color. The general options do not apply to this method.

Color surface patches to match the specified atoms or markers. The range option indicates a cutoff (default 2.0) in physical distance units, typically Å. The autoUpdate option indicates whether to update the coloring of a surface automatically when its shape changes. The ~scolor command discontinues coloring by zone. See also: Color Zone

Color by volume data such as electron density or electrostatic potential, where volume-model is the model number (preceded by #) of the volume data set. The perPixel option indicates whether to determine color separately for each surface pixel instead of interpolating across surface triangles (see details). Per-pixel coloring tends to give smoother color gradations. Values at surface vertices are determined by interpolation except when per-pixel coloring is used (see details). The colorOutsideVolume option specifies how to color for surface vertices that fall outside the volume data grid. The color_name can be any color name that specifies a single color; the default is #800080008000 (a dark gray). The offset option specifies how far out from each surface vertex, along its normal, to evaluate the data (default 0.0):

• d - a single offset distance
• start,end,N (three values separated by commas only) - starting distance, ending distance, and how many offsets to evaluate within that range, respectively. For example, offset 1.5,3.0,3 specifies offsets of 1.5, 2.25, and 3.0. Values from multiple offsets are averaged per surface vertex. Specifying multiple offsets turns off any per-pixel coloring.

Color by volume data gradient norm, where volume-model is the model number (preceded by #) of the volume data set. Gradients (how steeply the values change in space) at surface vertices are determined by interpolation (see details). The colorOutsideVolume and offset options are as described above for volume.

Color by distance from a point. The point can be specified with center, where center can be:

• x,y,z (three values separated by commas only) - an arbitrary point
• an atom-spec of any combination of atoms and surface pieces. The center of the bounding sphere of the specified items will be used.

The default is the center of the bounding box of the surface. The coordinateSystem option indicates that x,y,z specifications of center should be interpreted in the coordinate system of a reference model. N is the reference model number preceded by #. The default coordinate system is that of the surface being colored.

Color by distance from an axis. The axis is defined by any point on the axis and a direction. The point can be specified with center and the direction with axis, where axis can be:

• x - X-axis
• y - Y-axis
• z - Z-axis
• x,y,z (three values separated by commas only) - an arbitrary vector
• an atom-spec of exactly two atoms (not necessarily bonded or in the same model) or one bond. A bond can only be specified by selecting it and using the word selected, sel, or picked; any atoms also selected at the time will be ignored.

The default is the Z-axis in the coordinate system of the surface. The coordinateSystem option indicates that specifications of center and/or axis should be interpreted in the coordinate system of a reference model. N is the reference model number preceded by #. The default coordinate system is that of the surface being colored.

Color by distance from a plane, or topographic height. The plane is defined by any point on the plane and a vector normal to the plane. The point can be specified with center and the vector with axis. The coordinateSystem option indicates that specifications of center and/or axis should be interpreted in the coordinate system of a reference model. N is the reference model number preceded by #. The default coordinate system is that of the surface being colored.

cmap  palette | value1,color1:value2,color2:...
Use the specified color mapping, which can be either a pre-defined palette (colors listed in ascending value order):

• redblue (default) - red, white, blue
• rainbow - red, yellow, green, cyan, blue
• cyanmaroon - #0f1bc7adcf5b (a dark cyan), white, #9eb820005eb8 (a dark maroon)
• gray - black, white

or a series of value,color pairs (no spaces) separated by colons only. Values can be expressed directly on the scale of the data (cmapRange not used) or as fractional values 0.0-1.0 across a range of data specified with cmapRange. Values below the lowest given will map to the same color as the lowest, and values above the highest will map to the same color as the highest. A color can be any color name that specifies a single color.

cmapRange  low,high | full
What data values should map to the extremes of the cmap palette, or to values 0.0 and 1.0 when cmap value,color pairs are used. The low and high values should be separated by a comma only (no spaces). The full keyword indicates using the minimum and maximum values found at surface vertices (default for pre-defined palettes). When multiple surfaces are colored in a single command, the full range is determined separately for each surface.

reverseColors true | false
Whether to reverse the order of the colors in the palette.

capOnly true | false
Whether to color only surface caps and not the rest of a surface.

autoUpdate true | false
Whether to update the coloring of a surface automatically when its shape changes. For example, the shape of a surface cap changes as clipping is adjusted, and a molecular surface changes shape when it is recomputed with a different probe radius. This updating only accounts for changes in the shape of a surface, not changes in its position or orientation relative to other models.