DSP = display spectra, developed by Ph. Demoulin, Institute of Astrophysics, University of Liège, Belgium (e-mail : demoulin@astro.ulg.ac.be) Accepted formats : ****************** - SFIT2 input and output spectra - PROFFIT input (binary) and output (ASCII) formats - Curtis Rinsland SFIT1 input spectra (binary), SFIT output spectra (ASCII) and SIMUL output spectra (binary) - Bruker Jungfraujoch FTS spectra (binary A3000 format) - Liège-made Jungfraujoch FTS (binary) - Frank Hase LINEFIT format (ASCII, coma separated) - Geoff Toon GGG program output (ASCII) - (X,Y) spectra (ASCII) - (X,Y1,Y2) spectra (ASCII) [supposed to be respectively : wavenumber, observed spectrum, computed spectrum] - ASCII spectra ("Kitt Peak adapted") Features : ********** Works under DOS, Windows 3.11, Windows NT, Windows XP... Should work in CGA, EGA, VGA (Hercules ? ...) Coprocessor : required but a version not needing one can be obtained Printer : - output in Postscript file, on LASERJET III and on DESKJET 1200 C (color) printers - should work on all LASERJET printers ? Installation of DSP program : ***************************** NOTE : DSP only work with directories and files in the DOS filename format (8.3 characters) ! 1) Before running DSP, the environment variable DSPDIR must be set to the directory where DSP.FON and DSP.DOM are located. For example, if you copy all DSP files in the directory c:\util\dsp, add the line "SET DSPDIR=c:\util\dsp" in your AUTOEXEC.BAT file. 2) You will maybe have to create a directory C:\TEMP if it does not exist. 3) Run the program DSP_SET.EXE, to configure some settings (e.g. HITRAN linelist path). Runstring : *********** DSP [filename [wavenumber1 [wavenumber2]]] or DSP [filename [domain]] Example : ********* DSP spectrum 2925.45 2926.35 or DSP spectrum HCL (see DSP.DOM for examples of predefined domains) or DSP sp*.* Files : ******* DSP.EXE executable DSP.TXT this file DSP.DOM list of wavenumbers domains; you can edit this file to modify or or add your domains (maximum 56 domains) DSP.FON fonts used by DSP DSP.CFG configuration file created by DSP (should not be write protected if you want to save your configuration for the next run) DSP_SET.EXE configuration program Commands : ********** rem : most of the commands are related to the last spectrum drawn (for example L, F, X, Z, ... commands) C = new drawing; asks for the center and the width of the new domain to draw. D = new drawing; asks for the limits of the new domain to draw. Esc = go back one step. ctrl-Backspace = restart DSP F = line finder : asks for a wavenumber range and a minimum depth, finds all the lines in that range having that minimum depth, and saves the positions and depths of those lines in a file. Tab or ctrl-I : same as command I, but avoid to type the complete filename : you only type the last characters of the filename which are different from the previous filename; these characters will replace the corresponding characters in the previous filename. X (Z) = line right (left) of cursor : draws a line at the line center and gives the line position and depth. DSP looks only at lines whose depth is bigger than a given value. The default value for this minimum depth is 2.0 %. It can be changed by pressing Alt-F8. With Alt-F8, you can also change the way DSP searches lines (from 1 = search only broad lines, to 8 = search narrowest lines) Y = Y limits : by default, when DSP draws a spectrum on the screen, it expands it from the maximum to the minimum in the drawn domain. The Y command enable the user to fix Y values (for example to always draw from 0 to 1) or not. It toggles from a mode where Y axis is automatically expanded to a mode where the Y axis limits are fixed. The "TOTAL" option fixes the Y limits to the maximum and the minimum values of the complete spectrum. The Ctrl-Y command fixes the Y limits at [-0.03,1.03]. Alt-F1 = wavenumber calibration : first point a line with the X or the Z command, then press alt-F1; DSP will ask you for the wavenumber of that line. If the spectrum is in the Bruker spectra, you will be asked if you want to save the calibration in the spectrum header on disk. Alt-F12 = write domain on screen in a (X,Y) file Alt-H and Ctrl-H: Alt-H lists the HITRAN database around the pointed line : first you have to point a line with X or Z commands, then Alt-H will list HITRAN; first column of the listing is a crude approximation of the line depth (in %). Ctrl-H draws the HITRAN database (vertical lines, proportional to the line strength) superimposed over the spectrum; it is possible to draw only one species or all the species; to stop HITRAN drawing, press again Ctrl-H. The HITRAN database has to be in SFIT format (CFGL files, in 20 cm-1 pieces). HITRAN database location can be changed with Alt-F5 command (change HITRAN settings). Alt-H and Ctrl-H list only lines whose depth is larger than a given value. This threshold can also be changed by pressing Alt-F5. Alt-P : printer configuration Note for Windows NT and network printer users : DSP doesn't accept to print on an output device in the form of \\ULG001\LASERJET (network printer); instead you have to define (in DOS) a device LPTn by using the command "NET USE": for example "NET USE LPT2: \\ULG001\LASERJET /PERSISTENT:YES" keys -9 to 9 = zooms of 2^key, centered on cursor position. others commands : they should be obvious ? ----------------------------------------------------------------------------- Undocumented features : *********************** - if you type SUN for the spectrum name, you will see a pure solar spectrum obtained by the ATMOS experiment (JPL) in 1985 (you need this spectrum on your disk; it is distributed as ATLAS.SUN in the zip file) ----------------------------------------------------------------------------- The latest version of DSP can be obtained by anonymous ftp at ftp://arachnos.astro.ulg.ac.be/pub/users/demoulin/dsp/ Any comments or suggestions are welcome and can be sent to Ph. Demoulin (demoulin@astro.ulg.ac.be). ----------------------------------------------------------------------------- What's new ? ~~~~~~~~~~~~ June 1997 : - keyboard is now working correctly under Windows NT (cursor movement was incredibly slow under Windows NT); this improvement should also correct a problem reported in MS-DOS with a few PC, causing the system to hang when starting DSP; so DSP should now work on all PC ? - new command : ctrl-H (draws Hitran database) May 1998 : improvement in the "search line" part October 2000 : can now read multi-windows SFIT2 output files ("PBPFILE") (ctrl-PgDn and ctrl-PgUp commands) May 2001 : Postscript output is now in color April 2002 : LINEFIT format accepted June 2007 : can draw successive files (ex : DSP s*.*) January 2008 : now accept HITRAN2004 - 2007 version (released with SFIT2 - v3.93) [new gases : F141B, CH3OH (methanol), CH3CN, C2H6PL (C2H6 pseudolines), PAN (peroxyacetyl nitrate), CH3CHO] November 2008 : PROFFIT input (binary) and output (ASCII) format accepted March 2010 : now accept HITRAN 2008 format