A class to handle 2D FFT or 1D FFT in range or azimuth directions. More...

#include <Signal.h>

Public Member Functions
	Signal ()
	Default constructor.

	Signal (int nthreads)
	Constructor with number of threads.

void	fftPlanForward (std::valarray< std::complex< T > > &input, std::valarray< std::complex< T > > &output, int rank, int n, int howmany, int inembed, int istride, int idist, int *onembed, int ostride, int odist, int sign)
	initiate forward FFTW3 plan for a block of complex data input parameters follow FFTW3 interface for fftw_plan_many_dft

void	fftPlanForward (std::complex< T > input, std::complex< T > output, int rank, int n, int howmany, int inembed, int istride, int idist, int *onembed, int ostride, int odist, int sign)
	initiate forward FFTW3 plan for a block of complex data input parameters follow FFTW3 interface for fftw_plan_many_dft

void	fftPlanForward (std::valarray< T > &input, std::valarray< std::complex< T > > &output, int rank, int n, int howmany, int inembed, int istride, int idist, int *onembed, int ostride, int odist)
	initiate forward FFTW3 plan for a block of real data input parameters follow FFTW3 interface for fftw_plan_many_dft_r2c

void	fftPlanForward (T input, std::complex< T > output, int rank, int n, int howmany, int inembed, int istride, int idist, int *onembed, int ostride, int odist)
	initiate forward FFTW3 plan for a block of real data input parameters follow FFTW3 interface for fftw_plan_many_dft_r2c

void	fftPlanBackward (std::valarray< std::complex< T > > &input, std::valarray< std::complex< T > > &output, int rank, int n, int howmany, int inembed, int istride, int idist, int *onembed, int ostride, int odist, int sign)
	initiate iverse FFTW3 plan for a block of spectrum input parameters follow FFTW3 interface for fftw_plan_many_dft

void	fftPlanBackward (std::complex< T > input, std::complex< T > output, int rank, int n, int howmany, int inembed, int istride, int idist, int *onembed, int ostride, int odist, int sign)
	initiate iverse FFTW3 plan for a block of spectrum input parameters follow FFTW3 interface for fftw_plan_many_dft

void	fftPlanBackward (std::valarray< std::complex< T > > &input, std::valarray< T > &output, int rank, int n, int howmany, int inembed, int istride, int idist, int *onembed, int ostride, int odist)
	initiate iverse FFTW3 plan for a block of spectrum to be transformed to real data input parameters follow FFTW3 interface for fftw_plan_many_dft_c2r

void	fftPlanBackward (std::complex< T > input, T output, int rank, int n, int howmany, int inembed, int istride, int idist, int *onembed, int ostride, int odist)
	initiate iverse FFTW3 plan for a block of spectrum to be transformed to real data input parameters follow FFTW3 interface for fftw_plan_many_dft_c2r

void	forward (std::valarray< std::complex< T > > &input, std::valarray< std::complex< T > > &output)
	forward transform

void	forward (std::complex< T > input, std::complex< T > output)
	forward transform

void	forward (std::valarray< T > &input, std::valarray< std::complex< T > > &output)
	forward transform

void	forward (T input, std::complex< T > output)
	forward transform

void	inverse (std::valarray< std::complex< T > > &input, std::valarray< std::complex< T > > &output)
	inverse transform

void	inverse (std::complex< T > input, std::complex< T > output)
	inverse transform

void	inverse (std::valarray< std::complex< T > > &input, std::valarray< T > &output)
	inverse transform

void	inverse (std::complex< T > input, T output)
	inverse transform

void	forwardRangeFFT (std::valarray< std::complex< T > > &signal, std::valarray< std::complex< T > > &spectrum, int ncolumns, int nrows)
	initiate plan for forward FFT in range direction for a block of complex data.

void	forwardRangeFFT (std::complex< T > signal, std::complex< T > spectrum, int ncolumns, int nrows)
	initiate plan for forward FFT in range direction for a block of complex data.

void	forwardRangeFFT (std::valarray< T > &signal, std::valarray< std::complex< T > > &spectrum, int ncolumns, int nrows)
	initiate plan for forward FFT in range direction for a block of real data.

void	forwardRangeFFT (T signal, std::complex< T > spectrum, int ncolumns, int nrows)
	initiate plan for forward FFT in range direction for a block of real data.

void	forwardAzimuthFFT (std::valarray< std::complex< T > > &signal, std::valarray< std::complex< T > > &spectrum, int ncolumns, int nrows)
	initiate plan for forward FFT in azimuth direction for a block of complex data.

void	forwardAzimuthFFT (std::complex< T > signal, std::complex< T > spectrum, int ncolumns, int nrows)
	initiate plan for forward FFT in azimuth direction for a block of complex data.

void	forwardAzimuthFFT (std::valarray< T > &signal, std::valarray< std::complex< T > > &spectrum, int ncolumns, int nrows)
	initiate plan for forward FFT in azimuth direction for a block of real data.

void	forwardAzimuthFFT (T signal, std::complex< T > spectrum, int ncolumns, int nrows)
	initiate plan for forward FFT in azimuth direction for a block of real data.

void	forward2DFFT (std::valarray< std::complex< T > > &signal, std::valarray< std::complex< T > > &spectrum, int ncolumns, int nrows)
	initiate plan for forward two imensional FFT for a block of complex data

void	forward2DFFT (std::valarray< std::complex< T > > &signal, std::valarray< std::complex< T > > &spectrum, int incolumns, int inrows, int oncolumns, int onrows)
	initiate plan for forward two imensional FFT for a block of complex data

