Permute Axes of an Image#


switch the axes of an image


Input image

Input image#

Output image

Output image#



#include "itkImageFileReader.h"
#include "itkImageFileWriter.h"
#include "itkPermuteAxesImageFilter.h"

main(int argc, char * argv[])
  if (argc != 3)
    std::cerr << "Usage: " << std::endl;
    std::cerr << argv[0];
    std::cerr << " <InputFileName> <OutputFileName>";
    std::cerr << std::endl;
    return EXIT_FAILURE;

  const char * inputFileName = argv[1];
  const char * outputFileName = argv[2];

  constexpr unsigned int Dimension = 2;

  using PixelType = unsigned char;
  using ImageType = itk::Image<PixelType, Dimension>;

  const auto input = itk::ReadImage<ImageType>(inputFileName);

  using FilterType = itk::PermuteAxesImageFilter<ImageType>;
  auto filter = FilterType::New();

  FilterType::PermuteOrderArrayType order;
  order[0] = 1;
  order[1] = 0;


    itk::WriteImage(filter->GetOutput(), outputFileName);
  catch (const itk::ExceptionObject & error)
    std::cerr << "Error: " << error << std::endl;
    return EXIT_FAILURE;

  return EXIT_SUCCESS;

Classes demonstrated#

template<typename TImage>
class PermuteAxesImageFilter : public itk::ImageToImageFilter<TImage, TImage>

Permutes the image axes according to a user specified order.

PermuateAxesImageFilter permutes the image axes according to a user specified order. The permutation order is set via method SetOrder( order ) where the input is an array of ImageDimension number of unsigned int. The elements of the array must be a rearrangment of the numbers from 0 to ImageDimension - 1.

The i-th axis of the output image corresponds with the order[i]-th axis of the input image.

The output meta image information (LargestPossibleRegion, spacing, origin) is computed by permuting the corresponding input meta information.

ITK Sphinx Examples:

See itk::PermuteAxesImageFilter for additional documentation.