TRiP98 VOI command
| GSI Biophysics | TRiP98 long write-up |

VOI


voi | item / import()   list      debug
             export()   delete
             read       display
             write      inspect
             prefix() 
             select() 
             maxdosefraction() 
             weightfactor() 
             oarset oarclr

Purpose

Handles input and output of Volumes of Interest (VOIs), that is, as a set of contours describing target volume and sensitive structures.

Parameters

item
For read:
Specifies a single or a comma-separated list of items, interpreted as stem(s) of file name(s) (without extension .VDX) containing VOI information. Lists of VOI files require the single files to be compatible (same base grid).
VOIs come as text data files (<file>.VDX ) together with a text header file (<file>.HED).
For export(), delete write, inspect:
Specifies a list of single existing VOIs. You use "*" for "all" VOIs.
For import special file naming conventions apply (see there).
import()
isogray imports a bunch of VOI contours in IsoGray format. Only their stem name may be given, and only the files <file>*.str, <file>*.ctr will be considered. Note that CT slices in IsoGray format should be imported first, since some important information is available only in these.
select()
For read only: Specifies a (comma-separated) list of VOIs to be selected when the input file(s) are read. If multiple files are to be read a semicolon may be used to select different VOIs from different files.
export(fmt)
Exports current VOIs as specified by item in some other format. At present only gd is foreseen, to be plotted with the gd program. File naming convention:
<prefix><patient>voi.gd
read
Read VOIs as specified by item
write
Writes the current VOIs as specified by item. File naming convention:
<prefix><patient><vvv>.vdx
where normally <vvv>=000. If a CT exists with the same name stem and version number, <vvv> is incremented until uniqueness can be achieved. Beyond <vvv>=099 the command will fail.
prefix()
For export(), write: filename prefix.
oarset, oarclr
Marks (unmarks) the specified VOIs as being an organ-at-risk to be accounted for during optimization.
maxdosefraction(mdf)
Defines an upper dose limit, as a fraction of the prescribed target dose, for the specified VOI, to be considered during optimization, provided the VOI is an OAR.
weightfactor(wf)
A VOI-specific weight factor is applied in addition to the global weight factor. wf<1 increases the virtual error bars and hence de-emphasizes the VOI.
list
Show some internal info about the currently loaded VOIs.
delete
Deletes the specified VOIs from memory (not from file).
display
Displays the specified VOIs. Not yet implemented.
inspect
Show some internal info about the specified VOIs.
debug
Debug switch. Lots of output !

Remark

The header files (.HED) are often shared between CT and VOI data.

Examples

  1. voi OTTOT3000 / read
    
    Reads VOI (files OTTOT3000.VDX and OTTOT3000.HED) for patient "OTTOT3".
  2. voi target / export(gd) prefix(/tmp/)
    
    Exports the single VOI target in gd format. Filename is /tmp/<patient>.voi.gd
  3. voi cpd104,cdp401 /read select(boost,hirnstamm;rand)
    
    Select the structures boost and hirnstamm from the file cpd104.vdx and rand from the file cdp401.vdx
  4.  voi "/u/therapy/CBG135/CBG135000" / read select(boost,brainstem)
     voi brainstem / maxdosefraction(0.5) oarset
     voi * /list
    
    Selects volumes boost and brainstem from the VOIs found in the specified file. boost is the target volume, brainstem an organ-at-risk with a maximum dose of 50% of the target dose, when optimized with multiple fields.
  5. ct  "ISOGRAY/80325" /import(isogray)
    voi "ISOGRAY/20060" /import(isogray)
    
    Imports IsoGray CT slices first, then VOI contours from 20060*.str, 20060*.ctr, stored in directory ISOGRAY

| GSI Biophysics | TRiP98 long write-up |
Last updated:
$Id: trip98cmdvoi.html,v 1.10 2009/03/13 17:26:19 kraemer Exp $
M.Kraemer@gsi.de