Installation Notes - ENSDF Analysis and Checking Codes for MS-DOS®

National Nuclear Data Center
Department of Advanced Technology
Brookhaven National Laboratory
P.O. Box 5000
Upton, NY
11973-5000 USA
May 12, 1995

Table of Contents

Minimum System Requirements

Operating System: 3.1 and above
Hard Disk Space: 10,868,617 bytes[1]
Available Conventional Memory: Minimum load sizes range from 38551 bytes (SEQHST) to 502702 (ENSDAT)[2]
Floppy Disk Drive: At least one 3½-inch high-density drive[3]

Installation Procedures

Preparation

With a few exceptions, files have been compressed using the Microsoft® Compression Utility version 2.00[4] (As indicated by the underscore (_) in the extension) and require the Microsoft® Expansion Utility (EXPAND.EXE).[4] If you are operating under MS-DOS® 5.0 or above or have Microsoft® Windows™ 3.x or a compiler such as Microsoft® C/C++ 7.x, this utility should exist in the appropriate directory and already be in your path. If this does not apply, copy EXPAND.EXE found on the ENSDF_CODE1 disk to a directory in your path.

Using the Installation Batch Files Supplied

Copy the program RKEY.COM[5] found on ENSDF_CODE1 to a directory in your path. This program provides the interactive feature required in the batch files.Each distribution diskette has an installation batch file (INSTALLx.BAT with x=1 to 4 corresponding to diskette ENSDF_CODEx). These batch files are designed to act in sequence or independently and have the same three parameters as input. These parameters are:
  1. Drive containing the installation diskette (Default: A:. Must be given if the second parameter is specified and must contain the colon (:)).
  2. Drive to install the data on (Default: C:. Must be given if the third parameter is specified and must contain the colon (:)).
  3. Destination directory (Default: ENSDFCDS)
For example,
C:> B:INSTALL1.BAT B: D: TSTENSDF
will begin the installation of information contained in the ENSDF_CODE1 diskette in drive B: to drive D: under the directory TSTENSDF while
C:> A:INSTALL3.BAT
will begin the installation of information contained in the ENSDF_CODE3 diskette in drive A: to drive C: under the directory ENSDFCDS.

Each installation batch file will automatically copy or expand certain files and will prompt for an action in other cases. The file which will automatically be expanded is DATA.TST located on the ENSDF_CODE1 diskette. For each program, set of programs, or subroutine library selected, the associated "Read Me" file will be copied. The user will be queried about installing a program, set of programs, or subroutine library. If the answer is yes (Y or y), a subdirectory is created under the directory specified in the installation command and the "Read Me" is copied to this subdirectory. All files (N/Y)? will then appear; if the answer is yes (Y or y) all relevant files will be expanded into the subdirectory and if the answer is no, the user will be asked about each type of file associated with the program. Each question includes in parentheses either Y/N or N/Y. The first character indicates the default action and the second, an alternate action. Striking any key other than that indicated for the alternate action (case insensitive) will result in the default action.

Do It Yourself

If you wish to individually select files, EXPAND.EXE must still be present. Prior to expanding the file, DISTRM.MEM should be expanded and looked at. Example:
C:> CD MYENSDF
C:> EXPAND A:DISTRM.ME_ DISTRM.MEM
C:> PRINT DISTRM.MEM
This example changes directory to MYENSDF, expands DISTRM.MEM[6] into this directory, and prints it out. The next step would be to look at the "Read Me" files found in each program directory of the distribution diskettes[7] (e.g., READLOGF.ME in the LOGFT directory of ENSDF_CODE1 contains information on the program LOGFT.). These files are not compressed and may be copied or printed out. You may then expand the files of interest to you (See example, above).[8]

Procedures Followed in Assembling This Distribution

Compilation and Linking

Compilation was performed using Microsoft® FORTRAN Optimizing Compiler 5.0[9] with the following switches set:[10]
/Gt Default threshold of 256 bytes for allocation of data items to new data segment
/FPi In-line instructions generated and emulation math package selected
/G2 80286/80386 instruction set
/AH Huge memory model chosen

The optimization switch /Op which improves consistency of floating-point results was not invoked since this might result in less precise values, increased code size, and increased time for execution. The object library of subprograms (LLIBNSDE) was created using Microsoft® Library Manager 3.20.010.[11] Each module of the library was individually added to allow for selective searches and reduced code size. Linking was usually performed using Microsoft® Segmented Executable Linker 5.31.009[12] with no specific switches.[10],[13]

