RAMMS 1.3.0

RAMMS 1.3.0

6 Program Overview

RAMMS is a windows-based program that relies on drop-down menus and dialogue boxes to set the model parameters, run calculations and view results. Toolbar buttons are also available and provide short-cuts of the menu paths; moving the cursor over a button results in a short explanation, appearing in a text box below the cursor (’tooltip’). For functions not available in the current context, the menus and buttons are deactivated and cannot be used.

77

CHAPTER 6. PROGRAM OVERVIEW

Figure 6.1: Graphical user interface (GUI).

6.1 The Graphical User Interface (GUI)

The graphical user interface (GUI), see figure

6.1

on page

78 , consists of menu bar, horizon-

tal and vertical toolbar, main window, time step slider, right and left status bar, colorbar and panel. They will be explained in the following sections.

6.1.1 The menu bar

Track

Similar to the Microsoft Windows ’File’ menu, ’Track’ is used to open, close, save, print, backup and export files.

New... I Project Wizard

Start a new project, guided by the avalanche wizard (Ctrl+w).

New... I Convert XYZ − > ASCII Grid

Convert laser scanning data into a ESRI ASCII grid.

Open... I Input File

78 RAMMS User Manual

6.1. THE GRAPHICAL USER INTERFACE (GUI)

Open an existing input file (*.av2) (Ctrl+O).

Open... I Avalanche Simulation

Open existing avalanche simulation (select the folder containing the simulation files)

(Ctrl+A).

Close

Close active file (input or output).

Save

Save active file (Ctrl+S)

Save Copy As

Save a copy of the active file (e.g. test.av2 ) under a new name (e.g. simulation1.av2, works only in input mode). But, RAMMS stays with the active file (test.av2 )!

Export... I Export Display To Image File Create a Image of the active window in a chosen formate. You can chose the desired image format using the file extension (e.g.

.png, .jpg, .gif, .tif etc.)

Export... I Export GIF Animation Create a GIF Animation of the simulation (only in OUTPUT mode). Change GIF Animation Interval (s) in the Avalanche tab of the preferences.

Export... I Export Display To EPS Create an EPS-file of the active window.

Backup...

I Backup RAMMS Version Make a backup of the current RAMMS version.

Backup... I Backup Active Project Backup your active project. The user will be asked if he wants to include output files in the backup. This function is useful when having problems with a simulation. Make a backup and send the zip-file together with some explanations to [email protected] Make sure that all your input data (release area shapefiles, MuXi files, domain files, etc...) is in the project folder.

Backup...

I Backup User-Defined Files/Folders Backup any folder or files you want.

Preferences Change RAMMS preferences.

Log files... I RAMMS Logfile (current) Show active RAMMS logfile.

Log files... I RAMMS Logfile (last session) If RAMMS crashed, open this logfile

WSL Institute for Snow and Avalanche Research SLF 79

CHAPTER 6. PROGRAM OVERVIEW and copy/paste the content into an email to [email protected]

Install CYGWIN/GRASS Install CYGWIN and GRASS.

Exit Exit RAMMS (Ctrl+Q).

Edit

This menu is used to edit colorbar and dataspace properties. It is active only in input mode.

Edit Colorbar Properties Edit the colorbar properties.

Edit Dataspace Properties Edit your dataspace properties.

Input

Menu used to specify the global parameters, the calculation domain, release area, friction parameters and forest cover. This menu is active only in input mode.

80 RAMMS User Manual

Global Parameters

6.1. THE GRAPHICAL USER INTERFACE (GUI)

Change the global parameters

(avalanche return period, volume category)

Calculation

Domain... I

Draw New Calculation Domain

Load Existing Domain

This activates the button to draw a new calculation domain.

The mouse cursor changes to an arrow.

Load a existing calculation domain (*.dom) drawn and saved before

Release

Area... I

Draw New Release

Areas

Load Existing Release Areas

View and Edit Release Areas

This activates the button to draw new release areas. The mouse cursor changes to an arrow.

Load an existing release area shapefile.

The mouse cursor changes to an arrow and you can select release areas to define the release height and to view re-

Crop Release Area lease area information. This works only in 2D mode.

If your release area shapefile consists of several polygons, you can crop some of

Friction

Values... I

Load Existing MuXi

File them and create a new release shapefile.

Load afore created MuXi file

(*muxi.shp).

Create New MuXi

File (Automatic Procedure)

The DEM is analysed, classified and according to altitude, slope and curvature information, a new MuXi file is cre-

Show MuXi Classification ated.

Shows the result of the MuXi classification.

