(For a tutorial on running Octave in batch mode click here)
Getting started with Octave in Galileo
Let’s have a look at our files
The downloaded file consists of a .m file, a .csv file, and a Dockerfile. The octave_example.m script conducts a simple linear regression using the supplied mtcars.csv dataset and makes a simple plot. It also demonstrates how to use a dataset loaded from an online source.
Next, our octave_example.m file conducts a Monte Carlo experiment that simulates 50,000 throws of two six-sided dice to calculate the probability that the sum of one throw of two dice is greater than or equal to seven. It then repeats the same experiment 10 million times. Finally it compares the means of the two samples and the amount of time it took to calculate them.
Understanding the user interface
When you log into Galileo, the first thing you’ll see is your Dashboard:
To run the octave_example.m file, start by navigating to the Missions tab using the side menu.
Drag and drop the entire Octave_example folder you downloaded from GitHub to the “Add a mission” staging area. Once the folder has been uploaded, click on the “Run mission” button in the newly-created “Galileo-examples-octave” mission below the staging area. You will be asked to select a station on which to run the mission.
Choose the “Linux” station to begin and click “Run mission”. After the mission has been launched, you’ll be able to see the job running in the Jobs tab. The job runs quickly in Galileo – try running it locally and comparing.
When the example job completes, hit the Download button under Action to download the results.
The results folder will be downloaded as a .zip that contains an output.log file returning the results of the analysis and a folder called results where plots and other files that were created by the analysis are stored.
Let’s take a look at the output.log file first, which returns the results of the regression we ran:
Next, if we look in the results folder, we can see the plots we made:
Using the Configuration Wizard to create your own project
When you drag and drop a custom Octave job’s folder to start a mission on Galileo, the Configuration Wizard will appear to help you create a computing environment that is perfectly-suited for the custom job:
Once you have selected the mission type (Octave), given the job a name, you will also need to provide the wizard with the name of the .m file that initiates the job. Next, specify the dependencies the job requires, either by selecting them from the provided list or by manually entering the names, separated by a single space, and then clicking the “Add Dependencies Manually” button.
Finally, you will be asked to set two advanced settings, though you may leave them as the default settings if you are not relevant to your custom job.
Hit submit, and the job will launch and can be monitored and interacted with just like the example job by navigating to the Jobs panel.