tons of updates to and for docs

.github/workflows/test.yaml

@@ -28,21 +28,38 @@ jobs:
         with:
           path: ~/conda_pkgs_dir
           key: ${{ runner.os }}-conda-${{ env.CACHE_NUMBER }}-${{ hashFiles('ci/environment-py${{ matrix.python-version }}.yml') }}
-      - uses: conda-incubator/setup-miniconda@v3
+      # - uses: conda-incubator/setup-miniconda@v3
+      #   with:
+      #     # mamba-version: "*" # activate this to build with mamba.
+      #     python-version: ${{ matrix.python-version }}
+      #     miniforge-variant: Mambaforge
+      #     channels: conda-forge, defaults # These need to be specified to use mamba
+      #     channel-priority: true
+      #     environment-file: ci/environment-py${{ matrix.python-version }}.yml
+
+      #     activate-environment: test_env_particle-tracking-manager
+      #     use-only-tar-bz2: true # IMPORTANT: This needs to be set for caching to work properly!
+      # - name: Set up conda environment
+      #   shell: bash -l {0}
+      #   run: |
+      #     python -m pip install -e . --no-deps --force-reinstall
+
+      - name: Setup Micromamba Python ${{ matrix.python-version }}
+        uses: mamba-org/setup-micromamba@v1
         with:
-          # mamba-version: "*" # activate this to build with mamba.
-          python-version: ${{ matrix.python-version }}
-          miniforge-variant: Mambaforge
-          channels: conda-forge, defaults # These need to be specified to use mamba
-          channel-priority: true
+          init-shell: bash
+          create-args: >-
+            python=${{ matrix.python-version }} --channel conda-forge
           environment-file: ci/environment-py${{ matrix.python-version }}.yml
+          cache-environment: true
+          post-cleanup: 'all'
 
-          activate-environment: test_env_particle-tracking-manager
-          use-only-tar-bz2: true # IMPORTANT: This needs to be set for caching to work properly!
-      - name: Set up conda environment
+      - name: Install package
         shell: bash -l {0}
         run: |
           python -m pip install -e . --no-deps --force-reinstall
+
+
       - name: Run Tests
         shell: bash -l {0}
         run: |

ci/environment-py3.10.yml

@@ -4,42 +4,43 @@ channels:
 dependencies:
   - python=3.10
   ############## These will have to be adjusted to your specific project
-  # - adios_db
+  # - adios-db
   - appdirs
   - aiohttp
+  - kerchunk
   - numpy
-  # opendrift reqs
-  - matplotlib>=3.5
-  - numpy>=1.17
-  - scipy>=1.6
-  - netcdf4<=1.6.1
-  - ffmpeg
-  - pyproj>=2.3
-  - libgdal>=3.1
-  - gdal>=3.1
-  - xarray
-  - dask
-  - cfgrib
-  - pygrib
-  - xhistogram
-  - requests
-  - pytest<8
-  - pytest-cov
-  - pytest-benchmark
-  - pytest-mpl
-  - cartopy>=0.20
-  - nc-time-axis
-  - geojson
-  - pynucos>=2.12
-  - isodate
-  - coloredlogs
-  - cmocean
-  - utm
-  - roaring-landmask>=0.7
-  # - trajan>=0.1.3
-  # - adios_db
+  # # opendrift reqs
+  # - matplotlib>=3.5
+  # - numpy>=1.17
+  # - scipy>=1.6
+  # - netcdf4<=1.6.1
+  # - ffmpeg
+  # - pyproj>=2.3
+  # - libgdal>=3.1
+  # - gdal>=3.1
+  # - xarray
+  # - dask
+  # - cfgrib
+  # - pygrib
+  # - xhistogram
+  # - requests
+  # - pytest<8
+  # - pytest-cov
+  # - pytest-benchmark
+  # - pytest-mpl
+  # - cartopy>=0.20
+  # - nc-time-axis
+  # - geojson
+  # - pynucos>=2.12
+  # - isodate
+  # - coloredlogs
+  # - cmocean
+  # - utm
+  # - roaring-landmask>=0.7
+  # # - trajan>=0.1.3
+  # # - adios_db
   ##
