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.
There are two ways of working with the projects in this repository: you can either install the required software on your own computer, or run the code in a browser using GitHub Codespaces. If you want to spend time going through the projects and tinker with the code, then we recommend downloding on your own computer. The projects have been designed to run quickly even on slow laptops.
Instructions to run FDSE projects on GitHub Codespaces
The instructions below describe how to run the projects using GitHub codespaces, which is useful if you don't have Julia installed and want to have a quick look at the projects, or have problems installing Julia.
To run this way:
- Fork this repository by clicking the "Fork" button above
- In your fork click the "<> Code" button, move to the "Codespaces" tab, then "Creat codespaces on main"
- This will open a codespace which may take a while to setup
- Once everything has been setup open the command palette by clicking "View > Command Palette", then select "Julia: Start REPL"
- Once this is open type
]to open the package manager, typeinstantiateand return, this will install the required packages and may take a while - Once this is done you can run the project files by opening them in the editor and clicking the run arrow in the top right corner.
You can run codespaces for 60 hours a month with a normal GitHub account, or if you are a student you can upgrade to GitHub Pro for free which will give you 180 hours a month.
Instructions to install and run on your own computer
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:
- 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).
- Log in to http://github.com, then re-open this page and fork this repository (click the "Fork" button in the upper right).
- Download and install the latest stable version of Julia for your platform (linux, windows, mac) here: https://julialang.org/downloads
- Download and install Visual Studio Code here: https://code.visualstudio.com/download
- Download and install GitHub Desktop here: https://desktop.github.com
- Run GitHub Desktop and sign in using your GitHub account
- In GitHub Desktop, select Clone Repository from the File menu
- Select your FDSE repository and click "Clone"
- If you are asked how you are planning to use this fork, select "For my own purposes"
- In GitHub Desktop, open the FDSE directory by clicking "Open in Visual Studio Code"
- In Visual Studio Code, open the extensions tab (the icon on the left side of the window with 4 squares)
- Find and install the Julia Language Support extension in VS code
- 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!
John Taylor