viewtif 0.1.1__tar.gz → 0.1.3__tar.gz

viewtif-0.1.3/.gitignore

@@ -0,0 +1,4 @@
+.venv/
+dist/
+__pycache__/
+*.pyc

viewtif-0.1.3/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: viewtif
+Version: 0.1.3
+Summary: Simple GeoTIFF viewer with optional shapefile overlay.
+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
+Author: Keiko Nomura
+License: MIT
+Requires-Python: >=3.9
+Requires-Dist: click>=8.1
+Requires-Dist: matplotlib>=3.7
+Requires-Dist: numpy>=1.23
+Requires-Dist: pyside6>=6.5
+Requires-Dist: rasterio>=1.3
+Provides-Extra: geo
+Requires-Dist: geopandas>=0.13; extra == 'geo'
+Requires-Dist: shapely>=2.0; extra == 'geo'
+Description-Content-Type: text/markdown
+
+# viewtif
+
+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.
+
+---
+
+## Installation
+
+```bash
+pip install viewtif
+```
+
+## Quick Start
+```bash
+# View a GeoTIFF
+viewtif examples/sample_data/ECOSTRESS_LST.tif
+
+# View with shapefile overlay
+viewtif examples/sample_data/ECOSTRESS_LST.tif \
+  --shapefile examples/sample_data/Zip_Codes.shp
+
+# View an RGB composite
+viewtif --rgbfiles \
+  examples/sample_data/HLS_B4.tif \
+  examples/sample_data/HLS_B3.tif \
+  examples/sample_data/HLS_B2.tif
+
+```
+
+## Controls
+| Key                  | Action                                  |
+| -------------------- | --------------------------------------- |
+| `+` / `-`            | Zoom in / out                           |
+| Arrow keys or `WASD` | Pan                                     |
+| `C` / `V`            | Increase / decrease contrast            |
+| `G` / `H`            | Increase / decrease gamma               |
+| `M`                  | Toggle colormap (`viridis` ↔ `magma`)   |
+| `[` / `]`            | Previous / next band (single-band only) |
+| `R`                  | Reset view                              |
+
+## Features
+- Command-line driven GeoTIFF viewer
+- Supports single-band or RGB composite display.
+- Optional shapefile overlay for geographic context.
+- Adjustable contrast, gamma, and colormap.
+- Fast preview using rasterio and PySide6.
+
+## Example Data
+- ECOSTRESS_LST.tif
+- Zip_Codes.shp and associated files
+- HLS_B4.tif, HLS_B3.tif, HLS_B2.tif (RGB sample)
+
+## Credit & License
+`viewtif` was inspired by the NASA JPL Thermal Viewer — Semi-Automated Georeferencer (GeoViewer v1.12) developed by Jake Longenecker (University of Miami Rosenstiel School of Marine, Atmospheric & Earth Science) while at the NASA Jet Propulsion Laboratory, California Institute of Technology, with inspiration from JPL’s ECOSTRESS geolocation batch workflow by Andrew Alamillo. The original GeoViewer was released under the MIT License (2025) and may be freely adapted with citation.
+
+# Citation
+Longenecker, Jake; Lee, Christine; Hulley, Glynn; Cawse-Nicholson, Kerry; Purkis, Sam; Gleason, Art; Otis, Dan; Galdamez, Illeana; Meiseles, Jacquelyn. GeoViewer v1.12: NASA JPL Thermal Viewer—Semi-Automated Georeferencer User Guide & Reference Manual. Jet Propulsion Laboratory, California Institute of Technology, 2025. PDF.
+
+# License
+This project is released under the MIT License.

viewtif-0.1.3/README.md

