NAME

ea_offaxis - simulates off axis effective area tests


SYNOPSIS

ea_offaxis [-param=value ...]


PARAMETERS

ea_offaxis uses the PERL Getopt::Long parameter interface.

-z_focus

Tells where to drop off the rays. To find this value, run trace-xrcf1 with parameter 'focus = yes'. Then run command 'getfocus' on the foo.focus.lis file. This gives the focus value in OSAC coordinates.

-photdens

The photon density. This value is given to the 'limit' parameter in trace-xrcf1. The limit_type is set to r/mm2.

-runid

If user wants to simulate a specific XRCF test, set runid, otherwise leave unspecified.

-iteration

The iteration of the test. If not specified, and runid is given, iteration is set to 0.

-output

The name of the rdb output file. If not specified, output is sent to standard out.

-tag

Output tag. If not specified, tag is set to 'foo'. Be sure to specify a unique tag when running a batch job.

-src_par

The parameters for the source. This value is sent to the 'src_params' parameter in trace-xrcf1. If not specified, src_par is set to ``''.

-pitch

HRMA pitch. If runid is given, no need to set this parameter.

-yaw

HRMA yaw. If runid is given, no need to set this parameter.

-energy

X-ray energy. For example, if using aluminum source, set energy to 1.486. If runid is given, no need to set this parameter.

-shells

Quad and shutter configuration. For example, if using shells 1 and 3, set shells to 1,3 or oooooooocccccccc or oooo_oooo_cccc_cccc. If runid is given, no need to set this parameter.

-seed1

Random seed1. This value is sent to 'seed1' parameter in trace-xrcf1. If not specified, seed1 is set to 1.

-seed2

Random seed2. This value is sent to 'seed2' parameter in trace-xrcf1. If not specified, seed2 is set to 1.

-block

Random seed block. This value is sent to 'block' parameter in trace-xrcf1. If not specified, block is set to 0.

-config_db

Configuration database. This value is sent to 'config_db' parameter in trace-xrcf1. If not specified, config_db is set to 'xrcf_xss_05'.

-x_focus

The x-offset (mm) of grid from image center. This value is sent to parameter 'xoffset' in pinhole. Unless user wants to use specific x offset, no need to set this parameter. If runid is given, no need to set this parameter.

-y_focus

The y-offset (mm) of grid from image center. This value is sent to parameter 'yoffset' in pinhole. Unless user wants to use specific y offset, no need to set this parameter. If runid is given, no need to set this parameter.

-aperture

Aperture in units of mm. If runid is given, no need to set this parameter.

-detector

The focal plane detector. If runid is given, no need to set this parameter.

-plot

If yes, creates bp file. Can run bp2rdb | rdbplt to plot image.

-help

If yes, print this help information and exit.


DESCRIPTION

This program simulates off-axis effective area tests. It can be used to raytrace specific XRCF tests ( provide runid ), or raytrace non existing tests ( provide aperture, pitch, yaw, energy, shell, and focal plane detector information ).


AUTHOR

Kendra J. Michaud ( kmichaud@cfa.harvard.edu )