File: independentSets-doc.m2

package info (click to toggle)
macaulay2 1.24.11%2Bds-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 171,648 kB
  • sloc: cpp: 107,850; ansic: 16,307; javascript: 4,188; makefile: 3,947; lisp: 682; yacc: 604; sh: 476; xml: 177; perl: 114; lex: 65; python: 33
file content (55 lines) | stat: -rw-r--r-- 2,162 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
48
49
50
51
52
53
54
55
--- status: DRAFT
--- author(s): MES
--- notes: 

document { 
     Key => {independentSets,
	  (independentSets,Ideal),
	  (independentSets,MonomialIdeal),
	  [independentSets,Limit]},
     Headline => "some size-maximal independent subsets of variables modulo an ideal",
     Usage => "independentSets J",
     Inputs => {
	  "J" => Nothing => {ofClass Ideal, ", or ", ofClass MonomialIdeal},
	  Limit => ZZ => "the maximum number of independent sets to be found"
	  },
     Outputs => {
	  List => {" of products of variables.  The support of any one of these products
	    is a maximal independent subset of variables modulo ", TT "J"}
	  },
     "An independent set of variables of an ideal ", TT "J", " in a polynomial ring ", TT "R", " is a 
     set of variables that are algebraically independent modulo ", TT "J", " (i.e. there is no
	  polynomial in ", TT "J", " involving only these sets of variables.",
     PARA{},
     "If the Krull dimension of ", TT "R/J", " is ", TT "d", ", then a maximal independent set is an independent set
     having size ", TT "d", ".",
     PARA{},
     EXAMPLE lines ///
     	  R = QQ[a..h];
	  I = minors(2,genericMatrix(R,a,2,4))
	  inI = ideal leadTerm I
	  independentSets I
	  independentSets inI
	  ///,
     PARA{},
     "The independent sets returned correspond one for one with the minimal
     primes of smallest codimension of the ideal of lead terms of J.",
     EXAMPLE lines ///
          I = ideal"abc,bcd,cde,adf,cgh,b3f,a3g"
	  minimalPrimes I
	  independentSets I
	  ///,
     "The optional Limit argument is useful if you need only one, or several such independent sets.",
     EXAMPLE lines ///
	  L = independentSets(I, Limit=>1)
          ///,
     PARA{},
     "Often, you want the list of the variables in a maximal independent set, or the list of those not in the set.",
     EXAMPLE lines ///
          support L_0
	  rsort toList(set gens R - set support L_0)
          ///,
     PARA{},
     "This function is useful as a subroutine to primary decomposition algorithms.",
     SeeAlso => {"PrimaryDecomposition::PrimaryDecomposition", "MinimalPrimes::minimalPrimes", support, rsort}
     }