NAME

mxwldmn - filter rays based upon their weight


PARAMETERS

mxwldmn uses the standard parameter interface

input file
Input ray stream. If the filename is the string stdin, it reads the UNIX standard input stream. It accepts rays in bpipe format.

output file
Output ray stream. If the filename is the string stdout, it writes to the UNIX standard output stream. It writes rays in bpipe format.

seed1 unsigned int
The first seed for the random number generator.

seed2 unsigned int
The second seed for the random number generator.

block unsigned int
The block in the random number sequence at which to start using random numbers. (There are 1,048,576 blocks of 1,073,741,824 random numbers each).

version boolean
Print out mxwldmn's version and exit.

help boolean
Print out help and exit.

debug list
A list of debug flags. None are presently defined.


DESCRIPTION

mxwldmn reads a ray stream in bpipe format and discards rays based upon their weight. It generates a uniformly distributed random number (using ranlib's genunf function) between 0 and 1, and discards the ray if it's weight is less than the random number. The weights of rays which are not discarded are set to unity; their polarization information is discarded as well.

It writes out a bpipe formatted ray stream.


COPYRIGHT & LICENSE

Copyright 2006 Smithsonian Astrophysical Observatory

This software is released under the GNU General Public License. You may find a copy at

          http://www.fsf.org/copyleft/gpl.html


VERSION

This documents version 1.0.0 of mxwldmn.


AUTHOR

D. Jerius