dataset

The database used for the levels and decays is extracted from the ENSDF database.

For a given nucleus, the database is composed of different validated datasets, corresponding to different ways to produce the nucleus. A global dataset named : "ADOPTED LEVELS, GAMMAS" is used to merge all the different datasets in one. This is the default dataset of any nucleus in TkN.

TkN allows to load the different datasets. For a given nucleus, the datasets and their associated ID can be listed using:

tknucleus nuc("132Sn");
nuc.get_level_scheme()->print("dataset")

[ INFO     ] --- ENSDF ---
[ INFO     ] 132Sn : ADOPTED LEVELS, GAMMAS (14197) [2018-03]
[ INFO     ] 133IN B-N DECAY (165 MS) (14198) [2018-03]
[ INFO     ] 248CM SF DECAY (14199) [2018-03]
[ INFO     ] COULOMB EXCITATION (14200) [2018-03]
[ INFO     ] 132IN B- DECAY (0.200 S) (14201) [2018-03]
[ INFO     ] 132SN IT DECAY (2.080 US) (14202) [2018-03]
[ INFO     ] --- XUNDL ---
[ INFO     ] U(N,F):IS,RADIUS:XUNDL-3 (14203) [2020-03]
[ INFO     ] COULOMB EXCITATION:XUNDL-4 (14204) [2020-04]
[ INFO     ] 133IN B-N DECAY:162 MS:XUNDL-5 (14205) [2020-10]
[ INFO     ] 133IN B-N DECAY:167 MS:XUNDL-6 (14206) [2020-10]
[ INFO     ] 132IN B- DECAY:XUNDL-7 (14207) [2022-05]
[ INFO     ] 134IN B-2N DECAY:XUNDL-8 (14208) [2024-01]
[ INFO     ] 133IN B-N DECAY:XUNDL-10 (14209) [2025-11]
[ INFO     ] 133IN B-N DECAY:XUNDL-11 (14210) [2025-11]
[ INFO     ] 132IN B- DECAY:XUNDL-9 (14211) [2025-11]
[ INFO     ] U(N,F):IS,RADIUS:XUNDL-12 (14212) [2026-02]
[ COMMENT  ] Current dataset is '132Sn : ADOPTED LEVELS, GAMMAS' (14197)

The datasets are displayed in two sections: evaluated ENSDF datasets and non-evaluated XUNDL datasets. The publication date of each dataset (in YYYY-MM format) is shown in brackets when available, e.g. [2024-01].

To display dataset comments alongside the list, pass the "com" option:

nuc.get_level_scheme()->print("dataset", "com")

Select by name rather than a hardcoded ID: IDs are not stable across database versions. Names below are examples; inspect the available datasets first.

tknucleus nuc("132Sn");
auto scheme = nuc.get_level_scheme();
const int original = scheme->get_dataset()->get_id();
scheme->select_dataset("COULOMB EXCITATION");
nuc.get_level_scheme()->print("level");
scheme->select_dataset("COULOMB EXCITATION:XUNDL-4");
nuc.get_level_scheme()->print("level");
scheme->select_dataset(original);

[ INFO     ] dataset 'COULOMB EXCITATION' contains 2 levels:
[ INFO     ] Level energy = 0      keV [uncertain] ; Jpi: 0+
[ INFO     ] Level energy = 4040   keV [uncertain] ; Jpi: 2+
 
[ INFO     ] dataset 'COULOMB EXCITATION:XUNDL-4' contains 4 levels:
[ INFO     ] Level energy = 0      keV [uncertain] ; Jpi: 0+
[ INFO     ] Level energy = 4041.2 keV [uncertain] ; Jpi: 2+   ; half-life = 2.95    (-0.47  ; +0.70 ) fs
[ INFO     ] Level energy = 4351.9 keV [uncertain] ; Jpi: 3-   ; half-life = 2.4     (-0.6   ; +1.3  ) ps
[ INFO     ] Level energy = 4416   keV [uncertain] ; Jpi: 4+   ; half-life = 3.95    (0.13 ) ns uncertain level tag: S

The manager caches one shared scheme per nucleus. Selection and edits affect all callers of that scheme, not just the current tknucleus. Save/restore selections (using an RAII guard when exceptions or early returns are possible). Do not select or edit datasets while other threads read them. For a private selection, construct a separate tklevel_scheme in single-threaded code. Use a detached tkdataset for user-created levels instead of modifying the shared adopted dataset.

The current dataset object can be retrieved and inspected programmatically:

tknucleus nuc("132Sn");
auto ds = nuc.get_level_scheme()->get_dataset();

To iterate over all available datasets:

for (auto &[id, ds] : nuc.get_level_scheme()->get_datasets()) {
    glog << info << ds->get_name() << " (" << id << ")" << do_endl;
}

Here are the main methods available on a tkdataset:

method name	description
get_id()	returns the dataset integer ID
get_name()	returns the dataset name as a string
get_comment()	returns the dataset comment string (can be empty)
has_comment()	returns true if a comment is available
get_date()	returns the publication date in YYYY-MM format (can be empty)
has_date()	returns true if a publication date is available
get_source()	returns the source string: "ENSDF" or "XUNDL"
is_xundl()	returns true if the dataset comes from XUNDL