Virtual Cell Virtual Cell WebsiteSchool of Health Sciences WebsitePurdue University Website
About the Virtual CellDownload VCExamplesTheoryUser ManualHelpExecute VC Simulation
Debugging exposure scenarios with the RIO utility code
How to set up radiation exposure scenarios

RIO is a utility code that can be downloaded and installed with other VC software. This utility code can be especially useful when attempting to setup and debug complicated exposure scenario.

Purpose

RIO (short for RADX input/output) is a utility code that can be used to help setup and debug RADX exposure scenarios. The RIO application reads a set of RADX input parameters from a user specified ASCII file and then outputs dose and dose-rate information to another ASCII file in a format suitable for plotting. Additional diagnostic and summary information about the input exposure scenarios is printed to the output file as well. Finally, the RIO application serves as a simple tutorial on the use of RADX module routines and input files in other VC applications.

Getting Started

First download and install a copy of the RIO software and sample input files on your local computer (click here to jump to the software download area). The RIO application is a so-called command line utility so it is best to execute it from a DOS/Windows or Unix command line prompt (refer to your operating system documentation or local expert if this is a complete mystery to you). To execute the utility code, simply type the word RIO and press the enter key. The RIO application will prompt you for the name of an input file (e.g., test1.inp).

Enter the name of an (ASCII) input file and press return. If you did all of these steps correctly, you should see something like:

The RADX modules interpretation of your exposure scenarios will be written to the test1.out ASCII file in addition to the binary files to be used by VC. Use any ASCII file editor (e.g., the MS Windows notepad or WordPad application) to view/print the contents of the output file.

Program usage

RIO <source file> <radx file> -<command line option>
RIO -H

OPTIONS:
A: append scenarios to end of existing RADX file.
S: silent program execution
H: program help

EXAMPLES:
RIO [interactive program input]
RIO myapp.inp -S [silent execution]
RIO myapp.inp myapp.radx -A [append scenarios]
RIO myapp.radx [run with default options]
RIO -H [program help]

Sample Input and Output Files (Click on the buttons to view files)
 
Example 1.1
INPUT
Example 1.4
INPUT
Example 2.1
INPUT
Example 3.1
INPUT
Example 4.2
INPUT
OUTPUT
OUTPUT
OUTPUT
OUTPUT
OUTPUT
Example 1.2
INPUT
Example 1.5
INPUT
Example 2.2
INPUT
Example 3.2
INPUT
Example 4.3
INPUT
OUTPUT
OUTPUT
OUTPUT
OUTPUT
OUTPUT
Example 1.3
INPUT
Example 1.6
INPUT
Example 2.3
INPUT
Example 4.1
INPUT
Example 4.4
INPUT
OUTPUT
OUTPUT
OUTPUT
OUTPUT
OUTPUT

These examples are discussed in details in Tutorial 1, Tutorial 2, Tutorial 3, and Tutorial 4.

School of Health Sciences
Purdue University
Disclaimer

Last updated: 10 June, 2011
Webmaster