An implementation of the LevelScheduler interface that operates on and Epetra_CrsGraph, representing the non-zeros in a matrix. More...

#include <Isorropia_EpetraLevelScheduler.hpp>

Inheritance diagram for Isorropia::Epetra::LevelScheduler:

[legend]

Collaboration diagram for Isorropia::Epetra::LevelScheduler:

[legend]

List of all members.

Public Member Functions
	LevelScheduler (Teuchos::RCP< const Epetra_CrsGraph > input_graph, const Teuchos::ParameterList &paramlist=Teuchos::ParameterList("EmptyParameterList"), bool compute_now=true)
	Constructor.
	~LevelScheduler ()
	Destructor.
void	schedule (bool force_scheduling=false)
	Compute the scheduling if it has not already been computed, same effect as Isorropia::Epetra::LevelScheduler::compute.
void	compute (bool force_compute=false)
	Compute the scheduling if it has not already been computed, same effect as Isorropia::Epetra::LevelScheduler::schedule.
virtual int	numLevels () const
	Method which returns the number of levels.
virtual int	numElemsWithLevel (int level) const
	Return the number of elements in a given level.
virtual void	elemsWithLevel (int level, int *elementList, int len) const
	Fill user-allocated list (of length len) with the local ID for each element in the given level.
virtual void	setParameters (const Teuchos::ParameterList &paramlist)=0
	Set parameters for the Operator instance.
void	setParameters (const Teuchos::ParameterList &paramlist)
	setParameters() is an internal method which handles the parameters from a Teuchos::ParameterList object.
Teuchos::RCP < Isorropia::Epetra::CostDescriber > &	getCosts ()
	Get the cost object.
bool	alreadyComputed () const
	Query whether compute_operation() has already been called.
int	numProperties () const
	Return the number of different values used for "properties".
int	numLocalProperties () const
	Return the number of different values used for "properties" for this process only.
virtual const int &	operator[] (int myElem) const
	Return the new partition ID for a given element that resided locally in the old operation.
virtual int	numElemsWithProperty (int property) const
	Return the number of elements in a given partition.
virtual void	elemsWithProperty (int property, int *elementList, int len) const
	Fill user-allocated list (of length len) with the global element ids to be located in the given partition.
virtual int	extractPropertiesCopy (int len, int &size, int *array) const
	Copy a part of the property array.
virtual int	extractPropertiesView (int &size, const int *&array) const
	Give access of the property array that is owned by the current processor.

virtual bool	alreadyComputed () const =0
	Query whether the computation has already been called.
virtual int	numProperties () const =0
	Return the number of different values used for "properties".
virtual int	numLocalProperties () const =0
	Return the number of different values used for "properties" for this process only.
virtual const int &	operator[] (int myElem) const =0
	Return the "property" for a given element that resided locally.
virtual int	numElemsWithProperty (int property) const =0
	Return the number of LOCAL elements with the given property.
virtual void	elemsWithProperty (int property, int *elementList, int len) const =0
	Fill user-allocated list (of length len) with the local element ids of the LOCAL elements with the given property.
virtual int	extractPropertiesView (int &size, const int *&array) const =0
	Give access of the property array that is owned by the current processor.
virtual int	extractPropertiesCopy (int len, int &size, int *array) const =0
	Copy a part of the property array.
Protected Member Functions
void	computeNumberOfProperties ()
Protected Attributes
Teuchos::RCP< const Epetra_BlockMap >	input_map_
Teuchos::RCP< const Epetra_CrsGraph >	input_graph_
Teuchos::RCP< const Epetra_RowMatrix >	input_matrix_
Teuchos::RCP< const Epetra_MultiVector >	input_coords_
Teuchos::RCP < Isorropia::Epetra::CostDescriber >	costs_
Teuchos::RCP< const Epetra_MultiVector >	weights_
Teuchos::ParameterList	paramlist_
int	exportsSize_
std::vector< int >	imports_
std::vector< int >	properties_
bool	operation_already_computed_
int	global_num_vertex_weights_
int	global_num_graph_edge_weights_
int	global_num_hg_edge_weights_
Teuchos::RCP< Library >	lib_
int	base_

Detailed Description

An implementation of the LevelScheduler interface that operates on and Epetra_CrsGraph, representing the non-zeros in a matrix.

The elements to be partitioned into levels are matrix rows. Assumption is that matrix is lower triangular or upper triangular.

Constructor & Destructor Documentation

Isorropia::Epetra::LevelScheduler::LevelScheduler	(	Teuchos::RCP< const Epetra_CrsGraph >	input_graph,
		const Teuchos::ParameterList &	paramlist = `Teuchos::ParameterList("EmptyParameterList")`,
		bool	compute_now = `true`
	)

Constructor.

Parameters:

[in]	input_graph	the graph representing the non-zeros of the matrix
[in]	paramlist	list of parameters
[in]	compute_now	if `true`, the scheduling is computed in the constructor, otherwise call Isorropia::Epetra::LevelScheduler::schedule when you want to compute the scheduling, defaults to `false`

Isorropia::Epetra::LevelScheduler::~LevelScheduler ( ) [virtual]

