NAME

fujtym - generate timestamps for a ray stream


PARAMETERS

fujtym uses an IRAF-compatible parameter interface. A template parameter file is in /proj/axaf/simul/lib/uparm/fujtym.par.

input

The name of the bpipe format input stream. If it is stdin, the UNIX standard input stream is to be read.

output

The output bpipe stream. It may be stdout, in which case the stream will be written to the UNIX standard output stream.

method

How the time stamp is to be generated. It may be one of poisson or regular. See Time Stamp Generation for more information.

timepar

The parameter used to generate the time stamp. Its meaning varies depending upon the value of method. See Time Stamp Generation for more details.

seed1

The first random number seed. It can range from 1 to 2147483562, inclusive. Used only if method is poisson.

seed2

The second random number seed. It can range from 1 to 2147483398, inclusive. Used only if method is poisson.

block

The starting block in the random number stream. It can range from 0 to 1048575, inclusive. Used only if method is poisson.

overwrite

A boolean which indicates whether time stamp information already in the data stream is to be overwritten.

help

If yes, print out this message and exit

version

If yes, the version is output to the UNIX standard output stream, and the program exits.

mode

The standard mode parameter.


DESCRIPTION

fujtym takes as input a bpipe stream and adds a time stamp to each date packet. An existing time stamp will be overwritten if the overwrite parameter is set.


Time Stamp Generation

Time stamps are generated using one of the following methods, depending upon the value of the method parameter.

poisson

Time stamps are based upon a Poisson distribution in arrival rate. The mean rate (in counts / second) must be provided via the timepar parameter.

regular

Time stamps are based upon a constant difference in time between rays. The difference (in seconds) must be provided via the timepar parameter.

constant

Every ray is given the same time. The time (in seconds) must be provided via the timepar parameter.


AUTHOR

Diab Jerius ( djerius@cfa.harvard.edu )