NNDC Databases: ENDF | CSISRS | CINDA | NuDat | NSR | XUNDL | ENSDF | MIRD

   Search the NNDC:

ENSDF Utility Programs: ENSDAT and ComTrans

The National Nuclear Data Center maintains and distributes various programs in support of the International Atomic Energy Agency sponsored Nuclear Structure and Decay Data Network. These programs generally use as input files in the Evaluated Nuclear Structure Data File (ENSDF) format.

Installation Instructions for ENSDAT and COMTRANS_SL
[September 16, 2003]

The programs ENSDAT, COMTRANS_SL along with associated files, test cases and documentation are contained in either a self-extracting ZIP file (ensdat12_win.exe) for MS Windows or a ZIP file (ensdat12_unx.zip) for Linux. The installation instructions are in the file, readme_zip.txt.

ENSDAT related files

  • * ensdat - ENSDAT program
  •   ensdf_dic.dat - sequential ASCII translation dictionary file
  • * ra_ensdf_dic.dat - ENSDF translation dictionary file
  • * ensdat.config - ENSDAT configuration file (Windows only
  •   adopted.186 - sample input for ENSDF
  •   ad_186.ps - PostScript output for sample input
  •   ad_186.log - output message file for sample case
  •   readme_ens.txt - operating instructions for ENSDAT
  •   ENSDATCommands.pdf - documentation for available ENSDF commands

COMTRANS_SL related files

  • * comtrans_sl - COMTRANS_SL program
  •   ensdf_dic.dat - sequential ASCII translation dictionary file
  • * ra_ensdf_dic.dat - ENSDF translation dictionary file
  •   comtrans.tst - sample input for COMTRANS_SL
  •   comtrans.out - output for sample COMTRANS case
  •   readme_com.txt - operating instructions for COMTRANS

Installation instructions
Either execute the self-extracting ZIP file, ensdat12_win.exe, or unzip the file, ensdat12_unx.zip. About 3.4 MB of disk space is required. All of the files should be placed in the directory in which the programs will be executed. Read the readme files and run the test cases. The files above, flagged with an asterisk, are essential to the operation of each program. If ra_ensdf_dic.dat is not present, it will be generated from ensdf_dic.dat.

ENSDAT (Evaluated Nuclear Structure Drawings and Tables) Version 12.23   [July 25, 2007]

Authors: Charles L. Dunford, Robert R. Kinsey
National Nuclear Data Center, Bldg. 197-D
Brookhaven National Laboratory
P.O. Box 5000
Upton, NY 11973-5000

The program ENSDAT (Evaluated Nuclear Structure Drawings And Tables) is similiar to the production program for the Nuclear Data Sheets but more limited in its application. Only ENSDF data files can be used as input and a PostScript file, list of keynumbers in NSR, and a report file are output. As the default, all possible tables, band drawings, and gamma drawings are done for each dataset encountered in the input file. However, it is possible to choose one or more of these groups of output (see below). In addition, it is possible to modify the default tables and drawings by adding commands to the input file using control cards. (See the file enscomds.txt.) A final page is output to the PostScript file which gives a listing of all the keynumbers encountered in the input file.

The program asks for an input file name, an output file name and options. The ENSDF translation dictionary file must be in the same directory from which the program is executed. The input and output files may include a disk and directory path.

Input files:

  1. An ENSDF formatted file. Sample input files: ADOPTED.186
  2. ra_ensdf_dic.dat contains the ENSDF translation dictionaries.

Output files:

  1. PostScript file of tables and drawings and reference list in a form similar to the Nuclear Data Sheets.
  2. Report file summarizing work done and any errors noted.

Sample output files: AD_186.PS (PostScript file) and AD_186.LOG
Terminal dialog: The program will request the following information:

  1. Input - input file specification
  2. Output - output file name
  3. Options - one or more ofthe following options can be entered, separated by a blank:
    TABLELevel, gamma, and radiation information will be output in tabular format.
    BANDBand drawings will be output. Radplot type drawings are also output.
    DRAWGamma drawings will be output.
    NOAUTONo drawings or tables will be generated except those which are specified by the user on control cards added to the input file.
    If none of these options are used, all tables, band drawings (if any), and gamma drawings (if any) will be output to the PostScript file.
  4. View output - Yes or No (optional - see installation instructions for details)
Version History
5.0 - 11.5These versions of ENSDAT were developed and maintained by Robert Kinsey. The programming was done in Fortran 77.
12.0August 26, 2003. The code in this new release follows the Fortran 95 standard. The propriatary ISAM used for the ENSDF dictionary file has been replaced by a single random access file. A few bugs found during the conversion process have been fixed. The companion program, ENSWIN, is no longer supported. Instead, at the end of processing of the input file, a local PostScript viewer such as GhostView can be started to view the output PostScript file.
12.01December, 2003. Replaced specific sorts with a generalized Fortran sort routine. Included in ENSDAT, the creation of the random access dictionaries from the sequential version if necessary. Improved command line input and added command line processing for Windows
12.02January, 2004. Corrected error in reference list processing caused by the fact that UNIX and Windows do not support file version numbers
12.03March, 2004. Corrected generic problem when LEN_TRIM = LEN of a string. Corrected error in zero order control file generation. Fixed minor bug in text wrapping routine. Fixed problem on Unix when separation energies are need from the adopted data set of a parent
12.04June, 2004. Corrected two errors when in AUTO mode with both DRAWINGS and BANDS selected that failed to start a new page at a new plot. Corrected problem in E_TO_F where different code used on VMS and LINUX.
12.05-12.07Affected publication program only
12.08November 17, 2005 (TWB) Fixed problems in translating the symbol NN correctly
12.09November 22, 2005 (TWB) Fixed another problem in translating the symbol NN correctly
12.10April 19, 2006 (TWB)
  1. Increased storage allocated for level T1/2 from 30 to 40 in enspub_def.f
  2. Added check and warning if value is too large for allocated storage in movein of enspub.f
  3. Increased size of str from 30 to 40 in getsds of enspub.f
  4. Strip off "?" on units in readt of ndspub.f
  5. Checked for missing "+" in scientific notation and added in merlev of ndspub.f
  6. Output a few more messages to log file
12.11July 7, 2006 (TWB) Changed hard-wired limit of 999 gammas on line 5168 of enspub.f to the parameter ngammax
12.12July 18, 2006 (TWB)
  1. Corrected problem for storage of (delayed-)particle data when all transitions are placed by no particle energies given (Caused loss of a column when automatic breaking occured)
  2. Allow for possibility of approximate and limits for parent level energy and Q-value
12.13September 12, 2006 (TWB)
  1. Corrected problem in handling non-numeric uncertainties on BR
  2. Corrected logic problem in handling BANDs when footnote comment contains another symbol.
  3. Corrected a problem of outputting a non-numeric uncertainty twice on a program-generated footnote
  4. Corrected string length problem in outputting dataset headings
  5. Check to see if absolute intensity given and modified the program-generated footnote apprpriately:
    Fission datasets: Absolute intensity per 100 fissions.
    (N,G) datasets: Absolute intensity per 100 neutron captures.
    Reaction datasets: Absolute intensity per 100 incident particles.
    Decay datasets: Absolute intensity per 100 decays.
  6. Checked to see if dataset was not a decay and modified the drawing subtitle generated based on the PN record option appropriately
  7. Minor cosmetic change on BR value output for parent info in decay table
12.14November 29, 2006 (TWB)
  1. Fixed initialization problem with branching ratios
  2. Added up/down arrows to reduced transition probabilities as per 2005 USNDP NSDD Working Group meeting
  3. Added kludge to fix lost of positioning when page break within comments
  4. Moved output of BR comments to come after Parent info at start of table
  5. Added parent energy to Parent and BR comments when multiple P/N records
  6. Corrected minor problem in interpreting G as g-factor in Level record comment symbols
12.15December 21, 2006 (TWB)
  1. Patched logic problem when comment on BR was more than two records
  2. Added warning to terminal output when Normalization comment record encountered with no symbols given - Program cannot figure where to output it
  3. Added warning is the maximum number of N comments exceeded storage (maxncom=10)
  4. Added checks for leading blanks on comment records and suppressed
  5. Converted first character from upper to lower case when footnotes converted to comments
  6. Added kludge to use appropriate column labels on automatic footnotes for ELECTRON when converted to comments (i.e., "/D:ALL" used).
  7. Increased length of newline in subroutine AddBrComm to avoid unmatched curly brackets.
  8. Corrected problem of not editing normalization comments in subroutine AddBrComm if "C" or "T" comments.
12.16Affected publication program only
12.17February 21, 2007 (TWB)
  1. Increased storage for BR comments from 10 to 20
  2. Corrected problem which caused all "CN" continuaton records to be treated as first records
  3. Corrected problem where zero's were not being added properly to asymmetric uncertainties
12.18Affected publication program only
12.19May 1, 2007 (TWB)
  1. Absolute IB, IE, and TI not being shown on drawings due to an initialization problem - Fixed
  2. Corrected hard-wired tabbing problem for unplaced gamma and radiation footnote which caused misalignment of the text
  3. Fixed a Comments column width and tabbing problem when the COMBINE option was used
  4. Restored option on DRAW control (Removed 1/15/1993 as per JKT) to show beta, electron, and alpha quantity uncertainties in the drawing's radiation table
  5. Set option to show beta, electron, and alpha quantity uncertainties in the drawing's radiation table on when "/D:ALL" or "/F:a" switch is on BETA, ELECTRON, or ALPHA control record
  6. Attempted to handle some esoteric decay modes in the DSID that might be misintrepreted by the dictionaries
12.20May 18, 2007 (TWB)
  1. Corrected typo error in EDIT introduced in version 12.19 which leading characters of the parent line to be lost if T1/2 was in days
12.21July 11, 2007 (TWB)
  1. Corrected problems in positioning of table comments introduced in previous versions when correcting problems caused by the COMBINE option or comments being carried over to the next page.
  2. Corrected footnote placement problem when table was split into multiple columns
  3. Do not add up/down arrows when reduced transition probabilities are in Weisskopf units
12.22July 18, 2007 (TWB)
  1. Corrected footnote symbol problem. Apparently resereved character "?" used in temporary storage.
  2. If no symbols given for N record comment assume it to be on BR instead of not outputing it.
  3. Corrected editing problem on comment continuation when comment less than 10 characters
  4. Corrected instance of the maximum number of levels being hardwired in instead of using the parameter nlevmax
12.23July 25, 2007 (TWB)
  1. Corrected logic problem in RPLNRM which caused automatically generated normalization footnotes to be blanked out
  2. Corrected initialization problem which caused incorrect branching when generating abstract title in Cards mode

COMTRANS_SL (COMment TRANSlation) Version 7.1 [Nov. 24, 2003]

Author: Charles L. Dunford
National Nuclear Data Center, Bldg. 197-D
Brookhaven National Laboratory
P.O. Box 5000
Upton, NY 11973-5000

The program COMTRANS_SL is a nuclear structure evaluator tool for translating comments in the Evaluated Nuclear Structures Data File (ENSDF) from the all upper case form to the upper/lower case form. In addition, translations of code words found in the NSD dictionary are made into a rich text type of format (e.g., |a replaces ALPHA and {+56}Fe replaces 56FE). These comments no longer need to be used with the NSD dictionary. However, evaluators should note that adding a code word to such a translated comment means they must change the lower case comment flag (c or t) in column 7 to an upper case comment flag (C or T) or rerun the file using COMTRANS_SL. Otherwise, ENSDAT (and the publication code), which do not translate lower case comment (c or t) cards), will output the code word unchanged. Finally, the input file is converted into a Y2K compliant form. All keynumbers are changed from the old 6 character keynumber (85AU01) into the new 8 character keynumber (1985AU01). The keynumbers and fields of the DSID and Q cards are also changed to comply with the Y2K formats.