WSL Institute for Snow and Avalanche Research SLF 81

CHAPTER 6. PROGRAM OVERVIEW

Forest... I Draw New Forest

Area

Show Active Forest

Cover

Import Forest Area

From SHAPEFILE

Import Forest Area

From ASCII Grid

Remove Active Forest Cover

The mouse cursor changes to an arrow and you can draw new forest areas. Save the forest shapefile and then use the function below (Import Forest

Area From SHAPEFILE) to import the forest cover.

If forest cover is taken into account, the corresponding shapefile is displayed. If your project uses no forest cover at the moment, RAMMS will tell you so.

If a forest shapefile has been drawn (using ) it can be imported using this function.

If a forest ASCII grid is available, it can be imported using this function (0=no forest, 1

= forest).

Remove the active forest raster data from the project.

82 RAMMS User Manual

6.1. THE GRAPHICAL USER INTERFACE (GUI)

Show

This menu enables and disables the different visualizations. A little arrow indicates if the visualization is enabled or disabled.

Show Lights

Show Grid

Show Map

Show Image

Show/hide light effects

Show/hide computational grid

Show map

Show orthophoto/image

Show Release Area/Simulation Show/hide release area (input mode) or simulation results (output mode)

Show Isotropic View Switch between realistic (isotropic) and anisotropic view

Show Colorbar

Show Bottom Color

Show Arrow

Show Line Profile

Show Domain

Show/hide colorbar

Show/hide 0-color

OUTPUT — Show/hide point arrow of time plot

OUTPUT — Show/hide line of line profile

Show/hide calculation domain area

(only in input mode)

WSL Institute for Snow and Avalanche Research SLF 83

CHAPTER 6. PROGRAM OVERVIEW

Run

This menu is active only in input mode.

Run Avalanche Simulation Opens the module parameter window to change parameters and to start the calculation

Results

This menu contains the results functions and is only active in output mode.

84 RAMMS User Manual

Flow Height

Flow Velocity

Flow Pressure

Flow Momentum

Max

Values... I

6.1. THE GRAPHICAL USER INTERFACE (GUI)

Shows flow height of the avalanche for every time step.

Shows flow velocity of the avalanche for every time step.

Shows flow pressure of the avalanche for every time step.

Shows flow momentum of the avalanche for every time step.

Max Flow Height

Max Velocity

Max Pressure

Max Momentum

Displays the maximum flow height for each cell.

Displays the maximum velocity for each cell.

Displays the maximum pressure for each cell.

Displays the maximum momentum for each cell.

DEM

Adaptations I

Add Deposition to

DEM

Adds the deposition of an avalanche simulation to a new

DEM.

Flow

Analysis... I

Summary of Moving

Mass

Friction

Parameters I

Mu

Xi

Summarizes the Moving

Mass.

Display mu for this simulation.

Display xi for this simulation.

WSL Institute for Snow and Avalanche Research SLF 85

CHAPTER 6. PROGRAM OVERVIEW

GIS/GRASS

This menu contains GIS and GRASS functions.

Import Polygon Shapefile

Convert Shapefile...

Import a ESRI GIS polygon shapefile.

Converts a normal polygon shapefile into a RAMMS release file or a

RAMMS forest file.

This function makes only sense in the input mode.

Export Results As Shapefile Export the active results to an ESRI

GIS shapefile for later use in a GIS program.

Export Results As ASCII Grid Export the active results to an ESRI

ASCII Grid for later use in a GIS program.

Add Dam to DEM...

Adds a Dam to the DEM. You have to specify relative Dam height or absolute

Dam elevation.

Show Slope Angle (

)

Show Curvature (1/m)

Show Contour Plot

Resample Slope/Curvature

Display the slope angles.

Display the curvatures.

Display a contour plot.

Normally, slope and curvatures are calculated for a grid resolution of 10m.

You can change this resolution by using this function.

GRASS Advanced...

GRASS Logfiles...

These are advanced GRASS functions.

You should only use them if you know what you are doing.

Logfiles of all the GRASS functions are provided here. If your MuXi file looks strange, have a look at the MuXi Logfile.

86 RAMMS User Manual

6.1. THE GRAPHICAL USER INTERFACE (GUI)

Extras

Add/Change or Remove map Add or change the topographic map of your project.

The maps have to be located in your distribution’s ’Map’ folder, see section

3.5

for details. If not, you can browse for the maps.

Add/Change or Remove Imagery Add, change or remove the imagery used for visualization of your project.

The images have to be located in your distribution’s ’IMAGE’ folder, see section

