Merge branch 'main' into compathelper/new_version/2024-09-09-01-25-13…

…-951-00950358711

.buildkite/pipeline.yml

@@ -3,24 +3,24 @@ env:
   SECRET_CODECOV_TOKEN: "Ak2mVTxXnhkPNc096ImDdp7bOc4zGNTqFEEDaGMwAgYPr28g5dyMbslh8B/ad4NQHXVL1MXQ3zrUfGgMBRq+mmqRaAe13FI4Go9uCas6bzdZXE23ExiLzBmqVRNRf8GqEcpGL7BBreohC0cnfI0SVMiIJDCJXX9YsXJtlcpk1glQFMEFI5V6cpFe9K2l5xoUNQ4179ZYoJUMAy/aylQx/UdQuw527FjHQUsi5/dFtWzMqeys0secNa9alLvJCQdIX9OqPjmBYvuIIVXCR7vlZoH8PgXwEj7wbdp8/V31+wlLQI9WePcsJxoOybtLTOlwwfw4jWLAttDZYqnqiLVp3Q==;U2FsdGVkX18sNLCManU1B/jI5kh4LhSi69MFXljHSp9yWrN7u5d196K/XrELwb8ksbamyKeHjIvDIopwD55dbw=="
 
 steps:
-  - label: "🥝 Julia 1.6"
+  - label: "🥑 Julia 1.10"
     plugins:
       - JuliaCI/julia#v1:
-          version: '1.6'
+          version: '1.10'
       - JuliaCI/julia-test#v1: ~
-      - JuliaCI/julia-coverage#v1:
-          codecov: true
     agents:
       queue: "juliagpu"
       cuda: "*"
     if: build.message !~ /\[skip tests\]/
     timeout_in_minutes: 60
 
-  - label: "🥑 Julia 1.10"
+  - label: "🥝 Julia 1.11"
     plugins:
       - JuliaCI/julia#v1:
-          version: '1.10'
+          version: '1.11'
       - JuliaCI/julia-test#v1: ~
+      - JuliaCI/julia-coverage#v1:
+          codecov: true
     agents:
       queue: "juliagpu"
       cuda: "*"

.github/workflows/CI.yml

