mergephot


NAME

mergephot - merge dj/phot photon files


PARAMETERS

mergephot uses the standard parameter interface

desc file
This parameter specifies the merge description file. See below for more info.

output filename
This specifies the output file. If it's the string stdout, the rays are sent to the UNIX standard output stream.

exposure float
The exposure to scale the photons to, if non-zero. Leave this at zero!!

norm_photcnt boolean
If true, normalize the photon counts to the first streams. Leave this off!!

norm_wt boolean
Scale the photon streams to the largest scale factor? Leave this off!!

cvtbufsz float
The size of the internal input buffer, in kilobytes. 500 kb is a good size.

raybufsz float
The size of the internal work buffer, in Megabytes. This is really only used for merges, in which case it should be as large as possible, but less than the physical amount of memory in the computer. Otherwise, 8 Mb is a good size.

tmp_dir directory
If the photon files are larger than physical memory and a merge is required, this specifies where temporary files should be written. It should be to a local disk.

version boolean
Print out mergephot's version and exit.

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

.


DESCRIPTION

mergephot merges two or more ray files which are in dj/phot format. It is meant to merge ray files based upon the ray arrival times. In almost all cases, the files do not contain times, and thus it performs a concatenation, not a merge. Merges take substantially more time and resources than do concatenations. (Note that the tmp_dir parameter only applies to merges.)

mergephot uses a merge description file to determine which files to merge, and how to merge them. In the file, there should be one line per ray file, with four, white space separated, fields. The first field is the name of the file, the second and third, the x and y offsets to apply to the rays (these are usually 0), and the last field is a multiplicative factor applied to the weights of the rays (usually 1). For example:

shell1.dpde 0.0 0.0 1.0 shell3.dpde 0.0 0.0 1.0 shell4.dpde 0.0 0.0 1.0 shell6.dpde 0.0 0.0 1.0


AUTHOR

D. Jerius