Skip to content

JuliaAlgebra/MultivariatePolynomials.jl

Repository files navigation

Multivariate Polynomials

Documentation Build Status Social References to cite
Build Status Gitter DOI
Codecov branch

WARNING MultivariatePolynomials v0.5 has a few breaking changes including the change in the order of monomials. This means that the leading term will now appear last in the order of monomials instead of first.

This package provides an interface for manipulating multivariate polynomials. Implementing algorithms on polynomials using this interface will allow the algorithm to work for all polynomials implementing the interface.

The interface contains functions for accessing the coefficients, monomials, terms of the polynomial, defines arithmetic operations on them, rational functions, division with remainder, calculus/differentiation and evaluation/substitution.

Documentation

  • STABLEmost recently tagged version of the documentation.
  • LATESTin-development version of the documentation.

Citing

Please cite the JuliaCon 2022 presentation [Slides]. See CITATION.bib for the BibTeX.

Examples

Below is a simple usage example

using TypedPolynomials
@polyvar x y # assigns x (resp. y) to a variable of name x (resp. y)
p = 2x + 3.0x*y^2 + y
@test differentiate(p, x) # compute the derivative of p with respect to x
@test differentiate.(p, (x, y)) # compute the gradient of p
@test p((x, y)=>(y, x)) # replace any x by y and y by x
@test subs(p, y=>x^2) # replace any occurence of y by x^2
@test p(x=>1, y=>2) # evaluate p at [1, 2]

Below is an example with @polyvar x[1:3]

using TypedPolynomials
A = rand(3, 3)
@polyvar x[1:3] # assign x to a tuple of variables x1, x2, x3
p = sum(x .* x) # x_1^2 + x_2^2 + x_3^2
subs(p, x[1]=>2, x[3]=>3) # x_2^2 + 13
p(x=>A*vec(x)) # corresponds to dot(A*x, A*x), need vec to convert the tuple to a vector

Ecosystem

The following packages provides multivariate polynomials that implement the interface:

  • TypedPolynomials : Commutative polynomials of arbitrary coefficient types
  • DynamicPolynomials : Commutative and non-commutative polynomials of arbitrary coefficient types

The following packages extend/use the interface:

  • SemialgebraicSets : Sets defined by inequalities and equalities between polynomials and algorithms for solving polynomial systems of equations.
  • FixedPolynomials : Fast evaluation of multivariate polynomials
  • HomotopyContinuation : Solving systems of polynomials via homotopy continuation.
  • MultivariateBases : Standardized API for multivariate polynomial bases.
  • MultivariateMoments : Moments of multivariate measures and their scalar product with polynomials.
  • PolyJuMP : A JuMP extension for Polynomial Optimization.
  • SumOfSquares : Certifying the nonnegativity of polynomials, minimizing/maximizing polynomials and optimization over sum of squares polynomials using Sum of Squares Programming.

See also

  • Nemo for generic polynomial rings, matrix spaces, fraction fields, residue rings, power series
  • Polynomials for univariate polynomials
  • PolynomialRoots for a fast complex polynomial root finder