@@ -0,0 +1,54 @@
+name: CI
+on:
+  push:
+    branches: [main]
+    tags: ["*"]
+  pull_request:
+jobs:
+  test:
+    name: Julia ${{ matrix.version }} - ${{ matrix.os }} - ${{ matrix.arch }} - ${{ github.event_name }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        version:
+          - "1.10" # LTS
+          - "1.11"
+        os:
+          - macOS-latest
+          - windows-latest
+        arch:
+          - x64
+          - aarch64
+          - arm64
+        exclude:
+          # Test 32-bit only on Linux
+          - os: macOS-latest
+            arch: x64
+          - os: windows-latest
+            arch: aarch64
+          - os: windows-latest
+            arch: arm64
+    steps:
+      - uses: actions/checkout@v4
+      - uses: julia-actions/setup-julia@v2
+        with:
+          version: ${{ matrix.version }}
+          arch: ${{ matrix.arch }}
+      - uses: julia-actions/cache@v2
+      - uses: julia-actions/julia-buildpkg@v1
+      - uses: julia-actions/julia-runtest@v1
+  docs:
+    name: Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: julia-actions/setup-julia@v2
+        with:
+          version: '1.11'
+      - uses: julia-actions/julia-buildpkg@latest
+      - uses: julia-actions/julia-docdeploy@latest
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          DOCUMENTER_KEY: ${{ secrets.DOCUMENTER_KEY }}
+          JULIA_DEBUG: Documenter

.github/workflows/CompatHelper.yml

@@ -1,19 +1,45 @@
 name: CompatHelper
-
 on:
   schedule:
-    - cron: '00 00 * * *'
-
+    - cron: 0 0 * * *
+  workflow_dispatch:
+permissions:
+  contents: write
+  pull-requests: write
 jobs:
   CompatHelper:
     runs-on: ubuntu-latest
     steps:
-      - uses: julia-actions/setup-julia@latest
+      - name: Check if Julia is already available in the PATH
+        id: julia_in_path
+        run: which julia
+        continue-on-error: true
+      - name: Install Julia, but only if it is not already available in the PATH
+        uses: julia-actions/setup-julia@v2
         with:
-          version: '1.10'
-      - name: Pkg.add("CompatHelper")
-        run: julia -e 'using Pkg; Pkg.add("CompatHelper")'
-      - name: CompatHelper.main()
+          version: '1'
+          # arch: ${{ runner.arch }}
+        if: steps.julia_in_path.outcome != 'success'
+      - name: "Add the General registry via Git"
+        run: |
+          import Pkg
+          ENV["JULIA_PKG_SERVER"] = ""
+          Pkg.Registry.add("General")
+        shell: julia --color=yes {0}
+      - name: "Install CompatHelper"
+        run: |
+          import Pkg
+          name = "CompatHelper"
+          uuid = "aa819f21-2bde-4658-8897-bab36330d9b7"
+          version = "3"
+          Pkg.add(; name, uuid, version)
+        shell: julia --color=yes {0}
+      - name: "Run CompatHelper"
+        run: |
+          import CompatHelper
+          CompatHelper.main()
+        shell: julia --color=yes {0}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: julia -e 'using CompatHelper; CompatHelper.main()'
+          COMPATHELPER_PRIV: ${{ secrets.DOCUMENTER_KEY }}
+          # COMPATHELPER_PRIV: ${{ secrets.COMPATHELPER_PRIV }}

README.md

@@ -43,14 +43,12 @@ To install, use Julia's  built-in package manager (accessed by pressing `]` in t
 
 ```julia
 julia> ]
-(v1.6) pkg> add GeophysicalFlows
-(v1.6) pkg> instantiate
+(v1.10) pkg> add GeophysicalFlows
+(v1.10) pkg> instantiate
 ```
 
-The most recent version of GeophysicalFlows.jl requires Julia v1.6  (the current long-term-release) or later. _We strongly urge you to use this version._
-
-The latest version that is compatible with Julia v1.5 is GeophysicalFlows.jl v0.13.1.
-
+GeophysicalFlows.jl requires Julia v1.6 or later. However, the package has continuous integration testing on
+Julia v1.10 (the current long-term release) and v1.11. _We strongly urge you to use one of these Julia versions._
 
 ## Examples
 

docs/src/index.md

@@ -84,6 +84,8 @@ The bibtex entry for the paper is:
 
 ## Papers using `GeophysicalFlows.jl`
 
+1. Crowe, M. N. and Sutyrin, G. G. (2024) Symmetry breaking of two-layer eastward propagating dipoles. arXiv preprint arXiv.2410.14402, doi:[10.48550/arXiv.2410.14402](https://doi.org/10.48550/arXiv.2410.14402).
+
 1. Lobo, M., Griffies, S. M., and Zhang, W. (2024) Vertical structure of baroclinic instability in a three-layer quasi-geostrophic model over a sloping bottom. _ESS Open Archive_, doi:[10.22541/essoar.172166435.57577370/v1](https://doi.org/10.22541/essoar.172166435.57577370/v1).
 
 1. Pudig, M. and Smith, K. S. (2024) Baroclinic turbulence above rough topography: The vortex gas and topographic turbulence regimes. _ESS Open Archive_, doi:[10.22541/essoar.171995116.60993353/v1](https://doi.org/10.22541/essoar.171995116.60993353/v1).
@@ -92,7 +94,7 @@ The bibtex entry for the paper is:
 
 1. He, J. and Wang, Y. (2024) Multiple states of two-dimensional turbulence above topography. arXiv preprint arXiv:2405.10826, doi:[10.48550/arXiv.2405.10826](https://doi.org/10.48550/arXiv.2405.10826).
 
-1. Parfenyev, V., Blumenau, M., and Nikitin, I. (2024) Enhancing capabilities of particle image/tracking velocimetry with physics-informed neural networks. arXiv preprint arXiv:2404.01193, doi:[10.48550/arXiv.2404.01193](https://doi.org/10.48550/arXiv.2404.01193).
+1. Parfenyev, V., Blumenau, M., and Nikitin, I. (2024) Inferring parameters and reconstruction of two-dimensional turbulent flows with physics-informed neural networks. _Jetp Lett._, doi:[10.1134/S0021364024602203](https://doi.org/10.1134/S0021364024602203).
 
 1. Shokar, I. J. S., Kerswell, R. R., and Haynes, P. H. (2024) Stochastic latent transformer: Efficient modeling of stochastically forced zonal jets. _Journal of Advances in Modeling Earth Systems_, **16**, e2023MS004177, doi:[10.1029/2023MS004177](https://doi.org/10.1029/2023MS004177).
 

docs/src/installation_instructions.md

@@ -6,27 +6,27 @@ instantiate/build all the required dependencies
 
 ```julia
 julia> ]
-(v1.6) pkg> add GeophysicalFlows
-(v1.6) pkg> instantiate
+(v1.10) pkg> add GeophysicalFlows
+(v1.10) pkg> instantiate
 ```
 
 We recommend installing GeophysicalFlows.jl with the built-in Julia package manager, because 
 this installs a stable, tagged release. Later on, you can update GeophysicalFlows.jl to the 
 latest tagged release again via the package manager by typing
 
 ```julia
-(v1.6) pkg> update GeophysicalFlows
+(v1.10) pkg> update GeophysicalFlows
 ```
 
 Note that some releases might induce breaking changes to certain modules. If after anything 
 happens or your code stops working, please open an [issue](https://github.com/FourierFlows/GeophysicalFlows.jl/issues) 
 or start a [discussion](https://github.com/FourierFlows/GeophysicalFlows.jl/discussions). We're 
 more than happy to help with getting your simulations up and running.
 
-!!! warn "Use Julia 1.6 or newer"
+!!! warn "Julia 1.6 or newer required; Julia 1.10 or newer strongly encouraged"
     The latest GeophysicalFlows.jl requires at least Julia v1.6 to run.
     Installing GeophysicalFlows with an older version of Julia will install an older version 
     of GeophysicalFlows.jl (the latest version compatible with your version of Julia).
-
-    Last version compatible with Julia v1.5: GeophysicalFlows.jl v0.13.1
 
+    GeophysicalFlows.jl is continuously tested on Julia v1.10 (the current long-term release) and v1.11.
+    _We strongly urge you to use one of these Julia versions._