RSICC CODE PACKAGE CCC-728
1. NAME AND TITLE
GENII-LIN Multipurpose Health Physics Code System with a New Object-Oriented Interface, Release 2.1.
2. CONTRIBUTORS
Laboratorio di Montecuccolino, Bologna University, Bologna Italy.
Based on Genii-1.485 developed at Pacific Northwest Laboratory, Richland, Washington.
3. CODING LANGUAGE AND COMPUTER
Pentium PC; FORTRAN; C++ (C00728PC58601).
4. NATURE OF THE PROBLEM SOVED
The goal of the GENII-LIN project was to develop a multipurpose health physics code running on Linux platform. The general features of the GENII-LIN system include
· capabilities for calculating radiation dose both for acute and chronic releases, with options for annual dose, committed dose and accumulated dose
· capabilities for evaluating exposure pathways including direct exposure via water (swimming, boat, fishing), soil (buried and surface sources) and air (semi-infinite cloud and finite cloud model), inhalation pathways and ingestion pathways.
The release scenarios considered are
· acute release to air, from ground level or elevated sources, or to water;
· chronic release to air, from ground level or elevated sources, or to water;
· initial contamination of soil or surfaces.
GENII-LIN is the result of implementing the GENII-1.485 software package on the Linux platform. [Note that GENII-1.485 was distributed as RSICC package identifier C00601IBMPC02 and has been replaced in the RSICC collection with GENII 2.06 from PNL (C00737PC58600).] The GENII portion of the GENII-LIN package contains the program which was developed to incorporate the internal dosimetry models recommended by the International Commission on Radiological Protection (ICRP) into the environmental pathway analysis models used at Hanford. GENII, is a coupled system of six programs (ENV, ENVIN, DOSE, INTDF, EXTDF, DITTY) and the associated data libraries that comprise the Hanford Dosimetry System (Generation II) to estimate potential radiation doses to individuals or populations from both routine and accidental releases of radionuclides to air or water and residual contamination from spills or decontamination operations.
GENII-LIN 2.0 came with a new set of programs (ENV13, INTDF13, EXTDF13, DOSE13) and associated data libraries. It keeps all the capabilities of GENII-1.485 and incorporates into the existing environmental pathway analysis models the more recent internal dosimetry models recommended by the ICRP 72 and the radiological risk estimating procedures of FGR13.
GENII-LIN-2.1 is primarily a maintenance release with several bug fixes and improvements. Among them
5. METHOD OF SOLUTION
ENVIN controls the reading and organization of the input files for ENV, which then calculates the environmental transfer, uptake, and human exposure to radionuclides that result from the chosen scenario for the defined source term. ENV writes the annual media concentrations and intake rates to an intermediate data transfer file for use by DOSE. DOSE converts these data to radiation dose, calculating the external dose using factors generated by EXTDF and the internal dose using factors generated in INTDF. DOSE calculates the one-year dose, committed dose, cumulative dose, and maximum annual dose and prepares the normal output report of doses and optional doses by pathway and by radionuclide.
ENV13 is an updated version of the original module ENV. It writes the annual media concentrations and intake rates to intermediate data transfer files for use by DOSE13. DOSE13 is an updated version of DOSE. Converts data from ENV13 to radiation dose, calculating the external dose using factors generated by EXTDF13 and the internal dose using factors generated in INTDF13. DOSE13 calculates the one-year dose, committed dose, cumulative dose, and maximum annual dose and prepares the normal output report of doses and optional doses by pathway and by radionuclide. It provides risk estimates for health effects to individuals or populations, by applying appropriate risk factors to the effective dose equivalent or organ dose; for ease future development, it has been splitted into six independent modules (DOSE1, DOSE2, DOSE3, DOSE4, DOSE5, DOSE6) which are called depending on the age class considered. EXTDF13 is an updated version of EXTDF. It uses the same point kernel integration technique. It uses more recent and detailed data libraries, calculates the dose rate factors for each organ and organizes data for cancer risk calculation. INTDF13 is a full replacement of the original INTDF module. It reads the absorbed dose rate libraries, available from FGR 13, and calculates the incremental organ equivalent doses for any year following an initial intake. For each of the six ages considered, one output file is generated containing yearly incremental dose to each of 29 organs.
The GENII-LIN system includes a wizard-like graphical user interface written in c++, built on the Qt libraries by Trolltech, which allows the user to effectively address the parameters required for scenario generation and data input, internal and external dose factor generators, and environmental dosimetry programs.
A series of well-ordered screens steps the user through the process of problem definition and selection of options for setting up the files for input to the environmental dosimetry programs and dose factor generators and all the necessary processing files to manage the file handling needed to control the operations of the five subsequent modules. As may be required for each of the selected options, GENII-LIN activates other pages to control input of parameters for user selected scenarios.
Information transferring between computational modules is done through the data communication files.These files are supplied by the user through the GUI or generated by the computational modules to provide information to subsequent modules. The content and format of these files is defined by the requirements of the GENII-LIN software package. The computational modules must read and write information consistent with these requirements. The user can modify the content of the files with a text editor but not the format.
GENII-LIN comes with both text and graphical full featured file viewers for output management. The plots produced are fully customizable, by changing fonts and colors, and can be printed, copied to clipboard or saved with several formats (bmp, jpeg, tiff, eps...).
6. RESTRICTIONS AND LIMITATIONS
Maximum of 100 radionuclides, 16 sectors, 10 distance intervals, and 5 shields
7. TYPICAL RUNNING TIMES
Few minutes
8. COMPUTER HARDWARE REQUIREMENTS
GENII-LIN requires an Intel Pentium or equivalent PC running Linux. Both 32bit and 64bit systems are supported.
9. COMPUTER SOFTWARE REQUIREMENTS
GENII-LIN runs under Linux on an Intel Pentium or equivalent PC; both 32bit and 64bit systems are supported. Required software includes gfortran compiler, for the GENII portion of the code, and GNU C++ Compiler, g++, for the GUI; and Qt3 libraries by Trolltech. Included 32 bit pre-built binaries were built on a Pentium IV PC running SuSE 10.2 (Qt 3.3.8). 64 bit binaries were built on an AMD Athlon(tm) 64 X2 Dual Core Processor 3600+ running SuSE 10.3 (Qt 3.3.8). Genii-Lin2 was tested at RSICC on an AMD Opteron under RedHat Enterprise Linux 4 with gcc/g++ Version 3.4.6 compilers and Qt 3.3.3 libraries.
10. REFERENCES
10.a Included in documentation:
M. Sumini, F. Teodori, N. Cantoro, “GENII-LIN: a New Object-Oriented Interface for the GENII Code,” University of Bologna Informal Paper (November 2004).
These 2 reports document the GENII 1.485 code:
B. A. Napier, R.A. Peloquin, D. L. Strenge, and J. V. Ramsdell, "GENII-The Hanford Experimental Radiation Dosimetry Software System, Volume 1: Conceptual Representation," PNL- 6584 Vol. 1 (December 1988).
B. A. Napier, R.A. Peloquin, D. L. Strenge, and J. V. Ramsdell, "GENII- The Hanford Environmental Radiation Dosimetry Software System, Volume 2: Users' Manual," PNL-6584 Vol. 2 (November 1988).
10.b Publications on Genii-Lin (not included in distribution):
M. Sumini, F. Teodori, N. Cantoro, “GENII-LIN: a New Object-Oriented Interface for the GENII Code,” Proceedings of ICRS-2004, Madeira (2004).
M. Sumini, F. Teodori, N. Cantoro, “GENII-LIN: a New Object-Oriented Interface
for the GENII Code,” Radiation Protection Dosimetry, 116, 1-4, pp
597-600 (2005).
M. Sumini, F. Teodori, “GENII-LIN: a Multipurpose Health Physics Code Built on
GENII-1.485,” Proceedings of CITSA 2005, Orlando (July 2005).
Marco Sumini, Francesco Teodori, Nicola Cantoro, “GENII-LIN an Object Oriented
Health Physics Code for the Linux Operating System,” Proceedings of RPSD 2006, Carlsbad (NM) (April 2006).
11. CONTENTS OF CODE PACKAGE
The package is distributed on CD in a GNU compressed tar file with documentation and the following files:
FGR13LIBS.tgz
FILES32.tar - pre-built linux binaries for 32 bit systems
FILES64.tar - the pre-built linux binaries for 64 bit systems
install.sh
12. DATE OF ABSTRACT
November 2006, revised July 2008.
KEYWORDS:ENVIRONMENTAL DOSE; FISSION PRODUCT INVENTORY; INTERNAL DOSE; LIQUID PATHWAY; RADIOACTIVITY RELEASE; RADIOLOGICAL SAFETY; RADIONUCLIDES.