ImageDev

SwapQuadrants

Performs a quadrant-wise translation in circular mode.

Access to parameter description

This algorithm performs a quadrant-wise translation in circular mode by a vector equal to half the diagonal of the image, as shown in Figure 1. In case of an odd image size, the center is rounded up or down according to the centerPolicy value.

It is generally used to visualize the modulus of the FFT centered in the middle of image rather than in the upper left corner. The image is centered by a translation in circular mode by a vector equal to half the diagonal of the image.

<b> Figure 1.</b> The results of a regular and a centered FFT
Figure 1. The results of a regular and a centered FFT

See also

Function Syntax

This function returns the outputImage output parameter. 
// Function prototype.
std::shared_ptr< iolink::ImageView >
swapQuadrants( std::shared_ptr< iolink::ImageView > inputImage,
               SwapQuadrants::CenterPolicy centerPolicy,
               std::shared_ptr< iolink::ImageView > outputImage = NULL );
This function returns the outputImage output parameter. 
// Function prototype.
swap_quadrants( input_image, center_policy = SwapQuadrants.CenterPolicy.CEIL, output_image = None )
This function returns the outputImage output parameter. 
// Function prototype.
public static IOLink.ImageView
SwapQuadrants( IOLink.ImageView inputImage,
               SwapQuadrants.CenterPolicy centerPolicy = ImageDev.SwapQuadrants.CenterPolicy.CEIL,
               IOLink.ImageView outputImage = null );

Class Syntax

Parameters

Class Name SwapQuadrants

Parameter Name Description Type Supported Values Default Value
input
inputImage
The input image. Image Binary, Label, Grayscale or Multispectral nullptr
input
centerPolicy
The way to round the center position in case of odd image dimensions.
FLOOR This mode rounds the center position to the closest inferior integer.
CEIL This mode rounds the center position to the closest superior integer.
Enumeration CEIL
output
outputImage
The output image. Its dimensions and type are forced to the same values as the input. Image nullptr

Object Examples

auto foam = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam.vip" );

SwapQuadrants swapQuadrantsAlgo;
swapQuadrantsAlgo.setInputImage( foam );
swapQuadrantsAlgo.setCenterPolicy( SwapQuadrants::CenterPolicy::CEIL );
swapQuadrantsAlgo.execute();

std::cout << "outputImage:" << swapQuadrantsAlgo.outputImage()->toString();

foam = imagedev.read_vip_image(imagedev_data.get_image_path("foam.vip"))

swap_quadrants_algo = imagedev.SwapQuadrants()
swap_quadrants_algo.input_image = foam
swap_quadrants_algo.center_policy = imagedev.SwapQuadrants.CEIL
swap_quadrants_algo.execute()

print( "output_image:", str( swap_quadrants_algo.output_image ) );

ImageView foam = Data.ReadVipImage( @"Data/images/foam.vip" );

SwapQuadrants swapQuadrantsAlgo = new SwapQuadrants
{
    inputImage = foam,
    centerPolicy = SwapQuadrants.CenterPolicy.CEIL
};
swapQuadrantsAlgo.Execute();

Console.WriteLine( "outputImage:" + swapQuadrantsAlgo.outputImage.ToString() );

Function Examples

auto foam = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam.vip" );

auto result = swapQuadrants( foam, SwapQuadrants::CenterPolicy::CEIL );

std::cout << "outputImage:" << result->toString();

foam = imagedev.read_vip_image(imagedev_data.get_image_path("foam.vip"))

result = imagedev.swap_quadrants( foam, imagedev.SwapQuadrants.CEIL )

print( "output_image:", str( result ) );

ImageView foam = Data.ReadVipImage( @"Data/images/foam.vip" );

IOLink.ImageView result = Processing.SwapQuadrants( foam, SwapQuadrants.CenterPolicy.CEIL );

Console.WriteLine( "outputImage:" + result.ToString() );