QUESO::BaseEnvironment Class Reference

This (virtual) class sets up the environment underlying the use of the QUESO library by an executable. More...

#include <Environment.h>

Inheritance diagram for QUESO::BaseEnvironment:

Collaboration diagram for QUESO::BaseEnvironment:

Public Member Functions
Constructor/Destructor methods
	BaseEnvironment (const char *passedOptionsInputFileName, const EnvOptionsValues *alternativeOptionsValues)
	Default constructor. More...
	BaseEnvironment (const BaseEnvironment &obj)
	Copy constructor. It should not be used be the user. More...
virtual	~BaseEnvironment ()
	Destructor. More...
Set methods
BaseEnvironment &	operator= (const BaseEnvironment &rhs)
	Assignment operator. It should not be used be the user. More...
Environment, Communicator and Options Input File methods
bool	fullEnvIsReady () const
	Returns whether the full environment class is ready (constructor has successfully been called). More...
int	worldRank () const
	Returns the process world rank. More...
int	fullRank () const
	Returns the process full rank. More...
const MpiComm &	fullComm () const
	Access function for MpiComm full communicator. More...
RawType_MPI_Group	subGroup () const
	Access function for sub-group. More...
int	subRank () const
	Access function for sub-rank. More...
const MpiComm &	subComm () const
	Access function for MpiComm sub communicator. More...
const MpiComm &	selfComm () const
	Access function for MpiComm self-communicator. More...
int	inter0Rank () const
	Returns the process inter0 rank. More...
const MpiComm &	inter0Comm () const
	Access function for MpiComm inter0-communicator. More...
std::ofstream *	subDisplayFile () const
	Access function for m_subDisplayFile (displays file on stream). More...
std::string	subDisplayFileName () const
	Access function for m_subDisplayFileName (displays filename on stream). More...
unsigned int	numSubEnvironments () const
	Access function to the number of sub-environments. More...
unsigned int	subId () const
	Access function to the number of each sub-environment Id: m_subId. More...
const std::string &	subIdString () const
	Access to the attribute m_subIdString; which stores the string for the sub-environment, and it will be used, for instance, to create the output files for each sub-environment. More...
void	checkTheParallelEnvironment () const
std::string	optionsInputFileName () const
	Access to the attribute m_optionsInputFileName, which stores the name of the input file passed by the user to QUESO. More...
void	setOptionsInputFileAccessState (bool newState) const
po::variables_map &	allOptionsMap () const
void	scanInputFileForMyOptions (const po::options_description &optionsDesc) const
	This method scans the input file provided by the user to QUESO. More...
unsigned int	displayVerbosity () const
unsigned int	syncVerbosity () const
	Access function to private attribute m_syncVerbosity. More...
unsigned int	checkingLevel () const
	Access function to private attribute m_checkingLevel. More...
const RngBase *	rngObject () const
	Access to the RNG object. More...
void	resetSeed (int newSeedOption)
	Reset RNG seed. More...
int	seed () const
	Access to the RNG seed. More...
const BasicPdfsBase *	basicPdfs () const
	Access to Basic PDFs. More...
std::string	platformName () const
	Access to the platform name. More...
std::string	identifyingString () const
	Access function to private attribute m_identifyingString: identifying string. More...
void	resetIdentifyingString (const std::string &newString) const
	Reset private attribute m_identifyingString with the value newString. More...
bool	isThereInputFile () const
	//TODO Not implemented? it is called in examples/validationCycle/tests_old/results_5_25/uqTgaEx4.h. More...
