viewtif 0.1.1__tar.gz → 0.1.2__tar.gz

viewtif-0.1.2/.gitignore

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

viewtif-0.1.2/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: viewtif
+Version: 0.1.2
+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
+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.2/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.2/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.2/examples/sample_data/Zip_Codes.cpg

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

viewtif-0.1.2/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.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "viewtif"
-version = "0.1.1"
+version = "0.1.2"
 description = "Simple GeoTIFF viewer with optional shapefile overlay."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -21,6 +21,11 @@ dependencies = [
 [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.2}/src/viewtif/tif_viewer.py

@@ -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,14 @@ 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")
+@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("--shapefile", type=str, help="Optional shapefile to overlay")
+@click.option("--shp-width", default=1.0, show_default=True, type=float, help="Line width for shapefile overlay")
+def main(tif_path, band, scale, shapefile, shp_width):
+    """Lightweight GeoTIFF viewer."""
+    run_viewer(tif_path, scale=scale, band=band, shapefile=shapefile, 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
-