Level 3 FITS file : Extension 0 (Results) - ITA-Solar/solo-spice-ql GitHub Wiki

Extension 0 - Results (Fit components and parameters)

An example of a level 3 FITS file can be found here

Data cube

This extension contains the results of the fit, performed by CFIT_BLOCK. Each parameter for each fit component is given for each pixel, where the dimensions are as follows:

  • Raster: Fit-parameters + Chi^2, X, Y
  • Sit-and_stare: Fit-parameters + Chi^2, X, Y, Time (where NAXIS2 = 1)

Fit parameters include the Chi-squared parameter as the last parameter.

General Keywords

SOLARNET = Fully/Partially/No SOLARNET compliant (1/0.5/-1)
OBS_HDU  = HDU contains (no) observational data or SOLARNET Type P data (0/1/2)

EXTNAME  = Extension name              
FILENAME = Filename    
PGFILENA = Progenitor filename    
PARENT   = Parent filename    
PGEXTNAM = Extension name in progenitor file      

RESEXT   = Extension name of results extension
DATAEXT  = Extension name of data extension (this is a link to an external extension)
XDIMXT1  = Extension name of 1st dimension absorbed by analysis
WGTSEXT  = Extension name of weights extension
INCLEXT  = Extension name of include extension
CONSTEXT = Extension name of constant extension

NXDIM    = Number of dimensions absorbed by analysis process
XDIMTY1  = CTYPE of 1st dimension absorbed by analysis    
NWIN     = Number of windows in level 3 file  
WINNO    = Window number (starting at 0) within this study in this level 3 file
LEVEL    = Data processing level     
VERSION  = File version number
DATE-BEG = Beginning of data acquisition
INSTRUME = Instrument name                                                                       
OBSRVTRY = Observatory name
CREATOR  = Name of creator

Keywords describing the whole ANA

ANA_NCMP = Number of fit components, Min=1, Max=99

Keywords describing each component

CMPTYPnn = Type of Fit component nn ('Polynomial', 'Gaussian', 'SSW comp_bgauss', 'SSW comp_voigt')  
CMPNAMnn = Name of component nn  
CMPSTRnn = Function string of component nn  
CMPDESnn = Description of component nn  
CMPMULnn = Indicates whether component nn is multiplicative  
CMPINCnn = Indicates whether component nn is included in the fit  
CMP_NPnn = Number of parameters for component nn ((n+1) for polynomials of order n, 3 for Gauss, 5 for broadened gauss, 4 for Voigt gauss, 1 for Chi-squared), Min 0, Max 27 ([ ,a,b...,z]).

Keywords describing each parameter in a component

PNAMEnna = Name of parameter a (letter) for component nn  
PUNITnna = Physical unit of parameter a (letter) for component nn  
PDESCnna = Description of parameter a (letter) for component nn  
PINITnna = Initial value of parameter a (letter) for component nn  
PVALnna  = Value of parameter a (letter) for component nn  
PMAXnna  = Maximum value of parameter a (letter) for component nn  
PMINnna  = Minimum value of parameter a (letter) for component nn  
PTRNAnna = Linear transformation coefficient A of parameter a (letter) for component nn in (e.g, Lambda = PRVALnna * PRTRAnna + PRTRBnna)  
PTRNBnna = Linear transformation coefficient B of parameter a (letter) for component nn in (e.g, Lambda = PRVALnna * PRTRAnna + PRTRBnna)  
PCONSnna = Indicates whether parameter a (letter) for component nn is constant

World Coordinate System (WCS) keywords

WCSNAME = Name of coordinate system                                            
LONPOLE = Native longitude of the celestial pole                                             
SPECSYS = Spectral coord. not corrected for S/C velocity                                               
VELOSYS = [m/s] Default for SPECSYS='TOPOCENT'                                               

CTYPE1   = Type of 1st coordinate (fit parameter)                        
CNAME1   = Name of 1st coordinate                        
CUNIT1   = Units for 1st coordinate (for CRVAL1, CDELT1)  
CRVAL1   = [] 1st coordinate of reference point          
CDELT1   = [] Increment of 1st coord at ref point        
CRPIX1   = [pixel] 1st pixel index of reference point    
PC1_1    = Contribution of dim 1 to coord 1                    
                                                                            
CTYPE2   = Type of 2nd coordinate                        
CNAME2   = Name of 2nd coordinate  
CUNIT2   = Units for 2nd coordinate (for CRVAL2, CDELT2)  
CRVAL2   = [arcsec] 2nd coordinate of reference point    
CDELT2   = [arcsec] Increment of 2nd coord at ref point  
CRPIX2   = [pixel] 2nd pixel index of reference point    
PC2_2    = Contribution of dim 2 to coord 2   
PC2_3    = Contribution of dim 3 to coord 2  
                                                                            
CTYPE3   = Type of 3rd coordinate                        
CNAME3   = Name of 3rd coordinate  
CUNIT3   = Units for 3rd coordinate (for CRVAL3, CDELT3)  
CRVAL3   = [arcsec] 3rd coordinate of reference point    
CDELT3   = [arcsec] Increment of 3rd coord at ref point  
CRPIX3   = [pixel] 3rd pixel index of reference point    
PC3_2    = Contribution of dim 2 to coord 3 due to roll  
PC3_3    = Contribution of dim 3 to coord 3  
                                                                            
CTYPE4   = Type of 4th coordinate                         
CNAME4   = Description of 4th coordinate                  
CUNIT4   = Units for 4th coordinate (for CRVAL4, CDELT4)  
CRVAL4   = [s] 4th coord of ref point, relative to DATEREF  
CDELT4   = [s] Increment of 4th coord at ref point        
CRPIX4   = [pixel] 4th pixel index of reference point     
PC4_2    = Contribution of dim 2 to coord 4 due to roll  ; _optional, only for rasters_  
PC4_4    = Contribution of dim 4 to coord 4                    

BTYPE    = Type of data                                   
UCD      = Unified Content Descriptors v1.23           
BUNIT    = Physical units of calibrated data

Processing steps

All processing steps up to level 2 are included in this header. Additionally, at least two more processing steps are added during the creation of the level 3 file. E.g.:

PRSTEP11 = 'PEAK-FINDING'       /  Processing step type, step 11                 
PRPROC11 = 'spice_gt_peaks'     /  Name of procedure performing PRSTEP11         
PRPVER11 =                    1 /  Version of procedure PRPROC11                 
PRLIB11  = 'solarsoft/so/spice/idl/quicklook' /  Software library containing PRPR  
                                                                        
PRSTEP12 = 'LINE-FITTING'       /  Processing step type, step 12                 
PRPROC12 = 'spice_data::create_l3_file' /  Name of procedure performing PRSTEP12  
PRPVER12 =                    8 /  Version of procedure PRPROC12                 
PRLIB12  = 'solarsoft/so/spice/idl/quicklook' /  Software library containing PRPR  
PRPARA12 = 'LINE_LIST = 0,                                                     &'  
CONTINUE   'MASKING   = 1,                                                     &'  
CONTINUE   'FITTING   = 1,                                                     &'  
CONTINUE   'POSITION  = 0,                                                     &'  
CONTINUE   'VELOCITY  = -999,                                                  &'  
CONTINUE   'POSSIBLE_MANUAL_EDITING = 0' /  Parameters for PRPROC12

History

The history up to level 2 is included in this header. Additionally, the history of the creation of this level 3 file is added. This includes a list of functions that were called to create the level 3 file. E.g.:

HISTORY ANA:  > SPICE_CREATE_L3_DRIVER > SPICE_DATA::CREATE_L3_FILE