File: coimage-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 (34 lines) | stat: -rw-r--r-- 1,129 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
--- status: DRAFT
--- author(s): MES, taken from Dan's
--- notes: 

document { 
     Key => {coimage,
	  (coimage, Matrix),
	  (coimage, RingMap)},
     Headline => "coimage of a map",
     Usage => "coimage f",
     Inputs => {
	  "f" => {
	       "a ", TO2(RingMap,"ring map"), 
	       " or a ", TO2(Matrix, "matrix"),
           " from ", TT "A", " to ", TT "B"
	       }
	  },
     Outputs => {
	  {"The object ", TT "A/(kernel f)"}
	  },
     "In each of these cases, the coimage is isomorphic to the image, but the coimage is presented as
     a quotient object of the source of the map, whereas the image is presented as a subobject of the
     target of the map.  For rings, we can represent quotient rings, but not subrings, in Macaulay2.
     Hence, for ring maps, we can compute the coimage, but not the image.",
     PARA "The isomorphism between coimage and image is not always obvious, as the following example shows.",
     EXAMPLE {
	  "R = QQ[a..d];",
	  "M = matrix{{a^3,b^3-c^3,a*b*c,a*(b^2-c^2)}}",
	  "image M",
	  "coimage M",
	  "kernel M"
	  },
     SeeAlso => {image, cokernel, kernel, comodule}
     }