Livechart Data Download API
This API allows the direct download of data. At the moment the format provided is CSV (comma separated values). Future developments will include more formats, and more options to build custom queries.

Examples
The service URL is nds.iaea.org/relnsd/v1/data? followed by request parameters.
(please note that using 'v0' is the same as using 'v1' )
Here some examples of data request parameters:
fields=levels&nuclides=135xe    try it »
Xe-135 levels
fields=gammas&nuclides=135xe    try it »
Xe-135 gamma transitions
fields=ground_states&nuclides=all    try it »
all ground states in the database
fields=cumulative_fy&parents=233u    try it »
U-233 cumulative fission yields
fields=cumulative_fy&products=135xe    try it »
cumulative fission yields producing Xe-135
fields=decay_rads&nuclides=135xe&rad_types=e    try it »
electrons (Auger and conversion) from Xe-135 decays
fields=bin_beta&nuclides=135xe&rad_types=bm    try it »
Beta and (anti)neutrino energy distributions from Xe-135 G.S. decays

Attention
Jupyter lab
The Livechart API works very effectively with Python data analysis libraries (pandas and plotly in these examples), the first step to build models for Machine Learning.
Many examples, including 3D plotting, are detailed in this Notebook

Attention
There have been cases in which the service returns an HTTP Error 403: Forbidden
The workaround is to add an user agent to the request.
In Python:
def lc_read_csv(url):
    req = urllib.request.Request(url)
    req.add_header('User-Agent', 
        'Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:77.0) Gecko/20100101 Firefox/77.0')
    content = urllib.request.urlopen(req)
    return content

in Java:
protected String lc_read_csv(url){

    URL murl = new URL(url);
    URLConnection conn = murl.openConnection();
    conn.setRequestProperty("User-Agent",
    "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:77.0) Gecko/20100101 Firefox/77.0");
       
    BufferedReader br = new BufferedReader(
                   new InputStreamReader(conn.getInputStream()));

    String inputLine;
    StringBuffer sb = new StringBuffer();
    while ((inputLine = br.readLine()) != null) {
        sb.append(inputLine);
    }
    br.close();
    return sb.toString();
  }

For other languages, add the suggested user agent to the request using the avaliable function
API description
Service URL
The URL of the service is nds.iaea.org/relnsd/v1/data? followed by a chain of parameters linked by &. A parameter is specified as name=value

Parameters

fields

mandatory

Specifies which fields are fetched. At the moment, a predefined group of fields is avaliable. Further development will allow the user to specify the list of fields.

Values
ground_states or levels or gammas or decay_rads or cumulative_fy or independent_fy or bin_beta

Example
fields=cumulative_fy

See below for the description of the fields included in each group.

nuclides

Is mandatory for ground_states, levels, gammas, decay_rads, and bin_beta
It has no effect on cumulative_fy or independent_fy

Restricts the retrieval to the specified nuclide
In this version of the API, only one nuclide can be specified

Values
nuclides=135xe (mass+element)
or
nuclides=all allowed only for ground_states. All ground states are returned

parents

Valid only for cumulative_fy and independent_fy

All the products for the specified parent are returned.
In this API version only one parent can be specified

Values
parents= 232th or 233u or 235u or 238u or 237np or 239pu or 241pu or 241am


products

Valid only for cumulative_fy and independent_fy

All the fission yields of this product, for any parent, are returned
In this API version only one product can be specified

Values
products=135xe (mass+element)


rad_types

Only for, and mandatory for, decay_rads, and bin_beta
Only one value is allowed

Data are returned only for the specified type of radiation
In this API version only one radiation can be specified

Values for decay_rads
a bp bm g e x (α, β-, β+, γ, Auger and conversion electron, X-ray)

Values for bin_beta
bp bm ( β-, β+)

Full Example
fields=decay_rads&nuclides=135xe&rad_types=e


metastable_seqno

Only for bin_beta
Only one value is allowed
Optional, specifies the sequential number for an excited state

Values
1 2 3 ... (first metastable state, second, third, ... )

Full Example
fields=bin_beta&nuclides=135xe&rad_types=bm metastable_seqno=1
This would retrieve the spectra for the decay of the 526.5 keV level of Xe-135

