Macaulay2 » Documentation
Packages » SchurVeronese :: SchurVeronese
next | previous | forward | backward | up | index | toc

SchurVeronese -- syzygy data for Veronese embeddings of P^1 and P^2

Description

The authors of this package used a combination of high-throughput and high-performance computing and sparse numerical linear algebra to compute the syzygies of $\mathbb{P}^{2}$ under the $d$-fold Veronese embedding for various values of $d$. See the paper ``Conjectures and Computations about Veronese Syzygies'' by Bruce, Erman, Goldstein and Yang, which we refer to as [BEGY] (see arXiv:1711.03513) throughout the documentation for this package. In addition, much of the data generated from these computations (graded Betti numbers, multigraded Betti numbers, Schur functor decompositions, etc.) is currently available online via syzygydata.com. The goal of this package is to make this data more accessible and easy to use by providing a way to access it via Macaulay2.

Most functions have been implemented with three parameters $(d,n,b)$, where the goal is to compute the syzygies of the pushforward of the line bundle $\mathcal{O}(b)$ under the $d$-fold embedding. However, we have produced data for $n=1$ and $n=2$, for $b$ between $0$ and $d$ and for a limited range of values of $d$. Other inputs will produce an error message. Our hope is that as we (or others) are able to compute new data, we will be able to update the package.

One of the main functions is totalBettiTally, which produces the standard graded Betti table of the corresponding standard graded Veronese module. Other main functions refine the data in the Betti table by providing the multigraded Betti number or the Schur functor decompositions, or by computing statistics related to the Betti table (e.g., the BoijSoederberg coefficients) or related to the SchurFunctor decomposition.

A number of functions in this package produce individual entries of a Betti table. There are two common notations for referring to Betti numbers in the literature, and it will be useful to reference these notations throughout the documentation, similar to how they are referenced in the corresponding paper. For a graded module $M$ we will write $\beta_{i,j}(M)$ for $\dim Tor_i(M,k)_j$ and we write $K_{p,q}(M)$ for the vector space $Tor_p(M,k)_{p+q}$.

Authors

Certification a gold star

Version 1.1 of this package was accepted for publication in volume 11 of The Journal of Software for Algebra and Geometry on 5 May 2021, in the article The Schur–Veronese package in Macaulay2. That version can be obtained from the journal or from the Macaulay2 source code repository.

Version

This documentation describes version 1.1 of SchurVeronese.

Source code

The source code from which this documentation is derived is in the file SchurVeronese.m2. The auxiliary files accompanying it are in the directory SchurVeronese/.

Exports

  • Functions and commands
    • bsCoeffs -- a list of the Boij-Soederberg coefficients of a Veronese embedding
    • dominantWeightsBetti -- a hash table containing the dominant Schur functors of a Veronese embedding
    • lexWeightsBetti -- a hash table containing the lex-leading weight Schur functors of a Veronese embedding
    • makeBettiTally -- converts a hash table representing a Betti table to a Betti tally
    • multiBetti -- a hash table containing the multigraded Betti numbers of a Veronese embedding
    • numDistinctRepsBetti -- a hash table containing the number of distinct Schur functors of a Veronese embedding
    • numRepsBetti -- a hash table containing the number of Schur functors of a Veronese embedding
    • schurBetti -- a hash table for Schur module decomposition of Veronese Betti tables
    • totalBetti -- a hash table containing the graded Betti numbers of a Veronese embedding
    • totalBettiTally -- a Betti tally containing the graded Betti numbers of a Veronese embedding
  • Methods
    • bsCoeffs(ZZ,ZZ,ZZ) -- see bsCoeffs -- a list of the Boij-Soederberg coefficients of a Veronese embedding
    • dominantWeightsBetti(ZZ,ZZ,ZZ) -- see dominantWeightsBetti -- a hash table containing the dominant Schur functors of a Veronese embedding
    • lexWeightsBetti(ZZ,ZZ,ZZ) -- see lexWeightsBetti -- a hash table containing the lex-leading weight Schur functors of a Veronese embedding
    • makeBettiTally(HashTable) -- see makeBettiTally -- converts a hash table representing a Betti table to a Betti tally
    • multiBetti(ZZ,ZZ,ZZ) -- see multiBetti -- a hash table containing the multigraded Betti numbers of a Veronese embedding
    • numDistinctRepsBetti(ZZ,ZZ,ZZ) -- see numDistinctRepsBetti -- a hash table containing the number of distinct Schur functors of a Veronese embedding
    • numRepsBetti(ZZ,ZZ,ZZ) -- see numRepsBetti -- a hash table containing the number of Schur functors of a Veronese embedding
    • schurBetti(ZZ,ZZ,ZZ) -- see schurBetti -- a hash table for Schur module decomposition of Veronese Betti tables
    • totalBetti(ZZ,ZZ,ZZ) -- see totalBetti -- a hash table containing the graded Betti numbers of a Veronese embedding
    • totalBettiTally(ZZ,ZZ,ZZ) -- see totalBettiTally -- a Betti tally containing the graded Betti numbers of a Veronese embedding

For the programmer

The object SchurVeronese is a package.