@@ -0,0 +1,62 @@
+# viewtif
+
+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.
+
+---
+
+## Installation
+
+```bash
+pip install viewtif
+```
+
+## Quick Start
+```bash
+# View a GeoTIFF
+viewtif examples/sample_data/ECOSTRESS_LST.tif
+
+# View with shapefile overlay
+viewtif examples/sample_data/ECOSTRESS_LST.tif \
+  --shapefile examples/sample_data/Zip_Codes.shp
+
+# View an RGB composite
+viewtif --rgbfiles \
+  examples/sample_data/HLS_B4.tif \
+  examples/sample_data/HLS_B3.tif \
+  examples/sample_data/HLS_B2.tif
+
+```
+
+## Controls
+| Key                  | Action                                  |
+| -------------------- | --------------------------------------- |
+| `+` / `-`            | Zoom in / out                           |
+| Arrow keys or `WASD` | Pan                                     |
+| `C` / `V`            | Increase / decrease contrast            |
+| `G` / `H`            | Increase / decrease gamma               |
+| `M`                  | Toggle colormap (`viridis` ↔ `magma`)   |
+| `[` / `]`            | Previous / next band (single-band only) |
+| `R`                  | Reset view                              |
+
+## Features
+- Command-line driven GeoTIFF viewer
+- Supports single-band or RGB composite display.
+- Optional shapefile overlay for geographic context.
+- Adjustable contrast, gamma, and colormap.
+- Fast preview using rasterio and PySide6.
+
+## Example Data
+- ECOSTRESS_LST.tif
+- Zip_Codes.shp and associated files
+- HLS_B4.tif, HLS_B3.tif, HLS_B2.tif (RGB sample)
+
+## Credit & License
+`viewtif` was inspired by the NASA JPL Thermal Viewer — Semi-Automated Georeferencer (GeoViewer v1.12) developed by Jake Longenecker (University of Miami Rosenstiel School of Marine, Atmospheric & Earth Science) while at the NASA Jet Propulsion Laboratory, California Institute of Technology, with inspiration from JPL’s ECOSTRESS geolocation batch workflow by Andrew Alamillo. The original GeoViewer was released under the MIT License (2025) and may be freely adapted with citation.
+
+# Citation
+Longenecker, Jake; Lee, Christine; Hulley, Glynn; Cawse-Nicholson, Kerry; Purkis, Sam; Gleason, Art; Otis, Dan; Galdamez, Illeana; Meiseles, Jacquelyn. GeoViewer v1.12: NASA JPL Thermal Viewer—Semi-Automated Georeferencer User Guide & Reference Manual. Jet Propulsion Laboratory, California Institute of Technology, 2025. PDF.
+
+# License
+This project is released under the MIT License.

viewtif-0.1.3/examples/README.md

@@ -0,0 +1,24 @@
+# Examples
+
+This folder contains small demo data to test **viewtif**.
+
+## Quick test
+After installing viewtif, run:
+
+```bash
+viewtif examples/sample_data/ECOSTRESS_LST.tif
+viewtif examples/sample_data/ECOSTRESS_LST.tif --shapefile examples/Zip_Codes.shp
+viewtif --rgbfiles examples/sample_data/HLS_B4.tif examples/sample_data/HLS_B3.tif examples/sample_data/HLS_B2.tif
+```
+
+Controls
+| Key                           | Action                                | Mode        |
+| ----------------------------- | ------------------------------------- | ----------- |
+| `+` / `-`                     | Zoom in / out                         | All         |
+| Arrow keys or `W` `A` `S` `D` | Pan                                   | All         |
+| `C` / `V`                     | Decrease / increase contrast          | All         |
+| `G` / `H`                     | Decrease / increase gamma             | All         |
+| `M`                           | Toggle colormap (`viridis` ↔ `magma`) | Single-band |
+| `[` / `]`                     | Previous / next band                  | Single-band |
+| `R`                           | Reset view                            | All         |
+

viewtif-0.1.3/examples/sample_data/Zip_Codes.cpg

@@ -0,0 +1 @@
+UTF-8

viewtif-0.1.3/examples/sample_data/Zip_Codes.prj

