RAMMS 1.3.0

RAMMS 1.3.0

3 Setup and First Start

3.1 System Requirements

We recommend the following minimum system requirements for running RAMMS :

• OS: Windows XP (2000) 32 bit

• RAM (memory): 1GB (2 GB recommended)

• CPU: Intel Pentium 1 GHz (dual core recommended)

• Harddisk: ca. 410 MB

Windows Vista and Windows 7 are not supported at the moment.

3.2 Installation

Please download the RAMMS setup file ramms user setup.zip from http://ramms.slf.

ch/ramms/downloads/ramms_user_setup.zip

.

Please do the following steps before you begin to install:

• Unzip the file ramms user setup.zip to a temporary directory on your target machine.

The unzipped file will be entitled similar to ramms1.3.0 user setup.exe, showing the actual version of RAMMS (e.g. 1.3.0).

• You must have Administrator privileges on the target machine. If you do not have such privileges, the installer cannot modify the system configuration of the machine and the installation will fail. Note that you do not need Administrator privileges to run RAMMS afterwards.

• Read first, install afterwards! Please read the whole installation process once, before you begin the installation!!

5

CHAPTER 3. SETUP AND FIRST START

3.2.1 Installation procedure

Step 1: Welcome

Start the file ramms1.3.0 user setup.exe. The Welcome dialog introduces you to the English Setup program and will guide you through the installation process. Click ”Next” to continue.

Figure 3.1: Installation - Welcome dialog window.

Step 2: Readme

Short introduction to RAMMS. Click ”Next” to continue.

6

Figure 3.2: Installation - Readme dialog window.

RAMMS User Manual

3.2. INSTALLATION

Step 3: Accepting the License Agreement

Read the license agreement carefully and accept it by activating the check box in the lower left corner. If you do not accept the license agreement, you are not able to proceed with the installation. After accepting the license agreement, click Next to continue the installation.

Figure 3.3: Installation - License agreement dialog window.

Step 4: Select Destination Directory

Choose your Destination Directory. Simultaneously this dialog shows the amount of space available on your hard disk and required for the installation. Beware: − Do NOT use a blank or special characters within your installation directory path name (e.g.

C:\Program Files\RAMMS is not allowed, use C:\Programs\RAMMS or C:\Programme\RAMMS instead). Click Next to start the installation process.

Figure 3.4: Installation - Destination directory dialog window.

WSL Institute for Snow and Avalanche Research SLF 7

CHAPTER 3. SETUP AND FIRST START

Step 5: Installing the files

RAMMS is copying the files to the destination location and showing the installation progress.

Figure 3.5: Installation - Installing files dialog window.

Step 6: Finished installing the files

RAMMS finished copying the files. Click Next to finish the installation process.

8

Figure 3.6: Installation - Finished installing files dialog window.

RAMMS User Manual

Step 7: RAMMS Installation finished!

RAMMS successfully finished the installation. Click Finish.

3.2. INSTALLATION

Figure 3.7: Installation - Finished installation dialog window.

After having successfully installed RAMMS on your personal computer, you will notice the RAMMS icon on your desktop (for all users):

Figure 3.8: RAMMS icon.

Additionally, a new application folder is created in Start → Programs (for all users):

• RAMMS → Run RAMMS

• RAMMS → Uninstall RAMMS

Figure 3.9: RAMMS program group.

WSL Institute for Snow and Avalanche Research SLF 9

CHAPTER 3. SETUP AND FIRST START

3.3 Licensing Methods

Access to RAMMS is controlled by a Personal Use License. Personal use licenses are time limited licenses tied to a single personal computer. This method of licensing requires a machine’s unique host ID to be incorporated into a license request file. After the license request file is sent to WSL/SLF, you will receive a license key. Entering the license key on a personal computer enables full RAMMS functionality for the specific personal computer.

For more information please visit http://ramms.slf.ch

.

10 RAMMS User Manual

3.4. FIRST START

3.4 First Start

Double-click the icon or use Start → Programs → RAMMS → Run RAMMS to start

RAMMS for the first time. Whenever you start RAMMS, the splash screen below will pop up:

