WMT tutorial

From CSDMS
Revision as of 14:39, 16 May 2014 by Mpiper (talk | contribs)

The CSDMS Web Modeling Tool (WMT) is the web-based successor to the desktop CSDMS Modeling Tool (CMT). WMT allows users to build and run coupled surface dynamics models on a high-performance computing cluster (HPCC) from a web browser on a desktop, laptop or tablet computer.

This article gives a short tutorial on how to use WMT. For an overview of the buttonology of WMT, please see WMT Help.

Open WMT

In a web browser, go to

https://csdms.colorado.edu/wmt

to open WMT.

Sign in

Sign in to WMT with an email and a password.

WMT-sign-in.png

You have to be signed in to save and run models. If this is the first time you're signing in to WMT, you'll be prompted to repeat your password.

Select a driver for the model

To create a new model in WMT, you must start by selecting a component to act as the driver of the model.

In the Model panel, click the driver button and choose HydroTrend from the list of components displayed.

WMT-select-driver.png

This adds HydroTrend as the driver of the model, as the Model panel now shows.

WMT-Hydrotrend-driver.png

WMT has also given a generic Model title to the new model, based on the name of the driver component. We'll chose a more specific title when we save the model.

Get information on a model component

The HydroTrend model component you just added now acts as a button. Clicking it displays a new menu with a set of actions that can be performed on the model component.

WMT-action-menu.png

Let's choose to Get information on HydroTrend. Selecting this menu item displays a pop-up window giving the component name, version, DOI, a brief summary of its functionality, a link to the component's help page, and the author of the component.

WMT-component-info.png

For detailed infomation, you can follow the link to the component help page on the CSDMS web site.

Edit a component parameter

When HydroTrend was selected, its parameters were displayed in the Parameter panel.

WMT-Hydrotrend-parameters.png

Each parameter used by HydroTrend is listed with a reasonable default value chosen by the developer. Each parameter is also editable.

Try hovering over the first parameter, Simulation run time.

WMT-parameter-range.png

Note that the range of possible values for this parameter is displayed as a tooltip.

Change the Simulation run time parameter from 100 to 50 days by entering the value 50 (days) in the parameter's value box and selecting the <Enter> key. Note that you can use scientific notation: 50 could be entered as 5E1. [1]

If an out-of-range value is entered for a parameter, the value box turns red.

WMT-out-of-range-parameter.png

A model can still be saved and executed with out-of-range parameters present, but the results may be invalid. For this tutorial, use an in-range value of 50 (days).

Add labels to the model

Model labels are used to group and categorize models in WMT. Attaching labels to a model can help make it easier to find the model at a later time.

Save the model

Next, save the model by selecting the WMT-save-button.png Save button in the Model panel.

The model is saved at CSDMS. Anywhere you can access WMT, you can access your saved models. For example, you could design a model at your office, save it, and open it again on your home computer to edit it.

Give the model a name.

Note that labels are selected: HydroTrend and your email address. Make a new label that describes this model. (E.g., "tutorial")

Run the model

Standalone mode.

Check the status page.

Download the model output

Foo.

Notes

  1. Note the use of uppercase "E"; lowercase "e" won't work.

-- Mpiper (talk) 17:08, 15 May 2014 (MDT)