Sumatra


NameSumatra JSON
Version 0.8.1 PyPI version JSON
download
home_pageNone
SummaryA tool for automated tracking of computation-based scientific projects
upload_time2025-07-14 15:36:40
maintainerNone
docs_urlhttps://pythonhosted.org/Sumatra/
authorNone
requires_python>=3.9
licenseNone
keywords computational science simulation analysis project management
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage No coveralls.
            =============
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 beta code, and should be used with caution and frequent
backups of your records.

For documentation, see http://neuralensemble.org/sumatra/


Functionality:

* 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 version 3.9 or later The web interface requires
Django (>= 4.2).
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 Bazaar there is nothing else to install. If you
are using Subversion you will need to install the pysvn package. If you are using
Git, you will need to install git-python bindings, and for Mercurial install hg-api.


============
Installation
============

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

The easiest way to install is with pip::

    $ pip install sumatra[default]

The "default" option installs the most commonly-used features:

- Git support
- the local web-based GUI
- support for remote record stores

Other options are available. For example, to install support for Mercurial and for using a
PostgreSQL database as the record store, run::

    $ pip install sumatra[default,hg,postgres]


===========
Code status
===========

.. image:: https://github.com/open-research/sumatra/actions/workflows/tests.yml/badge.svg
   :target: https://github.com/open-research/sumatra/actions/workflows/tests.yml
   :alt: Unit Test Status

.. image:: https://coveralls.io/repos/open-research/sumatra/badge.svg
   :target: https://coveralls.io/repos/open-research/r/sumatra
   :alt: Code coverage

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "Sumatra",
    "maintainer": null,
    "docs_url": "https://pythonhosted.org/Sumatra/",
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "computational science, simulation, analysis, project management",
    "author": null,
    "author_email": "Sumatra authors and contributors <andrew.davison@cnrs.fr>",
    "download_url": "https://files.pythonhosted.org/packages/b8/00/7dd9d6ddb39948be31776364ecb39d07149333e6a6caa6e9c6e1afe2c62c/sumatra-0.8.1.tar.gz",
    "platform": null,
    "description": "=============\nAbout Sumatra\n=============\n\nSumatra is a tool for managing and tracking projects based on numerical\nsimulation and/or analysis, with the aim of supporting reproducible research.\nIt can be thought of as an automated electronic lab notebook for computational\nprojects.\n\nIt consists of:\n\n* a command-line interface, smt, for launching simulations/analyses with\n  automatic recording of information about the experiment, annotating these\n  records, linking to data files, etc.\n* a web interface with a built-in web-server, smtweb, for browsing and\n  annotating simulation/analysis results.\n* a Python API, on which smt and smtweb are based, that can be used in your own\n  scripts in place of using smt, or could be integrated into a GUI-based\n  application.\n\nSumatra is currently beta code, and should be used with caution and frequent\nbackups of your records.\n\nFor documentation, see http://neuralensemble.org/sumatra/\n\n\nFunctionality:\n\n* launch simulations and analyses, and record various pieces of information,\n  including:\n\n  - the executable (identity, version)\n  - the script (identity, version)\n  - the parameters\n  - the duration (execution time)\n  - console output\n  - links to all data (whether in files, in a database, etc.) produced by\n    the simulation/analysis\n  - the reason for doing the simulation/analysis\n  - the outcome of the simulation/analysis\n\n* allow browsing/searching/visualising the results of previous experiments\n* allow the re-running of previous simulations/analyses with automatic\n  verification that the results are unchanged\n* launch single or batch experiments, serial or parallel\n\n\n============\nRequirements\n============\n\nSumatra requires Python version 3.9 or later The web interface requires\nDjango (>= 4.2).\nSumatra requires that you keep your own code in a version control\nsystem (currently Subversion, Mercurial, Git and Bazaar are supported). If you\nare already using Bazaar there is nothing else to install. If you\nare using Subversion you will need to install the pysvn package. If you are using\nGit, you will need to install git-python bindings, and for Mercurial install hg-api.\n\n\n============\nInstallation\n============\n\nThese instructions are for Unix and Mac OS. They may work on Windows as well, but\nit hasn't been thoroughly tested.\n\nThe easiest way to install is with pip::\n\n    $ pip install sumatra[default]\n\nThe \"default\" option installs the most commonly-used features:\n\n- Git support\n- the local web-based GUI\n- support for remote record stores\n\nOther options are available. For example, to install support for Mercurial and for using a\nPostgreSQL database as the record store, run::\n\n    $ pip install sumatra[default,hg,postgres]\n\n\n===========\nCode status\n===========\n\n.. image:: https://github.com/open-research/sumatra/actions/workflows/tests.yml/badge.svg\n   :target: https://github.com/open-research/sumatra/actions/workflows/tests.yml\n   :alt: Unit Test Status\n\n.. image:: https://coveralls.io/repos/open-research/sumatra/badge.svg\n   :target: https://coveralls.io/repos/open-research/r/sumatra\n   :alt: Code coverage\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A tool for automated tracking of computation-based scientific projects",
    "version": "0.8.1",
    "project_urls": {
        "documentation": "https://sumatra.readthedocs.io",
        "download": "http://pypi.python.org/pypi/sumatra",
        "homepage": "https://neuralensemble.org/sumatra",
        "repository": "https://github.com/open-research/sumatra"
    },
    "split_keywords": [
        "computational science",
        " simulation",
        " analysis",
        " project management"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "545beaddb6db2812f32bad95dceb17f9928579827cdf48e28757d2b98439c623",
                "md5": "6f1911b38eced444e1cd8fda903770ca",
                "sha256": "cf5caf6ea1e05774abb3d6f669193a74a25da49e6b4195564f1d57bc421112a7"
            },
            "downloads": -1,
            "filename": "sumatra-0.8.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6f1911b38eced444e1cd8fda903770ca",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 369385,
            "upload_time": "2025-07-14T15:36:38",
            "upload_time_iso_8601": "2025-07-14T15:36:38.609060Z",
            "url": "https://files.pythonhosted.org/packages/54/5b/eaddb6db2812f32bad95dceb17f9928579827cdf48e28757d2b98439c623/sumatra-0.8.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b8007dd9d6ddb39948be31776364ecb39d07149333e6a6caa6e9c6e1afe2c62c",
                "md5": "21a44eb2af3bf50f0644bc7858036b21",
                "sha256": "5b73e6c6081dce356669373d7a22acf582a3c03e790d1cc6df8991f008e4b407"
            },
            "downloads": -1,
            "filename": "sumatra-0.8.1.tar.gz",
            "has_sig": false,
            "md5_digest": "21a44eb2af3bf50f0644bc7858036b21",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 2109469,
            "upload_time": "2025-07-14T15:36:40",
            "upload_time_iso_8601": "2025-07-14T15:36:40.452390Z",
            "url": "https://files.pythonhosted.org/packages/b8/00/7dd9d6ddb39948be31776364ecb39d07149333e6a6caa6e9c6e1afe2c62c/sumatra-0.8.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-14 15:36:40",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "open-research",
    "github_project": "sumatra",
    "travis_ci": true,
    "coveralls": false,
    "github_actions": true,
    "lcname": "sumatra"
}
        
Elapsed time: 1.91237s