Skip to content. | Skip to navigation

Personal tools
Log in

DIstributed Computing Environments (DICE) Team
We are a group of computer scientists and IT experts from the Department of Computer Science AGH and ACC Cyfronet AGH. We are a curiosity- and research-driven team, specializing in large-scale distributed computing, HPC, Web and Cloud technologies. We develop new methods, tools and environments and we apply these solutions in e-Science, healthcare and industrial domains.

You are here: Home Projects Projects full descriptions Mapper-files MAD User Manual

MAD User Manual

MAD (Multiscale Application Designer) is a web application used to build an abstract multiscale application out of a set of submodels and mappers which come from the MML notation. The applications can be stored in a dedicated repository for further use or to be shared with other users. The tool is extended with a reservation manager which lets users reserve time slots on the execution sites for the applications to be run. The abstract applications with the reservation information can be exported to an executable experiment run in the GridSpace environment.


Building multiscale applications

Building multiscale applications in MAD is straightforward. By using a drag-and-drop mouse technique, submodels or mappers can be dragged from the list on the left to the workspace area (the dotted area in the middle) like in Figure 1.


Fig. 1: Dragging submodels or mappers to the workspace area to build an application.

After a node is dropped onto the workspace area, it is highlighted with a reddish colour. This means it is the active node and can be deleted by pressing the Delete key. To make any of the nodes active, just click it. A node can be moved around the workspace by holding the left mouse button pressed on it.

After at least two nodes are present in the workspace area, their ports can be connected. To do that, press one of the ports and then press the other. The result of this operation is presented in Figure 2.


Fig. 2: Nodes are connected by clicking input and output ports.

Note that you cannot connect two input or output ports together. To remove a connection, highlight it by clicking the connecting line (it should become red) and press the Delete key (do not forget to deselect the active node or it will be also deleted). By adding and deleting nodes and making new connections you can build complex multiscale applications.

The lower part of MAD is a property editor in which you can modify the active node's parameters which are registered in the MaMe repository. If a given node represents a submodel or mapper which has many implementations, one of them can be chosen by picking the corresponding value in the radio list. For tightly coupled sections, the property editor groups all the nodes which belong to the section under a common tab. Picking one of the tabs activates a corresponding node and vice versa.


Using application repository

Each of the applications created in MAD can be stored in the application repository for further development or to share it with other users. Access scope to all applications stored in the repository is global and all users can use them. To open a previously saved application, click the "Open from repository" button in the menu on the right, pick one of the applications from the pop-up window and click the "Open" button.


Fig. 3: The list of saved applications.

To save a new application in the repository, build it and then click the "Save in repository" button in the menu on the right. A pop-up will appear where you need to provide name and description of the application. After the saving is done, the application is available straight away in the repository list. An application which is saved, can only be removed by using the MaMe repository directly. The application save pop-up is presented in the picture below.


Fig. 4: Simple data provided when saving an application in the repository.

Note that the application is saved together with all the values of the parameters changed in the property editor.

Managing reservations

For nodes which belong to a tightly coupled section, reservations can be managed directly in MAD. To manage reservations, an application with a tightly coupled section has to be built and a valid user proxy is necessary to open the reservation manager by clicking the Reservations button. After doing it, a view similar to the following should appear.


Fig. 5: Reservation manager for three tightly coupled nodes.

For each of the tightly coupled nodes different reservation types can be chosen. In the case of an automatic reservation, a time slot needs to be set in the lower part of the view. For manual reservation the ID needs to be provided in the corresponding text field. To create new reservation the "Reservation manager" button should be clicked. The identifiers of created reservations will be available in the selection lists next to the node names. After closing the dialog, the reservation information is stored and will be used during exporting the application to a GridSpace Experiment Workbench runtime.


Exporting applications to Experiment Workbench

When an application is ready and optionally the reservation information is available, it can be exported to an EW (Experiment Workbench) experiment to be executed. There are two ways to do this. First one is to use the "Export to EW experiment" option from the menu on the right. This option generates the final experiment as a downloadable content for viewing. This can become helpful for debugging purposes. The second option opens the experiment directly in the workbench. This is done by clicking the "Open in Experiment Workbench" button from the menu. If the user was not previously logged in EW, a login screen should be displayed and after a successful login operation the experiment is opened.

Copyright owner of Multiscale Application Designer is DIstributed Computing Environments (DICE) Team who makes it available to public under open source MIT license .

NOTE! This web site uses cookies and similar technologies (if you do not change the browser settings, you agree to this).

cyfronet agh