NESC0387 CITATION.

1. NAME OR DESIGNATION OF PROGRAM:  CITATION.

3. DESCRIPTION OF PROBLEM OR FUNCTION

CITATION is designed to solve problems using the finite-difference representation of neutron diffusion theory, treating up to three space dimensions with arbitrary group-to-group scattering. X-y-z, theta-r-z, hexagonal-z,  and triagonal-z geometries may be treated. Depletion problems may be solved and fuel managed for multi-cycle analysis. Extensive first-order perturbation results may be obtained given microscopic data and nuclide concentrations. Statics problems may be solved and perturbation results obtained with microscopic data.
CITATION-2-3-VP2 is a vectorized version for FACOM VP-100 and VP-200 vector computers.

4. METHOD OF SOLUTION

Explicit, finite-difference approximations in space and time have been implemented. The neutron-flux-eigenvalue problems are solved by direct iteration to determine the multiplica- tion factor or the nuclide densities required for a critical system.  CITATION-2-3-VP2: Algorithms for the inner-outer iterative calculations are adapted to vector computers. The SLOR method, which is used in the original CITATION code, and the SOR method, which is  adopted in the revised code, are vectorized by odd-even mesh ordering.

5. RESTRICTIONS ON THE COMPLEXITY OF THE PROBLEM

CITATION has been designed to attack problems which can be run in a reasonable amount  of time. Storage of data is allocated dynamically to give the user flexibility in dimensioning. Typically, a finite-difference diffusion problem could have 200 depleting zones, 10,000 nuclide densities, and 30,000 space-energy point flux values.

6. TYPICAL RUNNING TIME

The two-dimensional finite-difference diffusion theory eigenvalue problems iterate at a rate of about 0.1  millisecond per point per iteration with alternating-direction line  relaxation (two sweeps per iteration) with 8-byte words on the IBM 360/91 (0.5 on the 360/75). Since about 30 iterations are required for each succeeding eigenvalue problem, machine time for a depletion problem is about 0.003 second per point per time-step. Machine time  for most auxiliary calculations is usually insignificant. For a
representative fast breeder depletion problem, 68 percent of the machine CPU time is spent in solving eigenvalue problems. CITATION-2 (NESC0387/02): NEA-DB executed the test case on CDC CYBER 174 in 44 CP seconds.

NEA-DB executed the test case included in this package  on a PC/80486 (66MHz) in about 18 seconds.

7. UNUSUAL FEATURES OF THE PROGRAM

CITATION is considered unusual in  that it should be relatively easy to modify the contents or to add routines. Effective techniques are incorporated to determine a critical system. More than one set of microscopic cross sections may be used and nuclide behavior can be followed on a sub-zone scale within depletion regions. The user has flexible control over the route of a calculation as well as the edit of results.

8. RELATED AND AUXILIARY PROGRAMS

The microscopic cross section tape  for this program may be generated by various codes, but XSDRN is designed specifically for this purpose. The microscopic cross section routines, formerly an auxiliary program, were integrated into the code to permit such data to be supplied from cards or modified in the same run in which the problem is solved.

10. REFERENCES

- T.B. Fowler, D.R. Vondy and G.W. Cunningham:
  Nuclear Reactor Core Analysis Code CITATION,
  ORNL-TM-2496, Supplement 1 (October 1971), Supplement 2 (March
  1972), Supplement 3 (July 1972).
- N.M. Greene and C.W. Craven, Jr.:
  XSDRN, A Discrete Ordinates Spectral Averaging Code,
  ORNL-TM-2500 (July 1969).

- T.B. Fowler, D.R. Vondy and G.W. Cunningham:
  Nuclear Reactor Core Analysis Code CITATION
  ORNL-TM-2496, Revision 2 (July 1971)
- D.R. Vondy and T.B. Fowler:
  Job Stream of Cases for the Computer Code CITATION
  ORNL-TM-3793 (July 1972)
- NESC Note 81-66:
  CITATION Tape Description and Implementation Information
  (July 17, 1981)
- T.B. Fowler, D.R. Vondy and G.W. Cunningham:
  Nuclear Reactor Core Analysis Code CITATION
  ORNL-TM-2496, Revision 2 (July 1971)
- D.R. Vondy and T.B. Fowler:
  Job Stream of Cases for the Computer Code CITATION
  ORNL-TM-3793 (July 1972)

11. MACHINE REQUIREMENTS

IBM 360/91 or equivalent with at least 128,000 32-bit words of directly-addressable main storage, 7 to 32 I/O devices depending upon the calculation, excluding input and output devices and system requirements.

Hardware requirements:
- Intel 80386 processor or equivalent (Intel 80486 should be OK,   but not tested)
- Weitek 3167 numeric coprocessor or Intel 80387 numeric   coprocessor
- All available memory will be utilized, but 1 Mbyte of extended   memory is recommended.
*******************************************************************
Systems with 80386-387 combination, or with a 80486, should be able  to  run the executable CITINTEL.EXE whereas systems equipped with a
Weitek 3167 coprocessor should be able to run the executable CITWEITK.EXE.
*******************************************************************
The sample problem was run at the NEA/DB on a PC DELL 466/L (processor 80486 , 67 MHz, base memory of 640 Kbyte and extended memory of 15648 Kbyte).
The filesizes of the two executables CITINTEL.EXE and CITWEITK.EXE created using the Lahey F77L-EM/32 compiler, are 1.04 Mbyte and 1.10 Megabyte respectively.

13. OPERATING SYSTEM UNDER WHICH PROGRAM IS EXECUTED:  OS/360 (IBM 360). NOS 1.4-531 (CDC CYBER 174).

NEA-DB installed the program under MS-DOS 6.20.

14. OTHER PROGRAMMING OR OPERATING INFORMATION OR RESTRICTIONS

CITATION contains about 28,700 source statements. Without overlay, storage for the code instructions would approach 574,000 32-bit words, but with overlay the storage requirement is about 90,000 for  the program and fixed storage, 10,000 of this 90,000 is used for system library routines.

15. NAME AND ESTABLISHMENT OF AUTHOR

Contributed by:
T.B. Fowler, D.R. Vondy, and G.W. Cunningham
Oak Ridge National Laboratory
P.O. Box X
Oak Ridge, Tennessee 37830

File name	File description	Records
NESC0387_09.001	Information file	69
NESC0387_09.002	CITATION-2 source program (FORTRAN-77)	28704
NESC0387_09.003	CITATION-2 test case input data	904
NESC0387_09.004	CITATION-2 test case printed output	3197

File name	File description	Records
NESC0387_11.001	CITATION Information File	203
NESC0387_11.002	Intel 80387 executable version of CITATION	0
NESC0387_11.003	Weitek 3167 executable version of CITATION	0
NESC0387_11.004	Sample input file for CITATION -test problem	850
NESC0387_11.005	Sample output file from running CIT.INP	3459
NESC0387_11.006	DOS file-names	5