Skip to content
Symi Docs
WASM / JavaScript

Signatures in the WASM / JavaScript view are TypeScript. Where the JavaScript facade wraps an operation its form is listed first; the other calling forms are the raw wasm-bindgen exports.

On this page

Partial differential equations

A partial differential equation relates an unknown function of several variables to its partial derivatives. Everything on this page starts from a PartialDifferentialEquationProblem: a validated signature that fixes the equation, the dependent function, the ordered independent variables, and any initial or boundary data. Constructing the problem is a separate step from solving it, so that a malformed equation is rejected once, at construction, rather than reappearing as a strange answer from a solver.

The unknown and its derivatives are written with undefined functions.

The records these entries return — problems, classifications, principal parts, transformations, symmetry algebras, solution families, and verification reports — are documented together in Partial differential equation results.

Constructing a problem#

partial_differential_equation#

Raw WebAssembly: Default context

partialDifferentialEquation(
    equation: Expression,
    dependent_function: UndefinedFunction,
    independent_variables: string[],
    initial_conditions?: Expression[] | null,
    boundary_conditions?: Expression[] | null,
): PartialDifferentialEquationProblem
Calling forms

Raw WebAssembly: Explicit context: Context.partialDifferentialEquation

partialDifferentialEquation(
    equation: Expression,
    dependent_function: UndefinedFunction,
    independent_variables: string[],
    initial_conditions?: Expression[] | null,
    boundary_conditions?: Expression[] | null,
): PartialDifferentialEquationProblem

Construct a validated scalar PDE with an explicit dependent function and an explicit independent-variable order. The order is part of the signature: it fixes which coordinate the classifier and every transformation call the first axis, so the same equation given two orders is two problems. Conditions are residuals read as equal to zero.

Errors: an equation that does not involve the declared dependent function, a repeated or undeclared independent variable, or a condition outside the declared coordinates is an invalid-argument error naming the offending parameter.

discover_partial_differential_equation#

Raw WebAssembly: Default context

discoverPartialDifferentialEquation(
    equation: Expression,
    initial_conditions?: Expression[] | null,
    boundary_conditions?: Expression[] | null,
): PartialDifferentialEquationProblem
Calling forms

Raw WebAssembly: Explicit context: Context.discoverPartialDifferentialEquation

discoverPartialDifferentialEquation(
    equation: Expression,
    initial_conditions?: Expression[] | null,
    boundary_conditions?: Expression[] | null,
): PartialDifferentialEquationProblem

Recover the same signature from one governing residual alone, by reading the dependent function and the independent variables out of the derivatives that appear in it. It declines rather than guessing when the residual does not determine a unique signature — more than one undefined function, or a coordinate order the residual leaves ambiguous. Prefer partial_differential_equation when the signature is known; use this entry when the equation is the only thing in hand.

partial_differential_equation_arbitrary_function#

Raw WebAssembly: Explicit context

partialDifferentialEquationArbitraryFunction(
    preferred_name: string,
    arity: number,
): PartialDifferentialEquationArbitraryFunction

Allocate a collision-free arbitrary function of the stated arity, for use as a free element of a candidate solution family. The allocated name is derived from preferred_name but is guaranteed not to collide with a function already present in the context, so a family's free elements cannot be captured by a name the problem already uses.

Classifying#

classify_partial_differential_equation#

Raw WebAssembly: Default context

