CCC-0610 CALOR95.

1. NAME OR DESIGNATION OF PROGRAM:  CALOR95.

3. DESCRIPTION OF PROGRAM OR FUNCTION

CALOR95 is a Monte Carlo code system, written in Fortran 77 that is designed to assist experimentalists in evaluating and analyzing different types of calorimeter systems used in many high-energy physics experiments to  determine the energy and direction of incident hadrons, leptons, and photons. This code package contains HETC95, SPECT95, EGS4, MORSE, and other support programs. PSR-0261/MICAP, also available from RSICC for IBM mainframe, can be modified for workstation and substituted for MORSE. In April 1996 CALOR95 replaced CALOR89 in the RSIC  code collection. In July 1998 the MORSE code was replaced when it was found that previous versions of MORSE in this system did not yield the correct energy balance because absorbed gamma-ray energies were underestimated. No other modules were changed.

In July 1998 the MORSE code was replaced when it was found that previous versions of MORSE in the CALOR system did not yield the correct energy balance because absorbed gamma-ray energies were underestimated. No other modules were changed.

4. METHOD OF SOLUTION

HETC95 transports p, n, pi, mu in the energy range from the source-particle energy down to a specified energy cutoff using the MONTE CARLO methods to solve the Boltzman transport equation. SPECT calculates the energy depositions or "effective energy deposition" associated with the hadronic particles. EGS4 transports the gamma-rays from pi decay and the e from mu decay. MORSE transport the low energy neutrons (<20 MeV), and gamma rays produced during this phase are stored and transported using EGS4 or  can be transported by MORSE.

5. RESTRICTIONS ON THE COMPLEXITY OF THE PROBLEM:  None noted.

6. TYPICAL RUNNING TIME

Depends on the number of histories and energy of the source particles. Times notes for the sample problems on an IBM RISC 6000 Model 590.
HENMT88       2 seconds
HETC          4 seconds
EGSPREP       1 second
PEGS         23 seconds
EGS4         30 seconds
XSMORSE       9 seconds
MORSE        17 seconds
LIGHT         7 seconds
SPECS         1 second

No timing was performed for the different programs/modules.

7. UNUSUAL FEATURES: UNUSUAL FEATURES OF THE PROGRAM

8. RELATED AND AUXILIARY PROGRAMS

The CALOR-95 code system consists of the following programs (also called  modules in the following):
- EGS4: Monte Carlo program to perform electron and photon transport. It transports photons from pi0 decays and e+/e- from mu+/mu- decay.
- PEGS: Program to prepare the cross-sections to be used by EGS4.
- EGSPREP: Electron-photon cascade preparation program.
- MORSE: Monte Carlo program to perform neutron transport using multigroup cross-section data. It transports the low energy neutrons (<20 MeV). Photons produced during the neutron reactions can be transported by MORSE or by EGS4.
- XSMORSE: Program to prepare the cross-section data to be used by MORSE.
- HETC95: High Energy Transport Code. It transports p,n,pi+,pi-, mu+,mu- down to a specific energy cutoff.
- HENMT88: This program controls the reading/writing of tape containing intranuclear cascade data and evaporation data.
- LIGHT95: Program to produce the saturation curves.
- SPECT95: Program to perform hadron analysis. Calculates the energy deposition or the effective energy deposition associated with the hadronic particles.
- FANALYSIS: Program to perform the final analysis of the output.

10. REFERENCES

- T.A. Gabriel, J.E. Brau, B.L. Bishop,
  "The Physics of Compensating Calorimetry and the New CALOR89 Code System"
  ORNL/TM 11060 (March 1989).
- J.E. Brau, T.A. Gabriel, P.G. Rancoita,
  "Prospects for and Tests of Hadron Calorimetry with Silicon"
  ORNL/TM 10954 (March 1989).
- Application Software Group, CERN Program Library Long Writeup
  Y250,
  "HBOOK Reference Manual, DRAFT Version 4.14" (April 1992).

- B.L. Kirk:
  README (April 1996)
- B.L. Kirk:
  README for Sun (October 1996)
- T.A. Gabriel et al.:
  CALOR89 - A Monte Carlo Program Package for the Design and
  Analysis of Calorimeter Systems
  ORNL/TM-11185 (unpublished report). Contains portions of the following reports
  CCC-331/EGS4 (pages 93-164); PEGS4 User Manual (pages 2-43);
  CCC-203/MORSE-CG (pages 4.1-1 - 4.4-2); CCC-178/HETC  (HETC memo;
  ORNL-4744; NMTC Memo; ORNL-4606; NMTA Memo; ORNL-4736;
  ORNL-3667; ORNL-5619; NRL Memo Report 2729).
- T. Handler et al.:
  Unix Version of CALOR89 for Calorimeter Applications
  SDC-92-00257 (May 1992)

11. MACHINE REQUIREMENTS

The system runs on IBM RISC 6000 workstations with a minimum of 4 Mbytes of memory and 100 Mbytes of disk storage.

Both versions of CALOR-95 for IBM RISC 6000 and SUN workstations are provided. However, only the version for SUN platforms has been tested by the NEA/DB.
About 65 Megabyte of diskspace are required to:
a) Download the package files (source files, make files, data files, etc...)
b) Compile the source files and create the object (.o) files
c) Create the executables of the CALOR-95 modules.
d) Run these executables, producing output and intermediate files
Step a) requires about 38 Mbyte, the rest of the diskspace is required by files created during steps b) through d)

