rdb2region - construct a region file from an rdb table
rdb2region [options] [rdb table]
- --input file
-
The input file. May also be specified as the last command line argument.
If not present, reads from the standard input stream.
- --output file
-
Ordinarily, the results are written to the standard output stream.
This redirects them to the specified file.
- --help
-
Print this message and exit.
- --version
-
Print the version and exit.
- --color color
-
Specify the default color. If the color begins with a
%,
it specifies the name of the column containing the color,
allowing for different colors for each region.
- --font font
-
Specify the default font.
- --coord coordinate system
-
Specify the default coordinate system
- --edit | --noedit
-
The Edit property specifies if the user is allowed to edit the region
via the GUI. Defaults to true.
- --select | --noselect
-
The Select property specifies if the user is allowed to select (hence,
edit) the region via the GUI. For Regions used for catalogs and such,
it is desirable that the user is unable to edit, move, or delete the
region. Defaults to true.
- --move | --nomove
-
The Move property specifies if the user is allowed to move the region
via the GUI. Defaults to true.
- --rotate | --norotate
-
The Rotate property specifies if the user is allowed to rotate the
region via the GUI. Defaults to true.
- --delete | --nodelete
-
The Delete property specifies if the user is allowed to delete the
region via the GUI. Defaults to true.
- --include
-
The Include properties flags the region with a boolean NOT for
later analysis.
- --fixed
-
The Fixed in Size property specifies that the region does not change
in size as the image magnification factor changes. This allows the
user to build complex pointer type regions.
- --width
-
Specifies the line width used to draw the region.
Each region flag takes as a value parameters specific to that region.
- --annulus radius column
-
This creates a series of concentric annuli. The column gives the outer
radius of the annuli. The inner radius of the first annulus will be 0;
that for subsequent annuli are the outer radius of the previous
annulus. The input RDB table should be sorted on this column.
- --circle radius column
-
The default region is a circle; the circle radius is
taken from the specified column. If the column name begins with
%, this will specify the actual column radius, which will
be used for all of the regions.
- --ellipse semi-major axis column,semi-minor axis column,rotation angle column
-
The default region is an ellipse; the ellipse semi-major, semi-minor
and rotation angle are taken from the specified columns. If a
column name begins with
%, this will specify the actual value
for that parameter, to be used for all of the regions.
- --point marker type
-
Specifies that the default region is a point, with the
given marker type. If the marker type attribute begins
with a
%, it refers to a name of a column which contains
the actual marker type (allowing one to specify a different
marker type per region)
- --box width column,height column,rotation angle column
-
Specifies that the default region is a box; the box width, height, and
rotation angle are taken from the specified columns. If a column name
begins with
%, this will specify the actual value for that parameter,
to be used for all of the regions.
- --text text column
-
Specifies that text regions should be generated, with the text coming
from the specified column. This may also be used in conjunction with
the other region type options, in which case the text is added as
a property of the region rather than the region type.
- --x x coord
-
This forces all regions to have the specified
X coordinate.
- --y y coord
-
This forces all regions to have the specified
Y coordinate.
- --xcol column
-
The name of the column containing x values. Defaults to
x.
- --ycol column
-
The name of the column containing y values. Defaults to
y.
rdb2region generates a regions file from an RDB table.
Diab Jerius ( djerius@cfa.harvard.edu )