Using the web interface

The web interface is built using the Django web framework, and requires that Django be installed (see Installation).

Starting the web interface

Before using the web interface, you must have created a Sumatra project using smt init.

To launch the web interface, in your project directory run:

$ smtweb &

This will launch a simple web server that listens on port 8000, and will automatically open a new tab in your browser at You can specify the -n option which will disable automatic opening of the new tab:

$ smtweb -n

If port 8000 is already in use, you can specify a different port with the -p option to smtweb, e.g.:

$ smtweb -p 8001

If you have a large dataset and the webpage loads slowly, using the serverside processing increases the performance of the website. This method fetchs only displayed records from the server instead of all records. You can specify the -s option to start the local server with serverside processing:

$ smtweb -s

If you are using a single record store for multiple projects, you can run smtweb from anywhere and specify the location of the record store on the command line, e.g.:

$ smtweb ~/sumatra.db

List of projects

When you first start smtweb, the first page you see is a list of your projects.


Click on the project name to see the records of your simulations/analyses in that project.

List of records

By default, your project is viewed from a process-centric point of view, i.e. one record for each computation performed. The list of records page contains a table with one row per computation, with the following columns:

  • label
  • date/time
  • reason
  • outcome
  • input data
  • output data
  • duration
  • number of processes
  • executable name and version
  • main file
  • code version
  • command line arguments
  • tags

You can change which columns to display by clicking on the settings icon.


Selecting records

Each record is represented as one row in the table. The rows can be selected and unselected by clicking on them. Actions that can be performed on selected rows are:

  • delete records
  • compare records

Deleting records

When deleting records, you have the option of also deleting any data generated by that simulation or analysis.


Comparing records

Any pair of records can be compared.


Filtering the records

You can filter the records by clicking on the ‘tag’ icon or by using the search field.

Accessing record details

You can access the record detail by clicking the corresponding label name in the main table. The record detail page contains the following sections:

  • general info
  • parameters
  • input data
  • output data
  • dependencies
  • platform information
  • stdout & stderr

Data view

To view the history of your project from a data-centric point of view, click on the “Data View” tab.


You can also see details about individual data items, including a preview of the file contents for file formats which Sumatra understands (e.g. images, CSV data).


Image View

To view the image-rendered outputs of the records, click on the “Image view” button.

To switch view option from table to thumbgrid click on symbols in top right corner.

In thumbgrid the site starts to fetch the first 8 images. If you want to load 8 more images click ‘load more’ button at the end of the page. Otherwise by clicking ‘load all’ button the page will display all images.

Finishing up

Don’t forget to kill the webserver process (e.g. with fg, Ctrl-C) when you are finished with it.

Customizing the web interface

You can customize the web interface on a per-project basis by placing your own Django templates in a “templates” subdirectory of the Sumatra ”.smt” directory. The best way to proceed is to copy the default templates from “/path/to/sumatra/web/templates” to “/path/to/myproject/.smt/templates” and then modify them.