DAS51 news

DAS51 - New and Updated Features (10/4/13)

A. V. Panasyuk and L. Strachan (earlier D. Phillips and S. Giordano)

Introduction

This document describes the new and updated features of the UVCS Data Display and Analysis Software, Version 5.1 (DAS51). It has new features to work with the FINAL UVCS DATA (uncalibrated and calibrated UVCS FITS files) in the SOHO Archives. Note that any old calibrated FITS files that were calibrated prior to this DAS release will not work with DAS51. It is recommended that users download the new versions of their FITS files that are now in the SOHO Archives. These new files have additional FITS header KEYWORDS that were not included in the old FITS files. Old and new calibrated files are only compatible with their respective DAS version.

To see the previous version of this document, which described the DAS40 updates, click here http://www.cfa.harvard.edu/uvcs/get_involved/das40_news.html . This document has the original plots of the radiometric efficiencies vs. mirror aperture, mirror pointing correction, etc.

All of the features listed below have been implemented in the DAS Version 5.1.

Time variation in efficiency of the OVI direct channel
Time variation in efficiency for OVI redundant and LYA channels if appropriate
Time variation of wavelength calibration
Telescope mirror and grating cross talk correction
Improved precision for pointing calibration below 1.74 R_sun. (This provides a value at 1.5 R_sun and allows consistency in displaying the height throughout the DAS)
New estimate of second order radiometric calibration
White Light Channel characterization (including stray light) and calibration
Filter transmission information (automatic radiometric calibration for disk observations)
Improved precision for pointing variation with roll (small effect)
Dark count files can be specified
Instrument spectral line profile function can be specified

The DAS51 package consists of the following subdirectories and files:

Directory	File	Contents
DAS51/DPS/	das51_standalone2.pro	Main code
	das.help	DAS Help file (txt)
	das.pro	batch file to run das51_standalone2
	SULFIT5_standalone.pro	line fitting package
	sulfit.pro	batch file to run SULFIT5_standalone
DAS51/DPS/CAL/	D.40.1996.01.02, etc.	Radiometric calibration files
	xtalk_LYA.tab	LYA grating positions for X-talk correction
	xtalk_OVI.tab	OVI grating positions for X-talk correction
	GratShiftLYA.idl	IDL save file for LYA grating shift calibration
	GratShiftOVI.idl	IDL save file for OVI grating shift calibration
	stray_light_vld_DAS40_mod.dat	VLC stray light calibration
	UVCS_Art_small1.jpg	small UVCS+EIT solar image for DAS menu
	signat.jpg	small UVCS logo for DAS menu
DAS51/DPS/CATALOG	cat_sg_YYYY_A.tab cat_sg_YYYY_B.tab	Tables A and B for Observation catalog, created from FITS file headers. Presently a file for each year (YYYY) from 1996 to 2006
	CATALOG_CME_20031023	UVCS Observed CMEs list from J.Raymond and A. Ciaravella, last update Oct 23, 2003
	CATALOG_COMETS_20040520	UVCS Observed Comets list from J.Raymond and S. Giordano last update May 20, 2004
	Catalog1996_2006	IDL save file for UVCS DAS Catalog
	objects	list of values for Planned Targets
	obs_mode	list of values for Observed Heights
	observers	list of values for Lead Observers
	results	list of values for Actual Targets
	sci_obj	list of values for Science Objectives
DAS51/DPS/DARK	dark_1996_smth5	Dark Field file
DAS51/DPS/DOCS	e.g. das51_news.html	This document (and Help files for earlier DAS versions)
DAS51/DPS/FLAT	e.g. flat_sao.lya., flat_sao.ovi.	Flat Field calibration files
DAS51/DPS/MLOG	e.g. 96.08.27.a.log	Mission Log Files
DAS51/DPS/SCI	(empty)	Location for UVCS VLD and spectral FITS files to be analyzed by the User

In addition to the code:

1 - if you want display colored buttons, you should add the following lines somewhere in your ".Xdefaults" file (in the top level of your home directory):

!
IDL colors

Idl*background:        
LightBlue

Idl*foreground:        
Black

Idl*white*background:   White

Idl*green*background:   Green

Idl*yellow*background:  Yellow

Idl*blue*background:    Blue

Idl*lblue*background:   LightBlue

Idl*red*background:     Red

Idl*magenta*background: Magenta

Idl*cyan*background:    Cyan

Idl*azure*background:   Azure   
    
Idl*aqua*background:    Aquamarine    

Idl*gold*background:    Gold

Idl*indian*background: 
IndianRed    

2 - to manage DAS under 24-bit Linux displays add also the following lines in your ".Xdefaults" file

Idl.retain:2
Idl.gr_visual: TrueColor

To run the DAS51 code:

change to the directory DAS51/DPS/
start IDL
compile the code from the IDL prompt type: "@das {Return}"
bring up the DAS interface by typing "mn {Return}"

