Inter-Instrument Transformation
The goal of the inter-instrument correction is to equate the intensities from one instrument to the intensities of another. The choice of which instrument to use as the "reference instrument" is an updatable parameter.
Examples of Corrected Images
These images of before and after applying IIT are from the different instruments at Carrington Rotation 2108.59. These can be enlarged by clicking image titles.
AIA Images
Original AIA Image | Corrected AIA Image | Difference AIA Image |
---|---|---|
EUVI-A Images
Original STA Image | Corrected STA Image | Difference STA Image |
---|---|---|
EUVI-B Images
Original STB Image | Corrected STB Image | Difference STB Image |
---|---|---|
Examples of Histograms
200 Intensity Bin Histograms before and after IIT Correction.
LBC Corrected Histogram | IIT Corrected Histogram |
---|---|
Analysis Pipeline
Compute Histograms and Save to Database
This function applies the limb-brightening correction, calculates the associated IIT histogram, and saves these histograms to the database.
The source code and example usage for this is found in the CHD GitHub
and the generalized function can be found here.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
|
- 1.)
db_funcs.query_euv_images
- queries database for images (from EUV_Images table) in specified date range
- 2.)
db_funcs.query_inst_combo
- queries database for closest image combinations to date observed
- 3.)
lbcc_funcs.apply_lbc
- applies Limb-Brightening Correction to images and creates LBCCImage datatype
- 4.)
psi_d_types.LBCCImage.iit_hist
- calculates IIT histogram from LBC corrected data
- 5.)
psi_d_types.create_iit_hist
- creates IIT histogram datatype
- 6.)
db_funcs.add_hist
- saves histograms to database (table Histogram) associating an image_id, meth_id, and basic information with histogram
Calculate and Save Correction Coefficients
This function queries the database for IIT histograms, calculates correction coefficients, and saves them to the database.
The source code and example usage for this is found in the CHD GitHub
and the generalized function can be found here.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
|
- 1.)
db_funcs.query_euv_images
- queries database for euv images for the reference instrument
- used to get a range of Carrington rotation for which to calculate fit coefficients
- 2.)
db_funcs.query_hist
- queries database for histograms (from Histogram table) in specified date range
- 3.)
db_funcs.query_euv_images_rot
- queries database for euv images by Carrington rotation range
- 4.)
iit.optim_iit_linear
- use linear optimization method to calculate fit parameters
- hist_ref and hist_fit are the reference histogram and the instrument histogram for the fit
- these are determined using boolean indexing
- 5.)
db_funcs.store_iit_values
- save the two fit coefficients to database using function store_iit_values
- creates image combination combo_id of image_ids and dates in Images_Combos table
- creates association between each image_id and combo_id in Image_Combo_Assoc table
- creates new method “IIT” with an associated meth_id in Meth_Defs table
- creates new variable definitions "alpha and "x"" with an associated var_id in Var_Defs table
- store variable value as float in Var_Vals table with associated combo_id, meth_id, and var_id
- save the two fit coefficients to database using function store_iit_values
Apply Inter-Instrument Transformation and Plot New Images
This function queries the database for IIT coefficients, applies the correction, and plots resulting images.
The source code and example usage for this is found in the CHD GitHub
and the generalized function can be found here.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
|
- 1.)
db_funcs.query_euv_images
- queries database for images (from EUV_Images table) in specified date range
- queries for reference instrument to get minimum and maximum Carrington rotation
- 2.)
db_funcs.query_euv_images_rot
- queries for instrument in question based on Carrington rotation range
- 3.)
db_funcs.query_inst_combo
- queries database for closest image combinations to date observed
- does this for both the LBC and IIT methods
- 4.)
lbcc_funcs.apply_lbc
- applies Limb-Brightening Correction to images and creates LBCCImage datatype
- 5.)
apply_iit
- applies Inter-Instrument Transformation Correction to images and creates IITImage datatype
- 6.)
Plotting.PlotCorrectedImage
- plots LBC images, IIT corrected images, and the difference between them
Apply IIT
This is a sub-step that applies the Inter-Instrument Transformation Correction to individual image and returns the correct IIT Image. It is called during the third step of Inter-Instrument Transformation.
1 2 3 4 5 6 7 8 9 10 11 12 13 |
|
- 1.)
db_funcs.get_method_id
- queries database for method id associated with method name
- 2.)
db_funcs.query_var_val
- queries database for variable values associated with specific image (from Var_Vals table)
- 3.)
corrected_iit_data[use_indices] = 10 ** (alpha * np.log10(lbcc_data[use_indices]) + x)
- applies correction to image based off alpha, x, and lbcc corrected data arrays
- 4.)
psi_d_types.create_iit_image
- create IIT Image datatype from corrected IIT data
Generate Histogram Plots
This function generates histogram plots comparing data from before and after the IIT correction.
The source code and example usage for this is found in the CHD GitHub
and the generalized function can be found here.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
|
- 1.)
db_funcs.query_hist
- queries database for histograms (from Histogram table) in specified date range
- 2.)
db_funcs.query_euv_images
- queries database for images (from EUV_Images table) in specified date range
- 3.)
db_funcs.query_inst_combo
- queries database for closest image combinations to date observed
- does this for both the LBC and IIT methods
- 3.)
lbcc_funcs.apply_lbc
- applies Limb-Brightening Correction to images and creates LBCCImage datatype
- 4.)
psi_d_types.LosImage.iit_hist
- create 1D IIT Histogram from original LOS image data
- 5.)
apply_iit
- applies Inter-Instrument Transformation Correction to images and creates IITImage datatype
- 6.)
psi_d_types.IITImage.iit_hist
- create 1D IIT Histogram from corrected IIT image data
- 7.)
Plotting.Plot1d_Hist
- plot 1D Normalized IIT Histograms for original, LBC, and IIT data