Fields content
Data sources
In the following
Uncertainties
Half-life uncertainity is given in ENSDF notation, referring to the significant digits.
For example 12.1 h 11 means 12.1 h ± 1.1 and 12.1 h 1 means 12.1 h ± 0.1
The Uncertainity of the Half-life in seconds is symmetrised
Field groups
ENSDF_publication_cut-off, ENSDF_authors, and extraction date are at the end of each row
ground_states
Properties on the nuclide and its ground state level
namecontentunitssource
znumber of protons
nnumber of neutrons
symbolelement symbol
radiuscharge radiusfmAM
unc_r
abundanceAbundanceMole fraction %N
unc_a
energy_shiftunknown energy shiftX, Y, ...ENSDF
energyenergykeV
unc_e
ripl_shiftenergy shift from RIPLkeVRIPL
jpJπENSDF
half_lifeHalf-life
operator_hllimits on H-l valueAP, GT, LT, ...
unc_hlH-l unc in ENSDF style
unit_hlH-l units
half_life_secH-l in secondsseconds
unc_hlsH-l unc, symmetrized
decay_{1 2 3}1st, 2nd, 3rd decay mode
decay_{1 2 3}_%branching for 100 decays%
unc_{1 2 3}
isospinisospin
magnetic_dipolemagnetic dipoleμNS
unc_md
electric_quadrupoleelectric quadrupolebarn
unc_eq
qbmQ-value for β- decaykeVAME
unc_qb
qbm_nβ- nkeV
unc_qbmn
qaαkeV
unc_qa
qecelectron capturekeV
unc_qec
snneutron separation energykeV
unc_sn
spproton separation energykeV
unc_sp
bindingbinding energy / AkeV
unc_ba
atomic_massatomic massμAMU
unc_am
mass excessmass excesskeV
unc_me
me_systematicsmass excess from systematics
discoveryyear of discoveryN
levels
Properties of the excited energy levels of a nuclide
The meaning and source of the fields are the same as the ground_state set. Additional fields are:
namecontentunitssource
znumber of protonsENSDF
nnumber of neutrons
symbolelement symbol
idx
energy_shiftunknown energy shiftX, Y, ...
energyenergykeV
unc_e
ripl_shiftenergy shift from RIPLkeV
jpJπ
jp_order
half_lifeHalf-life
operator_hllimits on H-l valueAP, GT, LT, ...
unc_hlH-l unc in ENSDF style
unit_hlH-l units
half_life_secH-l in secondsseconds
unc_hlsH-l unc, symmetrized
decay_{1 2 3}1st, 2nd, 3rd decay mode
decay_{1 2 3}_%branching for 100 decays%
unc_{1 2 3}
isospinisospin
magnetic_dipolemagnetic dipoleμN
unc_mn
electric_quadrupoleelectric quadrupolebarn
unc_eq
gammas
Properties of the electromagnetic transitions between energy levels of the nuclide
In the following :
namecontent
znumber of protons
nnumber of neutrons
symbolelement symbol
start_level_idxstart level index
start_level_energystart level energy
unc_sle
start_level_jpstart level Jπ
end_level_idxend level index
end_level_energyend level energy
unc_ele
end_level_jpend level Jπ
gamma_idxγ index (within the start level)
energyenergy
unc_en
relative_intensityrelative intensity
unc_ri
multipolaritymultipolarity
mixing_ratiomixing ratio
unc_mr
b_e1RTPW - E1 multipolarity
unc_be1
b_e2RTPW - E2 multipolarity
unc_be2
b_m1RTPW - M1 multipolarity
unc_bm1
b_m2RTPW - M2 multipolarity
unc_bm2
decay_rads
Properties of the radiations emitted by the daughter(s) of the nuclide that decays
In the following : Fields common to all decay radiation types

namecontent
energyradiation energy
unc_en
intensityradiation intensity
unc_i
p_zz of the parent
p_nn of the parent
p_symbolelement of the parent
p_energy_shiftenergy shift of the parent
p_energyenergy of the parent
unc_pe
jp Jπ of the parent
half_lifehalf-life of the parent
operator_hllimits on H-l
unc_hlH-l unc in ENSDF style
unit_hlH-l units
half_life_secH-l seconds
unc_hlsH-l unc, symmetrized
decaydecay mode
decay_%branching
unc_d
qQ-value
unc_q
d_zz of the daughter
d_nn of the daughter
d_symbolelement of the daughter


α radiations

namecontent
daughter_level_hlfed level H-l [s]
daughter_level_energyfed level energy
hindrance_factorhindrance factor
unc_hf
• X-ray, electrons

namecontent
typeX for X-ray, AU for Auger, or CE for conversion
shellSiegbahn notation


• β radiations

namecontent
mean_energymean energy
unc_me
intensity_betaintensity for e- (e+) emission
unc_ib
daughter_level_hldaughter's excited state Half-life [s]
daughter_level_energydaughter's excited state energy
max_energyonly for β-, end-point energy
unc_me
energy_EConly for β+, energy available for Electron Capture
unc_eec
intensity_EConly for β+, intensity of EC
unc_ie
log_ftlog ft
unc_lfundefined
transition_type
(anti_)nu_mean_energytransition type
unc_(ame)nme(anti) neutrino mean energy


• γ radiations

namecontent
start_level_hlHalf-life of the initial level
start_level_energyenergy of the initial level
end_level_energyenergy of the final level
multipolaritymultipolarity of the transition
mixing_ratiomixing ratio
unc_mr
conversion_coeffconversion coefficient (total)
unc_cc




bin_beta
β+/- and ν / anti ν spectra

Spectra are obtained using Betashape code

namecontent
p_zz of the parent
p_nn of the parent
p_symbolelement of the parent
p_energyenergy of the parent
d_zz of the daughter
d_nn of the daughter
d_symbolelement of the daughter
bin_enbin energy
dn_dedn/de
unc_dn_deuncertainty
dn_de_nudn/de nu or anti nu
unc_dn_de_nuuncertainty
extraction_datedate of retrieval


Error codes

When no data are retrieved, a numeric code is returned

codemeaning
0the request is vaild, but there are no data fufilling the conditions
1"fields" parameter is not given
2"nuclides" parameter is not given but is required for the given "fields"
3"fields" parameter is misspelled
4"parents" o "products" not given for fission yields
5"rad_types" not valid
6unknown error


Feedback
Please address any feedback to NDS contact point

IAEA - Nuclear Data Section
Vienna International Centre, PO Box 100
A-1400 Vienna, Austria
Telephone: (+431) 2600-0
email:nds.contact-point
© 2009- 2024 IAEA Nuclear Data Section   
Terms of use