3.5

for details.

If not, you can browse for the images.

Point...

Profile...

Save Active Position

Reload Position

Google Earth...

Used to select points in OUTPUT mode, save point locations and export

Time Plot Data.

Used to draw a profile in OUTPUT mode, save profile points and export

Profile Plot Data.

Save your current state of view, as well as the enabled and disabled visualizations.

Reload your saved position.

Map Options

This function exports release areas, muxi files and your results to Google

Earth. See Map Options for map settings for areas outside of Switzerland.

Dialogue window to enter map settings

(projection, datum, offsets...) for areas outside of Switzerland.

WSL Institute for Snow and Avalanche Research SLF 87

CHAPTER 6. PROGRAM OVERVIEW

Project

This menu contains the project input and output logfiles.

Project Input Log

Displays the input logfile.

Project Output Log

Displays the output logfile. The input logfile is appended to the output logfile.

Help

Manuals... I

RAMMS web...

Updates...

About

RAMMS...

License Agreement...

Release Notes

User Manual (PDF) RAMMS User Manual

Friction Parameter RAMMS friction parameter

Table (PDF) table

RAMMS Homepage at http://ramms.slf.ch

Download RAMMS updates manually or directly from the web

About dialog window

RAMMS License Agreement

Information

RAMMS release about the

88 RAMMS User Manual

6.1. THE GRAPHICAL USER INTERFACE (GUI)

6.1.2 Horizontal toolbar

Project wizard: open avalanche wizard for creating a new avalanche project.

Open input file.

Open simulation.

Save copy as: save the active file under a new name (input).

Close: close the active file (input and output).

Print: displays the Windows print manager.

Undo, Redo.

Arrow (move and resize), Rotate, Move.

Simulation Results: Choose this function and move the arrow over the topography → x-, y- and z-Coordinates of the mouse position are shown in the lower right status bar (see below).

OUTPUT | If you move the arrow over the simulation data, the active parameter is shown as well (see right value in the figure below). If you click once with the left mouse button at a point of interest, a new window pops up called ’RAMMS::Avalanche Time

Plot <Active Parameter>’.

INPUT, 2D | Crop Release Areas: Click this button to make a selection of the release area polygons you want to crop.

INPUT, 2D | View and Edit Release Areas.

INPUT, 2D | Create new release area: specify new polygon-points by clicking with left mouse button, for the last polygon-point use a double-click to finish. The user is asked if he wants to draw more release areas. At last, he has to specify a new filename for the release area.

INPUT, 2D | Create new forest area: specify new polygon-points by clicking with left mouse button, for the last polygon-point use a double-click to finish. The user is asked if he wants to draw more forest areas. At last, he has to specify a new filename for the forest area.

WSL Institute for Snow and Avalanche Research SLF 89

CHAPTER 6. PROGRAM OVERVIEW

INPUT, 2D | Create new domain area: specify a new domain polygon by clicking with left mouse button, for the last polygonpoint use a double-click to finish. A dialogue box will then ask the user for a new domain name (e.g. test).

OUTPUT, 2D | Line Profile: Select the topography, until the

Line-Profile-Button is active. Click the button and then move the cursor to the start point of your profile. Click the left mouse button and move the cursor to the next position of your profile.

At the end position of your profile double click with the left mouse button. A new window pops up called ’RAMMS::Avalanche Line

Profile Plot Active Parameter’. This line profile plot is linked to your simulation. If you change the parameter or if you change the max-value in the avalanche-panel, the changes are adapted in the line profile plot!

Zoom tools.

Annotation tools: text, line, rectangle, oval, polygon, freehand.

90 RAMMS User Manual

6.1. THE GRAPHICAL USER INTERFACE (GUI)

6.1.3 Vertical toolbar

Add shapefile (*.shp).

Show/hide lights.

Show/hide mesh.

Show map.

Show image.

INPUT | Show/hide release area (or other active parameter).

OUTPUT | Show/hide simulation.

Switch between isotropic and anisotropic view.

Show/hide colorbar.

INPUT | Run Simulation.

OUTPUT | Animate Simulation / Continue Simulation.

Stop/Pause Simulation ( ).

OUTPUT | End Simulation: skip to last dump step of simulation.

Create a screenshot of the main window.

OUTPUT | Create GIF animation.

Edit colorbar properties.

Edit dataspace properties.

Change RAMMS preferences (e.g. working directory).

Change view to 2D / Change view to 3D ( ).

6.1.4 Main window

All input and output related visualizations are displayed in the main window.

6.1.5 Time step slider (only OUTPUT)

