Welcome
=======

Theano is a Python library that allows you to define, optimize, and
evaluate mathematical expressions involving multi-dimensional
arrays efficiently. Theano features:

* **tight integration with numpy** -- Use `numpy.ndarray` in Theano-compiled functions.
* **transparent use of a GPU** -- Perform data-intensive calculations up to 140x faster than with CPU.
* **symbolic differentiation** -- Let Theano do your derivatives.
* **speed and stability optimizations** -- Get the right answer for ``log(1+x)`` even when ``x`` is really tiny.
* **dynamic C code generation** -- Evaluate expressions faster.
* **extensive unit-testing and self-verification** -- Detect and diagnose many types of mistake.

Theano has been powering large-scale computationally intensive scientific investigations
since 2007.  But it is also approachable enough to be used in the classroom
(IFT6266 at the University of Montreal).

Download
========

We recommend the latest development version, available via::

    hg clone http://hg.assembla.com/theano Theano

The theano subfolder should be on your ``$PYTHONPATH``.  For more information about
installation and configuration, see :ref:`installing Theano <install>`.

Documentation
=============

Roughly in order of what you'll want to check out:

* :ref:`install` -- How to install Theano.
* :ref:`introduction` -- What is Theano?
* :ref:`tutorial` -- Learn the basics.
* :ref:`libdoc` -- Theano's functionality, module by module.
* :ref:`optimizations` -- Guide to Theano's graph optimizations.
* :ref:`extending` -- Learn to add a Type, Op, or graph optimization.
* :ref:`internal` -- How to maintaining Theano, LISA-specific tips, and more...
* `API <api/>`_ -- The automatically-generated API

You can download the latest `PDF documentation <http://deeplearning.net/software/theano/theano.pdf>`_, rather than reading it online.

Check out how Theano can be used for Machine Learning: `Deep Learning Tutorials <http://www.deeplearning.net/tutorial>`_.

Community
=========

* Register and post to `theano-users`_ if you want to talk to all Theano users.

* Register and post to `theano-dev`_ if you want to talk to the developers.

* We try to stay organized with `Theano's Trac <http://trac-hg.assembla.com/theano/report/1>`__ 

* Come visit us in Montreal!  Most of the developers are students in the LISA_ group at the `University of Montreal`_.

.. toctree::
   :maxdepth: 1
   :hidden:

   NEWS
   introduction
   install
   tutorial/index
   library/index
   optimizations
   extending/index
   glossary
   links
   internal/index
   examples/index
   proposals/index
   LICENSE


.. _theano-dev: http://groups.google.com/group/theano-dev
.. _theano-users: http://groups.google.com/group/theano-users
.. _tickets: http://pylearn.org/theano/trac/query?status=accepted&status=assigned&status=new&status=reopened&group=milestone&max=200&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=component&col=time&report=9&order=priority

.. _LISA: http://www.iro.umontreal.ca/~lisa
.. _University of Montreal: http://www.umontreal.ca