struct timeval	timevalBegin () const
	Used to save the time when the combo `QUESO+user's application' started to run. More...
I/O methods
bool	openOutputFile (const std::string &fileName, const std::string &fileType, const std::set< unsigned int > &allowedSubEnvIds, bool writeOver, FilePtrSetStruct &filePtrSet) const
	Opens an output file for each sub-environment that was chosen to send data to the file. More...
bool	openUnifiedOutputFile (const std::string &fileName, const std::string &fileType, bool writeOver, FilePtrSetStruct &filePtrSet) const
	Opens a unified output file, that will contain data from all sub-environments. More...
bool	openInputFile (const std::string &fileName, const std::string &fileType, const std::set< unsigned int > &allowedSubEnvIds, FilePtrSetStruct &filePtrSet) const
	Opens an input file. More...
bool	openUnifiedInputFile (const std::string &fileName, const std::string &fileType, FilePtrSetStruct &filePtrSet) const
	Opens the unified input file. More...
void	closeFile (FilePtrSetStruct &filePtrSet, const std::string &fileType) const
	Closes the file. More...
void	setExceptionalCircumstance (bool value) const
	Set an exceptional circumstance. More...
bool	exceptionalCircumstance () const
	Decides whether there is an exceptional circumstance. More...
virtual void	print (std::ostream &os) const =0

Protected Attributes
bool	m_fullEnvIsReady
int	m_worldRank
MpiComm *	m_fullComm
int	m_fullRank
int	m_fullCommSize
RawType_MPI_Group	m_fullGroup
std::string	m_optionsInputFileName
bool	m_optionsInputFileAccessState
po::options_description *	m_allOptionsDesc
po::variables_map *	m_allOptionsMap
unsigned int	m_subId
std::string	m_subIdString
RawType_MPI_Group	m_subGroup
MpiComm *	m_subComm
int	m_subRank
int	m_subCommSize
MpiComm *	m_selfComm
RawType_MPI_Group	m_inter0Group
MpiComm *	m_inter0Comm
int	m_inter0Rank
int	m_inter0CommSize
std::ofstream *	m_subDisplayFile
RngBase *	m_rngObject
BasicPdfsBase *	m_basicPdfs
struct timeval	m_timevalBegin
bool	m_exceptionalCircumstance
EnvOptionsValues	m_alternativeOptionsValues
EnvironmentOptions *	m_optionsObj

Detailed Description

This (virtual) class sets up the environment underlying the use of the QUESO library by an executable.

This class sets up the environment underlying the use of the QUESO library by an executable. It:

1. assigns rank numbers, other than the world rank, to nodes participating in a parallel job,
2. provides communicators for generating a sequence of vectors in a distributed way,
3. provides functionality to read options from the 'options input file' (whose name is passed in the constructor of this environment class),

4. opens output files for messages that would otherwise be written to the screen (one output file per allowed rank is opened and allowed ranks can be specified through the 'options input file').

   This class is virtual. It is inherited by 'EmptyEnvironment' and 'FullEnvironment'.
   The QUESO environment class is instantiated at the application level, right after 'MPI_Init(&argc,&argv)'.
   The QUESO environment is required by reference by many constructors in the QUESO library,
   and is available by reference from many classes as well.
   

   ---

   Throughout QUESO, there are five classes whose constructors check options in the 'options input file':
   

   1. BaseEnvironment
   2. StatisticalInverseProblem
   3. StatisticalForwardProblem
   4. MetropolisHastingsSG ('SG' stands for 'sequence generator')
   5. MonteCarloSG

   These classes rely on 'options classes' to read their options from the input file.
   The options classes are, respectively:
   

   1. EnvironmentOptions
   2. StatisticalInverseProblemOptions
   3. StatisticalForwardProblemOptions
   4. MetropolisHastingsSGOptions
   5. MonteCarloSGOptions

   The last two classes also rely on SequenceStatisticalOptions for reading the options specifying which statistics have to be computed on the sequences of vectors

   involved.

   The QUESO environment class manages five types of communicators. Let:
   

   1. 'W >= 1' be the size of whole world communicator involved in a parallel run;
   2. 'N >= 1' be the size of the communicator passed to the QUESO environment constructor;
   3. 'S >= 1' be the number of statistical problems a QUESO environment will be handling at the same time, in parallel.

   Usually 'W'='N', but such equality is not necessary. The number 'S' is equal to the QUESO environment option 'm_numSubEnvironments', and is equal to 1 by default. The number 'N' must be a multiple of 'S', otherwise the QUESO class prints a fatal error message and MPI aborts. The five types of communicators that QUESO manages are referred to as:

   1. world = MPI_WORLD_COMM, of size W;
   2. full = communicator passed to the constructor of BaseEnvironment, of size N and usually equal to the world communicator;
   3. sub = communicator of size N/S that contains the number of MPI nodes necessary to solve a statistical inverse problem or a statistical forward problem.
   4. self = MPI_SELF_COMM, of size 1;
   5. inter0 = communicator of size S formed by all MPI nodes that have 'sub' rank 0 in their respective 'sub' communicators.

   So, any given node has potentially five different ranks. Of course, if the user is solving just one statistical problem with just one MPI node, then all ranks are equal to zero.

   ---

   In the QUESO library terminology, one might refer to a QUESO "full" environment composed of
   

   'S' QUESO "sub" environments. Each sub environment is assigned a "sub" id varying from 0 (zero) to S-1. Each sub environment is able to generate a statistical inverse problem and/or a statistical forward problem. That is, each sub environment is able to handle a "sub" Markov chain (a sequence) of vectors and/or a "sub" Monte Carlo sequence of output vectors. The "sub" sequences can be seen as forming a "unified" sequence in a distributed way. Indeed, the virtual class 'VectorSequence' provides "sub" and "unified" statistical operations.

   A QUESO "sub" environment eventually prints messages to its own output file. In order for that to happen, the requirements are:

   1. option 'm_subDisplayFileName', a string, must be different than the default value ".";
   2. option 'm_subDisplayAllowedSet', a set of sub ids, must contain the id of the sub environment wanting to write a message to the output file;
   3. the previous requirement is automatically satisfied if the option 'm_subDisplayAllowAll', a boolean, is set to 1 (the default value is 0);
   4. the processor wanting to write a message to the output file must have sub rank 0 (zero).

   If all requirements are satisfied, then QUESO will generate a file with name '<m_subDisplayFileName>_sub<sub id>.txt'. For instance, if 'm_subDisplayFileName' is 'pROblem_775_' then a node of sub rank 0 in sub environment 17 will write a message to the file 'pROblem_775_sub17.txt'.

Definition at line 187 of file Environment.h.

Constructor & Destructor Documentation

QUESO::BaseEnvironment::BaseEnvironment	(	const char *	passedOptionsInputFileName,
		const EnvOptionsValues *	alternativeOptionsValues
	)

Default constructor.

Definition at line 130 of file Environment.C.

References m_alternativeOptionsValues, and m_optionsInputFileName.

  :
  m_fullEnvIsReady             (false),
  m_worldRank                  (-1),
  m_fullComm                   (NULL),
  m_fullRank                   (-1),
  m_fullCommSize               (1),
  m_optionsInputFileName       (""),
  m_optionsInputFileAccessState(true),
  m_allOptionsDesc             (NULL),
  m_allOptionsMap              (NULL),
  m_subComm                    (NULL),
  m_subRank                    (-1),
  m_subCommSize                (1),
  m_selfComm                   (NULL),
  m_inter0Comm                 (NULL),
  m_inter0Rank                 (-1),
  m_inter0CommSize             (1),
  m_subDisplayFile             (NULL),
  m_rngObject                  (NULL),
  m_basicPdfs                  (NULL),
  m_exceptionalCircumstance    (false),
  m_alternativeOptionsValues   (),
  m_optionsObj                 (NULL)
{
  if (passedOptionsInputFileName) m_optionsInputFileName     = passedOptionsInputFileName;
  if (alternativeOptionsValues  ) m_alternativeOptionsValues = *alternativeOptionsValues;
}

QUESO::BaseEnvironment::BaseEnvironment

(

const BaseEnvironment &

obj

)

Copy constructor. It should not be used be the user.

Definition at line 161 of file Environment.C.

References UQ_FATAL_TEST_MACRO, QUESO::UQ_INVALID_INTERNAL_STATE_RC, and worldRank().

{
  UQ_FATAL_TEST_MACRO(UQ_INVALID_INTERNAL_STATE_RC,
                      obj.worldRank(),
                      "BaseEnvironment::constructor(), copy",
                      "code should not execute through here");
}

QUESO::BaseEnvironment::~BaseEnvironment ( )

virtual

Destructor.

It deallocates memory and does other cleanup for the class object and its class members when the object is destroyed. It displays the total run time of the combo QUESO + application using the function gettimeofday() from a struct timeval (as specified in <sys/time.h>).

Definition at line 169 of file Environment.C.

References displayVerbosity(), m_allOptionsDesc, m_allOptionsMap, m_basicPdfs, m_fullComm, m_fullRank, m_inter0Comm, m_optionsObj, m_rngObject, m_selfComm, m_subComm, m_subDisplayFile, and m_timevalBegin.

{
  //if (m_subDisplayFile) {
  //  *m_subDisplayFile << "Entering BaseEnvironment::destructor()"
  //                          << std::endl;
  //}

  struct timeval timevalNow;
  /*int iRC = 0;*/
  /*iRC = */gettimeofday(&timevalNow, NULL);

  if( this->displayVerbosity() > 0 )
    {
     if (m_subDisplayFile) {
        *m_subDisplayFile << "Ending run at "    << ctime(&timevalNow.tv_sec)
                          << "Total run time = " << timevalNow.tv_sec - m_timevalBegin.tv_sec
                          << " seconds"
                          << std::endl;
      }

    if (m_fullRank == 0) {
        std::cout << "Ending run at "    << ctime(&timevalNow.tv_sec)
                  << "Total run time = " << timevalNow.tv_sec - m_timevalBegin.tv_sec
                  << " seconds"
                  << std::endl;
      }
    }

  if (m_optionsObj) delete m_optionsObj;
  if (m_allOptionsMap) {
    delete m_allOptionsMap;
    delete m_allOptionsDesc;
  }

  if (m_basicPdfs) delete m_basicPdfs;
  if (m_rngObject) delete m_rngObject;

  //if (m_subDisplayFile) {
  //  *m_subDisplayFile << "Leaving BaseEnvironment::destructor()"
  //                          << std::endl;
  //}

  if (m_subDisplayFile) delete m_subDisplayFile;
  if (m_inter0Comm    ) delete m_inter0Comm;
  if (m_selfComm      ) delete m_selfComm;
  if (m_subComm       ) delete m_subComm;
  if (m_fullComm      ) delete m_fullComm;
}

Member Function Documentation

po::variables_map & QUESO::BaseEnvironment::allOptionsMap

(

)

const

Access function to private attribute m_allOptionsMap. It is an instance of po::variables_map(), which allows concrete variables to map which store variables in real map.

Definition at line 368 of file Environment.C.

References m_allOptionsMap, m_worldRank, and UQ_FATAL_TEST_MACRO.

Referenced by QUESO::InfiniteDimensionalMCMCSamplerOptions::getMyOptionValues(), QUESO::EnvironmentOptions::getMyOptionValues(), QUESO::MLSamplingOptions::getMyOptionValues(), QUESO::StatisticalForwardProblemOptions::getMyOptionValues(), QUESO::StatisticalInverseProblemOptions::getMyOptionValues(), QUESO::MonteCarloSGOptions::getMyOptionValues(), QUESO::MetropolisHastingsSGOptions::getMyOptionValues(), and QUESO::MLSamplingLevelOptions::getMyOptionValues().

{
  UQ_FATAL_TEST_MACRO(m_allOptionsMap == NULL,
                      m_worldRank,
                      "BaseEnvironment::allOptionsMap()",
                      "m_allOptionsMap variable is NULL");
  return *m_allOptionsMap;
}

const BasicPdfsBase * QUESO::BaseEnvironment::basicPdfs

(

)

const

Access to Basic PDFs.

Definition at line 485 of file Environment.C.

References m_basicPdfs.

{
  return m_basicPdfs;
}

unsigned int QUESO::BaseEnvironment::checkingLevel

(

)

const

Access function to private attribute m_checkingLevel.

Definition at line 456 of file Environment.C.

References QUESO::EnvOptionsValues::m_checkingLevel, m_optionsObj, QUESO::EnvironmentOptions::m_ov, m_worldRank, and UQ_FATAL_TEST_MACRO.

Referenced by QUESO::GslMatrix::inverse().

{
  UQ_FATAL_TEST_MACRO(m_optionsObj == NULL,
                      m_worldRank,
                      "BaseEnvironment::checkingLevel()",
                      "m_optionsObj variable is NULL");
  return m_optionsObj->m_ov.m_checkingLevel;
}

void QUESO::BaseEnvironment::checkTheParallelEnvironment

(

)

const

void QUESO::BaseEnvironment::closeFile	(	FilePtrSetStruct &	filePtrSet,
		const std::string &	fileType
	)		const

Closes the file.

Definition at line 1117 of file Environment.C.

References QUESO::FilePtrSetStruct::ifsVar, m_subDisplayFile, m_worldRank, QUESO::FilePtrSetStruct::ofsVar, subDisplayFile(), subRank(), UQ_FATAL_TEST_MACRO, UQ_FILE_EXTENSION_FOR_HDF_FORMAT, and UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT.

Referenced by QUESO::GslVector::subReadContents(), QUESO::GslMatrix::subReadContents(), QUESO::GslVector::subWriteContents(), and QUESO::GslMatrix::subWriteContents().

{
  std::string fileType(inputFileType);
#ifdef QUESO_HAS_HDF5
  // Do nothing
#else
  if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
    if (m_subDisplayFile) {
      *this->subDisplayFile() << "WARNING in BaseEnvironment::closeFile()"
                              << ": file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                              << "' has been requested, but this QUESO library has not been built with 'hdf5'"
                              << ". Code will therefore process the file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                              << "' instead..."
                              << std::endl;
    }
    if (this->subRank() == 0) {
      std::cerr << "WARNING in BaseEnvironment::closeFile()"
                << ": file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                << "' has been requested, but this QUESO library has not been built with 'hdf5'"
                << ". Code will therefore process the file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                << "' instead..."
                << std::endl;
    }
    fileType = UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT;
  }
#endif

  if (fileType == UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT) {
    //filePtrSet.ofsVar->close(); // close() crashes on Mac; need to use delete(); why? prudenci 2010/June
    delete filePtrSet.ofsVar;
    filePtrSet.ofsVar = NULL;

    //filePtrSet.ifsVar->close();
    delete filePtrSet.ifsVar;
    filePtrSet.ifsVar = NULL;
  }
#ifdef QUESO_HAS_HDF5
  else if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
    H5Fclose(filePtrSet.h5Var);
  }
#endif
  else {
    UQ_FATAL_TEST_MACRO(true,
                        m_worldRank,
                        "BaseEnvironment::closeFile()",
                        "invalid file type");
  }

  return;
}

unsigned int QUESO::BaseEnvironment::displayVerbosity

(

)

const

Access function to private attribute m_displayVerbosity. It manages how much information will be release during the use of the QUESO library.

Definition at line 436 of file Environment.C.

References QUESO::EnvOptionsValues::m_displayVerbosity, m_optionsObj, QUESO::EnvironmentOptions::m_ov, m_worldRank, and UQ_FATAL_TEST_MACRO.

Referenced by QUESO::AsciiTable< V, M >::AsciiTable(), QUESO::BaseJointPdf< V, M >::BaseJointPdf(), QUESO::BaseMatrixCovarianceFunction< P_V, P_M, Q_V, Q_M >::BaseMatrixCovarianceFunction(), QUESO::BaseOneDGrid< T >::BaseOneDGrid(), QUESO::BaseScalarCdf< T >::BaseScalarCdf(), QUESO::BaseScalarCovarianceFunction< V, M >::BaseScalarCovarianceFunction(), QUESO::BaseVectorCdf< V, M >::BaseVectorCdf(), QUESO::BaseVectorMdf< V, M >::BaseVectorMdf(), QUESO::BaseVectorRealizer< V, M >::BaseVectorRealizer(), QUESO::BaseVectorRV< V, M >::BaseVectorRV(), QUESO::BetaJointPdf< V, M >::BetaJointPdf(), QUESO::BetaVectorRealizer< V, M >::BetaVectorRealizer(), QUESO::BetaVectorRV< V, M >::BetaVectorRV(), QUESO::ConcatenatedVectorRealizer< V, M >::ConcatenatedVectorRealizer(), QUESO::ConcatenatedVectorRV< V, M >::ConcatenatedVectorRV(), QUESO::GslVector::cwSetBeta(), QUESO::GslMatrix::determinant(), QUESO::ExponentialMatrixCovarianceFunction< P_V, P_M, Q_V, Q_M >::ExponentialMatrixCovarianceFunction(), QUESO::ExponentialScalarCovarianceFunction< V, M >::ExponentialScalarCovarianceFunction(), QUESO::FiniteDistribution::FiniteDistribution(), QUESO::FullEnvironment::FullEnvironment(), QUESO::GammaJointPdf< V, M >::GammaJointPdf(), QUESO::GammaVectorRealizer< V, M >::GammaVectorRealizer(), QUESO::GammaVectorRV< V, M >::GammaVectorRV(), QUESO::GaussianJointPdf< V, M >::GaussianJointPdf(), QUESO::GaussianVectorCdf< V, M >::GaussianVectorCdf(), QUESO::GaussianVectorMdf< V, M >::GaussianVectorMdf(), QUESO::GaussianVectorRealizer< V, M >::GaussianVectorRealizer(), QUESO::GaussianVectorRV< V, M >::GaussianVectorRV(), QUESO::GenericMatrixCovarianceFunction< P_V, P_M, Q_V, Q_M >::GenericMatrixCovarianceFunction(), QUESO::GenericScalarCovarianceFunction< V, M >::GenericScalarCovarianceFunction(), QUESO::GenericVectorRealizer< V, M >::GenericVectorRealizer(), QUESO::GenericVectorRV< V, M >::GenericVectorRV(), QUESO::HessianCovMatricesTKGroup< V, M >::HessianCovMatricesTKGroup(), QUESO::horizontalDistance(), QUESO::GslMatrix::inverse(), QUESO::InverseGammaJointPdf< V, M >::InverseGammaJointPdf(), QUESO::InverseGammaVectorRealizer< V, M >::InverseGammaVectorRealizer(), QUESO::InverseGammaVectorRV< V, M >::InverseGammaVectorRV(), QUESO::GslMatrix::invertMultiply(), QUESO::InvLogitGaussianVectorRV< V, M >::InvLogitGaussianVectorRV(), QUESO::JeffreysJointPdf< V, M >::JeffreysJointPdf(), QUESO::JeffreysVectorRealizer< V, M >::JeffreysVectorRealizer(), QUESO::JeffreysVectorRV< V, M >::JeffreysVectorRV(), QUESO::GslMatrix::lnDeterminant(), QUESO::LogNormalJointPdf< V, M >::LogNormalJointPdf(), QUESO::LogNormalVectorRealizer< V, M >::LogNormalVectorRealizer(), QUESO::LogNormalVectorRV< V, M >::LogNormalVectorRV(), openInputFile(), openOutputFile(), openUnifiedInputFile(), openUnifiedOutputFile(), QUESO::PoweredJointPdf< V, M >::PoweredJointPdf(), QUESO::GslMatrix::rank(), QUESO::SampledScalarCdf< T >::SampledScalarCdf(), QUESO::SampledVectorCdf< V, M >::SampledVectorCdf(), QUESO::SampledVectorMdf< V, M >::SampledVectorMdf(), QUESO::ScaledCovMatrixTKGroup< V, M >::ScaledCovMatrixTKGroup(), QUESO::EnvironmentOptions::scanOptionsValues(), QUESO::SequentialVectorRealizer< V, M >::SequentialVectorRealizer(), QUESO::StdOneDGrid< T >::StdOneDGrid(), QUESO::StdScalarCdf< T >::StdScalarCdf(), QUESO::GslMatrix::svdSolve(), QUESO::TransformedScaledCovMatrixTKGroup< V, M >::TransformedScaledCovMatrixTKGroup(), QUESO::UniformJointPdf< V, M >::UniformJointPdf(), QUESO::UniformOneDGrid< T >::UniformOneDGrid(), QUESO::UniformVectorRealizer< V, M >::UniformVectorRealizer(), QUESO::UniformVectorRV< V, M >::UniformVectorRV(), QUESO::VectorSet< V, M >::VectorSet(), QUESO::VectorSpace< V, M >::VectorSpace(), QUESO::VectorSubset< V, M >::VectorSubset(), QUESO::WignerJointPdf< V, M >::WignerJointPdf(), QUESO::WignerVectorRealizer< V, M >::WignerVectorRealizer(), QUESO::WignerVectorRV< V, M >::WignerVectorRV(), and ~BaseEnvironment().

{
  UQ_FATAL_TEST_MACRO(m_optionsObj == NULL,
                      m_worldRank,
                      "BaseEnvironment::displayVerbosity()",
                      "m_optionsObj variable is NULL");
  return m_optionsObj->m_ov.m_displayVerbosity;
}

bool QUESO::BaseEnvironment::exceptionalCircumstance

(

)

const

Decides whether there is an exceptional circumstance.

Definition at line 1178 of file Environment.C.

References m_exceptionalCircumstance.

{
  return m_exceptionalCircumstance;
}

const MpiComm & QUESO::BaseEnvironment::fullComm

(

)

const

Access function for MpiComm full communicator.

Definition at line 247 of file Environment.C.

References m_fullComm, m_worldRank, and UQ_FATAL_TEST_MACRO.

Referenced by QUESO::EnvironmentOptions::getMyOptionValues(), and QUESO::MiscCheckTheParallelEnvironment().

{
  UQ_FATAL_TEST_MACRO(m_fullComm == NULL,
                      m_worldRank,
                      "BaseEnvironment::fullComm()",
                      "m_fullComm variable is NULL");
  return *m_fullComm;
}

bool QUESO::BaseEnvironment::fullEnvIsReady

(

)

const

Returns whether the full environment class is ready (constructor has successfully been called).

Definition at line 229 of file Environment.C.

References m_fullEnvIsReady.

{
  return m_fullEnvIsReady;
}

int QUESO::BaseEnvironment::fullRank

(

)

const

Returns the process full rank.

Definition at line 241 of file Environment.C.

References m_fullRank.

Referenced by QUESO::GslVector::cwSetBeta(), QUESO::GslMatrix::eigen(), QUESO::GslMatrix::getColumn(), QUESO::EnvironmentOptions::getMyOptionValues(), QUESO::MetropolisHastingsSGOptions::getMyOptionValues(), QUESO::MLSamplingLevelOptions::getMyOptionValues(), QUESO::GslMatrix::getRow(), QUESO::GslMatrix::mpiSum(), QUESO::OptimizerMonitor::print_header(), QUESO::OptimizerMonitor::print_iteration(), QUESO::EnvironmentOptions::scanOptionsValues(), QUESO::GslMatrix::setColumn(), QUESO::GslMatrix::setRow(), QUESO::GslVector::subReadContents(), QUESO::GslMatrix::subReadContents(), and QUESO::MpiComm::syncPrintDebugMsg().

{
  return m_fullRank;
}

std::string QUESO::BaseEnvironment::identifyingString

(

)

const

Access function to private attribute m_identifyingString: identifying string.

Definition at line 497 of file Environment.C.

References QUESO::EnvOptionsValues::m_identifyingString, m_optionsObj, and QUESO::EnvironmentOptions::m_ov.

{
  return m_optionsObj->m_ov.m_identifyingString;
}

const MpiComm & QUESO::BaseEnvironment::inter0Comm

(

)

const

Access function for MpiComm inter0-communicator.

Definition at line 295 of file Environment.C.

References m_inter0Comm, m_worldRank, and UQ_FATAL_TEST_MACRO.

Referenced by QUESO::ComputeCovCorrBetweenScalarSequences(), and QUESO::ComputeCovCorrMatricesBetweenVectorSequences().

{
  UQ_FATAL_TEST_MACRO(m_inter0Comm == NULL,
                      m_worldRank,
                      "BaseEnvironment::inter0Comm()",
                      "m_inter0Comm variable is NULL");
  return *m_inter0Comm;
}

int QUESO::BaseEnvironment::inter0Rank

(

)

const

Returns the process inter0 rank.

Definition at line 289 of file Environment.C.

References m_inter0Rank.

Referenced by QUESO::ComputeCovCorrBetweenScalarSequences(), QUESO::ComputeCovCorrMatricesBetweenVectorSequences(), QUESO::ComputeUnifiedGaussian2dKde(), QUESO::MetropolisHastingsSGOptions::getMyOptionValues(), QUESO::MLSamplingLevelOptions::getMyOptionValues(), and QUESO::MpiComm::syncPrintDebugMsg().

{
  return m_inter0Rank;
}

bool QUESO::BaseEnvironment::isThereInputFile

(

)

const

//TODO Not implemented? it is called in examples/validationCycle/tests_old/results_5_25/uqTgaEx4.h.

unsigned int QUESO::BaseEnvironment::numSubEnvironments

(

)

const

Access function to the number of sub-environments.

Definition at line 319 of file Environment.C.

References QUESO::EnvOptionsValues::m_numSubEnvironments, m_optionsObj, QUESO::EnvironmentOptions::m_ov, m_worldRank, and UQ_FATAL_TEST_MACRO.

Referenced by QUESO::ComputeUnifiedGaussian2dKde(), and QUESO::MiscCheckTheParallelEnvironment().

{
  UQ_FATAL_TEST_MACRO(m_optionsObj == NULL,
                      m_worldRank,
                      "BaseEnvironment::numSubEnvironments()",
                      "m_optionsObj variable is NULL");
  return m_optionsObj->m_ov.m_numSubEnvironments;
}

bool QUESO::BaseEnvironment::openInputFile	(	const std::string &	fileName,
		const std::string &	fileType,
		const std::set< unsigned int > &	allowedSubEnvIds,
		FilePtrSetStruct &	filePtrSet
	)		const

Opens an input file.

Definition at line 913 of file Environment.C.

References QUESO::CheckFilePath(), displayVerbosity(), QUESO::FilePtrSetStruct::ifsVar, m_subDisplayFile, m_worldRank, subDisplayFile(), subRank(), UQ_ENV_FILENAME_FOR_NO_INPUT_FILE, UQ_FATAL_TEST_MACRO, UQ_FILE_EXTENSION_FOR_HDF_FORMAT, UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT, and worldRank().

Referenced by QUESO::GslVector::subReadContents(), and QUESO::GslMatrix::subReadContents().

{
  std::string fileType(inputFileType);
#ifdef QUESO_HAS_HDF5
  // Do nothing
#else
  if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
    if (m_subDisplayFile) {
      *this->subDisplayFile() << "WARNING in BaseEnvironment::openInputFile()"
                              << ": file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                              << "' has been requested, but this QUESO library has not been built with 'hdf5'"
                              << ". Code will therefore process the file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                              << "' instead..."
                              << std::endl;
    }
    if (this->subRank() == 0) {
      std::cerr << "WARNING in BaseEnvironment::openInputFile()"
                << ": file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                << "' has been requested, but this QUESO library has not been built with 'hdf5'"
                << ". Code will therefore process the file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                << "' instead..."
                << std::endl;
    }
    fileType = UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT;
  }
#endif

  bool returnValue = true;
  filePtrSet.ifsVar = NULL;
  if ((baseFileName                         == UQ_ENV_FILENAME_FOR_NO_INPUT_FILE) ||
      (allowedSubEnvIds.find(this->subId()) == allowedSubEnvIds.end()           )) {
    if ((m_subDisplayFile) && (this->displayVerbosity() >= 10)) {
      *this->subDisplayFile() << "In BaseEnvironment::openInputFile()"
                              << ": no input file opened with base name '" << baseFileName << "." << fileType
                              << "'"
                              << std::endl;
    }
    returnValue = false;
  }
  else {
    // Open file
    if ((m_subDisplayFile) && (this->displayVerbosity() >= 10)) {
      *this->subDisplayFile() << "In BaseEnvironment::openInputFile()"
                              << ": opening input file with base name '" << baseFileName << "." << fileType
                              << "'"
                              << std::endl;
    }
    if (this->subRank() == 0) {
      // Verify parent directory exists (for cases when a user
      // specifies a relative path for the desired output file). prudenci 2010/06/26
      // std::cout << "checking " << baseFileName+"."+fileType << std::endl;
      int irtrn = CheckFilePath((baseFileName+"."+fileType).c_str());
      UQ_FATAL_TEST_MACRO(irtrn < 0,
                          m_worldRank,
                          "BaseEnvironment::openInputFile()",
                          "unable to verify input path");

      if (fileType == UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT) {
        filePtrSet.ifsVar = new std::ifstream((baseFileName+"."+fileType).c_str(),
                                              std::ofstream::in);
        if ((filePtrSet.ifsVar == NULL) || (filePtrSet.ifsVar->is_open() == false)) {
          std::cerr << "In BaseEnvironment::openInputFile()"
                    << ": failed to open input file with base name '" << baseFileName << "." << fileType
                    << "'"
                    << std::endl;
        }
        UQ_FATAL_TEST_MACRO((filePtrSet.ifsVar == NULL) || (filePtrSet.ifsVar->is_open() == false),
                            this->worldRank(),
                            "BaseEnvironment::openInputFile()",
                            "file with fileName could not be found");
      }
#ifdef QUESO_HAS_HDF5
      else if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
        filePtrSet.h5Var = H5Fopen((baseFileName+"."+fileType).c_str(),
                                   H5F_ACC_RDONLY,
                                   H5P_DEFAULT);
      }
#endif
      else {
        UQ_FATAL_TEST_MACRO(true,
                            m_worldRank,
                            "BaseEnvironment::openInputFile()",
                            "invalid file type");
      }
    }
    else {
      returnValue = false;
    }
    //this->subComm().Barrier(); // prudenci-2011-01-17
  }

  return returnValue;
}

bool QUESO::BaseEnvironment::openOutputFile	(	const std::string &	fileName,
		const std::string &	fileType,
		const std::set< unsigned int > &	allowedSubEnvIds,
		bool	writeOver,
		FilePtrSetStruct &	filePtrSet
	)		const

Opens an output file for each sub-environment that was chosen to send data to the file.

Definition at line 516 of file Environment.C.

References QUESO::CheckFilePath(), displayVerbosity(), m_subDisplayFile, m_worldRank, QUESO::FilePtrSetStruct::ofsVar, subDisplayFile(), subId(), subIdString(), subRank(), UQ_ENV_FILENAME_FOR_NO_OUTPUT_FILE, UQ_FATAL_TEST_MACRO, UQ_FILE_EXTENSION_FOR_HDF_FORMAT, UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT, and worldRank().

Referenced by QUESO::GslVector::subWriteContents(), and QUESO::GslMatrix::subWriteContents().

{
  std::string fileType(inputFileType);
#ifdef QUESO_HAS_HDF5
  // Do nothing
#else
  if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
    if (m_subDisplayFile) {
      *this->subDisplayFile() << "WARNING in BaseEnvironment::openOutputFile()"
                              << ": file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                              << "' has been requested, but this QUESO library has not been built with 'hdf5'"
                              << ". Code will therefore process the file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                              << "' instead..."
                              << std::endl;
    }
    if (this->subRank() == 0) {
      std::cerr << "WARNING in BaseEnvironment::openOutputFile()"
                << ": file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                << "' has been requested, but this QUESO library has not been built with 'hdf5'"
                << ". Code will therefore process the file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                << "' instead..."
                << std::endl;
    }
    fileType = UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT;
  }
#endif

  bool returnValue = true;
  filePtrSet.ofsVar = NULL;
  if ((baseFileName                         == UQ_ENV_FILENAME_FOR_NO_OUTPUT_FILE) ||
      (allowedSubEnvIds.find(this->subId()) == allowedSubEnvIds.end()            )) {
    if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
      *this->subDisplayFile() << "In BaseEnvironment::openOutputFile()"
                              << ", subId = "     << this->subId()
                              << ": no output file opened with base name '" << baseFileName << "." << fileType
                              << "'"
                              << ", writeOver = " << writeOver
                              << std::endl;
    }
    returnValue = false;
  }
  else {
    // Open file
    if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
      *this->subDisplayFile() << "In BaseEnvironment::openOutputFile()"
                              << ", subId = "     << this->subId()
                              << ": opening output file with base name '" << baseFileName << "." << fileType
                              << "'"
                              << ", writeOver = " << writeOver
                              << std::endl;
    }

    if (this->subRank() == 0) {
#if 0
      std::cout << "In BaseEnvironment::openOutputFile()"
                << ": opening output file with base name '" << baseFileName << "." << fileType
                << "'"
                << ", writeOver = " << writeOver
                << std::endl;
#endif

      // Verify parent directory exists (for cases when a user
      // specifies a relative path for the desired output file).
      // std::cout << "checking " << baseFileName+"_sub"+this->subIdString()+"."+fileType << std::endl;
      if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
        *this->subDisplayFile() << "In BaseEnvironment::openOutputFile()"
                                << ", subId = "     << this->subId()
                                << ", trying to open output file with base name '" << baseFileName << "." << fileType
                                << "'"
                                << ", writeOver = " << writeOver
                                << ": calling CheckFilePath()..." 
                                << std::endl;
      }
      int irtrn = CheckFilePath((baseFileName+"_sub"+this->subIdString()+"."+fileType).c_str());
      if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
        *this->subDisplayFile() << "In BaseEnvironment::openOutputFile()"
                                << ", subId = "     << this->subId()
                                << ", trying to open output file with base name '" << baseFileName << "." << fileType
                                << "'"
                                << ", writeOver = " << writeOver
                                << ": returned from CheckFilePath() with irtrn = " << irtrn
                                << std::endl;
      }
      UQ_FATAL_TEST_MACRO(irtrn < 0,
                          m_worldRank,
                          "BaseEnvironment::openOutputFile()",
                          "unable to verify output path");

      if (writeOver) {
        // Write over an eventual pre-existing file
        if (fileType == UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT) {
          filePtrSet.ofsVar = new std::ofstream((baseFileName+"_sub"+this->subIdString()+"."+fileType).c_str(), 
                                                std::ofstream::out | std::ofstream::trunc);
        }
        else if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
          UQ_FATAL_TEST_MACRO(true,
                              m_worldRank,
                              "BaseEnvironment::openOutputFile(), writeOver=true",
                              "hdf file type not supported yet");
        }
        else {
          UQ_FATAL_TEST_MACRO(true,
                              m_worldRank,
                              "BaseEnvironment::openOutputFile(), writeOver=true",
                              "invalid file type");
        }
        if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
          *this->subDisplayFile() << "In BaseEnvironment::openOutputFile()"
                                  << ": just opened output file with base name '" << baseFileName << "." << fileType
                                  << "'"
                                  << ", writeOver = " << writeOver
                                  << ", options 'out|trunc'"
                                  << ", osfvar = " << filePtrSet.ofsVar
                                  << std::endl;
        }
      }
      else {
        // Write at the end of an eventual pre-existing file
        if (fileType == UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT) {
#if 0
          filePtrSet.ofsVar = new std::ofstream((baseFileName+"_sub"+this->subIdString()+"."+fileType).c_str(), 
                                                std::ofstream::in);
          std::cout << "filePtrSet.ofsVar(1) = " << filePtrSet.ofsVar << std::endl;
          if (filePtrSet.ofsVar) std::cout << "filePtrSet.ofsVar(1)->is_open() = " << filePtrSet.ofsVar->is_open() << std::endl;
          if (filePtrSet.ofsVar) delete filePtrSet.ofsVar;
#endif
          // 'm' and Ranger nodes behave differently on ofstream constructor... prudenci 2010/03/05
          filePtrSet.ofsVar = new std::ofstream((baseFileName+"_sub"+this->subIdString()+"."+fileType).c_str(), 
                                                std::ofstream::out /*| std::ofstream::in*/ | std::ofstream::app);
        }
        else if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
          UQ_FATAL_TEST_MACRO(true,
                              m_worldRank,
                              "BaseEnvironment::openOutputFile(), writeOver=false",
                              "hdf file type not supported yet");
        }
        else {
          UQ_FATAL_TEST_MACRO(true,
                              m_worldRank,
                              "BaseEnvironment::openOutputFile(), writeOver=false",
                              "invalid file type");
        }
        if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
          *this->subDisplayFile() << "In BaseEnvironment::openOutputFile()"
                                  << ": just opened output file with base name '" << baseFileName << "." << fileType
                                  << "'"
                                  << ", writeOver = " << writeOver
                                  << ", options 'out|in|app'"
                                  << ", osfvar = " << filePtrSet.ofsVar
                                  << std::endl;
        }

        if (fileType == UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT) {
          //std::cout << "filePtrSet.ofsVar(2) = " << filePtrSet.ofsVar << std::endl;
          //if (filePtrSet.ofsVar) std::cout << "filePtrSet.ofsVar(2)->is_open() = " << filePtrSet.ofsVar->is_open() << std::endl;
          if ((filePtrSet.ofsVar            == NULL ) ||
              (filePtrSet.ofsVar->is_open() == false)) {
            //std::cout << "Retrying 1..." << std::endl;
            delete filePtrSet.ofsVar;
            filePtrSet.ofsVar = new std::ofstream((baseFileName+"_sub"+this->subIdString()+"."+fileType).c_str(), 
                                                  std::ofstream::out | std::ofstream::trunc);
            if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
              *this->subDisplayFile() << "In BaseEnvironment::openOutputFile()"
                                      << ": just opened output file with base name '" << baseFileName << "." << fileType
                                      << "'"
                                      << ", writeOver = " << writeOver
                                      << ", options 'out|trunc'"
                                      << ", osfvar = " << filePtrSet.ofsVar
                                      << std::endl;
            }
          }
        } // only for matlab formats
      }
      if (filePtrSet.ofsVar != NULL) {
        if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
          *this->subDisplayFile() << "In BaseEnvironment::openOutputFile()"
                                  << ", subId = "     << this->subId()
                                  << ": succeeded on opening output file with base name '" << baseFileName << "." << fileType
                                  << "'"
                                  << ", writeOver = " << writeOver
                                  << std::endl;
        }
      }
      else {
        std::cerr << "In BaseEnvironment::openOutputFile()"
                  << ": failed to open output file with base name '" << baseFileName << "." << fileType
                  << "'"
                  << std::endl;
      }
      UQ_FATAL_TEST_MACRO((filePtrSet.ofsVar && filePtrSet.ofsVar->is_open()) == false,
                          this->worldRank(),
                          "openOutputFile()",
                          "failed to open output file");
    }
    else {
      returnValue = false;
    }
    //this->subComm().Barrier(); // prudenci-2011-01-17
  }

  return returnValue;
}

bool QUESO::BaseEnvironment::openUnifiedInputFile	(	const std::string &	fileName,
		const std::string &	fileType,
		FilePtrSetStruct &	filePtrSet
	)		const

Opens the unified input file.

Definition at line 1016 of file Environment.C.

References QUESO::CheckFilePath(), displayVerbosity(), QUESO::FilePtrSetStruct::ifsVar, m_subDisplayFile, m_worldRank, subDisplayFile(), subRank(), UQ_ENV_FILENAME_FOR_NO_INPUT_FILE, UQ_FATAL_TEST_MACRO, UQ_FILE_EXTENSION_FOR_HDF_FORMAT, UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT, and worldRank().

{
  std::string fileType(inputFileType);
#ifdef QUESO_HAS_HDF5
  // Do nothing
#else
  if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
    if (m_subDisplayFile) {
      *this->subDisplayFile() << "WARNING in BaseEnvironment::openUnifiedInputFile()"
                              << ": file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                              << "' has been requested, but this QUESO library has not been built with 'hdf5'"
                              << ". Code will therefore process the file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                              << "' instead..."
                              << std::endl;
    }
    if (this->subRank() == 0) {
      std::cerr << "WARNING in BaseEnvironment::openUnifiedInputFile()"
                << ": file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                << "' has been requested, but this QUESO library has not been built with 'hdf5'"
                << ". Code will therefore process the file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                << "' instead..."
                << std::endl;
    }
    fileType = UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT;
  }
#endif

  bool returnValue = true;
  filePtrSet.ifsVar = NULL;
  if (baseFileName == UQ_ENV_FILENAME_FOR_NO_INPUT_FILE) {
    if ((m_subDisplayFile) && (this->displayVerbosity() >= 10)) {
      *this->subDisplayFile() << "In BaseEnvironment::openUnifiedInputFile()"
                              << ": no input file opened with base name '" << baseFileName << "." << fileType
                              << "'"
                              << std::endl;
    }
    returnValue = false;
  }
  else {
    // Open file
    if ((m_subDisplayFile) && (this->displayVerbosity() >= 10)) {
      *this->subDisplayFile() << "In BaseEnvironment::openUnifiedInputFile()"
                              << ": opening input file with base name '" << baseFileName << "." << fileType
                              << "'"
                              << std::endl;
    }
    if (this->subRank() == 0) { // Needed ???????? prudenci 2010-11-11
      // Verify parent directory exists (for cases when a user
      // specifies a relative path for the desired output file). prudenci 2010/06/26
      // std::cout << "checking " << baseFileName+"."+fileType << std::endl;
      int irtrn = CheckFilePath((baseFileName+"."+fileType).c_str());
      UQ_FATAL_TEST_MACRO(irtrn < 0,
                          m_worldRank,
                          "BaseEnvironment::openUnifiedInputFile()",
                          "unable to verify input path");

      if (fileType == UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT) {
        filePtrSet.ifsVar = new std::ifstream((baseFileName+"."+fileType).c_str(),
                                              std::ofstream::in);
        if ((filePtrSet.ifsVar == NULL) || (filePtrSet.ifsVar->is_open() == false)) {
          std::cerr << "In BaseEnvironment::openUnifiedInputFile()"
                    << ": failed to open input file with base name '" << baseFileName << "." << fileType
                    << "'"
                    << std::endl;
        }
        UQ_FATAL_TEST_MACRO((filePtrSet.ifsVar == NULL) || (filePtrSet.ifsVar->is_open() == false),
                            this->worldRank(),
                            "BaseEnvironment::openUnifiedInputFile()",
                            "file with fileName could not be found");
      }
#ifdef QUESO_HAS_HDF5
      else if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
        filePtrSet.h5Var = H5Fopen((baseFileName+"."+fileType).c_str(),
                                   H5F_ACC_RDONLY,
                                   H5P_DEFAULT);
      }
#endif
      else {
        UQ_FATAL_TEST_MACRO(true,
                            m_worldRank,
                            "BaseEnvironment::openUnifiedInputFile()",
                            "invalid file type");
      }
    }
    //else {
    //  returnValue = false;
    //}
    //this->subComm().Barrier();
  }

  return returnValue;
}

bool QUESO::BaseEnvironment::openUnifiedOutputFile	(	const std::string &	fileName,
		const std::string &	fileType,
		bool	writeOver,
		FilePtrSetStruct &	filePtrSet
	)		const

Opens a unified output file, that will contain data from all sub-environments.

Definition at line 733 of file Environment.C.

References QUESO::CheckFilePath(), displayVerbosity(), m_subDisplayFile, m_worldRank, QUESO::FilePtrSetStruct::ofsVar, subDisplayFile(), subRank(), UQ_FATAL_TEST_MACRO, UQ_FILE_EXTENSION_FOR_HDF_FORMAT, UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT, and worldRank().

{
  std::string fileType(inputFileType);
#ifdef QUESO_HAS_HDF5
  // Do nothing
#else
  if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
    if (m_subDisplayFile) {
      *this->subDisplayFile() << "WARNING in BaseEnvironment::openUnifiedOutputFile()"
                              << ": file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                              << "' has been requested, but this QUESO library has not been built with 'hdf5'"
                              << ". Code will therefore process the file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                              << "' instead..."
                              << std::endl;
    }
    if (this->subRank() == 0) {
      std::cerr << "WARNING in BaseEnvironment::openUnifiedOutputFile()"
                << ": file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                << "' has been requested, but this QUESO library has not been built with 'hdf5'"
                << ". Code will therefore process the file format '" << UQ_FILE_EXTENSION_FOR_HDF_FORMAT
                << "' instead..."
                << std::endl;
    }
    fileType = UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT;
  }
#endif

  bool returnValue = true;
  filePtrSet.ofsVar = NULL;
  if (baseFileName == ".") {
    if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
      *this->subDisplayFile() << "In BaseEnvironment::openUnifiedOutputFile()"
                              << ": no unified output file opened with base name '" << baseFileName << "." << fileType
                              << "'"
                              << ", writeOver = " << writeOver
                              << std::endl;
    }
    returnValue = false;
  }
  else {
    // Open file
    if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
      *this->subDisplayFile() << "In BaseEnvironment::openUnifiedOutputFile()"
                              << ": opening unified output file with base name '" << baseFileName << "." << fileType
                              << "'"
                              << ", writeOver = " << writeOver
                              << std::endl;
    }


    //if ((this->subRank   () == 0) &&
    //    (this->inter0Rank() == 0)) {
#if 0
      std::cout << "In BaseEnvironment::openUnifiedOutputFile()"
                << ": opening output file with base name '" << baseFileName << "." << fileType
                << "'"
                << ", writeOver = " << writeOver
                << std::endl;
#endif
      // Verify parent directory exists (for cases when a user
      // specifies a relative path for the desired output file). prudenci 2010/06/26
      // std::cout << "checking " << baseFileName+"."+fileType << std::endl;
      int irtrn = CheckFilePath((baseFileName+"."+fileType).c_str());
      UQ_FATAL_TEST_MACRO(irtrn < 0,
                          m_worldRank,
                          "BaseEnvironment::openUnifiedOutputFile()",
                          "unable to verify output path");

      if (writeOver) {
        // Write over an eventual pre-existing file
        if (fileType == UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT) {
          filePtrSet.ofsVar = new std::ofstream((baseFileName+"."+fileType).c_str(),
                                                std::ofstream::out | std::ofstream::trunc);
        }
#ifdef QUESO_HAS_HDF5
        else if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
          filePtrSet.h5Var = H5Fcreate((baseFileName+"."+fileType).c_str(),
                                       H5F_ACC_TRUNC,
                                       H5P_DEFAULT,
                                       H5P_DEFAULT);
        }
#endif
        else {
          UQ_FATAL_TEST_MACRO(true,
                              m_worldRank,
                              "BaseEnvironment::openUnifiedOutputFile(), writeOver=true",
                              "invalid file type");
        }
        if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
          *this->subDisplayFile() << "In BaseEnvironment::openUnifiedOutputFile()"
                                  << ": just opened output file with base name '" << baseFileName << "." << fileType
                                  << "'"
                                  << ", writeOver = " << writeOver
                                  << ", options 'out|trunc'"
                                  << ", osfvar = " << filePtrSet.ofsVar
                                  << std::endl;
        }
      }
      else {
        // Write at the end of an eventual pre-existing file
        // 'm' and Ranger nodes behave differently on ofstream constructor... prudenci 2010/03/05
        if (fileType == UQ_FILE_EXTENSION_FOR_MATLAB_FORMAT) {
          filePtrSet.ofsVar = new std::ofstream((baseFileName+"."+fileType).c_str(),
                                                std::ofstream::out /*| std::ofstream::in*/ | std::ofstream::app);
        }
#ifdef QUESO_HAS_HDF5
        else if (fileType == UQ_FILE_EXTENSION_FOR_HDF_FORMAT) {
          filePtrSet.h5Var = H5Fcreate((baseFileName+"."+fileType).c_str(), // TEMPORARY - FIX ME
                                       H5F_ACC_TRUNC,
                                       H5P_DEFAULT,
                                       H5P_DEFAULT);
          //UQ_FATAL_TEST_MACRO(true,
          //                    m_worldRank,
          //                    "BaseEnvironment::openUnifiedOutputFile(), writeOver=false",
          //                    "hdf file type not supported yet");
        }
#endif
        else {
          UQ_FATAL_TEST_MACRO(true,
                              m_worldRank,
                              "BaseEnvironment::openUnifiedOutputFile(), writeOver=false",
                              "invalid file type");
        }
        if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
          *this->subDisplayFile() << "In BaseEnvironment::openUnifiedOutputFile()"
                                  << ": just opened output file with base name '" << baseFileName << "." << fileType
                                  << "'"
                                  << ", writeOver = " << writeOver
                                  << ", options 'out|in|app'"
                                  << ", osfvar = " << filePtrSet.ofsVar
                                  << std::endl;
        }
        if ((filePtrSet.ofsVar            == NULL ) ||
            (filePtrSet.ofsVar->is_open() == false)) {
#if 0
          std::cout << "Retrying 2..." << std::endl;
#endif
          delete filePtrSet.ofsVar;
          filePtrSet.ofsVar = new std::ofstream((baseFileName+"."+fileType).c_str(),
                                                std::ofstream::out | std::ofstream::trunc);
          if ((m_subDisplayFile) && (this->displayVerbosity() > 10)) { // output debug
            *this->subDisplayFile() << "In BaseEnvironment::openUnifiedOutputFile()"
                                    << ": just opened output file with base name '" << baseFileName << "." << fileType
                                    << "'"
                                    << ", writeOver = " << writeOver
                                    << ", options 'out|trunc'"
                                    << ", osfvar = " << filePtrSet.ofsVar
                                    << std::endl;
          }
        }
      }
      if (filePtrSet.ofsVar == NULL) {
        std::cerr << "In BaseEnvironment::openUnifiedOutputFile()"
                  << ": failed to open unified output file with base name '" << baseFileName << "." << fileType
                  << "'"
                  << std::endl;
      }
      UQ_FATAL_TEST_MACRO((filePtrSet.ofsVar && filePtrSet.ofsVar->is_open()) == false,
                          this->worldRank(),
                          "openUnifiedOutputFile()",
                          "failed to open output file");
    //}
  }

  return returnValue;
}

BaseEnvironment & QUESO::BaseEnvironment::operator=

(

const BaseEnvironment &

rhs

)

Assignment operator. It should not be used be the user.

Definition at line 219 of file Environment.C.

References UQ_FATAL_TEST_MACRO, QUESO::UQ_INVALID_INTERNAL_STATE_RC, and worldRank().

{
  UQ_FATAL_TEST_MACRO(UQ_INVALID_INTERNAL_STATE_RC,
                      rhs.worldRank(),
                      "BaseEnvironment::operator=()",
                      "code should not execute through here");
  return *this;
}

std::string QUESO::BaseEnvironment::optionsInputFileName

(

)

const

Access to the attribute m_optionsInputFileName, which stores the name of the input file passed by the user to QUESO.

Definition at line 341 of file Environment.C.

References m_optionsInputFileAccessState, and m_optionsInputFileName.

Referenced by QUESO::EnvironmentOptions::EnvironmentOptions(), QUESO::InfiniteDimensionalMCMCSamplerOptions::InfiniteDimensionalMCMCSamplerOptions(), QUESO::MetropolisHastingsSGOptions::MetropolisHastingsSGOptions(), QUESO::MonteCarloSGOptions::MonteCarloSGOptions(), QUESO::StatisticalForwardProblemOptions::StatisticalForwardProblemOptions(), QUESO::StatisticalInverseProblem< P_V, P_M >::StatisticalInverseProblem(), and QUESO::StatisticalInverseProblemOptions::StatisticalInverseProblemOptions().

{
  if (m_optionsInputFileAccessState) {
    return m_optionsInputFileName;
  }
  else {
    return "";
  }
}

std::string QUESO::BaseEnvironment::platformName

(

)

const

Access to the platform name.

Definition at line 491 of file Environment.C.

References m_optionsObj, QUESO::EnvironmentOptions::m_ov, and QUESO::EnvOptionsValues::m_platformName.

{
  return m_optionsObj->m_ov.m_platformName;
}

virtual void QUESO::BaseEnvironment::print ( std::ostream &  os ) const

pure virtual

Implemented in QUESO::FullEnvironment, and QUESO::EmptyEnvironment.

void QUESO::BaseEnvironment::resetIdentifyingString

(

const std::string &

newString

)

const

Reset private attribute m_identifyingString with the value newString.

Definition at line 503 of file Environment.C.

{
  m_optionsObj->m_ov.m_identifyingString = newString;
  return;
}

void QUESO::BaseEnvironment::resetSeed

(

int

newSeedOption

)

Reset RNG seed.

Definition at line 478 of file Environment.C.

References m_rngObject, and QUESO::RngBase::resetSeed().

{
  m_rngObject->resetSeed(newSeedOption);
  return;
}

const RngBase * QUESO::BaseEnvironment::rngObject

(

)

const

Access to the RNG object.

Definition at line 466 of file Environment.C.

References m_rngObject.

Referenced by QUESO::GslVector::cwSetBeta(), QUESO::GslVector::cwSetGamma(), QUESO::GslVector::cwSetGaussian(), QUESO::GslVector::cwSetInverseGamma(), QUESO::GslVector::cwSetUniform(), QUESO::InfiniteDimensionalGaussian::draw(), and QUESO::FiniteDistribution::sample().

{
  return m_rngObject;
}

void QUESO::BaseEnvironment::scanInputFileForMyOptions

(

const po::options_description &

optionsDesc

)

const

This method scans the input file provided by the user to QUESO.

It checks if no input file is passed and updates the private attribute m_allOptionsDesc, which keeps all the options.

Definition at line 378 of file Environment.C.

References m_allOptionsDesc, m_allOptionsMap, m_optionsInputFileName, m_worldRank, and UQ_FATAL_TEST_MACRO.

Referenced by QUESO::InfiniteDimensionalMCMCSamplerOptions::scanOptionsValues(), QUESO::EnvironmentOptions::scanOptionsValues(), QUESO::MLSamplingOptions::scanOptionsValues(), QUESO::StatisticalForwardProblemOptions::scanOptionsValues(), QUESO::StatisticalInverseProblemOptions::scanOptionsValues(), QUESO::MLSamplingLevelOptions::scanOptionsValues(), QUESO::MonteCarloSGOptions::scanOptionsValues(), and QUESO::MetropolisHastingsSGOptions::scanOptionsValues().

{
#ifdef UQ_USES_COMMAND_LINE_OPTIONS
  // If you want to use command line options, the following line does *not* work outside 'main.C',
  // e.g., in the constructor of FullEnvironment:
  // Line: po::store(po::parse_command_line(argc, argv, *m_allOptionsDesc), *m_allOptionsMap);
  //
  // Instead, put the following three lines *immediately after* instantianting the UQ environment
  // variable "FullEnvironment* env":
  // Line 1: po::store(po::parse_command_line(argc, argv, env->allOptionsDesc()), env->allOptionsMap());
  // Line 2: po::notify(env->allOptionsMap());
  // Line 3: env->getMyOptionValues();
#endif

#ifdef QUESO_MEMORY_DEBUGGING
  std::cout << "Entering BaseEnv::scanInputFileForMyOptions()" << std::endl;
#endif

  UQ_FATAL_TEST_MACRO(m_allOptionsDesc == NULL,
                      m_worldRank,
                      "BaseEnvironment::scanInputFileForMyOptions()",
                      "m_allOptionsDesc variable is NULL");
  m_allOptionsDesc->add(optionsDesc);
  //if (m_subDisplayFile) {
  //  *m_subDisplayFile << *m_allOptionsDesc
  //                    << std::endl;
  //}

  UQ_FATAL_TEST_MACRO(m_optionsInputFileName == "",
                      m_worldRank,
                      "BaseEnvironment::scanInputFileForMyOptions()",
                      "m_optionsInputFileName is 'nothing'");
  //std::ifstream ifs(m_optionsInputFileName.c_str());
  std::ifstream* ifs = new std::ifstream(m_optionsInputFileName.c_str());
#ifdef QUESO_MEMORY_DEBUGGING
  std::cout << "in BaseEnv::scanInputFileForMyOptions(), before store(a)" << std::endl;
#endif

  UQ_FATAL_TEST_MACRO(m_allOptionsMap == NULL,
                      m_worldRank,
                      "BaseEnvironment::scanInputFileForMyOptions()",
                      "m_allOptionsMap variable is NULL");
  po::store(po::parse_config_file(*ifs, *m_allOptionsDesc, true), *m_allOptionsMap);
#ifdef QUESO_MEMORY_DEBUGGING
  std::cout << "in BaseEnv::scanInputFileForMyOptions(), after store(a)" << std::endl;
#endif
  po::notify(*m_allOptionsMap);

  //ifs.close();
  delete ifs;
#ifdef QUESO_MEMORY_DEBUGGING
  std::cout << "Leaving BaseEnv::scanInputFileForMyOptions()" << std::endl;
#endif

  return;
}

int QUESO::BaseEnvironment::seed

(

)

const

Access to the RNG seed.

Definition at line 472 of file Environment.C.

References m_rngObject, and QUESO::RngBase::seed().

{
  return m_rngObject->seed();
}

const MpiComm & QUESO::BaseEnvironment::selfComm

(

)

const

Access function for MpiComm self-communicator.

Definition at line 279 of file Environment.C.

References m_selfComm, m_worldRank, and UQ_FATAL_TEST_MACRO.

{
  UQ_FATAL_TEST_MACRO(m_selfComm == NULL,
                      m_worldRank,
                      "BaseEnvironment::selfComm()",
                      "m_selfComm variable is NULL");
  return *m_selfComm;
}

void QUESO::BaseEnvironment::setExceptionalCircumstance

(

bool

value

)

const

Set an exceptional circumstance.

Definition at line 1171 of file Environment.C.

References m_exceptionalCircumstance.

{
  m_exceptionalCircumstance = value;
  return;
}

void QUESO::BaseEnvironment::setOptionsInputFileAccessState

(

bool

newState

)

const

Definition at line 352 of file Environment.C.

References m_optionsInputFileAccessState.

{
  m_optionsInputFileAccessState = newState;

  return;
}

const MpiComm & QUESO::BaseEnvironment::subComm

(

)

const

Access function for MpiComm sub communicator.

Definition at line 269 of file Environment.C.

References m_subComm, m_worldRank, and UQ_FATAL_TEST_MACRO.

Referenced by QUESO::MiscCheckTheParallelEnvironment().

{
  UQ_FATAL_TEST_MACRO(m_subComm == NULL,
                      m_worldRank,
                      "BaseEnvironment::subComm()",
                      "m_subComm variable is NULL");
  return *m_subComm;
}

std::ofstream * QUESO::BaseEnvironment::subDisplayFile

(

)

const

Access function for m_subDisplayFile (displays file on stream).

Definition at line 305 of file Environment.C.

References m_subDisplayFile.

Referenced by QUESO::AsciiTable< V, M >::AsciiTable(), QUESO::BaseJointPdf< V, M >::BaseJointPdf(), QUESO::BaseMatrixCovarianceFunction< P_V, P_M, Q_V, Q_M >::BaseMatrixCovarianceFunction(), QUESO::BaseOneDGrid< T >::BaseOneDGrid(), QUESO::BaseScalarCdf< T >::BaseScalarCdf(), QUESO::BaseScalarCovarianceFunction< V, M >::BaseScalarCovarianceFunction(), QUESO::BaseVectorCdf< V, M >::BaseVectorCdf(), QUESO::BaseVectorMdf< V, M >::BaseVectorMdf(), QUESO::BaseVectorRealizer< V, M >::BaseVectorRealizer(), QUESO::BaseVectorRV< V, M >::BaseVectorRV(), QUESO::BetaJointPdf< V, M >::BetaJointPdf(), QUESO::BetaVectorRealizer< V, M >::BetaVectorRealizer(), QUESO::BetaVectorRV< V, M >::BetaVectorRV(), closeFile(), QUESO::ComputeConditionalGaussianVectorRV(), QUESO::ConcatenatedVectorRealizer< V, M >::ConcatenatedVectorRealizer(), QUESO::ConcatenatedVectorRV< V, M >::ConcatenatedVectorRV(), QUESO::GslVector::cwSetBeta(), QUESO::GslMatrix::determinant(), QUESO::EnvironmentOptions::EnvironmentOptions(), QUESO::ExponentialMatrixCovarianceFunction< P_V, P_M, Q_V, Q_M >::ExponentialMatrixCovarianceFunction(), QUESO::ExponentialScalarCovarianceFunction< V, M >::ExponentialScalarCovarianceFunction(), QUESO::FiniteDistribution::FiniteDistribution(), QUESO::GammaJointPdf< V, M >::GammaJointPdf(), QUESO::GammaVectorRealizer< V, M >::GammaVectorRealizer(), QUESO::GammaVectorRV< V, M >::GammaVectorRV(), QUESO::GaussianJointPdf< V, M >::GaussianJointPdf(), QUESO::GaussianVectorCdf< V, M >::GaussianVectorCdf(), QUESO::GaussianVectorMdf< V, M >::GaussianVectorMdf(), QUESO::GaussianVectorRealizer< V, M >::GaussianVectorRealizer(), QUESO::GaussianVectorRV< V, M >::GaussianVectorRV(), QUESO::GenericMatrixCovarianceFunction< P_V, P_M, Q_V, Q_M >::GenericMatrixCovarianceFunction(), QUESO::GenericScalarCovarianceFunction< V, M >::GenericScalarCovarianceFunction(), QUESO::GenericVectorRealizer< V, M >::GenericVectorRealizer(), QUESO::GenericVectorRV< V, M >::GenericVectorRV(), QUESO::InfiniteDimensionalMCMCSamplerOptions::getMyOptionValues(), QUESO::MLSamplingOptions::getMyOptionValues(), QUESO::StatisticalForwardProblemOptions::getMyOptionValues(), QUESO::StatisticalInverseProblemOptions::getMyOptionValues(), QUESO::MonteCarloSGOptions::getMyOptionValues(), QUESO::MetropolisHastingsSGOptions::getMyOptionValues(), QUESO::MLSamplingLevelOptions::getMyOptionValues(), QUESO::HessianCovMatricesTKGroup< V, M >::HessianCovMatricesTKGroup(), QUESO::horizontalDistance(), QUESO::GslMatrix::inverse(), QUESO::InverseGammaJointPdf< V, M >::InverseGammaJointPdf(), QUESO::InverseGammaVectorRealizer< V, M >::InverseGammaVectorRealizer(), QUESO::InverseGammaVectorRV< V, M >::InverseGammaVectorRV(), QUESO::GslMatrix::invertMultiply(), QUESO::InvLogitGaussianVectorRV< V, M >::InvLogitGaussianVectorRV(), QUESO::JeffreysJointPdf< V, M >::JeffreysJointPdf(), QUESO::JeffreysVectorRealizer< V, M >::JeffreysVectorRealizer(), QUESO::JeffreysVectorRV< V, M >::JeffreysVectorRV(), QUESO::GslMatrix::lnDeterminant(), QUESO::LogNormalJointPdf< V, M >::LogNormalJointPdf(), QUESO::LogNormalVectorRealizer< V, M >::LogNormalVectorRealizer(), QUESO::LogNormalVectorRV< V, M >::LogNormalVectorRV(), QUESO::MetropolisHastingsSG< P_V, P_M >::MetropolisHastingsSG(), QUESO::MetropolisHastingsSGOptions::MetropolisHastingsSGOptions(), QUESO::MLSampling< P_V, P_M >::MLSampling(), QUESO::ModelValidation< P_V, P_M, Q_V, Q_M >::ModelValidation(), QUESO::MonteCarloSGOptions::MonteCarloSGOptions(), openInputFile(), openOutputFile(), openUnifiedInputFile(), openUnifiedOutputFile(), QUESO::PoweredJointPdf< V, M >::PoweredJointPdf(), QUESO::GslMatrix::rank(), QUESO::SampledScalarCdf< T >::SampledScalarCdf(), QUESO::SampledVectorCdf< V, M >::SampledVectorCdf(), QUESO::SampledVectorMdf< V, M >::SampledVectorMdf(), QUESO::ScaledCovMatrixTKGroup< V, M >::ScaledCovMatrixTKGroup(), QUESO::InfiniteDimensionalMCMCSamplerOptions::scanOptionsValues(), QUESO::MLSamplingOptions::scanOptionsValues(), QUESO::StatisticalForwardProblemOptions::scanOptionsValues(), QUESO::StatisticalInverseProblemOptions::scanOptionsValues(), QUESO::MLSamplingLevelOptions::scanOptionsValues(), QUESO::MonteCarloSGOptions::scanOptionsValues(), QUESO::MetropolisHastingsSGOptions::scanOptionsValues(), QUESO::SequentialVectorRealizer< V, M >::SequentialVectorRealizer(), QUESO::StatisticalForwardProblemOptions::StatisticalForwardProblemOptions(), QUESO::StatisticalInverseProblem< P_V, P_M >::StatisticalInverseProblem(), QUESO::StatisticalInverseProblemOptions::StatisticalInverseProblemOptions(), QUESO::StdOneDGrid< T >::StdOneDGrid(), QUESO::StdScalarCdf< T >::StdScalarCdf(), QUESO::GslVector::subReadContents(), QUESO::GslMatrix::subReadContents(), QUESO::GslMatrix::svdSolve(), QUESO::TransformedScaledCovMatrixTKGroup< V, M >::TransformedScaledCovMatrixTKGroup(), QUESO::UniformJointPdf< V, M >::UniformJointPdf(), QUESO::UniformOneDGrid< T >::UniformOneDGrid(), QUESO::UniformVectorRealizer< V, M >::UniformVectorRealizer(), QUESO::UniformVectorRV< V, M >::UniformVectorRV(), QUESO::ValidationCycle< P_V, P_M, Q_V, Q_M >::ValidationCycle(), QUESO::VectorSet< V, M >::VectorSet(), QUESO::VectorSpace< V, M >::VectorSpace(), QUESO::VectorSubset< V, M >::VectorSubset(), QUESO::WignerJointPdf< V, M >::WignerJointPdf(), QUESO::WignerVectorRealizer< V, M >::WignerVectorRealizer(), and QUESO::WignerVectorRV< V, M >::WignerVectorRV().

{
  return m_subDisplayFile;
}

std::string QUESO::BaseEnvironment::subDisplayFileName

(

)

const

Access function for m_subDisplayFileName (displays filename on stream).

Definition at line 311 of file Environment.C.

References m_optionsObj, QUESO::EnvironmentOptions::m_ov, and QUESO::EnvOptionsValues::m_subDisplayFileName.

{
  if (m_optionsObj == NULL) return ".";

  return m_optionsObj->m_ov.m_subDisplayFileName;
}

RawType_MPI_Group QUESO::BaseEnvironment::subGroup

(

)

const

Access function for sub-group.

Definition at line 257 of file Environment.C.

References m_subGroup.

{
  return m_subGroup;
}

unsigned int QUESO::BaseEnvironment::subId

(

)

const

Access function to the number of each sub-environment Id: m_subId.

Definition at line 329 of file Environment.C.

References m_subId.

Referenced by QUESO::MetropolisHastingsSGOptions::getMyOptionValues(), QUESO::MLSamplingLevelOptions::getMyOptionValues(), openOutputFile(), and QUESO::MpiComm::syncPrintDebugMsg().

{
  return m_subId;
}

const std::string & QUESO::BaseEnvironment::subIdString

(

)

const

Access to the attribute m_subIdString; which stores the string for the sub-environment, and it will be used, for instance, to create the output files for each sub-environment.

Definition at line 335 of file Environment.C.

References m_subIdString.

Referenced by openOutputFile(), QUESO::Sampled1D1DFunction::printForMatlab(), QUESO::GslVector::subWriteContents(), and QUESO::GslMatrix::subWriteContents().

{
  return m_subIdString;
}

int QUESO::BaseEnvironment::subRank

(

)

const

Access function for sub-rank.

Definition at line 263 of file Environment.C.

References m_subRank.

Referenced by closeFile(), QUESO::MetropolisHastingsSGOptions::getMyOptionValues(), QUESO::MLSamplingLevelOptions::getMyOptionValues(), QUESO::MiscCheckTheParallelEnvironment(), openInputFile(), openOutputFile(), openUnifiedInputFile(), openUnifiedOutputFile(), QUESO::GslVector::subReadContents(), QUESO::GslMatrix::subReadContents(), QUESO::GslVector::subWriteContents(), QUESO::GslMatrix::subWriteContents(), and QUESO::MpiComm::syncPrintDebugMsg().

{
  return m_subRank;
}

unsigned int QUESO::BaseEnvironment::syncVerbosity

(

)

const

Access function to private attribute m_syncVerbosity.

Definition at line 446 of file Environment.C.

References m_optionsObj, QUESO::EnvironmentOptions::m_ov, QUESO::EnvOptionsValues::m_syncVerbosity, m_worldRank, and UQ_FATAL_TEST_MACRO.

Referenced by QUESO::MpiComm::syncPrintDebugMsg().

{
  UQ_FATAL_TEST_MACRO(m_optionsObj == NULL,
                      m_worldRank,
                      "BaseEnvironment::displayVerbosity()",
                      "m_optionsObj variable is NULL");
  return m_optionsObj->m_ov.m_syncVerbosity;
}

struct timeval QUESO::BaseEnvironment::timevalBegin

(

)

const

Used to save the time when the combo `QUESO+user's application' started to run.

