viewtif 0.2.3__tar.gz → 0.2.5__tar.gz

{viewtif-0.2.3 → viewtif-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: viewtif
-Version: 0.2.3
+Version: 0.2.5
 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
@@ -26,6 +26,9 @@ Description-Content-Type: text/markdown
 # viewtif
 [![Downloads](https://static.pepy.tech/badge/viewtif)](https://pepy.tech/project/viewtif)
 [![PyPI version](https://img.shields.io/pypi/v/viewtif)](https://pypi.org/project/viewtif/)
+[![Python version](https://img.shields.io/badge/python-%3E%3D3.9-blue.svg)](https://pypi.org/project/viewtif/)
+
+
 
 A lightweight GeoTIFF viewer for quick visualization directly from the command line.  
 
@@ -59,9 +62,9 @@ pip install GDAL
 
 #### NetCDF support 
 ```bash
-brew install  "viewtif[netcdf]"
+pip install  "viewtif[netcdf]"
 ```
-> **Note:** For enhanced geographic visualization with map projections, coastlines, and borders, install with cartopy: `pip install "viewtif[netcdf]"` (cartopy is included in the netcdf extra). If cartopy is not available, netCDF files will still display with standard RGB rendering.
+> **Note:** For enhanced geographic visualization with map projections, coastlines, and borders, install with cartopy: `pip install "viewtif[netcdf]"` (cartopy is included in the netcdf extra). If cartopy is not available, netCDF files will still display with standard rendering.
 ## Quick Start
 ```bash
 # View a GeoTIFF
@@ -114,12 +117,7 @@ If the dataset is very large (e.g., >20 million pixels), it will pause and warn
 You can proceed manually or rerun with the `--scale` option for a smaller, faster preview.
 
 ### Update in v0.2.2: NetCDF support with optional cartopy visualization
-`viewtif` now supports NetCDF (`.nc`) files with xarray and optional cartopy geographic visualization.
-
-#### Installation with NetCDF support
-```bash
-pip install "viewtif[netcdf]"
-```
+`viewtif` now supports NetCDF (`.nc`) files via xarray, with optional cartopy-based geographic visualization. Use`[` / `]` to move forward or backward through time steps.
 
 #### Examples
 ```bash
@@ -161,4 +159,10 @@ This project is released under the MIT License.
 
 ## Contributors
 - [@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
+- [@p-vdp](https://github.com/p-vdp) — added File Geodatabase (.gdb) raster support
+
+## Useful links
+- https://www.linkedin.com/posts/desmond-lartey_geospatial-analysts-heads-up-check-out-activity-7386336488050925568-G5bN?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAA0INsBVIO1f6nS_NkKqFh4Na1ZpoYo2fc
+- https://www.linkedin.com/posts/keiko-nomura-0231891_dont-you-sometimes-just-want-to-see-a-activity-7383409138296528896-sbRM?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAA0INsBVIO1f6nS_NkKqFh4Na1ZpoYo2fc
+- https://www.linkedin.com/posts/keiko-nomura-0231891_now-you-can-see-hdf-files-from-the-command-activity-7383963721561399296-F5i0?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAA0INsBVIO1f6nS_NkKqFh4Na1ZpoYo2fc
+- https://www.linkedin.com/posts/keiko-nomura-0231891_you-can-now-view-netcdf-files-nc-from-activity-7386189562072670208-3A0V?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAA0INsBVIO1f6nS_NkKqFh4Na1ZpoYo2fc

{viewtif-0.2.3 → viewtif-0.2.5}/README.md

@@ -1,6 +1,9 @@
 # viewtif
 [![Downloads](https://static.pepy.tech/badge/viewtif)](https://pepy.tech/project/viewtif)
 [![PyPI version](https://img.shields.io/pypi/v/viewtif)](https://pypi.org/project/viewtif/)
+[![Python version](https://img.shields.io/badge/python-%3E%3D3.9-blue.svg)](https://pypi.org/project/viewtif/)
+
+
 
 A lightweight GeoTIFF viewer for quick visualization directly from the command line.  
 
@@ -34,9 +37,9 @@ pip install GDAL
 
 #### NetCDF support 
 ```bash
-brew install  "viewtif[netcdf]"
+pip install  "viewtif[netcdf]"
 ```
-> **Note:** For enhanced geographic visualization with map projections, coastlines, and borders, install with cartopy: `pip install "viewtif[netcdf]"` (cartopy is included in the netcdf extra). If cartopy is not available, netCDF files will still display with standard RGB rendering.
+> **Note:** For enhanced geographic visualization with map projections, coastlines, and borders, install with cartopy: `pip install "viewtif[netcdf]"` (cartopy is included in the netcdf extra). If cartopy is not available, netCDF files will still display with standard rendering.
 ## Quick Start
 ```bash
 # View a GeoTIFF
@@ -89,12 +92,7 @@ If the dataset is very large (e.g., >20 million pixels), it will pause and warn
 You can proceed manually or rerun with the `--scale` option for a smaller, faster preview.
 
 ### Update in v0.2.2: NetCDF support with optional cartopy visualization
-`viewtif` now supports NetCDF (`.nc`) files with xarray and optional cartopy geographic visualization.
-
-#### Installation with NetCDF support
-```bash
-pip install "viewtif[netcdf]"
-```
+`viewtif` now supports NetCDF (`.nc`) files via xarray, with optional cartopy-based geographic visualization. Use`[` / `]` to move forward or backward through time steps.
 
 #### Examples
 ```bash
@@ -136,4 +134,10 @@ This project is released under the MIT License.
 
 ## Contributors
 - [@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
+- [@p-vdp](https://github.com/p-vdp) — added File Geodatabase (.gdb) raster support
+
+## Useful links
+- https://www.linkedin.com/posts/desmond-lartey_geospatial-analysts-heads-up-check-out-activity-7386336488050925568-G5bN?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAA0INsBVIO1f6nS_NkKqFh4Na1ZpoYo2fc
+- https://www.linkedin.com/posts/keiko-nomura-0231891_dont-you-sometimes-just-want-to-see-a-activity-7383409138296528896-sbRM?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAA0INsBVIO1f6nS_NkKqFh4Na1ZpoYo2fc
+- https://www.linkedin.com/posts/keiko-nomura-0231891_now-you-can-see-hdf-files-from-the-command-activity-7383963721561399296-F5i0?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAA0INsBVIO1f6nS_NkKqFh4Na1ZpoYo2fc
+- https://www.linkedin.com/posts/keiko-nomura-0231891_you-can-now-view-netcdf-files-nc-from-activity-7386189562072670208-3A0V?utm_source=share&utm_medium=member_desktop&rcm=ACoAAAA0INsBVIO1f6nS_NkKqFh4Na1ZpoYo2fc

{viewtif-0.2.3 → viewtif-0.2.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "viewtif"
-version = "0.2.3"
+version = "0.2.5"
 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"

{viewtif-0.2.3 → viewtif-0.2.5}/src/viewtif/tif_viewer.py

@@ -42,7 +42,7 @@ import matplotlib.cm as cm
 import warnings
 warnings.filterwarnings("ignore", category=RuntimeWarning, module="shapely")
 
-__version__ = "0.2.2"
+__version__ = "0.2.5"
 
 # Optional overlay deps
 try:
@@ -210,10 +210,31 @@ class TiffViewer(QMainWindow):
             self.tif_path = self.tif_path or (os.path.commonprefix([red, green, blue]) or red)
 
         elif tif_path:
-            # --- Warn for large files before loading ---
+             # ---------------- Handle File Geodatabase (.gdb) ---------------- #
+            if tif_path and tif_path.lower().endswith(".gdb") and ":" not in tif_path:
+                import re, subprocess
+                gdb_path = tif_path  # use full path to .gdb
+                try:
+                    out = subprocess.check_output(["gdalinfo", "-norat", gdb_path], text=True)
+                    rasters = re.findall(r"RASTER_DATASET=(\S+)", out)
+                    if not rasters:
+                        print(f"[WARN] No raster datasets found in {os.path.basename(gdb_path)}.")
+                        sys.exit(0)
+                    else:
+                        print(f"Found {len(rasters)} raster dataset{'s' if len(rasters) > 1 else ''}:")
+                        for i, r in enumerate(rasters):
+                            print(f"[{i}] {r}")
+                        print("\nUse one of these names to open. For example, to open the first raster:")
+                        print(f'viewtif "OpenFileGDB:{gdb_path}:{rasters[0]}"')
+                        sys.exit(0)
+                except subprocess.CalledProcessError as e:
+                    print(f"[WARN] Could not inspect FileGDB: {e}")
+                    sys.exit(0)
+
+           # --- Warn for large files before loading ---
             warn_if_large(tif_path, scale=self._scale_arg)
 
-            # --------------------- Detect NetCDF --------------------- #
+           # --------------------- Detect NetCDF --------------------- #
             if tif_path and tif_path.lower().endswith((".nc", ".netcdf")):
                 try:
                     # Lazy-load NetCDF dependencies
@@ -359,26 +380,6 @@ class TiffViewer(QMainWindow):
                 except Exception as e:
                     raise RuntimeError(f"Error reading NetCDF file: {str(e)}")
             
-            # ---------------- Handle File Geodatabase (.gdb) ---------------- #
-            if tif_path and tif_path.lower().endswith(".gdb") and ":" not in tif_path:
-                import re, subprocess
-                gdb_path = tif_path  # use full path to .gdb
-                try:
-                    out = subprocess.check_output(["gdalinfo", "-norat", gdb_path], text=True)
-                    rasters = re.findall(r"RASTER_DATASET=(\S+)", out)
-                    if not rasters:
-                        print(f"[WARN] No raster datasets found in {os.path.basename(gdb_path)}.")
-                        sys.exit(0)
-                    else:
-                        print(f"Found {len(rasters)} raster dataset{'s' if len(rasters) > 1 else ''}:")
-                        for i, r in enumerate(rasters):
-                            print(f"[{i}] {r}")
-                        print("\nUse one of these names to open. For example, to open the first raster:")
-                        print(f'viewtif "OpenFileGDB:{gdb_path}:{rasters[0]}"')
-                        sys.exit(0)
-                except subprocess.CalledProcessError as e:
-                    print(f"[WARN] Could not inspect FileGDB: {e}")
-                    sys.exit(0)
 
             # # --- Universal size check before loading ---
             # warn_if_large(tif_path, scale=self._scale_arg)
@@ -768,7 +769,7 @@ class TiffViewer(QMainWindow):
             # If first pixel row corresponds to southernmost lat → flip to make north at top
             # We'll assume data[0, :] corresponds to lats[0]
             if lat_ascending:
-                print("[DEBUG] Flipping latitude orientation (lat ascending, data starts south)")
+                # print("[DEBUG] Flipping latitude orientation (lat ascending, data starts south)")
                 frame = np.flipud(frame)
 #             else:
 #                 print("[DEBUG] No flip (lat descending, already north-up)")
@@ -779,7 +780,7 @@ class TiffViewer(QMainWindow):
             first_col = lats[:, 0]
             lat_ascending = first_col[0] < first_col[-1]
             if lat_ascending:
-                print("[DEBUG] Flipping latitude orientation (2D grid ascending)")
+                # print("[DEBUG] Flipping latitude orientation (2D grid ascending)")
                 frame = np.flipud(frame)
 #             else:
 #                 print("[DEBUG] No flip (2D grid already north-up)")
@@ -793,7 +794,7 @@ class TiffViewer(QMainWindow):
             return frame
 
         step = int(self._scale_arg)
-        print(f"[DEBUG] Applying scale factor {step} to current frame")
+        print(f"Applying scale factor {step} to current frame")
 
         # Downsample the frame
         frame = frame[::step, ::step]
@@ -858,118 +859,6 @@ class TiffViewer(QMainWindow):
             pass
             
         return time_str
-            
-    # def update_time_label(self):
-    #     """Update the time label with the current time value"""
-    #     if hasattr(self, '_has_time_dim') and self._has_time_dim:
-    #         try:
-    #             time_value = self._time_values[self._time_index]
-    #             time_str = self.format_time_value(time_value)
-                
-    #             # Update time label if it exists
-    #             if hasattr(self, 'time_label'):
-    #                 self.time_label.setText(f"Time: {time_str}")
-                
-    #             # Create a progress bar style display of time position
-    #             total = len(self._time_values)
-    #             position = self._time_index + 1
-    #             bar_width = 20  # Width of the progress bar
-    #             filled = int(bar_width * position / total)
-    #             bar = "[" + "#" * filled + "-" * (bar_width - filled) + "]"
-                
-    #             # Show time info in status bar
-    #             step_info = f"Time step: {position}/{total} {bar} {self.format_time_value(self._time_values[self._time_index])}"
-                
-    #             # Update status bar if it exists
-    #             if hasattr(self, 'statusBar') and callable(self.statusBar):
-    #                 self.statusBar().showMessage(step_info)
-    #             else:
-    #                 print(step_info)
-    #         except Exception as e:
-    #             print(f"Error updating time label: {e}")
-            
-    # def toggle_play_pause(self):
-    #     """Toggle play/pause animation of time steps"""
-    #     if self._is_playing:
-    #         self.stop_animation()
-    #     else:
-    #         self.start_animation()
-    
-    # def start_animation(self):
-    #     """Start the time animation"""
-    #     from PySide6.QtCore import QTimer
-        
-    #     if not hasattr(self, '_play_timer') or self._play_timer is None:
-    #         self._play_timer = QTimer(self)
-    #         self._play_timer.timeout.connect(self.animation_step)
-        
-    #     # Set animation speed (milliseconds between frames)
-    #     animation_speed = 500  # 0.5 seconds between frames
-    #     self._play_timer.start(animation_speed)
-        
-    #     self._is_playing = True
-    #     self.play_button.setText("⏸")  # Pause symbol
-    #     self.play_button.setToolTip("Pause animation")
-    
-    # def stop_animation(self):
-    #     """Stop the time animation"""
-    #     if hasattr(self, '_play_timer') and self._play_timer is not None:
-    #         self._play_timer.stop()
-        
-    #     self._is_playing = False
-    #     self.play_button.setText("▶")  # Play symbol
-    #     self.play_button.setToolTip("Play animation")
-    
-    # def animation_step(self):
-    #     """Advance one frame in the animation"""
-    #     # Go to next time step
-    #     next_time = (self._time_index + 1) % len(self._time_values)
-    #     self.time_slider.setValue(next_time)
-    
-    # def closeEvent(self, event):
-    #     """Clean up resources when the window is closed"""
-    #     # Stop animation timer if it's running
-    #     if hasattr(self, '_is_playing') and self._is_playing:
-    #         self.stop_animation()
-        
-    #     # Call the parent class closeEvent
-    #     super().closeEvent(event)
-            
-    # def populate_date_combo(self):
-    #     """Populate the date combo box with time values"""
-    #     if hasattr(self, '_has_time_dim') and self._has_time_dim and hasattr(self, 'date_combo'):
-    #         try:
-    #             self.date_combo.clear()
-                
-    #             # Add a reasonable subset of dates if there are too many
-    #             max_items = 100  # Maximum number of items to show in dropdown
-                
-    #             if len(self._time_values) <= max_items:
-    #                 # Add all time values
-    #                 for i, time_value in enumerate(self._time_values):
-    #                     time_str = self.format_time_value(time_value)
-    #                     self.date_combo.addItem(time_str, i)
-    #             else:
-    #                 # Add a subset of time values
-    #                 step = len(self._time_values) // max_items
-                    
-    #                 # Always include first and last
-    #                 indices = list(range(0, len(self._time_values), step))
-    #                 if (len(self._time_values) - 1) not in indices:
-    #                     indices.append(len(self._time_values) - 1)
-                    
-    #                 for i in indices:
-    #                     time_str = self.format_time_value(self._time_values[i])
-    #                     self.date_combo.addItem(f"{time_str} [{i+1}/{len(self._time_values)}]", i)
-    #         except Exception as e:
-    #             print(f"Error populating date combo: {e}")
-                    
-    # def date_combo_changed(self, index):
-    #     """Handle date combo box selection change"""
-    #     if index >= 0:
-    #         time_index = self.date_combo.itemData(index)
-    #         if time_index is not None:
-    #             self.time_slider.setValue(time_index)
 
     def _render_rgb(self):
         if self.rgb_mode:
@@ -1049,12 +938,12 @@ class TiffViewer(QMainWindow):
 
         # --- Synchronize latitude orientation with normalized data ---
         if np.ndim(lats) == 1 and lats[0] < lats[-1]:
-            print("[DEBUG] Lat ascending → flip lats_downsampled to match flipped data")
+            # print("[DEBUG] Lat ascending → flip lats_downsampled to match flipped data")
             lats_downsampled = lats_downsampled[::-1]
         elif np.ndim(lats) == 2:
             first_col = lats[:, 0]
             if first_col[0] < first_col[-1]:
-                print("[DEBUG] 2D lat grid ascending → flip lats_downsampled vertically")
+                # print("[DEBUG] 2D lat grid ascending → flip lats_downsampled vertically")
                 lats_downsampled = np.flipud(lats_downsampled)
 
         # Convert 0–360 longitude to −180–180 if needed
@@ -1321,7 +1210,7 @@ def run_viewer(
 import click
 
 @click.command()
-@click.version_option("0.2.2", prog_name="viewtif")
+@click.version_option("0.2.5", 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")