/*========================================================================= * * Copyright NumFOCUS * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * https://www.apache.org/licenses/LICENSE-2.0.txt * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * *=========================================================================*/ #ifndef itkRayCastInterpolateImageFunction_hxx #define itkRayCastInterpolateImageFunction_hxx #include "itkCompensatedSummation.h" #include "itkMath.h" namespace itk { /** * \class Helper class to maintain state when casting a ray. * This helper class keeps the RayCastInterpolateImageFunction thread safe. */ template class RayCastInterpolateImageFunction::RayCastHelper { public: /** * Type of the Transform Base class * The fixed image should be a 3D image */ using TransformType = itk::Transform; using TransformPointer = typename TransformType::Pointer; using InputPointType = typename TransformType::InputPointType; using OutputPointType = typename TransformType::OutputPointType; using TransformParametersType = typename TransformType::ParametersType; using TransformJacobianType = typename TransformType::JacobianType; using SizeType = typename TInputImage::SizeType; using DirectionType = itk::Vector; using PointType = itk::Point; using InputImageType = TInputImage; using PixelType = typename InputImageType::PixelType; using IndexType = typename InputImageType::IndexType; using CompensatedSummationType = itk::CompensatedSummation; /** * Set the image class */ void SetImage(const InputImageType * input) { m_Image = input; } /** * Initialise the ray using the position and direction of a line. * * \param rayPosition The position of the ray in 3D (mm). * \param rayDirection The direction of the ray in 3D (mm). * * \return True if this is a valid ray. */ bool SetRay(const OutputPointType & rayPosition, const DirectionType & rayDirection); /** \brief * Integrate the interpolated intensities above a given threshold, * along the ray and return the result. * * This routine can be called after instantiating the ray and * calling SetProjectionCoord2D() or Reset(). It may then be called * as many times thereafter for different 2D projection * coordinates. * * \param integral The integrated intensities along the ray. * \param threshold The integration threshold [default value: 0] * * \return True if a valid ray was specified. */ bool IntegrateAboveThreshold(double & integral, double threshold); /// Reset the iterator to the start of the ray. void Reset(); /// Return the interpolated intensity of the current ray point. double GetCurrentIntensity() const; /// Return the ray point spacing in mm double GetRayPointSpacing() const { typename InputImageType::SpacingType spacing = this->m_Image->GetSpacing(); if (m_ValidRay) { return std::sqrt(m_VoxelIncrement[0] * spacing[0] * m_VoxelIncrement[0] * spacing[0] + m_VoxelIncrement[1] * spacing[1] * m_VoxelIncrement[1] * spacing[1] + m_VoxelIncrement[2] * spacing[2] * m_VoxelIncrement[2] * spacing[2]); } else { return 0.; } } /// Set the initial zero state of the object void ZeroState(); /// Initialise the object void Initialise(); protected: /// Calculate the endpoint coordinates of the ray in voxels. void EndPointsInVoxels(); /** * Calculate the incremental direction vector in voxels, 'dVoxel', * required to traverse the ray. */ void CalcDirnVector(); /** * Reduce the length of the ray until both start and end * coordinates lie inside the volume. * * \return True if a valid ray has been, false otherwise. */ bool AdjustRayLength(); /** * Obtain pointers to the four voxels surrounding the point where the ray * enters the volume. */ void InitialiseVoxelPointers(); /// Increment the voxel pointers surrounding the current point on the ray. void IncrementVoxelPointers(); /// Record volume dimensions and resolution void RecordVolumeDimensions(); /// Define the corners of the volume void DefineCorners(); /** \brief * Calculate the planes which define the volume. * * Member function to calculate the equations of the planes of 4 of * the sides of the volume, calculate the positions of the 8 corners * of the volume in mm in World, also calculate the values of the * slopes of the lines which go to make up the volume( defined as * lines in cube x,y,z dirn and then each of these lines has a slope * in the world x,y,z dirn [3]) and finally also to return the length * of the sides of the lines in mm. */ void CalcPlanesAndCorners(); /** \brief * Calculate the ray intercepts with the volume. * * See where the ray cuts the volume, check that truncation does not occur, * if not, then start ray where it first intercepts the volume and set * x_max to be where it leaves the volume. * * \return True if a valid ray has been specified, false otherwise. */ bool CalcRayIntercepts(); using TraversalDirectionEnum = RayCastHelperEnums::TraversalDirection; #if !defined(ITK_LEGACY_REMOVE) /**Exposes enum values at class level for backwards compatibility*/ static constexpr TraversalDirectionEnum UNDEFINED_DIRECTION = TraversalDirectionEnum::UNDEFINED_DIRECTION; static constexpr TraversalDirectionEnum TRANSVERSE_IN_X = TraversalDirectionEnum::TRANSVERSE_IN_X; static constexpr TraversalDirectionEnum TRANSVERSE_IN_Y = TraversalDirectionEnum::TRANSVERSE_IN_Y; static constexpr TraversalDirectionEnum TRANSVERSE_IN_Z = TraversalDirectionEnum::TRANSVERSE_IN_Z; static constexpr TraversalDirectionEnum LAST_DIRECTION = TraversalDirectionEnum::LAST_DIRECTION; #endif // Cache the image in the structure. Skip the smart pointer for // efficiency. This inner class will go in/out of scope with every // call to Evaluate() const InputImageType * m_Image; /// Flag indicating whether the current ray is valid bool m_ValidRay; /** \brief * The start position of the ray in voxels. * * NB. Two of the components of this coordinate (i.e. those lying within * the planes of voxels being traversed) will be shifted by half a * voxel. This enables indices of the neighbouring voxels within the plane * to be determined by simply casting to 'int' and optionally adding 1. */ double m_RayVoxelStartPosition[3]; /** \brief * The end coordinate of the ray in voxels. * * NB. Two of the components of this coordinate (i.e. those lying within * the planes of voxels being traversed) will be shifted by half a * voxel. This enables indices of the neighbouring voxels within the plane * to be determined by simply casting to 'int' and optionally adding 1. */ double m_RayVoxelEndPosition[3]; /** \brief * The current coordinate on the ray in voxels. * * NB. Two of the components of this coordinate (i.e. those lying within * the planes of voxels being traversed) will be shifted by half a * voxel. This enables indices of the neighbouring voxels within the plane * to be determined by simply casting to 'int' and optionally adding 1. */ CompensatedSummationType m_Position3Dvox[3]; /** The incremental direction vector of the ray in voxels. */ double m_VoxelIncrement[3]; /// The direction in which the ray is incremented thorough the volume (x, y or // z). TraversalDirectionEnum m_TraversalDirection; /// The total number of planes of voxels traversed by the ray. int m_TotalRayVoxelPlanes; /// The current number of planes of voxels traversed by the ray. int m_NumVoxelPlanesTraversed; /// Pointers to the current four voxels surrounding the ray's trajectory. const PixelType * m_RayIntersectionVoxels[4]; /** * The voxel coordinate of the bottom-left voxel of the current * four voxels surrounding the ray's trajectory. */ int m_RayIntersectionVoxelIndex[3]; /// The dimension in voxels of the 3D volume in along the x axis int m_NumberOfVoxelsInX; /// The dimension in voxels of the 3D volume in along the y axis int m_NumberOfVoxelsInY; /// The dimension in voxels of the 3D volume in along the z axis int m_NumberOfVoxelsInZ; /// Voxel dimension in x double m_VoxelDimensionInX; /// Voxel dimension in y double m_VoxelDimensionInY; /// Voxel dimension in z double m_VoxelDimensionInZ; /// The coordinate of the point at which the ray enters the volume in mm. double m_RayStartCoordInMM[3]; /// The coordinate of the point at which the ray exits the volume in mm. double m_RayEndCoordInMM[3]; /** \brief Planes which define the boundary of the volume in mm (six planes and four parameters: Ax+By+Cz+D). */ double m_BoundingPlane[6][4]; /// The eight corners of the volume (x,y,z coordinates for each). double m_BoundingCorner[8][3]; /// The position of the ray double m_CurrentRayPositionInMM[3]; /// The direction of the ray double m_RayDirectionInMM[3]; }; /* ----------------------------------------------------------------------- Initialise() - Initialise the object ----------------------------------------------------------------------- */ template void RayCastInterpolateImageFunction::RayCastHelper::Initialise() { // Save the dimensions of the volume and calculate the bounding box this->RecordVolumeDimensions(); // Calculate the planes and corners which define the volume. this->DefineCorners(); this->CalcPlanesAndCorners(); } /* ----------------------------------------------------------------------- RecordVolumeDimensions() - Record volume dimensions and resolution ----------------------------------------------------------------------- */ template void RayCastInterpolateImageFunction::RayCastHelper::RecordVolumeDimensions() { typename InputImageType::SpacingType spacing = this->m_Image->GetSpacing(); SizeType dim = this->m_Image->GetLargestPossibleRegion().GetSize(); m_NumberOfVoxelsInX = dim[0]; m_NumberOfVoxelsInY = dim[1]; m_NumberOfVoxelsInZ = dim[2]; m_VoxelDimensionInX = spacing[0]; m_VoxelDimensionInY = spacing[1]; m_VoxelDimensionInZ = spacing[2]; } /* ----------------------------------------------------------------------- DefineCorners() - Define the corners of the volume ----------------------------------------------------------------------- */ template void RayCastInterpolateImageFunction::RayCastHelper::DefineCorners() { // Define corner positions as if at the origin m_BoundingCorner[0][0] = m_BoundingCorner[1][0] = m_BoundingCorner[2][0] = m_BoundingCorner[3][0] = 0; m_BoundingCorner[4][0] = m_BoundingCorner[5][0] = m_BoundingCorner[6][0] = m_BoundingCorner[7][0] = m_VoxelDimensionInX * m_NumberOfVoxelsInX; m_BoundingCorner[1][1] = m_BoundingCorner[3][1] = m_BoundingCorner[5][1] = m_BoundingCorner[7][1] = m_VoxelDimensionInY * m_NumberOfVoxelsInY; m_BoundingCorner[0][1] = m_BoundingCorner[2][1] = m_BoundingCorner[4][1] = m_BoundingCorner[6][1] = 0; m_BoundingCorner[0][2] = m_BoundingCorner[1][2] = m_BoundingCorner[4][2] = m_BoundingCorner[5][2] = m_VoxelDimensionInZ * m_NumberOfVoxelsInZ; m_BoundingCorner[2][2] = m_BoundingCorner[3][2] = m_BoundingCorner[6][2] = m_BoundingCorner[7][2] = 0; } /* ----------------------------------------------------------------------- CalcPlanesAndCorners() - Calculate the planes and corners of the volume. ----------------------------------------------------------------------- */ template void RayCastInterpolateImageFunction::RayCastHelper::CalcPlanesAndCorners() { int j; // find the equations of the planes int c1 = 0, c2 = 0, c3 = 0; for (j = 0; j < 6; ++j) { // loop around for planes switch (j) { // which corners to take case 0: c1 = 1; c2 = 2; c3 = 3; break; case 1: c1 = 4; c2 = 5; c3 = 6; break; case 2: c1 = 5; c2 = 3; c3 = 7; break; case 3: c1 = 2; c2 = 4; c3 = 6; break; case 4: c1 = 1; c2 = 5; c3 = 0; break; case 5: c1 = 3; c2 = 7; c3 = 2; break; } double line1x, line1y, line1z; double line2x, line2y, line2z; // lines from one corner to another in x,y,z dirns line1x = m_BoundingCorner[c1][0] - m_BoundingCorner[c2][0]; line2x = m_BoundingCorner[c1][0] - m_BoundingCorner[c3][0]; line1y = m_BoundingCorner[c1][1] - m_BoundingCorner[c2][1]; line2y = m_BoundingCorner[c1][1] - m_BoundingCorner[c3][1]; line1z = m_BoundingCorner[c1][2] - m_BoundingCorner[c2][2]; line2z = m_BoundingCorner[c1][2] - m_BoundingCorner[c3][2]; double A, B, C, D; // take cross product A = line1y * line2z - line2y * line1z; B = line2x * line1z - line1x * line2z; C = line1x * line2y - line2x * line1y; // find constant D = -(A * m_BoundingCorner[c1][0] + B * m_BoundingCorner[c1][1] + C * m_BoundingCorner[c1][2]); // initialise plane value and normalise m_BoundingPlane[j][0] = A / std::sqrt(A * A + B * B + C * C); m_BoundingPlane[j][1] = B / std::sqrt(A * A + B * B + C * C); m_BoundingPlane[j][2] = C / std::sqrt(A * A + B * B + C * C); m_BoundingPlane[j][3] = D / std::sqrt(A * A + B * B + C * C); if (itk::Math::AlmostEquals((A * A + B * B + C * C), 0.0)) { itk::ExceptionObject err(__FILE__, __LINE__); err.SetLocation(ITK_LOCATION); err.SetDescription("Division by zero (planes) " "- CalcPlanesAndCorners()."); throw err; } } } /* ----------------------------------------------------------------------- CalcRayIntercepts() - Calculate the ray intercepts with the volume. ----------------------------------------------------------------------- */ template bool RayCastInterpolateImageFunction::RayCastHelper::CalcRayIntercepts() { bool noInterceptFlag[6]; double cubeIntercepts[6][3]; constexpr unsigned int numSides = 6; // =6 to allow truncation: =4 to remove truncated rays // Calculate intercept of ray with planes double interceptx[6]; double intercepty[6]; double interceptz[6]; for (unsigned int j = 0; j < numSides; ++j) { const double denom = (m_BoundingPlane[j][0] * m_RayDirectionInMM[0] + m_BoundingPlane[j][1] * m_RayDirectionInMM[1] + m_BoundingPlane[j][2] * m_RayDirectionInMM[2]); if (static_cast(denom * 100) != 0) { const double d = -(m_BoundingPlane[j][3] + m_BoundingPlane[j][0] * m_CurrentRayPositionInMM[0] + m_BoundingPlane[j][1] * m_CurrentRayPositionInMM[1] + m_BoundingPlane[j][2] * m_CurrentRayPositionInMM[2]) / denom; interceptx[j] = m_CurrentRayPositionInMM[0] + d * m_RayDirectionInMM[0]; intercepty[j] = m_CurrentRayPositionInMM[1] + d * m_RayDirectionInMM[1]; interceptz[j] = m_CurrentRayPositionInMM[2] + d * m_RayDirectionInMM[2]; noInterceptFlag[j] = true; // OK } else { noInterceptFlag[j] = false; // NOT OK } } unsigned int nSidesCrossed = 0; for (unsigned int j = 0; j < numSides; ++j) { // Work out which corners to use int c[4]; if (j == 0) { c[0] = 0; c[1] = 1; c[2] = 3; c[3] = 2; } else if (j == 1) { c[0] = 4; c[1] = 5; c[2] = 7; c[3] = 6; } else if (j == 2) { c[0] = 1; c[1] = 5; c[2] = 7; c[3] = 3; } else if (j == 3) { c[0] = 0; c[1] = 2; c[2] = 6; c[3] = 4; } else if (j == 4) { // TOP c[0] = 0; c[1] = 1; c[2] = 5; c[3] = 4; } else if (j == 5) { // BOTTOM c[0] = 2; c[1] = 3; c[2] = 7; c[3] = 6; } // Calculate vectors from corner of ct volume to intercept. double cornerVect[4][3]; for (unsigned int i = 0; i < 4; ++i) { if (noInterceptFlag[j]) { cornerVect[i][0] = m_BoundingCorner[c[i]][0] - interceptx[j]; cornerVect[i][1] = m_BoundingCorner[c[i]][1] - intercepty[j]; cornerVect[i][2] = m_BoundingCorner[c[i]][2] - interceptz[j]; } else { cornerVect[i][0] = 0; cornerVect[i][1] = 0; cornerVect[i][2] = 0; } } // Do cross product with these vectors int cross[4][3]; unsigned int k = 0; for (unsigned int i = 0; i < 4; ++i) { if (i == 3) { k = 0; } else { k = i + 1; } const double ax = cornerVect[i][0]; const double ay = cornerVect[i][1]; const double az = cornerVect[i][2]; const double bx = cornerVect[k][0]; const double by = cornerVect[k][1]; const double bz = cornerVect[k][2]; // The int and divide by 100 are to avoid rounding errors. If // these are not included then you get values fluctuating around // zero and so in the subsequent check, all the values are not // above or below zero. NB. If you "INT" by too much here though // you can get problems in the corners of your volume when rays // are allowed to go through more than one plane. cross[i][0] = static_cast((ay * bz - az * by) / 100); cross[i][1] = static_cast((az * bx - ax * bz) / 100); cross[i][2] = static_cast((ax * by - ay * bx) / 100); } // See if a sign change occurred between all these cross products // if not, then the ray went through this plane unsigned int crossFlag = 0; for (unsigned int i = 0; i < 3; ++i) { if ((cross[0][i] <= 0 && cross[1][i] <= 0 && cross[2][i] <= 0 && cross[3][i] <= 0) || (cross[0][i] >= 0 && cross[1][i] >= 0 && cross[2][i] >= 0 && cross[3][i] >= 0)) { ++crossFlag; } } if (crossFlag == 3 && noInterceptFlag[j] == 1) { cubeIntercepts[nSidesCrossed][0] = interceptx[j]; cubeIntercepts[nSidesCrossed][1] = intercepty[j]; cubeIntercepts[nSidesCrossed][2] = interceptz[j]; ++nSidesCrossed; } } // End of loop over all four planes m_RayStartCoordInMM[0] = cubeIntercepts[0][0]; m_RayStartCoordInMM[1] = cubeIntercepts[0][1]; m_RayStartCoordInMM[2] = cubeIntercepts[0][2]; m_RayEndCoordInMM[0] = cubeIntercepts[1][0]; m_RayEndCoordInMM[1] = cubeIntercepts[1][1]; m_RayEndCoordInMM[2] = cubeIntercepts[1][2]; if (nSidesCrossed >= 5) { itkDebugStatement(std::cerr << "WARNING: No. of sides crossed equals: " << nSidesCrossed << std::endl); } // If 'nSidesCrossed' is larger than 2, this means that the ray goes through // a corner of the volume and due to rounding errors, the ray is // deemed to go through more than two planes. To obtain the correct // start and end positions we choose the two intercept values which // are furthest from each other. if (nSidesCrossed >= 3) { double maxInterDist = 0.0; for (unsigned int j = 0; j < nSidesCrossed - 1; ++j) { for (unsigned int k = j + 1; k < nSidesCrossed; ++k) { double interDist = 0.0; for (unsigned int i = 0; i < 3; ++i) { interDist += (cubeIntercepts[j][i] - cubeIntercepts[k][i]) * (cubeIntercepts[j][i] - cubeIntercepts[k][i]); } if (interDist > maxInterDist) { maxInterDist = interDist; m_RayStartCoordInMM[0] = cubeIntercepts[j][0]; m_RayStartCoordInMM[1] = cubeIntercepts[j][1]; m_RayStartCoordInMM[2] = cubeIntercepts[j][2]; m_RayEndCoordInMM[0] = cubeIntercepts[k][0]; m_RayEndCoordInMM[1] = cubeIntercepts[k][1]; m_RayEndCoordInMM[2] = cubeIntercepts[k][2]; } } } nSidesCrossed = 2; } if (nSidesCrossed == 2) { return true; } else { return false; } } /* ----------------------------------------------------------------------- SetRay() - Set the position and direction of the ray ----------------------------------------------------------------------- */ template bool RayCastInterpolateImageFunction::RayCastHelper::SetRay(const OutputPointType & rayPosition, const DirectionType & rayDirection) { // Store the position and direction of the ray typename TInputImage::SpacingType spacing = this->m_Image->GetSpacing(); SizeType dim = this->m_Image->GetLargestPossibleRegion().GetSize(); // we need to translate the _center_ of the volume to the origin m_NumberOfVoxelsInX = dim[0]; m_NumberOfVoxelsInY = dim[1]; m_NumberOfVoxelsInZ = dim[2]; m_VoxelDimensionInX = spacing[0]; m_VoxelDimensionInY = spacing[1]; m_VoxelDimensionInZ = spacing[2]; m_CurrentRayPositionInMM[0] = rayPosition[0]; m_CurrentRayPositionInMM[1] = rayPosition[1]; m_CurrentRayPositionInMM[2] = rayPosition[2]; m_RayDirectionInMM[0] = rayDirection[0]; m_RayDirectionInMM[1] = rayDirection[1]; m_RayDirectionInMM[2] = rayDirection[2]; // Compute the ray path for this coordinate in mm m_ValidRay = this->CalcRayIntercepts(); if (!m_ValidRay) { Reset(); return false; } // Convert the start and end coordinates of the ray to voxels this->EndPointsInVoxels(); /* Calculate the ray direction vector in voxels and hence the voxel increment required to traverse the ray, and the number of interpolation points on the ray. This routine also shifts the coordinate frame by half a voxel for two of the directional components (i.e. those lying within the planes of voxels being traversed). */ this->CalcDirnVector(); /* Reduce the length of the ray until both start and end coordinates lie inside the volume. */ m_ValidRay = this->AdjustRayLength(); // Reset the iterator to the start of the ray. Reset(); return m_ValidRay; } /* ----------------------------------------------------------------------- EndPointsInVoxels() - Convert the endpoints to voxels ----------------------------------------------------------------------- */ template void RayCastInterpolateImageFunction::RayCastHelper::EndPointsInVoxels() { m_RayVoxelStartPosition[0] = m_RayStartCoordInMM[0] / m_VoxelDimensionInX; m_RayVoxelStartPosition[1] = m_RayStartCoordInMM[1] / m_VoxelDimensionInY; m_RayVoxelStartPosition[2] = m_RayStartCoordInMM[2] / m_VoxelDimensionInZ; m_RayVoxelEndPosition[0] = m_RayEndCoordInMM[0] / m_VoxelDimensionInX; m_RayVoxelEndPosition[1] = m_RayEndCoordInMM[1] / m_VoxelDimensionInY; m_RayVoxelEndPosition[2] = m_RayEndCoordInMM[2] / m_VoxelDimensionInZ; } /* ----------------------------------------------------------------------- CalcDirnVector() - Calculate the incremental direction vector in voxels. ----------------------------------------------------------------------- */ template void RayCastInterpolateImageFunction::RayCastHelper::CalcDirnVector() { double xNum, yNum, zNum; // Calculate the number of voxels in each direction xNum = itk::Math::abs(m_RayVoxelStartPosition[0] - m_RayVoxelEndPosition[0]); yNum = itk::Math::abs(m_RayVoxelStartPosition[1] - m_RayVoxelEndPosition[1]); zNum = itk::Math::abs(m_RayVoxelStartPosition[2] - m_RayVoxelEndPosition[2]); // The direction iterated in is that with the greatest number of voxels // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ // Iterate in X direction if ((xNum >= yNum) && (xNum >= zNum)) { if (m_RayVoxelStartPosition[0] < m_RayVoxelEndPosition[0]) { m_VoxelIncrement[0] = 1; m_VoxelIncrement[1] = (m_RayVoxelStartPosition[1] - m_RayVoxelEndPosition[1]) / (m_RayVoxelStartPosition[0] - m_RayVoxelEndPosition[0]); m_VoxelIncrement[2] = (m_RayVoxelStartPosition[2] - m_RayVoxelEndPosition[2]) / (m_RayVoxelStartPosition[0] - m_RayVoxelEndPosition[0]); } else { m_VoxelIncrement[0] = -1; m_VoxelIncrement[1] = -(m_RayVoxelStartPosition[1] - m_RayVoxelEndPosition[1]) / (m_RayVoxelStartPosition[0] - m_RayVoxelEndPosition[0]); m_VoxelIncrement[2] = -(m_RayVoxelStartPosition[2] - m_RayVoxelEndPosition[2]) / (m_RayVoxelStartPosition[0] - m_RayVoxelEndPosition[0]); } // This section is to alter the start position in order to // place the center of the voxels in there correct positions, // rather than placing them at the corner of voxels which is // what happens if this is not carried out. The reason why // x has no -0.5 is because this is the direction we are going // to iterate in and therefore we wish to go from center to // center rather than finding the surrounding voxels. m_RayVoxelStartPosition[1] += (static_cast(m_RayVoxelStartPosition[0]) - m_RayVoxelStartPosition[0]) * m_VoxelIncrement[1] * m_VoxelIncrement[0] + 0.5 * m_VoxelIncrement[1] - 0.5; m_RayVoxelStartPosition[2] += (static_cast(m_RayVoxelStartPosition[0]) - m_RayVoxelStartPosition[0]) * m_VoxelIncrement[2] * m_VoxelIncrement[0] + 0.5 * m_VoxelIncrement[2] - 0.5; m_RayVoxelStartPosition[0] = static_cast(m_RayVoxelStartPosition[0]) + 0.5 * m_VoxelIncrement[0]; m_TotalRayVoxelPlanes = static_cast(xNum); m_TraversalDirection = TraversalDirectionEnum::TRANSVERSE_IN_X; } // Iterate in Y direction else if ((yNum >= xNum) && (yNum >= zNum)) { if (m_RayVoxelStartPosition[1] < m_RayVoxelEndPosition[1]) { m_VoxelIncrement[1] = 1; m_VoxelIncrement[0] = (m_RayVoxelStartPosition[0] - m_RayVoxelEndPosition[0]) / (m_RayVoxelStartPosition[1] - m_RayVoxelEndPosition[1]); m_VoxelIncrement[2] = (m_RayVoxelStartPosition[2] - m_RayVoxelEndPosition[2]) / (m_RayVoxelStartPosition[1] - m_RayVoxelEndPosition[1]); } else { m_VoxelIncrement[1] = -1; m_VoxelIncrement[0] = -(m_RayVoxelStartPosition[0] - m_RayVoxelEndPosition[0]) / (m_RayVoxelStartPosition[1] - m_RayVoxelEndPosition[1]); m_VoxelIncrement[2] = -(m_RayVoxelStartPosition[2] - m_RayVoxelEndPosition[2]) / (m_RayVoxelStartPosition[1] - m_RayVoxelEndPosition[1]); } m_RayVoxelStartPosition[0] += (static_cast(m_RayVoxelStartPosition[1]) - m_RayVoxelStartPosition[1]) * m_VoxelIncrement[0] * m_VoxelIncrement[1] + 0.5 * m_VoxelIncrement[0] - 0.5; m_RayVoxelStartPosition[2] += (static_cast(m_RayVoxelStartPosition[1]) - m_RayVoxelStartPosition[1]) * m_VoxelIncrement[2] * m_VoxelIncrement[1] + 0.5 * m_VoxelIncrement[2] - 0.5; m_RayVoxelStartPosition[1] = static_cast(m_RayVoxelStartPosition[1]) + 0.5 * m_VoxelIncrement[1]; m_TotalRayVoxelPlanes = static_cast(yNum); m_TraversalDirection = TraversalDirectionEnum::TRANSVERSE_IN_Y; } // Iterate in Z direction else { if (m_RayVoxelStartPosition[2] < m_RayVoxelEndPosition[2]) { m_VoxelIncrement[2] = 1; m_VoxelIncrement[0] = (m_RayVoxelStartPosition[0] - m_RayVoxelEndPosition[0]) / (m_RayVoxelStartPosition[2] - m_RayVoxelEndPosition[2]); m_VoxelIncrement[1] = (m_RayVoxelStartPosition[1] - m_RayVoxelEndPosition[1]) / (m_RayVoxelStartPosition[2] - m_RayVoxelEndPosition[2]); } else { m_VoxelIncrement[2] = -1; m_VoxelIncrement[0] = -(m_RayVoxelStartPosition[0] - m_RayVoxelEndPosition[0]) / (m_RayVoxelStartPosition[2] - m_RayVoxelEndPosition[2]); m_VoxelIncrement[1] = -(m_RayVoxelStartPosition[1] - m_RayVoxelEndPosition[1]) / (m_RayVoxelStartPosition[2] - m_RayVoxelEndPosition[2]); } m_RayVoxelStartPosition[0] += (static_cast(m_RayVoxelStartPosition[2]) - m_RayVoxelStartPosition[2]) * m_VoxelIncrement[0] * m_VoxelIncrement[2] + 0.5 * m_VoxelIncrement[0] - 0.5; m_RayVoxelStartPosition[1] += (static_cast(m_RayVoxelStartPosition[2]) - m_RayVoxelStartPosition[2]) * m_VoxelIncrement[1] * m_VoxelIncrement[2] + 0.5 * m_VoxelIncrement[1] - 0.5; m_RayVoxelStartPosition[2] = static_cast(m_RayVoxelStartPosition[2]) + 0.5 * m_VoxelIncrement[2]; m_TotalRayVoxelPlanes = static_cast(zNum); m_TraversalDirection = TraversalDirectionEnum::TRANSVERSE_IN_Z; } } /* ----------------------------------------------------------------------- AdjustRayLength() - Ensure that the ray lies within the volume ----------------------------------------------------------------------- */ template bool RayCastInterpolateImageFunction::RayCastHelper::AdjustRayLength() { bool startOK, endOK; int Istart[3]; int Idirn[3]; if (m_TraversalDirection == TraversalDirectionEnum::TRANSVERSE_IN_X) { Idirn[0] = 0; Idirn[1] = 1; Idirn[2] = 1; } else if (m_TraversalDirection == TraversalDirectionEnum::TRANSVERSE_IN_Y) { Idirn[0] = 1; Idirn[1] = 0; Idirn[2] = 1; } else if (m_TraversalDirection == TraversalDirectionEnum::TRANSVERSE_IN_Z) { Idirn[0] = 1; Idirn[1] = 1; Idirn[2] = 0; } else { itk::ExceptionObject err(__FILE__, __LINE__); err.SetLocation(ITK_LOCATION); err.SetDescription("The ray traversal direction is unset " "- AdjustRayLength()."); throw err; return false; } do { startOK = false; endOK = false; Istart[0] = static_cast(std::floor(m_RayVoxelStartPosition[0])); Istart[1] = static_cast(std::floor(m_RayVoxelStartPosition[1])); Istart[2] = static_cast(std::floor(m_RayVoxelStartPosition[2])); if ((Istart[0] >= 0) && (Istart[0] + Idirn[0] < m_NumberOfVoxelsInX) && (Istart[1] >= 0) && (Istart[1] + Idirn[1] < m_NumberOfVoxelsInY) && (Istart[2] >= 0) && (Istart[2] + Idirn[2] < m_NumberOfVoxelsInZ)) { startOK = true; } else { m_RayVoxelStartPosition[0] += m_VoxelIncrement[0]; m_RayVoxelStartPosition[1] += m_VoxelIncrement[1]; m_RayVoxelStartPosition[2] += m_VoxelIncrement[2]; --m_TotalRayVoxelPlanes; } Istart[0] = static_cast(std::floor(m_RayVoxelStartPosition[0] + m_TotalRayVoxelPlanes * m_VoxelIncrement[0])); Istart[1] = static_cast(std::floor(m_RayVoxelStartPosition[1] + m_TotalRayVoxelPlanes * m_VoxelIncrement[1])); Istart[2] = static_cast(std::floor(m_RayVoxelStartPosition[2] + m_TotalRayVoxelPlanes * m_VoxelIncrement[2])); if ((Istart[0] >= 0) && (Istart[0] + Idirn[0] < m_NumberOfVoxelsInX) && (Istart[1] >= 0) && (Istart[1] + Idirn[1] < m_NumberOfVoxelsInY) && (Istart[2] >= 0) && (Istart[2] + Idirn[2] < m_NumberOfVoxelsInZ)) { endOK = true; } else { --m_TotalRayVoxelPlanes; } } while ((!(startOK && endOK)) && (m_TotalRayVoxelPlanes > 1)); return (startOK && endOK); } /* ----------------------------------------------------------------------- Reset() - Reset the iterator to the start of the ray. ----------------------------------------------------------------------- */ template void RayCastInterpolateImageFunction::RayCastHelper::Reset() { int i; m_NumVoxelPlanesTraversed = -1; // If this is a valid ray... if (m_ValidRay) { for (i = 0; i < 3; ++i) { m_Position3Dvox[i] = m_RayVoxelStartPosition[i]; } this->InitialiseVoxelPointers(); } // otherwise set parameters to zero else { for (i = 0; i < 3; ++i) { m_RayVoxelStartPosition[i] = 0.; } for (i = 0; i < 3; ++i) { m_RayVoxelEndPosition[i] = 0.; } for (i = 0; i < 3; ++i) { m_VoxelIncrement[i] = 0.; } m_TraversalDirection = TraversalDirectionEnum::UNDEFINED_DIRECTION; m_TotalRayVoxelPlanes = 0; for (i = 0; i < 4; ++i) { m_RayIntersectionVoxels[i] = nullptr; } for (i = 0; i < 3; ++i) { m_RayIntersectionVoxelIndex[i] = 0; } } } /* ----------------------------------------------------------------------- InitialiseVoxelPointers() - Obtain pointers to the first four voxels ----------------------------------------------------------------------- */ template void RayCastInterpolateImageFunction::RayCastHelper::InitialiseVoxelPointers() { IndexType index; int Ix, Iy, Iz; Ix = static_cast(m_RayVoxelStartPosition[0]); Iy = static_cast(m_RayVoxelStartPosition[1]); Iz = static_cast(m_RayVoxelStartPosition[2]); m_RayIntersectionVoxelIndex[0] = Ix; m_RayIntersectionVoxelIndex[1] = Iy; m_RayIntersectionVoxelIndex[2] = Iz; switch (m_TraversalDirection) { case TraversalDirectionEnum::TRANSVERSE_IN_X: { if ((Ix >= 0) && (Ix < m_NumberOfVoxelsInX) && (Iy >= 0) && (Iy + 1 < m_NumberOfVoxelsInY) && (Iz >= 0) && (Iz + 1 < m_NumberOfVoxelsInZ)) { index[0] = Ix; index[1] = Iy; index[2] = Iz; m_RayIntersectionVoxels[0] = this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index); index[0] = Ix; index[1] = Iy + 1; index[2] = Iz; m_RayIntersectionVoxels[1] = (this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index)); index[0] = Ix; index[1] = Iy; index[2] = Iz + 1; m_RayIntersectionVoxels[2] = (this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index)); index[0] = Ix; index[1] = Iy + 1; index[2] = Iz + 1; m_RayIntersectionVoxels[3] = (this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index)); } else { m_RayIntersectionVoxels[0] = m_RayIntersectionVoxels[1] = m_RayIntersectionVoxels[2] = m_RayIntersectionVoxels[3] = nullptr; } break; } case TraversalDirectionEnum::TRANSVERSE_IN_Y: { if ((Ix >= 0) && (Ix + 1 < m_NumberOfVoxelsInX) && (Iy >= 0) && (Iy < m_NumberOfVoxelsInY) && (Iz >= 0) && (Iz + 1 < m_NumberOfVoxelsInZ)) { index[0] = Ix; index[1] = Iy; index[2] = Iz; m_RayIntersectionVoxels[0] = (this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index)); index[0] = Ix + 1; index[1] = Iy; index[2] = Iz; m_RayIntersectionVoxels[1] = (this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index)); index[0] = Ix; index[1] = Iy; index[2] = Iz + 1; m_RayIntersectionVoxels[2] = (this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index)); index[0] = Ix + 1; index[1] = Iy; index[2] = Iz + 1; m_RayIntersectionVoxels[3] = (this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index)); } else { m_RayIntersectionVoxels[0] = m_RayIntersectionVoxels[1] = m_RayIntersectionVoxels[2] = m_RayIntersectionVoxels[3] = nullptr; } break; } case TraversalDirectionEnum::TRANSVERSE_IN_Z: { if ((Ix >= 0) && (Ix + 1 < m_NumberOfVoxelsInX) && (Iy >= 0) && (Iy + 1 < m_NumberOfVoxelsInY) && (Iz >= 0) && (Iz < m_NumberOfVoxelsInZ)) { index[0] = Ix; index[1] = Iy; index[2] = Iz; m_RayIntersectionVoxels[0] = (this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index)); index[0] = Ix + 1; index[1] = Iy; index[2] = Iz; m_RayIntersectionVoxels[1] = (this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index)); index[0] = Ix; index[1] = Iy + 1; index[2] = Iz; m_RayIntersectionVoxels[2] = (this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index)); index[0] = Ix + 1; index[1] = Iy + 1; index[2] = Iz; m_RayIntersectionVoxels[3] = (this->m_Image->GetBufferPointer() + this->m_Image->ComputeOffset(index)); } else { m_RayIntersectionVoxels[0] = m_RayIntersectionVoxels[1] = m_RayIntersectionVoxels[2] = m_RayIntersectionVoxels[3] = nullptr; } break; } default: { itk::ExceptionObject err(__FILE__, __LINE__); err.SetLocation(ITK_LOCATION); err.SetDescription("The ray traversal direction is unset " "- InitialiseVoxelPointers()."); throw err; } } } /* ----------------------------------------------------------------------- IncrementVoxelPointers() - Increment the voxel pointers ----------------------------------------------------------------------- */ template void RayCastInterpolateImageFunction::RayCastHelper::IncrementVoxelPointers() { double xBefore = m_Position3Dvox[0].GetSum(); double yBefore = m_Position3Dvox[1].GetSum(); double zBefore = m_Position3Dvox[2].GetSum(); m_Position3Dvox[0] += m_VoxelIncrement[0]; m_Position3Dvox[1] += m_VoxelIncrement[1]; m_Position3Dvox[2] += m_VoxelIncrement[2]; int dx = static_cast(m_Position3Dvox[0].GetSum()) - static_cast(xBefore); int dy = static_cast(m_Position3Dvox[1].GetSum()) - static_cast(yBefore); int dz = static_cast(m_Position3Dvox[2].GetSum()) - static_cast(zBefore); m_RayIntersectionVoxelIndex[0] += dx; m_RayIntersectionVoxelIndex[1] += dy; m_RayIntersectionVoxelIndex[2] += dz; int totalRayVoxelPlanes = dx + dy * m_NumberOfVoxelsInX + dz * m_NumberOfVoxelsInX * m_NumberOfVoxelsInY; m_RayIntersectionVoxels[0] += totalRayVoxelPlanes; m_RayIntersectionVoxels[1] += totalRayVoxelPlanes; m_RayIntersectionVoxels[2] += totalRayVoxelPlanes; m_RayIntersectionVoxels[3] += totalRayVoxelPlanes; } /* ----------------------------------------------------------------------- GetCurrentIntensity() - Get the intensity of the current ray point. ----------------------------------------------------------------------- */ template double RayCastInterpolateImageFunction::RayCastHelper::GetCurrentIntensity() const { double a, b, c, d; double y, z; if (!m_ValidRay) { return 0; } a = static_cast(*m_RayIntersectionVoxels[0]); b = static_cast(*m_RayIntersectionVoxels[1] - a); c = static_cast(*m_RayIntersectionVoxels[2] - a); d = static_cast(*m_RayIntersectionVoxels[3] - a - b - c); switch (m_TraversalDirection) { case TraversalDirectionEnum::TRANSVERSE_IN_X: { y = m_Position3Dvox[1].GetSum() - std::floor(m_Position3Dvox[1].GetSum()); z = m_Position3Dvox[2].GetSum() - std::floor(m_Position3Dvox[2].GetSum()); break; } case TraversalDirectionEnum::TRANSVERSE_IN_Y: { y = m_Position3Dvox[0].GetSum() - std::floor(m_Position3Dvox[0].GetSum()); z = m_Position3Dvox[2].GetSum() - std::floor(m_Position3Dvox[2].GetSum()); break; } case TraversalDirectionEnum::TRANSVERSE_IN_Z: { y = m_Position3Dvox[0].GetSum() - std::floor(m_Position3Dvox[0].GetSum()); z = m_Position3Dvox[1].GetSum() - std::floor(m_Position3Dvox[1].GetSum()); break; } default: { itk::ExceptionObject err(__FILE__, __LINE__); err.SetLocation(ITK_LOCATION); err.SetDescription("The ray traversal direction is unset " "- GetCurrentIntensity()."); throw err; } } return a + b * y + c * z + d * y * z; } /* ----------------------------------------------------------------------- IntegrateAboveThreshold() - Integrate intensities above a threshold. ----------------------------------------------------------------------- */ template bool RayCastInterpolateImageFunction::RayCastHelper::IntegrateAboveThreshold(double & integral, double threshold) { double intensity; // double posn3D_x, posn3D_y, posn3D_z; CompensatedSummationType sum; // Check if this is a valid ray if (!m_ValidRay) { return false; } /* Step along the ray as quickly as possible integrating the interpolated intensities. */ for (m_NumVoxelPlanesTraversed = 0; m_NumVoxelPlanesTraversed < m_TotalRayVoxelPlanes; ++m_NumVoxelPlanesTraversed) { intensity = this->GetCurrentIntensity(); if (intensity > threshold) { sum += intensity - threshold; } this->IncrementVoxelPointers(); } /* The ray passes through the volume one plane of voxels at a time, however, if its moving diagonally the ray points will be further apart so account for this by scaling by the distance moved. */ integral = sum.GetSum(); integral *= this->GetRayPointSpacing(); return true; } /* ----------------------------------------------------------------------- ZeroState() - Set the default (zero) state of the object ----------------------------------------------------------------------- */ template void RayCastInterpolateImageFunction::RayCastHelper::ZeroState() { int i; m_ValidRay = false; m_NumberOfVoxelsInX = 0; m_NumberOfVoxelsInY = 0; m_NumberOfVoxelsInZ = 0; m_VoxelDimensionInX = 0; m_VoxelDimensionInY = 0; m_VoxelDimensionInZ = 0; for (i = 0; i < 3; ++i) { m_CurrentRayPositionInMM[i] = 0.; } for (i = 0; i < 3; ++i) { m_RayDirectionInMM[i] = 0.; } for (i = 0; i < 3; ++i) { m_RayVoxelStartPosition[i] = 0.; } for (i = 0; i < 3; ++i) { m_RayVoxelEndPosition[i] = 0.; } for (i = 0; i < 3; ++i) { m_VoxelIncrement[i] = 0.; } m_TraversalDirection = TraversalDirectionEnum::UNDEFINED_DIRECTION; m_TotalRayVoxelPlanes = 0; m_NumVoxelPlanesTraversed = -1; for (i = 0; i < 4; ++i) { m_RayIntersectionVoxels[i] = nullptr; } for (i = 0; i < 3; ++i) { m_RayIntersectionVoxelIndex[i] = 0; } } /************************************************************************** * * * Rest of this code is the actual RayCastInterpolateImageFunction * class * * **************************************************************************/ /* ----------------------------------------------------------------------- Constructor ----------------------------------------------------------------------- */ template RayCastInterpolateImageFunction::RayCastInterpolateImageFunction() { m_Threshold = 0.; m_FocalPoint[0] = 0.; m_FocalPoint[1] = 0.; m_FocalPoint[2] = 0.; } /* ----------------------------------------------------------------------- PrintSelf ----------------------------------------------------------------------- */ template void RayCastInterpolateImageFunction::PrintSelf(std::ostream & os, Indent indent) const { this->Superclass::PrintSelf(os, indent); os << indent << "Threshold: " << m_Threshold << std::endl; os << indent << "FocalPoint: " << m_FocalPoint << std::endl; os << indent << "Transform: " << m_Transform.GetPointer() << std::endl; os << indent << "Interpolator: " << m_Interpolator.GetPointer() << std::endl; } /* ----------------------------------------------------------------------- Evaluate at image index position ----------------------------------------------------------------------- */ template auto RayCastInterpolateImageFunction::Evaluate(const PointType & point) const -> OutputType { double integral = 0; OutputPointType transformedFocalPoint = m_Transform->TransformPoint(m_FocalPoint); DirectionType direction = transformedFocalPoint - point; RayCastInterpolateImageFunction::RayCastHelper ray; ray.SetImage(this->m_Image); ray.ZeroState(); ray.Initialise(); const PointType origin = this->m_Image->GetOrigin(); const auto spacing = this->m_Image->GetSpacing(); PointType rayPosition = point; for (unsigned int i = 0; i < PointType::Length; ++i) { rayPosition[i] -= origin[i] - 0.5 * spacing[i]; } ray.SetRay(rayPosition, direction); ray.IntegrateAboveThreshold(integral, m_Threshold); return (static_cast(integral)); } template auto RayCastInterpolateImageFunction::EvaluateAtContinuousIndex( const ContinuousIndexType & index) const -> OutputType { OutputPointType point; this->m_Image->TransformContinuousIndexToPhysicalPoint(index, point); return this->Evaluate(point); } } // namespace itk #endif