ENSDAT and ComTrans

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

The programs ENSDAT, COMTRANS_SL along will associated files, test cases and documentation are contained in either a self-extracting ZIP file (ENSDAT12_VMS.EXE or ENSDAT12_WIN.EXE) for OpenVMS or 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
* ra_ensdf_dic.dat - ENSDF translation dictionary file
* ensdat.config - ENSDAT configuration file
 
  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
  enscomds.pdf - documentation for available ENSDF commands

 
COMTRANS_SL related files
* COMTRANS_SL - COMTRANS_SL program
* 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_VMS.EXE or ENSDAT12_WIN.EXE, or unzip the file, ENSDAT12_UNX.ZIP. About 2MB 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.

The program ENSDF_DIC has been included as an auxiliary program. Its purpose is to create the random access ENSDF dictionary file ra_ensdf_dic.dat from its sequential version, ensdf_dic.dat. If your random access file is damaged, you may recreate it by running ENSDF_DIC. In the future, dictionary updates will be distributed in the ASCII equential form that you must convert with ENSDF_DIC to create a new ra_ensdf_dic.dat.

ENSDAT (Evaluated Nuclear Structure Drawings and Tables) Version 12.0
[Aug. 26, 2003]

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
Phone: 631-344-2804 FAX: 631-344-2806
E-mail: "dunford@bnl.gov"

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.

COMTRANS_SL (COMment TRANSlation) Version 7.0
[August 8, 2003]

Author: Charles L. Dunford
National Nuclear Data Center, Bldg. 197-D
Brookhaven National Laboratory
P.O. Box 5000
Upton, NY 11973-5000
Phone: 631-344-2804 FAX: 631-344-2806
E-mail: "dunford@bnl.gov"

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.

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.


Contact

Charles L. Dunford
National Nuclear Data Center, Bldg. 197-D
Brookhaven National Laboratory
P.O. Box 5000
Upton, NY 11973-5000
Phone: 631-344-2804 FAX: 631-344-2806
E-mail: "dunford@bnl.gov"

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.


Last updated: September 29, 2003