Tutorial: Running Stata IN GALILEO

Licensing

Stata is propriety software licensed by StataCorp LLC. In order to run Stata on Galileo and comply with our terms of use, you must have a valid Stata 16 license.

We have implemented a bring-your-own license system. To use Stata with Galileo please add your stata.lic file from your home or office computer running Stata 16 to your Galileo project folder. On OS X, the file can typically be found at /Applications/Stata/stata.lic or by searching the file system.

We do not sell Stata licenses. Additional information on Stata can be found at their website. Any other inquiries about Stata or licensing can be directed to support@hypernetlabs.io.

Getting started with Stata IN GALILEO

To get started with Galileo, log into your account using Firefox or Chrome download our Stata example file from GitHub. The downloaded file consists of a .do file, a .dta file, and a Dockerfile.

Let’s have a look at our files

Our Stata example folder contains three files named carsdata.do, carsdata.dta, and Dockerfile. The carsdata.do script conducts a linear regression using the carsdata.dta dataset and makes a simple plot.

Understanding the User Interface

When you log into Galileo, the first thing you’ll see is your Dashboard:

Drag and drop the entire Stata example folder you downloaded from our 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-Stata” 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 plot we made:

Using the Configuration Wizard to create your own project

When you drag and drop a custom Stata 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 (Stata), given the job a name, you will also need to provide the wizard with the name of the .do 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.