Checking

The following checking was done on the programs in this distribution:[10]
  1. All programs were compiled, linked, and run both on a VAX 11/8820 and on a 386DX/25 or a P5-90 for the test cases provided. The results were checked to see if the program worked "as advertised" and that there was consistency in results between the two machines.
  2. Programs substantively changed since August 1992 (FMTCHK, GTOL, HSICC, and LOGFT) were checked running the programs on a VAX 11/8820 using as input significant sections of the ENSDF data in the pipeline at the National Nuclear Data Center. A subset of these data were then used as input on a 386DX/25 or P5-90 and the results compared to those of the VAX.
  3. Selected programs were run on an AT-class machine operating under DOS 3.10 to check for possible generic problems due either to the class of machine or version of DOS.

Virus Check

The master copies of the distribution diskettes were checked with Central Point Antivirus[14] or Microsoft Anti-Virus for Windows.[15]

Disclaimer

Neither the Associated Universities, Inc., nor the US Department of Energy make any warranty or assume any legal responsibility for the results produced by the programs and data included in this distribution.

Table 1. ENSDF Analysis and Checking Codes for MS-DOS (May 10, 1995)

File Size
(Bytes)		 Memory
(Bytes)		 Description
General
DATA.TST 3854 Sample input for most programs
DISTRM.MEM 14520 Brief description of ENSDF code distribution
Support Subprograms Used By Most Programs
LLIBNSDE.LIB 37693 Object library
LLIBNSDE.LIS 4536 Summary object library contents
NSDFLIB.FOR 199588 Source code
NSDFLIB.MEM 36784 Documentation
READNSDF.ME 6647 Brief description
Utility Codes
Evaluated Nuclear Structure Drawings and Tables
DATATST.KEY 48 Sample list of keynumbers extracted from input file
DATATST.LOG 235 Sample report output
DATATST.PSC 29340 Sample output (in PostScript)
ENSDAT.EXE 850414 502702 Executable
NSDDIC.DB 134803 Translation dictionary
NSDDIC.IDX 124416 Index to translation dictionary
READENSD.ME 4260 Brief description
Format and Syntax Checking
FMTCHK.EXE 207350 204310 Executable
FMTCHK.FOR 660069 Source code
FMTCHK.RPT 879 Sample output
READFMTC.ME 61144 Brief description including explanations of messages
Tabular Representation of Evaluated Nuclear Data
TREND.EXE 161148 161500 Executable
TREND.FOR 403604 Source code
TREND.RPT 3022 Sample output
READTREN.ME 7811 Brief description
Add Gammas to Adopted Levels
ADDGAM.EXE 52842 54362 Executable
ADDGAM.FOR 16236 Source code
ADDGAM.NEW 2132 Sample output
ADDGMG.DAT 1817 Sample input
ADDGML.DAT 402 Sample input
READADDG.ME 2385 Brief description
Analysis Codes
Calculate R0's, T½(α)'s, and α HF's
222RA.DAT 6478 Sample input
ALPHAD.EXE 262742 261766 Executable
ALPHAD.FOR 131282 Source code
ALPHAD.NEW 6478 Sample output
ALPHAD.RPT 1476 Sample report
READALPH.ME 2237 Brief description
Analyze Correlation and Conversion Coefficient Data
DELTA.DAT 1217 Sample input
DELTA.EXE 79714 80226 Executable
DELTA.FOR 210166 Source code
DELTA.RPT 69535 Sample output
READDELT.ME 9951 Brief description
Calculate Branching ratios, etc.
GABS.EXE 52860 60372 Executable
GABS.FOR 61336 Source code
GABS127.DAT 848 Sample report output
GABS192.DAT 1243 Sample report output
GABS57.DAT 696 Sample report output
GABS80.DAT 1236 Sample report output
GABS85.DAT 548 Sample report output
57IN.DAT 902 Sample input
80IN.DAT 2862 Sample input
80OUT.DAT 2998 Sample ENSDF output
127IN.DAT 1953 Sample input
127OUT.DAT 2135 Sample ENSDF output
192IN.DAT 4264 Sample input
192OUT.DAT 4396 Sample ENSDF output
READGABS.ME 5067 Brief description
Gamma to Level
GTOL.EXE 344896 343184 Executable
GTOL.FOR 310716 Source code
GTOL.RPT 7114 Sample output
READGTOL.ME 18672 Brief description
Hager-Seltzer Internal Conversion Coefficients
BLDHST.EXE 41432 42440 Executable for BLDHST
BLDHST.FOR 32800 Builds direct-access file and index from sequential files
CARDS.NEW 348 Sample new card output from HSICC
H1.DAT 161382 Sequential file of conversion coefficients for Z=3-34
H2.DAT 305214 Sequential file of conversion coefficients for Z=35-59
H3.DAT 287040 Sequential file of conversion coefficients for Z=60-82
H4.DAT 260676 Sequential file of conversion coefficients for Z=83-103
HSICC.EXE 153866 152410 Executable for HSICC
HSICC.FOR 224856 Calculates internal conversion coefficients
HSICC.RP2 1386 Sample comparison report from HSICC
HSICC.RPT 31756 Sample report from HSICC
HSMRG.EXE 148335 149391 Executable for HSMRG
HSMRG.FOR 28700 Merges new cards with original input file
HSMRG.NEW 4018 Sample ENSDF output from HSMRG
ICCSEQ.DAT 1014312 Sequential file containing all conversion coefficients
READHSIC.ME 22695 Brief documentation
SEQHST.EXE 37016 38552 Executable for SEQHST
SEQHST.FOR 13120 Creates a sequential file of conversion coefficients from direct-access file and index
Calculates log ft's
LOGFT.DAT 7938 Radial wave function data
LOGFT.EXE 105888 108096 Executable
LOGFT.FOR 237390 Source code
LOGFT.NEW 3854 Sample ENSDF output
LOGFT.RPT 7688 Sample report
READLOGF.ME 10086 Brief description
Physics Analysis of Nuclear Data to Outline Required Adjustments
FILE.ERR 710 Sample error report
FILE.GAM 23225 Sample γ report ordered by Eγ
FILE.GLE 20730 Sample γ report ordered by Elevel
FILE.LEV 22053 Sample level report
FILE.RAD 1832 Sample radiations report
FILE.REP 2900 Sample report noting possible problems
FILE.XRF 8958 Sample cross reference report
PANDIN.DAT 19684 Sample input data
PANDOR.EXE 404530 405346 Executable
PANDOR.FOR 270190 Source code
PANDOR.OUT 37720 Sample ENSDF output
PANDOR.PSC 43217 Documentation (in PostScript)
READPAND.ME 11216 Brief description
Recommended Upper Limits (RUL)
READRULE.ME 8267 Brief description
RULER.EXE 149510 147926 Executable
RULER.FOR 305532 Souce code
RULER.IN 21078 Sample input
RULER.OUT 56744 Sample ENSDF output
RULER.PSC 1509410 Documentation (in PostScript)
RULER1.RPT 98208 Sample comparison report
RULER2.RPT 61502 Sample calculation and insertion report

