annotate README.rst @ 61:3ec27b4cee7c draft default tip

"planemo upload for repository https://github.com/galaxyproteomics/tools-galaxyp/tree/master/tools/peptideshaker commit fc2810c412d9954fa584ae74497562b986c52764"

GalaxyP - PeptideShaker
=======================

- Home: <https://github.com/galaxyproteomics/tools-galaxyp/>
- Galaxy Tool Shed: <http://toolshed.g2.bx.psu.edu/view/galaxyp/peptideshaker>
- Tools ID: `peptide_shaker`, `search_gui`, `ident_params`, `fasta_cli`


Description
-----------

Perform protein identification combining numerous search engines (using SearchGUI) followed by peptide and protein inference with PeptideShaker.

Includes tool wrappers for FastaCLI, IdentificationParametersCLI, SearchGUI and PeptideShaker.



FastaCLI adds decoy sequences to any fasta file.

The Identification Parameters tool allows to create a parameters (par) file which can be (re)used later to parameterize SearchGUI or PeptideShaker.

The SearchGUI tool takes any number of mgf files and performs searches on these. It creates a large zip archive with all search results, the original database and spectra.

This can then be fed to the PeptideShaker tool which merges the results and performs peptide and protein inference.


General Requirements
--------------------

To avoid out of memory errors you may need to set the maximum heapspace for java processes if the default is too small for the data you are going to process (4gb for SearchGUI, 1GB for PeptideShaker).
For example, to set this in your shell:

    export _JAVA_OPTIONS='-Xmx8192m'

On some systems you may also need to adjust the amount of memory available for class definitions in addition to the maximum heapspace. For example:

	export _JAVA_OPTIONS='-Xmx8192m -XX:MaxPermSize=1024m'

It is also possible to set this on a per tool basis using advanced features of the galaxy job config system.

MSAmanda on linux
-----------------

Running MS Amanda on Linux requires that you have Mono installed. Mono 3.2.1 or newer is required.  If you install via the toolshed Mono should be installed automatically, however if this does not work you can install it manually.

On ubuntu Mono can be installed as follows

	sudo apt-get install mono-runtime
	sudo apt-get install libmono-system-core4.0-cil

For more help on installing Mono please see http://www.mono-project.com/download.

Note
----

- Requires Galaxy release v20.01 or later.

See:

* <http://compomics.github.io/projects/peptide-shaker.html/>
* <http://compomics.github.io/projects/searchgui.html/>

GalaxyP Community
-----------------

Current governing community policies for GalaxyP_ and other information can be found at:

<https://github.com/galaxyproteomics>

.. _GalaxyP: https://github.com/galaxyproteomics/


License
-------

Copyright (c) 2014 Regents of the University of Minnesota and Authors listed below.

To the extent possible under law, the author(s) have dedicated all copyright and related and neighboring rights to this software to the public domain worldwide. This software is distributed without any warranty.

You should have received a copy of the CC0 Public Domain Dedication along with this software. If not, see <https://creativecommons.org/publicdomain/zero/1.0/>.

You can copy, modify, distribute and perform the work, even for commercial purposes, all without asking permission.


Contributing
------------

Contributions to this repository are reviewed through pull requests. If you would like your work acknowledged, please also add yourself to the Authors section. If your pull request is accepted, you will also be acknowledged in <https://github.com/galaxyproteomics/tools-galaxyp/>


Authors
-------

Authors and contributors:

* Bjoern Gruening <[e-mail]>
* Ira Cooke
* Cody Wang
* Fred Sadler
* John Chilton <[e-mail]>
* Gerben Menschaert
* Elvis Ndah
* Minnesota Supercomputing Institute, Univeristy of Minnesota
* Carlos Horro