A C implementation for computing Dixon resultants and solving polynomial systems over finite fields and the rationals ℚ, based on the FLINT and PML libraries.
Website: https://dixonres.github.io
Note: This repository is under active development. The version submitted to Crypto 2026 is archived and available at:
- Release page: https://github.com/DixonRes/DixonRes/releases/tag/0.0.1
- Code tree: https://github.com/DixonRes/DixonRes/tree/0.0.1
- Dixon resultant computation for variable elimination
- Polynomial system solver for n×n systems
- Dixon with triangular ideal reduction
- Finite fields:
- Prime fields F_p (any size): Implemented with FLINT modular arithmetic, optionally accelerated by PML.
- Extension fields F_{p^k}: Further optimized for binary fields F_{2^n} with n in {8, 16, 32, 64, 128}.
- Rational field ℚ: Rational reconstruction via multi-prime CRT. Set field_size = 0 to enable.
- Complexity analysis — estimates Dixon matrix size, Bezout degree bound, and operation count before computing
- Command line input or file input. Automatic output to solution files
- FLINT (recommended version: 3.4.0)
https://github.com/flintlib/flint
Optional:
- PML (used automatically if available)
https://github.com/vneiger/pml
git clone https://github.com/DixonRes/DixonRes.git && cd DixonRes
./configure
make
make check # optional
make install # optionalFor more options, run ./configure --help or make help.
We also provide a Windows GUI at DixonRes-Windows or DixonRes-Cross.
./dixon "polynomials" "eliminate_vars" field_sizeExamples:
./dixon "x+y+z, x*y+y*z+z*x, x*y*z+1" "x,y" 257
./dixon "x^2+y^2+z^2-1, x^2+y^2-2*z^2, x+y+z" "x,y" 0./dixon --solve "polynomials" field_sizeExample:
./dixon --solve "x^2 + y^2 + z^2 - 6, x + y + z - 4, x*y*z - x - 1" 257Estimates the difficulty of a Dixon resultant computation without performing it. Reports equation count, variable count, degree sequence, Dixon matrix size (via Hessenberg recurrence), Bezout degree bound, and complexity in bits.
./dixon --comp "polynomials" "eliminate_vars" field_size
./dixon -c "polynomials" "eliminate_vars" field_sizeExamples:
./dixon --comp "x^3+y^3+z^3, x^2*y+y^2*z+z^2*x, x+y+z-1" "x,y" 257Custom omega — set the matrix-multiplication exponent used in the complexity formula (default: 2.3):
./dixon --comp --omega 2.373 "polynomials" "eliminate_vars" field_size
./dixon -c -w 2.0 "polynomials" "eliminate_vars" field_sizeFile input uses the same format as Dixon mode:
./dixon --comp example.dat # output: example_comp.dat./dixon "x + y^2 + t, x*y + t*y + 1" "x" 2^8The default settings use t as the extension field generator and FLINT's built-in field polynomial.
./dixon --solve "x^2 + t*y, x*y + t^2" "2^8: t^8 + t^4 + t^3 + t + 1"(with AES custom polynomial for F_256)
./dixon --ideal "ideal_generators" "polynomials" "eliminate_vars" field_sizeExample:
./dixon --ideal "a2^3=2*a1+1, a3^3=a1*a2+3" "a1^2+a2^2+a3^2-10, a3^3-a1*a2-3" "a3" 257After each multiplication, reduces x^q -> x for every variable.
./dixon --field-equation "polynomials" "eliminate_vars" field_size
./dixon --field-eqution -r "[d1,d2,...,dn]" field_sizeExample:
./dixon --field-eqution "x0*x2+x1, x0*x1*x2+x2+1, x1*x2+x0+1" "x0,x1" 2
./dixon --field-eqution -r [3]*5 2./dixon --silent [--solve|--comp|-c] <arguments>No console output is produced; the solution/report file is still generated.
Generate random polynomial systems with specified degrees for testing and benchmarking.
./dixon --random "[d1,d2,...,dn]" field_size
./dixon -r "[d]*n" field_size[d1,d2,...,dn]: degree list (comma-separated) for n polynomials[d]*n: all n polynomials have same degree dfield_size: field size (prime or extension); use0for Q
# Random + Dixon elimination
./dixon -r --solve "[d1,...,dn]" field_size
# Random + complexity analysis
./dixon -r --comp "[d]*n" field_size
./dixon -r -c --omega 2.373 "[4]*5" 257 # custom omega
# Random + Dixon with ideal reduction
./dixon -r "[d1,d2,d3]" "ideal_generators" field_size# 3 polynomials (deg 3,3,2) in GF(257)
./dixon --random "[3,3,2]" 257
# Solve 3 quadratic system in GF(257)
./dixon -r --solve "[2]*3" 257
# Complexity analysis of 4 quartic polynomials
./dixon -r --comp --omega 2.373 "[4]*4" 257Line 1 : field size (prime or p^k; use 0 for Q; generator defaults to 't')
Line 2+: polynomials (comma-separated, may span multiple lines)
Last : variables to ELIMINATE (comma-separated)
(#eliminate = #equations - 1)
Example:
./dixon example.dat
./dixon --comp example.datLine 1 : field size
Line 2+: polynomials
(n equations in n variables)
| Mode | Command-line input | File input example.dat |
|---|---|---|
| Dixon / Solver | solution_YYYYMMDD_HHMMSS.dat |
example_solution.dat |
| Complexity | comp_YYYYMMDD_HHMMSS.dat |
example_comp.dat |
Each output file contains field information, input polynomials, computation time, and the resultant, solutions, or complexity report.
- Equation count, variable list, elimination variable list, remaining variables
- Degree sequence of input polynomials
- Bezout bound (product of degrees)
- Dixon matrix size (Hessenberg recurrence)
- Resultant degree estimate
- Complexity in log₂ bits (with the omega value used)
- All computation modes generate a solution/report file by default
- Extension fields are slower than prime fields due to polynomial arithmetic
- The optional PML library only accelerates well-determined systems over prime fields
- Complexity analysis does not run any polynomial arithmetic; it parses only
- Over Q (
field_size=0),--solve,--ideal, and--field-equationare not yet supported
| Feature | F_p (p<2^63) | F_p (p>2^63) | F_{p^k} (p<2^63) | Q |
|---|---|---|---|---|
| Dixon resultant | ✅ | ✅ | ✅ | ✅ |
Complexity analysis (--comp) |
✅ | ✅ | ✅ | ✅ |
Random mode (-r) |
✅ | ✅ | ✅ | ✅ |
Polynomial solver (--solve) |
✅ | ❌ | ✅ | ❌ |
Ideal reduction (--ideal) |
✅ | ❌ | ✅ | ❌ |
| Field-equation reduction | ✅ | ❌ | ✅ | ❌ |
| PML acceleration | ✅ | ❌ | ❌ | ❌ |
DixonRes is distributed under the GNU General Public License version 2.0 (GPL-2.0-or-later). See the file COPYING.
