File: standardPairs-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 (47 lines) | stat: -rw-r--r-- 2,001 bytes parent folder | download | duplicates (5)
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
-- -*- coding: utf-8 -*-
--- status: Draft
--- author(s): Smith
--- notes: 

document { 
     Key => {standardPairs, (standardPairs,MonomialIdeal), (standardPairs, MonomialIdeal, List)},
     Headline => "find the standard pairs of a monomial ideal",
     Usage => "standardPairs I",
     Inputs => {
	  "I" => MonomialIdeal
	  },
     Outputs => {
	  {"a ", TO List, " of standard pairs for ", TT "I"}
	  },
     "The standard monomials of a monomial ideal ", TT "I", " (those monomials that are not 
     in ", TT "I", ") can be enumerated as follows.  Given a monomial ", 
     TT "m", " and a subset ", TT "F", " of the variables, the pair ", TT "(m,F)", " indexes
     the set of monomials of the form ", TT {"m", "m'"}, 
     " where the monomial ", TT "m'", " is supported on ", TT "F", ".  A ", TO List, " of pairs ", 
     TT "(m, F)", " form ", EM "standard pairs", " for the monomial ideal ", TT "I", 
     " if it satisfies the following three conditions:",
     UL {
	  {"for each pair, the monomial ", TT {"m"}, " is supported on the complement of ", 
	       TT "F", ";"},
	  {"all of the monomials represented by a pair are standard;"},
	  {"the pairs index disjoint sets of monomials."}
	  },
     EXAMPLE {
	  "R = QQ[x,y,z];",
	  "I = monomialIdeal(x*y^3*z, x*y^2*z^2, y^3*z^2, y^2*z^3)",
	  "standardPairs I"
	  },     
     PARA{},
     "The standard pairs are computed with Algorithm 3.2.5 in
     Gröbner Deformations of Hypergeometric Differential 
     Equations, by Mutsumi Saito, Bernd Sturmfels and Nobuki Takayama;
     Algorithms and Computation in Mathematics 6, Springer-Verlag, 2000.  
     Implemented by Gregory G. Smith.",
     PARA{},
     "For more information, see the ", EM "Monomial ideals", " chapter in Computations 
     in algebraic geometry with Macaulay2, edited by David Eisenbud, Daniel R. Grayson, 
     Michael E. Stillman, and Bernd Sturmfels, Algorithms and Computations in Mathematics 8, 
     Springer-Verlag, 2001.",
     SeeAlso => {}
     }