File: isQuotientModule-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 (32 lines) | stat: -rw-r--r-- 1,072 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
--- status: Draft
--- author(s): Gregory G. Smith
--- notes: 

document { 
     Key => {isQuotientModule, (isQuotientModule,Thing), (isQuotientModule,Module)},
     Headline => "whether something is evidently a quotient of a free module",
     Usage => "isQuotientModule M",
     Inputs => {
	  "M" => Thing
	  },
     Outputs => {
	  Boolean => {TO "true", " if the given representation of ", TT "M", " a quotient of a free module."}
	  },
     "This function checks if the module ", TT "M", " is a quotient of its ", TO "ambient", 
     " free module by examining its matrix of ", TO2((generators, Module),"generators"), ".",     
     EXAMPLE {
	  "R = ZZ/101[a,b,c];",
	  "M = R^1/(a^2,b^2,c^2)",
	  "isQuotientModule M"
	  },
     "The image of a map from a free module to the first generator of ", TT "M", " yields an equivalent 
     module that is ", EM "not", " presented as a quotient.",
     EXAMPLE {
	  "f = M_{0}",
	  "N = image f",
	  "M == N",	  
	  "isQuotientModule N",
	  },     
     SeeAlso => {(symbol_, Module, List), ambient, isFreeModule}
     }