Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/brjdenis/VarianESAPI-HalcyonGantryAngle

Varian ESAPI script and standalone app to determine Halcyon cardinal gantry angle error by manually analyzing a 2D image of the Cirs Iso Phantom
https://github.com/brjdenis/VarianESAPI-HalcyonGantryAngle

angle esapi gantry halcyon scripting varian

Last synced: 10 days ago
JSON representation

Varian ESAPI script and standalone app to determine Halcyon cardinal gantry angle error by manually analyzing a 2D image of the Cirs Iso Phantom

Awesome Lists containing this project

README 

        
# Halcyon gantry angle

Varian ESAPI script and standalone app for manually analyzing 2D images of the [Cirs Daily Iso Phantom](https://www.cirsinc.com/products/radiation-therapy/daily-iso-phantom/) with two circular objects that are used to calculate the Halcyon gantry angle deviation.



![image](image.png)



## Setup



To use the script, you should compile it on your system or use the standalone version (below). You should be able to open the project with Visual Studio 2019 Community Edition. Open the .sln file in Dosimetry folder. 

The script was developed for Eclipse version 15.6. It may not work with other versions of Eclipse or Varian ESAPI.



1. You will need to restore NuGet package for compilation: OxyPlot, Evil-Dicom. Right click the solution -> Restore NuGet packages.

2. Don't forget the references to Varian dlls.

3. Compile as Release for x64.



## Standalone version (updated)



If you don't have ESAPI, you can still use the program. Download it from here: [HalcyonGantryAngle_Standalone.zip](https://github.com/brjdenis/VarianESAPI-HalcyonGantryAngle/releases/download/HalcyonGantryAngle_Standalone_v1.0.0.4/HalcyonGantryAngle_Standalone_v1.0.0.4.zip) and unzip the contents to your computer. Run the .EXE file and select a dicom file that you would like to analyze. That is all. 



The program will call .esapi.dll library but without going through the same path as it would if you called it via Eclipse. It is really botched-up, to be honest ... not a very good programmer here.



The standalone version is using [Evil-dicom](https://github.com/rexcardan/Evil-DICOM) to read the image data. The dlls are included.



There is a very small difference in how the image is displayed via ESAPI or the standalone program. You will notice some difference in gray values and how Window/Level is applied at the beginning. If the radius of the circles is not close to the radius of the circular slice, then there may be a problem with the decimal point representation. Change the culture of your system to "en-US".



## Use in Eclipse



1. In External Beam Planning open a 2D portal image of the phantom. You can set Window/Level before running the script. The script will display internal pixel values, not taking into account *intercept* and *slope*.

2. Run the script.

3. Read the Help to learn how to move the circles.



## Formula



Angle deviations are calculated with this formula:



![image](imageeq.png)



Here *a* is the distance of the upper circle from the center of the cube, and *b* is the distance of the lower circle from the center of the cube (a = b = 5.7 cm). *X* and *Y* are the measured distances between the centers of the circles. The deviation is always positive, you have to determine the direction of error. 



The formula is an approximation for small angle deviations. For arbitrary angles it gets too complicated to be practical, but with some reasonable assumptions it can be shown that the sine of the gantry angle deviation is the solution of this quadratic equation:



![image](imageeq2.png)



Where Δ is the distance between the circles on the image, and SAD = 100 cm. You can change the formula in *CalculateDeviation()*.



The phantom must be leveled perfectly. 



## Log



* (12.11.2021) Fixed an error in image definition (oxyplot).



## Important note



**Before using this program see the [licence](https://github.com/brjdenis/VarianESAPI-HalcyonGantryAngle/blob/master/LICENSE) and make sure you understand it. The program comes with absolutely no guarantees of any kind.**



```

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

SOFTWARE.

```



## LICENSE



Published under the MIT license.