Functions
def	MapVoxToUser (voxcoord, refinementLevel, lod)

def	MapUserToVox (userCoord, refinementLevel, lod)

def	GetValidRegionMax (timestep, variableName, refinementLevel)

def	GetValidRegionMin (timestep, variableName, refinementLevel)

def	Get3DVariable (timestep, variableName, refinement, lod, bounds)

def	Get2DVariable (timestep, variableName, refinement, lod, bounds)

def	VariableExists (timestep, varname, refinement, lod)

def	Get3DMask (timestep, varname, refinement, lod, bounds)

def	Get2DMask (timestep, varname, refinement, lod, bounds)

Detailed Description

The vapor module is internal to vaporgui, so its methods and variables can only be accessed in the python scripts used to calculate derived variables inside vaporgui.  
This module includes the following methods:
vapor.MapVoxToUser - map voxel coordinates to user coordinates
vapor.MapUserToVox - map user coordinates to voxel coordinates
vapor.GetValidRegionMax - determine maximum valid voxel coordinates of a variable
vapor.GetValidRegionMin - determine minimum valid voxel coordinates of a variable
vapor.Get3DVariable - Obtain a 3 dimensional array of variable data from the VDC
vapor.Get2DVariable - Obtain a 2 dimensional array of variable data from the VDC
vapor.VariableExists - Determine whether a specified variable exists at a timestep
vapor.Get3DMask - Obtain a 3D mask variable indicating where a variable is not equal to its missing value
vapor.Get2DMask - Obtain a 2D mask variable indicating where a variable is not equal to its missing value.

This module also includes the following variables
vapor.TIMESTEP - The integer time step of the output variable(s) being calculated.
vapor.REFINEMENT - the integer refinement level of the output variable(s) being calculated. 
vapor.LOD - The integer level-of-detail (compression level) of the output variable(s) being calculated.
vapor.BOUNDS - The integer 6-tuple specifying the integer extents of the Z, Y, and X coordinates 
of the variable being calculated, inside the full 3D domain of the current VDC.

Function Documentation

◆ Get2DMask()

def vapor.Get2DMask	(	timestep,
		varname,
		refinement,
		lod,
		bounds
	)

Obtain the boolean 2D mask associated with a 2D variable at a timestep, 
with specified refinement, lod, and bounds. Arguments are:
timestep (integer time step)
varname (string variable name)
refinement (integer refinement level)
lod (integer compression level)
bounds (6-tuple integer extents identifying the location of the data in the full domain, 
as with vapor.BOUNDS.  The first and fourth entry are ignored.
Returns:  a 2-dimensional boolean array, which is the requested mask.

Definition at line 89 of file vapor.py.

◆ Get2DVariable()

def vapor.Get2DVariable	(	timestep,
		variableName,
		refinement,
		lod,
		bounds
	)

Obtain a 2-dimensional array of variable data from the VDC, using:
timestep (integer time step)
variableName (the variable name, a string)
refinement (integer refinement level)
lod (integer compression level)
bounds (6-tuple integer extents identifying the location of the data in the full domain, 
as with vapor.BOUNDS, however the first and fourth element of this tuple are ignored. 
Returns a 2-dimensional float32 array of variable values.

Definition at line 62 of file vapor.py.

◆ Get3DMask()

def vapor.Get3DMask	(	timestep,
		varname,
		refinement,
		lod,
		bounds
	)

Obtain the boolean 3D mask associated with a 3D variable at a timestep, with specified refinement, lod, and bounds. Arguments are:
timestep (integer time step)
varname (string variable name)
refinement (integer refinement level)
lod (integer compression level)
bounds (6-tuple integer extents identifying the location of the data in the full domain, as with vapor.BOUNDS.
Returns:  a 3-dimensional boolean array, which is the requested mask.

Definition at line 80 of file vapor.py.

◆ Get3DVariable()

def vapor.Get3DVariable	(	timestep,
		variableName,
		refinement,
		lod,
		bounds
	)

Obtain a 3-dimensional array of variable data from the VDC, using:
timestep (integer time step)
variableName (the variable name, a string)
refinement (integer refinement level)
lod (integer compression level)
bounds (6-tuple integer extents identifying the location of the data in the full domain, 
as with vapor.BOUNDS. 
Returns a 3-dimensional float32 array of variable values.

Definition at line 52 of file vapor.py.

◆ GetValidRegionMax()

def vapor.GetValidRegionMax	(	timestep,
		variableName,
		refinementLevel
	)

Determine the maximum voxel coordinates of a variable at a timestep and refinement level.
Calling sequence: maxCoord = vapor.GetValidRegionMax(timestep,variableName,refinementLevel)
Where: timestep is an integer time step in the VDC.
variableName is a string variable name in the VDC
refinementLevel is an integer refinement level in the VDC
returns maxCoord, an integer 3-tuple, the maximum coordinates of the variable at the timestep and refinement level.

Definition at line 36 of file vapor.py.

◆ GetValidRegionMin()

def vapor.GetValidRegionMin	(	timestep,
		variableName,
		refinementLevel
	)

Determine the minimum voxel coordinates of a variable at a timestep and refinement level.
Calling sequence: minCoord = vapor.GetValidRegionMin(timestep,variableName,refinementLevel)
Where: timestep is an integer time step in the VDC.
variableName is a string variable name in the VDC
refinementLevel is an integer refinement level in the VDC
returns minCoord, an integer 3-tuple, the minimum coordinates of the variable at the timestep and refinement level.

Definition at line 44 of file vapor.py.

◆ MapUserToVox()

def vapor.MapUserToVox	(	userCoord,
		refinementLevel,
		lod
	)

Convert user coordinates to voxel coordinates, at a given refinement level and level of detail.
Calling sequence: voxCoord = MapUserToVox(userCoord, refLevel [,lod]) 
Where: userCoord is a float3 3-tuple indicating user coordinates to convert.
refLevel is the integer refinement level
lod (optional, defaults to 0) is the integer compression level 
Result voxCoord is the returned integer 3-tuple of voxel coordinates.

Definition at line 28 of file vapor.py.

◆ MapVoxToUser()

def vapor.MapVoxToUser	(	voxcoord,
		refinementLevel,
		lod
	)

Convert voxel coordinates to user coordinates, at a given refinement level and level of detail.
Calling sequence: userCoord = MapVoxToUser(voxcoord, refLevel ,lod) 
Where: voxcoord is an integer 3-tuple indicating voxel coordinates to convert.
refLevel is the integer refinement level
lod (optional, defaults to 0) is the integer compression level 
Result userCoord is the returned float32 3-tuple of user coordinates.

Definition at line 20 of file vapor.py.

Referenced by vapor_utils.curl_findiff(), vapor_utils.div_findiff(), vapor_utils.grad_findiff(), vapor_wrf.wrf_curl_findiff(), and vapor_wrf.wrf_deriv_findiff().

◆ VariableExists()

def vapor.VariableExists	(	timestep,
		varname,
		refinement,
		lod
	)

Determine if a variable is present in the VDC at specified timestep, refinement, and lod.  Arguments are:
timestep (integer time step)
varname (the variable name, a string)
refinement (integer refinement level, optional, defaults to 0)
lod (integer compression level, optional, defaults to 0)
Returns: boolean value, true if the variable exists.

Definition at line 72 of file vapor.py.

Referenced by vapor_wrf.CTHGT(), vapor_wrf.CTT(), and vapor_wrf.DBZ().

Functions