<p>Categories are the main GAP objects in CAP. They are used to associate GAP objects which represent objects and morphisms with their category. By associating a GAP object to the category, one of two filters belonging to the category (ObjectFilter/MorphismFilter) are set to true. Via Add methods, functions for specific existential quantifiers can be associated to the category and after that can be applied to GAP objects in the category. A GAP category object also knows which constructions are currently possible in this category.</p>
<p>Classically, a category consists of a class of objects, a set of morphisms, identity morphisms, and a composition function satisfying some simple axioms. In CAP, we use a slightly different notion of a category.</p>
<p>A CAP category <span class="SimpleMath">\(\mathbf{C}\)</span> consists of the following data:</p>
<ul>
<li><p>A set <span class="SimpleMath">\(\mathrm{Obj}_{\mathbf{C}}\)</span> of <em>objects</em>.</p>
</li>
<li><p>For every pair <span class="SimpleMath">\(a,b \in \mathrm{Obj}_{\mathbf{C}}\)</span>, a set <span class="SimpleMath">\(\mathrm{Hom}_{\mathbf{C}}( a, b )\)</span> of <em>morphisms</em>.</p>
</li>
<li><p>For every pair <span class="SimpleMath">\(a,b \in \mathrm{Obj}_{\mathbf{C}}\)</span>, an equivalence relation <span class="SimpleMath">\(\sim_{a,b}\)</span> on <span class="SimpleMath">\(\mathrm{Hom}_{\mathbf{C}}( a, b )\)</span> called <em>congruence for morphisms</em>.</p>
</li>
<li><p>For every <span class="SimpleMath">\(a \in \mathrm{Obj}_{\mathbf{C}}\)</span>, an <em>identity morphism</em> <span class="SimpleMath">\(\mathrm{id}_a \in \mathrm{Hom}_{\mathbf{C}}( a, a )\)</span>.</p>
</li>
<li><p>For every triple <span class="SimpleMath">\(a, b, c \in \mathrm{Obj}_{\mathbf{C}}\)</span>, a <em>composition function</em></p>
<p class="center">\[\circ: \mathrm{Hom}_{\mathbf{C}}( b, c ) \times \mathrm{Hom}_{\mathbf{C}}( a, b ) \rightarrow \mathrm{Hom}_{\mathbf{C}}( a, c )\]</p>
<p>compatible with the congruence, i.e., if <span class="SimpleMath">\(\alpha, \alpha' \in \mathrm{Hom}_{\mathbf{C}}( a, b )\), \(\beta, \beta' \in \mathrm{Hom}_{\mathbf{C}}( b, c )\)</span>, <span class="SimpleMath">\(\alpha \sim_{a,b} \alpha'\) and \(\beta \sim_{b,c} \beta'\)</span>, then <span class="SimpleMath">\(\beta \circ \alpha \sim_{a,c} \beta' \circ \alpha'\)</span>.</p>
</li>
<li><p>For all <span class="SimpleMath">\(a, b \in \mathrm{Obj}_{\mathbf{C}}\)</span>, <span class="SimpleMath">\(\alpha \in \mathrm{Hom}_{\mathbf{C}}( a, b )\)</span>, we have</p>
</li>
<li><p>For all <span class="SimpleMath">\(a,b,c,d \in \mathrm{Obj}_{\mathbf{C}}\)</span>, <spanclass="SimpleMath">\(\alpha \in \mathrm{Hom}_{\mathbf{C}}( a, b )\)</span>, <span class="SimpleMath">\(\beta \in \mathrm{Hom}_{\mathbf{C}}( b, c )\)</span>, <span class="SimpleMath">\(\gamma \in \mathrm{Hom}_{\mathbf{C}}( c, d )\)</span>, we have</p>
<p>The GAP category of CAP categories. Objects of this type handle the CAP category information, the caching, and filters for objects in the CAP category. Please note that the object itself is not related to methods, you only need it as a handler and a presentation of the CAP category.</p>
<p>The GAP category of CAP category cells. Every object, morphism, and <span class="SimpleMath">\(2\)</span>-cell of a CAP category lies in this GAP category.</p>
<p>The GAP category of CAP category <span class="SimpleMath">\(2\)</span>-cells. Every <span class="SimpleMath">\(2\)</span>-cell of a CAP category lies in this GAP category.</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ AddCategoricalProperty</code>( <var class="Arg">list</var> )</td><td class="tdright">( function )</td></tr></table></div>
<p>Adds a categorical property to the list of CAP categorical properties. <var class="Arg">list</var> must be a list containing one entry, if the property is self dual, or two, if the dual property has a different name. If the first entry of the list is empty and the second is a property name, the property is assumed to have no dual.</p>
<p>The property of the category <var class="Arg">C</var> being skeletal, that is, whether <code class="code">IsEqualForObjects</code> and <code class="code">IsIsomorphicForObjects</code> coincide.</p>
<p>The property of the category <var class="Arg">C</var> being linear over a commutative ring <span class="SimpleMath">\(k\)</span> such that all external homs are finitely generated free <span class="SimpleMath">\(k\)</span>-modules.</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ ListOfDefiningOperations</code>( <var class="Arg">categorical_property</var> )</td><td class="tdright">( function )</td></tr></table></div>
<p>Returns: a list</p>
<p>The input <var class="Arg">categorical_property</var> is the name of a valid categorical property. The output is the list of names of the CAP operations needed to make this categorical property constructive.</p>
<p>The argument is a string <span class="SimpleMath">\(s\)</span>. This operation creates a new CAP category from scratch. Its name is set to <span class="SimpleMath">\(s\)</span>.</p>
<p>The argument is a string <span class="SimpleMath">\(s\)</span>. This operation creates a new CAP category from scratch. Its name is set to <span class="SimpleMath">\(s\)</span>. The category, its objects, its morphisms, and its two cells will lie in the corresponding given filters.</p>
<p>The argument is a string <span class="SimpleMath">\(s\)</span>. This operation creates a new CAP category from scratch. Its name is set to <span class="SimpleMath">\(s\)</span>. The category, its objects, its morphisms, and its two cells will lie in the corresponding given filters. The data types of the object/morphism/two cell datum can be given as described in <code class="func">CapJitInferredDataTypes</code> (<a href="https://homalg-project.github.io/CAP_project/CompilerForCAP/doc/chap2_mj.html#X821BE2CE7C30674E"><span class="RefLink">CompilerForCAP: CapJitInferredDataTypes</span></a>). As a convenience, simply a filter can be given if this suffices to fully determine the data type. If a data type is not specified, pass <code class="code">fail</code> instead.</p>
<p>The argument is a category <span class="SimpleMath">\(C\)</span>. The output is a filter in which all objects of <span class="SimpleMath">\(C\)</span> shall lie.</p>
<p>The argument is a category <span class="SimpleMath">\(C\)</span>. The output is a filter in which all morphisms of <span class="SimpleMath">\(C\)</span> shall lie.</p>
<p>The argument is a category <span class="SimpleMath">\(C\)</span>. The output is a filter in which all <span class="SimpleMath">\(2\)</span>-cells of <span class="SimpleMath">\(C\)</span> shall lie.</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ ObjectDatumType</code>( <var class="Arg">C</var> )</td><td class="tdright">( attribute )</td></tr></table></div>
<p>Returns: a data type or <code class="code">fail</code></p>
<p>The argument is a category <span class="SimpleMath">\(C\)</span>. The output is the data type (see <code class="func">CapJitInferredDataTypes</code> (<a href="https://homalg-project.github.io/CAP_project/CompilerForCAP/doc/chap2_mj.html#X821BE2CE7C30674E"><span class="RefLink">CompilerForCAP: CapJitInferredDataTypes</span></a>)) of object data of <span class="SimpleMath">\(C\)</span> (or <code class="code">fail</code> if this data type is not specified).</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ MorphismDatumType</code>( <var class="Arg">C</var> )</td><td class="tdright">( attribute )</td></tr></table></div>
<p>Returns: a data type or <code class="code">fail</code></p>
<p>The argument is a category <span class="SimpleMath">\(C\)</span>. The output is the data type (see <code class="func">CapJitInferredDataTypes</code> (<a href="https://homalg-project.github.io/CAP_project/CompilerForCAP/doc/chap2_mj.html#X821BE2CE7C30674E"><span class="RefLink">CompilerForCAP: CapJitInferredDataTypes</span></a>)) of morphism data of <span class="SimpleMath">\(C\)</span> (or <code class="code">fail</code> if this data type is not specified).</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ TwoCellDatumType</code>( <var class="Arg">C</var> )</td><td class="tdright">( attribute )</td></tr></table></div>
<p>Returns: a data type or <code class="code">fail</code></p>
<p>The argument is a category <span class="SimpleMath">\(C\)</span>. The output is the data type (see <code class="func">CapJitInferredDataTypes</code> (<a href="https://homalg-project.github.io/CAP_project/CompilerForCAP/doc/chap2_mj.html#X821BE2CE7C30674E"><span class="RefLink">CompilerForCAP: CapJitInferredDataTypes</span></a>)) of two cell data of <span class="SimpleMath">\(C\)</span> (or <code class="code">fail</code> if this data type is not specified).</p>
<p>The argument is a category <span class="SimpleMath">\(C\)</span> which is expected to lie in the filter <code class="code">IsLinearCategoryOverCommutativeRing</code>. The output is a commutative ring over which the category is linear.</p>
<p>The argument is a category <span class="SimpleMath">\(C\)</span> which is expected to lie in the filter <code class="code">IsEquippedWithHomomorphismStructure</code>. The output is the range category <span class="SimpleMath">\(D\)</span> of the defining functor <span class="SimpleMath">\(H: C^{\mathrm{op}} \times C \rightarrow D\)</span> of the homomorphism structure.</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ AdditiveGenerators</code>( <var class="Arg">C</var> )</td><td class="tdright">( attribute )</td></tr></table></div>
<p>Returns: a list of objects</p>
<p>The argument is an additive category <span class="SimpleMath">\(C\)</span>. The output is a list <span class="SimpleMath">\(L\)</span> of objects in <span class="SimpleMath">\(C\)</span> such that every object in <span class="SimpleMath">\(C\)</span> is a finite direct sum of objects in <spanclass="SimpleMath">\(L\)</span>.</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ IndecomposableProjectiveObjects</code>( <var class="Arg">C</var> )</td><td class="tdright">( attribute )</td></tr></table></div>
<p>Returns: a list of objects</p>
<p>The argument is an Abelian category <span class="SimpleMath">\(C\)</span> with enough projectives. The output is the set of indecomposable projective objects in <span class="SimpleMath">\(C\)</span> up to isomorphism. That is every projective object in <span class="SimpleMath">\(C\)</span> is isomorphic to a finite direct sum over these objects.</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ IndecomposableInjectiveObjects</code>( <var class="Arg">C</var> )</td><td class="tdright">( attribute )</td></tr></table></div>
<p>Returns: a list of objects</p>
<p>The argument is an Abelian category <span class="SimpleMath">\(C\)</span> with enough injectives. The output is the set of indecomposable injective objects in <span class="SimpleMath">\(C\)</span> up to isomorphism. That is every injective object in <span class="SimpleMath">\(C\)</span> is isomorphic to a finite direct sum over these objects.</p>
<p>The argument is a category <var class="Arg">C</var> and a string <var class="Arg">string</var>, which should be the name of a CAP operation, e.g., PreCompose. If applying this method is possible in <span class="SimpleMath">\(C\)</span>, the method returns <code class="code">true</code>, <code class="code">false</code> otherwise. If the string is not the name of a CAP operation, an error is raised. For debugging purposes one can also pass the CAP operation instead of its name.</p>
<p>The arguments are a category <span class="SimpleMath">\(C\)</span> and a string <span class="SimpleMath">\(s\)</span>. If <span class="SimpleMath">\(s\)</span> is a categorical property (e.g. <code class="code">"IsAbelianCategory"</code>), the output is a list of strings with CAP operations which are missing in <span class="SimpleMath">\(C\)</span> to have the categorical property constructively. If <span class="SimpleMath">\(s\)</span> is not a categorical property, an error is raised.</p>
<p>The argument is a cell <span class="SimpleMath">\(c\)</span>. The output is <code class="code">true</code> if <span class="SimpleMath">\(c\)</span> is well-defined, otherwise the output is <codeclass="code">false</code>.</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ Down</code>( <var class="Arg">x</var> )</td><td class="tdright">( attribute )</td></tr></table></div>
<p>Returns: a GAP object</p>
<p>The argument is a GAP object <span class="SimpleMath">\(x\)</span>. If <span class="SimpleMath">\(x\)</span> is an object in a CAP category, the output consists of data which are needed to reconstruct <span class="SimpleMath">\(x\)</span> (e.g., by passing them to an appropriate constructor). If <span class="SimpleMath">\(x\)</span> is a morphism in a CAP category, the output consists of a triple whose first entry is the source of <span class="SimpleMath">\(x\)</span>, the third entry is the range of <span class="SimpleMath">\(x\)</span>, and the second entry consists of data which are needed to reconstruct <span class="SimpleMath">\(x\)</span> (e.g., by passing them to an appropriate constructor, possibly together with the source and range of <span class="SimpleMath">\(x\)</span>).</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ DownOnlyMorphismData</code>( <var class="Arg">x</var> )</td><td class="tdright">( attribute )</td></tr></table></div>
<p>Returns: a GAP object</p>
<p>The argument is a morphism in a CAP category, the output consists of data which are needed to reconstruct <span class="SimpleMath">\(x\)</span> (e.g., by passing it to an appropriate constructor, possibly together with its source and range).</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ DownToBottom</code>( <var class="Arg">x</var> )</td><td class="tdright">( attribute )</td></tr></table></div>
<p>Returns: a GAP object</p>
<p>The argument is a GAP object <span class="SimpleMath">\(x\)</span>. This function iteratively calls <code class="code">Down</code> until it becomes stable.</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ SetDefaultCaching</code>( <var class="Arg">type</var> )</td><td class="tdright">( function )</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ SetDefaultCachingWeak</code>( )</td><td class="tdright">( function )</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ SetDefaultCachingCrisp</code>( )</td><td class="tdright">( function )</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ DeactivateDefaultCaching</code>( )</td><td class="tdright">( function )</td></tr></table></div>
<p>Sets the default caching behaviour, all new categories will have their caching set to either <code class="code">weak</code>, <code class="code">crisp</code>, or <code class="code">none</code>. The default at startup is <code class="code">weak</code>.</p>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ DisableInputSanityChecks</code>( <var class="Arg">category</var> )</td><td class="tdright">( function )</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ DisableOutputSanityChecks</code>( <var class="Arg">category</var> )</td><td class="tdright">( function )</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ EnablePartialInputSanityChecks</code>( <var class="Arg">category</var> )</td><td class="tdright">( function )</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ EnablePartialOutputSanityChecks</code>( <var class="Arg">category</var> )</td><td class="tdright">( function )</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ EnableFullInputSanityChecks</code>( <var class="Arg">category</var> )</td><td class="tdright">( function )</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ EnableFullOutputSanityChecks</code>( <var class="Arg">category</var> )</td><td class="tdright">( function )</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ DisableSanityChecks</code>( <var class="Arg">category</var> )</td><td class="tdright">( function )</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ EnablePartialSanityChecks</code>( <var class="Arg">category</var> )</td><td class="tdright">( function )</td></tr></table></div>
<div class="func"><table class="func" width="100%"><tr><td class="tdleft"><code class="func">‣ EnableFullSanityChecks</code>( <var class="Arg">category</var> )</td><td class="tdright">( function )</td></tr></table></div>
<p>Most operations can perform optional sanity checks on their arguments and results. The checks can either be partial (set by default), full, or disabled. With the following commands you can either enable the full checks, the partial checks or, for performance, disable the checks altogether. You can do this for input checks, output checks or for both at once.</p>
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung ist noch experimentell.