Training and Tutorials

Getting Stated With VICTOR

Follow the instructions below, or navigate to this presentation for a more in-depth introduction to the hub. 

instructions for how to register for VICTOR: In order to register for the VICTOR hub, you must possess a GitHub account. Navigate to GitHub.com/SignIn and enter your information to create an account. Next, navigate to victor.ldeo.columbia.edu in your browser, and follow the signup button on the far right of the navigation menu. Complete the Google Form. You will receive an invite to the inbox of the email you used to sign up. Accept the invite, then return to the victor homepage and click hub portal.

Look out fo am email invitation in the inbox of the email you used to register.

Video tutorial for registering for VICTOR: (Clicking the image below will open the 'Introduction to VICTOR' video on YouTube in a new tab). 

After logging into VICTOR, you will see a ‘server options’ screen (shown below). This is where you will choose the size of the machine you will need to run the models.

server options screen

Generally, you will be able to use the first two machine sizes for most cases (1.9 or 3.7 GB RAM). For slightly more granular or high-resolution options, choose the second option, or 7.4GB RAM. 

However, if you plan to run IMEX_lava, IMEX_sflow, fall3d, or hysplit, choose either the third or fourth option (7.4, 14.8 GB RAM). 

After selecting your target machine size, click the orange start button to continue to The Launcher.

 

From The Launcher, open a new terminal by double clicking the terminal icon at the bottom left of your screen. 

the launcher including the terminal icon
the terminal screen where users will use the victor setup command

In the new terminal, type 'victor setup' and press enter. A list of the available models will populate underneath. Using the list, type the number associated with the model you would like to use and press enter. For example, if you are using Molasses, type 11 and press enter. A folder titled Molasses will appear in your folder tree to the left of your screen. 

Running a cell: 

To run a cell, click the play button at the top of your notebook, or press Shift + Enter.

MOLASSES notebook showing the play button icon to run a cell

Some models only take a few minutes to run, while others may take a few hours. It is important to know that when the cell number appears as an asterisk (shown below) the cell is still running. 

asterisk showing a cell is still running.

Copying a DEM

If you would like to run a model with a DEM that is different than the one pre inputted into the model, begin by navigating to the following folder:

folder path for copying a DEM

Next, find the DEM you are interested in from the list and copy it by right clicking on the name. (left image below)

Then, return to the folder of the model you are using in your home directory. Paste the DEM file directly into this folder by right clicking in the folder and selecting paste. (right image below) Both of these steps are shown in the visual below, using an Iceland DEM and Lava2D as an example. 

Steps for copying and pasting a new DEM into a model folder