2D MPI abstract grid class More...

Inheritance diagram for dg::aRealMPITopology2d< real_type >:

Public Types
using	value_type = real_type

using	host_vector = MPI_Vector< thrust::host_vector< real_type > >
	The host vector type used by host functions like evaluate. More...

using	host_grid = RealMPIGrid2d< real_type >

Public Member Functions
real_type	x0 () const
	Return global x0. More...

real_type	x1 () const
	Return global x1. More...

real_type	y0 () const
	Return global y0. More...

real_type	y1 () const
	Return global y1. More...

real_type	lx () const
	Return global lx. More...

real_type	ly () const
	Return global ly. More...

real_type	hx () const
	Return global hx. More...

real_type	hy () const
	Return global hy. More...

unsigned	n () const
	Return n. More...

unsigned	nx () const
	number of polynomial coefficients in x More...

unsigned	ny () const
	number of polynomial coefficients in y More...

unsigned	Nx () const
	Return the global number of cells. More...

unsigned	Ny () const
	Return the global number of cells. More...

bc	bcx () const
	global x boundary More...

bc	bcy () const
	global y boundary More...

MPI_Comm	communicator () const
	Return mpi cartesian communicator that is used in this grid. More...

const DLT< real_type > &	dltx () const
	discrete legendre transformation in x More...

const DLT< real_type > &	dlty () const
	discrete legendre transformation in y More...

unsigned	size () const
	The total global number of points. More...

unsigned	local_size () const
	The total local number of points. More...

void	display (std::ostream &os=std::cout) const
	Display global and local grid. More...

int	pidOf (real_type x, real_type y) const
	Returns the pid of the process that holds the local grid surrounding the given point. More...

void	multiplyCellNumbers (real_type fx, real_type fy)
	Multiply the number of cells with a given factor. More...

void	set (unsigned new_n, unsigned new_Nx, unsigned new_Ny)
	Set the number of polynomials and cells. More...

void	set (unsigned new_nx, unsigned new_Nx, unsigned new_ny, unsigned new_Ny)
	Set the number of polynomials and cells. More...

bool	local2globalIdx (int localIdx, int PID, int &globalIdx) const
	Map a local index plus the PID to a global vector index. More...

bool	global2localIdx (int globalIdx, int &localIdx, int &PID) const
	Map a global vector index to a local vector Index and the corresponding PID. More...

const RealGrid2d< real_type > &	local () const
	Return a non-MPI grid local for the calling process. More...

const RealGrid2d< real_type > &	global () const
	Return the global non-MPI grid. More...

Protected Member Functions
	~aRealMPITopology2d ()=default
	disallow deletion through base class pointer More...

	aRealMPITopology2d (RealGrid1d< real_type > gx, RealGrid1d< real_type > gy, MPI_Comm comm)
	Construct a 2d grid as the product of two 1d grids. More...

	aRealMPITopology2d (const aRealMPITopology2d &src)=default

aRealMPITopology2d &	operator= (const aRealMPITopology2d &src)=default

virtual void	do_set (unsigned new_nx, unsigned new_Nx, unsigned new_ny, unsigned new_Ny)=0
	This function has an implementation. More...

Detailed Description

template<class real_type>
struct dg::aRealMPITopology2d< real_type >

2D MPI abstract grid class

Represents the global grid coordinates and the process topology. It just divides the given (global) box into nonoverlapping (local) subboxes that are attributed to each process

Note: a single cell is never divided across processes.; although it is abstract, objects are not meant to be hold on the heap via a base class pointer ( we protected the destructor)

Attention: The access functions nx() Nx() ,... all return the global parameters. If you want to have the local ones call the local() function.

Member Typedef Documentation

◆ host_grid

template<class real_type >

using dg::aRealMPITopology2d< real_type >::host_grid = RealMPIGrid2d<real_type>

◆ host_vector

template<class real_type >

using dg::aRealMPITopology2d< real_type >::host_vector = MPI_Vector<thrust::host_vector<real_type> >

The host vector type used by host functions like evaluate.

◆ value_type

template<class real_type >

using dg::aRealMPITopology2d< real_type >::value_type = real_type

Constructor & Destructor Documentation

◆ ~aRealMPITopology2d()

template<class real_type >

dg::aRealMPITopology2d< real_type >::~aRealMPITopology2d ( )

protecteddefault

disallow deletion through base class pointer

◆ aRealMPITopology2d() [1/2]

template<class real_type >

dg::aRealMPITopology2d< real_type >::aRealMPITopology2d	(	RealGrid1d< real_type >	gx,
		RealGrid1d< real_type >	gy,
		MPI_Comm	comm
	)

inlineprotected

Construct a 2d grid as the product of two 1d grids.

dg::Grid2d g2d( {x0,x1,nx,Nx,bcx},{y0,y1,ny,Ny,bcy});

dg::RealGrid2d< double >

dg::aRealMPITopology2d::x1

real_type x1() const

Return global x1.

Definition: mpi_grid.h:62

dg::aRealMPITopology2d::bcy

