Name:
nn_currents_diff.pro
Purpose:
Calculates the the non-neutralized currents of an active region and related parameters according to Georgoulis, Titov & Mikic 2012.
Calling sequence:
nn_currents_diff,c_img_br,c_img_bp,c_img_bt,c_img_bp_err,c_img_bt_err,bzthres=bzthres,minflux=minflux,minsize=minsize,pot_file=pot_file,no_pot=no_pot,have_partition=have_partition,simple_clusters=simple_clusters,$
CURRENTS_ORIG=CURRENTS_ORIG,CURRENTS_POT=CURRENTS_POT,AR_WHOLE=AR_WHOLE
Input parameters:
c_img_br : Br HARP cutout, corrected for limb presence.
c_img_bp : Bp HARP cutout, corrected for limb presence.
c_img_bt : Bt HARP cutout, corrected for limb presence.
c_img_bp_err : Bp_err HARP cutout, corrected for limb presence.
c_img_bt_err : Bt_err HARP cutout, corrected for limb presence.
Keywords:
bzthres: the threshold on the radial component of the magnetic field; default is 100 G
minflux: the threshold on the minimum flux contained in the partitions; default is 5 1019 Mx
minsize: the threshold on the minimum size of the partitions; default is 40 pixels
pot_file: the potential field extrapolation file containing the components at the photosphere
no_pot: if set no potential field is calculated
have_partition: set this keyword equal to a variable where the partitioned Br magnetrogram is stored
simple_clusters: set this keyword to use a simpler cluster finder; default option is the mct model.
Output:
currents_orig: structure containing the calculations of currents for each partition of the magnetogram
currents_pot: structure containing the calculations of currents for each partition of the magnetogram, based on the potential field components
ar_whole: structure containing all usefull information that characterizes the active region as a whole (imbalance, total non-neutralized currente etc)
Property name in DB:
nn_currents.num_currents: the number of partitions
nn_currents.tot_us_cur: the total unsigned non-neutralized current
nn_currents.err_tot_us_cur: the error of the total unsigned non-neutralized current
nn_currents.flimb: the active region flux imbalance
nn_currents.ipn_nn: the global current non-neutrality factor
nn_currents.err_ipn_nn: the error of the global current non-neutrality factor
nn_currents.net_curr: the net current of the active region
nn_currents.err_inet: the error of the net current of the active region
nn_currents.tot_pos: the total positive non-neutralized current
nn_currents.err_tot_pos: the error the total positive non-neutralized current
nn_currents.tot_neg: the total negative non-neutralized current
nn_currents.err_tot_neg: the error the total negative non-neutralized current
nn_currents.iimb: the current imbalance of the active region
nn_currents.its: the currents of the active region partitions
nn_currents.err_its: the error of the currents of the active region partitions
nn_currents.its_pot: the "potential" currents of the active region partitions
nn_currents.err_its_pot: the errors of the "potential" currents of the active region partitions
Repository:
https://dev.flarecast.eu/stash/projects/FE/repos/nn_currents-idl/browse
References:
Georgoulis, Titov and Mikic, 2012, The Astrophysical Journal, 761, 61