File: homogenize-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 (36 lines) | stat: -rw-r--r-- 1,277 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
document {
    Key => {
	 homogenize,
	(homogenize, Ideal,  RingElement),
	--(homogenize, Ideal, RingElement, List), ??
	(homogenize, Matrix, RingElement),
	(homogenize, Matrix, RingElement, List),
	(homogenize, Module, RingElement),
	(homogenize, Module, RingElement, List),
	(homogenize, Vector, RingElement),
	(homogenize, Vector, RingElement, List),
	(homogenize, RingElement, RingElement),
	(homogenize, RingElement, RingElement, List),
    },
    Headline => "homogenize with respect to a variable",
    TT "homogenize(m,v)", " -- homogenize the ring element, vector,
    matrix, or module ", TT "m", " using the variable ", TT "v", " in the ring of ", TT "m", ".",
    BR{},     
    TT "homogenize(m,v,w)", " -- homogenize ", TT "m", " using the variable ", TT "v", ",
    so that the result is homogeneous with respect to the given list ", TT "w", " of
    integers provided as weights for the variables.",
    PARA{},
    EXAMPLE {
	"R = ZZ/101[x,y,z,Degrees => {1,2,3}]",
	"f = 1 + y + z^2",
	"homogenize(f,x)",
	"homogenize(f,x,{1,0,-1})",
    },
    PARA{},
    "The weights that may be used are limited (roughly) to the range -2^30 .. 2^30.",
    PARA{},
    Caveat => {
	"If the homogenization overflows the monomial, this is not
	reported as an error."
    }
}