NAME: mimiretc PURPOSE: (one line only) Exposure time and throughput calculator for {\it Mimir} DESCRIPTION: This program is a non-blocking widget tool for grism and filter combinations for Mimir, an infrared imaging spectrograph at Lowell Observatory built in cooperation with Boston University. This program attempts to model the light passing through in the instrument and possible being dispersed. Along the way, the efficicncy of the instrument is tallied and you get to see what will be collected at the detector. When this program starts, it expects to find a collection of files in the current directory. These files define the instrument and the throughput of its individual components. The first file that is read is 'mimir.info'. This file has the following format: 1 Mimir_Info_v1.0 2 437.5 effective focal length of collimator in mm 3 132.195 effective focal length of camera in mm 4 27.0 pixel size of detector in microns 5 unity.dat 6 unity.dat 7 blank.dat 8 grism_jhk.dat ... a :grism sp.dat ... b :filter The line numbers do not appear in the file. Trailing comments are ok only on lines with numeric values (not with file names). The first line is the version ID tag. Line 2 is the effective focal length of the collimator in millimeters and is used only to determine pixel scale on the sky. Line 3 is the effective focal length of the camera lens in mm. This is used to determine the translation from angular deviation after the grism to pixels. Line 4 is the size of the pixels on the detector in microns. The balance of the file is a list of file names in two sections. The first section is a list of grisms. The list is terminated with the line ":grism". This grism list is made up of file names that point to grism definition files. The second section is a list of filters. Again, the filter list is a list of file names. Grism files are in the following format: 1 Mimir_Grism_v1.0 2 120.0 Grooves/mm 3 29.986 Groove angle, degrees 4 1.52 Index of refraction for resin 5 29.3 Prism apex angle, degrees 6 1.42 Index of refraction for prism The first line is the version id string. The next five lines specify the grism properties as indicated by the option comment strings. DO NOT include the line numbers in the file. Filter files are two-column tables of numbers. The first column is a wavelength in microns and the second column is the fraction of light transmitted at that wavelength (between 0 and 1). This file does not need to be tabulated on a regular grid. Internally the program will use linear interpolation to get intermediate values. To ensure that the file doesn't lead to non-physical values, make sure the first pair and last pair of numbers have identical throughputs so that extrapolation beyond the tabulated range will return a constant value. A complete set of files (including some test entries) are stored in ftp://ftp.lowell.edu/pub/buie/mimir/etc. Get all the .dat and .info files. The File menu option of "postscript" causes a color postscript file to be generated with all three plots (wavelength, angle, and pixel) to the file idl.ps. CATEGORY: Utility CALLING SEQUENCE: mimiretc INPUTS: OPTIONAL INPUT PARAMETERS: KEYWORD INPUT PARAMETERS: OUTPUTS: KEYWORD OUTPUT PARAMETERS: COMMON BLOCKS: SIDE EFFECTS: RESTRICTIONS: mimir.info is read only upon startup. If you edit this file while the program is running you will need to exit and restart to pick up the changes. All other files are read whenever a plot is generated meaning you can edit a grism or filter file, save it, replot and see the new values. PROCEDURE: MODIFICATION HISTORY: written by Marc W. Buie, Lowell Observatory, 2002/11/26 2002/12/02, MWB, fixed set_plot bug on Windows platforms