Throughout this workshop, we will use the Julia Programming Language and the Pluto module as our programming environment. Let's install these tools on our computers.
Install the latest version of Julia which can be downloaded at the Julia Downloads page. It is advisable you add julia to the PATH, which can be done during the installation process.
Once Julia is installed, open the Julia REPL (this process differs depending on your operative system). For instance, in Windows you can found and run the Julia executable and then the Julia REPL will show up:
<img src="../assets/julia-repl-windows.png" alt="" style="width:35%;"><img src="../assets/julia-repl.png" alt="" style="width:65%;">
There are many tutorials on the internet for programming in the Julia language. We recommend you refer to the official tutorials or this simple beginner tutorial."
When working with Julia, you will need to install some modules. In Julia it's necessary to open a Package Manager Session for doing so. During this workshop, we will use the Pluto module as the development environment. Let's add this module.
In the Julia Session (characterized by the julia> prompt), type the ] character to bring up the Package Manager Session (characterized by the pkg> prompt):
<center><img src="../assets/pkg-session.png" alt="" style="width:75%;"></center>
, then add the Pluto package by typing add Pluto and press enter:
<img src="../assets/pkg-add-pluto.png" alt="" style="width:50%;"><img src="../assets/pkg-add-pluto-finish.png" alt="" style="width:50%;">
To go back to the Julia Sesssion, simply press the backspace button:
<center><img src="../assets/pkg-back-to-julia.png" alt="" style="width:75%;"></center>
Just for testing purposes, let's create a simple Julia script in the Pluto environment. First, in a Julia Session import the Pluto module with the using Pluto command, and then launch it with the Pluto.run() function:
julia> using Pluto
julia> Pluto.run()<center><img src="../assets/pluto-open.png" alt="" style="width:75%;"></center>
A window of your default browser will show up:
<center><img src="../assets/pluto-dashboard.png" alt="" style="width:80%;"></center>
You can scroll down this page to see some Pluto Notebook examples. However, let's continue by clicking on + Create a new notebook and an empty Pluto Notebook, an environment for programming in Julia, will be displayed:
<center><img src="../assets/pluto-empty-notebook.png" alt="" style="width:80%;"></center>
Feel free to messing around with options and buttons in the Pluto Notebook. There are lots of tutorials and resources on the Internet for using Pluto, we recommend you to read at least this tutorial.
Write the following in your Pluto Notebook and run it (this example is taken from here):
<embed type="text/html" src="../assets/pluto-test-example.html" style="height:880px;width:100%;">
All done! You have successfully written a Julia program in the Pluto environment.
In this workshop, you will be working with notebooks available in the GitHub repository, each aligned with the topic of a specific session.
To run these notebooks on your local computer, navigate to the session of your interest:
<center><img src="../assets/github-open-session.png" alt="" style="width:100%;"></center>
Next, open the Pluto notebook file with the .jl extension:
<center><img src="../assets/github-open-notebook.png" alt="" style="width:100%;"></center>
Next, download the notebook:
<center><img src="../assets/github-download-notebook.png" alt="" style="width:100%;"></center>
A Pluto notebook file should be stored in your computer's Downloads folder.
Next, run Pluto:
julia> using Pluto
julia> Pluto.run()In the Pluto dashboard, drag and drop the Pluto notebook file:
<center><img src="../assets/github-pluto-drag-and-drop.gif" alt="" style="width:100%;"></center>
Finally, click on the button labeled Run notebook code to execute the Julia code:
<center><img src="../assets/github-pluto-run.png" alt="" style="width:100%;"></center>
All done! Feel free to play around with these notebooks during the workshop.