void	forward2DFFT (std::complex< T > signal, std::complex< T > spectrum, int ncolumns, int nrows)
	initiate plan for forward two imensional FFT for a block of complex data

void	forward2DFFT (std::complex< T > signal, std::complex< T > spectrum, int incolumns, int inrows, int oncolumns, int onrows)
	initiate plan for forward two imensional FFT for a block of complex data

void	forward2DFFT (std::valarray< T > &signal, std::valarray< std::complex< T > > &spectrum, int ncolumns, int nrows)
	initiate plan for forward two imensional FFT for a block of real data

void	forward2DFFT (std::valarray< T > &signal, std::valarray< std::complex< T > > &spectrum, int incolumns, int inrows, int oncolumns, int onrows)
	initiate plan for forward two imensional FFT for a block of real data

void	forward2DFFT (T signal, std::complex< T > spectrum, int ncolumns, int nrows)
	initiate plan for forward two imensional FFT for a block of real data

void	forward2DFFT (T signal, std::complex< T > spectrum, int incolumns, int inrows, int oncolumns, int onrows)
	initiate plan for forward two imensional FFT for a block of real data

void	inverseRangeFFT (std::valarray< std::complex< T > > &spectrum, std::valarray< std::complex< T > > &signal, int ncolumns, int nrows)
	initiate plan for backward FFT in range direction for a block of data

void	inverseRangeFFT (std::complex< T > spectrum, std::complex< T > signal, int ncolumns, int nrows)
	initiate plan for backward FFT in range direction for a block of data

void	inverseRangeFFT (std::valarray< std::complex< T > > &spectrum, std::valarray< T > &signal, int ncolumns, int nrows)
	initiate plan for backward FFT in range direction for a block of data

void	inverseRangeFFT (std::complex< T > spectrum, T signal, int ncolumns, int nrows)
	initiate plan for backward FFT in range direction for a block of data

void	inverseAzimuthFFT (std::valarray< std::complex< T > > &spectrum, std::valarray< std::complex< T > > &signal, int ncolumns, int nrows)
	initiate plan for inverse FFT in azimuth direction for a block of data

void	inverseAzimuthFFT (std::complex< T > spectrum, std::complex< T > signal, int ncolumns, int nrows)
	initiate plan for inverse FFT in azimuth direction for a block of data

void	inverseAzimuthFFT (std::valarray< std::complex< T > > &spectrum, std::valarray< T > &signal, int ncolumns, int nrows)
	initiate plan for inverse FFT in azimuth direction for a block of data

void	inverseAzimuthFFT (std::complex< T > spectrum, T signal, int ncolumns, int nrows)
	initiate plan for inverse FFT in azimuth direction for a block of data

void	inverse2DFFT (std::valarray< std::complex< T > > &spectrum, std::valarray< std::complex< T > > &signal, int ncolumns, int nrows)
	initiate plan for inverse two dimensional FFT for a block of data

void	inverse2DFFT (std::complex< T > spectrum, std::complex< T > signal, int ncolumns, int nrows)
	initiate plan for inverse two dimensional FFT for a block of data

void	inverse2DFFT (std::valarray< std::complex< T > > &spectrum, std::valarray< T > &signal, int ncolumns, int nrows)
	initiate plan for inverse two dimensional FFT for a block of data

void	inverse2DFFT (std::complex< T > spectrum, T signal, int ncolumns, int nrows)
	initiate plan for inverse two dimensional FFT for a block of data

void	upsample (std::valarray< std::complex< T > > &signal, std::valarray< std::complex< T > > &signalOversampled, int rows, int fft_size, int oversampleFactor)
	upsampling a block of data in range direction

void	upsample (std::valarray< std::complex< T > > &signal, std::valarray< std::complex< T > > &signalOversampled, int rows, int fft_size, int oversampleFactor, std::valarray< std::complex< T > > shiftImpact)
	upsampling a block of data in range direction and shifting the upsampled signal by a constant.

void	upsample (isce3::core::EArray2D< std::complex< T > > &signal, isce3::core::EArray2D< std::complex< T > > &signalUpsampled, const isce3::core::EArray2D< std::complex< T > > &shiftImpact={})
	upsampling a basebanded block of data in range (columns) direction and shifting the upsampled signal by a constant.

void	upsample2D (std::valarray< std::complex< T > > &signal, std::valarray< std::complex< T > > &signalOversampled, int oversampleFactor)
	2D upsampling a block of 2D data

void	upsample2D (std::valarray< std::complex< T > > &signal, std::valarray< std::complex< T > > &signalOversampled, int oversampleFactor, std::valarray< std::complex< T > > &shiftImpact)
	2D upsampling a block of 2D data and shifting the upsampled signal by a constant.

void	upsample2D (std::complex< T > signal, std::complex< T > signalOversampled, int oversampleFactor)
	2D upsampling a block of 2D data

void	upsample2D (std::complex< T > signal, std::complex< T > signalOversampled, int oversampleFactor, std::complex< T > *shiftImpact)
	2D upsampling a block of 2D data and shifting the upsampled signal by a constant.

void	nextPowerOfTwo (size_t N, size_t &fftLength)
	next power of two

void	_fwd_configure (int rank, int n, int howmany, int inembed, int istride, int idist, int *onembed, int ostride, int odist)
	save FFT plan parameters