The time step slider can be moved manually to change the active time step.

WSL Institute for Snow and Avalanche Research SLF 91

CHAPTER 6. PROGRAM OVERVIEW

6.1.6 Left status bar

The left status bar is used to display status information for operations or informational messages pertaining to the currently selected surface or manipulators.

6.1.7 Right status bar

The right status bar is used to display the position of the cursor within the surface and additionally simulation results at the position of the cursor.

Figure 6.2: Position information and triangle simulation results in the right status bar.

6.1.8 Colorbar

In general, the colorbar appears at the right edge of the main window (see figure

6.1

) and can be moved and resized (see ex-

ercise ”Editing the colorbar” on page

49 ).

Figure 6.3: Colorbar

6.1.9 Panel

An avalanche panel is displayed on the right side of the RAMMS GUI (see fig.

6.4

),

and consists of four tabs (General, Display, Volumes and Region). This panel changes interactively, depending on what parameter is displayed in the main window. The current parameter (A-1)and all visualizations (A-2) are additional information/functions on the avalanche panel.

General Tab

The General tab (A) shows some important simulation parameters, such as: nr. of nodes, nr. of cells, end time (s), dump step (s), grid resolution (m) and avalanche density (kg/m3).

92 RAMMS User Manual

6.1. THE GRAPHICAL USER INTERFACE (GUI)

Figure 6.4: Avalanche panel.

Display Tab

The Display tab (B) shows parameters that are important for the display (colors, transparency) of results and polygon shapefiles. The Min and Max values as well as the number of colors influence directly the colorbar and the visualization. The transparency of the simulation results can be changed on the avalanche-display-panel. 0% means no transparency,

100% means total transparency, see figure below (fig.

6.5

). The colorbar is devided into

n (nr. of colors) different colors, where the lowest color is normally not displayed. The bottom line informs the user of the range of the values that are not displayed in the current visualization (only in output mode).

Volumes Tab

The Volumes tab (C) gives the user information about the release area, such as projected release area, 3D release area, estimated release volume (input mode), release mass (input)

WSL Institute for Snow and Avalanche Research SLF 93

CHAPTER 6. PROGRAM OVERVIEW

Figure 6.5: No transparency (left) and 40% transparency (right) of simulation result.

and calculated release volume (output). The input release volume is estimated. Normally, the calculated release area is 1% − 7% larger than the estimated values.

Region Tab

The Region Tab (D) gives information about min and max X-, Y-coordinates and the altitude limits as well as an information about the region area in km2.

94 RAMMS User Manual

6.2. FILE MANAGEMENT

6.2 File management

6.2.1 Software RAMMS

After the installation of RAMMS, the installation directory contains the following folders:

<installation directory>

<bin>:

<bmp>:

This folder contains all RAMMS executable-files.

Bitmap-files, used for toolbar buttons.

<defaults>: This folder contains some default files.

<grass>: This folder contains all GRASS shell scripts used for terrain analysis.

<IDL71>: This folder contains the IDL Virtual Machine distribution.

<Manual>: This folder contains the manuals and publications.

<Temp>: This folder contains some temporary files and the CYGWIN/GRASS installation file.

Additionally, the installation directory contains also the following files:

<installation directory>

<ramms.ico>: The RAMMS icon.

<ramms.sav>: The main compiled program file.

<ramms init.sav>: Additional compiled program file.

<ramms.exe>: Start RAMMS with this exe-file.

<ramms.ini>:

<uninstall.exe>:

<uninstall.ini>:

The ini-file belongs to the ramms.exe-file.

Uninstall RAMMS with this exe-file.

The ini-file belongs to the uninstall.exe-file.

6.2.2 Organizing your data

Recommendation to organize your RAMMS-data (this is only a recommendation, but it proved to be a good way):

Create a folder ’RAMMS’ (not in your installation directory, use another drive for your projects and data) e.g. D:\RAMMS and in there the following folders:

• Projects

• DEM

• FOREST

• Maps

WSL Institute for Snow and Avalanche Research SLF 95

CHAPTER 6. PROGRAM OVERVIEW

• OrthoPhoto

It is important, that the DEM and forest files, as well as your georeferenced maps and imagery, are located in the appropriate folders. These folders are the ones selected in the

RAMMS preferences (how to set the correct folders see section

3.5

).

IMPORTANT: There should be no blanks or special characters in all the above directories.

For example, do not specify a working directory like C:\Documents and Settings\Eigene

Dateien\Data etc...this will not work for RAMMS.

96 RAMMS User Manual

Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project