Table 2. Packing List for 3½-inch HD Diskettes

ENSDF_CODE1 ENSDF_CODE2 ENSDF_CODE3 ENSDF_CODE4
General DELTA INSTALL2.BAT INSTALL3.BAT INSTALL4.BAT
EXPAND.EXE FMTCHK HSICC GABS ENSDAT
INSTALL1.BAT GTOL PANDORA TREND
ADDGAM LOGFT RULER
ALPHAD NSDFLIB

Endnotes

  1. For full installation. See Table 1 for individual file sizes.
  2. See Table 1 for individual minimum load sizes.
  3. Contact the National Nuclear Data Center if different media are required.
  4. ©Microsoft Corp. 1990-1992. All rights reserved.
  5. Dan Gookin. Advanced MS-DOS® Batch File Programming, 2nd Edition (McGram-Hill, Inc. 1991).
  6. Located in the root directory of ENSDF_CODE1.
  7. See Table 2.
  8. Many of the programs use the file DATA.TST on ENSDF_CODE1 as sample input.
  9. ©Microsoft Corp. 1982-1989. All rights reserved.
  10. With the exception of ENSDAT which includes C routines.
  11. ©Microsoft Corp. 1983-1992. All rights reserved.
  12. ©Microsoft Corp. 1984-1992. All rights reserved.
  13. The /S:4096 was used with LOGFT to increase the stack parameter due to the recursive techniques used.
  14. ©Central Point Software, Inc. 1991-1993.
  15. ©Central Point Software, Inc. 1993.
Thomas W. Burrows