A cache based data reader. More...

#include <DataMgrAMR.h>

Inheritance diagram for VAPoR::DataMgrAMR:

Public Member Functions
	DataMgrAMR (const string &metafile, size_t mem_size)

	DataMgrAMR (const MetadataVDC &metadata, size_t mem_size)

virtual	~DataMgrAMR ()

Public Member Functions inherited from VAPoR::DataMgr
	DataMgr (size_t mem_size)

virtual	~DataMgr ()

virtual void	GetDim (size_t dim[3], int reflevel=0) const

int	GetNumTransforms () const

virtual vector< size_t >	GetCRatios () const

virtual string	GetCoordSystemType () const

virtual string	GetGridType () const

virtual vector< double >	GetExtents (size_t ts=0)

virtual long	GetNumTimeSteps () const

virtual string	GetMapProjection () const

virtual vector< string >	GetVariableNames () const

virtual vector< string >	GetVariables3D () const

virtual vector< string >	GetVariables2DXY () const

virtual vector< string >	GetVariables2DXZ () const

virtual vector< string >	GetVariables2DYZ () const

virtual vector< string >	GetCoordinateVariables () const

virtual vector< long >	GetPeriodicBoundary () const

virtual vector< long >	GetGridPermutation () const

virtual double	GetTSUserTime (size_t ts) const

virtual void	GetTSUserTimeStamp (size_t ts, string &s) const

virtual RegularGrid *	GetGrid (size_t ts, string varname, int reflevel, int lod, const size_t min[3], const size_t max[3], bool lock=false)

void	UnlockGrid (const RegularGrid *rg)

int	UnlockRegion (const float *)

void	Clear ()

int	GetDataRange (size_t ts, const char *varname, float range[2], int reflevel=0, int lod=0)

int	GetValidRegion (size_t ts, const char *varname, int reflevel, size_t min[3], size_t max[3])

virtual int	VariableExists (size_t ts, const char *varname, int reflevel=0, int lod=0)

bool	BestMatch (size_t ts, const char *varname, int req_reflevel, int req_lod, int &reflevel, int &lod)

int	NewPipeline (PipeLine *pipeline)

void	RemovePipeline (string name)

bool	IsVariableDerived (string varname) const

bool	IsVariableNative (string varname) const

virtual VarType_T	GetVarType (const string &varname) const

bool	GetMissingValue (string varname, float &value) const

void	PurgeVariable (string varname)

virtual void	MapUserToVox (size_t timestep, const double vcoord0[3], size_t vcoord1[3], int reflevel=0, int lod=0)

virtual void	MapVoxToUser (size_t timestep, const size_t vcoord0[3], double vcoord1[3], int ref_level=0, int lod=0)

virtual void	GetEnclosingRegion (size_t ts, const double minu[3], const double maxu[3], size_t min[3], size_t max[3], int reflevel=0, int lod=0)

virtual bool	IsCoordinateVariable (string varname) const

void	PrintCache (std::ostream &o)

void	SetInterpolationOrder (int order)

int	GetInterpolationOrder () const

Public Member Functions inherited from VetsUtil::MyBase
	MyBase ()

const string &	getClassName () const

Public Member Functions inherited from VAPoR::AMRIO
	AMRIO (const MetadataVDC &metadata)

	AMRIO (const string &metafile)

virtual	~AMRIO ()

int	VariableExists (size_t ts, const char *varname, int reflevel=0, int lod=0) const

int	OpenTreeWrite (size_t timestep)

int	OpenTreeRead (size_t timestep)

int	CloseTree ()

int	TreeRead (AMRTree *tree)

int	TreeWrite (const AMRTree *tree)

int	OpenVariableWrite (size_t timestep, const char *varname, int reflevel=-1, int lod=-1)

virtual int	BlockWriteRegion (const float *region, const size_t bmin[3], const size_t bmax[3], bool block=true)

virtual int	WriteRegion (const float *region, const size_t min[3], const size_t max[3])

virtual int	WriteRegion (const float *region)