void	_rev_configure (int rank, int n, int howmany, int inembed, int istride, int idist, int *onembed, int ostride, int odist)
	save FFT plan parameters

void	_fwd_configureRangeFFT (int ncolumns, int nrows)
	determine the required parameters for setting range FFT plans

void	_fwd_configureAzimuthFFT (int ncolumns, int nrows)
	determine the required parameters for setting azimuth FFT plans

void	_fwd_configure2DFFT (int incolumns, int inrows, int oncolumns, int onrows)
	determine the required parameters for setting 2D FFT plans

void	_rev_configureRangeFFT (int ncolumns, int nrows)
	determine the required parameters for setting range FFT plans

void	_rev_configureAzimuthFFT (int ncolumns, int nrows)
	determine the required parameters for setting azimuth FFT plans

void	_rev_configure2DFFT (int ncolumns, int nrows)
	determine the required parameters for setting 2D FFT plans

Detailed Description

template<class T>
class isce3::signal::Signal< T >

A class to handle 2D FFT or 1D FFT in range or azimuth directions.

Constructor & Destructor Documentation

◆ Signal()

template<class T>

isce3::signal::Signal< T >::Signal ( int nthreads )

Constructor with number of threads.

This uses the Multi-threaded FFTW

Member Function Documentation

◆ _fwd_configure()

template<class T>

void isce3::signal::Signal< T >::_fwd_configure	(	int	rank,
		int *	n,
		int	howmany,
		int *	inembed,
		int	istride,
		int	idist,
		int *	onembed,
		int	ostride,
		int	odist )

inline

save FFT plan parameters

Parameters

[in]	rank	dataset number of dimensions
[in]	n	size of each dimension (array)
[in]	howmany	number of forward FFT
[in]	inembed	layout of the input container
[in]	istride	packing of the input data
[in]	idist	number of elements between two input dataset
[in]	onembed	layout of the output container
[in]	ostride	packing of the output data
[in]	odist	number of elements between two output dataset

◆ _fwd_configure2DFFT()

template<class T>

void isce3::signal::Signal< T >::_fwd_configure2DFFT	(	int	incolumns,
		int	inrows,
		int	oncolumns,
		int	onrows )

inline

determine the required parameters for setting 2D FFT plans

Parameters

[in]	incolumns	number of columns
[in]	inrows	number of rows
[in]	oncolumns	number of columns in output container
[in]	onrows	number of rows in output container

◆ _fwd_configureAzimuthFFT()

template<class T>

void isce3::signal::Signal< T >::_fwd_configureAzimuthFFT	(	int	ncolumns,
		int	nrows )

inline

determine the required parameters for setting azimuth FFT plans

Parameters

[in]	ncolumns	number of columns
[in]	nrows	number of rows

◆ _fwd_configureRangeFFT()

template<class T>

void isce3::signal::Signal< T >::_fwd_configureRangeFFT	(	int	ncolumns,
		int	nrows )

inline

determine the required parameters for setting range FFT plans

Parameters

[in]	ncolumns	number of columns
[in]	nrows	number of rows

◆ _rev_configure()

template<class T>

void isce3::signal::Signal< T >::_rev_configure	(	int	rank,
		int *	n,
		int	howmany,
		int *	inembed,
		int	istride,
		int	idist,
		int *	onembed,
		int	ostride,
		int	odist )

inline

save FFT plan parameters

Parameters

[in]	rank	dataset number of dimensions
[in]	n	size of each dimension (array)
[in]	howmany	number of forward FFT
[in]	inembed	layout of the input container
[in]	istride	packing of the input data
[in]	idist	number of elements between two input dataset
[in]	onembed	layout of the output container
[in]	ostride	packing of the output data
[in]	odist	number of elements between two output dataset

◆ _rev_configure2DFFT()

template<class T>

void isce3::signal::Signal< T >::_rev_configure2DFFT	(	int	ncolumns,
		int	nrows )

inline

determine the required parameters for setting 2D FFT plans

Parameters

[in]	ncolumns	number of columns
[in]	nrows	number of rows

◆ _rev_configureAzimuthFFT()

template<class T>

void isce3::signal::Signal< T >::_rev_configureAzimuthFFT	(	int	ncolumns,
		int	nrows )

inline

determine the required parameters for setting azimuth FFT plans

Parameters

[in]	ncolumns	number of columns
[in]	nrows	number of rows

◆ _rev_configureRangeFFT()

template<class T>

void isce3::signal::Signal< T >::_rev_configureRangeFFT	(	int	ncolumns,
		int	nrows )

inline

determine the required parameters for setting range FFT plans

Parameters

[in]	ncolumns	number of columns
[in]	nrows	number of rows

◆ fftPlanBackward() [1/4]

template<class T>

void isce3::signal::Signal< T >::fftPlanBackward	(	std::complex< T > *	input,
		std::complex< T > *	output,
		int	rank,
		int *	n,
		int	howmany,
		int *	inembed,
		int	istride,
		int	idist,
		int *	onembed,
		int	ostride,
		int	odist,
		int	sign )

initiate iverse FFTW3 plan for a block of spectrum input parameters follow FFTW3 interface for fftw_plan_many_dft

Parameters

[in]	input	block of data
[out]	output	block of data
[in]	rank
[in]	size
[in]	howmany
[in]	inembed
[in]	istride
[in]	idist
[in]	onembed
[in]	ostride
[in]	odist
[in]	sign

◆ fftPlanBackward() [2/4]

template<class T>