The program asks for an input file name, an output file name and options. The ENSDF translation dictionary file must be in the same directory from which the program is executed. The input and output files may include a disk and directory path.

Input files:

  1. An ENSDF formatted file. Sample input file: COMTRANS.TST.
  2. ra_ensdf_dic.dat contains the ENSDF translation dictionaries.

Sample output file: COMTRANS.OUT
Terminal dialog: The program will request the following information:

  1. Input - input file specification
  2. 2. Output -output file specification
Version History
1.0 - 5.1These versions of COMTRANS were developed and maintained by Robert Kinsey. The programming was done in Fortran 77.
7.0August 8, 2003. The code in this new release follows the Fortran 95 standard. The propriatary ISAM used for the ENSDF dictionary file has been replaced by a single random access file.
7.1November 24, 2003. Program automatically generates random access ENSDF dictionaries from sequential file.

Evaluators note: Please do not use COMTRANS on evaluations submitted to the NNDC. Some changes made by COMTRANS are irreversible and complicate editing the file. A program, ENSY2K, will do the Y2K conversion without changing the dictionary translations into a rich test type form.

Disclaimer

Neither the Brookhaven Science Associates, Inc., nor the US Department of Energy make any warranty or assume any legal responsibility for the results produced by these programs.

Top of Page

Web: Boris Pritychenko, T.D. Johnson, NNDC, Brookhaven National Laboratory