[general]
; Deliberately distinct from the two other GeoZarr plugins that can sit beside this
; one in the same profile: "GeoZarr Viewer" (eodcgmbh, which this is a fork of) and
; "GeoZarr" (wietzesuijker). Keep in step with PLUGIN_NAME in datacube_viewer/__init__.py
; -- scripts/build_plugin.py refuses to build if the two drift.
name=Datacube Viewer
; 3.40 is the floor because of Python, not QGIS: zarr 3 needs Python >= 3.11 and
; icechunk >= 2 needs >= 3.12, and QGIS 3.40 LTR is the first release whose standard
; Windows/macOS builds ship Python 3.12.
qgisMinimumVersion=3.40
qgisMaximumVersion=3.99
description=Load and visualise datacubes from GeoZarr, Zarr, NetCDF and Icechunk, with multiscale pyramids and sliders for time and other axes.
; PLACEHOLDER. The version comes from the git tag (vX.Y.Z) and scripts/build_plugin.py
; injects it here on the way into the .zip. Do not hand-edit a real number in: it
; would be overwritten, and this file would then misreport what shipped. The build
; refuses to run if this is anything other than 0.0.0. To release, tag the commit.
version=0.3.0
author=TUW-GEO
email=colin.moldenhauer@geo.tuwien.ac.at

; Required by plugins.qgis.org; an upload without repository and tracker is rejected.
repository=https://github.com/TUW-GEO/qgis-datacube-viewer
tracker=https://github.com/TUW-GEO/qgis-datacube-viewer/issues
homepage=https://github.com/TUW-GEO/qgis-datacube-viewer

about=Load GeoZarr datacubes, plain Zarr stores, NetCDF files and Icechunk repositories
    as raster layers in QGIS.
    Sliders in a dock panel step through the non-spatial axes of the cube (time, sensor,
    etc.) and redraw the layer as you drag. The plugin reads directly from
    plain Zarr v3 stores and NetCDF files as well as Icechunk repositories (local, S3,
    GCS, Azure, R2 or HTTP), resolves the CRS from zarr-conventions "proj:code" or CF
    grid mappings, and switches between pyramid levels as you zoom. Icechunk branches,
    tags and snapshots can be selected at load time and changed afterwards without
    re-adding the layer.
    .
    ONE MANUAL STEP AFTER INSTALL: this plugin needs the "zarr" (>=3) Python package
    for Zarr stores and/or "netCDF4" for NetCDF files, and QGIS's Plugin Manager does
    not install Python packages. After installing, open Raster > Datacube Viewer >
    Install Python Dependencies... - it detects your operating system and QGIS
    build, shows the exact command to run, where to run it, and the interpreter it
    targets, and on Windows, macOS and Linux can run it for you with "Install now".
    That installs with pip --user and pins every package QGIS's Python already has,
    so it never upgrades or replaces one of them. "icechunk" is optional and only
    needed for Icechunk repositories. zarr and icechunk require Python 3.11 or newer.
    On Linux, QGIS uses the system Python, which can be older (Python 3.10 on Ubuntu
    22.04); the README describes using QGIS from conda-forge instead.
    .
    Originally developed by EODC (https://eodc.eu) as "GeoZarr Viewer". MIT licensed.
    This is a renamed fork carrying local changes; it is not the EODC release.

; Keep in step with keywords in pyproject.toml, which repeats these in order.
tags=geozarr,zarr,netcdf,datacube,icechunk,raster,multiscale,pyramid,cog,earth observation

category=Raster
icon=icons/open_cube.png
experimental=True
deprecated=False
server=False

; Set this to True only after actually running the plugin against a Qt6 QGIS build;
; declaring it untested would strand users on the builds that are becoming the default.
; supportsQt6=True

hasProcessingProvider=no
changelog=0.3.0
    - Drag and drop: a Zarr store, NetCDF file or Icechunk repository dragged
      onto QGIS opens in the Add Datacube Layer dialog, already connected.
      Under Settings > Options > Datacube Viewer > Drag-and-drop behavior, each
      kind can instead add every variable as a layer, or be left to QGIS (GDAL),
      with a separate choice for a batch of several stores dropped at once.
    - Stores of a batch that open the dialog share one when they match (same
      datasets, variables and axes), and what is added from it is added from
      each; otherwise they open one after another, with Skip Remaining to stop.
    - Fuzzy search in the slider sidebar and the load dialog: jump to a
      date or axis value, select or add a variable by part of its name.
    - Attributes at the bottom of the slider sidebar: the selected layer's
      variable, axes, dataset and store metadata, with copy.
    - A layer asked for a slice it does not have (an unknown axis, or an
      index outside its axis) is now invalid and says why, rather than
      silently showing another slice. setIndices refuses the same with the
      reason in lastError, and a project whose saved slice the store no
      longer has says so when it opens.
    - The slider sidebar redraws while a handle is dragged, not only when it
      stops moving; "Redraw while dragging" turns that off for slow stores,
      with its default in the plugin's options.
    - The dialog's Add button says Add Layer or Add Layers; the install help
      can copy its check command too.
    - Fix: recent NetCDF files are no longer greyed out as missing in the
      dialog's Location list.
  0.2.0
    - Install now: Raster > Datacube Viewer > Install Python Dependencies...
      installs zarr, netCDF4, icechunk, fsspec and s3fs itself, without
      changing any package QGIS already uses (conda in a conda environment).
    - The slider sidebar opens on the new layer when layers are added from the
      dialog. Turn this off under Settings > Options > Datacube Viewer.
    - Icechunk branches, tags and snapshots in the slider sidebar, kept in step
      with Time Travel.
    - Add / Apply / Close in the Add Datacube Layer dialog: Add closes it,
      Apply keeps it open.
    - A layer can override the store's nodata value through its layer URI.
    - New toolbar icons.
    - Fix: the axis sliders no longer swap order between loads of the same store.
  Earlier versions: see the GitHub releases.
