Professional Documents
Culture Documents
Machine Definition in RT Admin - Elekta
Machine Definition in RT Admin - Elekta
Machine Definition in RT Admin - Elekta
Objectives
This procedure demonstrates how to define an Elekta machine for Eclipse™ in RT Administration.
Note: There are two ways of defining an external beam machine for Eclipse
in RT Administration:
- Follow ‘Machine creation wizard’ built in the RT Administration
- Import machine parameters from xml file.
This procedure demonstrates how to create an Elekta machine by importing
its parameters from xml file.
Figure 1: Quicklinks > Administration >RT Administration
3. Read the displayed message. Click Yes to continue when ready. See Figure 2.
Figure 2: Entering RT Administration
4. Select Radiation and Imaging Devices workspace on the workspace bar. See Figure 3.
Figure 3: Radiation and Imaging Devices
5. Click Import and then select Import External Beam Linac… . See Figure 4.
Figure 4: Import External Beam Linac
Tip: This procedure describes how to create an Elekta machine by importing its definition
xml file previously exported from the treatment workstation. If the xml file is not available,
machine can be created using the built-in machine creation wizard – click New, select New
External Beam and follow the wizard. The following Elekta machine models are supported:
6. Navigate to the machine XML file location and click Open. See Figure 5.
Figure 5: Select Machine Definition XML File
Figure 6: Creation Succeeded
Figure 7: Save Changes
9. Select Parameters have been reviewed and are correct and then click Save Changes to confirm
saving changes made in RT Administration. See Figure 8.
Figure 8: Confirm Changes
Figure 9: Select the Machine
2. In the General tab, verify the machine ID, Name, Machine Scale and verify / select the desired
treatment workstation from Conn. Workstation dropdown. See Figure 10.
Figure 10: External Beam Properties – General
Important Note: On the Elekta machines, there are two different scales
namely the Linac Parameter Scale and the Angular Parameter Scale. Even
one machine can have two different scales; in that case, customer needs to
call Elekta to get more information before the connection takes place.
Caution: On the Treatment console of the Elekta, the name is put in as a number
(serial number of the machine (attached to the license)), the ID of the machine is the
name given to the machine (this can be found in the upper left corner of Elekta
console which is not always defined as default). See Figure below:
3. Select the External Beam tab and type in geometrical parameters. Default source to Field Entry is
a default SSD for the fixed SSD fields. Verify Source Axis distance. Click OK. See Figure 11.
Figure 11: External Beam Properties – External Beam
Important Note: Time in Meterset Unit section need to be put to MU. Time
in Meterset Unit is used for Cobalt machines.
Note: For the Elekta Synergy Agility machine, even though the machine does
not have X-jaws mounted, the option X jaws in Mounted Jaws section has to
be selected.
4. Select the Operating Limits tab. From the dropdown select display scale. Modify treatment unit limits
if needed by double-clicking a parameter. See Figure 12.
Note: Scale selection in Operating Limits tab changes the scale only for
viewing purposes. Review the operating limits using the correct (actual)
machine scale.
Figure 12: Operating Limits
5. To enable Elekta VMAT, motion mode for Dose Rate has to be set to Dynamic - double click the
Dose Rate to open Operating Limit Properties. See Figure 13.
Figure 13: Operating Limits – Dose Rate
6. In Dose Rate Operating Limit Properties set the Motion Mode to Dynamic. Click OK when done.
See Figure 14.
Figure 14: Dose Rate Operating Limit Properties
7. For VMAT-capable machine, the maximum gantry speed needs to be defined (refer to Elekta
documentation for max gantry speed). Double-click Gantry Rotation to open Operating Limit
Properties and set Max Speed. Click OK when done. See Figure 15.
Figure 15: Gantry Rotation Operating Limit Properties
Note: For the Elekta Beam Modulator, check the collimator limits. Correct values in
IEC61217 scale are shown on the picture below. Wedge limits need to be adjusted not to
exceed the collimator operating limits for the Elekta BM. Make sure min value equals max
value for Collimator X1,X2,Y1,Y2.
Note: For Elekta VMAT, the motion mode for jaws (Field X, Y and Collimator X1, X2, Y1,
Y2) need to be set to Dynamic as MLCi and MLCi2 support jaw tracking. For maximum jaw
speed refer to Elekta documentation. (for example the speed is 1.6cm/s for Elekta
Synergy). See picture below:
Figure 16: Technique Tab
9. Double-click Static technique to open its Properties. Make the technique default by selecting Default
Technique checkbox. Proceed by clicking OK. See Figure 17.
Figure 17: Technique Properties
10. Review all techniques and Operating Limits Overrides. The operating limits for which you can
define overrides are:
a) Dose Dynamic MU - Defines the minimum and maximum number of monitor units for IMRT and
VMAT fields.
b) Monitor Units - Defines the minimum and maximum number of monitor units for fields that are not
dose dynamic.
c) MU / Degree - Defines the minimum and maximum number of monitor units per degree for arc
fields.
d) Treatment Time - Defines the minimum and maximum treatment time in minutes for a field.
Note: The operating limits and the primary fluence mode specific overrides
are created at the Treatment Console, and imported with the machine
definition XML file to RT Administration
11. If desired, create a new operating limit override or modify existing one for selected technique (double
click opens the Properties dialog). Highlight the technique ARC and click New Operating Limit to
create a new limit. See Figure 18.
12. In Operating Limit Properties select the Type and define Label and Min, Max MU limits as
necessary. Click OK when done. See Figure 18.
Figure 18: Technique Tab > Operating Limit Override
13. Select the Energy Mode tab. If default Energy Mode for this machine should be selected, double
click the Energy Mode to display its Properties. See Figure 19.
Figure 19: Energy Mode
14. Enable Default Energy Mode to make the mode default. Click OK when done. See Figure 20.
Figure 20: Energy / Mode Properties
15. The default dose rate may be set for each energy mode. Select Energy Mode on left side of the
screen. Right side of the screen will display list of dose rates available for selected Energy Mode.
Double-click a Dose Rate to display its Properties. See Figure 21.
Figure 21: Energy Mode – Energy Mode Dose Rates
16. Select Default Dose Rate checkbox. Click OK when done. See Figure 22.
Figure 22: Dose Rate Properties
Note: For Elekta VMAT, make sure proper machine discrete dose rates are
defined in machine Energy Mode tab. If necessary, create new dose rates by
clicking the New Dose Rate button. For the proper discrete dose rates, check
with the machine manufacturer. This needs to correspond with configuration
of the Elekta machine as Elekta VMAT isn't using a continuous dose rate
modulation but a stepped dose rate modulation.
17. Repeat steps B.15 to B.16 to set default dose rate for all energy modes.
18. Select the Applicator tab. Double-click an applicator to display its Properties. See Figure 23.
Figure 23: Applicator Tab
19. There are TWO different ways of configuring the applicators in RT Administration for the
Elekta machine.
20. STEP1: First we create applicators that will be used for plan transfer to treatment unit.
21. OPTION 1:
a) For the conventional applicators - there are three different types of applicators: Rect, Square and
Tube. See Figure 24.
Figure 24: Applicator Tab – Applicator Types
In Applicator tab, set Field Size X and Field Size Y to blank (NULL) and click Apply,
Click Configure Jaw Size and verify that all jaw sizes are blank (NULL), see Figure 25.
Figure 25: Configure Applicator Size
Important Note: For Rectangular and Square applicator types, make sure
Rectangular checkbox is checked. For tubular applicator types make sure the
Rectangular checkbox is unchecked.
Caution: For Eclipse treatment planning systems only, set Distance from
the source to the head of the applicator = 95.00. See Figure 25.
22. OPTION 2:
a) For the custom-coded applicators - the different types of applicators that customer is using, have
to be created. You can configure these types of applicators ONLY IF each energy uses a single
applicator. See Figure 26.
Figure 26: Applicator Tab – Custom Coded Applicators
Set the appropriate Field Size X and Field Size Y for each applicator. Make sure the field
sizes match the field size of the applicator in Treat Administration. Click Apply,
Click Configure Jaw Size. Take the same jaw sizes for each energy as Field Size X and Y
for each applicator. Click OK when done. See Figure 27.
Figure 27: Configure Applicator Size
23. STEP 2: For both options, we create an extra set of applicators that will be used for planning and
dose calculation.
24. Create one applicator for each physical applicator available on the machine that you want to use in
planning. See Figure 28.
Figure 28: Create Applicators for Planning and Dose Calculation
Important Note: The dose calculation is not supported for TUBE applicators.
At the moment Eclipse supports calculation with standard square and
rectangular applicators using GGPB. Tube applicators can be created in
order to facilitate plan visualization in Eclipse.
a) Set the appropriate Field Size X and Field Size Y for each applicator. Click Apply,
b) Click Configure Jaw Size. Set the jaw sizes for each energy to match Field Size X and Y for
each applicator. Click OK when done. See Figure 29.
Figure 29: Configure Applicator Size
Caution: For the appropriate field size for each applicator, keep in mind that
in Eclipse the field size is defined at isocenter and that the nominal size for
Elekta applicators is defined at 95cm from the photon target. This means the
value you need to enter in Eclipse for the field size must be 1.05 times the
nominal size of the applicator. For the tubular applicators, only one value
needs to be entered and it corresponds to the applicator diameter.
Caution: For Eclipse treatment planning systems only, set Distance from
the source to the head of the applicator to 95.00 cm
Note: It is not possible to configure jaw sizes until the applicator is enabled
for a certain energies in Configured EMT tab.
26. Repeat step B.25 for all applicators created for dose calculation.
28. Confirm saving the changes - enable Parameters have been reviewed and are correct and click
Save Changes. See Figure 30.
Figure 30: Save Changes
Figure 31: Clinical Data
Figure 32: Add-on Material Tab
Tip: The same add-on materials may be used for the same accessory on
different machines.
3. Define new materials for accessories that affect the beam properties - click New Material.
See Figure 33.
Figure 33: New Material
4. Define an add-on material for MLC. In the General tab, type in ID, Name. Select MLC from the
Usage Type dropdown list. Click OK when done. See Figure 34.
Figure 34: Add-On Material Properties – General Tab (Left), Energies Tab (Right)
5. Create a new add-on material for block - click New Material. See Figure 33.
6. Define the add-on material ID and Name. Select Block from Usage Type dropdown list.
See Figure 35.
Figure 35: Block Add-on Material
Note: The block Thickness and Base Plate Thickness are not used in the
calculation of the block transmission. Those parameters are used only for
documentation purposes.
Note: Different block add-on materials should be defined for each kind of
block thickness and material to be used.
7. Create a new add-on material for tray - click New Material. See Figure 33.
8. In the General tab, type in ID and Name. Select Tray from Usage Type dropdown list.
See Figure 36.
Figure 36: Tray Add-on Material
Note: The tray Thickness and Base Plate Thickness are not used in the
calculation of the tray transmission. Those parameters are used only for
documentation purposes.
9. Create a new add-on material for electron cut-out - click New Material. See Figure 33.
10. In the General tab, define the add-on material ID and Name. Select Block from Usage Type
dropdown list. See Figure 37.
Figure 37: Electron Cutout Add-on Material
11. Create a new add-on material for compensator - click New Material. See Figure 33.
12. In General tab, define the material’s ID and Name. Select Compensator from Usage Type
dropdown list and type in Thickness value that represents minimal compensator thickness.
See Figure 38.
Figure 38: Compensator Add-on Material
13. Click Save All ( ) when all necessary add-on materials for your machine have been created.
Figure 39: Radiation and Imaging Devices Workspace – Overview Tab
2. Select the MLC tab and then select the add-on material for the MLC from Add-On Material
dropdown. See Figure 40.
Figure 40: MLC Tab – Add-On Material Dropdown
3. Click anywhere in the tab to leave the drop down. Energies, the MLC has been enabled for, are then
listed on the right side of the screen. Define the Transmission Factor and Dosimetric Leaf Gap for
all enabled energies. See Figure 41.
Figure 41: MLC – Dosimetric Properties
Caution: Dosimetric Parameters may significantly affect calculation. Make sure MLC
is assigned the correct add-on material and that Dosimetric Parameters are correct.
4. Double-click the MLC propertied column or click Properties to open MLC Properties. In General tab,
confirm that MLC has an add-on material assigned (Add-On Material). See Figure 42.
Figure 42: MLC Properties – General Tab
5. Select the MLC tab and make sure the displayed MLC parameters are correct. See Figure 43.
Figure 43: MLC Properties – MLC Tab
Note: The following table highlights key differences among Elekta MLCs:
Minimum Dose Dynamic Leaf Gap [cm] N/A N/A N/A N/A
Minimum Arc Dynamic Leaf Gap [cm] 0.5 0.5 0.14 0.5
Figure 44: Wedge Tab
7. Double-click a wedge to open its Properties. In the Wedge tab, review the limits and orientations and
make sure the angle is set to 60deg. Click OK when done. See Figure 45.
Figure 45: Wedge Properties – Wedge Tab
Note: If the machine has the Motorized Wedge installed, check the option
Motorized.
8. If the Elekta machine has an Elekta Omni Wedge installed (Elekta machines with backup jaws such
as Synergy, SL20), configuration has to be performed as follows:
a) Make sure the Motorized Wedge is configured. In Wedge tab of the Wedge Properties verify
the operating limits and orientations. Click OK when done. See Figure 46.
Figure 46: Motorized Wedge for Elekta with Backup Jaws
b) Click New Dynamic Wedge to create a new dynamic wedge for the Elekta treatment unit. Define
ID in the General tab. In Wedge tab of the Dynamic Wedge Properties, select the Enhanced
check box and define the operating limits and orientations. Click OK when done. See Figure 47.
Figure 47: New Dynamic Wedge for Elekta
c) Click New Standard Wedge to create a new standard wedge. In the General tab define the ID.
In the Wedge tab of the Standard Wedge Properties, select the Omniwedge and the
Motorized (confirm the message that all assigned slots will be unassigned) check boxes. Define
the Angle, Source Dist. (this information will not be used later), make sure the limits and
orientation are correct. Click OK when done. See Figure 48.
Figure 48: New Standard Wedge for Elekta
Figure 49: Tray Tab
10. Verify trays for blocks and electron cut-outs. See Figure 50.
Note: All default trays with INTERNAL CODES are created automatically.
There are 127 photon trays (Shadow Tray) and 15 electron trays (Fitment)
created in Treat Administration / RT Administration.
Photon Tray
Electron Tray
Figure 50: Photon and Electron Trays
11. An add-on material can be selected for a tray from Add-On Material dropdown to account for the
attenuation of the tray. If no Add-On Material is selected, the tray will be considered transparent to
radiation.
12. Select the add-on material for the desired trays from the Add-On Material dropdown. See and then
define its Dosimetric Parameters for all energies on the right side of the screen. See Figure 51.
Figure 51: Select Add-On Material
13. Click the right side of the screen to leave Add-On Material dropdown. Dosimetric Properties will
populate; define the Transmission Factor for all enabled energies. See Figure 52.
Figure 52: Define Dosimetric Properties
Tip: You can use Select button (See Figure 52) to review or enable / disable
energies that the Dosimetric Properties are available for.
14. Repeat steps D.12 - D.13 for all tray that are to be assigned an add-on material.
15. Double-click a tray to open Tray Properties. In General tab, check ID, Name and verify the selected
Add-On Material Check the Internal Code sent towards the treatment workstation. See Figure 53.
Figure 53: Tray Properties – General Tab
Note: For custom coded Elekta machines, the accessory internal code which
is recognized by the system Treat Administration must match the code read
from machine accessory. Make sure that the IDs used in Treat Administration
correspond with the IDs used in RT Administration.
Note: Photon trays: The valid range of codes for the acrylic tray is 1 – 126.
Code 127 is shown if Shadow tray is attached without an acrylic tray, or if an
acrylic tray installed that has all the holes drilled. It is recommended that the
code 127 is not used for any acrylic tray. Codes 0 and 128 are invalid.
Note: Electron trays: The valid range of codes for acrylic tray is 1 – 14. End
frame code 1 is used for standard end frames, codes 2-14 are used for
custom end frames.
Note: For non-custom coded Elekta machines, when using the Tray, one
internal code is send towards the treatment workstation (check this code with
the customer).
16. Select Slots tab, and make sure an appropriate slot is assigned to the tray. If necessary, select a slot
from All Slots available list and use > to assign it to the slot. Click OK when done. See Figure 54.
Figure 54: Tray Properties – Slots Tab
17. Repeat steps D.15 - D.16 for all trays to check their parameters.
Caution: Never add a new Tray for Elekta machine, use the existing ones.
Figure 55: Blocks and Compensators Tab
19. In order to be able to define Dosimetric Properties for the listed block and compensator materials,
they have to be enabled for some energies first. Click Enable. Then select the energies the material
is to be used with and click OK when done. See Figure 56.
Figure 56: Select Energies
20. Then define Dosimetric Properties for the active block or compensator material on the right side of
the screen. See Figure 57.
Figure 57: Block Dosimetric Parameters
21. Repeat steps D.19 - D.20 for all materials that are to be assigned Dosimetric Properties.
Tip: New Material… button in upper left corner can be used to create a new
Add-On Material without going to Clinical Data workspace.
22. Select Configured EMT tab. EMT stands for ‘Energy Mode – Technique’. See Figure 58.
Figure 58: Configured EMT Tab
23. The Add-ons (accessories such as trays, MLC, wedges, etc.) have to be validated for use with each
technique and energy. Select the EMT combination by clicking in the white cell (next to the check
box) in the table on the left hand side. Right side of the screen will display add-on validation for
selected Energy Mode/ Technique. Verify that the appropriate add-ons are available for any selected
EMT combination. See Figure 59.
Figure 59: Add-On Validation
Figure 60: Imager Tab
26. In General tab, define ID, Name, select the Machine Model and type in Manufacturer Name. In
Port Imager make sure Default Port Imager is selected. Click OK when done. See Figure 61.
Figure 61: Port Imager Properties
28. Select Parameters have been reviewed and are correct and click Save Changes to confirm saving
the changes made to machine configuration. See Figure 62.
Figure 62: Confirm Changes