virtual int	WriteSlice (const float *slice)

int	OpenVariableRead (size_t timestep, const char *varname, int reflevel=0, int lod=0)

virtual int	BlockReadRegion (const size_t bmin[3], const size_t bmax[3], float *region, bool unblock=true)

virtual int	ReadRegion (const size_t min[3], const size_t max[3], float *region)

virtual int	ReadRegion (float *region)

virtual int	ReadSlice (float *slice)

virtual int	CloseVariable ()

int	VariableRead (AMRData *data)

int	VariableWrite (AMRData *data)

int	GetBlockMins (const float **mins, int reflevel) const

int	GetBlockMaxs (const float **maxs, int reflevel) const

const float *	GetDataRange () const

void	GetValidRegion (size_t min[3], size_t max[3], int reflevel) const

Public Member Functions inherited from VAPoR::VDFIOBase
	VDFIOBase (const MetadataVDC &metadata)

	VDFIOBase (const string &metafile)

virtual	~VDFIOBase ()

double	GetReadTimer () const

double	GetSeekTimer () const

void	SeekTimerReset ()

void	SeekTimerStart ()

void	SeekTimerStop ()

double	GetWriteTimer () const

double	GetXFormTimer () const

Public Member Functions inherited from VAPoR::MetadataVDC
	MetadataVDC (const size_t dim[3], size_t numTransforms, const size_t bs[3], int nFilterCoef=1, int nLiftingCoef=1, int msbFirst=1, int vdfVersion=VDF_VERSION)

	MetadataVDC (const size_t dim[3], const size_t bs[3], const vector< size_t > &cratios, string wname, string wmode)

	MetadataVDC (const string &metafile)

	MetadataVDC (const MetadataVDC &node)

virtual	~MetadataVDC ()

int	Merge (const MetadataVDC &metadata, size_t ts=0)

int	Merge (const string &path, size_t ts=0)

int	MakeCurrent () const

const string &	GetParentDir () const

const string &	GetMetafileName () const

const string &	GetDataDirName () const

int	ConstructFullVBase (size_t ts, const string &var, string *path) const

int	ConstructFullAuxBase (size_t ts, string *path) const

int	Write (const string &path, int relative_path=1)

virtual const size_t *	GetBlockSize () const

virtual void	GetBlockSize (size_t bs[3], int) const

virtual void	GetGridDim (size_t dim[3]) const

const size_t *	GetDimension () const

int	GetFilterCoef () const

int	GetLiftingCoef () const

virtual int	GetNumTransforms () const

int	GetMSBFirst () const

int	GetVDFVersion () const

string	GetWaveName () const

string	GetBoundaryMode () const

virtual vector< size_t >	GetCRatios () const

int	GetVDCType () const

int	SetGridType (const string &value)

string	GetGridType () const

int	IsValidGridType (const string &value) const

int	SetCoordSystemType (const string &value)

string	GetCoordSystemType () const

int	IsValidCoordSystemType (const string &value) const

int	SetExtents (const vector< double > &value)

vector< double >	GetExtents (size_t ts=0) const

int	IsValidExtents (const vector< double > &value) const

int	SetNumTimeSteps (long value)

long	GetNumTimeSteps () const

int	IsValidTimeStep (long value) const

int	SetVariableNames (const vector< string > &value)

int	SetVariables3D (const vector< string > &value)

vector< string >	GetVariables3D () const

vector< string >	GetCoordinateVariables () const

int	SetCoordinateVariables (const vector< string > &value)

int	SetVariables2DXY (const vector< string > &value)

int	SetVariables2DXZ (const vector< string > &value)

int	SetVariables2DYZ (const vector< string > &value)

vector< string >	GetVariables2DXY () const

vector< string >	GetVariables2DXZ () const

vector< string >	GetVariables2DYZ () const

int	SetComment (const string &value)

string	GetComment () const

int	SetPeriodicBoundary (const vector< long > &value)

vector< long >	GetPeriodicBoundary () const

int	SetGridPermutation (const vector< long > &value)

