Introduction

Physics data in version 6 is imported every time the program launches from tab delimited text (MacOS filetype TEXT) files with the extension .iphys (e.g. I-125(IAI-125A).iphys). Plaque Simulator version 6 uses the same physics file format as version 5. When the file is imported, a checksum of its contents is calculated and compared against the most recent checksum recorded in the pschecksums table of the PSdatabase.sqlite file located in the Plaque Simulator Data folder. You can inspect the PSdatabase.sqlite file using a program such as SQLite Database Browser. If errors are detected in the file (e.g. required data fields are missing) or the current and database checksums do not match, the file will be flagged as defective and MUST be authenticated before it can used for dosimetry calculations.

You can create, review or edit the data in the text files using Microsoft Excel or a text editor such as BBEdit, or directly in the Plaque Simulator Physics window and then export the text file. The Physics window has 7 selectable panes which are selected by clicking the buttons in the toolbar at the top of the window. These panes organize physics data according to function. Click on the links at the top of this page to learn more about each functional group.

Toolbar

The buttons along the bottom of the Physics window are used to create, open, reload and save physics files.

BottomButtons
  • New - Initialize a new, empty, physics class data structure. It is generally more convenient to duplicate an existing physics file using operating system commands, rename it, open and then edit it compared to creating a new file from scratch.
  • Open - Open a .iphys file.
  • Reload - Reload the file associated with the currently selected source menu item.
  • Reload All - Reload all .iphys files found in the Plaque Simulator Data folder.
  • Save - Overwrite the file of the currently selected item of the source menu.
  • Save As... - Save the file of the currently selected source menu item with the ability to relocate and rename the file.
  • Save All - Overwrite the files of all items listed in the source menu.

This tutorial will take you through the steps necessary to create and authenticate a physics file using the Plaque Simulator physics editor.


Unlocking the physics editor

The Physics window is accessed from the Dosimetry menu. To simply review physics data, select Dose Calc. Options and then Physics.... In order to edit or authenticate physics data, you will need to unlock the Physics window.

DosimetryDoseCalcOptions

To unlock the Physics editor select Dose Calc. Options and then Unlock Physics....

UnlockPhysics
Physics6Unlock

In the Physics window password sheet enter the identifier (e.g. name or initials) of the person authorizing physics file access, the physics password, and then click the OK button. The default physics password is 'macula'. The physics password may be customized when licensing Plaque Simulator.


Authenticating a physics file

When a .iphys file is imported, if any errors are detected (e.g. required data fields are missing) or the current and database checksums do not match, the file will be flagged as defective and MUST be authenticated before it can used for dosimetry calculations. A listing of the problems and authentication tools are found in the Misc panel of the Physics window. In menu listings of physics files, files available for dosimetry calculations are indicated by the Ball-go-16 icon and defective files are indicated by the Ball-stop-16 icon.

PhysicsFileMenuWithBadFile
Physics6MiscWithBadFile

Physics files may only be authenticated when the Physics window has been unlocked as described above.

  • Authenticate - Authenticates the file of the selected item of the source menu.
  • Delete All Checksums - Clears the checksums database, simulating the conditions of a new installation or application upgrade.
  • Authenticate All Files - Simultaneously authenticates all files listed in the source menu. Use this button to quickly authenticate everything following a new installation or upgrade of Plaque Simulator.

Exporting the .iphys file

When all of the required data for the selected Source have been entered, click the Save As... button. This opens the Save file navigator. Physics data for Plaque Simulator versions 5 and 6 are imported and exported as tab delimited text files (e.g. I-125(IAI-125A).iphys) which end with the ".iphys" extension. Physics files should be located in the Physics folder in the Plaque Simulator Data folder.

Save

When Plaque Simulator exports a physics file it sets the MacOS file type to TEXT and the creator to XCEL. This allowed you to click on these files in earlier versions the MacOS Finder and they would open automatically in the Excel component of Microsoft Office for editing or verifying data. In MacOSX 10.8 you may have to use the Finder Get Info window Open with: tool to assign Microsoft Excel.app as the application to open .iphys files.

After you have saved your xxxx.iphys file and been returned to the Physics dialog, click the Reload All button. Plaque Simulator will rescan the Data folder for physics files and rebuild the Source popup menu in the Physics window.

GetInfo