.help addrmf Jun94 ftools.caltools
.ih
NAME
ADDRMF -- Add together RMFs
.ih
USAGE
addrmf [<list> [<rmffile>]]

addrmf <list> [rmffile=<rmffile>]

addrmf [file1,file2,..] [wt1,wt2,...] [rmffile=<rmffile>]

.ih
DESCRIPTION
ADDRMF adds together two or more RMFs. A  weighting  factor  may  be
applied  to  each input RMF.   To average RMFs, total weights should
add up to 1.0.  To add RMFs, each individual weight should be 1.0.
The header and energy bounds extensions are copied from the first
input  RMF.  Some  checking  is  done  to ensure  that  compatible
RMFs  are added however thought is advised before using this tool.

.ih
PARAMETERS
.ls list [string]
The input to this parameter can either be a list of  RMF  files,
or  can  be  the name of an ASCII file containing such a list
of files (one per line) and weighting factors for the  RMFs.
Note that for long parameter values (e.g. high precision weights),
parameter values read from the command line are limited to 1024 chars
and an ASCII file should be used instead if parameter lengths may
exceed this number.
Each line  of the file should contain the RMF name followed
by a real number giving the weighting to be applied to  this
RMF  in  the summation.   In  case of, an ascii file is used,
the name of the ASCII  file  should  be  preceeded  by  a,  '@'
(eg  @file_list instructs  the  task  to open the ASCII file
file_list, and read the RMF filenames from it).  The  number
of  RMF  files  cannot exceed 2500.
.le
.ls weights [string]
Weighting  factors  for  the  RMFs  given via the list parameter.
User is asked for this parameter when name  of  RMFs are  given
and  not  the  ascii file.  The number of values and ordering
MUST be the same as for the filenames specified by  the list
parameter. The input to this parameter is a list of reals.
.le
.ls rmffile [string]
The name of the output RMF file.
.le
.ls clobber [bool]
If clobber = yes then overwrite the RMF file if a file of this name already
exists.
.le
.ih
EXAMPLES

ASCA:
.br
Add together the RMFs foo.rmf and goo.rmf with equal weighting
and write the answer to hoo.rmf. First create file.list containing :
	foo.rmf  0.5
.br
        goo.rmf  0.5
.br
then :

     ca> addrmf @file.list hoo.rmf
.fi
.ih
               or,

     ca> addrmf foo.rmf,goo.rmf 0.5,0.5 hoo.rmf

.br
RXTE:
.br
When adding together responses from different detectors (for
example individual PCU in the RXTE PCA), use a weight of 1.0
for each individual file.  This is required for the following
reason: One detector receives X counts, so N detectors receive
N*X counts.  The matrix for one detector has approximately
1400 cm^2.  So the matrix for a combined PHA spectrum with N*X
counts must have approximately N*1400 cm^2.

       ca> addrmf pcu0.rmf,pcu1.rmf,pcu3.rmf 1.0,1.0,1.0 pcu_013.rmf

.fi
BUGS

.ih


.endhelp