-    #- opendrift
+  - opendrift>=1.11.2
   - scipy
   - xarray
   # - xroms
@@ -49,7 +50,8 @@ dependencies:
   - coverage
   - pip
   - pytest
-  - pip:
-    - git+https://github.com/OpenDrift/opendrift
-    - git+https://github.com/fsspec/kerchunk
+  # - pip:
+    # - adios_db
+    # - git+https://github.com/OpenDrift/opendrift
+    # - git+https://github.com/fsspec/kerchunk
     # - xroms  # can't be found on conda-forge for CI, but don't need since in runslow tests?

ci/environment-py3.11.yml

@@ -4,42 +4,43 @@ channels:
 dependencies:
   - python=3.11
   ############## These will have to be adjusted to your specific project
-  # - adios_db
+  # - adios-db
   - appdirs
   - aiohttp
+  - kerchunk
   - numpy
-  # opendrift reqs
-  - matplotlib>=3.5
-  - numpy>=1.17
-  - scipy>=1.6
-  - netcdf4<=1.6.1
-  - ffmpeg
-  - pyproj>=2.3
-  - libgdal>=3.1
-  - gdal>=3.1
-  - xarray
-  - dask
-  - cfgrib
-  - pygrib
-  - xhistogram
-  - requests
-  - pytest<8
-  - pytest-cov
-  - pytest-benchmark
-  - pytest-mpl
-  - cartopy>=0.20
-  - nc-time-axis
-  - geojson
-  - pynucos>=2.12
-  - isodate
-  - coloredlogs
-  - cmocean
-  - utm
-  - roaring-landmask>=0.7
+  # # opendrift reqs
+  # - matplotlib>=3.5
+  # - numpy>=1.17
+  # - scipy>=1.6
+  # - netcdf4<=1.6.1
+  # - ffmpeg
+  # - pyproj>=2.3
+  # - libgdal>=3.1
+  # - gdal>=3.1
+  # - xarray
+  # - dask
+  # - cfgrib
+  # - pygrib
+  # - xhistogram
+  # - requests
+  # - pytest<8
+  # - pytest-cov
+  # - pytest-benchmark
+  # - pytest-mpl
+  # - cartopy>=0.20
+  # - nc-time-axis
+  # - geojson
+  # - pynucos>=2.12
+  # - isodate
+  # - coloredlogs
+  # - cmocean
+  # - utm
+  # - roaring-landmask>=0.7
   # - trajan>=0.1.3
   # - adios_db
   ##
-    #- opendrift
+  - opendrift>=1.11.2
   - scipy
   - xarray
   # - xroms
@@ -49,7 +50,8 @@ dependencies:
   - coverage
   - pip
   - pytest
-  - pip:
-    - git+https://github.com/OpenDrift/opendrift
-    - git+https://github.com/fsspec/kerchunk
+  # - pip:
+    # - adios_db
+    # - git+https://github.com/OpenDrift/opendrift
+    # - git+https://github.com/fsspec/kerchunk
     # - xroms  # can't be found on conda-forge for CI, but don't need since in runslow tests?

ci/environment-py3.9.yml

@@ -4,42 +4,43 @@ channels:
 dependencies:
   - python=3.9
   ############## These will have to be adjusted to your specific project
-  # - adios_db
+  # - adios-db
   - appdirs
   - aiohttp
+  - kerchunk
   - numpy
