reading of the spectral time series within the readEPR_Exp_Specs
function
reading parameter strings from 'parameter' files within the readEPR_param_slct
function
the g-value scale on x-axis within the plotting functions is now properly displayed
if the related time(series) unit is converted in relevant data frames,
the corresponding column is renamed in order to inherit the new unit
(like time_s), accordingly
now, the elements in names argument, within the readEPR_Exp_Specs_multif,
can also contain characters like c("a","b","c"), not just numbers
like c("250","260","270")
fixed visualization of legend labels within the plot_EPR_Specs function
natural abundance of interacting nuclei to calculate the intensities
within the eval_sim_EPR_iso and related functions/examples
polynomial to fit the distribution of (B1,Bm)
within the cavity was extended in quantify_EPR_Abs. Now, the degrees from
5 to 12 are available
additionally, the above-corresponding (B1,Bm) theoretical distribution calculation was removed for now, and will be addressed in the future
intensity, B, and the time.series column indices arguments, in general reading
function readEPR_Exp_Specs, were renamed (using .id) in order to clearly
point to headers in col.names
magnettech option added to reading functions to read the EPR spectra
and parameters from these instruments, additionally, the 'general' reading
function readEPR_Exp_Specs was updated to read files, from
the most common EPR instruments, more easily by adding the auxiliary
data.structure argument
the optimization algorithms, other than diff-levenmarq, were removed
from the eval_kinR_EPR_modelFit for now, additional optimization
methods will be implemented later on
many function documentations updated + several examples added +
code-cleaning (by styler package) done in many functions +
README, DESCRIPTION and vignettes updated, accordingly
vignette to describe the EPR simulations and fitting was removed, for now (will be added later), however, the important points from that vignette are summarized in the relevant function documentations
stoichiometric coefficient notation as well as reaction model scheme
for consecutive reactions within the eval_kinR_ODE_model updated/extended
option to use Tesla (T) unit, now available in all g-value evaluations
line.type option added to all relevant plotting functions
calculation of confidence interval by the eval_interval_cnfd_tVec simplified
to read the EPR instrumental parameters by readEPR_params_slct,
added option to read several parameters simultaneously (vectorized input)
customized plot themes, like plot_theme_In_ticks, were simplified,
now, there is no need to add opposite axis-ticks by additional theme layer,
those function can now also include additional arguments from general
theme() function
perinaphthenyl (PNT) ENDOR spectral data added to package database for documentation examples (in plotting and reading functions)
setting up the continuous integrations like R CMD check
and pkgdown (in order to build the site) via github actions
CONTRIBUTING.md added to package/site
new vignette for datasets added
new family functions for EPR spectroelectrochemistry, including
the function to plot voltammograms and chronoamperograms
(plot_ECh_VoC_amperogram) as well as to calculate the transferred charge
and the corresponding number of electrons from chronoamperogram
(eval_ECh_QNe_chronoamp)
new dataset (Triarylamine_radCat_decay_a) as an example of time
series experimental data + new datasets coming from magnettech
instrument: AcridineDeriv_Irrad_365nm
calculation of normalization constant quantify_EPR_Norm_const ⇒
number of points added to calculated norm. constant by unitless receiver gain
kinetic models by ODE ⇒ eval_kinR_ODE_model + eval_kinR_EPR_modelFit
now consider partial reaction orders and correct formulas for rates
⇒ derivations divided by stoichiometric coefficients according
to IUPAC recommendations (see also https://doi.org/10.1021/ed083p510) +
additionally, now the kinetic parameters can be optimized
not only by the Levenberg-Marquardt algorithm but also by those including within
the optim_for_EPR_fitness (in case if the partial reaction orders
are considered)
eval_kinR_ODE_model can now compare/plot experimental data and model
in order to 'play' with (manually optimize) partial reaction orders
and/or stoichiometric coefficients to fit the experimental data e.g. like
integrals or concentrations vs. time. Additionally, the A <-- R --> B kinetic model
was removed (also from eval_kinR_EPR_modelFit) simply, because it "doubles"
the R --> B model. The model can be added later on.
several bugs in quantify_EPR_Abs (e.g. like concentration calculation + default temperature
definition) were fixed. The function was completely rewritten. Moreover, now the quantification possesses
user's/instrument's defined polynomial (orders from 6 to 11) fitting of the spatial distribution
of B1 and Bm as well as point sample calibration factor as arguments
in order to be more flexible. Finally, the theoretical B1 and Bm distribution
(see e.g. https://www.sciencedirect.com/science/article/pii/S1090780797912489)
can be considered as well in order to estimate the radical concentration.
remedy for the Breit-Rabi calculations of energies/frequencies/Bs in simulation => now the g-value for each level is corrected and B are calculated by the fixed-point iterations (see e.g https://doi.org/10.1016/j.jmr.2005.08.013). Simulations are not limited by the number of equivalent nuclei groups anymore (6 could be used up to now). Right now any number of groups maybe used in the actual simulation functions. All simulations are also continuously checked by the package tests/examples.
eval_sim_EPR_isoFit now contains the option not only to fit the pseudo-Voight lines but also pure
Lorentzian or pure Gaussian onto the experimental EPR spectra
README ⇒ pkg. badges initiated + usage examples added + DESCRIPTION + vignette demonstrating
the basic functionality of the package
several documentations and examples
draw_molecule_by_rcdk ⇒ renamed and focused just on one molecule +
added option to place label of the molecule onto an arbitrary position of output image +
documentation + examples
increased accuracy of ENDOR frequencies in nuclei isotopes_ds dataset
couple of variables/arguments (e.g. like B <-> B.val) renamed in order to be consistent
throughout the package
to select/remove the columns from data frame objects by {dplyr} the dplyr::all_of() function
is now mostly applied in the package code
extended tolerance to find half of the max. intensity in order to evaluate FWHM
functions to read the EPR spectra like readEPR_Exp_Specs, readEPR_Exp_Specs_kin
as well as readEPR_Exp_Specs_multif were simplified and now contain the option to take additional
arguments from the essential data.table::fread() which are not predefined in those functions
in order to be more flexible upon reading
added files required to run examples as well as those incl. in vignette(s) ⇒ they are related to EPR spectra of electrochemically generated tetramethyl-phenylenediamine (TMPD) radical cation
smoothing of EPR spectra by {npreg} package ⇒ smooth_EPR_Spec_by_npreg which is based
on the evaluation of polynomial splines
fitting of the experimental EPR spectra by simulations ⇒ eval_sim_EPR_isoFit where several
optimization methods can be applied ⇒ all incl. in optim_for_EPR_fitness + baseline correction
(either "constant" or "linear" or "quadratic") is now included in the fitting procedure
new tutorial vignette for simulations EPR_Simulations was initiated/set up
testing environment by the {testthat} pkg. set up and initiated + added tests for simulations
and conversions
added files/spectral data corresponding to an EPR spectrum of aminoxyl radical for examples and testing
main function to read EPR spectral data (readEPR_Exp_Specs) is now forced to use
file argument ⇒ that is data.table::fread(file = path_to_ASC)
conversion of time to var within a cyclic change in convert_time2var
changed tolerance to find intensity values around 0 in g-factor evaluation
(eval_gFactor_Spec) in order to take into account different spectral data resolutions
general integration function (eval_integ_EPR_Spec) now includes the proper scaling
of sigmoid integrals + fixed Intensity bug in vector output for the integrated
form of EPR spectra
temperature parameter in instrumental .DSC or .par files is sometimes missing ⇒
now the readEPR_params_tabs checks whether the temperature parameter is present
and creates the table accordingly (with or without the temperature)
README, DESCRIPTION and "Introduction"" vignette
documentation references set up
Code for the absolute quantification of paramag. centers/radicals was simplified
within the quantify_EPR_abs function.
Function to draw molecules was rewritten to read both .sdf files and smiles characters +
it was renamed to draw_molecules_by_rcdk.
Reading the simulated spectra (readEPR_Sim_Spec) has now the option to read ASCII data from
various sources like ⇒ "easyspin", "xenon", "simfonia" (winepr) or "csv".
Instrumental parameters (related to recording of EPR spectra, readEPR_params_tab)
can be converted into interactive table based on {DT} package.
Both solvents and isotopes datasets were renamed to ..._ds.
several documentations and examples
The Intensity selection based on different character strings is now replaced
by the lineSpecs.form argument throughout the corresponding functions.
The simulation section/family was renamed to Simulation and Optimization.
Presentation of simulated and experimental spectra (presentEPR_Sim_Spec) has now option
to display overlayed spectra.
read properties of solvents (from the corresponding datasets) ⇒ readEPR_solvent_props
convert magnetic flux density (B) values according to input-output units ⇒ convert_B
simulation of isotropic EPR spectra in both derivative & integrated spectral forms ⇒
eval_sim_EPR_iso
simulation of isotropic EPR spectra corresponding to linear combination of several
components evaluated by the latter function ⇒ eval_sim_EPR_iso_combo
read instrumental parameters required for the simulations that is now implemented
in both sim. functions ⇒ readEPR_params_slct_sim
Added functions to evaluate radical kinetics incl. fitting procedures to experimental data (integral intensities).
Added basic package data structure and vignettes. Package data now include the isotope database,
isotope_db, to gather the basic properties of nuclei mainly for analysis in EPR/ENDOR spectroscopy.
For such purpose the new function eval_nu_ENDOR was written. It provides calculation of ENDOR/Larmor
frequencies for selected nuclei at specific saturation magnetic flux densities, Bsat.
All functions (incl. documentation) are now linked by sections/families.
quantify_EPR_sim function. Additionally, the main reading functions,
readEPR_... have been completely rewritten.