Definition at line 510 of file Environment.C.

{
  return m_timevalBegin;
}

int QUESO::BaseEnvironment::worldRank

(

)

const

Returns the process world rank.

Definition at line 235 of file Environment.C.

References m_worldRank.

Referenced by QUESO::GslVector::atLeastOneComponentBiggerOrEqualThan(), QUESO::GslVector::atLeastOneComponentBiggerThan(), QUESO::GslVector::atLeastOneComponentSmallerOrEqualThan(), QUESO::GslVector::atLeastOneComponentSmallerThan(), BaseEnvironment(), QUESO::BetaVectorRV< V, M >::BetaVectorRV(), QUESO::BoxSubset< V, M >::BoxSubset(), QUESO::GslMatrix::chol(), QUESO::ComputeConditionalGaussianVectorRV(), QUESO::ComputeCovCorrBetweenScalarSequences(), QUESO::ComputeCovCorrMatricesBetweenVectorRvs(), QUESO::ComputeCovCorrMatricesBetweenVectorSequences(), QUESO::ComputeSubGaussian2dKde(), QUESO::ComputeUnifiedGaussian2dKde(), QUESO::ConcatenatedJointPdf< V, M >::ConcatenatedJointPdf(), QUESO::GslVector::copy(), QUESO::GslMatrix::copy(), QUESO::GslVector::cwExtract(), QUESO::GslMatrix::cwExtract(), QUESO::GslVector::cwSet(), QUESO::GslMatrix::cwSet(), QUESO::GslVector::cwSetBeta(), QUESO::GslVector::cwSetConcatenated(), QUESO::GslVector::cwSetGamma(), QUESO::GslVector::cwSetInverseGamma(), QUESO::DiscreteSubset< V, M >::DiscreteSubset(), QUESO::EnvironmentOptions::EnvironmentOptions(), QUESO::ExponentialMatrixCovarianceFunction< P_V, P_M, Q_V, Q_M >::ExponentialMatrixCovarianceFunction(), QUESO::GslMatrix::fillWithBlocksDiagonally(), QUESO::GslMatrix::fillWithBlocksHorizontally(), QUESO::GslMatrix::fillWithBlocksVertically(), QUESO::GslMatrix::fillWithTensorProduct(), QUESO::GslMatrix::fillWithTranspose(), QUESO::FiniteDistribution::FiniteDistribution(), QUESO::GammaVectorRV< V, M >::GammaVectorRV(), QUESO::GaussianVectorRV< V, M >::GaussianVectorRV(), QUESO::EnvironmentOptions::getMyOptionValues(), QUESO::MLSamplingOptions::getMyOptionValues(), QUESO::MetropolisHastingsSGOptions::getMyOptionValues(), QUESO::MLSamplingLevelOptions::getMyOptionValues(), QUESO::GslMatrix::GslMatrix(), QUESO::GslVector::GslVector(), QUESO::InfiniteDimensionalMCMCSamplerOptions::InfiniteDimensionalMCMCSamplerOptions(), QUESO::InstantiateIntersection(), QUESO::GslMatrix::internalSvd(), QUESO::GslMatrix::inverse(), QUESO::InverseGammaVectorRV< V, M >::InverseGammaVectorRV(), QUESO::GslMatrix::invertMultiply(), QUESO::GslMatrix::invertMultiplyForceLU(), QUESO::InvLogitGaussianVectorRV< V, M >::InvLogitGaussianVectorRV(), QUESO::leftDiagScaling(), QUESO::LogNormalVectorRV< V, M >::LogNormalVectorRV(), QUESO::GslVector::matlabDiff(), QUESO::GslVector::matlabLinearInterpExtrap(), QUESO::GslMatrix::matlabLinearInterpExtrap(), QUESO::Matrix::Matrix(), QUESO::MetropolisHastingsSGOptions::MetropolisHastingsSGOptions(), QUESO::MiscCheckTheParallelEnvironment(), QUESO::MonteCarloSGOptions::MonteCarloSGOptions(), QUESO::GslVector::mpiAllQuantile(), QUESO::GslVector::mpiAllReduce(), QUESO::GslVector::mpiBcast(), QUESO::GslMatrix::multiply(), openInputFile(), openOutputFile(), openUnifiedInputFile(), openUnifiedOutputFile(), QUESO::GslMatrix::operator()(), QUESO::operator*(), QUESO::Matrix::operator*=(), QUESO::Vector::operator*=(), QUESO::GslVector::operator*=(), QUESO::GslMatrix::operator*=(), QUESO::Matrix::operator+=(), QUESO::Vector::operator+=(), QUESO::GslVector::operator+=(), QUESO::GslMatrix::operator+=(), QUESO::Matrix::operator-=(), QUESO::Vector::operator-=(), QUESO::GslVector::operator-=(), QUESO::GslMatrix::operator-=(), QUESO::Vector::operator/=(), QUESO::GslVector::operator/=(), QUESO::Matrix::operator=(), QUESO::Vector::operator=(), QUESO::GslVector::operator=(), operator=(), QUESO::operator==(), QUESO::rightDiagScaling(), QUESO::FiniteDistribution::sample(), QUESO::scalarProduct(), QUESO::InfiniteDimensionalMCMCSamplerOptions::scanOptionsValues(), QUESO::EnvironmentOptions::scanOptionsValues(), QUESO::StatisticalForwardProblemOptions::scanOptionsValues(), QUESO::StatisticalInverseProblemOptions::scanOptionsValues(), QUESO::MonteCarloSGOptions::scanOptionsValues(), QUESO::MetropolisHastingsSGOptions::scanOptionsValues(), QUESO::GslVector::sizeGlobal(), QUESO::GslVector::sizeLocal(), QUESO::StatisticalForwardProblemOptions::StatisticalForwardProblemOptions(), QUESO::StatisticalInverseProblem< P_V, P_M >::StatisticalInverseProblem(), QUESO::StatisticalInverseProblemOptions::StatisticalInverseProblemOptions(), QUESO::SubF1F2Gaussian2dKdeIntegral(), QUESO::GslVector::subReadContents(), QUESO::GslMatrix::subReadContents(), QUESO::GslVector::subWriteContents(), QUESO::GslMatrix::subWriteContents(), QUESO::GslMatrix::svd(), QUESO::GslMatrix::svdSolve(), QUESO::GslMatrix::transpose(), QUESO::Vector::Vector(), QUESO::VectorSet< V, M >::VectorSet(), QUESO::VectorSpace< V, M >::VectorSpace(), QUESO::VectorSubset< V, M >::VectorSubset(), QUESO::WignerJointPdf< V, M >::WignerJointPdf(), QUESO::WignerVectorRealizer< V, M >::WignerVectorRealizer(), QUESO::WignerVectorRV< V, M >::WignerVectorRV(), QUESO::GslMatrix::zeroLower(), and QUESO::GslMatrix::zeroUpper().

