Metadata-Version: 2.0
Name: gc3pie
Version: 2.5.1
Summary: A Python library and simple command-line frontend for computational job submission to multiple resources.
Home-page: http://gc3pie.readthedocs.io/
Author: Sergio Maffioletti, Antonio Messina, Riccardo Murri
Author-email: gc3pie-dev@googlegroups.com
License: LGPL
Description-Content-Type: UNKNOWN
Keywords: batch cloud cluster differential optimization ec2 gridengine job management large-scale data analysis openstack pbs remote execution sge slurm ssh torque workflow
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
Classifier: License :: DFSG approved
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Chemistry
Classifier: Topic :: System :: Distributed Computing
Requires-Dist: lockfile
Requires-Dist: paramiko
Requires-Dist: pycrypto
Requires-Dist: parsedatetime
Requires-Dist: python-daemon
Requires-Dist: pyyaml
Requires-Dist: sqlalchemy
Requires-Dist: blinker
Requires-Dist: coloredlogs
Requires-Dist: dictproxyhack
Requires-Dist: prettytable
Requires-Dist: pyCLI
Provides-Extra: daemon
Requires-Dist: inotifyx; extra == 'daemon'
Provides-Extra: ec2
Requires-Dist: boto; extra == 'ec2'
Provides-Extra: openstack
Requires-Dist: python-keystoneclient; extra == 'openstack'
Requires-Dist: python-glanceclient; extra == 'openstack'
Requires-Dist: python-neutronclient; extra == 'openstack'
Requires-Dist: python-novaclient; extra == 'openstack'
Requires-Dist: os-client-config; extra == 'openstack'
Provides-Extra: optimizer
Requires-Dist: numpy; extra == 'optimizer'

========================================================================
    GC3Pie |gitter|
========================================================================

.. |gitter| image:: https://badges.gitter.im/gc3pie/chat.svg
   :alt: Join the chat at https://gitter.im/gc3pie/chat
   :target: https://gitter.im/gc3pie/chat?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

.. This file follows reStructuredText markup syntax; see
   http://docutils.sf.net/rst.html for more information


GC3Pie is a suite of Python classes (and command-line tools built
upon them) to aid in submitting and controlling batch jobs to clusters
and grid resources seamlessly.  GC3Pie aims at providing the
building blocks by which Python scripts that combine several
applications in a dynamic workflow can be quickly developed.

The GC3Pie suite is comprised of three main components:

 * GC3Libs: A python package for controlling the life-cycle of a Grid or batch computational job
 * GC3Utils: Command-line tools exposing the main functionality provided by GC3Libs
 * GC3Apps: Driver scripts to run large job campaigns


GC3Libs
=======

GC3Libs provides services for submitting computational jobs to Grids
and batch systems and controlling their execution, persisting job
information, and retrieving the final output.

GC3Libs takes an _application-oriented approach to batch computing.  A
generic ``Application`` class provides the basic operations for
controlling remote computations, but different ``Application``
subclasses can expose adapted interfaces, focusing on the most
relevant aspects of the application being represented. Specific
interfaces are already provided for the GAMESS_ and Rosetta_ suites;
new ones can be easily created by subclassing the generic
``Application`` class.


GC3Utils
========

Most of the time users have lots of different accounts on several
diverse resources. The idea underlying GC3Utils is that a user can
submit and control a computational job from one single place with a few
simple commands.

Commands are provided to submit a job (``gsub``), check its running
status (``gstat``), get a snapshot of the output files (``gget``,
``gtail``), or cancel it (``gkill``).


GC3Apps
=======

There is a need in some scientific communities, to run large job
campaigns to analyze a vast number of data files with the same
application.  The single-job level of control implemented by GC3Utils
in this case is not enough: you would have to implement "glue scripts"
to control hundreds or thousand scripts at once.  GC3Pie has provisons
for this, in the form of re-usable Python classes that implement a
single point of control for job families.

The GC3Apps scripts are driver scripts that run job campaigns using
the supported applications on a large set of input data.  They can be
used in production as-is, or adapted to suit your data processing needs.


Installation instructions and further reading
=============================================

For up-to-date information, please read the GC3Pie documentation at:
http://gc3pie.readthedocs.io/

Installation instructions are in the `INSTALL.rst`_ file (in this
same directory), or can be read online at:
http://gc3pie.readthedocs.io/en/latest/users/install.html

.. _`INSTALL.rst`: https://github.com/uzh/gc3pie/blob/master/docs/users/install.rst


.. References

.. _GC3Pie: http://gc3pie.googlecode.com/
.. _GAMESS: http://www.msg.chem.iastate.edu/gamess/
.. _Rosetta: http://www.rosettacommons.org/


.. (for Emacs only)
..
  Local variables:
  mode: rst
  End:


