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

#include <EpetraExt_XMLReader.h>

	XMLReader (const Epetra_Comm &Comm, const std::string &FileName)
	ctor
	~XMLReader ()
	dtor
void	Read (const std::string &Label, Epetra_Map *&Map)
	Reads the Epetra_Map stored with label `Label`.
void	Read64 (const std::string &Label, Epetra_Map *&Map)
	Reads the Epetra_Map stored with label `Label`. Long Long version.
void	Read (const std::string &Label, Epetra_CrsGraph *&Graph)
	Reads the Epetra_CrsGraph stored with label `Label`.
void	Read64 (const std::string &Label, Epetra_CrsGraph *&Graph)
	Reads the Epetra_CrsGraph stored with label `Label`. Long Long version.
void	Read (const std::string &Label, Epetra_CrsMatrix *&Matrix)
	Reads the Epetra_CrsMatrix stored with label `Label`.
void	Read64 (const std::string &Label, Epetra_CrsMatrix *&Matrix)
	Reads the Epetra_CrsMatrix stored with label `Label`. Long Long version.
void	Read (const std::string &Label, Epetra_MultiVector *&MultiVector)
	Reads the Epetra_MultiVector stored with label `Label`.
void	Read64 (const std::string &Label, Epetra_MultiVector *&MultiVector)
	Reads the Epetra_MultiVector stored with label `Label`. Long Long version.
void	Read (const std::string &Label, std::vector< std::string > &Content)
	Reads a std::vector of strings with label `Label`.
void	Read (const std::string &Label, Teuchos::ParameterList &List)
	Reads the Teuchos::ParameterList stored with label `Label`.

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 112 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 120 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 462 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 530 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 113 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 162 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 226 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 278 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 344 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 403 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 609 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 636 of file EpetraExt_XMLReader.cpp.

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