CEDAR Demo

Stéphane BélandCenter for Astrophysics and Space Astronomy

University of Colorado

September 9, 2008

CEDAR Package:

•Download from http://cos.colorado.edu/CEDAR

•Reference files available at: http://cos.colorado.edu/CEDAR/REFERENCE/

•Help Files (seriously outdated): http://cos.colorado.edu/CEDAR/CEDAR_HELP.tar.gz •Requirements:

•IDL 6.0 or later (now at 7.0)

•ASTRON Library at: http://idlastro.gsfc.nasa.gov/

•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 …