Getting Started with DESUMA2

From DESUMA Wiki
Getting Started with DESUMA2
Jump to: navigation, search

This is the tutorial page for DESUMA and UMDES.


Setting up UMDES

DESUMA is a Java based program to allow users of the UMDES library to graphically view results. To use UMDES, it must be downloaded. It can be downloaded here. After downloading UMDES, DESUMA must be pointed to the UMDES library to use its functions. To do this, select Edit>Preferences.... (Or on OSX, Desuma>Preferences....).

Under the profile tab, select the 'Browse...' button under the Plugins Directory. Locate where your copy of DESUMA is stored, and select the file umdes.xml in the umdes folder. Click OK and the plugin will be automatically loaded every time DESUMA is launched.

NOTE: On Linux/Unix/Mac systems, you may need to change the file permissions of the files if the library consists of executables. You can fix this by going to the directory of the executables and type in the command line "chmod+x *" or through the File Preferences for your operating system.


Creating States

States can be created via the command line or the batch window. It is possible to create states that initially have no markings, or it is possible to use flags to indicate that a state has special properties (e.g., initial, marked).

A state can also be added by right-clicking the graph and selecting "Add State" from the pop-up menu. Note that this method does not allow flagging.

Using the Command Line

There are two ways to create a state without flags:

-Type state state_name into the command line and press <Enter>.
-Type s state_name into the command line and press <Enter>.

Both commands achieve the same result. If the state is created, a circle-- or ellipse if state resizing is enabled-- with state_namedisplayed in the center will appear in the workspace. Also, the status bar will be updated with a message indicating success. The first state created becomes the initial state.

State names containing black spaces are not accepted by DESUMA.

Multiple States

Multiple states can be created via the command line or the batch window. For either case, the syntax is:

- Type multistate number_of_states into the command line and press <Enter>.
- Type ms number_of_states into the command line and press <Enter>.

The names of the states are automatically assigned based on the following rules:

- The least number of letters available from the word 'state', used sequentially, for which any state does not have that name.
- The lowest digit available [1,9].

Example: ms 3 will provide the states {s1, s2, s3} if these states do not already exist.


It is also possible to create a state and initially assign it some properties using the flags options. The syntax is as follows:

state state_name [flags]

s state_name [flags]

-i -I

tags the state as the initial state (graphically indicated by displaying the state in green)

-m -M

gives the state the marked property (graphically indicated by a double circle in the workspace)


-At any time, there may only be one initial state. New states created (or modified) as initial states will take the initial status from the previous initial state (if one exists).
-Flags must be preceded with a dash character.
-Flags are not available for the multistate command.


-state 1 -IM: creates an initial marked state named 1.
-s 34 -I: creates an initial state named 34.
-multistate 3: creates three states with default names.
-ms 20: creates twenty states with default names
Personal tools