% Time-stamp: <2002-09-09 09:46:01 dph> 
% MIT Directory: ~dph/h2/ASC/ARD/ICD
% CfA Directory: /dev/null
% File: CO_ARD_ICD.txt
% Author: D. Huenemoerder
% Original version: 981002
%====================================================================

DocID: dph003  ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD


Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981002
Submitted_by:   Larry David
Item number:    dph003.0001
Page:           19
                
Problem:        Coefficient vs energy fit will be a cubic spline.
		A table of coefs will be provided.
                
Dependencies:   none

Reply:          ...as proposed.
                
Due Date:       -

Status:         CLOSED. 
		no change.


%%%%%%%%%%	%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981002
Submitted_by:   Larry David
Item number:    dph003.0002
Page:           17, 18
                
Problem:        Are individual shell's vignetting fits really
		required? So far, all, 1&3, 4&6 have been fit.
                
Dependencies:   Cal model details.

Reply:          Probably not.  If there are no other objections, I
		will delete the single-shell extensions from the
		specified file format.
		981022: objection: need individual shells, since get
		weighted by grating effic. prior to summing.
		990219 Cal/MST are generating denser table - 70
		  angles, 1000 energies (and each shell?) ==> use
		  tables instead of model.
                
Due Date:       981023

Status:         Pending update of DRAFT 1.1.
		981018 Noted as an unresolved issue.
		981215 Query to Cal: - still an open issue - carried
		       to v1.2
		990308 defined as table for each shell.
		CLOSED.


%%%%%%%%%%%%%
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981006
Submitted_by:   Joel Kastner
Item number:    dph003.0003
Page:           5,6,7,10
                
Problem:        clarify text, fix typos, as per markup
                
Dependencies:   none

Reply:          OK.
                
Due Date:       981023

Status:         Accept. Pending update of DRAFT 1.1
		981020 Done.
		CLOSED

%%%%%%%%%%      
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981006
Submitted_by:   Joel Kastner
Item number:    dph003.0004
Page:           8,9
                
Problem:        HDU tables: No principal HDUs denoted via "(*)".
		981020 Done.
                
Dependencies:   -

Reply:          OK.
                
Due Date:       981023

Status:         Accept.  Pending update.
		981018 Done.
		CLOSED

%%%%%%%%%%      
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981006
Submitted_by:   Joel Kastner
Item number:    dph003.0005
Page:           8
                
Problem:        Suggest splitting each extension into separate file
		(per device), as for uniformity images.
                
Dependencies:   none

Reply:          Seems sensible.  Will consider.  Discuss.
                
Due Date:       981023

Status:         Tentatively accepted, pending discussion.
		981016: Discussed.  Instead of splitting, join.
		981018: changed device file into extensions. Added
		EXTVER. 
		CLOSED

%%%%%%%%%%      
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981006
Submitted_by:   Joel Kastner
Item number:    dph003.0006
Page:           11,12
                
Problem:        Sizing estimates inconsistent w/ file definitions.
		Numbers of files not explained.
                
Dependencies:   none

Reply:          Will review and fix as necessary.
                
Due Date:       981023

Status:         pending update of draft 1.1
		981020 Done.
		CLOSED
                
%%%%%%%%%%      
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981006
Submitted_by:   Joel Kastner
Item number:    dph003.0007
Page:           22
                
Problem:        Clarify windows as per markup.
                
Dependencies:   none

Reply:          OK.
                
Due Date:       981023

Status:         Accepted. Pending update.
		981020 Done.
		CLOSED
                
%%%%%%%%%%      
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981006
Submitted_by:   Joel Kastner
                
Item number:    dph003.0008
Page:           27
                
Problem:        Paragraph misplaced.
                
Dependencies:   none

Reply:          Will move to before section 11.1 where it belongs.
                
Due Date:       981023

Status:         Accepted. Pending update.
		981020 Done.
		CLOSED
                
                
%%%%%%%%%%      
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981007
Submitted_by:   dph
Item number:    dph003.0009
Page:           5-12
                
Problem:        Talked to Mark Bautz.  They are modeling QE
		uniformity. At low energy, all noise (i.e.,
		uniform). At higher energies, looks like:

		   Q(E,x,y) = K * exp( -A(x,y) / lambda(E) )
		     A(x,y) are depeletion depths, large scale
		       fluctuations (> 32x32 pixels).
                     lambda(E) is absorption scale length; can
                       possibly be parameterized in this energy range
                       by a power-law.

		 Mark will deliver A(x,y), lambda(E) if we want.

		 But for BI: need empirical table of QE, as defined.

		 He will review the ICD.
                
