File: homology-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,334 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
--- status: done
--- author(s): dan
--- notes: 

document { 
     Key => homology,
     Headline => "general homology functor",
     "Most applications of this functor are dispatched through ", TT "HH", ".
     If it is intended that ", TT "i", " be of class ", TO "ZZ", ", 
     ", TT "M", " be of class ", TT "A", ", and ", TT "N", " be of
     class ", TT "B", ", then the method for computing ", TT "HH_i(M,N)", " can be installed with 
     code of the following form.",
     PRE "     homology(ZZ, A, B) := opts -> (i,M,N) -> ...",
     SeeAlso => {"cohomology", "HH", "ScriptedFunctor"}
     }

document { 
     Key => (homology,Matrix,Matrix),
     Headline => "homology of a pair of maps",
     Usage => "M = homology(f,g)",
     Inputs => { "f", "g" },
     Outputs => {
	  "M" => {"computes the homology module ", TT "(kernel f)/(image g)", "."}
	  },
     "Here ", TT "g", " and ", TT "f", " should be composable maps with ", TT "f*g", "
     equal to zero.",
     PARA {
	  "In the following example, we ensure that the source of ", TT "f", " and the target of
	  ", TT "f", " are exactly the same, taking even the degrees into account, and we ensure
	  that ", TT "f", " is homogeneous."},
     EXAMPLE {
	  "R = QQ[x]/x^5;",
	  "f = map(R^1,R^1,{{x^3}}, Degree => 3)",
	  "M = homology(f,f)",
	  "prune M"
	  }
     }