Figure 3.10: RAMMS start window.

Click on the image. It will disappear and RAMMS will start up. The following dialog window appears (Fig.

3.11

RAMMS - Licensing):

Figure 3.11: RAMMS licensing window.

3.4.1 Personal License Request File

Click the button to create your personal license request file. In Fig.

3.12

enter your full name and the name of your company.

In the next dialogue window, choose the destination directory of your personal license request file and save it to your target machine. Your personal license request file should look similar to Fig.

3.13

.

WSL Institute for Snow and Avalanche Research SLF 11

CHAPTER 3. SETUP AND FIRST START

Figure 3.12: Enter user name and company name.

Figure 3.13: Personal license request file RAMMS request Muster Test.txt

3.4.2 Personal License Key

How to order a Personal License Key

You find an order form on the RAMMS web page at http://ramms.slf.ch/

. Fill in all your personal information, choose license period, license typ and number of licenses you wish to order, attach your personal license request file, accept the license agreement and click Submit Order.

An order confirmation email is sent to your Email address. We then process your order and send you an invoice. As soon as we received your payment, we will send you your personal license key. Your personal license key is named similar to RAMMS license Muster

Test.txt. Open the file in a text-editor. It should look similar to Fig.

3.14

.

Now, restart RAMMS (as explained before). Again, the pop-up window (Fig.

3.10

) and

then the dialogue window of Fig.

3.11

appears (RAMMS - Licensing).

Copy the license key (in this example: akck-3ijh-3jtl-2h5h-g340 ) and paste it at LICENSE

KEY: (see Figure

3.11

). If RAMMS accepts your installation key, you successfully finished

12 RAMMS User Manual

3.4. FIRST START

Figure 3.14: Personal license key file RAMMS license Muster Test.txt

the installation. Please continue with section

3.4.3

and install Cygwin/GRASS (required to use RAMMS ).

3.4.3 CYGWIN / GRASS installation

RAMMS is coupled to the Open Source GIS Software GRASS . Before you can benefit of all the functions of RAMMS, you must install GRASS on your PC. RAMMS works with

GRASS version 6.2.3. Later versions of GRASS are not supported in RAMMS. GRASS needs Cygwin, a Linux-like environment for Windows. Please perform the following steps to install both GRASS and Cygwin:

• Be aware: You need Administrator privileges on the target machine to install

GRASS !

• Run Track → Install Cygwin/GRASS to install GRASS Version 6.2.3 .

Figure 3.15: Continue Cygwin/GRASS installation?

Click YES to begin the installation of Cygwin and GRASS.

WSL Institute for Snow and Avalanche Research SLF 13

CHAPTER 3. SETUP AND FIRST START

• Choose the file Cygwin623.zip in the Temp-directory of your RAMMS -distribution and click OK.

Figure 3.16: Choose Cygwin/GRASS installation zip-file.

14 RAMMS User Manual

3.4. FIRST START

• In the next window you are asked to specify the installation directory. Choose e.g. C:\Programs without cygwin, because cygwin will be appended automatically!

VERY IMPORTANT: Do NOT use BLANKS or any special characters in the installation path!!

Figure 3.17: Choose Cygwin/GRASS installation directory.

WSL Institute for Snow and Avalanche Research SLF 15

CHAPTER 3. SETUP AND FIRST START

• The files are now being extracted to the directory you specified before. Please be patient, because this can take a while!

Figure 3.18: Cygwin/GRASS - Extract files.

• To finish our installation of Cygwin/GRASS, we have to update the Windows registry with the Cygwin/GRASS information. Click YES in the window below:

Figure 3.19: Cygwin/GRASS - Add to registry.

Figure 3.20: Cygwin/GRASS - Registered successfully.

16 RAMMS User Manual

3.4. FIRST START

• At the end a few Cygwin/GRASS scripts are executed. The installation of Cygwin/GRASS is now completed!

Figure 3.21: Cygwin/GRASS - Automatic scripts.

3.4.4 Potential problem

The following error can occur:

Figure 3.22: Error message

