Nuclear Data Section (NDS)
             Department of Nuclear Sciences and Applications
                International Atomic Energy Agency (IAEA)
                Vienna International Centre, P.O. Box 100,
                        A-1400 Vienna, Austria
                Tel:(+43 1) 2600-21714; Fax:(+43 1) 26007
  
       "X5-json: comprehensive presentation of EXFOR in JSON format"
               Prepared by Viktor Zerkin, IAEA-NDS, 2023-08-16
_______________________________________________________________________________

CONTENT

    EXFOR data and relevant information presented as set of JSON files
 1) X5.json files (one file per Entry) include meta-data, dictionary-information,
    original and computational data, data for renormalization by monitor cross 
    sections and decay data.
 2) EXFOR-Entries.csv  - list of Entries (CSV: Comma Separated Values)
 3) EXFOR-Datasets.csv - list of Datasets
 4) Examples of usage  - programs on Python3
_______________________________________________________________________________

LICENSES

 1) See LICENSE.TXT
_______________________________________________________________________________

DOWNLOAD

 1) Download file "EXFOR-x5json-20230816.zip" from Internet:
    https://www-nds.iaea.org/cdroms/#x5json
_______________________________________________________________________________

INSTALL

 1) Uncompress file "EXFOR-x5json-20230816.zip" to HD disk
    (required free space on HD disk: ~3.5Gb)

    Windows: two options a) or b)
      a) right click on the file "EXFOR-x5json-20230816.zip" and follow
          --> "7-zip" --> "Extract files"
      b) Open command prompt window: <Windows/R> --> type "cmd<Enter>"
         C:\TMP1> "C:\Program Files\7-Zip\7z.exe" x EXFOR-x5json-20230816.zip

    Linux/MacOS:
      $ unzip EXFOR-x5json-20230816.zip
_______________________________________________________________________________

USAGE

 Prepared to be used by programs to build own database or procedures.
_______________________________________________________________________________

EXAMPLES

Required: Python3, Plotly

Programs:
 1) entries.py        read list of Entries, display selected info
 2) datasets.py       read list of Datasets, select by reaction, display info
 3) data1.py          find datasets by reaction, extract data in computational form
 4) data2.py          find datasets by reaction, extract data, plot by Plotly -> html
 5) index0.py         scan dir recursively to find files by extension ".x5.json"
 6) index2.py         scan dir recursively, load *.x5.json, produce Entry-index
 7) index2entries.py  scan dir recursively, load *.x5.json, produce Entry-index in JSON and CSV
 8) index2datasets.py scan dir recursively, load *.x5.json, produce Datasets-index in JSON and CSV
 9) json2tree.py      display JSON file in Web browser as interactive tree

Run:
 $ python -B entries.py
 $ python -B datasets.py
 $ python -B data1.py
 $ python -B data2.py
 $ python -B index0.py
 $ python -B index2.py
 $ python -B index2entries.py
 $ python -B index2datasets.py
 $ python -B json2tree.py 1/135/13597.x5.json
_______________________________________________________________________________

Please report setup/runtime errors to V.Zerkin@iaea.org
_______________________________________________________________________________

         ALL PRODUCTS ON THIS PACKAGE ARE PROVIDED IN GOOD FAITH AND 
                    WITHOUT A WARRANTY OF ANY KIND.