Dependencies:   IPI model and product delivery, use in exposure map
		code. 

Reply:          consider new format or function for FI
		non-uniformity. 
                
Due Date:       981130

Status:         pending review.  If new product, not until v.1.3.
		981020  Included as unresolved issue.
		981215 held mtg w/ fkb, bm, jed 12/11; still pending;
		       fkb studying.  carried into 1.2
                990218 met w/ fkb (weeks ago) - abs. model will be
                       done.  Revise ARD to be table of abs coef and
                       function.
		       carried to v1.2
		       revise in v1.3
		990308 revised to depletion depth table and
		       functional.
		CLOSED.

#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981009
Submitted_by:   D.Huenemoerder
Item number:    dph003.0010
Page:           28
                
Problem:        Multiple extensions should have EXTNAME the same w/
		EXTVER as an index, and HDUNAME = EXTNAME<EXTVER>;
		e.g., RM, 1, RM1.
                
Dependencies:   ASC FITS guide

Reply:          make it so.
                
Due Date:       981023

Status:         accepted, pending edit of DRAFT 1.1.
		981020 Done.
		CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981020
Submitted_by:   D.Huenemoerder
Item number:    dph003.0011
Page:           28
                
Problem:        PI_lo, PI_hi should be energy_lo, energy_hi
                
Dependencies:   tg_resolve_events

Reply:          make it so.
                
Due Date:       981023

Status:         accepted, pending edit of DRAFT 1.1.
		981020 Done.
		CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981021
Submitted_by:   D.Huenemoerder for A.Rots
Item number:    dph003.0012
Page:           28
                
Problem:        IRM extension is really an "EBOUNDS" extension. Its
		name should be changed
                
Dependencies:   tg_resolve_events

Reply:          Well, as defined, the ENERGY_LO, ENERGY_HI columns are
                DELTAS from the ENERGY column, and are not absolute
                limits.   We should either leave it as is, or change
                to absolute energy limits (and alter the functioning
                tg_resolve_events) 
                
Due Date:       981130

Status:         Pending further discussion,
		for possible adoption in v1.2.
		Comments added to v1.1 as "Notes".

		981215: Done:
			Implemented in "R4C2.0  Monday, December 7,
		        1998" as IRM.  Is not EBOUNDS, but upper/lower
		        deviations from nominal, as energy, energy_lo,
		        energy_hi. 
		CLOSED
		


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981021
Submitted_by:   D.Huenemoerder for A.Rots
Item number:    dph003.0013
Page:           
                
Problem:        The two HESF files should be combined into one, w/ 2
		extensions.   Uncertainty extension should become an
		uncertainty column in the efficiency extension.
                
Dependencies:   none

Reply:          agree
                
Due Date:       981123

Status:         Accept for v1.1
		981021 Done.
		CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981022
Submitted_by:   D.Huenemoerder
Item number:    dph003.0014
Page:           
                
Problem:        Combined shell areas is of dubious use.
		Use for gratings first weights by TG effic before
		combining. Recommend deletion of 1+3, 4+6 in both HRMA
		products. 
                
Dependencies:   none

Reply:          agree
                
Due Date:       981123

Status:         Accept for v1.1
		981022 Done.
		CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           981022
Submitted_by:   D.Huenemoerder
Item number:    dph003.0015
Page:           32
                
Problem:        There should be 3 files, HEG, MEG, and LEG.
                
Dependencies:   none

Reply:          agree
                
Due Date:       981123

Status:         Accept for v1.1
		981022 Done.
		CLOSED



#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.1 DRAFT
Date:           990129
Submitted_by:   D.Huenemoerder
Item number:    dph003.0016
Page:           ?
                
Problem:        Add products relevant to HRC-S vignetting:
		filter transmissions, mirror areas, detector
		geometry.
		990218: products needed:
			hrc-s geometry (where filter boundaries are)
			hrma geometry (shell front, back, radii)
			filter transmissivities (?)
                
Dependencies:   none

Reply:          need for LETGS ARFs
                
Due Date:       990215

Status:         accept for v1.3
		990308 - added filter transmission efficiencies.
		990310 - added parameter tables.
		CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.2
Date:           990219
Submitted_by:   D.Huenemoerder
Item number:    dph003.0017
Page:           various
                
Problem:        Need to include CALDB keywords.
		Also add file-name templates.
                
Dependencies:   caldb.txt v1.3 or greater.

Reply:          yes.
                
Due Date:       990215

Status:         990308 - done - added subsections for file name, caldb keys.