int	SetMissingValue (double value)

int	SetMissingValue ()

vector< double >	GetMissingValue () const

vector< long >	GetGridPermutation () const

int	SetMapProjection (const string &value)

virtual string	GetMapProjection () const

int	SetTSUserTime (size_t ts, const vector< double > &value)

double	GetTSUserTime (size_t ts) const

int	SetTSUserTimeStamp (size_t ts, const string &s)

void	GetTSUserTimeStamp (size_t ts, string &s) const

string	GetTSAuxBasePath (size_t ts) const

int	HasTSUserTime (size_t ts) const

int	IsValidUserTime (const vector< double > &value) const

int	SetTSXCoords (size_t ts, const vector< double > &value)

vector< double >	GetTSXCoords (size_t ts) const

int	SetTSYCoords (size_t ts, const vector< double > &value)

vector< double >	GetTSYCoords (size_t ts) const

int	SetTSZCoords (size_t ts, const vector< double > &value)

vector< double >	GetTSZCoords (size_t ts) const

int	SetTSComment (size_t ts, const string &value)
	Set a comment for the time step indicated by `ts`. More...

string	GetTSComment (size_t ts) const
	Return the comment for the indicated time step, `ts`, if it exists. More...

int	SetTSExtents (size_t ts, const vector< double > &value)

vector< double >	GetTSExtents (size_t ts) const

int	SetTSMissingValue (size_t ts, double v)

vector< double >	GetTSMissingValue (size_t ts) const
	Returns the time-varying missing value, if any. More...

int	SetVComment (size_t ts, const string &var, const string &value)

string	GetVComment (size_t ts, const string &var) const

string	GetVBasePath (size_t ts, const string &var) const

int	SetVBasePath (size_t ts, const string &var, const string &value)

int	SetVDataRange (size_t ts, const string &var, const vector< double > &value)

vector< double >	GetVDataRange (size_t ts, const string &var) const

int	IsValidVDataRange (const vector< double > &value) const

int	SetVMissingValue (size_t ts, const string &var, double v)

vector< double >	GetVMissingValue (size_t ts, const string &var) const

vector< string >	GetUserDataLongTags () const

int	SetUserDataLong (const string &tag, const vector< long > &value)

vector< long >	GetUserDataLong (const string &tag) const

vector< string >	GetUserDataDoubleTags () const

int	SetUserDataDouble (const string &tag, const vector< double > &value)

vector< double >	GetUserDataDouble (const string &tag) const

vector< string >	GetUserDataStringTags () const

int	SetUserDataString (const string &tag, const string &value)

string	GetUserDataString (const string &tag) const

int	SetUserDataStringVec (const string &tag, const vector< string > &value)

vector< string >	GetUserDataStringVec (const string &tag) const

vector< string >	GetTSUserDataLongTags () const

int	SetTSUserDataLong (size_t ts, const string &tag, const vector< long > &value)

vector< long >	GetTSUserDataLong (size_t ts, const string &tag) const

int	SetTSUserDataDouble (size_t ts, const string &tag, const vector< double > &value)

vector< double >	GetTSUserDataDouble (size_t ts, const string &tag) const

vector< string >	GetTSUserDataDoubleTags () const

int	SetTSUserDataString (size_t ts, const string &tag, const string &value)

string	GetTSUserDataString (size_t ts, const string &tag) const

vector< string >	GetTSUserDataStringTags () const

vector< string >	GetVUserDataLongTags () const

int	SetVUserDataLong (size_t ts, const string &var, const string &tag, const vector< long > &value)

vector< long >	GetVUserDataLong (size_t ts, const string &var, const string &tag) const

vector< string >	GetVUserDataDoubleTags () const

int	SetVUserDataDouble (size_t ts, const string &var, const string &tag, const vector< double > &value)

vector< double >	GetVUserDataDouble (size_t ts, const string &var, const string &tag) const

int	SetVUserDataString (size_t ts, const string &var, const string &tag, const string &value)

