========================================== Echelle Simulator V1.0 (March 2010) ========================================== ******** Contents ******** History Overview Requirements Installation How to use Contact Address INPUT parameters ******** History ******** v0.9.1 May. 2003 : First version Source distribution v0.9.2 Aug. 2004 ... v1.0 March.2010 .sav file distribution to use IDL Virtual Machine ******** OVERVIEW ******** The echelle simulator for IRCS was developed for the following purposes: 1. It helps users find the most suitable positions of spectral lines of their interest by adjusting the echelle and cross-disperser setting parameters to avoid bad pixels on the detector. 2. It helps users identify the spectral features, telluric absorption lines, OH emission lines, stellar photospheric lines, etc. This function is useful for identification of comparison line as the first step of wavelength calibration. 3. It helps spectrograph developers predict the spectral format of the echelle spectrograph and investigate the optical arrangement. The echelle simulator for IRCS has the following functions in order to make easy comparison between the simulated echellogram and observed frames. 1. It can overlap the echellogram on an observed frame and badpixel image. 2. It calculates and draws slit images of spectral lines given in a list file. 3. It draws instrumental response functions including the blaze function of the gratings, atmospheric transmittance, and filter transmittance function. 4. It gives a list file for the positions and information of spectral lines. 5. It can draw the atmospheric transmittance overlapped on an observed spectral format. You can find the outputs for standard setting of echelle spectrograph of IRCS in the IRCS homepage (http://www.naoj.org/Observing/Instruments/IRCS/index.html). The current version of echelle simulator is based on Gaussian optics. ************* REQUIREMENTS ************* 1. IDL VM (Virtual Machine) for Windows/Unix/Mac OC X #Download the latest IDL from ITT website (http://www.ittvis.com/idl). #IDL VM is free. You don't need an IDL license. #You can choose to install just IDL VM or whole package of IDL during installation. 2. Postscript Viewer e.g. ggv, gv(GhostView), Adobe illustrator, etc. ************* INSTALLATION ************* ==1. Unpacking === Unzip the Esimulatorv1.0.tar.gz file into any desired directory. >tar -zxvf Esimulatorv1.0.tar *file list README ; this file file.list ; file list ESimulator.sav ; main program ESimulator.par ; parameter file (INPUT parameter) ;Atmospheric transmittance data ATM_TRANS_1.00-5.50.dat ;spectral line data [FeII]_linelist.dat 12CO_fundamental.dat 13CO_fundamental.dat AtomicHydrogenline.dat CO_bandhead.dat H2_total_list.dat He_lines.dat iraf_argon.dat issac_OHlistv20.dat ohlines.dat ;Transmittance of filters Iz_spfilter.dat J_spfilter.dat H_spfilter.dat K_spfilter.dat L_spfilter.dat M_spfilter.dat zJ_spfilter.dat ; Bad pixel image spg_badpix90.fits ==2. Set Working Folder === The directory used for unpacking files will be the Working Folder. Every OUTPUT file will be made in this Working Folder. *********** HOW TO USE *********** 1. INPUT Parameter Setting (1) OPEN ESimulator.par by text editor such as vi/emacs/notepad.... (2) EDIT and SET INPUT parameters in ESimulator.par for your observation. (3) SAVE ESimulator.par. 2. Run ESimulator.sav file in the IDL VM (Virtual Machine) [When .sav files are linked with IDL VM] (a) Double-click the directory including ESimulator.sav in Windows Explorer, (b) "Runtime App" will be appear on task bar and make OUTPUT files (default Echellogram.ps and RF.ps.) [Using Windows Explorer and mouse (drag & drop)] (a) Open the directory including ESimulator.sav in Windows Explorer, (b) Select ESimulator.sav file, (c) Drag ESimulator.sav file and drop it onto the IDL Virtual Machine icon on your desktop. (d) "Runtime App" will be appear on task bar and make OUTPUT files (default Echellogram.ps and RF.ps.) [OPEN .sav file from IDL VM] (a) Select Start->Program->IDL 6.* or 7.* ->IDL Virtual Machine, (b) Select (Double-click) ESimulator.sav file in file open dialog window of IDL VM, (c) "Runtime App" will be appear on task bar and make OUTPUT files (default Echellogram.ps and RF.ps.) [CASE 1] (a) Run ESimulator.sav file with the following UNIX command: idl -vm=ESimulator.sav Where is the complete path of the directory including ESimulator.sav file. (b) OUTPUT files (default Echellogram.ps, RF.ps, and Line.table) will be made. [CASE 2] (a) Start IDL VM with the following command: idl -vm (b) Open ESimulator.sav in the IDL VM. (c) OUTPUT files (default Echellogram.ps and RF.ps) will be made. 3. You can check the messages made by the program in "program.log" ****************** Parameter Setting ****************** 1) Set output files You can modify/change the output file names PS_OUTPUT : IRCS Echellogram output (postscript file) PS_RESPONSE_OUTPUT : IRCS response function output (postscript file) LINES_OUTPUT : Table of spectral lines displayed on echellogram (ascii file) 2) Set band filter BAND : You can choose one band filter among Iz, zJ, J, H, K, L, and M. 3) Set Echelle and Cross-disperser SETTING : You can choose one standard setting of IRCS among Iz, zJ, J, H- and H+ in H-band, K- and K+ in K-band, LA-, LA*, LA+, LB-, LB*, and LB+ in L-band, M--, M-, M+, and M++ in M-band You will meet an error message when the 'BAND' and 'SETTING' parameters are mismatched: "ERROR#1: Mismatching between BAND and SETTING parameters." If you want to calculate the outputs with a non-standard setting situation, please set 'SETTING = Custom' and then set ECHELLE and X-DISP parameters. The ECHELLE parameter can be set from -12000 to 11000. The X-DISP parameter can be set from -6000 to 6100. The real positions of spectral lines are different within several pixels from the calculated positions. The main reason is that current version of this program does not correct the optical abbretions. The real positions, however, are also moved in a few pixels due to mounting accuracy of IRCS to the Subaru Telescope. The 'd_Ec_Offset' and 'd_XD_Offset' parameters are prepared for users to adjust the positions of spectral lines in detail. These parameters are useful when you compare the positions of spectal lines on an observed real image with those of spectral lines calculated by this program. 4) Set width and length of slit SLIT : You can choose one slit in the following slits: J-High (0.155"W X 3.89"L), J-Med (0.309"W X 3.89"L), J-Low (0.618"W X 3.89"L) H-High (0.155"W X 5.79"L), H-Med (0.309"W X 5.79"L), H-Low (0.618"W X 5.79"L) K-High (0.155"W X 7.50"L), K-Med (0.309"W X 7.50"L), K-Low (0.618"W X 7.50"L) L-Med (0.309"W X 10.5"L), L-Low (0.618"W X 10.5"L) If you want to use a not-built-in slit, please set 'SLIT = Custom' and then set 'SLITWIDTH' and 'SLITLENGTH' parameters in arcsecond unit. 5) Set echellogram plot options PLOTOBJECT : You can choose one among 'Aperture', 'Line', and 'ATM_T': 'Aperture' will draw the aperture of each order with wavelength, 'Line' will draw spectral lines in the files of LINEDATA, and 'ATM_T' will draw both the atmospheric transmittance and spectral lines on the echellogram. 6) Set line data files LINEDATA : You can set ascii (text) files including the spectral line data You can set up to ten files as the LINEDATA files. The ascii files including the spectral line data have the format as the follows: unit ; set wavelength unit