void isce3::signal::Signal< T >::fftPlanBackward	(	std::complex< T > *	input,
		T *	output,
		int	rank,
		int *	n,
		int	howmany,
		int *	inembed,
		int	istride,
		int	idist,
		int *	onembed,
		int	ostride,
		int	odist )

initiate iverse FFTW3 plan for a block of spectrum to be transformed to real data input parameters follow FFTW3 interface for fftw_plan_many_dft_c2r

Parameters

[in]	input	block of data
[out]	output	block of data
[in]	rank
[in]	size
[in]	howmany
[in]	inembed
[in]	istride
[in]	idist
[in]	onembed
[in]	ostride
[in]	odist

◆ fftPlanBackward() [3/4]

template<class T>

void isce3::signal::Signal< T >::fftPlanBackward	(	std::valarray< std::complex< T > > &	input,
		std::valarray< std::complex< T > > &	output,
		int	rank,
		int *	n,
		int	howmany,
		int *	inembed,
		int	istride,
		int	idist,
		int *	onembed,
		int	ostride,
		int	odist,
		int	sign )

initiate iverse FFTW3 plan for a block of spectrum input parameters follow FFTW3 interface for fftw_plan_many_dft

Parameters

[in]	input	block of data
[out]	output	block of data
[in]	rank
[in]	size
[in]	howmany
[in]	inembed
[in]	istride
[in]	idist
[in]	onembed
[in]	ostride
[in]	odist
[in]	sign

◆ fftPlanBackward() [4/4]

template<class T>

void isce3::signal::Signal< T >::fftPlanBackward	(	std::valarray< std::complex< T > > &	input,
		std::valarray< T > &	output,
		int	rank,
		int *	n,
		int	howmany,
		int *	inembed,
		int	istride,
		int	idist,
		int *	onembed,
		int	ostride,
		int	odist )

initiate iverse FFTW3 plan for a block of spectrum to be transformed to real data input parameters follow FFTW3 interface for fftw_plan_many_dft_c2r

Parameters

[in]	input	block of data
[out]	output	block of data
[in]	rank
[in]	size
[in]	howmany
[in]	inembed
[in]	istride
[in]	idist
[in]	onembed
[in]	ostride
[in]	odist

◆ fftPlanForward() [1/4]

template<class T>

void isce3::signal::Signal< T >::fftPlanForward	(	std::complex< T > *	input,
		std::complex< T > *	output,
		int	rank,
		int *	n,
		int	howmany,
		int *	inembed,
		int	istride,
		int	idist,
		int *	onembed,
		int	ostride,
		int	odist,
		int	sign )

initiate forward FFTW3 plan for a block of complex data input parameters follow FFTW3 interface for fftw_plan_many_dft

Parameters

[in]	input	block of data
[out]	output	block of data
[in]	rank	rank of the transform (1: for one dimensional and 2: for two dimensional transform)
[in]	size	size of each transform (ncols: for range FFT, nrows: for azimuth FFT)
[in]	howmany	number of FFT transforms for a block of data (nrows: for range FFT, ncols: for azimuth FFT)
[in]	inembed
[in]	istride
[in]	idist
[in]	onembed
[in]	ostride
[in]	odist
[in]	sign

◆ fftPlanForward() [2/4]

template<class T>

void isce3::signal::Signal< T >::fftPlanForward	(	std::valarray< std::complex< T > > &	input,
		std::valarray< std::complex< T > > &	output,
		int	rank,
		int *	n,
		int	howmany,
		int *	inembed,
		int	istride,
		int	idist,
		int *	onembed,
		int	ostride,
		int	odist,
		int	sign )

initiate forward FFTW3 plan for a block of complex data input parameters follow FFTW3 interface for fftw_plan_many_dft

Parameters

[in]	input	block of data
[out]	output	block of data
[in]	rank	rank of the transform (1: for one dimensional and 2: for two dimensional transform)
[in]	size	size of each transform (ncols: for range FFT, nrows: for azimuth FFT)
[in]	howmany	number of FFT transforms for a block of data (nrows: for range FFT, ncols: for azimuth FFT)
[in]	inembed
[in]	istride
[in]	idist
[in]	onembed
[in]	ostride
[in]	odist
[in]	sign

◆ fftPlanForward() [3/4]

template<class T>

void isce3::signal::Signal< T >::fftPlanForward	(	std::valarray< T > &	input,
		std::valarray< std::complex< T > > &	output,
		int	rank,
		int *	n,
		int	howmany,
		int *	inembed,
		int	istride,
		int	idist,
		int *	onembed,
		int	ostride,
		int	odist )

initiate forward FFTW3 plan for a block of real data input parameters follow FFTW3 interface for fftw_plan_many_dft_r2c

Parameters

[in]	input	block of data
[out]	output	block of data
[in]	rank	rank of the transform (1: for one dimensional and 2: for two dimensional transform)
[in]	size	size of each transform (ncols: for range FFT, nrows: for azimuth FFT)
[in]	howmany	number of FFT transforms for a block of data (nrows: for range FFT, ncols: for azimuth FFT)
[in]	inembed
[in]	istride
[in]	idist
[in]	onembed
[in]	ostride
[in]	odist

◆ fftPlanForward() [4/4]

template<class T>

void isce3::signal::Signal< T >::fftPlanForward	(	T *	input,
		std::complex< T > *	output,
		int	rank,
		int *	n,
		int	howmany,
		int *	inembed,
		int	istride,
		int	idist,
		int *	onembed,
		int	ostride,
		int	odist )