string	GetVUserDataString (size_t ts, const string &var, const string &tag) const

vector< string >	GetVUserDataStringTags () const

Public Member Functions inherited from VAPoR::Metadata
	Metadata ()

virtual	~Metadata ()

virtual std::vector< std::string >	GetVariableNames () const

virtual void	GetTSUserTimeStamp (size_t ts, std::string &s) const =0

virtual void	GetDim (size_t dim[3], int reflevel=0) const

virtual void	GetDimBlk (size_t bdim[3], int reflevel=0) const

virtual bool	GetMissingValue (std::string varname, float &value) const

virtual void	MapVoxToBlk (const size_t vcoord[3], size_t bcoord[3], int reflevel=-1) const

virtual void	MapVoxToUser (size_t timestep, const size_t vcoord0[3], double vcoord1[3], int ref_level=0) const

void	MapUserToVox (size_t timestep, const double vcoord0[3], size_t vcoord1[3], int reflevel) const

virtual VarType_T	GetVarType (const std::string &varname) const

virtual int	IsValidRegion (const size_t min[3], const size_t max[3], int reflevel=0) const

virtual int	IsValidRegionBlk (const size_t min[3], const size_t max[3], int reflevel=0) const

virtual bool	IsCoordinateVariable (std::string varname) const

Public Member Functions inherited from VAPoR::ParsedXml
virtual	~ParsedXml ()

virtual bool	charHandler (ExpatParseMgr , const XML_Char , int)

Protected Member Functions
virtual void	_GetDim (size_t dim[3], int reflevel) const

virtual void	_GetBlockSize (size_t bs[3], int) const

virtual int	_GetNumTransforms () const

virtual vector< double >	_GetExtents (size_t ts=0) const

virtual long	_GetNumTimeSteps () const

virtual vector< string >	_GetVariables3D () const

virtual vector< string >	_GetVariables2DXY () const

virtual vector< string >	_GetVariables2DXZ () const

virtual vector< string >	_GetVariables2DYZ () const

virtual vector< long >	_GetPeriodicBoundary () const

virtual vector< long >	_GetGridPermutation () const

virtual double	_GetTSUserTime (size_t ts) const

virtual void	_GetTSUserTimeStamp (size_t ts, string &s) const

virtual int	_VariableExists (size_t ts, const char *varname, int reflevel=0, int lod=0) const

virtual int	_OpenVariableRead (size_t timestep, const char *varname, int reflevel=0, int lod=0)

virtual void	_GetValidRegion (size_t min[3], size_t max[3], int reflevel) const

virtual const float *	_GetDataRange () const

virtual int	_BlockReadRegion (const size_t bmin[3], const size_t bmax[3], float *region)

virtual int	_CloseVariable ()

Protected Member Functions inherited from VAPoR::DataMgr
virtual vector< size_t >	_GetCRatios () const

virtual string	_GetCoordSystemType () const

virtual string	_GetGridType () const

virtual vector< double >	_GetTSXCoords (size_t ts) const

virtual vector< double >	_GetTSYCoords (size_t ts) const

virtual vector< double >	_GetTSZCoords (size_t ts) const

virtual string	_GetMapProjection () const

virtual vector< string >	_GetCoordinateVariables () const

virtual bool	_GetMissingValue (string varname, float &value) const

Protected Member Functions inherited from VetsUtil::MyBase
void	SetClassName (const string &name)

Protected Member Functions inherited from VAPoR::VDFIOBase
void	_ReadTimerReset ()

void	_ReadTimerStart ()

void	_ReadTimerStop ()

void	_WriteTimerReset ()

void	_WriteTimerStart ()

void	_WriteTimerStop ()

void	_XFormTimerReset ()

void	_XFormTimerStart ()

void	_XFormTimerStop ()

int	_MaskOpenWrite (size_t timestep, string varname, int reflevel)

int	_MaskOpenRead (size_t timestep, string varname, int reflevel)

int	_MaskClose ()

int	_MaskWrite (const float *srcblk, const size_t bmin_p[3], const size_t bmax_p[3], bool block)