bc bcy() const

global y boundary

Definition: mpi_grid.h:132

dg::aRealMPITopology2d::nx

unsigned nx() const

number of polynomial coefficients in x

Definition: mpi_grid.h:106

dg::aRealMPITopology2d::ny

unsigned ny() const

number of polynomial coefficients in y

Definition: mpi_grid.h:108

dg::aRealMPITopology2d::y0

real_type y0() const

Return global y0.

Definition: mpi_grid.h:68

dg::aRealMPITopology2d::Nx

unsigned Nx() const

Return the global number of cells.

Definition: mpi_grid.h:114

dg::aRealMPITopology2d::Ny

unsigned Ny() const

Return the global number of cells.

Definition: mpi_grid.h:120

dg::aRealMPITopology2d::y1

real_type y1() const

Return global y1.

Definition: mpi_grid.h:74

dg::aRealMPITopology2d::x0

real_type x0() const

Return global x0.

Definition: mpi_grid.h:56

dg::aRealMPITopology2d::bcx

bc bcx() const

global x boundary

Definition: mpi_grid.h:126

Parameters

gx	a Grid in x - direction
gy	a Grid in y - direction
comm	a two-dimensional Cartesian communicator

Note: the paramateres given in the constructor are global parameters

◆ aRealMPITopology2d() [2/2]

template<class real_type >

dg::aRealMPITopology2d< real_type >::aRealMPITopology2d ( const aRealMPITopology2d< real_type > & src )

protecteddefault

explicit copy constructor (default)

Parameters

src source

Member Function Documentation

◆ bcx()

template<class real_type >

bc dg::aRealMPITopology2d< real_type >::bcx ( ) const

inline

global x boundary

Returns: boundary condition

◆ bcy()

template<class real_type >

bc dg::aRealMPITopology2d< real_type >::bcy ( ) const

inline

global y boundary

Returns: boundary condition

◆ communicator()

template<class real_type >

MPI_Comm dg::aRealMPITopology2d< real_type >::communicator ( ) const

inline

Return mpi cartesian communicator that is used in this grid.

Returns: Communicator

◆ display()

template<class real_type >

void dg::aRealMPITopology2d< real_type >::display ( std::ostream & os = std::cout ) const

inline

Display global and local grid.

Parameters

os	output stream

◆ dltx()

template<class real_type >

const DLT< real_type > & dg::aRealMPITopology2d< real_type >::dltx ( ) const

inline

discrete legendre transformation in x

◆ dlty()

template<class real_type >

const DLT< real_type > & dg::aRealMPITopology2d< real_type >::dlty ( ) const

inline

discrete legendre transformation in y

◆ do_set()

template<class real_type >

virtual void dg::aRealMPITopology2d< real_type >::do_set	(	unsigned	new_nx,
		unsigned	new_Nx,
		unsigned	new_ny,
		unsigned	new_Ny
	)

protectedpure virtual

This function has an implementation.

◆ global()

template<class real_type >

const RealGrid2d< real_type > & dg::aRealMPITopology2d< real_type >::global ( ) const

inline

Return the global non-MPI grid.

The global grid contains the global boundaries and cell numbers. This is the grid that we would have to use in a non-MPI implementation. The global grid returns the same values for x0(), x1(), ..., Nx(), Ny(), ... as the grid class itself

Returns: non-MPI Grid object

◆ global2localIdx()

template<class real_type >

bool dg::aRealMPITopology2d< real_type >::global2localIdx	(	int	globalIdx,
		int &	localIdx,
		int &	PID
	)		const

inline

Map a global vector index to a local vector Index and the corresponding PID.

Parameters

globalIdx	a global vector Index
localIdx	contains local vector index on output
PID	contains corresponding PID in the communicator on output

Returns: true if successful, false if globalIdx is not part of the grid

◆ hx()

template<class real_type >

real_type dg::aRealMPITopology2d< real_type >::hx ( ) const

inline

Return global hx.

Returns: global grid constant

◆ hy()

template<class real_type >

real_type dg::aRealMPITopology2d< real_type >::hy ( ) const

inline

Return global hy.

Returns: global grid constant

◆ local()

template<class real_type >

const RealGrid2d< real_type > & dg::aRealMPITopology2d< real_type >::local ( ) const

inline

Return a non-MPI grid local for the calling process.

The local grid contains the boundaries and cell numbers the calling process sees and is in charge of.

Returns: Grid object

Note: the boundary conditions in the local grid are not well defined since there might not actually be any boundaries

◆ local2globalIdx()

template<class real_type >

bool dg::aRealMPITopology2d< real_type >::local2globalIdx	(	int	localIdx,
		int	PID,
		int &	globalIdx
	)		const

inline

Map a local index plus the PID to a global vector index.

Parameters

localIdx	a local vector index
PID	a PID in the communicator
globalIdx	the corresponding global vector Index (contains result on output)

Returns: true if successful, false if localIdx or PID is not part of the grid

◆ local_size()

template<class real_type >

unsigned dg::aRealMPITopology2d< real_type >::local_size ( ) const

inline

The total local number of points.

Returns: equivalent to local.size()

◆ lx()

template<class real_type >

real_type dg::aRealMPITopology2d< real_type >::lx ( ) const

inline

Return global lx.

Returns: global length

◆ ly()

template<class real_type >

real_type dg::aRealMPITopology2d< real_type >::ly ( ) const

inline

Return global ly.

Returns: global length

◆ multiplyCellNumbers()

template<class real_type >

void dg::aRealMPITopology2d< real_type >::multiplyCellNumbers	(	real_type	fx,
		real_type	fy
	)

inline

Multiply the number of cells with a given factor.

With this function you can resize the grid ignorantly of its current size

Parameters

fx	new global number of cells is fx*global().Nx()
fy	new global number of cells is fy*global().Ny()

◆ n()

template<class real_type >

unsigned dg::aRealMPITopology2d< real_type >::n ( ) const

inline

Return n.

Returns: number of polynomial coefficients

◆ nx()

template<class real_type >

unsigned dg::aRealMPITopology2d< real_type >::nx ( ) const

inline

number of polynomial coefficients in x

◆ Nx()

template<class real_type >

unsigned dg::aRealMPITopology2d< real_type >::Nx ( ) const

inline

Return the global number of cells.

Returns: number of cells

◆ ny()

template<class real_type >

unsigned dg::aRealMPITopology2d< real_type >::ny ( ) const

inline

number of polynomial coefficients in y

◆ Ny()

template<class real_type >

unsigned dg::aRealMPITopology2d< real_type >::Ny ( ) const

inline

Return the global number of cells.

Returns: number of cells

◆ operator=()

template<class real_type >

aRealMPITopology2d & dg::aRealMPITopology2d< real_type >::operator= ( const aRealMPITopology2d< real_type > & src )

protecteddefault

explicit assignment operator (default)

Parameters

src source

◆ pidOf()

template<class real_type >

int dg::aRealMPITopology2d< real_type >::pidOf	(	real_type	x,
		real_type	y
	)		const

Returns the pid of the process that holds the local grid surrounding the given point.

Parameters

x	X-coord
y	Y-coord

Returns: pid of a process, or -1 if non of the grids matches

◆ set() [1/2]

template<class real_type >

void dg::aRealMPITopology2d< real_type >::set	(	unsigned	new_n,
		unsigned	new_Nx,
		unsigned	new_Ny
	)

inline

Set the number of polynomials and cells.

Same as set(new_n,new_Nx,new_n,new_Ny)

Parameters

new_n	new number of Gaussian nodes for both x and y
new_Nx	new number of cells in x
new_Ny	new number of cells in y

◆ set() [2/2]

template<class real_type >

void dg::aRealMPITopology2d< real_type >::set	(	unsigned	new_nx,
		unsigned	new_Nx,
		unsigned	new_ny,
		unsigned	new_Ny
	)

inline

Set the number of polynomials and cells.

Parameters

new_nx	new number of Gaussian nodes in x
new_Nx	new number of cells in x
new_ny	new number of Gaussian nodes in y
new_Ny	new number of cells in y

◆ size()

template<class real_type >

unsigned dg::aRealMPITopology2d< real_type >::size ( ) const

inline

The total global number of points.

Returns: equivalent to nx()*ny()*Nx()*Ny()

◆ x0()

template<class real_type >

real_type dg::aRealMPITopology2d< real_type >::x0 ( ) const

inline

Return global x0.

Returns: global left boundary

◆ x1()

template<class real_type >

real_type dg::aRealMPITopology2d< real_type >::x1 ( ) const

inline

Return global x1.

Returns: global right boundary

◆ y0()

template<class real_type >

real_type dg::aRealMPITopology2d< real_type >::y0 ( ) const

inline

Return global y0.

Returns: global left boundary

◆ y1()

template<class real_type >

real_type dg::aRealMPITopology2d< real_type >::y1 ( ) const

inline

Return global y1.

Returns: global right boundary

The documentation for this struct was generated from the following file:

topology/mpi_grid.h

Public Types

Public Member Functions

Protected Member Functions

Detailed Description

Member Typedef Documentation

◆ host_grid

◆ host_vector

◆ value_type

Constructor & Destructor Documentation

◆ ~aRealMPITopology2d()

◆ aRealMPITopology2d() [1/2]

◆ aRealMPITopology2d() [2/2]

Member Function Documentation

◆ bcx()

◆ bcy()

◆ communicator()

◆ display()

◆ dltx()

◆ dlty()

◆ do_set()

◆ global()

◆ global2localIdx()

◆ hx()

◆ hy()

◆ local()

◆ local2globalIdx()

◆ local_size()

◆ lx()

◆ ly()

◆ multiplyCellNumbers()

◆ n()

◆ nx()

◆ Nx()

◆ ny()

◆ Ny()

◆ operator=()

◆ pidOf()

◆ set() [1/2]

◆ set() [2/2]

◆ size()

◆ x0()

◆ x1()

◆ y0()

◆ y1()