Details
The vacuum Einstein field equations assert that the Einstein curvature tensor (or, more generally, the Einstein curvature tensor plus the metric tensor multiplied by a non-zero cosmological constant) vanishes identically. Since the Einstein curvature tensor is the trace reverse of the Ricci curvature tensor, the Einstein curvature tensor vanishes identically if and only if the Ricci curvature tensor vanishes identically.
In differential geometry, the significance of the vacuum Einstein field equations is that they can be used to characterize Einstein manifolds, i.e. Riemannian or pseudo-Riemannian manifolds for which the Ricci curvature tensor is proportional to the metric tensor. Einstein manifolds with zero cosmological constant are necessarily Ricci-flat (due to the above trace reverse relationship between the two curvature tensors).
In general relativity, the significance of the vacuum Einstein field equations is that, by the full Einstein field equations, the Einstein curvature tensor (plus the metric tensor multiplied by a potentially non-zero cosmological constant) vanishes identically if and only if the stress-energy tensor, and hence the matter-energy content of spacetime, vanishes identically. It is for this reason that such solutions are known as vacuum (or sometimes lambdavacuum, in the case of non-zero cosmological constant) solutions.
ResourceFunction["SolveVacuumEinsteinEquations"] assumes a non-zero cosmological constant (represented by the purely symbolic value "") by default, although this can be overridden as part of the second argument of the function.
ResourceFunction["SolveVacuumEinsteinEquations"] classifies all vacuum solutions as either exact (i.e. no additional assumptions required) or non-exact (i.e. some additional assumptions required), depending upon whether any additional field equations must be assumed in order for the given MetricTensor to constitute a valid solution to the vacuum Einstein field equations. Any such field equations (if they exist) can be computed using the property "FieldEquations".
ResourceFunction["SolveVacuumEinsteinEquations"] does not assume any particular number of dimensions, nor any particular metric convention, for the underlying manifold (although some properties, such as "LorentzianConditions", implicitly assume a (-,+,+,+,…) signature). ResourceFunction["SolveVacuumEinsteinEquations"] also does not require the metric to be strictly symmetric (i.e. spin and torsion connections are also supported), although the computation of the Einstein curvature tensor implicitly assumes the torsion-free Levi-Civita connection by default.
ResourceFunction["SolveVacuumEinsteinEquations"] implicitly keeps track of all known algebraic equivalences between tensor expressions, and can apply them for simplification purposes where necessary. Requesting the "ReducedEinsteinEquations" property has the effect of applying all known tensor equivalences and simplifying (note that this can have the effect of increasing computation time significantly).
By default, ResourceFunction["SolveVacuumEinsteinEquations"] evaluates all partial derivatives of the metric tensor automatically. In certain cases, however, these partial derivatives may be difficult or even impossible to compute, in which case the evaluation may not terminate in a reasonable time. Requesting the "SymbolicEinsteinEquations" property has the effect of leaving all partial derivatives unevaluated instead (note that this can have the effect of increasing expression length significantly).
If ResourceFunction["SolveVacuumEinsteinEquations"] succeeds in solving the vacuum Einstein field equations (or in proving that no such solution can exist), it will return a VacuumSolution expression.
Based on the eigenvalues of the matrix representation of the underlying metric tensor in covariant form, the underlying manifold will be classified by
ResourceFunction["SolveVacuumEinsteinEquations"] as either Riemannian (all eigenvalues positive or all eigenvalues negative), pseudo-Riemannian (some eigenvalues positive and some eigenvalues negative), Lorentzian (all eigenvalues positive except for one negative, or all eigenvalues negative except for one positive) or
Indeterminate.
The property "RiemannianConditions" returns the conditions necessary to guarantee that the eigenvalues of the matrix representation of the underlying metric tensor are strictly positive; "PseudoRiemannianConditions" returns the conditions necessary to guarantee that the eigenvalues of the matrix representation of the underlying metric tensor are all non-zero; "LorentzianConditions" returns the conditions necessary to guarantee that the eigenvalue corresponding to the {1,0,0,…} eigenvector of the underlying metric tensor (if it exists) is negative, with all other eigenvalues being positive. Note that this is strictly less general than the behavior of properties such as "RiemannianQ" (described in the point above), since it assumes certain features of the metric signature.
In VacuumSolution, the following properties are supported:
"FieldEquations" | list of any (additional) field equations that must be assumed in order for the metric to be a valid solution to the vacuum Einstein field equations |
"EinsteinEquations" | list of vacuum Einstein field equations asserting that the Einstein tensor (plus the metric tensor multiplied by the cosmological constant) is identically zero |
"ReducedEinsteinEquations" | list of vacuum Einstein field equations asserting that the Einstein tensor (plus the metric tensor multiplied by the cosmological constant) is identically zero, modulo all tensor equivalences |
"SymbolicEinsteinEquatons" | list of vacuum Einstein field equations asserting that the Einstein tensor (plus the metric tensor multiplied by the cosmological constant) is identically zero, with purely symbolic partial derivative operators |
"MetricTensor" | underlying metric tensor associated to the vacuum solution |
"Coordinates" | list of coordinate symbols for the vacuum solution |
"CoordinateOneForms" | list of differential 1-form symbols for the coordinates of the vacuum solution |
"SolutionQ" | whether the metric tensor is a valid solution to the vacuum Einstein field equations |
"ExactSolutionQ" | whether the metric tensor is a valid exact solution to the vacuum Einstein field equations (i.e. no additional field equations need to be assumed) |
"CosmologicalConstant" | value of the cosmological constant for the vacuum solution |
"Dimensions" | number of dimensions of the underlying manifold/spacetime described by the vacuum solution |
"Signature" | list of +1s and -1s designating the signature of the underlying manifold described by the vacuum solution (+1 for each positive eigenvalue of the metric, -1 for each negative eigenvalue of the metric) |
"RiemannianQ" | whether the underlying manifold described by the vacuum solution is Riemannian (i.e. all eigenvalues of the metric have the same sign) |
"PseudoRiemannianQ" | whether the underlying manifold described by the vacuum solution is pseudo-Riemannian (i.e. all eigenvalues of the metric are non-zero, but not all have the same sign) |
"LorentzianQ" | whether the underlying manifold described by the vacuum solution is Lorentzian (i.e. all eigenvalues of the metric have the same sign, except for one eigenvalue which has the opposite sign) |
"RiemannianConditions" | list of conditions required to guarantee that the underlying manifold described by the vacuum solution is Riemannian (i.e. all eigenvalues of the metric are positive) |
"PseudoRiemannianConditions" | list of conditions required to guarantee that the underlying manifold described by the vacuum solution is pseudo-Riemannian (i.e. all eigenvalues of the metric are non-zero) |
"LorentzianConditions" | list of conditions required to guarantee that the underlying manifold described by the vacuum solution is Lorentzian (i.e. the "time" eigenvalue of the metric is negative and all other eigenvalues are positive) |
"Properties" | list of properties |