This error occurs, if certain .NET libraries are missing on your target machine. You need to install these missing libraries.

Start the installer by double-clicking the file run system32 dll.bat in the Temp folder of your RAMMS installation directory. Follow the instructions below to install the files:

WSL Institute for Snow and Avalanche Research SLF 17

CHAPTER 3. SETUP AND FIRST START

Step 1: Welcome to IDL Visual Studio Merge Modules

The Welcome dialog introduces you to the English Setup program and will guide you through the installation process of the IDL Visual Studio Merge Modules. Click ”Next” to continue.

Figure 3.23: IDL Visual Studio Merge Modules - Welcome dialog window.

Step 2: Ready to install the Program

Click ”Next” to continue.

18

Figure 3.24: IDL Visual Studio Merge Modules - Ready to install the Program.

RAMMS User Manual

Step 3: Installing IDL Visual Studio Merge Modules

The wizard is installing the files. Please wait until it is finished.

3.4. FIRST START

Figure 3.25: IDL Visual Studio Merge Modules - Installing...

Step 4: InstallShield Wizard Completed

The wizard completed the installation. Click Finish.

Figure 3.26: Installation - Destination directory dialog window.

You successfully installed the necessary files and RAMMS should start now normally. Go back to section

3.4

and start RAMMS.

WSL Institute for Snow and Avalanche Research SLF 19

CHAPTER 3. SETUP AND FIRST START

3.5 Preferences

Before starting to work with RAMMS, be sure to set your RAMMS preferences and place the necessary DEM (Digital Elevation Model) files as well as the FOREST files, MAPS and georeferenced IMAGERY you wish to use in the appropriate folders defined in the preferences, see Figs.

3.27

and

3.28

.

Use Track → Preferences to open the RAMMS preferences window or click the button .

• General tab

Setting

Cygwin directory

GRASS version

Working directory

Map directory

Image directory

DEM directory

FOREST directory

Purpose

This field allows you to set the Cygwin directory.

This should correspond to your installation directory of Cygwin, e.g. C:\Programme\cygwin.

Use this field to specify the GRASS version you use. You can find your current GRASS version here: C:\Programme\cygwin\usr\local\grass-

6.X.X (default grass-6.2.3).

Set your working directory. VERY IMPOR-

TANT: Do NOT use BLANKS in the working directory path!!

Set the folder where you place your georeferenced digital maps (consists of a TIFF-file and a corresponding tfw-file (world-file).

Set the folder where you place your digital georeferenced orthophotos (aerial picture, consists of a TIFF-file and a corresponding tfw-file

(world-file).

Set the folder where you place the Digital

Elevation Models (format: ASCII grid, see

4.2.1

on page

25 )

Set the folder where you place your forest-files

(formats: ASCII grid or polygon shapefile).

20 RAMMS User Manual

3.5. PREFERENCES

• Avalanche tab

Setting

Read timesteps

Nr of colorbar colors

GIF-Animation interval (s)

Background color

Animation delay (s)

Purpose

Choose between reading ALL or only 1 timestep.

Default is reading ALL timesteps.

Set default nr of colorbar colors.

Set interval for GIF-Animation images.

Set background color (greyscale between 0:black and 255:white).

Set animation delay to decelerate the animation speed.

Figure 3.27: General tab of RAMMS preferences.

Figure 3.28: Avalanche tab of

RAMMS preferences.

See exercise ”Working directory” on page

22

below on how to choose a new working directory. All further settings can be changed in a similar manner. The settings are saved, until they are changed again manually.

WSL Institute for Snow and Avalanche Research SLF 21

CHAPTER 3. SETUP AND FIRST START

Exercise 3.5.a: Working directory

Choosing the right working directory is very useful and saves a lot of time, searching for files and folders.

Click window.

(or use Track → Preferences) to open the RAMMS preferences

◦ Click into the field Working directory, then the appearing arrow and Edit...

A window pops up where you can choose your new working directory. Click

OK in both windows.

22

Figure 3.29: RAMMS preferences.

Figure 3.30: Browse for the correct folder.

End of Example 3.5.a

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