NAME

funcnts2rdb - convert the output of funcnts to an RDB table

SYNOPSIS

funcnts2rdb [options] -- [input [output]]

OPTIONS

Options may take optional arguments, which are symbolically shown below enclosed in square brackets. Optional arguments may be appended to the option with an equals sign, or may be separated from it by white space.

--input file

The input file. if not present, reads from the standard input stream. The input file may also be specified as the first non-option argument on the command line, i.e.

--output file

Ordinarily, the results are written to the standard output stream. This redirects them to the specified file. This may also be specified as the second non-option argument on the command line. In this case, the input file must be specified as the first non-option argument on the command line, i.e.

  funcntsrdb [options] input output

--data[=file]

output the background subtracted data

--sumdata[=file]

output the summed background subtracted data

--source[=file]

output the source region data

--bkgd[=file]

output the background region data

--help | -h

Print a short help message and exit.

--usage

Print this message and exit.

--version

Print the version and exit.

DESCRIPTION

funcnts2rdb converts the output of funcnts into an RDB table. It normally reads from the standard input stream and writes to the standard output stream.

There are up to four different tables in funcnts output. They can't all be written to one output stream (they don't play well in groups), so there are options to specify which ones get written and where. From here on, the default output stream refers to what was specified via the --output option, or to the system standard output stream if --output wasn't specified.

To write out a particular table, specify the appropriate parameter (--data, --sumdata, --source, or --bkgd). Each parameter takes an optional value, which is the name of the file to which the table is to be written. If no file is specified, the table is written to the default output stream.

funcnts2rdb's default behavior is to write the background-subtracted counts table to the default output stream. The background-subtracted data are not written out if output files are specified for other tables.

Examples

The default behavior is equivalent to
```
 funcnts2rdb --data
```
```
 funcnts2rdb --sumdata < funcnts.output
```
will instead write the summed background data to the default output stream.
```
 funcnts2rdb --sumdata=sum.rdb --source=src.rdb < funcnts.out
```
will write the summed background-subtracted data and the source region data to the specified files.
```
 funcnts2rdb --data --sumdata=sum.rdb --source=src.rdb < funcnts.out
```
will write the summed background-subtracted data and the source region data to the specified files, and the background subtracted data to the default output stream.

AUTHOR

Diab Jerius ( djerius@cfa.harvard.edu )