Top
Back: intclMonIdeal
Forward: finiteDiagInvariants
FastBack:
FastForward:
Up: normaliz_lib
Top: Singular Manual
Contents: Table of Contents
Index: Index
About: About this document

D.4.19.6 torusInvariants

Procedure from library normaliz.lib (see normaliz_lib).

Usage:
torusInvariants(intmat A);
torusInvariants(intmat A, intvec grading);

Return:
Returns an ideal representing the list of monomials generating the ring of invariants as an algebra over the coefficient field. $R^T$.
The function returns the ideal given by the input matrix A if one of the options supp, triang, volume, or hseries has been activated. However, in this case some numerical invariants are computed, and some other data may be contained in files that you can read into Singular (see showNuminvs, exportNuminvs).

Background:
Let $T = (K^*)^r$ be the $r$-dimensional torus acting on the polynomial ring $R = K[X_1 ,\ldots,X_n]$ diagonally. Such an action can be described as follows: there are integers $a_{i,j}$, $i=1,\ldots,r$, $j=1,\ldots,n$, such that $(\lambda_1,\ldots,\lambda_r)\in T$ acts by the substitution

\begin{displaymath}X_j \mapsto \lambda_1^{a_{1,j}} \cdots \lambda_r^{a_{r,j}}X_j,
\quad j=1,\ldots,n.\end{displaymath}

In order to compute the ring of invariants $R^T$ one must specify the matrix $A=(a_{i,j})$.

Example:
 
LIB "normaliz.lib";
ring R=0,(x,y,z,w),dp;
intmat E[2][4] = -1,-1,2,0, 1,1,-2,-1;
torusInvariants(E);
==> _[1]=x2z
==> _[2]=y2z
==> _[3]=xyz
See also: diagInvariants; finiteDiagInvariants; intersectionValRingIdeals; intersectionValRings.


Top Back: intclMonIdeal Forward: finiteDiagInvariants FastBack: FastForward: Up: normaliz_lib Top: Singular Manual Contents: Table of Contents Index: Index About: About this document
            User manual for Singular version 4-0-3, 2016, generated by texi2html.