groebner.jl

Groebner bases in (almost) pure Julia

https://github.com/sumiya11/groebner.jl

Science Score: 64.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: arxiv.org
  • Committers with academic emails
    6 of 13 committers (46.2%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.0%) to scientific vocabulary

Keywords

f4 grobner-basis groebner-basis julia symbolic-computation

Keywords from Contributors

graphics
Last synced: 6 months ago · JSON representation ·

Repository

Groebner bases in (almost) pure Julia

Basic Info
Statistics
  • Stars: 71
  • Watchers: 3
  • Forks: 13
  • Open Issues: 11
  • Releases: 49
Topics
f4 grobner-basis groebner-basis julia symbolic-computation
Created over 4 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog License Citation

README.md

Groebner.jl logo

Runtests Dev codecov

Groebner.jl is a Julia package for computing Groebner bases over fields. Groebner.jl is distributed under GNU GPL v2.

For documentation please check out https://sumiya11.github.io/Groebner.jl. For a simple example, see below.

For development plan: Plans for 2025.

Installation

You can install Groebner.jl using the Julia package manager. From the Julia REPL, type

julia import Pkg; Pkg.add("Groebner")

After the installation, you can run the package tests with

julia import Pkg; Pkg.test("Groebner")

How to use Groebner.jl?

The main function provided by Groebner.jl is groebner. It works with polynomials from AbstractAlgebra.jl, DynamicPolynomials.jl, and Nemo.jl.

with AbstractAlgebra.jl

We create a ring of polynomials in 3 variables and a simple polynomial system

```julia using AbstractAlgebra

R, (x1, x2, x3) = QQ["x1", "x2", "x3"]

system = [ x1 + x2 + x3, x1x2 + x1x3 + x2x3, x1x2*x3 - 1 ] ```

And compute the Groebner basis by passing the system to groebner

```julia using Groebner

G = groebner(system) julia

result

3-element Vector{AbstractAlgebra.Generic.MPoly{Rational{BigInt}}}: x3^3 - 1 x2^2 + x2*x3 + x3^2 x1 + x2 + x3 ```

with DynamicPolynomials.jl

Similarly to AbstractAlgebra.jl, we create a system of polynomials and pass it to groebner

```julia using DynamicPolynomials, Groebner

@polyvar x1 x2 system = [10x1x2^2 - 11x1 + 10, 10x1^2x2 - 11x2 + 10]

G = groebner(system) julia

result

3-element Vector{Polynomial{DynamicPolynomials.Commutative{DynamicPolynomials.CreationOrder}, Graded{LexOrder}, Rational{BigInt}}}: 10//11x2 - 10//11x1 - x2² + x1² 1//1 - 11//10x2 - 10//11x2² + 10//11x1x2 + x2³ 1//1 - 11//10x1 + x1x2² ```

Contacts

This library is maintained by Alexander Demin ().

Contributing

Contributions are very welcome, as are feature requests and suggestions. In particular additional examples and documentation improvements are encouraged. If you encounter any problems, please open an issue or contact a maintainer.

Acknowledgement

