Skip to content
Symi Docs
Python
On this page

Series and residues

taylor_series#

Default context

taylor_series(
    input_expression: ExpressionLike,
    variable: VariableLike,
    expansion_point: ExpressionLike,
    order: int,
) -> Expression
Calling forms and variants

Explicit context: Context.taylor_series

taylor_series(
    input_expression: ExpressionLike,
    variable: VariableLike,
    expansion_point: ExpressionLike,
    order: int,
) -> Expression

Expression method: Expression.taylor_series

taylor_series(
    variable: VariableLike,
    expansion_point: ExpressionLike,
    order: int,
) -> Expression

Variant using local assumptions — AssumptionScope method: AssumptionScope.taylor_series

taylor_series(
    input_expression: ExpressionLike,
    variable: VariableLike,
    expansion_point: ExpressionLike,
    truncation_order: int,
) -> Expression

Truncated Taylor expansion about expansion_point, keeping terms of degree strictly less than order (the remainder is O((x−a)order⁡)O((x-a)^{\operatorname{order}}). Returns the truncated polynomial, not a series object; order = 0 returns zero. Coefficients are computed exactly by repeated symbolic differentiation.

maclaurin_series#

Default context

maclaurin_series(
    input_expression: ExpressionLike,
    variable: VariableLike,
    order: int,
) -> Expression
Calling forms

Explicit context: Context.maclaurin_series

maclaurin_series(
    input_expression: ExpressionLike,
    variable: VariableLike,
    order: int,
) -> Expression

Expression method: Expression.maclaurin_series

maclaurin_series(variable: VariableLike, order: int) -> Expression

taylor_series specialised to expansion point 0.

laurent_series#

Default context

laurent_series(
    input_expression: ExpressionLike,
    variable: VariableLike,
    center: ExpressionLike,
    order: int,
) -> Expression
Calling forms

Explicit context: Context.laurent_series

laurent_series(
    input_expression: ExpressionLike,
    variable: VariableLike,
    center: ExpressionLike,
    order: int,
) -> Expression

Expression method: Expression.laurent_series

laurent_series(
    variable: VariableLike,
    center: ExpressionLike,
    order: int,
) -> Expression

Truncated Laurent expansion at center: every (variable⁡−center⁡)k(\operatorname{variable} - \operatorname{center})^k term with −m≤k<order⁡-m \le k < \operatorname{order}, where m is the pole order. Analytic points degrade to the Taylor expansion. At an essential singularity (where pole_order declines) the result is an unevaluated series_unevaluated(...) placeholder, because no finite truncation of the principal part is correct.

residue#

Default context

residue(
    input_expression: ExpressionLike,
    variable: Any,
    center: Any,
) -> Expression
Calling forms

Explicit context: Context.residue

residue(
    input_expression: ExpressionLike,
    variable: Any,
    center: Any,
) -> Expression

Expression method: Expression.residue

residue(variable: Any, center: Any) -> Expression

Coefficient of (variable⁡−center⁡)−1(\operatorname{variable} - \operatorname{center})^{-1} in the Laurent expansion at center. Analytic/removable points give 0; simple poles use the limit of (x−c)f(x - c) f; higher poles use the derivative formula. Essential singularities return an unevaluated residue_unevaluated(...) placeholder. Rational functions use exact polynomial valuations and formal series division, so explicit algebraic centers do not need to occur as structural factors.

pole_order#

Default context

pole_order(
    input_expression: ExpressionLike,
    variable: VariableLike,
    center: ExpressionLike,
) -> Optional[int]
Calling forms

Explicit context: Context.pole_order

pole_order(
    input_expression: ExpressionLike,
    variable: VariableLike,
    center: ExpressionLike,
) -> Optional[int]

Expression method: Expression.pole_order

pole_order(
    variable: VariableLike,
    center: ExpressionLike,
) -> Optional[int]

Order of the singularity at center: 0 for analytic/removable points, m≥1m \ge 1 for a pole of order mm. Returns None (undefined in JS) when no order ≤16\leq 16 can be certified — the essential-singularity / undecidable verdict. Notes: this is the one series entry returning a plain integer, mirroring the core classifier; it never returns an unevaluated form. For a rational function at an exact algebraic center, the order is obtained from the square-free multiplicities of its numerator and denominator.

Example#

Series expansion, residues, and closed-form summation.

Python
import symi

x = symi.symbol("x")
k = symi.symbol("k", integer=True)
n = symi.symbol("n", integer=True)

print(symi.taylor_series(symi.exp(x), "x", 0, 4))
print(symi.residue(1 / (x**2 + 1), "x", symi.imaginary_unit))
print(symi.execute(symi.summation(k, "k", 0, n)))

Symi documentation · Python