Man page - raster3d(1)

Packages contains this manual

Package:  raster3d
apt-get install raster3d

Manuals in package:
• stereo3d(1)
• ribbon(1)
• rastep(1)
• raster3d(1)
• avs2ps(1)
• r3d_objects(1)
• render(1)
• rods(1)
• rings3d(1)
• balls(1)
• normal3d(1)
• label3d(1)
• r3dtops(1)
Documentations in package:
• raster3d

Manual

Raster3D

NAME
SYNOPSIS
DESCRIPTION
EXAMPLES
SOURCE
SEE ALSO
LICENSE
AUTHORS

---

NAME

Raster3D - molecular graphics package

SYNOPSIS

The Raster3D molecular graphics package consists of a core program render and a number of ancillary programs ( balls , rastep , rods ) which produce input files for rendering from PDB (Protein Data Bank) files of atomic coordinates. Raster3D can also render images composed using other programs such as MOLSCRIPT [Per Kraulis (1991), J. Appl. Cryst. 24, 946-950].

Raster3D is freely available. If you use the package to prepare figures for publication, please give proper credit to the authors. The proper citation for the current version is Merritt & Bacon (1997).

Bacon & Anderson (1988) J. Molec. Graphics 6, 219-220.
Merritt & Murphy (1994) Acta Cryst. D50, 869-873.
Merritt & Bacon (1997) Meth. Enzymol. 277, 505-524.

DESCRIPTION

Raster3D uses a fast Z-buffer algorithm to produce high quality pixel images featuring one shadowing light source, additional non-shadowing light sources, specular highlighting, transparency, and Phong shaded surfaces. Output is in the form of a pixel image with 24 bits of color information per pixel. Raster3D does not depend on graphics hardware.

The following image output formats are supported: AVS, JPEG, PNG, TIFF, and SGI libimage. To actually view or manipulate the images produced, you must also have installed an image viewing package (e.g. John Cristy’s ImageMagick or the SGI libimage utilities). A filter utility avs2ps is included in the package which can convert an AVS format output stream directly to a dithered monochrome PostScript image.

Although Raster3D is not intended as a general purpose ray-tracing package, nothing in the rendering process is specific to molecular graphics.

EXAMPLES

Using only programs included in the Raster3D distribution one can create and render space-filling models, ball-and-stick models, ribbon models, and figures composed of any combination of these. The following set of commands would produce a composite figure of an Fe-containing metalloprotein with a smoothly shaded ribbon representation of the protein and spheres drawn for the Fe atoms:

#
# Draw smooth ribbon with default color scheme 2,
# save description (with header records) in ribbon.r3d
#
cat protein.pdb | ribbon -d2 > ribbon.r3d
#
# Extract Fe atoms only, and draw as spheres.
# Color info is taken from colorfile.
# Save description (with no header records) in irons.r3d
#
grep "FE" protein.pdb | cat colorfile - | balls -h > irons.r3d
#
# combine the two descriptions and render to a PNG image
#
cat ribbon.r3d irons.r3d | render > picture.png

Integrated use of MOLSCRIPT/Raster3D/ImageMagick allows one to describe, render, and view 3D representations of existing MOLSCRIPT figures:

molscript -r infile.dat | render | display png:-

SOURCE

web URL:

			http://www.bmsc.washington.edu/raster3d/raster3d.html
		contact:
			Ethan A Merritt
			University of Washington, Seattle WA 98195
			merritt@u.washington.edu

SEE ALSO

render(l), rastep(l), rods(l), ribbon(l), balls(l), avs2ps(l), stereo3d(l)

LICENSE

Raster3D version 3.0 is distributed under the terms of the
Artistic License, Version 2.0.

AUTHORS

Originally written by David J Bacon and Wayne F Anderson.
Ancillary programs by Mark Israel, Stephen Samuel, Michael Murphy, Albert Berghuis, and Ethan A Merritt. Extensions, revisions, and modifications by Ethan A Merritt.

---