GridapDD29Workshop

The practical part of the workshop will consist of instructors' guided hands-on tutorials and exercises. You will find below the instructions to set up the software environment required to run the tutorials.

NOTE: In the case you have any issues while following these instructions, please fill an issue here and we will try to help you out. This will also help other participants that may have the same issue.

Required software

Before being able to work on the workshop material, you will need to install the following software on your laptop:

• Install git, the version control system we will use. For Windows users, we strongly recommend installing git for Windows. This will also install a bash shell, which will allow you to follow the rest of the installation instructions verbatim.
• Download and install Julia based on the platform you are using from the Julia home page.
• Download and install VSCode based on the platform you are using from the VSCode home page.
• Install and configure the Julia extension for VSCode. Some interesting features of the Julia extension for VSCode are covered in the following YouTube video.
• Install ParaView post-processing software. We will use the basic features of ParaView. In any case, if you are keen on learning more, there is a whole YouTube channel on ParaView that will give you many more ideas.

Getting the workshop material

The workshop material is available as a git repository here. You can either download it as a zip file or clone the repository using git. We strongly recommend the latter as you will be able to automatically pull the most up-to-date changes as per required.

If your system has an ssh client, you can clone the repository using the following command

git clone [email protected]:gridap/GridapDD29Workshop.git

from the terminal. In order this command to be successful, you will need to generate a pair of public/private SSH keys, and then associate the public key to your GitHub account. You may find some instructions on how to do this here. If, for whatever reason, you are not able to succeed, you may also try:

git clone https://github.com/gridap/GridapDD29Workshop.git

which does not require the aforementioned pair of public/private SSH keys.

Alternative methods to clone the repository can be found here.

Once you have cloned the repository, you can pull the most up-to-date changes with the following command executed from the root directory of the repository:

git pull origin

You may expect changes in the tutorials and exercises till the very last minute. These instructions are mostly definitive, though.

Setting up the environment on your local computer from the terminal

Move into the newly cloned repository and start Julia from the terminal by typing

julia --project=.

Then, press ] to enter the package manager and run

(GridapDD29Workshop) pkg> instantiate
(GridapDD29Workshop) pkg> update
(GridapDD29Workshop) pkg> build

to install and precompile all the packages needed for the workshop. This may take a while.

To render Jypyter notebooks interactively, you also need to run the following:

  julia -e'using Pkg; Pkg.add("IJulia")'

More information on Julia Environments can be found here.

Setting up the environment on your local computer with VSCode

1. Open VSCode. Then, on the top menu, select File->Open Folder, and select the workshop's material folder you just cloned.
2. Ensure that the Julia environment in the bottom status bar of VSCode is GridapDD29Workshop. Click here for instructions on how to do that.
3. Open the Julia REPL in VSCode. To this end, open the command palette with the keyboard key combination Crtl+Shift+P.
4. On the command palette, type "julia". You should get a drop-down list with different options. Select Julia: Start REPL option. This should open the Julia REPL on the VSCode's terminal window at the bottom.
5. Run the instantiate package manager command as described in the previous section.