FDSE computational projects

This project contains documentation and scripts for the computational projects for the Fluid Dynamics of Sustainability and the Environment (FDSE) summer school. If you spot any typos or have suggestions for the project descriptions or code, please create a pull request or create an issue on github.

The projects use the Julia programming language. If you are new to Julia, this document contains a quickstart guide: https://sje30.github.io/catam-julia/intro/julia-manual.html

If you are familiar with another language (Python, MATLAB, R, C, etc.) then the following guide usefully explains the key differences: https://docs.julialang.org/en/v1/manual/noteworthy-differences/

Julia is a modern programming language which is as easy to use as python or Matlab, but provides the speed of languages like Fortran and C.

Julia comes with a REPL (which stands for read-evaluate-print-loop) which provides a command-line interface much like python or Matlab. While it is possible to use this on its own, we suggest using a code development platform which provides a single tool to edit and run the scripts and display plots. In particular, we recommend Visual Studio Code which is an excellent tool and free to use.

For the recommended installation, follow these steps:

1. If you don't already have one, create a free account on http://github.com (click the sign-up button in the top right corner).
2. Log in to http://github.com, then re-open this page and fork this repository (click the "Fork" button in the upper right).
3. Download and install the latest stable version of Julia for your platform (linux, windows, mac) here: https://julialang.org/downloads
4. Download and install Visual Studio Code here: https://code.visualstudio.com/download
5. Download and install GitHub Desktop here: https://desktop.github.com
6. Run GitHub Desktop and sign in using your GitHub account
7. In GitHub Desktop, select Clone Repository from the File menu
8. Select your FDSE repository and click "Clone"
9. If you are asked how you are planning to use this fork, select "For my own purposes"
10. In GitHub Desktop, open the FDSE directory by clicking "Open in Visual Studio Code"
11. In Visual Studio Code, open the extensions tab (the icon on the left side of the window with 4 squares)
12. Find and install the Julia Language Support extension in VS code
13. Find and install the GitHub Pull Requests and Issues extension in VS code

For the next steps, see the README file inside the Project 1 folder.

I hope you enjoy the projects!