TRiP98 VOI command
voi | item / import() list debug
create4dvoi voistate() bin
bininflate binconvert binexpand
bindelete() binupdatewdw() binsetname()
binsetdesc() binbuildunion() bincrop()
Handles input and output of Volumes of Interest (VOIs), that is,
as a set of contours describing target volume and sensitive structures.
Specifies a single or a comma-separated list of items,
interpreted as stem(s) of file name(s) (without extension
containing VOI information.
Lists of VOI files require the single files to be compatible (same
come as text data files (
<file>.VDX ) together with
a text header file (
For export(), delete
Specifies a list of single existing VOIs.
"*" for "all" VOIs.
For import special file naming conventions
apply (see there).
isogray imports a bunch of VOI contours
format. Only their stem name may be given, and only the files
will be considered.
CT slices in
IsoGray format should be
first, since some important information is available only in these.
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.
Exports current VOIs as specified by item in some other format.
At present only
gd is foreseen, to be plotted with the
File naming convention:
Read VOIs as specified by item
Writes the current VOIs as specified by item.
File naming convention:
If a CT exists with the same name stem and version number,
<vvv> is incremented until uniqueness can be achieved.
<vvv>=099 the command will fail.
For export(), write:
- oarset, oarclr
Marks (unmarks) the specified VOIs as being an organ-at-risk
to be accounted for during
Defines an upper dose limit, as a fraction of the prescribed target dose,
for the specified VOI,
to be considered during
provided the VOI is an OAR.
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.
Show some internal info about the currently loaded VOIs.
Deletes the specified VOIs from memory (not from file).
Displays the specified VOIs. Not yet implemented.
Show some internal info about the specified VOIs.
Debug switch. Lots of output !
This parameter is similar in its function to the
With the additional parameter
the actual state of the VOI must be
specified. After that a given transformation builds the VOI's in all other
Specifies the state in which the VOI actual is. Needed to create a 4D-VOI
from a 3D one (
Can only be used in combination with the read or write flag. It forces the
use of a binary VOI instead of using the classical polygon-based VOIs.
If binary VOIs are in use by TRiP, they are mostly reduced in size to an
absolute minimum. So very little memory is needed for the running program. If
a binary VOI is saved, it could be useful to save its position in the
coordinate system. A cube, in which a binary VOI is saved, can't provide
this. Only if you expand the VOI to the original cube size and put it on the
right position, you can store its position. (Needs lots of space on the disk,
was simple to implement and nothing aditional must be developed.)
With this flag its possible to create a binary VOI from a wdw based VOI. So
the advantages of binary VOIs can be used for wdw based VOIs, too.
If the space for a binary VOI is to small and the transformation of it moves
the VOI outside, expand the range around the VOI, so that the transformation
can be done successfully. The amount of the widening can be specified.
Otherwise 1.0 as default value is used.
Specify a binary VOI or a list of binary VOIs by their names and delete them. Use a
comma separated list of bin voi names in the bracket.
Specify a binary VOI by its name and transform it into a wdw (old version of
With this flag you are able to give a binary VOI a new name.
voiname a description
Merges the VOIs in list
voi1,voi2,... to a single, larger VOI.
Trims unused margins and thus reduces RAM requirements and
speeds up some calculations as well.
For 3D configurations
the header files (
.HED) are often shared between CT and VOI data.
voi OTTOT3000 / read
Reads VOI (files
OTTOT3000.HED) for patient "OTTOT3".
voi target / export(gd) prefix(/tmp/)
Exports the single VOI
voi cpd104,cdp401 /read select(boost,hirnstamm;rand)
Select the structures
from the file
from the file
voi "/u/therapy/CBG135/CBG135000" / read select(boost,brainstem)
voi brainstem / maxdosefraction(0.5) oarset
voi * /list
from the VOIs found in the specified file.
boost is the target volume,
an organ-at-risk with a maximum dose of 50% of the target dose,
when optimized with multiple fields.
ct "ISOGRAY/80325" /import(isogray)
voi "ISOGRAY/20060" /import(isogray)
IsoGray CT slices first,
then VOI contours from
stored in directory
voi "binvoi" /read bin
Forces the read command to read a binary voi instead of a normal voi.
voi "normalVoi" /read
trafo "transformation" /read
voi /create4dvoi voistate(4)
This is an example how to create a 4D VOI from a 3D one
by means of a transformation prescription (
Voistate() parameter specifies in which state
the original 3D VOI is assumed to be.
$Id: trip98cmdvoi.html,v 1.13 2011/03/08 19:02:46 kraemer Exp $