Select Git revision
metis_l2_prep_vl_generic.pro
-
Roberto Susino authoredRoberto Susino authored
metis_l2_prep_vl_generic.pro 8.32 KiB
pro metis_l2_prep_vl_generic
; keyword defining if the detector reference frame must be used for the output
ref_detector = 0
; start the log
journal,'output/metis_l2_prep_log.txt'
; read the auxiliary file - here we have all the inputs we need
input = json_parse('input/contents.json', /toarray, /tostruct)
; load the spice kernels
load_spice_kernels, input.spice_kernels, kernel_list = kernel_list, kernel_version = kernel_version
journal, 'SPICE kernel files correctly loaded:'
journal, ' SDK version= ' + kernel_version
; read the calibration package
cal_pack = json_parse(input.cal_pack_path + '/index.json', /toarray, /tostruct)
; include the calibration package path into the cal_pack structure
cal_pack = create_struct('path', input.cal_pack_path + path_sep(), cal_pack)
journal, 'Calibration package correctly imported:'
journal, ' version = ' + cal_pack.version
journal, ' validity range = ' + string(cal_pack.validity_range.start, cal_pack.validity_range._end, format = '(A, "-", A)')
; read the primary hdu
data = mrdfits(input.file_name, 0, primary_header, /silent)
; read the quality matrix
quality_matrix = mrdfits(input.file_name, 'quality matrix', /silent)
; convert the string header into an idl structure
header = fits_hdr2struct(primary_header)
journal, 'L1 FITS file correctly read:'
journal, ' filename = ' + file_basename(input.file_name)
journal, ' datatype = ' + string(header.datatype, format = '(I0)')
journal, ' sess_num = ' + header.sess_num
journal, ' obj_cnt = ' + string(header.obj_cnt, format = '(I0)')
journal, ' pol_id = ' + string(header.pol_id, format = '(I0)')
journal, ' nbin = ' + string(sqrt(header.nbin), format = '(I0)')
; calibration block
file_name_fields = strsplit(header.filename, '_', /extract)
; error is the quadratic relative error
error = 0.
case header.datatype of
0 : begin
data = double(data)
; ====================================
; for old l1 data
; data = data * header.nbin * header.ndit
; header.xposure = header.xposure * header.ndit
; header.nsumexp = header.ndit
; ====================================
data = metis_dark_vlda(data, header, cal_pack, error = error, quality_matrix = quality_matrix, history = history)
; ====================================
; for data already subtracted of dark
; file = file_basename(header.parent, '.fits') + '_subdark.fits'
; data = mrdfits('VL subdark/' + file, 0, /silent)
; data = rebin(data, header.naxis1, header.naxis2)
; data = data * header.nbin * header.ndit
; history = ['Dark correction: ', ' ' + file]
; ====================================
if header.pol_id eq 0 then begin
btype = 'VL fixed-polarization intensity'
descriptor = 'metis-vl-image'
polarimetric = 1
endif else if header.pol_id ge 1 and header.pol_id le 4 then begin
btype = 'VL fixed-polarization intensity'
descriptor = 'metis-vl-image'
polarimetric = 1
endif else begin
btype = 'VL total brightness'
descriptor = 'metis-vl-tb'
polarimetric = 0
endelse
data = metis_flat_field(data, header, cal_pack, error = error, quality_matrix = quality_matrix, history = history)
data = metis_vignetting(data, header, cal_pack, error = error, quality_matrix = quality_matrix, history = history)
data = metis_rad_cal(data, header, cal_pack, polarimetric = polarimetric, error = error, quality_matrix = quality_matrix, history = history)
bunit = cal_pack.vl_channel.cal_units
end
3 : begin
; calibration of temporal noise images
btype = 'VL temporal standard deviation'
descriptor = file_name_fields[2]
bunit = 'DN'
history = !null
end
5 : begin
; calibration of cr/sep log matrices
btype = 'VL cosmic-ray matrix'
descriptor = file_name_fields[2]
bunit = 'DN'
history = !null
end
else : begin
journal, 'Error 01: wrong input data product (expected data types 0, 3, or 5).'
journal
exit, status = 1
end
endcase
; definitions for the primary header
; version of the fits file
version = string(input.l2_version + 1, format = '(I02)')
; fits creation date
date = date_conv(systime(/julian, /utc), 'FITS')
; name of the fits file
file_name = 'solo_L2_' + descriptor + '_' + file_name_fields[3] + '_V' + version + '.fits'
out_file_name = 'output/' + file_name
; adjust the primary header
fxaddpar, primary_header, 'FILENAME', file_name
fxaddpar, primary_header, 'PARENT', file_basename(input.file_name)
fxaddpar, primary_header, 'LEVEL', 'L2'
fxaddpar, primary_header, 'ORIGIN', ''
fxaddpar, primary_header, 'CREATOR', 'metis_l2_prep_vl_generic.pro'
fxaddpar, primary_header, 'VERS_SW', input.sw_version
fxaddpar, primary_header, 'VERS_CAL', cal_pack.version, after = 'VERS_SW'
fxaddpar, primary_header, 'BTYPE', btype
fxaddpar, primary_header, 'BUNIT', bunit
fxaddpar, primary_header, 'DATAMIN', min(data, /nan)
fxaddpar, primary_header, 'DATAMAX', max(data, /nan)
fxaddpar, primary_header, 'WAVEBAND', cal_pack.vl_channel.name
fxaddpar, primary_header, 'XPOSURE', header.xposure
fxaddpar, primary_header, 'NSUMEXP', header.nsumexp
sxdelpar, primary_header, 'BLANK'
; read the calibration curve to convert pmp raw voltages (dacpol) into effective polarization angles
dacpol_cal = cal_pack.vl_channel.dacpol_cal
if header.pol_id ne 5 then begin
if fix(header.hdr_vers) le 4 then begin
case header.pol_id of
0: dacpol = header.dac1pol1
1: dacpol = header.dac1pol1
2: dacpol = header.dac1pol2
3: dacpol = header.dac1pol3
4: dacpol = header.dac1pol4
endcase
endif
if fix(header.hdr_vers) ge 5 then begin
dacpol = header.dac1pol1
endif
k = where(dacpol_cal.dacpol eq dacpol)
angle = dacpol_cal.angle[k]
angle = float(angle[0])
fxaddpar, primary_header, 'POLANGLE', angle, '[deg] Polarization angle', after = 'POL_ID'
endif
; append wcs keywords
wcs = metis_wcs(header, cal_pack, ref_detector = ref_detector)
foreach element, wcs do fxaddpar, primary_header, element.name, element.value, element.comment, before = 'DATATYPE'
; append solar ephemeris keywords
ephemeris = solo_get_ephemeris(header, cal_pack)
foreach element, ephemeris do fxaddpar, primary_header, element.name, element.value, element.comment, before = 'DATATYPE'
history = [history, 'Update WCS and solar ephemeris:', ' SKD version = ' + kernel_version]
; update the comment and history keywords
fxaddpar, primary_header, 'COMMENT', 'Uncertainty matrix in the FITS extension is preliminary.'
for k = 0, n_elements(history) - 1 do $
fxaddpar, primary_header, 'HISTORY', history[k]
fxaddpar, primary_header, 'HISTORY', 'L2 FITS file created on ' + date
; add checksum and datasum to the fits header
if not ref_detector then data = metis_rectify(data, 'VL')
fits_add_checksum, primary_header, data
mwrfits, float(data), out_file_name, primary_header, /no_comment, /create, /silent
journal, 'Fits file created:'
journal, ' file name = ' + file_basename(out_file_name)
; add the extension with the quality matrix
extension_header = !null
fxaddpar, extension_header, 'PCOUNT', 0, 'Parameter count'
fxaddpar, extension_header, 'GCOUNT', 1, 'Group count'
fxaddpar, extension_header, 'EXTNAME', 'Quality matrix', 'Extension name'
if not ref_detector then quality_matrix = metis_rectify(quality_matrix, 'VL')
fits_add_checksum, extension_header, quality_matrix
mwrfits, float(quality_matrix), out_file_name, extension_header, /no_comment, /silent
journal, 'Quality-matrix extension correctly added.'
; add the extension with the error matrix
extension_header = !null
fxaddpar, extension_header, 'PCOUNT', 0, 'Parameter count'
fxaddpar, extension_header, 'GCOUNT', 1, 'Group count'
fxaddpar, extension_header, 'EXTNAME', 'Error matrix', 'Extension name'
error_matrix = data * sqrt(error)
if not ref_detector then data = metis_rectify(error_matrix, 'VL')
fits_add_checksum, extension_header, float(error_matrix)
mwrfits, float(error_matrix), out_file_name, extension_header, /no_comment, /silent
journal, 'Error-matrix extension correctly added.'
; write the auxiliary information file
output = { $
file_name: out_file_name, $
l1_file_name: input.file_name, $
log_file_name: 'output/metis_l2_prep_log.txt' $
}
json_write, output, 'output/contents.json'
; unload the spice kernels
load_spice_kernels, kernel_list = kernel_list, /unload
journal, 'SPICE kernel files unloaded.'
; close the log
journal, 'Exiting without errors.'
journal
exit, status = 0
end