{
  return m_worldRank;
}

Member Data Documentation

po::options_description* QUESO::BaseEnvironment::m_allOptionsDesc

protected

Definition at line 363 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), scanInputFileForMyOptions(), and ~BaseEnvironment().

po::variables_map* QUESO::BaseEnvironment::m_allOptionsMap

protected

Definition at line 364 of file Environment.h.

Referenced by allOptionsMap(), QUESO::FullEnvironment::FullEnvironment(), scanInputFileForMyOptions(), and ~BaseEnvironment().

EnvOptionsValues QUESO::BaseEnvironment::m_alternativeOptionsValues

protected

Definition at line 386 of file Environment.h.

Referenced by BaseEnvironment(), and QUESO::FullEnvironment::FullEnvironment().

BasicPdfsBase* QUESO::BaseEnvironment::m_basicPdfs

protected

Definition at line 382 of file Environment.h.

Referenced by basicPdfs(), QUESO::FullEnvironment::FullEnvironment(), and ~BaseEnvironment().

bool QUESO::BaseEnvironment::m_exceptionalCircumstance

mutableprotected

Definition at line 384 of file Environment.h.

Referenced by exceptionalCircumstance(), and setExceptionalCircumstance().

MpiComm* QUESO::BaseEnvironment::m_fullComm

