Merge pull request #1338 from scolobb/ct0-base-classes

Implement CT Base Classes
sympy · Jun 18, 2012 · d1ff275 · d1ff275
2 parents 1052b45 + 9e0f2a1
commit d1ff275
Show file tree

Hide file tree

Showing 12 changed files with 1,337 additions and 1 deletion.
diff --git a/doc/src/modules/categories.txt b/doc/src/modules/categories.txt
@@ -0,0 +1,46 @@
+Category Theory Module
+======================
+
+.. module:: sympy.categories
+
+Introduction
+------------
+
+The category theory module for SymPy will allow manipulating diagrams
+within a single category, including drawing them in TikZ and deciding
+whether they are commutative or not.
+
+The general reference work this module tries to follow is
+
+  [JoyOfCats] J. Adamek, H. Herrlich. G. E. Strecker: Abstract and
+              Concrete Categories. The Joy of Cats.
+
+The latest version of this book should be available for free download
+from
+
+   katmat.math.uni-bremen.de/acc/acc.pdf
+
+The module is still in its pre-embryonic stage.
+
+Base Class Reference
+--------------------
+.. autoclass:: Object
+   :members:
+
+.. autoclass:: Morphism
+   :members:
+
+.. autoclass:: NamedMorphism
+   :members:
+
+.. autoclass:: CompositeMorphism
+   :members:
+
+.. autoclass:: IdentityMorphism
+   :members:
+
+.. autoclass:: Category
+   :members:
+
+.. autoclass:: Diagram
+   :members:
diff --git a/doc/src/modules/index.txt b/doc/src/modules/index.txt
@@ -47,6 +47,7 @@ access any SymPy module, or use this contens:
    utilities/index.txt
    parsing.txt
    physics/index.txt
+   categories.txt
 
 Contributions to docs
 ---------------------

diff --git a/sympy/categories/__init__.py b/sympy/categories/__init__.py
@@ -0,0 +1,22 @@
+"""
+Category Theory module.
+
+Provides some of the fundamental category-theory-related classes,
+including categories, morphisms, diagrams.  Functors are not
+implemented yet.
+
+The general reference work this module tries to follow is
+
+  [JoyOfCats] J. Adamek, H. Herrlich. G. E. Strecker: Abstract and
+              Concrete Categories. The Joy of Cats.
+
+The latest version of this book should be available for free download
+from
+
+   katmat.math.uni-bremen.de/acc/acc.pdf
+
+"""
+
+from baseclasses import (Object, Morphism, IdentityMorphism,
+                         NamedMorphism, CompositeMorphism, Category,
+                         Diagram)