#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3 --- 10 march 99
Date:           990312
Submitted_by:   D.Dewey
Item number:    dph003.0018
Page:           26
                
Problem:        bottom of page 26 should be something like "HRC will
		need QE function for each MCP-filter combination for 7
		extensions."

Dependencies:   none

Reply:          roger that.
		990325 fixed.
                
Due Date:       990319

Status:         990326 CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder, J.Davis
Item number:    dph003.0019
Page:           6,7
                
Problem:        Need bad-pixels in QE equation.
                
Dependencies:   expmap

Reply:          Will add term to Eqs.1,4.
		990610 done.
                
Due Date:       990721

Status:         990610 CLOSED.

#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder, J.Davis
Item number:    dph003.0020
Page:           p.10,11
                
Problem:        Clumsy QE file structure.	
		Better as 3 columns,		E, QE, sigma
                Drop ACIS quadrants -- will come from uniformity.
		Move error extension into HDU with QE.

Dependencies:   expmap tools

Reply:          do it.
		990610 done.
                
Due Date:       990721

Status:         990710 CLOSED

#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder, F.Baganoff
Item number:    dph003.0021
Page:           6
                
Problem:        ACIS QE uniformity cannot be modeled by depletion
		depth  vs position.
		Revise section.
                
Dependencies:   expmap

Reply:          ok.
                
Due Date:       990721

Status:         990615 CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder
Item number:    dph003.0022
Page:           various
                
Problem:        Add SHELL to CBD keywords, where appropriate.
                
Dependencies:   expmap tools

Reply:          ok.
                
Due Date:       990721

Status:         990615 CLOSED

#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder
Item number:    dph003.0023
Page:           64
                
Problem:        Need to add HESF/HRC-S params to HRS-S param file;
		params are thosed used for HESF mask calculation.
                
Dependencies:   tg_create_mask

Reply:          ok.
                
Due Date:       990721

Status:         990615 CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder, J.Davis
Item number:    dph003.0024
Page:           14
                
Problem:        Pending knowledge of HRC-S uniformity details, add
		HRC-S uniformity images vs energy, similar to HRC-I
		uniformity image(s).  Makes analogous to Discrete QE
		(see p.23, and CO-dph003.0025 below)
                
Dependencies:   expmap tools

Reply:          Will do.  Put a note on the HRC-S QE uniformity
		section that that format is tentative and might not be
		used in lieu of the image and linear interpolation.

		Also included revised HRC-I, HRC-S format, made
		generic to apply to ACIS, as well.

		990610 Issue: how to specify spatial grid on image
		column. 

Due Date:       990721

Status:         990611 CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder
Item number:    dph003.0025
Page:           23
                
Problem:        Discrete QE has clumsy format.  Add energy grid as
		another column instead of an extension.
                
Dependencies:   expmap tools

Reply:          ok.  
                
Due Date:       990721

Status:         990611 CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder, J.Davis
Item number:    dph003.0026
Page:           28
                
Problem:        On-axis format is not same as OGIP.  Adopt OGIP
                format, which will make same as vignetting file.  For
                on-axis, theta,phi grids will not be present. Area
                will be stored as a 3D image, w/ two axes of 0 size.
                
Dependencies:   expmap tools.

Reply:          ok.
                
Due Date:       990721

Status:         990611 CLOSED.



#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder, J.Davis
Item number:    dph003.0027
Page:           31
                
Problem:        Off-axis area is not OGIP compliant.  To adopt, put
		theta, phi, and energy grids into array columns.  Make
		sure energy is first (fastest) index, then theta, phi
		(and add TDIMn keyword).  Also need to extrapolate CIP
		points to make a uniform grid (interpolate-able).
		Will also make same as on-axis format, but for
		non-null axes.
                
Dependencies:   expmap tools

Reply:          ok.
                
Due Date:       990721

Status:         990610 CLOSED.


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder, J.Davis
Item number:    dph003.0028
Page:           35
                
Problem:        Vignetting function is not OGIP compliant.  Adopt OGIP
		format.
                
Dependencies:   expmap tools

Reply:          See .0026 and .0027.  These 3 changes will make
		on-axis area, off-axis area, and vignetting have same
		form. 
                
Due Date:       990721

Status:         990610 CLOSED.


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder
Item number:    dph003.0029
Page:           42
                
Problem:        Need new format: cast as a REGION by
		making ENERGY_LO and ENERGY_HI absolute energies,
		instead of differences from nominal.   (EBOUNDS isn't
		quite appropriate, because EBOUNDS maps a "CHANNEL" to
		E_MIN, E_MAX.)
                