The updated and new features are organized and described in this document
following the menus and buttons as they appear in the DAS main window.

Compatibility:

DAS51 works with IDL 5.3 and later (up to IDL 8.1)
DAS51 was developed for UNIX and Linux-based operating systems (not MS-Windows)

Main Window (No change from DAS40)

More readable color buttons
Number of Data Set extended to 18 (DAS33 has only 10)
Display FITS filenames in the main window with long path
Authors list moved to a button
Buttons to show release notes and help as html pages
"Display 2D Images" added for DAS40 (See below)
"DATA CATALOG"added for DAS40 (See below)

General Menu (No change from DAS40)

"Clear all Data Sets" option
"Save DAS Session" into a .sav file
"Restore DAS Session" from a previous saved .sav file

SPVL Data Menu (NEW changes for DAS51)

"All Data: Combine MIRPOS " option added
"Concatenate All Data Sets" option added
Read FITS

File selection allows the user to click and browse the directories
Read compressed, .Z, and gzipped, .gz, files (DAS33 read .Z only)
Read VLD files

Modify/delete panels

Option to select the total number of bins along the slit, that is the "total bin(s)" field
Display data of the selected panel, with rows and columns coordinates, to help the panel modification

Calibration Menu (NEW changes for DAS51 are highlighted below)

Original DAS40 features:

Configuration Calibration, now automatically chooses appropriate calibration files from the ../CAL directory.
Configuration Calibration, Perform mirror calibration below 1.74 R using the new calibration files.

Radiometric Calibration, Perform correction for neutral density filter transmission as a function of wavelength, the calibration parameters from L.Gardner are in the DAS IDL code.

Offset Pointing Correction, compute the effective pointing in the case of instrument offset, the calibration parameters from L.Gardner are in the DAS IDL code. The figure below shows as DAS40 allows the display and processing of the disk observations.

Background subtraction. A panel where only the background is expected can be selected, averaged in the spectral direction and subtracted from another panel. This feature is not really related to data calibration.

Perform detector profile correction, this feature deconvolve detector profile and perform the subtraction from the data by using the procedure developed by A. Panasyuk.

VLD pB calibration

Instrumental configuration corrected for x-talk, read ancillary calibration files with grating position for both UV channels: "../CAL/xtalk_LYA.tab" and "..CAL/xtalk_OVI.tab"

VLD Pointing corrected for the channel offset

pB computation from M.Romoli et al. paper 2002

correction for new VLD efficiency, the field "CAL.VLD.FACTOR" in the calibration file has been updated
correction for stray light, read ancillary calibration file "../CAL/stray_light_vld_fit1.dat"

New features for DAS51: The menu buttons listed below perform their actions on ALL WS Data Sets.

All Data: Configuration
All Data: Offset Correction
All Data: VL pB Computations
All Data: Wavelength Calibration
All Data: Radiometric Calibration

IMAGE Data Menu (No change from DAS40)

The Make Image feature, allows the creation of images for the ratio between two panels

DATA CATALOG (No change from DAS40)

The DAS comes with up-to-date catalog tables as of the date you downloaded it. If you would like the newest tables, please check http://www.cfa.harvard.edu/uvcs/DOWNLOAD/TABLES51.tar.Z

Display Data (No change from DAS40)

Widget resized

Update features

Save postscript files of the plots along the spatial and spectral direction, "Hardcopy" button.
Pointing display show the solar polar coordinate of selected detector pixel (distance and polar angle), "PTNG" button.
Statistics allow total counts larger values with respect to the DAS33, "STAT" button

Original features from DAS40

Panel zoom with option to save images into various formats (jpeg,tiff,png,ps), "ZOOM2" button.
Option to perform a Gaussian fit of select spatial and spectral region, "GFit" button.

Display of VLD data

Raw data display

print counts

Configured data display:

print counts
plots of counts vs time

pB data display:

print pB values

plots of many parameters:

pB vs Time or vs Height
Angle vs Time or vs Height
Stokes I,Q,U vs or vs Height
pB/I vs Time or vs Height

Plots hardcopy on postscript file, "Harcopy button"
Save values into ascii file, "Save on ASCII File" button
Zoom plot option, sliders below the plot.

Quick Look (No change from DAS40)

Allow display of larger number of exposures with respect to DAS33
Allow display larger exposure times with respect to DAS33
Option to save images into various formats (jpeg,tiff,png,ps)
Works for 2D images

Display 2D Images

Display Pointing (1 NEW change for DAS51)

Option to load UVCS synoptic, LASCO, EIT and more images from http://soho.nascom.nasa.gov/data/latestimages.html and superimpose those images to the UVCS Field of View, "Load Image" button.
Option to save images into various formats, "SAVE IMA" button
Option to adjust the offset of loaded images, "Adjust PNTG" button.
Works for VLD also.
"OVERLAP INT" added to plot intensities.