MST Raytrace Programs



Ray Generation, Interactions with Matter

doublepass trace rays from source through optics, off a flat, and back again
flat reflects off a rectangular flat
genphot generate test rays, filling a geometric area
hsi_rqe adjust ray weight according to HSI relative quantum efficience. Assumes monochromatic rays at one of the HSI calibration energies.
multilayer_reflect reflect rays from a multilayer surface
OSAC polarization all about OSAC polarization info
raygen generate rays from realistic sources. also available in PDF
reflect reflect rays; see also reflect udf. Note that reflect is obsolete; use multilayer_reflect instead.
SAOdrat ray trace off of a deformed surface; see also saodrat_udf (dvi) or saodrat_udf (ps). SAOdrat is now obsolete; use surface_intercept instead.
SAOfocus evaluate focus with minimum RMS spot size.
surface_intercept ray trace a deformed surface. This is a replacement for SAOdrat. Currently the main difference is that surface_intercept uses a faster and nonproprietary B-spline implementation BSplineEval
spline_convert_format convert between spline deformation file formats.
trace-nest1 now obsolete. raytrace a nest of shells, hey!
trace-nest2 raytrace a nest of shells, hey!
trace-nest3 raytrace a nest of shells, hey!
trace-shell5 now obsolete. raytrace a shell, hey!
trace-shellz3 raytrace a shell, hey!
trace-shellz4 raytrace a shell, hey! (still experimental)

Ray Manipulations

blur blur rays' positions
fujtym fudge ray time stamps
ghost_filter selectively remove rays based on ghost ray status
mergephot merge ray streams (phot format)
mergerays merge ray streams (bpipe format)
mixrays mix ray streams (phot format)
mxwldmn sample ray weights
passid filter rays based on their id numbers
photz set rays' Z coordinate
rotate_ray rotate rays in raystream about a fixed spatial point
setwt set rays' weights to a given value
shift_phot move rays around
throttle reduce the number of rays in a ray stream

Ray Analysis

b-c-simplex beam center using simplex
beam-center beam center using spline peaks
centroid centroid a bpipe ray stream
chord calculate center of ring image
enen-p measure encircled energy
enwtsum enwtsum - sum up weights of rays with the same energy

Detectors, Instruments, Apertures, Obstructions

deticpt intercept rays at detector plane
aperture simulate apertures
grating Simulate ideal diffraction gratings (HETG, LETG)
img_slitsim simulate slit apertures
mcp simulate a micro-channel-plate detector
mesh simulate FPC window mesh
pinhole simulate pinhole apertures
quef apply an energy dependent quantum efficiency to a ray stream
spatquant bin ray streams in a variety of ways
wedge simulate a wedge aperture

Conversion (Formats, Coordinates)

bp2fits convert bpipe rays to the AXAF FITS standard for Ray Trace Interchange
elaz2raygen convert from OSAC elevation/azimuth coordinates to the raygen polar coordinate system.
fits2bp convert FITS binary table to a bpipe stream
fits2rdb convert FITS binary table to an rdb table
bp2rdb convert bpipe rays to /rdb tables
rdb2bp_rt convert rdb table to bpipe rays
bpipe2eventfits convert bpipe to HSI events FITS file
bpipe2fr convert bpipe rays to fullrays
bpipe2phot convert bpipe rays to phot dpde rays
flip_axis flip a coordinate axis
fr2bpipe convert fullrays to bpipe rays
hrma2osac translate HRMA to OSAC coordinates
mirror2osac extract OSAC mirror constants from a mirror output file and write an rdb file compatible with the trace-shell family of raytrace programs.
osac2xrcf translate OSAC to XRCF coordinates
osac2hrma translate OSAC to HRMA coordinates
bpscalepos rescale position by scale. replacement for rescale_units
rescale_units rescale spatial coordinates by scale_factor
spline_asc_to_bin convert ascii spline deformation files to binary
spline_bin_to_asc convert binary spline deformation files to ascii

Visualization

imageplot low level image plotting routine
imageray image a raytrace
photfitsplt plot scatter diagrams of FITS files meeting the AXAF Photon FITS standard

End to End Simulations

sim_ea simulate XRCF effective area and pinhole measurements
xrcf_rt simulate XRCF measurements specified by runid

Studies, Process Simulations

foc_vs_dens
lsm_vs_multilayer_reflect comparison of the LSM and multilayer_reflect code
mesh_trans study transmission through the fpc-mesh
ph_survey study pinhole scans
ph_survey2 study pinhole scans
ph_survey3 study pinhole scans
pinhole_focus simulate the pinhole focus algorithm
qshut_focus simulate the quad shutter focus algorithm

AXAF MST Simulations and Analysis Software
Diab Jerius
Last modified: Tue Sep 21 11:08:59 EDT 2004