initiate forward FFTW3 plan for a block of real data input parameters follow FFTW3 interface for fftw_plan_many_dft_r2c

Parameters

[in]	input	block of data
[out]	output	block of data
[in]	rank	rank of the transform (1: for one dimensional and 2: for two dimensional transform)
[in]	size	size of each transform (ncols: for range FFT, nrows: for azimuth FFT)
[in]	howmany	number of FFT transforms for a block of data (nrows: for range FFT, ncols: for azimuth FFT)
[in]	inembed
[in]	istride
[in]	idist
[in]	onembed
[in]	ostride
[in]	odist

◆ forward() [1/4]

template<class T>

void isce3::signal::Signal< T >::forward	(	std::complex< T > *	input,
		std::complex< T > *	output )

forward transform

unnormalized forward transform

Parameters

[in]	input	block of data
[out]	output	block of spectrum

◆ forward() [2/4]

template<class T>

void isce3::signal::Signal< T >::forward	(	std::valarray< std::complex< T > > &	input,
		std::valarray< std::complex< T > > &	output )

forward transform

unnormalized forward transform

Parameters

[in]	input	block of data
[out]	output	block of spectrum

◆ forward() [3/4]

template<class T>

void isce3::signal::Signal< T >::forward	(	std::valarray< T > &	input,
		std::valarray< std::complex< T > > &	output )

forward transform

unnormalized forward transform

Parameters

[in]	input	block of data
[out]	output	block of spectrum

◆ forward() [4/4]

template<class T>

void isce3::signal::Signal< T >::forward	(	T *	input,
		std::complex< T > *	output )

forward transform

unnormalized forward transform

Parameters

[in]	input	block of data
[out]	output	block of spectrum

◆ forward2DFFT() [1/8]

template<class T>

void isce3::signal::Signal< T >::forward2DFFT	(	std::complex< T > *	signal,
		std::complex< T > *	spectrum,
		int	incolumns,
		int	inrows,
		int	oncolumns,
		int	onrows )

initiate plan for forward two imensional FFT for a block of complex data

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	incolumns	number of columns of the block of data in input container
[in]	inrows	number of rows of the block of data in input container
[in]	oncolumns	number of columns of the block of data in output container
[in]	oupnrows	number of rows of the block of data in output container

If doing an out-of-place FFT, the output can be stored in a container whose number of columns and rows could be different than the input. This would be necessary for instance in the case of 2D upsampling

◆ forward2DFFT() [2/8]

template<class T>