Destructor.

Reimplemented from Isorropia::LevelScheduler.

Member Function Documentation

void Isorropia::Epetra::LevelScheduler::schedule ( bool force_scheduling = false ) [virtual]

Compute the scheduling if it has not already been computed, same effect as Isorropia::Epetra::LevelScheduler::compute.

Parameters:

[in] force_scheduling if true recompute the scheduling even if it has already been computed, defaults to false

Implements Isorropia::LevelScheduler.

void Isorropia::Epetra::LevelScheduler::compute ( bool force_compute = false ) [inline, virtual]

Compute the scheduling if it has not already been computed, same effect as Isorropia::Epetra::LevelScheduler::schedule.

Parameters:

[in] force_compute if true recompute the scheduling even if it has already been computed, defaults to false

Implements Isorropia::Epetra::Operator.

virtual int Isorropia::LevelScheduler::numLevels ( ) const [inline, virtual, inherited]

Method which returns the number of levels.

Returns:: The number of levels on the local process. Levels begin at 1 and increase by 1.

See also:: Isorropia::Operator::numProperties()

virtual int Isorropia::LevelScheduler::numElemsWithLevel ( int level ) const [inline, virtual, inherited]

Return the number of elements in a given level.

Parameters:

level The wanted level.

Returns:: The number of elements in the level.

See also:: Isorropia::Operator::numElemsWithProperty()

virtual void Isorropia::LevelScheduler::elemsWithLevel	(	int	level,
		int *	elementList,
		int	len
	)		const `[inline, virtual, inherited]`

Fill user-allocated list (of length len) with the local ID for each element in the given level.

Parameters:

level	the wanted level
elementList	an array to receive local elements of the given level
len	the number of elements wanted

See also:: Isorropia::Operator::elemsWithProperty()

virtual void Isorropia::Operator::setParameters ( const Teuchos::ParameterList & paramlist ) [pure virtual, inherited]

Set parameters for the Operator instance.

The contents of the input paramlist object are copied into an internal ParameterList attribute. Instances of this interface should not retain a reference to the input ParameterList after this method returns.

Parameters:

[in] paramlist List of parameters that the user wants to use.

Implemented in Isorropia::Epetra::Operator.

virtual bool Isorropia::Operator::alreadyComputed ( ) const [pure virtual, inherited]

Query whether the computation has already been called.

Returns:: True if the computation has already been done, False otherwise.

Implemented in Isorropia::Epetra::Operator.

virtual int Isorropia::Operator::numProperties ( ) const [pure virtual, inherited]

Return the number of different values used for "properties".

For example, the number of colors or the number of parts used for the overall graph/matrix.

Returns:: Global number of values for properties

Remarks:: Infact, it returns the upper bound of the interval of taken values. For example, for the colors "1,2,4" , it will return "4"

Implemented in Isorropia::Epetra::Operator.

virtual int Isorropia::Operator::numLocalProperties ( ) const [pure virtual, inherited]

Return the number of different values used for "properties" for this process only.

Returns:: Local number of values for properties

Implemented in Isorropia::Epetra::Operator.

virtual const int& Isorropia::Operator::operator[] ( int myElem ) const [pure virtual, inherited]

Return the "property" for a given element that resided locally.

Parameters:

[in] myElem the local ID of the element we want to know the property.

Returns:: property associated to the local element.

Implemented in Isorropia::Epetra::Operator.

virtual int Isorropia::Operator::numElemsWithProperty ( int property ) const [pure virtual, inherited]

Return the number of LOCAL elements with the given property.

Parameters:

[in] property Value of the property to consider.

Returns:: Number of local elems which have this property.

Implemented in Isorropia::Epetra::Operator.

virtual void Isorropia::Operator::elemsWithProperty	(	int	property,
		int *	elementList,
		int	len
	)		const `[pure virtual, inherited]`

Fill user-allocated list (of length len) with the local element ids of the LOCAL elements with the given property.

Parameters:

[in]	property	Value of the property to consider.
[out]	elementList	User allocated array (of size at least `len`) of local ID that have the asked property.
[in]	len	Maximum lenght for the array. If `len` is greater than the result of numElemsWithProperty() for `property`, only the first and relevant elements are filled.

Remarks:: Memory space which is not useful in the array is not initialized or used in this method.

Implemented in Isorropia::Epetra::Operator.

virtual int Isorropia::Operator::extractPropertiesView	(	int &	size,
		const int *&	array
	)		const `[pure virtual, inherited]`

Give access of the property array that is owned by the current processor.

Parameters:

[out]	size	Number of elements in the array.
[out]	array	Pointer to the the properties array inside the object.

Remarks:: This pointer is only significant if the object still exists. Otherwise, you must use

See also:: Isorropia::Operator::extractPropertiesCopy().; Isorropia::Operator::extractPropertiesCopy()

Implemented in Isorropia::Epetra::Operator.

virtual int Isorropia::Operator::extractPropertiesCopy	(	int	len,
		int &	size,
		int *	array
	)		const `[pure virtual, inherited]`

Copy a part of the property array.

Parameters:

