Skip to content
Symi Docs
Python
On this page

Elementary functions

Elementary functions simplify when their arguments provide enough exact information.

All routed through the auto-simplifying builders, so the result is in canonical ASAE form (e.g. sqrt(x) is stored as x^(1/2), known special values collapse).

sin#

Default context

sin(x: Any) -> Expression
Calling forms

Explicit context: Context.sin

sin(x: Any) -> Expression

cos#

Default context

cos(x: Any) -> Expression
Calling forms

Explicit context: Context.cos

cos(x: Any) -> Expression

tan#

Default context

tan(x: Any) -> Expression
Calling forms

Explicit context: Context.tan

tan(x: Any) -> Expression

sec#

Default context

sec(x: Any) -> Expression
Calling forms

Explicit context: Context.sec

sec(x: Any) -> Expression

csc#

Default context

csc(x: Any) -> Expression
Calling forms

Explicit context: Context.csc

csc(x: Any) -> Expression

cot#

Default context

cot(x: Any) -> Expression
Calling forms

Explicit context: Context.cot

cot(x: Any) -> Expression

arcsin#

Default context

arcsin(x: Any) -> Expression
Calling forms

Explicit context: Context.arcsin

arcsin(x: Any) -> Expression

arccos#

Default context

arccos(x: Any) -> Expression
Calling forms

Explicit context: Context.arccos

arccos(x: Any) -> Expression

arctan#

Default context

arctan(x: Any) -> Expression
Calling forms

Explicit context: Context.arctan

arctan(x: Any) -> Expression

arcsec#

Default context

arcsec(x: Any) -> Expression
Calling forms

Explicit context: Context.arcsec

arcsec(x: Any) -> Expression

arccsc#

Default context

arccsc(x: Any) -> Expression
Calling forms

Explicit context: Context.arccsc

arccsc(x: Any) -> Expression

arccot#

Default context

arccot(x: Any) -> Expression
Calling forms

Explicit context: Context.arccot

arccot(x: Any) -> Expression

The principal value is arctan(1/x), with arccot(0) = pi/2. Over the reals it lies in (-pi/2, 0) for negative x and in (0, pi/2] otherwise, so it jumps at zero; in the complex plane its branch cut is the closed segment of the imaginary axis from -i to i.

sinh#

Default context

sinh(x: Any) -> Expression
Calling forms

Explicit context: Context.sinh

sinh(x: Any) -> Expression

cosh#

Default context

cosh(x: Any) -> Expression
Calling forms

Explicit context: Context.cosh

cosh(x: Any) -> Expression

tanh#

Default context

tanh(x: Any) -> Expression
Calling forms

Explicit context: Context.tanh

tanh(x: Any) -> Expression

sech#

Default context

sech(x: Any) -> Expression
Calling forms

Explicit context: Context.sech

sech(x: Any) -> Expression

csch#

Default context

csch(x: Any) -> Expression
Calling forms

Explicit context: Context.csch

csch(x: Any) -> Expression

coth#

Default context

coth(x: Any) -> Expression
Calling forms

Explicit context: Context.coth

coth(x: Any) -> Expression

arcsinh#

Default context

arcsinh(x: Any) -> Expression
Calling forms

Explicit context: Context.arcsinh

arcsinh(x: Any) -> Expression

arccosh#

Default context

arccosh(x: Any) -> Expression
Calling forms

Explicit context: Context.arccosh

arccosh(x: Any) -> Expression

arctanh#

Default context

arctanh(x: Any) -> Expression
Calling forms

Explicit context: Context.arctanh

arctanh(x: Any) -> Expression

arcsech#

Default context

arcsech(x: Any) -> Expression
Calling forms

Explicit context: Context.arcsech

arcsech(x: Any) -> Expression

arccsch#

Default context

arccsch(x: Any) -> Expression
Calling forms

Explicit context: Context.arccsch

arccsch(x: Any) -> Expression

arccoth#

Default context

arccoth(x: Any) -> Expression
Calling forms

Explicit context: Context.arccoth

arccoth(x: Any) -> Expression

exp#

Default context

exp(x: Any) -> Expression
Calling forms

Explicit context: Context.exp

exp(x: Any) -> Expression

The natural exponential.

log#

Default context

log(x: Any, base: Optional[Any] = None) -> Expression
Calling forms

Explicit context: Context.log

log(x: Any, base: Optional[Any] = None) -> Expression

Natural logarithm; with base given, log(x)/log(base).

sqrt#

Default context

sqrt(x: Any) -> Expression
Calling forms

Explicit context: Context.sqrt

sqrt(x: Any) -> Expression

Principal square root, stored as x^(1/2).

root#

Default context

root(x: Any, n: Any) -> Expression
Calling forms

Explicit context: Context.root

root(x: Any, n: Any) -> Expression

Principal n-th root, stored as x^(1/n).

abs#

Default context

abs(x: Any) -> Expression
Calling forms

Explicit context: Context.abs

abs(x: Any) -> Expression

The absolute value. It folds to x or -x whenever the sign of x is decided by the exact real order procedure — the same decided class evaluate_truth reports on — so abs(sqrt(5) - 2) becomes sqrt(5) - 2 rather than staying wrapped. A sign the procedure cannot prove leaves the call symbolic; signum folds on exactly the same reach.

floor#

Default context

floor(x: Any) -> Expression
Calling forms

Explicit context: Context.floor

floor(x: Any) -> Expression

ceiling#

Default context

ceiling(x: Any) -> Expression
Calling forms

Explicit context: Context.ceiling

ceiling(x: Any) -> Expression

conjugate#

Default context

conjugate(x: Any) -> Expression
Calling forms

Explicit context: Context.conjugate

conjugate(x: Any) -> Expression

Complex conjugate.

factorial#

Default context

factorial(x: Any) -> Expression
Calling forms

Explicit context: Context.factorial

factorial(x: Any) -> Expression

binomial#

Default context

binomial(n: Any, k: Any) -> Expression
Calling forms

Explicit context: Context.binomial

binomial(n: Any, k: Any) -> Expression

Binomial coefficient C(n, k).

min#

Default context

min(*arguments: Any) -> Expression
Calling forms

Explicit context: Context.min

min(*arguments: Any) -> Expression

Minimum of the arguments (variadic in Python; a JS array in WASM).

max#

Default context

max(*arguments: Any) -> Expression
Calling forms

Explicit context: Context.max

max(*arguments: Any) -> Expression

Maximum of the arguments (variadic in Python; a JS array in WASM).

Example#

Elementary functions evaluate exactly at recognised arguments and stay symbolic elsewhere.

Python
import symi

x = symi.symbol("x")

print(symi.sin(symi.pi / 6))
print(symi.exp(0))
print(symi.sqrt(18))
print(symi.log(symi.exp(x)))
print(symi.cos(x) ** 2 + symi.sin(x) ** 2)

absolute_value#

Not exposed by the Python bindings. Available as Context.absoluteValue in WASM / JavaScript, UniffiExpression.absoluteValue in Kotlin, UniffiExpression.absoluteValue in Swift, api::Expression::absolute_value in Rust.

The absolute value ∣x∣|x|, spelled in full. It is the same operation as abs; the two names exist because abs is the spelling the Python and JavaScript hosts use for their own built-in, and the full name is the spelling the mobile hosts generate.

Symi documentation · Python