TkN 2.3
Toolkit for Nuclei
Loading...
Searching...
No Matches
Public Member Functions | Friends | List of all members
tkdataset Class Reference
Physics

Stores information on a specific dataset. More...

Detailed Description

Stores information on a specific 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:

cpp tknucleus nuc("132Sn"); nuc.get_level_scheme()->print("dataset") shell [ INFO ] Available datasets are : [ INFO ] 132Sn : ADOPTED LEVELS, GAMMAS (12581) [ INFO ] 133IN B-N DECAY (165 MS) (12582) [ INFO ] 248CM SF DECAY (12583) [ INFO ] COULOMB EXCITATION (12584) [ INFO ] 132IN B- DECAY (0.200 S) (12585) [ INFO ] 132SN IT DECAY (2.080 US) (12586) [ INFO ] U(N,F):IS,RADIUS:XUNDL-3 (12587) [ INFO ] COULOMB EXCITATION:XUNDL-4 (12588) [ INFO ] 133IN B-N DECAY:162 MS:XUNDL-5 (12589) [ INFO ] 133IN B-N DECAY:167 MS:XUNDL-6 (12590) [ COMMENT ] Current dataset is '132Sn : ADOPTED LEVELS, GAMMAS' (12581)

As shown in the above example, TkN also include the non evaluated datasets (XUNDL). These datasets are coming from recently published data, but that have still not been evaluated by the National Nuclear Data Center.

The dataset can be selected as follows (using the Coulomb Excitation dataset ids):

cpp tknucleus nuc("132Sn"); nuc.get_level_scheme()->select_dataset(12584); nuc.get_level_scheme()->print("level"); nuc.get_level_scheme()->select_dataset(12588); nuc.get_level_scheme()->print("level"); ``‘shell [ INFO ] dataset 'COULOMB EXCITATION’ contains 2 levels: [ INFO ] Level energy = 0 keV [no uncertainty] ; Jpi: 0+ [ INFO ] Level energy = 4040 keV [no uncertainty] ; Jpi: 2+

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

\class tklevel_scheme
\brief Collection of levels and decay
\details

For all the nuclei with known data on the ENSDF or XUNDL databases, it is possible to access to a tkn::tklevel_scheme object.

The level scheme is determined for a given dataset see tkn::tkdataset documentation.

For one dataset, the level scheme gives access to the nuclear levels and decay information. Refer to the tkn::tklevel or tkn::tkdecay documentation.

Definition at line 56 of file tklevel_scheme.h.

#include <tklevel_scheme.h>

Public Member Functions

 tkdataset ()=default
 
 tkdataset (const tkstring &_nuc, int _zz, int _aa, const tkstring &_name, int _id)
 
virtual ~tkdataset ()=default
 
shared_ptr< tkgammadecay > add_gamma_decay (shared_ptr< tklevel > _lvlfrom, shared_ptr< tklevel > _lvlto, double _ener=0., double _unc=0.)
 add a new decay between two levels to the dataset
 
shared_ptr< tklevel > add_level (double _ener, double _unc, tkstring _unit, tkstring _jpistr)
 manually add a new level to the dataset
 
int get_id () const
 returns the dataset ID
 
const tkstring & get_name () const
 returns the dataset name
 
const tkstring & get_nucleus_name () const
 returns the nucleus name associated to this dataset
 

Friends

class tklevel
 
class tklevel_scheme
 

Constructor & Destructor Documentation

◆ tkdataset() [1/2]

tkdataset ( const tkstring & _nuc,
int _zz,
int _aa,
const tkstring & _name,
int _id )
inline

Definition at line 79 of file tklevel_scheme.h.

◆ tkdataset() [2/2]

tkdataset ( )
default

◆ ~tkdataset()

virtual ~tkdataset ( )
virtualdefault

Member Function Documentation

◆ add_gamma_decay()

shared_ptr< tkgammadecay > add_gamma_decay ( shared_ptr< tklevel > _lvlfrom,
shared_ptr< tklevel > _lvlto,
double _ener = 0.,
double _unc = 0. )

add a new decay between two levels to the dataset

Definition at line 624 of file tklevel_scheme.cpp.

◆ add_level()

shared_ptr< tklevel > add_level ( double _ener,
double _unc,
tkstring _unit,
tkstring _jpistr )

manually add a new level to the dataset

Definition at line 592 of file tklevel_scheme.cpp.

◆ get_id()

int get_id ( ) const
inline

returns the dataset ID

Definition at line 84 of file tklevel_scheme.h.

◆ get_name()

const tkstring & get_name ( ) const
inline

returns the dataset name

Definition at line 86 of file tklevel_scheme.h.

◆ get_nucleus_name()

const tkstring & get_nucleus_name ( ) const
inline

returns the nucleus name associated to this dataset

Definition at line 88 of file tklevel_scheme.h.

Friends And Related Symbol Documentation

◆ tklevel

friend class tklevel
friend

Definition at line 58 of file tklevel_scheme.h.

◆ tklevel_scheme

friend class tklevel_scheme
friend

Definition at line 59 of file tklevel_scheme.h.

The documentation for this class was generated from the following files: