Medical Imaging Interaction Toolkit
2016.11.0
Medical Imaging Interaction Toolkit
|
Gantry tilt analysis result. More...
#include <mitkGantryTiltInformation.h>
Public Types | |
typedef itk::Point< double, 3 > | Point3Dd |
typedef itk::Vector< double, 3 > | Vector3Dd |
Public Member Functions | |
GantryTiltInformation () | |
Just so we can create empty instances for assigning results later. More... | |
void | Print (std::ostream &os) const |
GantryTiltInformation (const Point3D &origin1, const Point3D &origin2, const Vector3D &right, const Vector3D &up, unsigned int numberOfSlicesApart) | |
THE constructor, which does all the calculations. More... | |
bool | IsSheared () const |
Whether the slices were sheared. More... | |
bool | IsRegularGantryTilt () const |
Whether the shearing is a gantry tilt or more complicated. More... | |
double | GetMatrixCoefficientForCorrectionInWorldCoordinates () const |
The offset distance in Y direction for each slice in mm (describes the tilt result). More... | |
double | GetRealZSpacing () const |
The z / inter-slice spacing. Needed to correct ImageSeriesReader's result. More... | |
double | GetTiltCorrectedAdditionalSize (unsigned int imageSizeZ) const |
The shift between first and last slice in mm. More... | |
double | GetTiltAngleInDegrees () const |
Calculated tilt angle in degrees. More... | |
Static Public Member Functions | |
static GantryTiltInformation | MakeFromTagValues (const std::string &origin1String, const std::string &origin2String, const std::string orientationString, unsigned int numberOfSlicesApart) |
Factory method to create GantryTiltInformation from tag values (strings). More... | |
Gantry tilt analysis result.
Takes geometry information for two slices of a DICOM series and calculates whether these fit into an orthogonal block or not. If NOT, they can either be the result of an acquisition with gantry tilt OR completly broken by some shearing transformation.
Most calculations are done in the constructor, results can then be read via the remaining methods.
This class is a helper to DICOMITKSeriesGDCMReader and can not be used outside of The DICOMReader Module
Definition at line 42 of file mitkGantryTiltInformation.h.
typedef itk::Point<double,3> mitk::GantryTiltInformation::Point3Dd |
Definition at line 47 of file mitkGantryTiltInformation.h.
typedef itk::Vector<double,3> mitk::GantryTiltInformation::Vector3Dd |
Definition at line 48 of file mitkGantryTiltInformation.h.
mitk::GantryTiltInformation::GantryTiltInformation | ( | ) |
Just so we can create empty instances for assigning results later.
Definition at line 25 of file mitkGantryTiltInformation.cpp.
mitk::GantryTiltInformation::GantryTiltInformation | ( | const Point3D & | origin1, |
const Point3D & | origin2, | ||
const Vector3D & | right, | ||
const Vector3D & | up, | ||
unsigned int | numberOfSlicesApart | ||
) |
THE constructor, which does all the calculations.
Determining the amount of tilt is done by checking the distances of origin1 from planes through origin2. Two planes are considered:
The tilt angle can then be calculated from these distances
origin1 | origin of the first slice |
origin2 | origin of the second slice |
right | right/up describe the orientatation of borth slices |
up | right/up describe the orientatation of borth slices |
numberOfSlicesApart | how many slices are the given origins apart (1 for neighboring slices) |
Definition at line 48 of file mitkGantryTiltInformation.cpp.
References doublepoint, doublevector, and MITK_DEBUG.
double mitk::GantryTiltInformation::GetMatrixCoefficientForCorrectionInWorldCoordinates | ( | ) | const |
The offset distance in Y direction for each slice in mm (describes the tilt result).
Definition at line 229 of file mitkGantryTiltInformation.cpp.
double mitk::GantryTiltInformation::GetRealZSpacing | ( | ) | const |
The z / inter-slice spacing. Needed to correct ImageSeriesReader's result.
Definition at line 236 of file mitkGantryTiltInformation.cpp.
double mitk::GantryTiltInformation::GetTiltAngleInDegrees | ( | ) | const |
Calculated tilt angle in degrees.
Definition at line 223 of file mitkGantryTiltInformation.cpp.
double mitk::GantryTiltInformation::GetTiltCorrectedAdditionalSize | ( | unsigned int | imageSizeZ | ) | const |
The shift between first and last slice in mm.
Needed to resize an orthogonal image volume.
Definition at line 217 of file mitkGantryTiltInformation.cpp.
bool mitk::GantryTiltInformation::IsRegularGantryTilt | ( | ) | const |
Whether the shearing is a gantry tilt or more complicated.
Gantry tilt will only produce shifts in ONE orientation, not in both.
Since the correction code currently only coveres one tilt direction AND we don't know of medical images with two tilt directions, the loading code wants to check if our assumptions are true.
Definition at line 252 of file mitkGantryTiltInformation.cpp.
Referenced by mitk::EquiDistantBlocksSorter::AnalyzeFileForITKImageSeriesReaderSpacingAssumption(), mitk::ThreeDnTDICOMSeriesReader::LoadMitkImageForImageBlockDescriptor(), and mitk::DICOMITKSeriesGDCMReader::LoadMitkImageForImageBlockDescriptor().
bool mitk::GantryTiltInformation::IsSheared | ( | ) | const |
Whether the slices were sheared.
True if any of the shifts along right or up vector are non-zero.
Definition at line 243 of file mitkGantryTiltInformation.cpp.
Referenced by mitk::EquiDistantBlocksSorter::AnalyzeFileForITKImageSeriesReaderSpacingAssumption().
|
static |
Factory method to create GantryTiltInformation from tag values (strings).
Parameters as the regular c'tor.
Definition at line 150 of file mitkGantryTiltInformation.cpp.
References mitk::DICOMStringToOrientationVectors(), and mitk::DICOMStringToPoint3D().
Referenced by mitk::EquiDistantBlocksSorter::AnalyzeFileForITKImageSeriesReaderSpacingAssumption(), and mitk::NormalDirectionConsistencySorter::Sort().
void mitk::GantryTiltInformation::Print | ( | std::ostream & | os | ) | const |
Definition at line 187 of file mitkGantryTiltInformation.cpp.