void isce3::signal::Signal< T >::forward2DFFT	(	std::complex< T > *	signal,
		std::complex< T > *	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward two imensional FFT for a block of complex data

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ forward2DFFT() [3/8]

template<class T>

void isce3::signal::Signal< T >::forward2DFFT	(	std::valarray< std::complex< T > > &	signal,
		std::valarray< std::complex< T > > &	spectrum,
		int	incolumns,
		int	inrows,
		int	oncolumns,
		int	onrows )

initiate plan for forward two imensional FFT for a block of complex data

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	incolumns	number of columns of the block of data
[in]	inrows	number of rows of the block of data
[in]	oncolumns	number of columns of the block of data in output container
[in]	onrows	number of rows of the block of data in output container

If doing an out-of-place FFT, the output can be stored in a container whose number of columns and rows could be different than the input. This would be necessary for instance in the case of 2D upsampling

◆ forward2DFFT() [4/8]

template<class T>

void isce3::signal::Signal< T >::forward2DFFT	(	std::valarray< std::complex< T > > &	signal,
		std::valarray< std::complex< T > > &	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward two imensional FFT for a block of complex data

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ forward2DFFT() [5/8]

template<class T>

void isce3::signal::Signal< T >::forward2DFFT	(	std::valarray< T > &	signal,
		std::valarray< std::complex< T > > &	spectrum,
		int	incolumns,
		int	inrows,
		int	oncolumns,
		int	onrows )

initiate plan for forward two imensional FFT for a block of real data

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	incolumns	number of columns of the block of data in input container
[in]	inrows	number of rows of the block of data in input container
[in]	oncolumns	number of columns of the block of data in output container
[in]	oupnrows	number of rows of the block of data in output container

If doing an out-of-place FFT, the output can be stored in a container whose number of columns and rows could be different than the input. This would be necessary for instance in the case of 2D upsampling

◆ forward2DFFT() [6/8]

template<class T>

void isce3::signal::Signal< T >::forward2DFFT	(	std::valarray< T > &	signal,
		std::valarray< std::complex< T > > &	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward two imensional FFT for a block of real data

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ forward2DFFT() [7/8]

template<class T>

void isce3::signal::Signal< T >::forward2DFFT	(	T *	signal,
		std::complex< T > *	spectrum,
		int	incolumns,
		int	inrows,
		int	oncolumns,
		int	onrows )

initiate plan for forward two imensional FFT for a block of real data

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	incolumns	number of columns of the block of data in input container
[in]	inrows	number of rows of the block of data in input container
[in]	oncolumns	number of columns of the block of data in output container
[in]	oupnrows	number of rows of the block of data in output container

If doing an out-of-place FFT, the output can be stored in a container whose number of columns and rows could be different than the input. This would be necessary for instance in the case of 2D upsampling.

◆ forward2DFFT() [8/8]

template<class T>

void isce3::signal::Signal< T >::forward2DFFT	(	T *	signal,
		std::complex< T > *	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward two imensional FFT for a block of real data

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ forwardAzimuthFFT() [1/4]

template<class T>

void isce3::signal::Signal< T >::forwardAzimuthFFT	(	std::complex< T > *	signal,
		std::complex< T > *	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward FFT in azimuth direction for a block of complex data.

azimuth direction is assumed to be in the direction of the rows of the array.

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ forwardAzimuthFFT() [2/4]

template<class T>

void isce3::signal::Signal< T >::forwardAzimuthFFT	(	std::valarray< std::complex< T > > &	signal,
		std::valarray< std::complex< T > > &	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward FFT in azimuth direction for a block of complex data.

azimuth direction is assumed to be in the direction of the rows of the array.

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ forwardAzimuthFFT() [3/4]

template<class T>

void isce3::signal::Signal< T >::forwardAzimuthFFT	(	std::valarray< T > &	signal,
		std::valarray< std::complex< T > > &	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward FFT in azimuth direction for a block of real data.

azimuth direction is assumed to be in the direction of the rows of the array.

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ forwardAzimuthFFT() [4/4]

template<class T>

void isce3::signal::Signal< T >::forwardAzimuthFFT	(	T *	signal,
		std::complex< T > *	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward FFT in azimuth direction for a block of real data.

azimuth direction is assumed to be in the direction of the rows of the array.

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ forwardRangeFFT() [1/4]

template<class T>

void isce3::signal::Signal< T >::forwardRangeFFT	(	std::complex< T > *	signal,
		std::complex< T > *	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward FFT in range direction for a block of complex data.

range direction is assumed to be in the direction of the columns of the array.

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ forwardRangeFFT() [2/4]

template<class T>

void isce3::signal::Signal< T >::forwardRangeFFT	(	std::valarray< std::complex< T > > &	signal,
		std::valarray< std::complex< T > > &	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward FFT in range direction for a block of complex data.

range direction is assumed to be in the direction of the columns of the array.

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ forwardRangeFFT() [3/4]

template<class T>

void isce3::signal::Signal< T >::forwardRangeFFT	(	std::valarray< T > &	signal,
		std::valarray< std::complex< T > > &	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward FFT in range direction for a block of real data.

range direction is assumed to be in the direction of the columns of the array.

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ forwardRangeFFT() [4/4]

template<class T>

void isce3::signal::Signal< T >::forwardRangeFFT	(	T *	signal,
		std::complex< T > *	spectrum,
		int	ncolumns,
		int	nrows )

initiate plan for forward FFT in range direction for a block of real data.

range direction is assumed to be in the direction of the columns of the array.

Parameters

[in]	signal	input block of data
[out]	spectrum	output block of spectrum
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverse() [1/4]

template<class T>

void isce3::signal::Signal< T >::inverse	(	std::complex< T > *	input,
		std::complex< T > *	output )

inverse transform

unnormalized inverse transform.

◆ inverse() [2/4]

template<class T>

void isce3::signal::Signal< T >::inverse	(	std::complex< T > *	input,
		T *	output )

inverse transform

unnormalized inverse transform.

◆ inverse() [3/4]

template<class T>

void isce3::signal::Signal< T >::inverse	(	std::valarray< std::complex< T > > &	input,
		std::valarray< std::complex< T > > &	output )

inverse transform

unnormalized inverse transform.

Note that since the FFTW library does not normalize the DFT computations, computing a forward followed by a backward transform (or vice versa) results in the original array scaled by length of fft.

Parameters

[in]	input	block of spectrum
[out]	output	block of data

◆ inverse() [4/4]

template<class T>

void isce3::signal::Signal< T >::inverse	(	std::valarray< std::complex< T > > &	input,
		std::valarray< T > &	output )

inverse transform

unnormalized inverse transform.

◆ inverse2DFFT() [1/4]

template<class T>

void isce3::signal::Signal< T >::inverse2DFFT	(	std::complex< T > *	spectrum,
		std::complex< T > *	signal,
		int	ncolumns,
		int	nrows )

initiate plan for inverse two dimensional FFT for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverse2DFFT() [2/4]

template<class T>

void isce3::signal::Signal< T >::inverse2DFFT	(	std::complex< T > *	spectrum,
		T *	signal,
		int	ncolumns,
		int	nrows )

initiate plan for inverse two dimensional FFT for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverse2DFFT() [3/4]

template<class T>

void isce3::signal::Signal< T >::inverse2DFFT	(	std::valarray< std::complex< T > > &	spectrum,
		std::valarray< std::complex< T > > &	signal,
		int	ncolumns,
		int	nrows )

initiate plan for inverse two dimensional FFT for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverse2DFFT() [4/4]

template<class T>

void isce3::signal::Signal< T >::inverse2DFFT	(	std::valarray< std::complex< T > > &	spectrum,
		std::valarray< T > &	signal,
		int	ncolumns,
		int	nrows )

initiate plan for inverse two dimensional FFT for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverseAzimuthFFT() [1/4]

template<class T>

void isce3::signal::Signal< T >::inverseAzimuthFFT	(	std::complex< T > *	spectrum,
		std::complex< T > *	signal,
		int	ncolumns,
		int	nrows )

initiate plan for inverse FFT in azimuth direction for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverseAzimuthFFT() [2/4]

template<class T>

void isce3::signal::Signal< T >::inverseAzimuthFFT	(	std::complex< T > *	spectrum,
		T *	signal,
		int	ncolumns,
		int	nrows )

initiate plan for inverse FFT in azimuth direction for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverseAzimuthFFT() [3/4]

template<class T>

void isce3::signal::Signal< T >::inverseAzimuthFFT	(	std::valarray< std::complex< T > > &	spectrum,
		std::valarray< std::complex< T > > &	signal,
		int	ncolumns,
		int	nrows )

initiate plan for inverse FFT in azimuth direction for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverseAzimuthFFT() [4/4]

template<class T>

void isce3::signal::Signal< T >::inverseAzimuthFFT	(	std::valarray< std::complex< T > > &	spectrum,
		std::valarray< T > &	signal,
		int	ncolumns,
		int	nrows )

initiate plan for inverse FFT in azimuth direction for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverseRangeFFT() [1/4]

template<class T>

void isce3::signal::Signal< T >::inverseRangeFFT	(	std::complex< T > *	spectrum,
		std::complex< T > *	signal,
		int	ncolumns,
		int	nrows )

initiate plan for backward FFT in range direction for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverseRangeFFT() [2/4]

template<class T>

void isce3::signal::Signal< T >::inverseRangeFFT	(	std::complex< T > *	spectrum,
		T *	signal,
		int	ncolumns,
		int	nrows )

initiate plan for backward FFT in range direction for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverseRangeFFT() [3/4]

template<class T>

void isce3::signal::Signal< T >::inverseRangeFFT	(	std::valarray< std::complex< T > > &	spectrum,
		std::valarray< std::complex< T > > &	signal,
		int	ncolumns,
		int	nrows )

initiate plan for backward FFT in range direction for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ inverseRangeFFT() [4/4]

template<class T>

void isce3::signal::Signal< T >::inverseRangeFFT	(	std::valarray< std::complex< T > > &	spectrum,
		std::valarray< T > &	signal,
		int	ncolumns,
		int	nrows )

initiate plan for backward FFT in range direction for a block of data

Parameters

[in]	spectrum	input block of spectrum
[out]	signal	output block of data
[in]	ncolumns	number of columns of the block of data
[in]	nrows	number of rows of the block of data

◆ nextPowerOfTwo()

template<class T>

void isce3::signal::Signal< T >::nextPowerOfTwo	(	size_t	N,
		size_t &	fftLength )

inline

next power of two

Parameters

[in]	N	the actual length of a signal
[in]	fftLength	next power of two

◆ upsample() [1/3]

template<class T>

void isce3::signal::Signal< T >::upsample	(	isce3::core::EArray2D< std::complex< T > > &	signal,
		isce3::core::EArray2D< std::complex< T > > &	signalUpsampled,
		const isce3::core::EArray2D< std::complex< T > > &	shiftImpact = {} )

upsampling a basebanded block of data in range (columns) direction and shifting the upsampled signal by a constant.

The shift is applied by an inout linear phase term in frequency domain.

Parameters

[in]	signal	input block of data
[out]	signalUpsampled	output block of oversampled data
[in]	shiftImpact	a linear phase term equivalent to a constant shift in time domain

◆ upsample() [2/3]

template<class T>

void isce3::signal::Signal< T >::upsample	(	std::valarray< std::complex< T > > &	signal,
		std::valarray< std::complex< T > > &	signalUpsampled,
		int	rows,
		int	fft_size,
		int	upsampleFactor )

upsampling a block of data in range direction

Parameters

[in]	signal	input block of data
[in]	signalUpsampled	output block of oversampled data
[in]	rows	number of rows of the block of input and upsampled data
[in]	fft_size	number of columns of the block of input data
[in]	upsampleFactor	upsampling factor

◆ upsample() [3/3]

template<class T>

void isce3::signal::Signal< T >::upsample	(	std::valarray< std::complex< T > > &	signal,
		std::valarray< std::complex< T > > &	signalUpsampled,
		int	rows,
		int	fft_size,
		int	upsampleFactor,
		std::valarray< std::complex< T > >	shiftImpact )

upsampling a block of data in range direction and shifting the upsampled signal by a constant.

The shift is applied by an inout linear phase term in frequency domain.

Parameters

[in]	signal	input block of data
[out]	signalUpsampled	output block of oversampled data
[in]	rows	number of rows of the block of input and upsampled data
[in]	fft_size	number of columns of the block of input data
[in]	upsampleFactor	upsampling factor
[out]	shiftImpact	a linear phase term equivalent to a constant shift in time domain

◆ upsample2D() [1/4]

template<class T>

void isce3::signal::Signal< T >::upsample2D	(	std::complex< T > *	signal,
		std::complex< T > *	signalUpsampled,
		int	upsampleFactor )

2D upsampling a block of 2D data

Parameters

[in]	signal	input block of 2D data
[out]	signalUpsampled	output block of oversampled data
[in]	upsampleFactor	upsampling factor

When doing out-of-place upsampling, i.e., when the container of the input to upsample is different to the one that will contain the upsampled data, the FFT forward plan must be set to out-of-place (with the input and output containers) and the FFT reverse plan to in-place (with the output container). In both case (in-place or out-of-place 2D upsampling), it is the user responsability to provide an output container that is padded (for in-place) or filled (for out-of-place) with zeros.

◆ upsample2D() [2/4]

template<class T>

void isce3::signal::Signal< T >::upsample2D	(	std::complex< T > *	signal,
		std::complex< T > *	signalUpsampled,
		int	upsampleFactor,
		std::complex< T > *	shiftImpact )

2D upsampling a block of 2D data and shifting the upsampled signal by a constant.

The shift is applied by an inout linear phase term in frequency domain.

Parameters

[in]	signal	input block of 2D data
[out]	signalUpsampled	output block of oversampled data
[in]	upsampleFactor	upsampling factor
[in]	shiftImpact	a linear phase term equivalent to a constant shift in time domain

When doing out-of-place upsampling, i.e., when the container of the input to upsample is different to the one that will contain the upsampled data, the FFT forward plan must be set to out-of-place (with the input and output containers) and the FFT reverse plan to in-place (with the output container). In both case (in-place or out-of-place 2D upsampling), it is the user responsability to provide an output container that is padded (for in-place) or filled (for out-of-place) with zeros.

◆ upsample2D() [3/4]

template<class T>

void isce3::signal::Signal< T >::upsample2D	(	std::valarray< std::complex< T > > &	signal,
		std::valarray< std::complex< T > > &	signalUpsampled,
		int	oversampleFactor )

2D upsampling a block of 2D data

Parameters

[in]	signal	input block of 2D data
[out]	signalUpsampled	output block of oversampled data
[in]	upsampleFactor	upsampling factor

When doing out-of-place upsampling, i.e., when the container of the input to upsample is different to the one that will contain the upsampled data, the FFT forward plan must be set to out-of-place (with the input and output containers) and the FFT reverse plan to in-place (with the output container). In both case (in-place or out-of-place 2D upsampling), it is the user responsability to provide an output container that is padded (for in-place) or filled (for out-of-place) with zeros.

◆ upsample2D() [4/4]

template<class T>

void isce3::signal::Signal< T >::upsample2D	(	std::valarray< std::complex< T > > &	signal,
		std::valarray< std::complex< T > > &	signalUpsampled,
		int	upsampleFactor,
		std::valarray< std::complex< T > > &	shiftImpact )

2D upsampling a block of 2D data and shifting the upsampled signal by a constant.

The shift is applied by an inout linear phase term in frequency domain.

Parameters

[in]	signal	input block of 2D data
[out]	signalUpsampled	output block of oversampled data
[in]	upsampleFactor	upsampling factor
[in]	shiftImpact	a linear phase term equivalent to a constant shift in time domain

When doing out-of-place upsampling, i.e., when the container of the input to upsample is different to the one that will contain the upsampled data, the FFT forward plan must be set to out-of-place (with the input and output containers) and the FFT reverse plan to in-place (with the output container). In both case (in-place or out-of-place 2D upsampling), it is the user responsability to provide an output container that is padded (for in-place) or filled (for out-of-place) with zeros.

The documentation for this class was generated from the following files:

/home/runner/work/isce3/isce3/cxx/isce3/signal/forward.h
/home/runner/work/isce3/isce3/cxx/isce3/signal/Signal.h
/home/runner/work/isce3/isce3/cxx/isce3/signal/Signal.cpp
/home/runner/work/isce3/isce3/cxx/isce3/signal/Signal.icc

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ Signal()

Member Function Documentation

◆ _fwd_configure()

◆ _fwd_configure2DFFT()

◆ _fwd_configureAzimuthFFT()

◆ _fwd_configureRangeFFT()

◆ _rev_configure()

◆ _rev_configure2DFFT()

◆ _rev_configureAzimuthFFT()

◆ _rev_configureRangeFFT()

◆ fftPlanBackward() [1/4]

◆ fftPlanBackward() [2/4]

◆ fftPlanBackward() [3/4]

◆ fftPlanBackward() [4/4]

◆ fftPlanForward() [1/4]

◆ fftPlanForward() [2/4]

◆ fftPlanForward() [3/4]

◆ fftPlanForward() [4/4]

◆ forward() [1/4]

◆ forward() [2/4]

◆ forward() [3/4]

◆ forward() [4/4]

◆ forward2DFFT() [1/8]

◆ forward2DFFT() [2/8]

◆ forward2DFFT() [3/8]

◆ forward2DFFT() [4/8]

◆ forward2DFFT() [5/8]

◆ forward2DFFT() [6/8]

◆ forward2DFFT() [7/8]

◆ forward2DFFT() [8/8]

◆ forwardAzimuthFFT() [1/4]

◆ forwardAzimuthFFT() [2/4]

◆ forwardAzimuthFFT() [3/4]

◆ forwardAzimuthFFT() [4/4]

◆ forwardRangeFFT() [1/4]

◆ forwardRangeFFT() [2/4]

◆ forwardRangeFFT() [3/4]

◆ forwardRangeFFT() [4/4]

◆ inverse() [1/4]

◆ inverse() [2/4]

◆ inverse() [3/4]

◆ inverse() [4/4]

◆ inverse2DFFT() [1/4]

◆ inverse2DFFT() [2/4]

◆ inverse2DFFT() [3/4]

◆ inverse2DFFT() [4/4]

◆ inverseAzimuthFFT() [1/4]

◆ inverseAzimuthFFT() [2/4]

◆ inverseAzimuthFFT() [3/4]

◆ inverseAzimuthFFT() [4/4]

◆ inverseRangeFFT() [1/4]

◆ inverseRangeFFT() [2/4]

◆ inverseRangeFFT() [3/4]

◆ inverseRangeFFT() [4/4]

◆ nextPowerOfTwo()

◆ upsample() [1/3]

◆ upsample() [2/3]

◆ upsample() [3/3]

◆ upsample2D() [1/4]

◆ upsample2D() [2/4]

◆ upsample2D() [3/4]

◆ upsample2D() [4/4]