diff --git a/Project.toml b/Project.toml index eedbd3e95ffeaa07769935d6b65e4d3c6a9a30c5..53fb184e71a897f7a77be9c7234d153311a839a9 100644 --- a/Project.toml +++ b/Project.toml @@ -1,7 +1,7 @@ name = "PersefoneDesktop" uuid = "78b50b3d-c6fc-409a-aced-ad0772f04556" authors = ["Daniel Vedder <daniel.vedder@idiv.de>"] -version = "0.2.1" +version = "0.2.2" [deps] CSV = "336ed68f-0bac-5ca0-87d4-7b16caf5d00b" diff --git a/README.md b/README.md index f812ebbb4bcba26a1489a4e2a7dd4529dd4e1590..6dfb1d82d29947814404e1904ee32a2632c83766 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,28 @@ This is the graphical user interface to the [Persefone model](http://persefone-m With it, you can watch a simulation run unfold and interactively explore how the model functions. -## Install & run +## Quick start + +*Follow these instructions if you simply want to try out the software as a user. +If you want to play around with the source code, see the next section.* + +1. Download the [Julia programming language](https://julialang.org/downloads/) and install it on + your computer. +2. Start Julia. This should launch a commandline interface/REPL. +3. Execute the following commands (copy-and-paste should work): + +```julia +using Pkg +Pkg.add(url="https://git.idiv.de/persefone/persefone-model.git") +Pkg.add(url="https://git.idiv.de/persefone/persefone-desktop.git") +using PersefoneDesktop +ENV["QSG_RENDER_LOOP"] = "basic" # only needed on Windows +launch() +``` + +## Running from the repo + +*Follow these instructions if you want to get to grips with the source code.* **To install:** Install [Julia](https://julialang.org/downloads/) and download/clone this repository. Open a Julia REPL in the downloaded folder and execute the following