Dependencies:   expmap tools; tg_resolve_events, if current IRM format
		is phased out.

Reply:          OK.
                
Due Date:       990721

Status:         OPEN

#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder, J.Davis
Item number:    dph003.0030
Page:           46
                
Problem:        Difficult format - need to figure out which array
		element is for a given order, and can't get vector vs
		energy easily.  Revise to enumerate order in a column,
		then have array columns of energy, efficiency, and
		uncertainty. (this also puts all information in one
		row, so the uncertainty HDU doesn't have to be
		found, if needed).
                
Dependencies:   expmap tools.

Reply:          990610, J.Davis: actually, proposed revision would
		require the energy grids to be replicated on each
		row. This would be a waste of space, since they are
		all identical.  Keep current format.

		Revised to put uncertainties in same HDU as an
		additional array column.
                
Due Date:       990721

Status:         990611 CLOSED.


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder, J.Davis
Item number:    dph003.0031
Page:           51
                
Problem:        HESF efficiency: revise format to array colunms.
		Reduces HDUs needed.  Add a THETA (incident angle)
		column.
                
Dependencies:   expmap tools.

Reply:          ok.
                
Due Date:       990721

Status:         990615 CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder
Item number:    dph003.0032
Page:           54
                
Problem:        Filter transmission: better format would be using
		array columns, so can eliminate HDU's for
		uncertainties.
                
Dependencies:   expmap tools

Reply:          ok.
                
Due Date:       990721

Status:         990615 CLOSED



#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990607
Submitted_by:   D.Huenemoerder
Item number:    dph003.0033
Page:           various
                
Problem:        need to accomodate asymmetric statistical and
		systematic errors.  Use STAT_MIN, STAT_MAX, SYS_MIN,
		SYS_MAX (as per OGIP CAL/GEN/92-003, version 1995 Jul
		11, section 9) .
                
Dependencies:   

Reply:          
                
Due Date:       990721

Status:         990615 CLOSED


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990614
Submitted_by:   A.Dobrzycki
Item number:    dph003.0034
Page:           10,12,54
                
Problem:        HRC-S chip_id's are 1,2,3 (not 0,1,2)
                
Dependencies:   hrc-L1 data; expmap tools

Reply:          ok.
                
Due Date:       990721

Status:         990614 CLOSED.


#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990614
Submitted_by:   A.Dobrzycki
Item number:    dph003.0035
Page:           p.15
                
Problem:        chipx, chipy should not be floats, but ints.
                
Dependencies:   hrc, acis L1

Reply:          ok.  Table in question is obsolete.
                
Due Date:       990721

Status:         990614 CLOSED.

#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990614
Submitted_by:   A.Dobrzycki
Item number:    dph003.0036
Page:           various
                
Problem:        energy should not have TLMIN, TLMAX applied.
                
Dependencies:   

Reply:          ok
                
Due Date:       990721

Status:         990615 CLOSED



#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.6
Date:           2002.09.10
Submitted_by:   D.Huenemoerder
Item number:    dph003.0037
Page:           tbd
                
Problem:        Need to add ACIS contamination data.
                
Dependencies:   ardlib (mkarf, mkgarf, mkinstmap)

Reply:          
                
Due Date:       2002.09.23

Status:         OPEN







#######################################  CO  TEMPLATE ###############
#############
Regarding:      ARD for Exposure Maps and Grating L1.5-2 Pipelines ICD
Version:        1.3
Date:           990614
Submitted_by:   D.Huenemoerder
Item number:    dph003.00nn
Page:           
                
Problem:        
                
Dependencies:   

Reply:          
                
Due Date:       990721

Status:         OPEN



hrma: omit bin columns

hrc-i qeu: make same format as acis-i (don't need regions, var length
      arrays)

hrc-s qeu: change to hrc-s mcp qeu, 
           regions too hard w/ qe*uvis;

hrc-s uvis: separate files.



2000.07.18


   new ard: letgs filter  

e.g.: 
** Structure <32a970>, 12 tags, length=104, refs=1:
   ROW_IDX         INT              1
   ROW_ID          STRING    'SOURCE         '
   SHAPE           STRING    'polygon         '
   TG_R            FLOAT     Array[7]
   TG_D            FLOAT     Array[7]
   R               FLOAT     Array[2]
   ROTANG          FLOAT           0.00000
   TG_PART         INT              0
   TG_SRCID        INT              0
   TG_M            INT             -1
   BACKSCAL        FLOAT           1.00000
   COMPONENT       INT              3 
  
   MTYPE is dispang   for MFORM tg_R,tg_D