Skip to content

Semaphore web application user guide

Alvin Sebastian edited this page Jul 8, 2013 · 2 revisions

User Guide

To use the Sempahore to manage and run your experiments online, you need an account for the particular instance that you want to use. The official instance can be accessed from http://semaphore.n2o.net.au. To request an account, please contact us. A demo account has been created for public trial and evaluation purpose. Note that anyone can create, modify, and delete any data associated with the demo account. Please refer to the main website for more information.

Managing Experiments

After logging in, click Models in the main menu to bring the list of experiments that you have created. If no experiment has been created, the list will empty. Use the side menu on the left side for quick navigation between experiments.

Experiments list

Creating an Experiment

To create a new experiment, press the New Experiment button at the bottom of the side menu. To proceed, a unique name must be entered and a model type must be selected. The model type is the name of modelling tool that will be used for all runs of the experiment. Other metadata information such as description and keywords are optional. Press save to finish creating the record. A panel showing the new experiment details will be displayed.

Experiment new

Working with the Experiment Panel

The experiment panel is divided into three main areas: Metadata, Input Files, and Experiment Runs. Press the Edit button to edit the metadata. Use the Delete button with caution as it will remove the experiment and all of its data.

Experiment show

Metadata

This area displays all the metadata information of the selected experiment.

Input Files

This area lists all the uploaded and linked input files. Any modification to existing input files are tracked as revisions. For each of the file, you can select the active revision. Use the download, view, and delete icons next to the filename to download, view, and delete a selected revision respectively.

Experiment Runs

This area provides the interface to run experiment and manage the run history.

Uploading Input Files

To upload one or more input files, press the Add button on the Input Files area. A popup dialog will be displayed. Select either:

  • Local upload : Upload a file or files from the local (your own) computer. Follow the instruction and select the files.
  • Remote upload : Upload or link a publicly accessible file from a remote server (HTTP or FTP) by entering the URL. A linked file is not copied to the Semaphore system.

Experiment upload input

Running an Experiment

To run the experiment, select the required input files, enter the name and description of the run, and hit Run Experiment. A new entry will be added to the list of Run History. The Status column will be updated in real time to indicate the progress:

  • queue : The experiment run is still queued in the server.
  • run : The modelling tool has been run with the given input files.
  • end : The run has finished and the results are available.

Click on the run name to show the details of the run, including all the input and output files.

Experiment run show

To see the experiment result, download or view the output files.

Experiment output

Clone this wiki locally