@@ -0,0 +1 @@
+PROJCS["NAD_1983_StatePlane_California_II_FIPS_0402_Feet",GEOGCS["GCS_North_American_1983",DATUM["D_North_American_1983",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Lambert_Conformal_Conic"],PARAMETER["False_Easting",6561666.666666666],PARAMETER["False_Northing",1640416.666666667],PARAMETER["Central_Meridian",-122.0],PARAMETER["Standard_Parallel_1",38.33333333333334],PARAMETER["Standard_Parallel_2",39.83333333333334],PARAMETER["Latitude_Of_Origin",37.66666666666666],UNIT["Foot_US",0.3048006096012192]]

{viewtif-0.1.1 → viewtif-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "viewtif"
-version = "0.1.1"
+version = "0.1.3"
 description = "Simple GeoTIFF viewer with optional shapefile overlay."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -18,9 +18,17 @@ dependencies = [
   "PySide6>=6.5"
 ]
 
+[project.optional-dependencies]
+geo = ["geopandas>=0.13", "shapely>=2.0"]
+
 [project.scripts]
 viewtif = "viewtif.tif_viewer:main"
 
+[project.urls]
+"Homepage" = "https://github.com/nkeikon/tifviewer"
+"Source" = "https://github.com/nkeikon/tifviewer"
+"Issues" = "https://github.com/nkeikon/tifviewer/issues"
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/viewtif"]
 

{viewtif-0.1.1 → viewtif-0.1.3}/src/viewtif/tif_viewer.py

@@ -74,8 +74,8 @@ class TiffViewer(QMainWindow):
         rgb: list[int] | None = None,
         rgbfiles: list[str] | None = None,
         shapefiles: list[str] | None = None,
-        shp_color: str = "cyan",
-        shp_width: float = 1.5,
+        shp_color: str = "white",
+        shp_width: float = 2,
     ):
         super().__init__()
 
@@ -85,7 +85,7 @@ class TiffViewer(QMainWindow):
         self.rgb = rgb
         self.rgbfiles = rgbfiles
 
-        self._scale_arg = max(1, int(scale))
+        self._scale_arg = max(1, int(scale or 1))
         self._transform: Affine | None = None
         self._crs = None
 
@@ -482,14 +482,36 @@ def run_viewer(
 import click
 
 @click.command()
-@click.argument("tif_path", type=click.Path(exists=True))
-@click.option("--shapefile", type=click.Path(exists=True), default=None,
-              help="Optional shapefile overlay")
-@click.option("--scale", type=float, default=None, help="Optional scale")
-@click.option("--band", type=int, default=None, help="Optional band index")
-def main(tif_path, shapefile, scale, band):
-    """CLI entry point for viewtif"""
-    run_viewer(tif_path, scale=scale, band=band, shapefile=shapefile)
+@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=float, help="Scale factor for display")
+@click.option("--rgb", nargs=3, type=int, help="Three band numbers for RGB, e.g. --rgb 4 3 2")
+@click.option("--rgbfiles", nargs=3, type=str, help="Three single-band TIFFs for RGB, e.g. --rgbfiles B4.tif B3.tif B2.tif")
+@click.option("--shapefile", multiple=True, type=str, help="One or more shapefiles to overlay")
+@click.option("--shp-color", default="white", show_default=True, help="Overlay color (name or #RRGGBB).")
+@click.option("--shp-width", default=1.0, show_default=True, type=float, help="Overlay line width (screen pixels).")
+def main(tif_path, band, scale, rgb, rgbfiles, shapefile, shp_color, shp_width):
+    """Lightweight GeoTIFF viewer."""
+
+    # --- Warn early if shapefile requested but geopandas missing ---
+    if shapefile and not HAVE_GEO:
+        print(
+            "[WARN] --shapefile requires geopandas and shapely.\n"
+            "       Install them with: pip install viewtif[geo]\n"
+            "       Proceeding without shapefile overlay."
+        )
+
+    run_viewer(
+        tif_path,
+        scale=scale,
+        band=band,
+        rgb=rgb,
+        rgbfiles=rgbfiles,
+        shapefile=shapefile,
+        shp_color=shp_color,
+        shp_width=shp_width,
+    )
+
 
 if __name__ == "__main__":
     main()

viewtif-0.1.1/PKG-INFO

@@ -1,23 +0,0 @@
-Metadata-Version: 2.4
-Name: viewtif
-Version: 0.1.1
-Summary: Simple GeoTIFF viewer with optional shapefile overlay.
-Author: Keiko Nomura
-License: MIT
-Requires-Python: >=3.9
-Requires-Dist: click>=8.1
-Requires-Dist: matplotlib>=3.7
-Requires-Dist: numpy>=1.23
-Requires-Dist: pyside6>=6.5
-Requires-Dist: rasterio>=1.3
-Description-Content-Type: text/markdown
-
-# viewtif
-
-A simple GeoTIFF viewer with optional shapefile overlay.
-
-## Usage
-
-```bash
-viewtif my_raster.tif --shapefile my_overlay.shp
-

viewtif-0.1.1/README.md

@@ -1,9 +0,0 @@
-# viewtif
-
-A simple GeoTIFF viewer with optional shapefile overlay.
-
-## Usage
-
-```bash
-viewtif my_raster.tif --shapefile my_overlay.shp
-