Vector calculus
Coordinates are passed as a list of variable names; vector fields as a list of component expressions in the same order. Empty variable lists and component/variable count mismatches raise.
gradient#
Default context
gradient(
scalar_field: ExpressionLike,
variables: Iterable[VariableLike],
) -> list[Expression]Calling forms
Explicit context: Context.gradient
gradient(
scalar_field: ExpressionLike,
variables: Iterable[VariableLike],
) -> list[Expression]: the partial derivatives in the order of variables.
divergence#
Default context
divergence(
vector_components: Iterable[ExpressionLike],
variables: Iterable[VariableLike],
) -> ExpressionCalling forms
Explicit context: Context.divergence
divergence(
vector_components: Iterable[ExpressionLike],
variables: Iterable[VariableLike],
) -> Expression; component and variable counts must match.
curl#
Default context
curl(
vector_components: Iterable[ExpressionLike],
variables: Iterable[VariableLike],
) -> list[Expression]Calling forms
Explicit context: Context.curl
curl(
vector_components: Iterable[ExpressionLike],
variables: Iterable[VariableLike],
) -> list[Expression]. Requires exactly three components and three variables; other dimensions raise.
laplacian#
Default context
laplacian(
scalar_field: ExpressionLike,
variables: Iterable[VariableLike],
) -> ExpressionCalling forms
Explicit context: Context.laplacian
laplacian(
scalar_field: ExpressionLike,
variables: Iterable[VariableLike],
) -> Expression.
jacobian#
Default context
jacobian(
vector_components: Iterable[ExpressionLike],
variables: Iterable[VariableLike],
) -> MatrixCalling forms
Explicit context: Context.jacobian
jacobian(
vector_components: Iterable[ExpressionLike],
variables: Iterable[VariableLike],
) -> MatrixThe matrix with entry (rows index components, columns index
variables). Returned as a Matrix so the result composes with the matrix
methods.
hessian#
Default context
hessian(
scalar_field: ExpressionLike,
variables: Iterable[VariableLike],
) -> MatrixCalling forms
Explicit context: Context.hessian
hessian(
scalar_field: ExpressionLike,
variables: Iterable[VariableLike],
) -> MatrixThe matrix of second partials, computed as the Jacobian of the gradient; structurally symmetric on smooth input.
Example#
Differential operators over an ordered coordinate list.
import symi
x = symi.symbol("x")
y = symi.symbol("y")
z = symi.symbol("z")
print(symi.gradient(x**2 * y, ["x", "y"]))
print(symi.divergence([x, y, z], ["x", "y", "z"]))
print(symi.curl([y, -x, 0], ["x", "y", "z"]))
print(symi.laplacian(x**2 + y**2, ["x", "y"]))