13. SOFTWARE REQUIREMENTS: OPERATING SYSTEM UNDER WHICH PROGRAM IS EXECUTED

The versions of CALOR-95 provided within this package have been installed and executed at RSICC in the following machines:
- Sun Sparc 20, under Solaris 2.4, using the Sun Sparc Fortran 2.0
compiler
- Sun Sparc 20, under Solaris 2.6, using the Sun Workshop Fortran 4.2
- IBM RISC 6000/Model 590, under the AIX 3.2.5 operating system, using the XL Fortran compiler version 3.2.2.3

15. NAME AND ESTABLISHMENT OF AUTHORS

Contributed by:
                Radiation Safety Information Computational Center
                Oak Ridge National Laboratory
                Oak Ridge, Tennessee, U. S. A.

Developed by:
                Oak Ridge National Laboratory
                Oak Ridge, Tennessee, U. S. A.

610SUN05.01 Program abstract
C00610/lis This file
libpack.a Archived library of math routines
henmt88/readme.HENMT88 Information file
henmt88/HENMT88.INP Input files
henmt88/HETCBCD.DAT Input files
henmt88/CASCADE.BIN Output files
henmt88/EVAPOR.BIN Output files
henmt88/henmt88.f FORTRAN 77 sources
henmt88/makefile.henmt88 Script file to compile and link
henmt88/102296.log Log file of compilation and execution
hetc93cg/readme.hetc Information file
hetc93cg/cg.fu Combinatorial geometry data
hetc93cg/hetc.inp Input files
hetc93cg/CASCADE.BIN Input files
hetc93cg/EVAPOR.BIN Input files
hetc93cg/*.f FORTRAN 77 sources (336 sources)
hetc93cg/makefile.hetc Script file to compile and link
hetc93cg/hetc.ppr Output file
hetc93cg/haug02.dat Binary output file
hetc93cg/102296.log Log file of compilation and execution
egs4_93cg/readme.egs4 Information file
egs4_93cg/cg.fu Combinatorial geometry data
egs4_93cg/egs.inp Input files
egs4_93cg/egspreph.dat Input
egs4_93cg/pbfe.p Input cross sections
egs4_93cg/*.f FORTRAN 77 sources (36 sources)
egs4_93cg/makefile.egs4 Script file to compile and link
egs4_93cg/EGS.PPR Output file
egs4_93cg/ehaug02.dat Binary output file
egs4_93cg/102296.log Log file of compilation and execution
egsprep/readme.egsprep Information file
egsprep/egsprep.inp* Input files (3 files)
egsprep/haug02.dat Binary input file
egsprep/egsprep.f FORTRAN 77 source
egsprep/makefile.egsprep Script file to compile and link
egsprep/egsprep.ppr* Output file (3 files)
egsprep/egspreph.dat Binary output file (input to EGS4)
egsprep/102296.log Log file of compilation and execution
pegs93/readme.pegs Information file
pegs93/pegs.5 Input file
pegs93/pegs.8 Cross section input
pegs93/pegs.9 Cross section input
pegs93/*.f FORTRAN 77 sources (100 sources)
pegs93/makefile.pegs Script file to compile and link
pegs93/pbfe.ppr Output file
pegs93/pbfe.p Binary cross-section output file
pegs93/102296.log Log file of comilation and execution
xsmorse93/readme.xsmorse Information file
xsmorse93/bcdbin.inp Input file
xsmorse93/xsbcdbin.f FORTRAN 77 source
xsmorse93/makefile.xsmorse Script file to compile and link
xsmorse93/bcdbin.ppr Output file
xsmorse93/xsmorse.bin Binary output file (input to MORSE)
xsmorse93/102296.log Log file of compilation and execution
morse93cg/readme.morse Information file
morse93cg/ft01 Binary cross section (xsmorse.bin)
morse93cg/ft09 HETC history file (haug02.dat)
morse93cg/ft05 Sample input for SDC scintillator
morse93cg/ft05_fe Sample input for iron problem
morse93cg/ft05_h Samplr inp for hydrogen problem
morse93cg/*.f FORTRAN 77 sources (101 sources)
morse93cg/make_c95 Script file to compile and link SDC scintillator problem
morse93cg/make_f77 Script file to compile and link hydrogen and iron problem
morse93cg/ft02 Output file
morse93cg/ft07 Output file
morse93cg/ft10 Output file
morse93cg/ft11 Output file
morse93cg/ft12 Output file
morse93cg/ft16 Output file
morse93cg/ft06 Output file
morse93cg/102296.log Log file of compilaiton and execution
light93/readme.light Information file
light93/light.inp Input file
light93/light.f FORTRAN 77 source
light93/makefile.light Script file to compile and link
light93/light.ppr Output file
light93/kb131.dat Binary output file (input to SPECT)
light93/102296.log Log file for compilation and execution
spect93/readme.spect Information file
spect93/spect.inp Input file
spect93/*.f FORTRAN 77 sources (2 sources)
spect93/makefile.spect Script file to compile and link
spect93/spect.ppr Output file
spect93/shaug02.dat Binary output file
light93/102296.log Log file of compilation and execution
fanalysis/analyz.inp Input file
fanalysis/analyz.f FORTRAN source file
fanalysis/makefile.analyz Makefile to compile and link
fanalysis/analyz.ppr sample output
README.CD Installation instructions
README.RSI Installation instructions
610TAR2.LIS List of files
610TAR2.Z Material for RISC6000