File: sortColumns-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 (73 lines) | stat: -rw-r--r-- 2,316 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
--- status: TODO
--- author(s): 
--- notes: 

document { 
     Key => {sortColumns, (sortColumns,Matrix)},
     Headline => "permutation giving sort order",
     Usage => "sortColumns m",
     Inputs => {
	  "m" => "between free modules"
	  },
     Outputs => {
	  List => {"of integers, representing the order
	       which places the columns in order"}
	  },
     PARA{},
     "See ", TO (sort,Matrix), " for the ordering used.  The meanings of the
     optional parameters is also the same.",
     EXAMPLE {
	  "R = ZZ/32003[a..d,MonomialOrder=>Lex];",
	  "m = matrix{{a*d, b^2, b^100, b^50*d^50, c^2*d}}",
	  "p = sortColumns m",
	  "m_p"
	  },
     EXAMPLE {
	  "p = sortColumns(m, DegreeOrder=>null, MonomialOrder=>Descending)",
	  "m_p"
	  },
     EXAMPLE {
	  "R = ZZ/101[a..c];",
      	  "f = matrix{{1,a,a^2,b^2,b,c,c^2,a*b,b*c,a*c}}",
      	  "s = sortColumns f",
      	  "f_s",
      	  "s = sortColumns(f,DegreeOrder => Descending)",
      	  "f_s"
	  },
     SeeAlso => {sort},
     Subnodes => {
	 TO [sortColumns, MonomialOrder],
	 TO [sortColumns, DegreeOrder],
         },
     }
document { 
     Key => [sortColumns, MonomialOrder],
     Headline => "specify Ascending or Descending monomial order",
     Usage => "sortColumns(...,MonomialOrder=>x)",
     Inputs => {
	  "x" => Symbol => { "either ", TO "Ascending", " or ", TO "Descending"}
	  },
     Consequences => {
	  {"After the degree order has been considered, sort the columns of
	  the matrix in Ascending or Descending monomial order"}
	  },     
     Caveat => {"This option only works for sorting columns of a matrix, not
	  the elements of a list"},
     SeeAlso => {}
     }
document { 
     Key => [sortColumns, DegreeOrder],
     Headline => "specify Ascending, Descending, or null",
     Usage => "sortColumns(...,DegreeOrder=>x)",
     Inputs => {
	  "x" => Symbol => { "either ", TO "Ascending", ", ", TO "Descending", ", or ", TO null}
	  },
     Consequences => {
	  {"If ", TT "x", " is not null, first order the columns of the matrix
	  in ascending or descending degree (depending on ", TT "x", ").  If ",
	  TT "x", " is null, then only use the monomial order in the sort"}
	  },     
     Caveat => {"This option only works for sorting columns of a matrix, not
	  the elements of a list"},
     SeeAlso => {}
     }