/usr/share/doc/raster3d/html/ribbon.html is in raster3d-doc 3.0-3-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 | <html>
<head>
<title> ribbon - Raster3D package </title>
<LINK REL=stylesheet HREF="r3d_docstyle.css" TEXT="text/css">
</head>
<body>
<h1 align=center>
<a name="RTFToC19">RIBBON</a></h1>
<h4>
<a name="RTFToC20">SYNOPSIS</a></h4>
ribbon
is a preprocessor which prepares a simple ribbon representation of a protein
backbone for the
<a href="raster3d.html">Raster3D</a>
molecular graphics package.<p>
<pre>
ribbon [-h] [-d[0123456]] pdbfile
</pre>
or
(to take PDB records from stdin)
<pre>
ribbon [-h] -d[0123456] -
</pre>
Ribbon
reads a PDB coordinate file and produces a stream of Raster3D
object descriptor records on stdout describing
a ribbon constructed from a triangular mesh.
The file produced by ribbon may be fed directly to render or
it may be combined with descriptor files produced by other Raster3D utilities.
<h4>
<a name="RTFToC21">EXAMPLES</a></h4>
To describe a the entire protein chain as a single ribbon colored smoothly from
blue at the N-terminus to red at the C-terminus:
<pre>
ribbon -d2 protein.pdb | render > chain_picture.png
</pre>
To
color a multi-chain protein with specified colors for each chain:
<pre>
cat chaincolors.pdb protein.pdb | ribbon -d5 - > chains.r3d
</pre>
<H4>OPTIONS</H4>
<dl>
<dt><i>-h</i><dd>Suppress header records in output. By default ribbon will
produce an output file which starts with header records containing a default
set of scaling and processing options. The -h flag will suppress these header
records so that the output file contains only triangle descriptors. This option
is useful for producing files which describe only part of a scene, and which
are to be later combined with descriptor files produced by other programs.
<dt><i>-d[0123456]</i><dd>By default ribbon requires interactive input to select
ribbon parameters and coloring information. Five default coloring schemes are
implemented, however, and these may be selected as a command line option to
bypass any interactive input.
<br>-d or -d0 same as -d2 below
<br>-d1 solid color ribbon (defaults to blue)
<br>-d2 shade from blue at N-terminus to red at C-terminus
<br>-d3 one surface of ribbon is blue, other surface is grey
<br>-d4 shade front surface from blue to red, back surface is grey
<br>-d5 color separate chains using successive color cards from
input stream.
Note that pattern matching on the color records is not done;
colors are simply taken sequentially as new chains are encountered.
<br>-d6 Take color from nearest CA atom using color match
templates from the COLOUR records at the head of the input file.
</dl>
<h4>DESCRIPTION</h4>
The input to ribbon consists of a single text file containing colour
information [optional] and atomic coordinates in PDB data bank
format. Only CA and carbonyl O atom records are required; all other input atoms
are ignored. Ribbon parameters and colouring specified interactively when the
program is run. Keyboard interaction may be bypassed by selecting one of the
default colouring schemes using the -d flag. A triangular mesh ribbon is output
as Raster3D descriptor records. By default the output file contains a set of
header records as required by the render program. The header is constructed to
include a TMAT matrix corresponding to the transformation matrix contained in
file setup.matrix (if it exists), or to the Eulerian angles contained in file
setup.angles (if it exists).
Ribbon produces a continuous smooth trace of the protein backbone. For more
complicated representations of protein secondary structure it is better to use
a different program, e.g. Molscript, rather than ribbon.
<h4>ENVIRONMENT</h4>
The files setup.matrix and setup.angles, if they exist, affect the header
records produced by ribbon.
<h4>AUTHORS</h4>
Original ribbon code written by Phil Evans for the CCP4 version of FRODO.
Modification to describe solid ribbons as triangular mesh for Phong shading in
Raster3D package by Ethan A Merritt.
<hr>
<a href="raster3d.html">
<img src="index_button.gif" align=top> Back to top </a>
<a href="http://www.bmsc.washington.edu/raster3d/raster3d.html">
<img src="r3d_icon.gif" alt="" align=top> Raster3D homepage </a>
</body>
</html>
|