README file for:
----------------
TIMED SEE EGS Level 2 Data Products

This README file is located at:
https://lasp.colorado.edu/data/timed_see/level2_egs/README_EGS_L2_011.TXT

Also read the SEE_v11_releasenotes.txt file for known issues 
with the SEE data availabel at:
https://lasp.colorado.edu/data/timed_see/SEE_v11_releasenotes.txt

--------------------------------------------------
TIMED Data Rules of the Road & Data Access Policy
--------------------------------------------------
Users of TIMED data are asked to respect the following 
guidelines

Mission scientific and model results are open to all.

Users should contact the PI or designated team member of an 
instrument or modeling group early in an analysis project 
to discuss the appropriate use of instrument data or model 
results. This applies to TIMED mission team members, guest 
investigators, and other members of the scientific 
community or general public.

Users that wish to publish the results derived from TIMED 
data should normally offer co-authorship to the PI or 
his/her designated team member.  Co-authorship may be 
declined. Appropriate acknowledgement to institutions, 
personnel, and funding agencies should be given.

Users should heed the caveats of investigators as to the 
interpretation and limitations of data or model results. 
Investigators supplying data or models may insist that such 
caveats be published, even if co-authorship is declined. 
Data and model version numbers should also be specified

Pre-prints of publications and conference abstracts should 
be widely distributed to interested parties within the 
mission and related projects.

See also: http://www.timed.jhuapl.edu/scripts/mdc_rules.pl


--------------------------------------------------
TIMED SEE EGS Level 2 Data Product
--------------------------------------------------

EGS OVERVIEW:  The EUV Grating Spectrograph (EGS) component 
of SEE is a 1/4 meter Rowland circle spectrograph with a 
mechanically-ruled concave grating and a microchannel plate 
detector with a two-dimensional 1024 x 64 coded anode (CODACON) 
readout. The EGS covers the wavelength range from approximately 
26 to 190 nm.  Details of the instrument can be found at 
https://lasp.colorado.edu/see/overview/instrument-overview

For normal operations, SEE observes the Sun for about 3 minutes 
every orbit (97 minutes), which usually gives 14-15 measurements 
per day. The SEE Level 2 data are time averaged over the entire 
day, after applying corrections for atmospheric absorption, 
degradation, flare removal, and to 1-AU. A suborbital (sounding 
rocket) payload is flown once a year for TIMED SEE absolute 
calibrations.  The first SEE suborbital calibration flight was 
on Feb. 8, 2002, the second was on Aug. 12, 2003, the third was
on Oct. 15, 2004, the fourth was on Oct. 28, 2006, and the final
SEE calibration flight was on Apr. 14, 2008.  There are also three
SDO EVE calibration flights used for checking SEE degradation trends -
May 3, 2010, Mar. 23, 2011, and June 23, 2012.


DATA LOCATION:  SEE FTP site at
          https://lasp.colorado.edu/data/timed_see/level2_egs/

  Copy the *.ncdf files as BINARY files.

  Copy the *.pro files (IDL procedures) as ASCII files.

  Copy the *.txt files (help files) as ASCII files.

  A special mission-to-date merged file is created from this data
  and updated daily. The most recent file may be located at:
  https://lasp.colorado.edu/data/timed_see/level2_egs/
  with a naming convention of see__egs_L2_merged_YYYYDOY_011.ncdf

FILE FORMAT:  NetCDF file for each daily average

FILE CONTENT:  Solar irradiance from ~26-190 nm gridded onto 
1-Angstrom bins.

CURRENT VERSION:  11 (released 10/12)

See SEE_v11_releasenotes.txt for more information.

READING A FILE:  
You can use the IDL procedure read_netcdf.pro to read the 
SEE data products (or almost any NetCDF file).  Example 
usage follows.

  IDL> read_netcdf,'see__egs_L2_2003039_011_02.ncdf',d,att
where
  d = data read from the specified file
  att = string array listing the attributes (definitions)

  IDL> help, d, /structure    ; to list data structure

  IDL> n = n_elements(att)		; to print attributes
  IDL> for k=0,n-1 do print, att[k]

read_netcdf.pro can be found at
https://lasp.colorado.edu/data/timed_see/code/software/idl/netCDF/read_netcdf.pro

--------------------------------------------------
Special Software for EGS Level 2 Data Products
--------------------------------------------------

PLOTEGS_TS.PRO
--------------
This procedure will plot the time series (TS) for a 
specified wavelength range.  

USAGE:
  IDL>  plotegs_ts, start_date, end_date, 30.0, 40.0, directory=directory
				; reads all the level2 data files from start_date to 
				; end_date in directory and plot integrated data from 
				; 30-40 nm

plotegs_ts can be found at
https://lasp.colorado.edu/data/timed_see/level2_egs/plotegs_ts.pro

PLOTEGS_SP.PRO
--------------
This procedure will plot the median irradiance for one day.

  IDL>  plotegs_sp, date, directory=directory
				; reads the most recent file for date in directory
				; and plots the median spectrum

plotegs_sp can be found at
https://lasp.colorado.edu/data/timed_see/level2_egs/plotegs_sp.pro


--------------------------------------------------
Version History for EGS Level 2 Data Product
--------------------------------------------------
1.00  Pre-launch test version

2.00  Pre-launch revised test version

3.00  12/01  Early-operation version

4.00   5/02  Not a publicly available version.  Updated with 
corrections for the sensitivity related to the rocket 
calibration results, updated FOV maps, atmospheric absorption 
(essentially none), and to 1 AU. 

5.00  9/02  First public version.  Updated with algorithms to 
use in-flight FOV, in-flight second-order, responsivity, 
in-flight scattered light, in-flight flatfield, degradation/recovery.

6.00  3/03  See SEE_v6_releasenotes.txt for information.

7.00  7/04  See SEE_v7_releasenotes.txt for information.

8.00  6/05  See SEE_v8_releasenotes.txt for information.

9.00  4/07  See SEE_v9_releasenotes.txt for information.

10.00 7/09  See SEE_v10_releasenotes.txt for information.

11.00 10/12 See SEE_v11_releasenotes.txt for information.

--------------------------------------------------

The main SEE web page is:  http://lasp.colorado.edu/see

For SEE data access problems or suggestions, you can send 
e-mail to don.woodraska@lasp.colorado.edu or 
tom.woods@lasp.colorado.edu

--------------------------------------------------
END OF README FILE