Beam Configuration 16.0 Reference Guide
Beam Configuration 16.0 Reference Guide
Eclipse
Publication Title
Beam Configuration Reference Guide
Abstract
This document provides reference information and procedures for using the Beam Configuration application, version 16.0.
This publication is the English-language original.
Trademarks
® ® ™ ™
CadPlan and Varian are registered trademarks, Eclipse and Enhanced Dynamic Wedge are trademarks of Varian
Medical Systems, Inc.
®
Microsoft is a registered trademark of Microsoft Corporation.
All other trademarks or registered trademarks are the property of their respective owners.
Copyright
© 2001-2019 Varian Medical Systems, Inc. All rights reserved. Published in Finland
No part of this publication may be reproduced, translated, or transmitted without the express written permission of Varian
Medical Systems, Inc.
Notice
Information in this publication is subject to change without notice and does not represent a commitment on the part of
Varian. Varian is not liable for errors contained in this publication or for incidental or consequential damages in connection
with furnishing or use of this material.
Electronic Labeling
This symbol on the label indicates that the Instructions for Use for the corresponding product are available at
www.MyVarian.com. Access the Instructions for Use in electronic form by logging in with your assigned MyVarian user
credentials.
In compliance with Anvisa and EU regulations, Varian will send Brazil and EU customers a
free printed copy of the Instructions for Use within 7 days. Use the “Paper Publication Re-
quest” form provided on the Varian webpage to order your copy.
Legal Manufacturer
Varian Medical Systems, Inc.
3100 Hansen Way
Palo Alto, CA 94304
United States of America
CAUTION: US Federal law restricts this device to sale by or on the order of a physician.
13485
Medical Device
IEC 62083
™
Eclipse Treatment Planning System is IEC 62083 compliant.
2797
Legal Information 3
Table of Contents
Introduction ................................................................................................................... 7
Information in This Guide .................................................................................................................. 7
Who Should Read This Guide ........................................................................................................... 7
Visual Cues ....................................................................................................................................... 8
Related Publications .......................................................................................................................... 8
Contact Varian Customer Support ..................................................................................................... 9
Table of Contents 5
Approving and Unapproving the Configured Beam Data ................................................................ 43
Approve Beam Data ............................................................................................................... 45
Unapprove Beam Data ........................................................................................................... 45
CT Calibration ............................................................................................................. 46
About CT Calibration ....................................................................................................................... 46
Converting CT Numbers to Electron and Mass Densities ............................................................... 46
Changing the CT Calibration ........................................................................................................... 47
Change the CT Calibration Curve .......................................................................................... 48
Modify the CT Calibration Curve with the Curve Editor .......................................................... 48
Index .......................................................................................................................... 67
WARNING: Beam Configuration should be used only by persons who are qualified in
radiation physics and are familiar with dose measurements.
CAUTION: It is the responsibility of the user to ensure the validity and integrity of the
input data, and to understand that the quality of the output depends
critically on the quality of the input. Any irregularities or uncertainties about
input data, units, identification, or quality of any other nature shall be
thoroughly investigated before the data are used.
CAUTION: Do not use the computer operating system to edit or delete any files used
by the treatment planning application except when the use of the files is
detailed and supported in the user documentation of the manufacturer of
the treatment planning system.
NOTICE: Regional Settings in the Windows operating system using commas as the
decimal separator are not recognized by Eclipse. For example, the entry
“1,23” will not be recognized as “1.23”. The decimal point “.” should always
be used regardless of the Regional Settings.
Introduction 7
Visual Cues
This publication uses the following visual cues to help you find information:
WARNING: A warning describes actions or conditions that can result in serious injury
or death.
Note: A note describes information that may pertain to only some conditions, readers, or sites.
Tip: A tip describes useful but optional information such as a shortcut, reminder, or suggestion,
to help get optimal performance from the equipment or software.
Related Publications
● Eclipse Photon and Electron Reference Guide: Provides reference information for using
the Eclipse treatment planning system and instructions for tasks performed outside the
daily treatment planning workflow.
● Eclipse Proton Reference Guide: Provides reference information for using the Eclipse
treatment planning system and instructions for tasks performed outside the daily proton
treatment planning workflow.
● Eclipse Photon and Electron Algorithms Reference Guide: Describes algorithms
supported in the Eclipse treatment planning system.
● Eclipse Proton Algorithms Reference Guide: Describes algorithms supported in the
Eclipse treatment planning system for proton planning.
● RT and Imaging Online Help: Describes the functions available in Radiation Oncology
applications and provides instructions for using them.
● Varian Service Portal User Rights Reference Guide: Describes the administration of
users, user groups and user rights for Varian ARIA Oncology Information System (OIS)
applications, except for 4D Integrated Treatment Console.
● Varian Service Portal Administration Reference Guide: Describes the global configuration
and management of the shared system, user, licensing, database, security, maintenance,
and radiation therapy settings for ARIA Oncology Information System (OIS) for Radiation
Oncology (RO) modules and applications, and ARIA OIS for Medical Oncology (MO).
● DICOM Import and Export Reference Guide: Contains information on using the DICOM
Import and Export application.
● Varian Medical Systems Backup Guidelines (CTB-GE-936): Provides general information
about data backup processes and more detailed information in regards to Varian system
backups.
Introduction 9
Quick Overview of Beam Data Configuration
Note: For information on the beam configuration with CadPlan beam data, refer to the user
documentation of Eclipse version 11.0 or 13.0.
Beam Configuration
Beam Configuration is designed for the entry of measured dosimetric beam data and automatic
generation of beam data files for external treatment planning. Measured beam data can be
imported to Beam Configuration from a water phantom device in the w2CAD file format or the
data can be entered manually. The measured beam data is converted into the format required for
dose calculation. The measured beam data and the configured beam data can be analyzed using
the beam analysis tools. Potential deviations between the measured and calculated data are
shown by means of a differential graph and a statistical report.
WARNING: Beam Configuration should be used only by persons who are qualified in
radiation physics and are familiar with dose measurements.
CAUTION: Be careful that the measured beam data that is used for the configuration
corresponds to the characteristics of the treatment unit. When
modifications are made to the treatment unit, make sure that the measured
beam data still corresponds to the treatment unit.
Note: Full functionality Beam Configuration is restricted to user access right groups Physicist,
Service, System Administrator, and All Rights. Make sure that these user access rights are not
assigned to unauthorized persons.
Beam Configuration supports configuring multiple calculation models and energies of different
modalities and provides integration with the database that contains the treatment machine
definitions.
WARNING: The system uses a central database that allows running the application on
different workstations simultaneously. If multiple simultaneous users work
with the same data, this may lead to situations where another user has
modified and saved the data that you are currently working with. Therefore,
avoid situations with multiple users concurrently editing the same data. If
you try to save your changes, the system will issue a warning message
about another user already editing the same data. Always carefully verify
the synchronized data, because it may contain changes made by both you
and the other user.
3
5
1. Menu bar
2. Toolbar
3. Context Window
4. Object Window
5. Data Windows
1
2
1. Menu bar
2. Toolbar
3. Context Window
4. Object Window
5. Data Windows
1. Scope Window
2. Focus Window
3. Selected object
In the figure, the treatment unit forms the top of the hierarchy. Beneath the treatment unit are
several photon and electron energies each with one or several calculation models configured.
Moreover, beam data objects with an invalid checksum value are shown with a yellow
background in their icon.
The contents of the Focus Window are linked to the object selected in the Scope Window. In
this example, a treatment unit configured for a calculation model is selected in the Scope
Window, and its contents are shown in the Focus Window.
The approval state of the beam data is indicated by a colored frame around the data icons
displayed in the Context Window. Configured beam data can be in three possible states: Empty,
Approved and Unapproved. The green boxes shown in the figure indicate that the beam data is
approved.
Related Topics
Beam Data and Checksums on page 17
NOTICE: Apart from saving your work regularly, create regular backups of your
system to avoid losing important information. The regular backups should
contain patient database including image directories, dosimetric data, and
beam data.
Note: After making changes to beam data in Beam Configuration, make sure that all Eclipse
applications are restarted to enforce the changes to the beam data that is used in treatment
planning.
1. Parameters
2. Measured Profiles
3. Spectrum
To resolve an invalid checksum and take the affected configured beam data back into use, you
need to unapprove the data, and then verify and revalidate it. In the process of unapproving the
beam data, all data that has dependencies on the affected beam data is deleted, and a message
is shown listing the data to be deleted.
Related Topics
Context Window in Beam Configuration on page 15
NOTICE: Use the same file naming conventions in beam data measurements (input
files) and in Beam Configuration (Therapy Unit name), and name the
input files so that it is easy to match the beam data to the treatment unit
during the configuration process.
Related Topics
Loading Parameter Values from the Database for a Calculation Model on page 32
NOTICE: To detect possible errors occurring when importing measured beam data,
always compare the configured beam data with the measured beam data.
NOTICE: Use the same file naming conventions in beam data measurements (input
files) and in Beam Configuration (Therapy Unit name), and name the
input files so that it is easy to match the beam data to the treatment unit
during the configuration process.
Related Topics
Assigning Beam Data on page 33
Copying Beam Data on page 33
Related Topics
Configuring Add-on Data on page 29
1. In the Focus Window, select the add-on for which you want to import the measured data.
2. Choose File > Import and then the measured data you wish to import.
2 3 4
1
5
1. Navigate to the folder containing the w2CAD files in this list box
2. Select the w2CAD file or files in this box
3. Displays the measurements in the selected w2CAD files
4. Select the measurements for preview in the data view
5. Select this check box to view the curves during the import
6. Preview the selected measured data in these boxes
3. In the Look in list box, navigate to the folder containing the files to be imported, and select a
file or multiple files.
To see a preview of the measurements contained in the files, select a measurement in the
Measurements in selected files box.
4. To view each individual curve when the data is imported, select the Review data curves
during import check box. You can decide for each curve, if you want to import it or not.
5. Click OK to start the import.
All measurements in the selected file(s) will be imported.
Note: If you notice errors in the measured data, stop the import process. Trace the source of
the error to a problem in the measured data, and correct the measured data before resuming
the import procedure.
Related Topics
Verifying Configured Beam Data on page 27
1 4
2 5
4. To navigate to the directory containing the Eclipse beam data, click Browse.
Navigate to the level of general data files of the calculation model. This level is above the
folders containing the configured beam data files. For instance, the general data folder may
be named “AAA”, and the configured data folders below it “000”, “001”, “002”, and so on. You
should navigate to the folder named “AAA” in this case.
5. In the list box on the left, select the data set containing the Eclipse beam data to import.
You can review some parameters of the data set in the list box on the right.
6. In the Into beam data box, define a name for the beam data.
Related Topics
Verifying Configured Beam Data on page 27
File Hierarchy in Beam Configuration on page 63
Match and Assign Add-On Data on page 31
Adding New Beam Data on page 20
Related Topics
Editing Configured Beam Data on page 28
Note: After making changes to beam data in Beam Configuration, make sure that all Eclipse
applications are restarted to enforce the changes to the beam data that is used in treatment
planning.
Related Topics
Verifying Configured Beam Data on page 27
Related Topics
Verifying Configured Beam Data on page 27
NOTICE: To detect possible errors occurring when importing measured beam data,
always compare the configured beam data with the measured beam data.
Note: Manual changes made to the measured or configured beam data curves do not
automatically invalidate the previously configured data. If you modify beam data manually,
make sure you take the necessary configuration steps again to re-generate the configured data
from the edited data.
Related Topics
Editing Configured Beam Data on page 28
The lower data window displays the selected curve. The upper data window displays all
curves contained in the selected beam data.
Tip: The normalization type for the displayed curve depends on the selected algorithm. More
information: Eclipse Photon and Electron Algorithms Reference Guide or Eclipse Proton
Algorithms Reference Guide.
3. To show the data points along the curve, click Show Data Points .
4. Review the data curves.
Related Topics
Editing Configured Beam Data on page 28
1 2
The point values along the curve are shown in the left part of the Curve Editor; the data curve
itself in the right part. You can move the points by typing new values.
The Curve Editor can also be used to view approved beam data, which is read-only.
Edit and View Beam Data Curves with the Curve Editor
1. In the Focus Window under an add-on, select the item containing the curve to edit.
2. In the Object Window, select the curve to edit.
5. Click OK.
Related Topics
Generating Configured Beam Data on page 26
Edit and View Beam Data Curves with the Curve Editor on page 28
Table 1 Data Used for Automatic Add-On Matching for Photon/Electron Treatment Units
Add-On Data
Standard wedge Wedge angles
Enhanced Dynamic Wedge All data found for the add-on
Electron applicator Applicator sizes
Compensator Compensator materials
Cone set Cone applicators
Elekta motorized wedge All data found for the add-on
Elekta virtual wedge All data found for the add-on
Siemens virtual wedge All data found for the add-on
MLC MLC materials
Table 2 Data used for Automatic Add-on Matching for Proton Treatment Units
Add-On Data
Option Options
Lateral Spreader Lateral spreaders
Range Shifter Range shifters
Range Modulator Range modulators
Beam Spot Beam spots
Block Block materials
Compensator Compensator materials
MLC MLC materials
Tip: To remove an approved add-on, select the add-on in the Focus Window and choose
Edit > Clear.
Note: To skip an add-on, select None in the list. This may be necessary, if you later wish to
match the add-on manually.
d. Repeat until you have matched all add-ons.
After the last add-on, the Automatically Match Add-On Data dialog box closes.
Note: The match is valid for all wedges in the database with the selected angle.
Related Topics
Clear Beam Data on page 35
Load All Parameter Values from the Database for a Calculation Model
1. Choose Beam Data > Parameter Values > Get All Parameters from Database.
If there are differences between the values saved in Beam Configuration and the default
values stored in the database, a message box opens, listing the parameter values found in
Beam Configuration and values found in the database. If there are no differences, the
message box simply states this.
2. To close the message box and complete the action, click OK.
Note: Assigning beam data from another treatment unit also means that any change performed
to the calculation model will affect all treatment units sharing the same beam data. Notice that
you can also copy beam data from one treatment unit to another, which creates an independent
calculation model.
Related Topics
Copying Beam Data on page 33
Note: If your system has a group or groups of dosimetrically equivalent machines configured,
after choosing Insert > New Beam Data, you are prompted to confirm whether you wish to
assign the beam data from one of the equivalent machines. You can then select the equivalent
machine from which you wish to use the beam data and move on to matching and assigning the
add-on data.
Note: If your system has a group or groups of dosimetrically equivalent machines configured,
after choosing Insert > New Beam Data, you are prompted to confirm whether you wish to
copy the beam data from one of the equivalent machines. You can then select the equivalent
machine from which you wish to copy the beam data and move on to matching and assigning
the add-on data.
Related Topics
Match and Assign Add-On Data on page 31
Note: The preferred method in making beam data changes is to modify the original measured
beam data files and re-import modified files to Beam Configuration.
1. In the Focus Window, right-click a configured beam data object and then choose Set Data
as Modified.
2. Confirm the modification and click Set to Modified State.
Information Example
Number of measurements $NUMS 1
Direction direction: 0 0 1
In addition, the curve export files contain information about the selected curve, such as the field
size, depth, direction, or the measurement depth, depending on the selected curve.
Information Example
Treatment unit (configured in RT Administration) machine: D_Varian23EX, 6X
In addition, the export files contain information about the particular data, such as the SSD, the
SPD or the calibration date, depending on the type of data exported.
Note: If the calibration curves of the default CT scanner do not correspond to unit density at
HU = 0, the dose calculation in Beam Analysis will not correspond to a water-equivalent
situation.
where
Dm(x) = Measured dose at the point x
Dc(x) = Calculated dose at the point x
The following quality parameters are calculated to indicate the quality of the beam data:
● Photon and electron beam data
● Distance (in millimeters) to agreement of the 100% dose point (dmax)
● Distance (in millimeters) to agreement of the 50% dose point
2 3
1. Graphical overlay
2. Dose differences plot
3. Table of numerical comparison parameters
2 3
1. Graphical overlay
2. Dose difference plot
3. Table of numerical comparison parameters
2
3
3. Select the desired calculation option group on the left side of the Calculation Options dialog
box.
4. Click the desired calculation option on the right side of the dialog box, and do one of the
following:
● Click the down-pointing arrowhead and choose a new value from the list.
● Type a new value in the text box.
5. Click OK.
WARNING: Beam data approved in Beam Configuration is available for clinical use
even though the beam data may not be fully commissioned.
The Approved status is indicated in the Focus Window by a green frame around the beam data
icons.
1 2
In this example, the beam data on the left is unapproved, and the beam data on the right is
approved. You can approve all beam data of a treatment unit by selecting the treatment unit in the
Focus Window and then approving the data. The Properties dialog shows more details about
the beam data, such as the date and time of approval.
Related Topics
Map File in Beam Configuration on page 64
About CT Calibration
You must create a valid CT calibration curve for each CT scanner added to the database. This
calibration curve is used to do the following:
● Conversion of the HU values in a CT image to electron or mass densities during dose
calculation.
● Conversion of HU values to electron density during DICOM import and export.
In Eclipse, you can assign a HU (CT value) to a structure. During DICOM export or
import, the HU value of the structure is converted to relative electron density. The relative
electron density is read from the electron density calibration curve defined for the CT
scanner.
To achieve accurate calculations, each CT scanner should have its own calibration curve, which
is applied only to the CT images created with this specific scanner. All used calibration curves
must be approved.
To obtain HU vs. calibration curves for an individual CT scanner, scan a phantom that contains a
sufficient range of materials with known mass density calibration, electron density or proton
stopping power data, or create a curve from theoretical considerations 1, 2, 3.
Note: Set the same HU value range for all CT calibration curves.
1 Chetty I.J., Curran B., Cygler J.E. et al., Report of the AAPM Task Group No. 105: Issues associated with clinical
implementation of Monte Carlo-based photon and electron external beam treatment planning. Med Phys 2007; 34:
4818–4853.
2 Schaffner B. and Pedroni E.: The precision of proton range calculations in proton radiotherapy treatment planning:
experimental verification of the relation between CT-HU and proton stopping power. Phys. Med. Biol. 1998 43,
1579.
3 Constantinou C., Harrington J.C., DeWerd L.A., An electron density calibration phantom for CT-based treatment
planning computers. Med Phys. 1992 Mar–Apr; 19 (2): 325–7.
where
ρω,ε = Electron density relative to the electron density of water
NCT = Dependence of the electron density from the electron density of
water on CT number
Related Topics
Change the CT Calibration Curve on page 48
NOTICE: Apart from saving your work regularly, create regular backups of your
system to avoid losing important information. The regular backups should
contain patient database including image directories, dosimetric data, and
beam data.
Note: After making changes to beam data in Beam Configuration, make sure that all Eclipse
applications are restarted to enforce the changes to the beam data that is used in treatment
planning.
Note: When editing a CT calibration curve, make sure that the Y-values are in increasing order.
Note: Always verify the CT calibration. Varian does not assume responsibility for the validity of
the CT calibration curve.
To verify that the CT calibration curve is correctly configured, take a CT image of the calibration
phantom, import it in the system and check that the values shown in the Physical Properties tab
of the Point Dose tool are correct.
Information about using the Physical Property tab: Eclipse Photon and Electron Reference
Guide.
4 ICRU Report 42, “Use of Computers in External Beam Radiotherapy Procedures with High Energy Photons and
Electrons”, p. 18
CT Calibration 47
Change the CT Calibration Curve
1. Choose Beam Data or Beam Analysis > CT Calibration.
2. To use the default scanner values (marked with X) for all calibration curves of a CT scanner,
select the scanner and click Reset Curves.
3. To use the default scanner values (marked with X) for a calibration curve, select the curve
and click Reset.
4. To view a comment regarding a curve, select the curve.
The comment is shown in the Description box.
5. To modify a CT calibration curve:
a. Select the curve and click Edit.
b. To view the values of a point, click any point on the curve.
The cursor moves to the data cell of the selected point.
c. Modify the points if necessary, and click OK.
6. To revert to the previously saved values, select the curve and click Reset.
7. To approve a CT calibration curve, select the curve and click Approve.
8. To cancel the approval of a CT calibration curve, select the curve and click Unapprove.
9. Click Close.
Related Topics
Modify the CT Calibration Curve with the Curve Editor on page 48
c. In the Density, Relative Density, or Value box, type the value for the new point.
d. Click OK to add the point to the curve.
2. To move a point, type a new value in its data cell.
3. To remove a point from the curve, click Delete Point.
Click Yes.
1 2
1. Workstation type 1
2. Workstation type 2
3. DCF server
4. Network
In the above example, workstations of type 1 have Eclipse installed. Each of these workstations
contain a local calculation configuration file that enables performing calculations on the
workstation. In addition to local calculations, these workstations can also perform remote
calculations on other workstations connected to the DCF network. Workstations of type 1 also
have an agent installed as a system service. Agents enable Eclipses on other workstations to
perform calculations on type 1 workstations. The agents use calculation configuration files located
in the DCF folder on the DCF server.
2 2
1 3
2 2
3 3
1. Eclipse
2. Servant (algorithm)
3. Agent
4. Distributor
Note: When defining calculation settings, remember that changing a global calculation setting
affects every workstation connected to the same DCF. Local calculation settings override the
global calculation settings on the current workstation.
Note: When defining calculation settings, remember that changing a global calculation setting
affects every workstation connected to the same DCF. Local calculation settings override the
global calculation settings on the current workstation.
Note: When defining calculation settings, remember that changing a global calculation setting
affects every workstation connected to the same DCF. Local calculation settings override the
global calculation settings on the current workstation.
Note: When defining calculation settings, remember that changing a global calculation setting
affects every workstation connected to the same DCF. Local calculation settings override the
global calculation settings on the current workstation.
Debug output
This setting is optional. If the value is set to true, the servants send extra information of their
progress and actions during calculation. The setting should only be used for debug purposes
since it can have an adverse effect on the calculation performance, and the amount of data sent
can be very large. The debug logs are generated in a folder in C:\VMSOS\Log\Application
\RTM\DCF\. Each DCF request generates a new subfolder named based on the date, time and
logged user (YYYY-MM-DD@HH.MM.SS.MSEC_UserName) under the previously mentioned folder
and detailed debug files are written to this folder. If the value is set to false or left empty, no debug
output is generated.
Related Topics
Distributed Calculation Framework on page 49
Tip: Removing a calculation model does not remove the configured beam data folder for the
calculation model. If you wish to create the same calculation model, you need to use a different
name for the configured beam data folder.
The following information is shown for each calculation model in the dialog box:
● Model Name—Calculation model name. In cases where several calculation models are
defined for a particular beam energy, each model is identified by its name.
● Algorithm—Name of the algorithm on which the model is based.
● Version—Version of the algorithm on which the model is based.
The version denotes the version of the algorithm that is used by this calculation model.
Changing the version here does not update the configured beam data for this model. If
the beam data is incompatible with the new version of the algorithm, you must re-
configure the beam data.
● Beam Data Directory—Directory on the DCF server where the beam data of the
calculation model is stored.
● Particles—Particle type of the calculation model (photon, electron, proton). This
information is read from the installation file of the algorithm and cannot be modified.
● Calculation Types—Calculation capabilities of the calculation model (for example, volume
dose, compensator, optimization). This information is read from the installation file of the
algorithm and cannot be modified.
● To use the beam data of another calculation model configured in the system, select the
Use same beam data as existing calculation model option and select the desired
calculation model from the list. To limit the list of algorithms shown in the list, select Only
show compatible calculation models.
● To copy the beam data from an old calculation model when upgrading data from an older
Eclipse, select the Copy beam data from old beam data directory option and then type
or navigate to the desired directory. Verify that the correct source folder is always used.
Note: If the selected old beam data has been configured in an earlier version of Beam
Configuration, you are prompted to update the data.
● In the Beam Data Directory text box, type the relative path of the directory where the
parameters from the selected existing algorithm are saved, navigate to the desired
directory, or use the path suggested.
6. To add the new calculation model, click Add.
If you selected the Copy beam data from existing calculation model option or the Copy
beam data from old beam data directory option, the beam data is updated, and a message
is shown describing which data types were modified in the update. Continue with the next
step.
Otherwise this is the last step and the calculation model is added.
7. Click Close in the message box describing which data types were modified in the update.
8. When prompted, do one of the following: To delete all calculated beam data, click Yes.
To keep the calculated beam data, click No.
9. In the message box prompting you to re-calculate all beam data, click OK.
10. Re-calculate the beam data.
Note: If you have plans that are calculated using the previously named calculation model and
you want to recalculate these plans, you must recalculate them using the new renamed
calculation model.
Note: The version denotes the version of the algorithm that is used by this calculation model.
Changing the version here does not update the configured beam data for this model. If the
beam data is incompatible with the new version of the algorithm, you must re-configure the
beam data.
5. Click OK.
6. To complete the version change, update the beam data using the Update Calculation Model
command, re-configure the beam data if necessary, and approve the beam data.
Related Topics
Update Calculation Models on page 60
Note: It is not possible to remove server side algorithm based models, such as MSS Leaf
Motion Calculator, Varian Leaf Motion Calculator, DVH Estimation, or Smart LMC. To disable
the use of these models, clear the Enabled check box.
Related Topics
Change the Version of the Algorithm for a Calculation Model on page 59
1. In the Configure Calculation Models dialog box, click Add Model to add a new calculation
model to use as a container for the updated beam data.
2. Type a descriptive name for the model.
3. Select the algorithm that the model will be based on.
4. Select the Copy beam data from existing calculation model option and select the existing
calculation model from the list.
To limit the list of algorithms shown in the list, select Only show compatible calculation
models.
The selected directory must contain the mapfile.txt file, which defines the treatment unit/
energy combination that each beam data subdirectory has been configured for. If the new
Eclipse version contains a treatment unit that has the same ID as the older version, the
correct beam data is automatically assigned to this treatment unit. Otherwise, you can
separately assign beam data for each treatment unit/energy combination.
5. Click Add.
6. When prompted, do one of the following: To delete all calculated beam data, click Yes.
To keep the calculated beam data, click No.
7. In the message box prompting you to re-calculate all beam data, click OK.
8. Re-calculate the beam data.
Related Topics
Assigning Beam Data on page 33
Add Calculation Models to the Configuration on page 58
The table describes the algorithm files that are created, edited and shown in Beam
Configuration and contained in the algorithm folders.
File Description
ConfigurationCalculationSpecification.xml
Related Topics
Distributed Calculation Framework on page 49
Note: The contents of the map file are managed by Beam Configuration and should not be
modified using a text editor. If you encounter a need to modify the file, inform Varian Medical
Systems.
The filename of the map file is mapfile.txt. The syntax of the map file is described below. The
text is read from the syntax file of the beam data files.
Data set tags, repeated for each treatment unit and associated add-ons
$StartOfDataSet Beginning of a data set section in a map file.
A data set describes the physical data files that belong to the con-
figured beam data. The beam data directory which contains the
files is always located in the same directory with the map file.
Data files always belong to the beam data or to add-on beam
data.
$EndOfDataSet End of a data set section in a map file.
Other parameters, de- Each entry contains the file name of the parameters file, approval
pending on the data type timestamp (date and time, approver, time zone, version of Beam
specification Configuration used for creating the file), approval code and
checksum.
AddOn: Data ID of the add-on. For instance, <00>.
Add-on entry, for instance, File name of the add-on file, approval timestamp (date and time,
<DPR>, or <WDD> approver, time zone), approval code and checksum. For instance,
DPR:<001_00_DPR.xml><ApproveTime="07.06.2013
12:21:45" Approver="physicist" TimeZone="UTC
+03:00 FLE Daylight Time"><1><1892969726>
It is recommended to use unambiguous date and time formatting. This can be achieved with the
Region and Language settings in Windows. Using a format like dd MMM yyyy for short dates in
the Customize Format dialog box will produce unambiguous date displays for the English locale,
for instance, “05 Sep 2013”.
If you have beam data files configured and approved in a Beam Configuration version earlier
than 13.0, the files do not have the timestamps described in the table. The approval code used
prior to version 13.0 is of the following format: <0> = unapproved; <1> = approved. For instance,
the map file entry for a model parameters file using the earlier approval code: Model
Parameters:<000.MODEL><BCVer="7.1.66"><0><161343607>.
Index 67
resolve invalid checksum 18 editing CT calibration curve 48
resolving 35 modifying beam data curves 28
unapprove beam data 18 overview 28
configuration file print-out 29
ConfigurationCalculationSpecification.xml customer support 9
63
crcfile.crc 63
datafiles.crc 63 D
datafiles.txt 63 data flow in Beam Configuration 12
hierarchy of configuration files 63 datafiles.crc 63
lockinginfo.txt 63 datafiles.txt file 63
logfile.txt 63 DCF (Distributed Calculation Framework)
mapfile.txt 63, 64 calculation settings 52
progressfile.txt 63 configuration storage rules 56
structure of configuration files 63 configuring global settings 55
template.crc 63 configuring local settings 55
Template.MODEL 63 general settings 51
Template.PARAM 63 managing configuration storage rules 56
configuration storage manager 56 overview 49
managing storage rules 56 performance settings 53
configuration storage rules 56 settings 51
ConfigurationCalculationSpecification.xml file 63 troubleshooting settings 54
configured beam data depth dose (Beam Configuration)
calculating 26 adding data manually 25
all add-ons 26 editing dmax manually 29
individual add-on 26 normalizing comparison 43
clearing 35 Distributed Calculation Framework
comparing with calculated dose 39 see DCF (Distributed Calculation
deleting 35 Framework)
editing 28 dose
importing from Eclipse 24 checksum 17, 18
managing 34 dose (Beam Configuration)
modifying beam data files 35 calculating 42
verifying 27 calculation in Beam Analysis 39
Context Window 15 checksum 13, 15, 33, 43
crcfile.crc file 63 comparing with configured beam data 39
CT calibration dose calculation
changing 47 see calculation (Beam Configuration)
CT numbers and electron density 46 dosimetric leaf gap 29
CT numbers and mass densities 46
editing CT calibration curve 48
CT scanner 46 E
curve data
electron density
export files 37
calibration 46
exporting 37, 38
conversion formula 46
print-outs 29
converting CT numbers 46
printing 35
electron density and CT numbers 46
Curve Editor
emailing Varian customer support 9
depth of dose maximum 29
F N
Focus Window 15 navigating in workspaces 13
normalization (Beam Configuration)
compared depth doses 43
G configuring options 57
general parameters
defining for add-ons 19 O
updating between versions 61
global calculation settings 51 online customer support 9
calculation 52 ordering product documents by phone 9
general 51
performance 53
troubleshooting 54 P
profile data
I adding manually 25
printing 35
information in this guide 7 progressfile.txt file 63
intended audience publication
publication 7 intended audience 7
intended use of product 7
S
L
Scope Window 15
linear attenuation support e-mail addresses 9
configuring 29
local calculation settings 51
calculation 52 T
general 51 table data
performance 53 interpolating 25
trouleshooting 54 technical support 9
lockinginfo.txt file 63 template.crc file 63
logfile.txt file 63 Template.MODEL file 63
Template.PARAM file 63
M transmission
configuring 29
mapfile.txt file 63, 64 treatment unit
mass density and CT numbers 46 assigning beam data 33
matching copying beam data to 33
add-on data 31 defining parameters for beam configuration
automatic 31 19
Index 69
U
unapproving
beam data 18, 43
V
Varian customer support 9
verification
configured beam data 27
using ASCII format 37
using W2DAC format 37
visual cues 8