.. _contents:

####################################
Welcome to PyCogent's documentation!
####################################

**Contents**

.. toctree::
    :maxdepth: 1
    
    install
    README
    coding_guidelines
    data_file_links
    examples/index
    cookbook/index
    developer_notes
    scripting_guidelines
    licenses
    ChangeLog


.. todolist::

********
Overview
********

PyCogent is a software library for genomic biology. It is a fully integrated and thoroughly tested framework for: controlling third-party applications; devising workflows; querying databases; conducting novel probabilistic analyses of biological sequence evolution; and generating publication quality graphics. It is distinguished by many unique built-in capabilities (such as true codon alignment) and the frequent addition of entirely new methods for the analysis of genomic data.

Our primary goal is to provide a collection of rigourously validated tools for the manipulation and analysis of genome biology data sets. The project is routinely employed in numerous labs across the world and has provided essential capabilities for many high profile publications, e.g. `Nature 2009 457:480-4`_, `PNAS 2008 105:17994-9`_, `Science 2008 320:1647-51`_, `Nature 2008 453: 175-83`_ and `Nat Genet 2007 39: 1261-5`_.

*************************
Contacts and contributing
*************************

If you find a bug or have feature/documentation requests, please create a new issue on our GitHub `issue tracker <https://github.com/pycogent/pycogent/issues>`_. If you have any questions, please create a new issue on the `issue tracker <https://github.com/pycogent/pycogent/issues>`_ and tag it with the *question* tag. We appreciate your input!

********
Citation
********

If you use this software for published work please cite -- `Knight et al., 2007, Genome Biol, 8, R171 <http://genomebiology.com/2007/8/8/R171>`_.

******
Search
******

* :ref:`search`

.. _`Nature 2009 457:480-4`: http://www.ncbi.nlm.nih.gov/pubmed/19043404?ordinalpos=6&itool=EntrezSystem2.PEntrez.Pubmed.Pubmed_ResultsPanel.Pubmed_DefaultReportPanel.Pubmed_RVDocSum
.. _`PNAS 2008 105:17994-9`: http://www.ncbi.nlm.nih.gov/pubmed/19004758?ordinalpos=7&itool=EntrezSystem2.PEntrez.Pubmed.Pubmed_ResultsPanel.Pubmed_DefaultReportPanel.Pubmed_RVDocSum
.. _`Science 2008 320:1647-51`: http://www.ncbi.nlm.nih.gov/pubmed/18497261?ordinalpos=12&itool=EntrezSystem2.PEntrez.Pubmed.Pubmed_ResultsPanel.Pubmed_DefaultReportPanel.Pubmed_RVDocSum
.. _`Nature 2008 453: 175-83`: http://www.ncbi.nlm.nih.gov/pubmed/18464734?dopt=Citation
.. _`Nat Genet 2007 39: 1261-5`: http://www.ncbi.nlm.nih.gov/pubmed/17828264?dopt=Citation

**********************
News and Announcements
**********************

PyCogent News and Announcements are available via the News and Announcements Blog at http://pycogent.wordpress.com.

`Subscribe to the News and Annoucements RSS Feed <http://pycogent.wordpress.com/feed>`_