protected

Definition at line 356 of file Environment.h.

Referenced by fullComm(), QUESO::FullEnvironment::FullEnvironment(), and ~BaseEnvironment().

int QUESO::BaseEnvironment::m_fullCommSize

protected

Definition at line 358 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment().

bool QUESO::BaseEnvironment::m_fullEnvIsReady

protected

Definition at line 353 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), and fullEnvIsReady().

RawType_MPI_Group QUESO::BaseEnvironment::m_fullGroup

protected

Definition at line 359 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment().

int QUESO::BaseEnvironment::m_fullRank

protected

Definition at line 357 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), fullRank(), QUESO::FullEnvironment::readOptionsInputFile(), and ~BaseEnvironment().

MpiComm* QUESO::BaseEnvironment::m_inter0Comm

protected

Definition at line 376 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), inter0Comm(), and ~BaseEnvironment().

int QUESO::BaseEnvironment::m_inter0CommSize

protected

Definition at line 378 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment().

RawType_MPI_Group QUESO::BaseEnvironment::m_inter0Group

protected

Definition at line 375 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment().

int QUESO::BaseEnvironment::m_inter0Rank

protected

Definition at line 377 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), and inter0Rank().

bool QUESO::BaseEnvironment::m_optionsInputFileAccessState

