class XMLReader: A class for reading Epetra objects stored in XML files. More...

#include <EpetraExt_XMLReader.h>

Private Attributes
bool	IsOpen_
	If `true`, then the file has been successfully opened. More...

const Epetra_Comm &	Comm_
	Communicator object. More...

Teuchos::RCP< Teuchos::XMLObject >	fileXML_
	parsed XML object. More...

	XMLReader (const Epetra_Comm &Comm, const std::string &FileName)
	ctor More...

	~XMLReader ()
	dtor More...

void	Read (const std::string &Label, Epetra_Map *&Map)
	Reads the Epetra_Map stored with label `Label`. More...

void	Read64 (const std::string &Label, Epetra_Map *&Map)
	Reads the Epetra_Map stored with label `Label`. Long Long version. More...

void	Read (const std::string &Label, Epetra_CrsGraph *&Graph)
	Reads the Epetra_CrsGraph stored with label `Label`. More...

void	Read64 (const std::string &Label, Epetra_CrsGraph *&Graph)
	Reads the Epetra_CrsGraph stored with label `Label`. Long Long version. More...

void	Read (const std::string &Label, Epetra_CrsMatrix *&Matrix)
	Reads the Epetra_CrsMatrix stored with label `Label`. More...

void	Read64 (const std::string &Label, Epetra_CrsMatrix *&Matrix)
	Reads the Epetra_CrsMatrix stored with label `Label`. Long Long version. More...

void	Read (const std::string &Label, Epetra_MultiVector *&MultiVector)
	Reads the Epetra_MultiVector stored with label `Label`. More...

void	Read64 (const std::string &Label, Epetra_MultiVector *&MultiVector)
	Reads the Epetra_MultiVector stored with label `Label`. Long Long version. More...

void	Read (const std::string &Label, std::vector< std::string > &Content)
	Reads a std::vector of strings with label `Label`. More...

void	Read (const std::string &Label, Teuchos::ParameterList &List)
	Reads the Teuchos::ParameterList stored with label `Label`. More...

Detailed Description

class XMLReader: A class for reading Epetra objects stored in XML files.

Class EpetraExt::XMLReader allows to read several Trilinos objects stored in XML files. The XML data format is specified in the documentation of class EpetraExt::XMLWriter, which also contains a MATLAB script. A typical usage of this class is reported in file epetraext/example/inout/XML_IO.cpp.

This class requires Teuchos to be configured with the option –enable-teuchos-expat.

Reading objects from a file requires the following steps. First, we define an XMLReader object,

EpetraExt::XMLReader XMLReader(Comm, "data.xml");

Then, we define a set of pointers,

Epetra_Map* MyMap;
Epetra_CrsMatrix* MyMatrix;
Epetra_MultiVector* MyLHS;
Epetra_MultiVector* MyRHS;
Teuchos::ParameterList MyParameters;
std::vector<std::string> Author;
std::vector<std::string> Date;
std::vector<std::string> MyContent;

Reading simply goes as follows:

XMLReader.Read("Author", Author);
XMLReader.Read("Date", Date);
XMLReader.Read("MyMap", MyMap);
XMLReader.Read("MyMatrix", MyMatrix);
XMLReader.Read("MyLHS", MyLHS);
XMLReader.Read("MyRHS", MyRHS);
XMLReader.Read("MyContent", MyContent);
XMLReader.Read("MyParameters", MyParameters);

In distributed environments, Epetra_MultiVector, Epetra_CrsGraph and Epetra_CrsMatrix objects have a linear distribution. Epetra_Map objects can be read only when using the same number of processors used for writing.

Warning: All the created objects must be deleted from the user using delete.

Author: Marzio Sala, D-INFK/ETHZ

Date: Last updated on 10-May-06.

Definition at line 119 of file EpetraExt_XMLReader.h.

Constructor & Destructor Documentation

EpetraExt::XMLReader::XMLReader	(	const Epetra_Comm &	Comm,
		const std::string &	FileName
	)

ctor

Definition at line 96 of file EpetraExt_XMLReader.cpp.

EpetraExt::XMLReader::~XMLReader ( )

inline

dtor

Definition at line 127 of file EpetraExt_XMLReader.h.

Member Function Documentation

void EpetraExt::XMLReader::Read	(	const std::string &	Label,
		Epetra_Map *&	Map
	)

Reads the Epetra_Map stored with label Label.

Definition at line 463 of file EpetraExt_XMLReader.cpp.

void EpetraExt::XMLReader::Read64	(	const std::string &	Label,
		Epetra_Map *&	Map
	)

Reads the Epetra_Map stored with label Label. Long Long version.

Definition at line 531 of file EpetraExt_XMLReader.cpp.

void EpetraExt::XMLReader::Read	(	const std::string &	Label,
		Epetra_CrsGraph *&	Graph
	)

Reads the Epetra_CrsGraph stored with label Label.

Definition at line 114 of file EpetraExt_XMLReader.cpp.

void EpetraExt::XMLReader::Read64	(	const std::string &	Label,
		Epetra_CrsGraph *&	Graph
	)

Reads the Epetra_CrsGraph stored with label Label. Long Long version.

Definition at line 163 of file EpetraExt_XMLReader.cpp.

void EpetraExt::XMLReader::Read	(	const std::string &	Label,
		Epetra_CrsMatrix *&	Matrix
	)

Reads the Epetra_CrsMatrix stored with label Label.

Definition at line 227 of file EpetraExt_XMLReader.cpp.

void EpetraExt::XMLReader::Read64	(	const std::string &	Label,
		Epetra_CrsMatrix *&	Matrix
	)

Reads the Epetra_CrsMatrix stored with label Label. Long Long version.

Definition at line 279 of file EpetraExt_XMLReader.cpp.

void EpetraExt::XMLReader::Read	(	const std::string &	Label,
		Epetra_MultiVector *&	MultiVector
	)

Reads the Epetra_MultiVector stored with label Label.

Definition at line 345 of file EpetraExt_XMLReader.cpp.

void EpetraExt::XMLReader::Read64	(	const std::string &	Label,
		Epetra_MultiVector *&	MultiVector
	)

Reads the Epetra_MultiVector stored with label Label. Long Long version.

Definition at line 404 of file EpetraExt_XMLReader.cpp.

void EpetraExt::XMLReader::Read	(	const std::string &	Label,
		std::vector< std::string > &	Content
	)

Reads a std::vector of strings with label Label.

Definition at line 610 of file EpetraExt_XMLReader.cpp.

void EpetraExt::XMLReader::Read	(	const std::string &	Label,
		Teuchos::ParameterList &	List
	)

Reads the Teuchos::ParameterList stored with label Label.

Definition at line 637 of file EpetraExt_XMLReader.cpp.

Member Data Documentation

bool EpetraExt::XMLReader::IsOpen_

private

If true, then the file has been successfully opened.

Definition at line 181 of file EpetraExt_XMLReader.h.

const Epetra_Comm& EpetraExt::XMLReader::Comm_

private

Communicator object.

Definition at line 183 of file EpetraExt_XMLReader.h.

Teuchos::RCP<Teuchos::XMLObject> EpetraExt::XMLReader::fileXML_

private

parsed XML object.

Definition at line 185 of file EpetraExt_XMLReader.h.

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

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation