# file: xrcf_data.fmt in ~dd/idl/xrcf/ # # This file is the definition and long-winded discussion # of the ASCII tab-delimited file containing # xrcf analysis results related to Effective Area # and grating Efficiency. For rdb compatability, # the first two rows contain column names and # column data widths(for printing only) and types # (N = numeric, S = string, M=month) # # Each row is one effective area/efficiency measurement # for a given energy-order-configuration-analysis_method. # # This is basically an interface format # allowing level 2 results to be uniformly collected # for level 3 analysis. # # HRMA-no_grating # data is entered in this format with grating = NONE # and order = 999 (no grating present) and "efficiency" # would not be filled in. # # BUMP vs LINE # I make a distinction between the "bump" that is # measured (e.g. from FPC histogram) and the "line" that # the entry (row) is for. See the Ti information at # http://space.mit.edu/HETG/xrcf_sources/sources.html for # example... As fitting evolves from ROI to XSPEC # this distinction may not matter - but even the focal # plane with a grating and aperture may or not contain # satellite lines. # # RAW DATA # The raw data is recorded as counts (in the bump), # error, and time. Plus and minus errors are provided # for the focal plane to allow upper/lower limits that # may not be symmetrical. # # SLIGHTLY PROCESSED # The raw data can be turned into a flux and a focal # plane rate. The value "flux" is in "photons_in_line / s cm^2", # (thus compensated for escaped photons, monitor detector # efficiency, fraction in line, and detector area.) # The focal plane rate is photons_in_line in aperture / s # and so includes these effects (except for physical area) # as well. # # FINAL PRODUCTS # The optical system effective area in cm^2 and the # grating effective efficiency are the two final # products. The focal-plane detector QE, counts/photon, # is available so that the system detection area, # cm^2 counts/photon, can be calculated (most useful # for flight instruments.) # # BLANK FIELDS # For a string type field any non-TAB entry is possible. # For numeric fields, if left blank or if containing a "/" # (as in n/a N/A) the field will readin as 0.0 # by rdb_read.pro. # #. . . . . . . . . . . . revision history . . . . . . . . . . . . . . # modified 3/19/97, 3/20/97 after talking with Dick Edgar # and Dave Davis; 3/26/97 after playing around with it. # 4/3/97 modified after talking with Herman, Dave and doing a 2C test case. # 4/22/97 change run_id to a string (allow ,s and -s in it too) # . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . # # The column definitions are: # # - - - - - These first columns have the configuration and - - - - - - - - # results in them , if only these were filled in # we could have s/w to plot results vs predictions etc. # # Configuration: (because the TRW ID can be used to point into the # req_run cmdb to get other details - only those # most relevant to EA analysis are included here.) # 1 trw_id : E-HXF-3D-10.002 # 2 energy : 4.510 # 3 wavelength : 2.749 # 4 source (and filter) : Ti-Ka,TiKx2 (useful to flag EIPS vs DCM,HIREFS) # 5 shutters : {MEG,ALL} ( same as in CMDB ) # 6 grating : MEG ( For a specific order measurement # this field will generally be LEG, # MEG, or HEG. For 0 order it could # be HETG or HEG+MEG, MEG+HEG. # As in the CMDB no grating is NONE ) # 7 order : +1 ( 999 for no grating ) # 8 fp_detector : FPC ( FPC SSD HSI 2C0 2C1 HRC-I HRC-S ACIS ) # 9 fp_aperture : 2000 ( fp diameter over which the measurement is made, # this may be s/w defined for imaging detectors ) # Efficiency result #10 effic : 0.0935 ( effective efficiency for the nominal mirror shells ) #11 effic_err_plus : 0.0028 ( 1 sigma values ) #12 effic_err_minus : 0.0028 #13 effic_syst plus : ( systematic error estimate given #14 effic_syst minus : as two-sided ) #15 effic_method : GIGO ( GIGO - grating in / grating out ) # ( KHA - known HRMA area ) # ( RTOM - Relative to other measurement ) #16 reference_value : 195.3 ( cm^2 , for relevant shutter config., e.g., # here the ref is for {ALL,ALL} so factor of 0.568 # was used to convert to {MEG,ALL}.) #17 reference_id : E-IXF-3D-9.001, *0.568 ( this gave 343 cm^2 for ALL,ALL compared # to expected ~470 cm^2 ) # # Effective area result #18 effective : 18.28 ( cm^2 ) #19 effective_err_plus : 0.38 #20 effective_err_minus : 0.38 #21 effective_syst plus : 0.95 ( systematic errors - BND calibration only to 5% ?) #22 effective_syst minus: 0.95 #23 effective_method : BNDREF ( BNDREF - uses BND area and counts # to determine effective area. ) # Reference information #24 analyst : dd ( some strings to allow different analyses #25 analysis_date : 970326 to be separated ) #26 memo_file : http://space.mit.edu/HETG/xrcf_sources/sources.html#Ti #27 comment_string : there's a lot of data # # - - - - - - - - - Data specifics - - - - - - - # Time of focal plane measurement start #28 irig : 034:15:10:52.639 ( of focal plane data set ) # # HXDS data information #29 mst_date : 970203 ( MST date code ) #30 run_id : 111123 ( MST run_id, can be range # 111123-111125 or comma # separated. ) #31 iteration : 0 ( can be range or comma sep'ed. ) # # 2C/HRC/ACIS data information strings #32 data_string_1 : N/A ( strings needed in addition to above #33 data_string_2 : N/A in order to automatically find the data # for example, for the 2C we need # the 2c date code and the sequence "s1.1" ) # # - - - - - - - - - Analysis details - - - - - - # Focal plane line counts #34 focal_line : 893.7 ( photons / sec in "line" in aperture ) #35 focal_line_plus : 5.3 ( 1 sigma plus line-fraction # errors, continuum fraction in aperture ) #36 focal_line_minus : 5.3 ( 1 sigma minus lin-fraction error ) #37 focal_qe : 0.848 ( bump-counts / photon, for informational use, more # important with a non-FPC focal plane detecotor. ) #38 focal_method : Ka=0.74, escape=0.078, qe=0.92 ( description or pointer to information... ) #39 focal_counts : 28071. ( counts in the "bump" ) #40 focal_err_plus : 167. ( generally 1 sigma values, plus and minus #41 focal_err_minus : 167. because low counts may be asymmetric in error ) # Also apertures may have uncertainties in amount # of satellite lines etc. in them. ) #42 focal_time : 27.4 #43 focal_analysis : ROI, 130-220, no-escape ( ROI GAUSS XSPEC etc. with useful # additional strings ) # HRMA Flux #44 flux : 48.87 ( line-photons / s cm^2 at HRMA ) #45 flux_err : 0.22 ( systematic errors go in effective area errors ) #46 flux_method : N, a=32.26, qe=0.92, escape=0.078, Ka=0.74 # ( description of flux algorithm and constants used or # pointer to doc or s/w ) # BND FPC information #49 fpc_ht_counts : ( counts in the "bump" ) #50 fpc_ht_err : #51 fpc_ht_time : ( live time in s ) #52 fpc_hn_counts : 49406. ( count in the "bump" ) #53 fpc_hn_err : 222. #54 fpc_hn_time : 27.34 ( live time in s ) #55 fpc_hn_aperture : ALL ( ALL (32.26 cm^2) or 36 (9.2 cm^2), as in CMDB talk ) #56 fpc_hb_counts : ( count in the "bump" ) #57 fpc_hb_err : #58 fpc_hb_time : ( live time in s ) #59 fpc_hs_counts : ( count in the "bump" ) #60 fpc_hs_err : #61 fpc_hs_time : ( live time in s ) #62 fpc_5_counts : ( count in the "bump" ) #63 fpc_5_err : #64 fpc_5_time : ( live time in s ) #65 fpc_5_aperture : #66 fpc_analysis : ROI, 130-240, no-escape ( ROI GAUSS XSPEC etc. w/string ) # # SSD 500 information #67 ssd_5_counts : 8487. ( count in the "bump" ) #68 ssd_5_err : #69 ssd_5_time : 26.94 ( live time in s ) #70 ssd_5_aperture : #71 ssd_5_analysis : ROI, 800-930, Ka ( ROI(no escape) GAUSS XSPEC etc.)