mutableprotected

Definition at line 362 of file Environment.h.

Referenced by optionsInputFileName(), and setOptionsInputFileAccessState().

std::string QUESO::BaseEnvironment::m_optionsInputFileName

protected

Definition at line 361 of file Environment.h.

Referenced by BaseEnvironment(), QUESO::FullEnvironment::FullEnvironment(), optionsInputFileName(), QUESO::FullEnvironment::readOptionsInputFile(), and scanInputFileForMyOptions().

EnvironmentOptions* QUESO::BaseEnvironment::m_optionsObj

protected

Definition at line 387 of file Environment.h.

Referenced by checkingLevel(), displayVerbosity(), QUESO::FullEnvironment::FullEnvironment(), identifyingString(), numSubEnvironments(), platformName(), subDisplayFileName(), syncVerbosity(), and ~BaseEnvironment().

RngBase* QUESO::BaseEnvironment::m_rngObject

protected

Definition at line 381 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), resetSeed(), rngObject(), seed(), and ~BaseEnvironment().

MpiComm* QUESO::BaseEnvironment::m_selfComm

protected

Definition at line 373 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), selfComm(), and ~BaseEnvironment().

MpiComm* QUESO::BaseEnvironment::m_subComm

protected

Definition at line 369 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), subComm(), and ~BaseEnvironment().