We would like to acknowledge the developers of the msolve library (https://msolve.lip6.fr/), as several components of Groebner.jl were adapted from msolve. In our F4 implementation, we adapt and adjust the code of monomial hashtable, critical pair handling and symbolic preprocessing, and linear algebra from msolve. The source code of msolve is available at https://github.com/algebraic-solving/msolve.

We thank Vladimir Kuznetsov for helpful discussions and providing the sources of his F4 implementation.

We are grateful to The Max Planck Institute for Informatics, The MAX team at l'X, and the OURAGAN team at Inria for providing computational resources.

See also

Other software in Julia that can be used for computing Groebner bases:

If you do not see your package here, we either do not know about it, or forgot to include it, sorry! Feel free to open a PR.

Citing Groebner.jl

If you find Groebner.jl useful in your work, you can star this repository and cite this paper

@misc{demin2024groebnerjl, title={Groebner.jl: A package for Gr\"obner bases computations in Julia}, author={Alexander Demin and Shashi Gowda}, year={2024}, eprint={2304.06935}, archivePrefix={arXiv}, primaryClass={cs.MS} }

Owner

  • Name: Alexander Demin
  • Login: sumiya11
  • Kind: user

Citation (CITATION.bib)

## Citation

If you use Groebner.jl, please cite [this paper](https://arxiv.org/abs/2304.06935)

@misc{demin2024groebnerjl,
      title={Groebner.jl: A package for Gr\"obner bases computations in Julia}, 
      author={Alexander Demin and Shashi Gowda},
      year={2024},
      eprint={2304.06935},
      archivePrefix={arXiv},
      primaryClass={cs.MS}
}

GitHub Events

Total
  • Create event: 23
  • Commit comment event: 18
  • Issues event: 10
  • Release event: 8
  • Watch event: 8
  • Delete event: 2
  • Member event: 1
  • Issue comment event: 44
  • Push event: 165
  • Pull request event: 33
Last Year
  • Create event: 23
  • Commit comment event: 18
  • Issues event: 10
  • Release event: 8
  • Watch event: 8
  • Delete event: 2
  • Member event: 1
  • Issue comment event: 44
  • Push event: 165
  • Pull request event: 33

Committers

Last synced: 10 months ago

All Time
  • Total Commits: 976
  • Total Committers: 13
  • Avg Commits per committer: 75.077
  • Development Distribution Score (DDS): 0.293
Past Year
  • Commits: 238
  • Committers: 4
  • Avg Commits per committer: 59.5
  • Development Distribution Score (DDS): 0.508
Top Committers
Name Email Commits
Alexander Demin a****2@e****u 690
Sasha Demin d****n@l****r 162
Sasha Demin a****n@m****e 69
CompatHelper Julia c****y@j****g 30
Shashi Gowda g****a@m****u 10
pogudingleb p****b@g****m 5
Stefan Krastanov g****c@k****g 2
odow o****n@g****m 2
Alexander Demin a****n@a****e 2
Yichao Yu y****2@g****m 1
Neven Sajko s@p****m 1
Alexander A Bouman a****n@g****m 1
Alexander Demin d****n@m****r 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 41
  • Total pull requests: 156
  • Average time to close issues: 7 months
  • Average time to close pull requests: 15 days
  • Total issue authors: 19
  • Total pull request authors: 10
  • Average comments per issue: 4.95
  • Average comments per pull request: 0.69
  • Merged pull requests: 121
  • Bot issues: 0
  • Bot pull requests: 55
Past Year
  • Issues: 7
  • Pull requests: 41
  • Average time to close issues: N/A
  • Average time to close pull requests: 1 day
  • Issue authors: 4
  • Pull request authors: 3
  • Average comments per issue: 3.14
  • Average comments per pull request: 0.63
  • Merged pull requests: 33
  • Bot issues: 0
  • Bot pull requests: 12
Top Authors
Issue Authors
  • sumiya11 (18)
  • nsajko (4)
  • aabouman (2)
  • iliailmer (2)
  • KenZhenLin (1)
  • AayushSabharwal (1)
  • JuliaTagBot (1)
  • wangjie212 (1)
  • martinkjlarsson (1)
  • odow (1)
  • 0708andreas (1)
  • xyz333math (1)
  • YingboMa (1)
  • polka125 (1)
  • shashi (1)
Pull Request Authors
  • sumiya11 (117)
  • github-actions[bot] (79)
  • pogudingleb (4)
  • yuyichao (2)
  • Krastanov (2)
  • nsajko (1)
  • shashi (1)
  • YingboMa (1)
  • odow (1)
  • aabouman (1)
Top Labels
Issue Labels
enhancement (5) documentation (1) bug (1)
Pull Request Labels

Dependencies

.github/workflows/DeployPage.yml actions
  • JamesIves/github-pages-deploy-action releases/v3 composite
  • actions/checkout v2 composite
  • julia-actions/setup-julia v1 composite
.github/workflows/Downstream.yml actions
  • actions/checkout v2 composite
  • julia-actions/julia-buildpkg latest composite
  • julia-actions/setup-julia v1 composite
.github/workflows/Runtests.yml actions
  • actions/checkout v2 composite
  • julia-actions/julia-buildpkg latest composite
  • julia-actions/julia-runtest latest composite
  • julia-actions/setup-julia latest composite
.github/workflows/TagBot.yml actions
  • JuliaRegistries/TagBot v1 composite
.github/workflows/CompatHelper.yml actions
.github/workflows/FormatCheck.yml actions
  • actions/checkout v3 composite
  • julia-actions/setup-julia latest composite
.github/workflows/PerformanceCheck.yml actions
  • actions/checkout v2 composite
  • julia-actions/julia-buildpkg latest composite
  • julia-actions/setup-julia latest composite