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:

1. Fork this repository by clicking the "Fork" button above

2. In your fork click the "<> Code" button, move to the "Codespaces" tab, then "Creat codespaces on main"

3. This will open a codespace which may take a while to setup

4. Once everything has been setup open the command palette by clicking "View > Command Palette", then select "Julia: Start REPL"

5. Once this is open type ] to open the package manager, type instantiate and return, this will install the required packages and may take a while

6. 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.

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