Files.. 1

Shared Library Files. 1

X Resource Files. 1

Run Time File. 1

Other Data Files. 1

Resources Directory Files. 2

Testing Utilities.. 2

 

Files

Shared Library Files

This program uses the radiation therapy library file librtgen.so.  This file must be moved or copied to /usr/lib.  The other library files used are the field dose shared library librfd.so, and the System2100 shared library librlgen.so, which must also be in /usr/lib.  Lastly, the PNG image file library librlpng.so must be moved to /usr/lib.

X Resource Files

The X resource file is DosimetryCheckRes and must reside either in the home directory or in /usr/lib/X11/app-defaults.  The Field Dose resource file FieldDoseRes and the System2100Res resource files are also needed.  If the resource files are only in the home directory, then the user must log into the home directory for the program to successfully find the resouce files.  This is an X function, and X generates no error messages if a resource file cannot be found.

Run Time File

The run time file is DosimetryCheck and can be invoked from the keyboard.  The program uses the System2100 program resources file system and looks for the file rlresources.dir.loc to locate where the program resouce directory is. 

 

Program ReadRtogCheck is provided to read in treatment plans written in RTOG format.  This is a ASCII program and is invoked with the flag -d followed by the directory where the RTOG files are.  For example:   ReadRtogCheck  -d  rtog.dir.  This program is described in a separate section in this manual.

Other Data Files

Data files are stored in the directory located by the file DataDir.loc in the program resources directory (see Sysem2100 documentation).  Subdirectories used are:

1.      CalDCur.d for storing calibration curves.

2.      CalFieldDose.d for storing ion chamber and diode calibration files.

3.      DenCur.d for storing pixel to density conversion curves.

4.      StSp.d for storing step strip files.

Resources Directory Files

Specific files of interest in the program resources directory are:

1.      BeamData.loc that locates where beam data is stored.

2.      DataDir.loc, specifying the location of the above data directory.

3.      DefaultBeamColor defines the default color used to display beams.

4.      DoseDisplay defines default parameters for the display of 2d isodose curves and 3d dose clouds.

5.      Kernels.loc specifies where Monte Carlo calculated kernels are stored.

6.      TenPercentIsodose specifies default values for some isodose displays.

Testing Utilities

Several utilities are provided for testing.

 

Program ComputePolyCAFiles will compute the dose for the same central axis points used to generate the pencil kernel.  A report file is written and stored in the beam data directory under the energy selected (see Beam Data Files).

 

Program CreateSquareCTScan will generate a simulated CT scan that is square in shape.  Square or circular regions of inhomogeneity may be created inside the water density square.  The result may be used to create a stacked image set for testing purposes.

 

Program GenerateFieldDoseImage will simulate a measured x-ray field by computing the same from a beam model.  Rectangular and asymmetric fields may be generated.  Shielding blocks can be simulated as well.  The format for a block to be read by program GenerateFieldDoseImage is specified here with the example file:

 

80.0  .039  5

 0.80  3.20

-0.80  3.20

-0.80 -3.20

 0.80 -3.20

 0.80  3.20

 

The first number is the distance that the block contour is defined at.  Next follows the transmission through the block.  Next is the number of block contour points.  This is to be followed with the required number of data pairs, x,y coordinates in cm, where the origin is at the central axis.  This file is not read under the ASCII file standard in that comments are not supported.