int	_MaskRead (const size_t bmin_p[3], const size_t bmax_p[3])

void	_MaskRemove (float *blk, bool &valid_data) const

void	_MaskReplace (size_t bx, size_t by, size_t bz, float *blk) const

Additional Inherited Members
Public Types inherited from VAPoR::DataMgr
enum	VarType_T { VARUNKNOWN = -1, VAR3D, VAR2D_XY, VAR2D_XZ, VAR2D_YZ }

Public Types inherited from VetsUtil::MyBase
typedef void(*	ErrMsgCB_T) (const char *msg, int err_code)

typedef void(*	DiagMsgCB_T) (const char *msg)

Public Types inherited from VAPoR::Metadata
enum	VarType_T { VARUNKNOWN = -1, VAR3D, VAR2D_XY, VAR2D_XZ, VAR2D_YZ }

Static Public Member Functions inherited from VetsUtil::MyBase
static void	SetErrMsg (const char *format,...)
	Record a formatted error message. More...

static void	SetErrMsg (int errcode, const char *format,...)
	Record a formatted error message and an error code. More...

static const char *	GetErrMsg ()

static void	SetErrCode (int err_code)
	Record an error code. More...

static int	GetErrCode ()
	Retrieve the current error code. More...

static void	SetErrMsgCB (ErrMsgCB_T cb)

static ErrMsgCB_T	GetErrMsgCB ()

static void	SetErrMsgFilePtr (FILE *fp)

static const FILE *	SetErrMsgFilePtr ()

static void	SetDiagMsg (const char *format,...)
	Record a formatted diagnostic message. More...

static const char *	GetDiagMsg ()

static void	SetDiagMsgCB (DiagMsgCB_T cb)

static DiagMsgCB_T	GetDiagMsgCB ()

static void	SetDiagMsgFilePtr (FILE *fp)

static bool	EnableErrMsg (bool enable)

Public Attributes inherited from VAPoR::ParsedXml
ParsedXml *	previousClass

Static Public Attributes inherited from VetsUtil::MyBase
static char *	ErrMsg

static int	ErrCode

static int	ErrMsgSize

static FILE *	ErrMsgFilePtr

static ErrMsgCB_T	ErrMsgCB

static char *	DiagMsg

static int	DiagMsgSize

static FILE *	DiagMsgFilePtr

static DiagMsgCB_T	DiagMsgCB

static bool	Enabled

Static Protected Member Functions inherited from VAPoR::VDFIOBase
static void	_UnpackCoord (VarType_T vtype, const size_t src[3], size_t dst[3], size_t fill)

static void	_PackCoord (VarType_T vtype, const size_t src[3], size_t dst[3], size_t fill)

static void	_FillPackedCoord (VarType_T vtype, const size_t src[3], size_t dst[3], size_t fill)

Protected Attributes inherited from VAPoR::DataMgr
const vector< string >	emptyVec

Protected Attributes inherited from VAPoR::Metadata
bool	_deprecated_get_dim

Static Protected Attributes inherited from VAPoR::ParsedXml
static const string	_stringType

static const string	_longType

static const string	_doubleType

static const string	_typeAttr

Detailed Description

A cache based data reader.

Author: John Clyne

Version: $Revision$

Date: $Date$

Definition at line 25 of file DataMgrAMR.h.

Constructor & Destructor Documentation

VAPoR::DataMgrAMR::DataMgrAMR	(	const string &	metafile,
		size_t	mem_size
	)

VAPoR::DataMgrAMR::DataMgrAMR	(	const MetadataVDC &	metadata,
		size_t	mem_size
	)

virtual VAPoR::DataMgrAMR::~DataMgrAMR ( )

inlinevirtual

Definition at line 40 of file DataMgrAMR.h.

Member Function Documentation

virtual int VAPoR::DataMgrAMR::_BlockReadRegion	(	const size_t	bmin[3],
		const size_t	bmax[3],
		float *	region
	)

protectedvirtual

Read in and return a subregion from the currently opened multiresolution data volume.

The dimensions of the region are provided in block coordinates. However, the returned region is not blocked.

Parameters

[in]	bmin	Minimum region extents in block coordinates
[in]	bmax	Maximum region extents in block coordinates
[out]	region	The requested volume subregion

Return values

status Returns a non-negative value on success

See also: _OpenVariableRead(), _GetBlockSize()

Implements VAPoR::DataMgr.

virtual int VAPoR::DataMgrAMR::_CloseVariable ( )

inlineprotectedvirtual

Close the currently opened variable.

See also: _OpenVariableRead()

Implements VAPoR::DataMgr.

Definition at line 132 of file DataMgrAMR.h.

References VAPoR::AMRIO::CloseVariable().

virtual void VAPoR::DataMgrAMR::_GetBlockSize	(	size_t	bs[3],
		int	reflevel
	)		const

inlineprotectedvirtual

Return the internal blocking factor at a given refinement level

For multi-resolution data this method returns the dimensions of a data block at refinement level reflevel, where reflevel is in the range 0 to GetNumTransforms(). A value of -1 may be specified to indicate the maximum refinement level. In fact, any value outside the valid refinement level range will be treated as the maximum refinement level.

Parameters

[in]	reflevel	Refinement level

Implements VAPoR::DataMgr.

Definition at line 52 of file DataMgrAMR.h.

virtual const float* VAPoR::DataMgrAMR::_GetDataRange ( ) const

inlineprotectedvirtual

Return the data range for the currently open variable

The method returns the minimum and maximum data values, respectively, for the variable currently opened. If the variable is not opened, or if it is opened for writing, the results are undefined.

Returns: range A pointer to a two-element array containing the Min and Max data values, respectively. If the derived class' implementation of this method returns NULL, the DataMgr class will compute the min and max itself.

Reimplemented from VAPoR::DataMgr.

Definition at line 123 of file DataMgrAMR.h.

References VAPoR::AMRIO::GetDataRange().

virtual void VAPoR::DataMgrAMR::_GetDim	(	size_t	dim[3],
		int	reflevel
	)		const

inlineprotectedvirtual

Get the dimension of a volume

Returns the X,Y,Z coordinate dimensions of all data variables in grid (voxel) coordinates at the resolution level indicated by reflevel. Hence, all variables of a given type (3D or 2D) must have the same dimension. If reflevel is -1 (or the value returned by GetNumTransforms()) the native grid resolution is returned. In fact, any value outside the valid range is treated as the maximum refinement level

Parameters

[in]	reflevel	Refinement level of the variable
[out]	dim	A three element vector (ordered X, Y, Z) containing the voxel dimensions of the data at the specified resolution.

See also: GetNumTransforms()

Implements VAPoR::DataMgr.

Definition at line 48 of file DataMgrAMR.h.

References VAPoR::Metadata::GetDim().

virtual vector<double> VAPoR::DataMgrAMR::_GetExtents ( size_t ts = 0 ) const

inlineprotectedvirtual

Return the domain extents specified in user coordinates

Return the domain extents specified in user coordinates for the indicated time step. Variables in the data have spatial positions defined in a user coordinate system. These positions may vary with time. This method returns min and max bounds, in user coordinates, of all variables at a given time step.

Parameters

[in] ts A valid data set time step in the range from zero to GetNumTimeSteps() - 1. If ts is out of range, GetExtents() will return a reasonable default value.

Return values

extents A six-element array containing the min and max bounds of the data domain in user-defined coordinates. The first three elements specify the minimum X, Y, and Z bounds, respectively, the second three elements specify the maximum bounds.

Implements VAPoR::DataMgr.

Definition at line 60 of file DataMgrAMR.h.

References VAPoR::MetadataVDC::GetExtents().

virtual vector<long> VAPoR::DataMgrAMR::_GetGridPermutation ( ) const

inlineprotectedvirtual

Return a three-element integer array indicating the coordinate ordering permutation.

Return values

integer-vector

Reimplemented from VAPoR::DataMgr.

Definition at line 86 of file DataMgrAMR.h.

References VAPoR::MetadataVDC::GetGridPermutation().

virtual long VAPoR::DataMgrAMR::_GetNumTimeSteps ( ) const

inlineprotectedvirtual

Return the number of time steps in the data collection

Return values

value The number of time steps

Implements VAPoR::DataMgr.

Definition at line 64 of file DataMgrAMR.h.

References VAPoR::MetadataVDC::GetNumTimeSteps().

virtual int VAPoR::DataMgrAMR::_GetNumTransforms ( ) const

inlineprotectedvirtual

Return number of transformations in hierarchy

For multi-resolution data this method returns the number of coarsened approximations present. If no approximations are available - if only the native data are present - the return value is 0.

Return values

n	The number of coarsened data approximations available

Implements VAPoR::DataMgr.

Definition at line 56 of file DataMgrAMR.h.

References VAPoR::MetadataVDC::GetNumTransforms().

virtual vector<long> VAPoR::DataMgrAMR::_GetPeriodicBoundary ( ) const

inlineprotectedvirtual

Return a three-element boolean array indicating if the X,Y,Z axes have periodic boundaries, respectively.

Return values

boolean-vector

Implements VAPoR::DataMgr.

Definition at line 82 of file DataMgrAMR.h.

References VAPoR::MetadataVDC::GetPeriodicBoundary().

virtual double VAPoR::DataMgrAMR::_GetTSUserTime ( size_t ts ) const

inlineprotectedvirtual

Return the time for a time step

This method returns the time, in user-defined coordinates, associated with the time step, ts. Variables such as velocity field components that are expressed in distance per units of time are expected to use the same time coordinates as the values returned by this mehtod.

Parameters

[in] ts A valid data set time step in the range from zero to GetNumTimeSteps() - 1.

Return values

value The user time at time step ts. If ts is outside the valid range zero is returned.

Implements VAPoR::DataMgr.

Definition at line 90 of file DataMgrAMR.h.

References VAPoR::MetadataVDC::GetTSUserTime().

virtual void VAPoR::DataMgrAMR::_GetTSUserTimeStamp	(	size_t	ts,
		string &	s
	)		const

inlineprotectedvirtual

Return the time for a time step

This method returns the user time, associated with the time step, ts, as a formatted string. The returned time stamp is intended to be used for annotation purposes

Parameters

[in]	ts	A valid data set time step in the range from zero to GetNumTimeSteps() - 1.
[out]	s	A formated time string. If `ts` is outside the valid range zero the empty string is returned.

Implements VAPoR::DataMgr.

Definition at line 94 of file DataMgrAMR.h.

References VAPoR::MetadataVDC::GetTSUserTimeStamp().

virtual void VAPoR::DataMgrAMR::_GetValidRegion	(	size_t	min[3],
		size_t	max[3],
		int	reflevel
	)		const

inlineprotectedvirtual

Return the valid bounds of the currently opened region

The data model permits the storage of volume subregions. This method may be used to query the valid domain of the currently opened volume. Results are returned in voxel coordinates, relative to the refinement level indicated by reflevel.

Parameters

[out]	min	A pointer to the minimum bounds of the subvolume
[out]	max	A pointer to the maximum bounds of the subvolume
[in]	reflevel	Refinement level of the variable. A value of -1 indicates the maximum refinment level defined for the VDC

Return values

status Returns a negative value if the volume is not opened for reading.

See also: _OpenVariableRead()

Implements VAPoR::DataMgr.

Definition at line 115 of file DataMgrAMR.h.

References VAPoR::AMRIO::GetValidRegion().

virtual vector<string> VAPoR::DataMgrAMR::_GetVariables2DXY ( ) const

inlineprotectedvirtual

Return the names of the 2D, XY variables in the collection

Return values

value is a space-separated list of 2D XY variable names An emptry string is returned if no variables of this type are present

Implements VAPoR::DataMgr.

Definition at line 72 of file DataMgrAMR.h.

References VAPoR::MetadataVDC::GetVariables2DXY().

virtual vector<string> VAPoR::DataMgrAMR::_GetVariables2DXZ ( ) const

inlineprotectedvirtual

Return the names of the 2D, XZ variables in the collection

Return values

value is a space-separated list of 2D ZY variable names An emptry string is returned if no variables of this type are present

Implements VAPoR::DataMgr.

Definition at line 75 of file DataMgrAMR.h.

References VAPoR::MetadataVDC::GetVariables2DXZ().

virtual vector<string> VAPoR::DataMgrAMR::_GetVariables2DYZ ( ) const

inlineprotectedvirtual

Return the names of the 2D, YZ variables in the collection

Return values

value is a space-separated list of 2D YZ variable names An emptry string is returned if no variables of this type are present

Implements VAPoR::DataMgr.

Definition at line 78 of file DataMgrAMR.h.

References VAPoR::MetadataVDC::GetVariables2DYZ().

virtual vector<string> VAPoR::DataMgrAMR::_GetVariables3D ( ) const

inlineprotectedvirtual

Return values

value is a space-separated list of 3D variable names. An emptry string is returned if no variables of this type are present

Implements VAPoR::DataMgr.

Definition at line 68 of file DataMgrAMR.h.

References VAPoR::MetadataVDC::GetVariables3D().

virtual int VAPoR::DataMgrAMR::_OpenVariableRead	(	size_t	timestep,
		const char *	varname,
		int	reflevel = `0`,
		int	lod = `0`
	)

protectedvirtual

Open the named variable for reading

This method prepares the multi-resolution, multi-lod data volume, indicated by a variable name and time step pair, for subsequent read operations by methods of this class. Furthermore, the number of the refinement level parameter, reflevel indicates the resolution of the volume in the multiresolution hierarchy, and the lod parameter indicates the level of detail.

The valid range of values for reflevel is [0..max_refinement], where max_refinement is the maximum finement level of the data set: GetNumTransforms(). A value of zero indicates the coarsest resolution data, a value of max_refinement indicates the finest resolution data.

The valid range of values for lod is [0..max_lod], where max_lod is the maximum lod of the data set: GetCRatios().size() - 1. A value of zero indicates the highest compression ratio, a value of max_lod indicates the lowest compression ratio.

An error occurs, indicated by a negative return value, if the volume identified by the {varname, timestep, reflevel, lod} tupple is not present on disk. Note the presence of a volume can be tested for with the VariableExists() method.

Parameters

[in]	timestep	Time step of the variable to read
[in]	varname	Name of the variable to read
[in]	reflevel	Refinement level of the variable. A value of -1 indicates the maximum refinment level defined for the VDC
[in]	lod	Level of detail requested. A value of -1 indicates the lowest compression level available for the VDC

See also: GetVariables3D(), GetVariables2DXY(), GetNumTransforms()

Implements VAPoR::DataMgr.

virtual int VAPoR::DataMgrAMR::_VariableExists	(	size_t	ts,
		const char *	varname,
		int	reflevel = `0`,
		int	lod = `0`
	)		const

inlineprotectedvirtual

Returns true if indicated data volume is available

Returns true if the variable identified by the timestep, variable name, refinement level, and level-of-detail is present in the data set. Returns 0 if the variable is not present.

Parameters

[in]	ts	A valid time step between 0 and GetNumTimesteps()-1
[in]	varname	A valid variable name
[in]	reflevel	Refinement level requested. The coarsest refinement level is 0 (zero). A value of -1 indicates the finest refinement level contained in the VDC.
[in]	lod	Compression level of detail requested. The coarsest approximation level is 0 (zero). A value of -1 indicates the finest refinement level contained in the VDC.

Implements VAPoR::DataMgr.

Definition at line 99 of file DataMgrAMR.h.

References VAPoR::AMRIO::VariableExists().

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

/Users/clyne/src/vapor/lib/vdf/DataMgrAMR.h

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation