LOG IN / REGISTER
Esther Guide

Guide

General usage

To use Esther it is mandatory to first register and log in. After this procedure is completed, one can access the analyze page of Esther which serves as an interface to our tool-set for parameter identification. The interface consists of a data-tree, providing access to datafiles owned by the respective user or public to all, and a widget pane, where the content of individual files may be managed and the computation may be started. Opening a datafile spawns a window displaying its contents in the form of an appropriate widget. The core of Esther is a model-checker Parsybone. The modeling language of Pasrybone is described in this PDF manual.

Each user is provided with 500 MB of data storage and 2 server-side processes for computation.

Creating a model

To create a model, either copy one of the publicly available one that are stored in the public folder of the interface or create a new empty file using the button on the Start screen. A model is a multi-valued, multigraph described using our XML-based language DBM (a visual environment is currently being developed).

If you are not familiar with the framework of discrete regulatory models we can recommend for example the article Semantics of Biological Regulatory Networks.

DBM is built over XML, so if you are familiar with XML, you should be able to get the core ideas very quickly. For a swift overview of how the model works, you can see the example_model.dbm model in the Public folder in your file tree. The model is commented and provides all the necessary knowledge for understanding of how to create a model on your own.

Once a model is finished, it must be saved before starting the simulation.

Using the tools

Our tools operate on the server and provide quite strong computational capabilities. To use a tool it is usually sufficient to click an appropriate button in the current window. Clicking a button will start the respective program using the currently visible file and store its results to a new file of appropriate sort. The result file is usually created as a child of the source file, but in some cases it must be explicitly saved first.

Parsybone

Parsybone reads the model and enumerates all the parametrizations that satisfy static constraints imposed on the model. After enumeration, all the parametrizations are verified against a property specified in the model file. Those that satisfy the property are saved within an sqlite database file together with other relevant data that were gathered during the computation.

The result of the computation is not being stored automatically. Starting Parsybone creates an independent task that can be observed in the task list. To save the file, wait until the computation is finished and then click the save button.

Filter

Upon opening an sqlite file, a list of parametrizations of the model together with other relevant data is displayed. The size of the output is up to 128 members, if there are more, they are not being displayed. The current list can be filtered based on various criteria. For filtering, click the filter button on the bottom of the screen. This brings up an interface for constructing constraints. Each constraint is numerical comparison between the values in the database and the one specified by the constraint. To apply the constrain, use add for making it appear in the list and then apply to start the process itself.

Constrains can be saved in a filter file for later use.

Behaviour map

To visualise the dynamics of the simulation process, click the Behaviour map button at the bottom of the parameter list screen. Please note that for visualisation all parametrizations not just the visible 128 are used. The behaviour map will be created in form of an XGMML graph file under your filter/parameter set file. Also note that you have to save your filter if you want to use it for filtering visualised data.

The simulation is depicted using nodes to describe states of the simulation process and edges as transitions between them. The nodes coloured in shades of cyan represent measurements of the time series data whilst the gray ones depict steps in between the measurements. You can select individual nodes and edges to display additional information. (Drag and drop allows to select multiple elements at once.)

File management

We provide the file management system to allow easy manipulation with the data. To invoke file-related tools, right-click the respective file - this will create a floating list of options in that place. Whereas the functionality of most of the options are quite obvious, there are two cases that deserve closer attention.

To simplify collaboration we allow each user to publish his files. This is done by clicking the make public button. After this, the file can be read (not overwritten) by any registered user of Esther.

Each user is provided a 500 MB space for storing their files. Even though this may seem like a lot, the results of computation are usually quite spacious and it may quickly overrun the capacity. To preserve your files over the limit, you may download them using the respective button. The file may be later uploaded, if requested for further use.

Questions

In case of further interest, please send your questions to adam.streck [at] fu-berlin.de .