CEDAR Demo Stéphane Béland Center for Astrophysics and Space Astronomy University of Colorado September 9, 2008

CEDAR Package: Download from Reference files available at: Help Files (seriously outdated): Requirements: IDL 6.0 or later (now at 7.0) ASTRON Library at: Tested on Mac OS X, Windows XP and Vista, Solaris Should run on any platform IDL runs (Unix, Linux, Windows) Installation: Stand Alone: Copy and expand the tar file in a separate CEDAR directory (~/CEDAR) Copy the file cedar.def.dist to cedar.def and edit to reflect local directory structure Add the new CEDAR directory to IDL search path Start cedar from within IDL or using the shell script named “cedar” Server: Copy and expand the tar file in a separate CEDAR directory on the server Edit the file cedar.def.dist and cedar.dist to reflect the installation directories Edit mkcedar and copy it to a common area (/usr/local/bin) Users need to run mkcedar from their HOME directory before starting cedar from the command line by typing “cedar”

SDI file format (cos_dm06_revI.pdf):

CEDAR: Properties Interface to update and modify the environment variables defining directories and parameters used by CEDAR. Reads and updates the file cedar.def

Viewers: Viewer -> SDI Header (starts show_sdi_header) Viewer -> Science Data (starts sdi_viewer) Viewer -> X1D Spectra or X1D + Fit (starts either plot_x1d or plot_x1d_fit) Viewer -> HV/Aux/Rate Monitor (starts plot_hvi) Viewer -> Pulse Height Dump (starts plot_phd) Tools -> HEXVIEW (starts hexview)

Tools: Display specific telemetry items: Tools -> Show Header Items (starts show_header_items) Select either FITS or SDI files Enter a list of FITS keywords or telemetry mnemonics (DM06) (case insensitive) Display results in a Table that can be edited, plotted and saved Convert SDI to FITS: Tools -> Process1 (FITS+TC+GC) (starts calcos_process1) Outputs data to the directory defined as CEDAR_FITS_ROOT (FUV: 2 files) Keeps data in DETECTOR coordinate by default Run from the command line to transform in USER coordinate (IDL> calcos_process1, /usercoord) Only performs TC and GC on FUV data

Tools (cont.): Extract X1D: Tools -> Extract FUV Spectra (starts extract_fuv_spect) Outputs data to the directory defined as CEDAR_RESULTS_PATH CSIL*_x1d_s.fits for the science spectra through the PSA CSIL*_x1d_c.fits for the calibration spectra through the WCA User specifies extraction boxes from either Reference file, fixed or Auto Looks for USERCOORD keyword to determine if USER or DETECTOR coordinate (uses appropriate reference file) Tools -> Extract NUV Stripes (starts extract_nuv_stripes) Outputs data to the directory defined as CEDAR_RESULTS_PATH CSIL*_x1d_sa.fits, CSIL*_x1d_sb.fits, CSIL*_x1d_sc.fits for the 3 science stripes through the PSA CSIL*_x1d_ca.fits, CSIL*_x1d_cb.fits, CSIL*_x1d_cc.fits for the calibration stripes through the WCA User specifies extraction boxes from either Reference file, fixed or Auto Looks for USERCOORD keyword to determine if USER or DETECTOR coordinate (uses appropriate reference file)

Tools (cont.): Tools -> Wavelength Calibration (starts cos_wavecal) Read in a X1D file Tool determines optical element and central wavelength from FITS keywords and uses solutions from reference files Handles data in either USER or DETECTOR coordinate system Use “Drag” to manually align the input spectra with the NIST PtNe Vacuum spectra (align close to center) Adjust “Min. Peak.” value according to the data (enough of the brightest lines) “Auto Find” does a decent job for the FUV if initial solution is close and alignment is good: can pick blends and miss lines Manual line identification is better: Zoom on a line Click on line in plot to select corresponding NIST line Click on “Find Line Center” and select the best fit: Centroid or Gaussian Fit The Wavelength and corresponding line center pixel position will be added to the list Continue until full spectra is covered Click “Dispersion Solution”: Select the order of the fit Click on “Fit Polynomial (W vs X)” Edit the mis-identified points on the plot and re-evaluate the dispersioon solution until satisfied Save the solution and the plot of residuals

Tools (cont.): Wavelength Calibration

Science Data Viewer (sdi_viewer): Will display SDI, POD and FITS files (COS, FUSE, STIS and generic image FITS files) Feature rich: Plot data, Statistics, Gaussfit, spectral lines extraction, TimeTag filtering, Pulse Height Filtering, TimeTag movie, list specific events, sisplay the FITS header, multiple contrasts, transform in USER or DETECT coordinates Useful from the command line (any 2D array)

Additional Tools: Database: Create a new dB, Add entries, Make backup, Query selected DB (cedar->properties) FITS file entries add all KEYWORDS (FITS and _spt files) Query Tool: Select from list of KEYWORDS or type in any KEYWORDS (case insensitive) Add logical combination of KEYWORDS NOT SQL query format View the details of the FITS headers Save the result of query Display selected file

Additional Tools (cont.): Tools -> Data Compare: Used to compare two memory dump files Tools -> Memory Dump Statistics: Used to get basic statistics from a memory dump file Tools -> Number of Events: Prints in the IDL command window, the total number of events and rates from a list of selected files Tools -> Lab Configuration: Allows to edit the KEYWORDS reflecting the setting during Thermal Vac tests for a list of files Tools -> Spectral Lines Extraction: Automatic spectral line extraction from a list of files and a a list of approximate positions Tools -> Extract All NUV Lines: Performs an Automatic findlines on NUV data and saves all lines found in ASCII file Tools -> Extract NUV Resolution: automatically find line positions for wavelength calibration and resolution determination Tools -> Track Lines in TimeTag: Tracks the centroid and width of a list of spectral lines from a single TTAG exposure Tools -> Combine Files: Combine TimeTag or ACCUM files together IDL Command Line Tools: accum2ttag: …guess what it does cos_nuv_addwave: adds wavelength data to x1d files after WCA xcorrel flipcoord: transform data from oen coordinate system to the other get_rate_stats: get the count rates from either FITS or SDI file get_stim_rates, get_stim_stats: gets information on FUV stim data plot_data, plot_multi: general purpose plotting toolsgvim timeshi timeshift: slices and overlays TTAG data from a single file timeslice: extract a time slice from a TTAG data file and creates a new output file More …