Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions Project.toml
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ CairoMakie = "0.12, 0.13"
CoordinateTransformations = "0.6"
Extents = "0.1"
GeoInterfaceMakie = "0.1"
GeometryOps = "0.1.31"
GeometryOps = "0.1.31 - 0.1"
Interpolations = "0.14, 0.15, 0.16"
JLD2 = "0.4, 0.5, 0.6"
Measures = "0.3"
Expand All @@ -44,7 +44,7 @@ SplitApplyCombine = "1"
StaticArrays = "1"
Statistics = "1"
StructArrays = "0.6, 0.7"
julia = "1.9"
julia = "1.10"

[extras]
LibGEOS = "a90b1aa1-3769-5649-ba7e-abc5a9d163eb"
Expand Down
28 changes: 9 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,31 +21,21 @@ To learn how to build and run simulations, [check out our documentation and tuto

## _Installation_

Subzero is not yet a [registered Julia package](https://julialang.org/packages/). So to install it,
Subzero is a [registered Julia package](https://julialang.org/packages/). So to install it,

1. [Download Julia](https://julialang.org/downloads/) (version 1.9 or later). We recommend using [`JuliaUp`](https://github.com/JuliaLang/juliaup) so it is easy to change versions in the future.
1. [Download Julia](https://julialang.org/downloads/) (version 1.10 or later). We recommend using [`JuliaUp`](https://github.com/JuliaLang/juliaup) so it is easy to change versions in the future.

2. As `Subzero.jl` is not yet registered as an official package, you will need to install it from GitHub. To do this, you will need a SSH key on your computer and stored in GitHub. GitHub provides documentation for the needed steps:
- [Checking for existing SSH keys](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys)
- [Generating a new key](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)
- [Adding a new key](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)
- [Testing your connection](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/testing-your-ssh-connection).

3. Once you have established your SSH connection from within terminal, you now need to update your Julia `startup.jl` file. This is within the `.julia/config` folder. If you don't have a `.config` folder, please make one using `mkdir config` run on terminal within your `.julia` folder. If you don't have a `startup.jl` file you can make this using `touch startup.jl` within the `config` folder. Then, using a text editor (such as vim), add the following line to your `startup.jl` file:

`ENV["JULIA_PKG_USE_CLI_GIT"]=true`

We need this as Julia's SSH library can't read the types of SSH keys that GitHub now requires. This will have Julia use your local command line interface (CLI) version of Git. This only works with Julia 1.7 and higher.

4. Launch Julia and enter into the package manager mode by typing `]` in the terminal.

5. Run the following
2. Launch Julia and type

```julia
pkg> add "git@github.com:Caltech-OCTO/Subzero.jl.git"
julia> using Pkg

julia> Pkg.add("Subzero")
```

This will add the package to your package manager. After that you return to the REPL mode by hitting the backspace and you are ready to use Subzero!
This installs the latest version that's _compatible with your current environment_.

3. You are ready to use Subzero! Get started with:

```julia
julia> using Subzero
Expand Down
Loading