classifyPartialDifferentialEquation(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationClassification
Calling forms

Raw WebAssembly: Explicit context: Context.classifyPartialDifferentialEquation

classifyPartialDifferentialEquation(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationClassification

Exact structural analysis of a validated scalar PDE: its order, its linearity, its principal part, and the coefficient data each of those is read from. The analysis is structural and exact — a coefficient whose sign or reality cannot be proved is reported as undetermined rather than assumed.

classify_second_order_partial_differential_equation#

Raw WebAssembly: Default context

classifySecondOrderPartialDifferentialEquation(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationSecondOrderClassification
Calling forms

Raw WebAssembly: Explicit context: Context.classifySecondOrderPartialDifferentialEquation

classifySecondOrderPartialDifferentialEquation(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationSecondOrderClassification

The elliptic/parabolic/hyperbolic type of a two-variable linear second-order PDE over real coordinates, taken from the discriminant of the principal part's symmetric matrix. The type is reported per case, with a verdict, because a discriminant with a symbolic sign is of one type on one region and another type elsewhere; a type is claimed only where its sign condition is proved.

Changing coordinates#

change_partial_differential_equation_variables#

Raw WebAssembly: Default context

changePartialDifferentialEquationVariables(
    problem: PartialDifferentialEquationProblem,
    target_variables: string[],
    forward_coordinates?: Expression[] | null,
    inverse_coordinates?: Expression[] | null,
    target_dependent_function?: UndefinedFunction | null,
): PartialDifferentialEquationTransformationResult
Calling forms

Raw WebAssembly: Explicit context: Context.changePartialDifferentialEquationVariables

changePartialDifferentialEquationVariables(
    problem: PartialDifferentialEquationProblem,
    target_variables: string[],
    forward_coordinates?: Expression[] | null,
    inverse_coordinates?: Expression[] | null,
    target_dependent_function?: UndefinedFunction | null,
): PartialDifferentialEquationTransformationResult

Transform a two-variable PDE through an exact user-supplied change of variables. The forward and inverse coordinate maps are both required for the chain rule to be applied exactly; the transformation is carried out symbolically, never numerically, and the result carries the transformed problem together with the maps used.

canonicalize_partial_differential_equation#

Raw WebAssembly: Default context

canonicalizePartialDifferentialEquation(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationCanonicalizationResult
Calling forms

Raw WebAssembly: Explicit context: Context.canonicalizePartialDifferentialEquation

canonicalizePartialDifferentialEquation(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationCanonicalizationResult

Construct and independently verify exact canonical coordinates for a supported PDE — the coordinates in which a second-order equation takes its canonical principal form for its type. The coordinates are derived and then checked by transforming the original equation into them, so a canonicalization is reported only when its own verification passes.

verify_partial_differential_equation_coordinate_transformation#

Raw WebAssembly: Default context

verifyPartialDifferentialEquationCoordinateTransformation(
    problem: PartialDifferentialEquationProblem,
    transformation: PartialDifferentialEquationTransformationResult,
): PartialDifferentialEquationTransformationVerificationReport
Calling forms

Raw WebAssembly: Explicit context: Context.verifyPartialDifferentialEquationCoordinateTransformation

verifyPartialDifferentialEquationCoordinateTransformation(
    problem: PartialDifferentialEquationProblem,
    transformation: PartialDifferentialEquationTransformationResult,
): PartialDifferentialEquationTransformationVerificationReport

Independently check a coordinate transformation without producing one: the coordinate maps are confirmed mutually inverse and the transformed equation is confirmed to be the exact pullback of the original. No transformation runs, so a supplied transformation is reported as given rather than repaired.

Solving#

solve_partial_differential_equation#

Raw WebAssembly: Default context

solvePartialDifferentialEquation(
    problem: PartialDifferentialEquationProblem,
    method?: string | null,
): PartialDifferentialEquationSolveResult
Calling forms

Raw WebAssembly: Explicit context: Context.solvePartialDifferentialEquation

solvePartialDifferentialEquation(
    problem: PartialDifferentialEquationProblem,
    method?: string | null,
): PartialDifferentialEquationSolveResult

The sound PDE dispatcher under a stable method name. automatic lets the dispatcher choose among the implemented routes; a named method runs only that route and declines when it does not apply, so a named request is never silently answered by a different method.

Use solve_partial_differential_equation_request when the scope, geometry, regularity, or solution class is part of the question.

solve_partial_differential_equation_request#

Raw WebAssembly: Default context

solvePartialDifferentialEquationRequest(
    problem: PartialDifferentialEquationProblem,
    scope: string,
    geometric_domain?: string | null,
    regularity?: string | null,
    solution_class?: string | null,
    method?: string | null,
): PartialDifferentialEquationSolveResult
Calling forms

Raw WebAssembly: Explicit context: Context.solvePartialDifferentialEquationRequest

solvePartialDifferentialEquationRequest(
    problem: PartialDifferentialEquationProblem,
    scope: string,
    geometric_domain?: string | null,
    regularity?: string | null,
    solution_class?: string | null,
    method?: string | null,
): PartialDifferentialEquationSolveResult

Solve a PDE request in which the geometry, regularity, and solution class are part of the question. geometric_domain is whole_space, disk (radial then angular variable, origin interior), or real_line_evolution (whole-line spatial variable then positive evolution variable). regularity is unrestricted or origin_regular_periodic (disk only). solution_class is unrestricted or polynomial_growth.

A general request is answered only by a family whose completeness theorem is proved over the requested class. Otherwise the result declines with complete_family_not_established or completeness_holds_only_on_a_narrower_solution_class — the latter is the verdict for the unrestricted heat request, whose initial-data representation is complete only among solutions of polynomial growth. Geometry or regularity no implemented method supports declines with declared_geometry_not_supported or declared_regularity_not_supported.

solve_partial_differential_equation_with_transform_axis_specifications#

Raw WebAssembly: Default context

solvePartialDifferentialEquationWithTransformAxisSpecifications(
    problem: PartialDifferentialEquationProblem,
    method: string,
    transform_axis_specifications: string[],
): PartialDifferentialEquationSolveResult
Calling forms

Raw WebAssembly: Explicit context: Context.solvePartialDifferentialEquationWithTransformAxisSpecifications

solvePartialDifferentialEquationWithTransformAxisSpecifications(
    problem: PartialDifferentialEquationProblem,
    method: string,
    transform_axis_specifications: string[],
): PartialDifferentialEquationSolveResult

Solve through a transform route with the axis geometry stated explicitly and in order: one specification per axis, naming the axis kind the transform is to treat that coordinate as. A transform route needs to know which coordinate is the whole line and which is the positive evolution direction; this entry makes that part of the request rather than something a solver infers.

separate_partial_differential_equation#

Raw WebAssembly: Default context

separatePartialDifferentialEquation(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationSeparationResult
Calling forms

Raw WebAssembly: Explicit context: Context.separatePartialDifferentialEquation

separatePartialDifferentialEquation(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationSeparationResult

Separate a supported PDE into exact one-variable ODEs. The result carries the separated equations, the separation constants introduced, and the strategy that produced them; each separated equation is an ordinary differential equation that the ODE routes can close.

Point symmetries#

derive_partial_differential_equation_point_symmetries#

Raw WebAssembly: Default context

derivePartialDifferentialEquationPointSymmetries(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationPointSymmetryAlgebra
Calling forms

Raw WebAssembly: Explicit context: Context.derivePartialDifferentialEquationPointSymmetries

derivePartialDifferentialEquationPointSymmetries(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationPointSymmetryAlgebra

Derive the point-symmetry algebra of a scalar first- or second-order PDE from its prolonged determining equations. Each basis generator is verified by an independent infinitesimal-criterion check. For a linear homogeneous equation the additive solution symmetry is reported separately (admits_additive_solution_symmetry), because it is constrained to solutions rather than being an arbitrary function. Problems carrying initial or boundary data decline, as do infinite-dimensional algebras the bounded reduction cannot close. The result carries decline, parameters, basis, general_generator, determining_equations, and outstanding_obligations; discrete symmetries are never claimed.

partial_differential_equation_point_symmetry_generator#

Raw WebAssembly: Default context

partialDifferentialEquationPointSymmetryGenerator(
    problem: PartialDifferentialEquationProblem,
    coordinate_infinitesimals: Expression[],
    dependent_infinitesimal: Expression,
): PartialDifferentialEquationPointSymmetryGenerator
Calling forms

Raw WebAssembly: Explicit context: Context.partialDifferentialEquationPointSymmetryGenerator

partialDifferentialEquationPointSymmetryGenerator(
    problem: PartialDifferentialEquationProblem,
    coordinate_infinitesimals: Expression[],
    dependent_infinitesimal: Expression,
): PartialDifferentialEquationPointSymmetryGenerator

A candidate generator, one coordinate infinitesimal per independent variable and a dependent infinitesimal written in the unknown evaluated at them. It is a candidate, not a certificate: every consumer verifies it is a symmetry.

construct_partial_differential_equation_point_symmetry_action#

Raw WebAssembly: Default context

constructPartialDifferentialEquationPointSymmetryAction(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationPointSymmetryAction
Calling forms

Raw WebAssembly: Explicit context: Context.constructPartialDifferentialEquationPointSymmetryAction

constructPartialDifferentialEquationPointSymmetryAction(problem: PartialDifferentialEquationProblem): PartialDifferentialEquationPointSymmetryAction

Integrate every basis generator into a one-parameter group, verify each group by its own intertwining identity, and certify their composition as the connected local action u = a + A f(X). The result carries parameters, transformed_coordinates, amplitude, multiplier, intertwining, invertibility, outstanding_obligations, and decline or point_symmetry_decline. applied_to_seed(seed) returns A f(X) and applied_to_seed_with_additive_solution(seed, additive_solution) returns a + A f(X); the transformed coordinates must lie in the seed's chart.

solve_partial_differential_equation_by_similarity_reduction#

Raw WebAssembly: Default context

solvePartialDifferentialEquationBySimilarityReduction(
    problem: PartialDifferentialEquationProblem,
    generator: PartialDifferentialEquationPointSymmetryGenerator,
): PartialDifferentialEquationSimilaritySolution
Calling forms

Raw WebAssembly: Explicit context: Context.solvePartialDifferentialEquationBySimilarityReduction

solvePartialDifferentialEquationBySimilarityReduction(
    problem: PartialDifferentialEquationProblem,
    generator: PartialDifferentialEquationPointSymmetryGenerator,
): PartialDifferentialEquationSimilaritySolution

Reduce a two-variable PDE by a fiber-linear point symmetry to an ODE in the invariant, solve that ODE as a complete family, and lift the family back. The result carries invariant, similarity_variable, weight, reduced_equation, multiplier, lifted_family, lifted_constants, lifted_family_verification, outstanding_obligations, and decline. The lifted family is a family of invariant solutions and always carries the obligation that it is not the general solution.

Candidate solutions and verification#

A candidate family is stated, then checked. The two are deliberately separate operations: a verified residual proves membership in the solution set and never coverage of it, so a family that is verified is not thereby complete.

explicit_partial_differential_equation_solution#

Raw WebAssembly: Default context

explicitPartialDifferentialEquationSolution(
    solution: Expression,
    arbitrary_functions?: PartialDifferentialEquationArbitraryFunction[] | null,
    proof_obligations?: string[] | null,
): PartialDifferentialEquationSolutionFamily
Calling forms

Raw WebAssembly: Explicit context: Context.explicitPartialDifferentialEquationSolution

explicitPartialDifferentialEquationSolution(
    solution: Expression,
    arbitrary_functions?: PartialDifferentialEquationArbitraryFunction[] | null,
    proof_obligations?: string[] | null,
): PartialDifferentialEquationSolutionFamily

State a candidate family in explicit form — the unknown written as an expression in the coordinates — together with the arbitrary functions it treats as free and any proof obligations it carries. Stating a family asserts nothing; verify_partial_differential_equation_solution is what establishes it.

implicit_partial_differential_equation_solution#

Raw WebAssembly: Default context

implicitPartialDifferentialEquationSolution(
    residual: Expression,
    arbitrary_functions?: PartialDifferentialEquationArbitraryFunction[] | null,
    proof_obligations?: string[] | null,
): PartialDifferentialEquationSolutionFamily
Calling forms

Raw WebAssembly: Explicit context: Context.implicitPartialDifferentialEquationSolution

implicitPartialDifferentialEquationSolution(
    residual: Expression,
    arbitrary_functions?: PartialDifferentialEquationArbitraryFunction[] | null,
    proof_obligations?: string[] | null,
): PartialDifferentialEquationSolutionFamily

State the same kind of candidate family as a residual read as equal to zero, for a family that cannot be solved for the unknown in closed form.

verify_partial_differential_equation_solution#

Raw WebAssembly: Default context

verifyPartialDifferentialEquationSolution(
    problem: PartialDifferentialEquationProblem,
    solution: PartialDifferentialEquationSolutionFamily,
): PartialDifferentialEquationVerificationReport
Calling forms

Raw WebAssembly: Explicit context: Context.verifyPartialDifferentialEquationSolution

verifyPartialDifferentialEquationSolution(
    problem: PartialDifferentialEquationProblem,
    solution: PartialDifferentialEquationSolutionFamily,
): PartialDifferentialEquationVerificationReport

Independently verify a candidate family against a problem by exact residual reasoning: substitute the family into the equation and every declared condition, and reduce the residuals symbolically. The report carries a verdict, the residuals that were not proved zero, and any outstanding obligations, so an inconclusive verification is distinguishable from a refutation.

Symi documentation · WASM / JavaScript