File: isWellDefined-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 (38 lines) | stat: -rw-r--r-- 1,115 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
-- -*- coding: utf-8 -*-
--- status: Draft
--- author(s): MES
--- notes: 

document { 
     Key => {isWellDefined,(isWellDefined,Matrix),(isWellDefined,RingMap)},
     Headline => "whether a map is well defined",
     Usage => "isWellDefined f",
     Inputs => {
	  "f" => ofClass{Matrix, RingMap}
	  },
     Outputs => {
	  Boolean => {"whether ", TT "f", " is a well-defined map"}
	  },
     "In order to check whether a matrix, whose source module is not free, is well defined,
     then a Gröbner basis computation will probably be required.",
     EXAMPLE lines ///
     	  R = QQ[a..d];
	  f = map(R^1,coker vars R,{{1_R}})
	  isWellDefined f
	  isWellDefined map(coker vars R, R^1, {{1_R}})
	  ///,
     "In order to check whether a ring map is well defined,
     it is often necessary to check that the image of an ideal 
     under a related ring map is zero.  This often requires
     a Gröbner basis as well.",
     EXAMPLE lines ///
     	  A = ZZ/5[a]
	  factor(a^3-a-2)
     	  B = A/(a^3-a-2);
	  isWellDefined map(A,B)
	  isWellDefined map(B,A)
          ///,
     SeeAlso => {
	  map
	  }
     }