File: Grassmannian-doc.m2

package info (click to toggle)
macaulay2 1.25.05%2Bds-2
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 172,152 kB
  • sloc: cpp: 107,824; ansic: 16,193; javascript: 4,189; makefile: 3,899; lisp: 702; yacc: 604; sh: 476; xml: 177; perl: 114; lex: 65; python: 33
file content (116 lines) | stat: -rw-r--r-- 4,946 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
-- -*- coding: utf-8 -*-
document {
    Key => {
	 Grassmannian,
	(Grassmannian, ZZ, ZZ), 
	  (Grassmannian, ZZ, ZZ, PolynomialRing),
	  [Grassmannian, CoefficientRing],
	  [Grassmannian, Variable]},
     Headline => "compute the ideal of the Grassmannian of linear subspaces of a vector space",
     Usage => "Grassmannian(k,r)\nGrassmannian(k,r,R)",
     Inputs => { 
	  "k", 
	  "r",
	  CoefficientRing => Ring => "the coefficient ring for the polynomial ring to be made",
	  Variable => Symbol => { "the base symbol for the indexed variables to be used.  The subscripts are the elements of ", TT "subsets(n+1,k+1)",
	       ", converted to sequences and, if ", TT "k", " is 0, converted to integers." }
	  },
     Outputs => {{ "the ideal of the Grassmannian variety of all projective ", TT "k", "-planes in ", BOLD "P", SUP "r"}},
     "If a polynomial ring ", TT "R", " is given as the third argument, then the resulting ideal is moved to that ring.",
     EXAMPLE lines ///
	 Grassmannian(1,3)
	 J = Grassmannian(2,5, CoefficientRing => ZZ/31, Variable => T) -* no-capture-flag *-
     ///,
     "The variables of the ring are based on the symbol provided, but assignments
     are not made until the ring or the ideal is assigned to a global variable or is submitted to ", TO "use", ", as follows.",
     EXAMPLE {
	  "T_(0,2,3)",
	  "use ring J",
	  "T_(0,2,3)"
	  },
     "In many ways, more natural than returning an ideal would be to return the corresponding quotient ring or
     variety, but creating a quotient ring involves computing a Gröbner basis, which
     might impose a heavy computational burden that the user would prefer to avoid.",
     SeeAlso => {"Schubert","pfaffians"}
     }

document { 
    Key => {
	 Schubert,
	(Schubert,ZZ,ZZ,VisibleList), 
	  [Schubert,CoefficientRing],
	  [Schubert,Variable]},
     Headline => "compute the Plücker ideal of a Schubert variety",
     Usage => "Schubert(k,n,sigma)",
     Inputs => { 
	  "k", 
	  "n", 
	  "sigma" => {"a subset of ", TT "0..n", " of size ", TT "k+1", " that indexes the Schubert variety"},
	  CoefficientRing => Ring => "the coefficient ring for the polynomial ring to be made",
	  Variable => Symbol => { "the base symbol for the indexed variables to be used.  The subscripts are the elements of ", TT "subsets(n+1,k+1)",
	       ", converted to sequences and, if ", TT "k", " is 0, converted to integers." }
	  },
     Outputs => {Ideal => "the ideal of the Schubert variety indexed by sigma" },
     TEX ///Given natural numbers $k \le{} n$, this routine finds the
     ideal of the Schubert variety indexed by sigma in the Grassmannian of projective 
     $k$-planes in $P^n$.///,
     PARA {
     	  TEX ///For example, the ideal of the Schubert variety indexed by $\{1,2,4\}$ in the
	  Grassmannian of projective planes in $P^4$ is displayed in the following example.///
     	  },
     EXAMPLE lines ///
	  I = Schubert(2,4,{1,2,4},CoefficientRing => QQ)
	  R = ring I;
	  C = res I
	  betti C
     ///,
     SeeAlso => {"Grassmannian","pfaffians"}
     }

document {
    Key => {
	Fano,
       (Fano, ZZ, Ideal),
       (Fano, ZZ, Ideal, Ring)},
    Headline => "compute the ideal of a Fano scheme in the Grassmannian",
    SYNOPSIS (
	Heading => "Fano scheme",
	Usage => "Fano(k,I)",
	Inputs => {
	    "k" => {"a positive integer less than ", TT "r"},
	    "I" => {"an ideal representing a variety in projective ", TT "r", "-space"},
	},
	Outputs => {"the ideal of a Fano scheme in the Grassmannian"},
	"Given an ideal ", TT "I", " representing a projective variety ", TT "X", "
	in ", TT "P^r", ", a positive integer k<r, and optionally a
	ring ", TT "GR", " with (exactly) ", TT "r+1", " choose ", TT "k+1", " variables,
	representing the ambient space of the Grassmannian of
	k-planes in ", TT "P^r", ", this routine returns the ideal in
	", TT "GR", " of the Fano scheme that parametrizes the k-planes
	lying on ", TT "X", ".  If the optional third argument is not
	present, the routine fabricates its own ring,
	and returns an ideal in it."
    ),
    SYNOPSIS (
	Usage => "Fano(k,I,GR)",
	Inputs => {
	    "k" => {"a positive integer less than ", TT "r"},
	    "I" => {"an ideal representing a variety in projective ", TT "r", "-space"},
	    "GR" => {}
	},
	Outputs => {"the ideal of a Fano scheme in the Grassmannian"},
	"Given an ideal ", TT "I", " representing a projective variety ", TT "X", "
	in ", TT "P^r", ", a positive integer k<r, and optionally a
	ring ", TT "GR", " with (exactly) ", TT "r+1", " choose ", TT "k+1", " variables,
	representing the ambient space of the Grassmannian of
	k-planes in ", TT "P^r", ", this routine returns the ideal in
	", TT "GR", " of the Fano scheme that parametrizes the k-planes
	lying on ", TT "X", ".  If the optional third argument is not
	present, the routine fabricates its own ring,
	and returns an ideal in it."
    ),
    SeeAlso => {
	Grassmannian,
	"Tutorial: Fano varieties"
    }
}