TR 1 CMS Machine Extraction and Import
Technical Reference 1 – CMS/Monaco Machine Extraction and Import This is a step-by-step description of how to get the machine data files from CMS or Monaco and then import them into RadCalc. The first two sections explain transferring the necessary files from the CMS or Monaco to RadCalc, the third section explains importing the machine data into RadCalc Section 1: Transferring data from CMS to RadCalc These steps are performed on the CMS computer. 1) 2) 3)
4) 5)
6)
7)
You must login to your system as the root user (the root password is usually focus1). type: cd /FOCUS and press the return key. type: ls and press the return key. You may see a list of directories named rtp1, rtp2, etc. Usually you would go into the rtp1 directory but it may be some other directory. Assuming that you are going into the rtp1 directory... type: cd rtp1 and press the return key type: ls and press return key. You will see a list of directories that are numbered (i.e. 1, 2, etc.). These refer to institution numbers. The institution number is most likely just 1. One may need to look in the CMS software program to determine the correct institution number. Assuming institution 1 is the correct number then... type: cd 1 and press the return key. In this directory is the directory named "tele". This refers to teletherapy sources. All of the machines are contained within this directory. It is easiest to backup this entire directory. type the command: tar cvf tele.tar tele
One can now FTP the tele.tar file over to the RadCalc folder. The simplest way to do this is to go to a PC where you can access RadCalc. Open up a DOS prompt (i.e. Command prompt) and then change directories to the RadCalc folder and then issue the following commands: 1) 2)
3) 4) 5)
type: ftp 10.0.0.0 (10.0.0.0 should be substituted with the IP address of your CMS computer. You will be prompted to enter a username and then a password. First try using the root username and password. If that does not work then you will need to enter a different username and password. Once you successfully login you will be at an FTP prompt. type: cd /FOCUS/rtp1/1 and press return (this assumes ‘rtp1’ are ‘1’ are the correct directories otherwise you will need to type the correct path) type: bin and press return (this makes the transfer mode binary) type: get tele.tar and press return (this will bring the file over to the PC)
TR-1 - CMS Machine Extraction and Import, Rev. B
Page 1 of 3
6)
type: bye and press return (this will exit the FTP program and bring you back to a DOS prompt)
Now that the file is on the PC in the RadCalc folder, type the following command from the DOS prompt: tar xvf tele.tar This will extract the file and preserve the file structure that was originally on the CMS computer.
Section 2: Transferring data from Monaco to RadCalc These steps are performed on the Monaco computer. Open Windows Explorer and browse to the ‘Data Location’ set in Monaco settings, typically C:\Users\Public\Documents\CMS\FocalData\Installation 2) Browse to the appropriate Clinic folder 3) Right click on the ‘tele’ folder and select ‘Send to -> Compressed (zipped) folder’ from the menu which appears. 4) Press Enter to keep the name as tele.zip. 5) Move this file to a shared network location or device which can be accessed by a PC where you can access RadCalc. 7) On the PC where you can access RadCalc, open Windows Explorer and browse to the RadCalc folder. 8) Copy the tele.zip file made above to the RadCalc folder 9) Right click on the tele.zip file and select ‘Extract All..’ from the menu. 10) Press the Extract button, this will extract the file and preserve the file structure that was originally on the Monaco computer. 1)
Section 3: Importing the transferred data into RadCalc Start the RadCalc program and click on the File menu, then choose Utilities, and then Physics Setup. On the Machine Information tab is a button labeled Import. Click this button and the Machine Import dialog box will display. On this dialog box, make sure CMS is chosen as the Machine Format. Next, you need to set the import path. To do this, press the Browse button. A new dialog box will display and should have the RadCalc folder pre-selected. Within the RadCalc folder will be the CMS tele folder. Select this folder and press the OK button. The Machine Energy List will now be populated with all of the machine energy names from your CMS system. Next, you need to use shift-click or control-click to select all of the photon and electron energies that belong together (i.e. belong to same machine). Once you select them, press the Import Into New Machine button. For each photon energy, an ‘Enter Reference Depth For Energy’ dialog box will display. This dialog box will display the contents of the CMS
TR-1 - CMS Machine Extraction and Import, Rev. B
Page 2 of 3
file that contains the output factors. This information is provided as a reference for you in order to help determine the correct reference depth for entry. Your reference depth will most likely be either Dmax or 10cm. Enter the appropriate value in the dialog box and press the OK button. After responding to each dialog box, you will be returned back to the Machine Import dialog box. If you have more machines to import then please repeat this process. When you have finished importing machines, you can then press the Close button and then review your imported machine data. This import process primarily imports the output factors, wedge factors, cone factors, PDD data, and profile data. The general machine characteristics will need to be entered for each machine. These are as follows: 1) 2) 3) 4) 5) 6) 7) 8)
On the Photon Energies window, the reference SSD, calibration value, transmission values, and radiation light field offset will need to be entered. On the Jaw Settings window all information will need to be entered. On the Gantry, Collimator, and Couch angle windows all information will need to be entered. On the Wedges window, all wedge limits and labels will need to be entered. Also, dynamic wedge information will need to be entered. On the Attenuators window, the attenuator information will need to be entered and then the factors on the Attenuator Factors window. On the MLC Information window, the MLC information will need to be entered. On the Electron Energies window the Energy Value will need to be entered. On the Electron Cones window, missing information may need to be entered along with the machine jaw settings for the cone on the Factors, Effective SSDs, and More window.
TR-1 - CMS Machine Extraction and Import, Rev. B
Page 3 of 3
4) 5)
6)
7)
You must login to your system as the root user (the root password is usually focus1). type: cd /FOCUS and press the return key. type: ls and press the return key. You may see a list of directories named rtp1, rtp2, etc. Usually you would go into the rtp1 directory but it may be some other directory. Assuming that you are going into the rtp1 directory... type: cd rtp1 and press the return key type: ls and press return key. You will see a list of directories that are numbered (i.e. 1, 2, etc.). These refer to institution numbers. The institution number is most likely just 1. One may need to look in the CMS software program to determine the correct institution number. Assuming institution 1 is the correct number then... type: cd 1 and press the return key. In this directory is the directory named "tele". This refers to teletherapy sources. All of the machines are contained within this directory. It is easiest to backup this entire directory. type the command: tar cvf tele.tar tele
One can now FTP the tele.tar file over to the RadCalc folder. The simplest way to do this is to go to a PC where you can access RadCalc. Open up a DOS prompt (i.e. Command prompt) and then change directories to the RadCalc folder and then issue the following commands: 1) 2)
3) 4) 5)
type: ftp 10.0.0.0 (10.0.0.0 should be substituted with the IP address of your CMS computer. You will be prompted to enter a username and then a password. First try using the root username and password. If that does not work then you will need to enter a different username and password. Once you successfully login you will be at an FTP prompt. type: cd /FOCUS/rtp1/1 and press return (this assumes ‘rtp1’ are ‘1’ are the correct directories otherwise you will need to type the correct path) type: bin and press return (this makes the transfer mode binary) type: get tele.tar and press return (this will bring the file over to the PC)
TR-1 - CMS Machine Extraction and Import, Rev. B
Page 1 of 3
6)
type: bye and press return (this will exit the FTP program and bring you back to a DOS prompt)
Now that the file is on the PC in the RadCalc folder, type the following command from the DOS prompt: tar xvf tele.tar This will extract the file and preserve the file structure that was originally on the CMS computer.
Section 2: Transferring data from Monaco to RadCalc These steps are performed on the Monaco computer. Open Windows Explorer and browse to the ‘Data Location’ set in Monaco settings, typically C:\Users\Public\Documents\CMS\FocalData\Installation 2) Browse to the appropriate Clinic folder 3) Right click on the ‘tele’ folder and select ‘Send to -> Compressed (zipped) folder’ from the menu which appears. 4) Press Enter to keep the name as tele.zip. 5) Move this file to a shared network location or device which can be accessed by a PC where you can access RadCalc. 7) On the PC where you can access RadCalc, open Windows Explorer and browse to the RadCalc folder. 8) Copy the tele.zip file made above to the RadCalc folder 9) Right click on the tele.zip file and select ‘Extract All..’ from the menu. 10) Press the Extract button, this will extract the file and preserve the file structure that was originally on the Monaco computer. 1)
Section 3: Importing the transferred data into RadCalc Start the RadCalc program and click on the File menu, then choose Utilities, and then Physics Setup. On the Machine Information tab is a button labeled Import. Click this button and the Machine Import dialog box will display. On this dialog box, make sure CMS is chosen as the Machine Format. Next, you need to set the import path. To do this, press the Browse button. A new dialog box will display and should have the RadCalc folder pre-selected. Within the RadCalc folder will be the CMS tele folder. Select this folder and press the OK button. The Machine Energy List will now be populated with all of the machine energy names from your CMS system. Next, you need to use shift-click or control-click to select all of the photon and electron energies that belong together (i.e. belong to same machine). Once you select them, press the Import Into New Machine button. For each photon energy, an ‘Enter Reference Depth For Energy’ dialog box will display. This dialog box will display the contents of the CMS
TR-1 - CMS Machine Extraction and Import, Rev. B
Page 2 of 3
file that contains the output factors. This information is provided as a reference for you in order to help determine the correct reference depth for entry. Your reference depth will most likely be either Dmax or 10cm. Enter the appropriate value in the dialog box and press the OK button. After responding to each dialog box, you will be returned back to the Machine Import dialog box. If you have more machines to import then please repeat this process. When you have finished importing machines, you can then press the Close button and then review your imported machine data. This import process primarily imports the output factors, wedge factors, cone factors, PDD data, and profile data. The general machine characteristics will need to be entered for each machine. These are as follows: 1) 2) 3) 4) 5) 6) 7) 8)
On the Photon Energies window, the reference SSD, calibration value, transmission values, and radiation light field offset will need to be entered. On the Jaw Settings window all information will need to be entered. On the Gantry, Collimator, and Couch angle windows all information will need to be entered. On the Wedges window, all wedge limits and labels will need to be entered. Also, dynamic wedge information will need to be entered. On the Attenuators window, the attenuator information will need to be entered and then the factors on the Attenuator Factors window. On the MLC Information window, the MLC information will need to be entered. On the Electron Energies window the Energy Value will need to be entered. On the Electron Cones window, missing information may need to be entered along with the machine jaw settings for the cone on the Factors, Effective SSDs, and More window.
TR-1 - CMS Machine Extraction and Import, Rev. B
Page 3 of 3