int QUESO::BaseEnvironment::m_subCommSize

protected

Definition at line 371 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment().

std::ofstream* QUESO::BaseEnvironment::m_subDisplayFile

mutableprotected

Definition at line 380 of file Environment.h.

Referenced by closeFile(), QUESO::FullEnvironment::FullEnvironment(), openInputFile(), openOutputFile(), openUnifiedInputFile(), openUnifiedOutputFile(), subDisplayFile(), and ~BaseEnvironment().

RawType_MPI_Group QUESO::BaseEnvironment::m_subGroup

protected

Definition at line 368 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), and subGroup().

unsigned int QUESO::BaseEnvironment::m_subId

protected

Definition at line 366 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), and subId().

std::string QUESO::BaseEnvironment::m_subIdString

protected

Definition at line 367 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), and subIdString().

int QUESO::BaseEnvironment::m_subRank

protected

Definition at line 370 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), and subRank().

struct timeval QUESO::BaseEnvironment::m_timevalBegin

protected

Definition at line 383 of file Environment.h.

Referenced by QUESO::FullEnvironment::FullEnvironment(), and ~BaseEnvironment().

int QUESO::BaseEnvironment::m_worldRank

protected

Definition at line 354 of file Environment.h.

Referenced by allOptionsMap(), checkingLevel(), closeFile(), displayVerbosity(), fullComm(), QUESO::FullEnvironment::FullEnvironment(), inter0Comm(), numSubEnvironments(), openInputFile(), openOutputFile(), openUnifiedInputFile(), openUnifiedOutputFile(), scanInputFileForMyOptions(), selfComm(), subComm(), syncVerbosity(), and worldRank().

---

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

• src/core/inc/Environment.h
• src/core/src/Environment.C