KAPPA PACKAGE README

08-Feb-2024

PURPOSE:

Synthesis of optically thin emission line and continuum spectra for solar and stellar coronae for the non-Maxwellian kappa-distributions.
Currently, the software and database allows calculation of the synthetic spectra for kappa = 1.7, 1.8, 1.9, 2, 2.5, 3, 4, 5, 7, 10, 15, 25, and 33.
Corresponding Maxwellian spectra can be calculated using CHIANTI, version 10
(Dere, K.P. . Del Zanna, G. Young, P.R., Landi, E., Sutherland, R. S.: 1997, Astrophys. J. Suppl. Ser., 241, 22;
Del Zanna, G., Dere, K.P., Young, P.R., Landi, E.: 2021, Astrophys. J. 909, 38)
or using Maxwellian branche of KAPPA package.

REFERENCE:

Dzifcakova, E., Dudik, J., Kotrc, P., Farnik, F., Kulinova, A.: 2014, "KAPPA: A Package for Synthesis of optically thin spectra for the non-Maxwellian kappa-distributions based on the CHIANTI database" ApJS 217, 14
Dzifcakova, E., Dudik, J., Zemanova, A., Lorincik, J., Karlicky M.: 2021, "KAPPA: A Package for Synthesis of Optically Thin Spectra for the Non-Maxwellian Kappa-Distributions. II. Major Update to Compatibility with CHIANTI version 10" , ApJS , 257, 62
Dzifcakova, E., Dudik, J.,Pavelkova, M., Solarova, B. Kulinova, A.: 2023, "KAPPA: A Package for the Synthesis of Optically Thin Spectra for the Non-Maxwellian Kappa-Distributions. III. Improvements to Ionization Equilibrium and Extension to kappa < 2", ApJS , 269, 45

HOW TO INSTALL THE DATABASE IN SSW IDL:

1) CHIANTI 10 is required

2) Copy the files and database into a standalone folder kappa/

3) The '!data_pth' system variable has to be set, pointing to the directory with the database (including full path)

EXAMPLE:
defsysv, '!data_pth', '/home/user/kappa/data'

4) You can work in the folder kappa or Individual routines need to be compiled to run KAPPA

EXAMPLES:
.r /home/user/kappa/ch_load_2ion_rates_k.pro
.r /home/user/kappa/ch_load_ion_rates_k.pro
.r /home/user/kappa/ch_setup_ion_k.pro
.r /home/user/kappa/ch_synthetic_k.pro
.r /home/user/kappa/descale_diel_k.pro
.r /home/user/kappa/emiss_calc_k.pro
.r /home/user/kappa/freebound_k.pro
.r /home/user/kappa/freebound_ion_k.pro
.r /home/user/kappa/freefree_k.pro
.r /home/user/kappa/freefree_k_integral.pro
.r /home/user/kappa/isothermal_k.pro
.r /home/user/kappa/kappa.pro
.r /home/user/kappa/make_kappa_spec_k.pro
.r /home/user/kappa/plot_populations_k.pro
.r /home/user/kappa/pop_solver_k.pro
.r /home/user/kappa/read_ff_k.pro
.r /home/user/kappa/read_ionrec_k.pro
.r /home/user/kappa/read_rate_ioniz_k.pro
.r /home/user/kappa/read_rate_recomb_k.pro
.r /home/user/kappa/read_kappa_ups.pro
.r /home/user/kappa/ups_kappa_interp.pro
....

The above examples can be included into the idl_startup.pro for automatic compilation.

KAPPA SOFTWARE AND DATABASE

Direct access to DATABASE

The routines above contain as the first parameter a value of kappa with the exception of the main widget routine kappa.pro where parameter kappa is given by the selection of the ionization equilibrium.

EXAMPLES:
Dz23_logn0_kappa_2.ioneq - calculations for kappa=2 and zero density ionization equilibrium
chianti.ioneq - calculations for the Maxwellian distribution

KAPPA MANUAL

Last update: March, 2024

ACKNOWLEDGEMENTS:

This work was supported by Grant Agency of the Czech Republic, Grant Nos. 18-09072S and 22-07155S. We acknowledge the CHIANTI database and software, www.chiantidatabase.org, on which the KAPPA package is based and without which it could not exist. CHIANTI is a collaborative project involving the NRL (USA), RAL (UK), MSSL (UK), the Universities of Florence (Italy) and Cambridge (UK), and George Mason University (USA). It is a great spectroscopic database and software and the authors are very grateful for its existence and availability.