viewtif 0.1.10__tar.gz → 0.2.1__tar.gz

{viewtif-0.1.10 → viewtif-0.2.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: viewtif
-Version: 0.1.10
-Summary: Lightweight GeoTIFF, HDF/HDF5, and Esri File Geodatabase (.gdb) viewer with shapefile overlay and large-raster safeguard.
+Version: 0.2.1
+Summary: Lightweight GeoTIFF, NetCDF, HDF/HDF5, and Esri File Geodatabase (.gdb) viewer with optional shapefile overlay. NetCDF and cartopy support available via pip install viewtif[netcdf].
 Project-URL: Homepage, https://github.com/nkeikon/tifviewer
 Project-URL: Source, https://github.com/nkeikon/tifviewer
 Project-URL: Issues, https://github.com/nkeikon/tifviewer/issues
@@ -25,14 +25,7 @@ Description-Content-Type: text/markdown
 
 A lightweight GeoTIFF viewer for quick visualization directly from the command line.  
 
-You can visualize single-band GeoTIFFs, RGB composites, and shapefile overlays in a simple Qt-based window.
-
----
-Latest stable release: v0.1.9 (PyPI)
-
-Development branch: v0.2.0-dev (experimental, not released)
-
----
+You can visualize single-band GeoTIFFs, RGB composites, HDF, NetCDF files and shapefile overlays in a simple Qt-based window.
 
 ## Installation
 
@@ -52,7 +45,7 @@ pip install "viewtif[geo]"
 > **Note:** For macOS(zsh) users:
 > Make sure to include the quotes, or zsh will interpret it as a pattern.
 
-#### HDF/HDF5 support
+#### HDF/HDF5 support 
 ```bash
 brew install gdal     # macOS
 sudo apt install gdal-bin python3-gdal  # Linux
@@ -91,9 +84,15 @@ viewtif AG100.v003.33.-107.0001.h5 --subset 1 --band 3
 `[WARN] raster lacks CRS/transform; cannot place overlays.`
 
 ### Update in v1.0.7: File Geodatabase (.gdb) support
-`viewtif` can now open raster datasets stored inside Esri File Geodatabases (`.gdb`), using the GDAL `OpenFileGDB` driver.  
+`viewtif` can now open raster datasets stored inside Esri File Geodatabases (`.gdb`).
 When you open a .gdb directly, `viewtif` will list available raster datasets first, then you can choose one to view.
 
+Most Rasterio installations already include the OpenFileGDB driver, so .gdb datasets often open without installing GDAL manually.
+
+If you encounter:
+RuntimeError: GDB support requires GDAL,
+install GDAL as shown above to enable the driver. 
+
 ```bash
 # List available raster datasets
 viewtif /path/to/geodatabase.gdb
@@ -101,7 +100,7 @@ viewtif /path/to/geodatabase.gdb
 # Open a specific raster
 viewtif "OpenFileGDB:/path/to/geodatabase.gdb:RasterName"
 ```
-> **Note:** Requires GDAL 3.7 or later with the OpenFileGDB driver enabled. If multiple raster datasets are present, viewtif lists them all and shows how to open each. The .gdb path and raster name must be separated by a colon (:).
+> **Note:** If multiple raster datasets are present, viewtif lists them all and shows how to open each. The .gdb path and raster name must be separated by a colon (:).
 
 ### Update in v1.0.7: Large raster safeguard
 As of v1.0.7, `viewtif` automatically checks the raster size before loading.  
@@ -116,12 +115,12 @@ You can proceed manually or rerun with the `--scale` option for a smaller, faste
 | `C` / `V`            | Increase / decrease contrast            |
 | `G` / `H`            | Increase / decrease gamma               |
 | `M`                  | Toggle colormap (`viridis` ↔ `magma`)   |
-| `[` / `]`            | Previous / next band (single-band only) |
+| `[` / `]`            | Previous / next band (or time step)     |
 | `R`                  | Reset view                              |
 
 ## Features
 - Command-line driven GeoTIFF viewer.
-- Supports single-band, RGB composite, and HDF/HDF5 subdatasets.
+- Supports single-band, RGB composite, HDF/HDF5 subdatasets, and NetCDF.
 - Optional shapefile overlay for geographic context.
 - Adjustable contrast, gamma, and colormap.
 - Fast preview using rasterio and PySide6.
@@ -142,5 +141,5 @@ Longenecker, Jake; Lee, Christine; Hulley, Glynn; Cawse-Nicholson, Kerry; Purkis
 This project is released under the MIT License.
 
 ## Contributors
-- [@HarshShinde0](https://github.com/HarshShinde0) — added mouse-wheel and trackpad zoom support
+- [@HarshShinde0](https://github.com/HarshShinde0) — added mouse-wheel and trackpad zoom support; added NetCDF support with [@nkeikon](https://github.com/nkeikon) 
 - [@p-vdp](https://github.com/p-vdp) — added File Geodatabase (.gdb) raster support

{viewtif-0.1.10 → viewtif-0.2.1}/README.md

@@ -5,14 +5,7 @@
 
 A lightweight GeoTIFF viewer for quick visualization directly from the command line.  
 
-You can visualize single-band GeoTIFFs, RGB composites, and shapefile overlays in a simple Qt-based window.
-
----
-Latest stable release: v0.1.9 (PyPI)
-
-Development branch: v0.2.0-dev (experimental, not released)
-
----
+You can visualize single-band GeoTIFFs, RGB composites, HDF, NetCDF files and shapefile overlays in a simple Qt-based window.
 
 ## Installation
 
@@ -32,7 +25,7 @@ pip install "viewtif[geo]"
 > **Note:** For macOS(zsh) users:
 > Make sure to include the quotes, or zsh will interpret it as a pattern.
 
-#### HDF/HDF5 support
+#### HDF/HDF5 support 
 ```bash
 brew install gdal     # macOS
 sudo apt install gdal-bin python3-gdal  # Linux
@@ -71,9 +64,15 @@ viewtif AG100.v003.33.-107.0001.h5 --subset 1 --band 3
 `[WARN] raster lacks CRS/transform; cannot place overlays.`
 
 ### Update in v1.0.7: File Geodatabase (.gdb) support
-`viewtif` can now open raster datasets stored inside Esri File Geodatabases (`.gdb`), using the GDAL `OpenFileGDB` driver.  
+`viewtif` can now open raster datasets stored inside Esri File Geodatabases (`.gdb`).
 When you open a .gdb directly, `viewtif` will list available raster datasets first, then you can choose one to view.
 
+Most Rasterio installations already include the OpenFileGDB driver, so .gdb datasets often open without installing GDAL manually.
+
+If you encounter:
+RuntimeError: GDB support requires GDAL,
+install GDAL as shown above to enable the driver. 
+
 ```bash
 # List available raster datasets
 viewtif /path/to/geodatabase.gdb
@@ -81,7 +80,7 @@ viewtif /path/to/geodatabase.gdb
 # Open a specific raster
 viewtif "OpenFileGDB:/path/to/geodatabase.gdb:RasterName"
 ```
-> **Note:** Requires GDAL 3.7 or later with the OpenFileGDB driver enabled. If multiple raster datasets are present, viewtif lists them all and shows how to open each. The .gdb path and raster name must be separated by a colon (:).
+> **Note:** If multiple raster datasets are present, viewtif lists them all and shows how to open each. The .gdb path and raster name must be separated by a colon (:).
 
 ### Update in v1.0.7: Large raster safeguard
 As of v1.0.7, `viewtif` automatically checks the raster size before loading.  
@@ -96,12 +95,12 @@ You can proceed manually or rerun with the `--scale` option for a smaller, faste
 | `C` / `V`            | Increase / decrease contrast            |
 | `G` / `H`            | Increase / decrease gamma               |
 | `M`                  | Toggle colormap (`viridis` ↔ `magma`)   |
-| `[` / `]`            | Previous / next band (single-band only) |
+| `[` / `]`            | Previous / next band (or time step)     |
 | `R`                  | Reset view                              |
 
 ## Features
 - Command-line driven GeoTIFF viewer.
-- Supports single-band, RGB composite, and HDF/HDF5 subdatasets.
+- Supports single-band, RGB composite, HDF/HDF5 subdatasets, and NetCDF.
 - Optional shapefile overlay for geographic context.
 - Adjustable contrast, gamma, and colormap.
 - Fast preview using rasterio and PySide6.
@@ -122,5 +121,5 @@ Longenecker, Jake; Lee, Christine; Hulley, Glynn; Cawse-Nicholson, Kerry; Purkis
 This project is released under the MIT License.
 
 ## Contributors
-- [@HarshShinde0](https://github.com/HarshShinde0) — added mouse-wheel and trackpad zoom support
+- [@HarshShinde0](https://github.com/HarshShinde0) — added mouse-wheel and trackpad zoom support; added NetCDF support with [@nkeikon](https://github.com/nkeikon) 
 - [@p-vdp](https://github.com/p-vdp) — added File Geodatabase (.gdb) raster support

{viewtif-0.1.10 → viewtif-0.2.1}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "hatchling.build"
 
 [project]
 name = "viewtif"
-version = "0.1.10"
-description = "Lightweight GeoTIFF, HDF/HDF5, and Esri File Geodatabase (.gdb) viewer with shapefile overlay and large-raster safeguard."
+version = "0.2.1"
+description = "Lightweight GeoTIFF, NetCDF, HDF/HDF5, and Esri File Geodatabase (.gdb) viewer with optional shapefile overlay. NetCDF and cartopy support available via pip install viewtif[netcdf]."
 readme = "README.md"
 requires-python = ">=3.9"
 license = { text = "MIT" }

{viewtif-0.1.10 → viewtif-0.2.1}/src/viewtif/tif_viewer.py

@@ -40,6 +40,10 @@ from PySide6.QtGui import QImage, QPixmap, QPainter, QPen, QColor, QPainterPath
 from PySide6.QtCore import Qt
 
 import matplotlib.cm as cm
+import warnings
+warnings.filterwarnings("ignore", category=RuntimeWarning, module="shapely")
+
+__version__ = "0.2.1"
 
 # Optional overlay deps
 try:
@@ -729,7 +733,7 @@ def run_viewer(
 import click
 
 @click.command()
-@click.version_option("0.1.10", prog_name="viewtif")
+@click.version_option("0.2.1", prog_name="viewtif")
 @click.argument("tif_path", required=False)
 @click.option("--band", default=1, show_default=True, type=int, help="Band number to display")
 @click.option("--scale", default=1.0, show_default=True, type=int, help="Scale factor for display")