Skip to main content

A tool for automated tracking of computation-based scientific projects

Project description

About Sumatra

Sumatra is a tool for managing and tracking projects based on numerical simulation and/or analysis, with the aim of supporting reproducible research. It can be thought of as an automated electronic lab notebook for computational projects.

It consists of:

  • a command-line interface, smt, for launching simulations/analyses with automatic recording of information about the experiment, annotating these records, linking to data files, etc.

  • a web interface with a built-in web-server, smtweb, for browsing and annotating simulation/analysis results.

  • a Python API, on which smt and smtweb are based, that can be used in your own scripts in place of using smt, or could be integrated into a GUI-based application.

Sumatra is currently alpha code, and should be used with caution and frequent backups of your records.

For documentation, see http://packages.python.org/Sumatra/ and http://neuralensemble.org/sumatra/

Intended functionality (not all implemented yet):

  • launch simulations and analyses, and record various pieces of information, including:

    • the executable (identity, version)

    • the script (identity, version)

    • the parameters

    • the duration (execution time)

    • console output

    • links to all data (whether in files, in a database, etc.) produced by the simulation/analysis

    • the reason for doing the simulation/analysis

    • the outcome of the simulation/analysis

  • allow browsing/searching/visualising the results of previous experiments

  • allow the re-running of previous simulations/analyses with automatic verification that the results are unchanged

  • launch single or batch experiments, serial or parallel

Requirements

Sumatra requires Python versions 2.6 or 2.7. The web interface requires Django (>= 1.2) and the django-tagging package. Sumatra requires that you keep your own code in a version control system (currently Subversion, Mercurial, Git and Bazaar are supported). If you are already using Mercurial or Bazaar there is nothing else to install. If you are using Subversion you will need to install the pysvn package. If you using Git, you will need to install git-python bindings.

Installation

These instructions are for Unix, Mac OS X. They may work on Windows as well, but it hasn’t been thoroughly tested.

If you have downloaded the source package, Sumatra-0.4.0.tar.gz:

$ tar xzf Sumatra-0.4.0.tar.gz
$ cd Sumatra-0.4.0
# python setup.py install

The last step may have to be done as root.

Alternatively, you can install directly from the Python Package Index:

$ pip install sumatra

or:

$ easy_install sumatra

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Sumatra-0.4.0.tar.gz (1.4 MB view details)

Uploaded Source

File details

Details for the file Sumatra-0.4.0.tar.gz.

File metadata

  • Download URL: Sumatra-0.4.0.tar.gz
  • Upload date:
  • Size: 1.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for Sumatra-0.4.0.tar.gz
Algorithm Hash digest
SHA256 c840ee5958e4bcf48b8fe3c27d81daa4b76b12a329c974e5aaeb319925fce673
MD5 fd9f2592f5329f23bf151056d713d7ca
BLAKE2b-256 51ca37d11f5a496acac12b5c097738127c4f5276ead20de8f1bc9daf92fb09a9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page