TkN: Version 2.5

Data sources and content

• The ground-state mass excess (mass_excess) is now sourced exclusively from the IAEA AME CSV file (groundstates.csv), and no longer from the NuDat JSON.
  • This avoids inconsistencies when NuDat and IAEA values diverge.
  • tkn-create returns a clear error if the IAEA CSV is missing.
  • groundstates.csv is now bundled in the TkN installation (via CMake install rule) as a fallback when the network is unavailable.

tkdataset

• New metadata fields stored in the DATASET table and accessible through the C++ API:
  • dataset_date (YYYY-MM format): publication date of the dataset, extracted from the ENSDF identification record (fdate field).
    • tkdataset::get_date() — returns the date string
    • tkdataset::has_date() — returns true if a date is available
  • dataset_source ("ENSDF" or "XUNDL"): identifies the database of origin.
    • tkdataset::get_source() — returns the source string
    • tkdataset::is_xundl() — returns true if the dataset comes from XUNDL

tklevel_scheme

• print("dataset") now displays datasets in two clearly separated sections: ENSDF and XUNDL.
  • Each section shows the dataset name, ID, and publication date (when available).
  • Dataset comments are displayed when the "com" option is passed.
• New overloads for get_levels() and get_decays() accepting a lambda predicate for filtered access:

  auto levels = scheme->get_levels([](auto lvl){ return lvl->get_energy() < 1000.; });

tklevel / tkdecay display

• Significant overhaul of the terminal output format for levels and decays:
  • Properties are now displayed on a single line with consistent column alignment.
  • Long comment strings are automatically word-wrapped at 80 characters.
  • Fixed incorrect scientific notation for the final level energy in decay chains.
  • Decay type is now shown with a capitalized label (e.g. Gamma decay:, Beta decay:).

tkn-print

• New option --nucleus / -n: specify the nucleus directly as a named option (in addition to the existing positional argument).
• New option --dataset-comment: print the comment associated with a specific dataset (by ID).
• --datasets is now accepted as an alias for --show-datasets.
• Autocompletion scripts (bash and zsh) updated accordingly.

Documentation

• Corrected and expanded the online user guide

Bug fixes

• tknucleus::get_element_name() was always returning an empty string. The tkmanager loader was reading from a non-existent DB column "name" instead of the correct "element_name" column of the ELEMENT table.