-  # opendrift reqs
-  - matplotlib>=3.5
-  - numpy>=1.17
-  - scipy>=1.6
-  - netcdf4<=1.6.1
-  - ffmpeg
-  - pyproj>=2.3
-  - libgdal>=3.1
-  - gdal>=3.1
-  - xarray
-  - dask
-  - cfgrib
-  - pygrib
-  - xhistogram
-  - requests
-  - pytest<8
-  - pytest-cov
-  - pytest-benchmark
-  - pytest-mpl
-  - cartopy>=0.20
-  - nc-time-axis
-  - geojson
-  - pynucos>=2.12
-  - isodate
-  - coloredlogs
-  - cmocean
-  - utm
-  - roaring-landmask>=0.7
+  # # opendrift reqs
+  # - matplotlib>=3.5
+  # - numpy>=1.17
+  # - scipy>=1.6
+  # - netcdf4<=1.6.1
+  # - ffmpeg
+  # - pyproj>=2.3
+  # - libgdal>=3.1
+  # - gdal>=3.1
+  # - xarray
+  # - dask
+  # - cfgrib
+  # - pygrib
+  # - xhistogram
+  # - requests
+  # - pytest<8
+  # - pytest-cov
+  # - pytest-benchmark
+  # - pytest-mpl
+  # - cartopy>=0.20
+  # - nc-time-axis
+  # - geojson
+  # - pynucos>=2.12
+  # - isodate
+  # - coloredlogs
+  # - cmocean
+  # - utm
+  # - roaring-landmask>=0.7
   # - trajan>=0.1.3
   # - adios_db
   ##
-    #- opendrift
+  - opendrift>=1.11.2
   - scipy
   - xarray
   # - xroms
@@ -49,7 +50,8 @@ dependencies:
   - coverage
   - pip
   - pytest
-  - pip:
-    - git+https://github.com/OpenDrift/opendrift
-    - git+https://github.com/fsspec/kerchunk
+  # - pip:
+    # - adios_db
+    # - git+https://github.com/OpenDrift/opendrift
+    # - git+https://github.com/fsspec/kerchunk
     # - xroms  # can't be found on conda-forge for CI, but don't need since in runslow tests?

docs/api.rst

@@ -9,4 +9,4 @@ API
    :recursive:
 
    the_manager
-   models.opendrift
+   models

docs/configuration.md

@@ -160,9 +160,11 @@ m.show_config(key="ocean_model")
 The built-in ocean models are:
 * NWGOA (1999–2008) over the Northwest Gulf of Alaska (Danielson, S. L., K. S. Hedstrom, E. Curchitser,	2016. Cook Inlet Model Calculations, Final Report to Bureau of Ocean Energy Management,	M14AC00014,	OCS	Study BOEM 2015-050, University	of Alaska Fairbanks, Fairbanks,	AK,	149 pp.)
 * CIOFS (1999–2022) across Cook Inlet, Alaska, a hindcast version of NOAA's CIOFS model. (Thyng, K. M., C. Liu, M. Feen, E. L. Dobbins, 2023. Cook Inlet Circulation Modeling, Final Report to Oil Spill Recovery Institute, Axiom Data Science, Anchorage, AK.)
-* CIOFS_NOW (mid-2021 through 48 hours from present time) which is the nowcast/forecast version of the CIOFS model. (Shi, L., L. Lanerolle, Y. Chen, D. Cao, R. Patchen, A. Zhang,
+* CIOFSOP (mid-2021 through 48 hours from present time) which is the nowcast/forecast version of the CIOFS model. (Shi, L., L. Lanerolle, Y. Chen, D. Cao, R. Patchen, A. Zhang,
 and E. P. Myers, 2020. NOS Cook Inlet Operational Forecast System: Model development and hindcast skill assessment, NOAA Technical Report NOS CS 40, Silver Spring, Maryland, September 2020.)
 
+If you are running locally on an Axiom server you can use `ocean_model_local=True` to access the model output locally instead of remotely.
+
 An alternative ocean model can be used instead by initializing the `Manager` then setting up the reader manually, as shown in a {ref}`Quick Start<new_reader>` example:
 
 ```
@@ -239,6 +241,8 @@ To limit the variables saved in the export file, input a list of just the variab
 m = ptm.OpenDriftModel(export_variables=[])
 ```
 
+The default list of `export_variables` is set in `config_model` but is modified depending on the `drift_model` set.
+
 
 #### How to modify details for Stokes Drift
 

docs/environment.yml

@@ -8,6 +8,7 @@ dependencies:
    - adios_db
    - aiohttp
    - appdirs
+   - cmocean
    - numpy
    - xarray
    # These are needed for the docs themselves

docs/index.rst

@@ -23,6 +23,7 @@ To install from PyPI:
    :caption: Examples and demos
 
    quick_start
+   tutorial
    configuration