[in]	len	of the array given by the user.
[out]	size	Number of elements in the array.
[out]	array	Array of properties. Allocated by the user with a size of at least `len` elements.

Remarks:: Memory space which is not useful in the array is not initialized or used in this method.

See also:: Isorropia::Operator::extractPropertiesView()

Implemented in Isorropia::Epetra::Operator.

void Isorropia::Epetra::Operator::setParameters ( const Teuchos::ParameterList & paramlist ) [virtual, inherited]

setParameters() is an internal method which handles the parameters from a Teuchos::ParameterList object.

Implements Isorropia::Operator.

Teuchos::RCP<Isorropia::Epetra::CostDescriber>& Isorropia::Epetra::Operator::getCosts ( ) [inline, inherited]

Get the cost object.

bool Isorropia::Epetra::Operator::alreadyComputed ( ) const [inline, virtual, inherited]

Query whether compute_operation() has already been called.

Implements Isorropia::Operator.

int Isorropia::Epetra::Operator::numProperties ( ) const [inline, virtual, inherited]

Return the number of different values used for "properties".

For example, the number of colors or the number of parts used for the overall graph/matrix.

Returns:: Global number of values for properties

Remarks:: Infact, it returns the upper bound of the interval of taken values. For example, for the colors "1,2,4" , it will return "4"

Implements Isorropia::Operator.

int Isorropia::Epetra::Operator::numLocalProperties ( ) const [inline, virtual, inherited]

Return the number of different values used for "properties" for this process only.

Returns:: Local number of values for properties

Implements Isorropia::Operator.

virtual const int& Isorropia::Epetra::Operator::operator[] ( int myElem ) const [virtual, inherited]

Return the new partition ID for a given element that resided locally in the old operation.

Implements Isorropia::Operator.

virtual int Isorropia::Epetra::Operator::numElemsWithProperty ( int property ) const [virtual, inherited]

Return the number of elements in a given partition.

Implements Isorropia::Operator.

virtual void Isorropia::Epetra::Operator::elemsWithProperty	(	int	property,
		int *	elementList,
		int	len
	)		const `[virtual, inherited]`

Fill user-allocated list (of length len) with the global element ids to be located in the given partition.

Implements Isorropia::Operator.

virtual int Isorropia::Epetra::Operator::extractPropertiesCopy	(	int	len,
		int &	size,
		int *	array
	)		const `[virtual, inherited]`

Copy a part of the property array.

Parameters:

[in]	len	of the array given by the user.
[out]	size	Number of elements in the array.
[out]	array	Array of properties. Allocated by the user with a size of at least `len` elements.

Remarks:: Memory space which is not useful in the array is not initialized or used in this method.

See also:: Isorropia::Operator::extractPropertiesView()

Implements Isorropia::Operator.

virtual int Isorropia::Epetra::Operator::extractPropertiesView	(	int &	size,
		const int *&	array
	)		const `[virtual, inherited]`

Give access of the property array that is owned by the current processor.

Parameters:

[out]	size	Number of elements in the array.
[out]	array	Pointer to the the properties array inside the object.

Remarks:: This pointer is only significant if the object still exists. Otherwise, you must use

See also:: Isorropia::Operator::extractPropertiesCopy().; Isorropia::Operator::extractPropertiesCopy()

Implements Isorropia::Operator.

void Isorropia::Epetra::Operator::computeNumberOfProperties ( ) [protected, inherited]

Member Data Documentation

Teuchos::RCP<const Epetra_BlockMap> Isorropia::Epetra::Operator::input_map_ [protected, inherited]

Teuchos::RCP<const Epetra_CrsGraph> Isorropia::Epetra::Operator::input_graph_ [protected, inherited]

Teuchos::RCP<const Epetra_RowMatrix> Isorropia::Epetra::Operator::input_matrix_ [protected, inherited]

Teuchos::RCP<const Epetra_MultiVector> Isorropia::Epetra::Operator::input_coords_ [protected, inherited]

Teuchos::RCP<Isorropia::Epetra::CostDescriber> Isorropia::Epetra::Operator::costs_ [protected, inherited]

Teuchos::RCP<const Epetra_MultiVector> Isorropia::Epetra::Operator::weights_ [protected, inherited]

Teuchos::ParameterList Isorropia::Epetra::Operator::paramlist_ [protected, inherited]

int Isorropia::Epetra::Operator::exportsSize_ [protected, inherited]

std::vector<int> Isorropia::Epetra::Operator::imports_ [protected, inherited]

std::vector<int> Isorropia::Epetra::Operator::properties_ [protected, inherited]

bool Isorropia::Epetra::Operator::operation_already_computed_ [protected, inherited]

int Isorropia::Epetra::Operator::global_num_vertex_weights_ [protected, inherited]

int Isorropia::Epetra::Operator::global_num_graph_edge_weights_ [protected, inherited]

int Isorropia::Epetra::Operator::global_num_hg_edge_weights_ [protected, inherited]

Teuchos::RCP<Library> Isorropia::Epetra::Operator::lib_ [protected, inherited]

int Isorropia::Epetra::Operator::base_ [protected, inherited]

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

Isorropia_EpetraLevelScheduler.hpp

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation