getEnergyConditions
Description
The energy conditions are evaluated point-wise for all spacetime gridpoints of the stress-energy tensor. The function only evaluates the Null Energy Condition (NEC), Weak Energy Condition (WEC), Strong Energy Condition (SEC), and Dominant Energy Condition (DEC).
For more general background on the energy conditions, please read:
Method
The evaluation of the point-wise energy conditions samples a set of observer vector fields. The null vector is defined within a Cartesian locally-Minkowskian space. The direction of the spatial velocity is sampled from a set of vectors that map to evenly distributed points on a sphere, which, in a spherical coordinate representation, result in the set of four-velocities that map to different observers. The resulting vectors for each observer are then normalized. For timelike vectors, the four-velocity is defined in the same manner but is additionally scaled from 0 to 1 for a specified number of timelike samples for each of the spatial velocity direction samples. All vectors are then normalized.
Syntax
[
map
,
vec
,
vectorFieldOut
] = getEnergyConditions(
energyTensor
,
metric
,
condition
,
numAngularVec
,
numTimeVec
,
returnVec
,
tryGPU
)
Input Arguments
blue are required inputs.
orange are optional inputs with native default values.
energyTensor
struct
object
Input stress-energy tensor to determine energy conditions.
metric
struct
object
Input metric which determined the stress-energy tensor.
condition
1x1 array
string
The selected energy condition. Can be either "Null", "Weak", "Strong", or "Dominant".
numAngularVec
1x1 array
integer
The set number of even-spaced angular samples of four-velocity orientations. This sets the number of directions to sample.
numTimeVec
1x1 array
integer
The set number of time samples. This evenly reduces the magnitude of the four-velocity spatial part in the given sample number. The default value is 10.
returnVec
1x1 array
integer
Return the vectors and each of their respective energy condition evaluation results. The default value is 0.
tryGPU
1x1 array
integer
Use the GPU for evaluations, input either 1 for true or 0 for false. The default value is 0.
Output Arguments
map
4D array
double
Returned energy condition at each spacetime grid point. The array format is specified as:
vec
6D array
double
The energy condition evaluation for each of the sampled vectors at each spacetime grid point. The array format is specified as:
This is only returned if returnVec
is not 0.
vectorFieldOut
3D or 4D array
double
The set of observer 4-vectors that are used to sample the energy conditions at each point in spacetime. If the energy condition requires a null vector field then the return is a 3D array specified as:
This is only returned if returnVec
is not 0.
Last updated