SimpleRTK: Difference between revisions

From Openrtk
Jump to navigation Jump to search
No edit summary
No edit summary
Line 24: Line 24:
= Testing SimpleRTK =
= Testing SimpleRTK =
A simple example is located in Utilities/SimpleRTK/Examples/RTKFirstReconstruction.py and shows how to use SimpleRTK
A simple example is located in Utilities/SimpleRTK/Examples/RTKFirstReconstruction.py and shows how to use SimpleRTK
  #!/usr/bin/env python
  from __future__ import print_function
  import SimpleRTK as srtk
  import sys
  import os
  if len ( sys.argv ) < 2:
    print( "Usage: RTKFirstReconstruction <output>" )
    sys.exit ( 1 )
  # Defines the RTK geometry object
  geometry = srtk.ThreeDimCircularProjectionGeometry()
  numberOfProjections = 360
  firstAngle = 0
  angularArc = 360
  sid = 600 # source to isocenter distance in mm
  sdd = 1200 # source to detector distance in mm
  isox = 0 # X coordinate on the projection image of isocenter
  isoy = 0 # Y coordinate on the projection image of isocenter
  for x in range(0,numberOfProjections):
    angle = firstAngle + x * angularArc / numberOfProjections
    geometry.AddProjection(sid,sdd,angle,isox,isoy)
  constantImageSource = srtk.ConstantImageSource()
  origin = [ -127.0, -127.0, -127.0 ]
  sizeOutput = [ 256, 256,  numberOfProjections ]
  spacing = [ 1.0, 1.0, 1.0 ]
  constantImageSource.SetOrigin( origin )
  constantImageSource.SetSpacing( spacing )
  constantImageSource.SetSize( sizeOutput )
  constantImageSource.SetConstant(0.0)
  source = constantImageSource.Execute()
  rei = srtk.RayEllipsoidIntersectionImageFilter()
  semiprincipalaxis = [ 50, 50, 50]
  center = [ 0, 0, 0]
  # Set GrayScale value, axes, center...
  rei.SetDensity(20)
  rei.SetAngle(0)
  rei.SetCenter(center)
  rei.SetAxis(semiprincipalaxis)
  rei.SetGeometry( geometry )
  reiImage = rei.Execute(source)
 
  # Create reconstructed image
  constantImageSource2 = srtk.ConstantImageSource()
  sizeOutput = [ 256, 256,  256 ]
  constantImageSource2.SetOrigin( origin )
  constantImageSource2.SetSpacing( spacing )
  constantImageSource2.SetSize( sizeOutput )
  constantImageSource2.SetConstant(0.0)
  source2 = constantImageSource2.Execute()
  print("Performing reconstruction")
  feldkamp = srtk.FDKConeBeamReconstructionFilter()
  feldkamp.SetGeometry( geometry );
  feldkamp.SetTruncationCorrection(0.0);
  feldkamp.SetHannCutFrequency(0.0);
  image = feldkamp.Execute(source2,reiImage)
 
  pixelID = image.GetPixelIDValue()
  caster = srtk.CastImageFilter()
  caster.SetOutputPixelType( pixelID )
  image = caster.Execute( image )
  writer = srtk.ImageFileWriter()
  writer.SetFileName ( sys.argv[1] )
  writer.Execute ( image );

Revision as of 04:53, 21 July 2014

Introduction

SimpleRTK provides a simple interface to RTK in a variety of languages. For now only Python and C# binding have been tested and are supported. SimpleRTK will be provided as part of RTK making it easier to configure, build and use. Note that SimpleRTK is derived from the SimpleITK project for the Insight Toolkit, however it's under its own project.

Building RTK with SimpleRTK

SimpleRTK uses Swig to generate the wrapping for different languages. As the version of Swig should be controlled, SimpleRTK will automatically download the right version of Swig and its dependencies for the different platforms. However you can always point to the installed version of Swig if you'd like to, but this is not recommended.

Here are the simple steps to build and configure wrapping for RTK:

  1. Run CMake on RTK as you normally do
  2. Check the option BUILD_SIMPLERTK (default is OFF)
  3. Ename WRAP_PYTHON and/or WRAP_CSHARP (On Windows)
  4. Configure
  5. Build as usual. Note that building will download the require libraries so you should have an internet connection enabled.

Python installation

To install a built python package into the system Python, as root run:

cd SimpleRTK-build/Wrapping
python PythonPackage/setup.py install

Alternatively, a Python virtual environment can be created and the distribution installed there. If you build the "dist" target a Python egg will be created in the "Wrapping/dist" directory. Building Python wheels can be enabled with a CMake flag.

Testing SimpleRTK

A simple example is located in Utilities/SimpleRTK/Examples/RTKFirstReconstruction.py and shows how to use SimpleRTK

 #!/usr/bin/env python
 from __future__ import print_function
 import SimpleRTK as srtk
 import sys
 import os
 if len ( sys.argv ) < 2:
   print( "Usage: RTKFirstReconstruction <output>" )
   sys.exit ( 1 )
 # Defines the RTK geometry object
 geometry = srtk.ThreeDimCircularProjectionGeometry()
 numberOfProjections = 360
 firstAngle = 0
 angularArc = 360
 sid = 600 # source to isocenter distance in mm
 sdd = 1200 # source to detector distance in mm
 isox = 0 # X coordinate on the projection image of isocenter
 isoy = 0 # Y coordinate on the projection image of isocenter
 for x in range(0,numberOfProjections):
   angle = firstAngle + x * angularArc / numberOfProjections
   geometry.AddProjection(sid,sdd,angle,isox,isoy)
 constantImageSource = srtk.ConstantImageSource()
 origin = [ -127.0, -127.0, -127.0 ]
 sizeOutput = [ 256, 256,  numberOfProjections ]
 spacing = [ 1.0, 1.0, 1.0 ]
 constantImageSource.SetOrigin( origin )
 constantImageSource.SetSpacing( spacing )
 constantImageSource.SetSize( sizeOutput )
 constantImageSource.SetConstant(0.0)
 source = constantImageSource.Execute()
 rei = srtk.RayEllipsoidIntersectionImageFilter()
 semiprincipalaxis = [ 50, 50, 50]
 center = [ 0, 0, 0]
 # Set GrayScale value, axes, center...
 rei.SetDensity(20)
 rei.SetAngle(0)
 rei.SetCenter(center)
 rei.SetAxis(semiprincipalaxis)
 rei.SetGeometry( geometry )
 reiImage = rei.Execute(source)
 
 # Create reconstructed image
 constantImageSource2 = srtk.ConstantImageSource()
 sizeOutput = [ 256, 256,  256 ]
 constantImageSource2.SetOrigin( origin )
 constantImageSource2.SetSpacing( spacing )
 constantImageSource2.SetSize( sizeOutput )
 constantImageSource2.SetConstant(0.0)
 source2 = constantImageSource2.Execute()
 print("Performing reconstruction")
 feldkamp = srtk.FDKConeBeamReconstructionFilter()
 feldkamp.SetGeometry( geometry );
 feldkamp.SetTruncationCorrection(0.0);
 feldkamp.SetHannCutFrequency(0.0);
 image = feldkamp.Execute(source2,reiImage) 
  
 pixelID = image.GetPixelIDValue()
 caster = srtk.CastImageFilter()
 caster.SetOutputPixelType( pixelID )
 image = caster.Execute( image )
 writer = srtk.ImageFileWriter()
 writer.SetFileName ( sys.argv[1] )
 writer.Execute ( image );