viewtif 0.2.1__tar.gz → 0.2.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. {viewtif-0.2.1 → viewtif-0.2.3}/PKG-INFO +27 -8
  2. {viewtif-0.2.1 → viewtif-0.2.3}/README.md +21 -7
  3. {viewtif-0.2.1 → viewtif-0.2.3}/pyproject.toml +8 -3
  4. viewtif-0.2.3/src/viewtif/tif_viewer.py +1357 -0
  5. viewtif-0.2.1/src/viewtif/tif_viewer.py +0 -771
  6. {viewtif-0.2.1 → viewtif-0.2.3}/.gitignore +0 -0
  7. {viewtif-0.2.1 → viewtif-0.2.3}/examples/README.md +0 -0
  8. {viewtif-0.2.1 → viewtif-0.2.3}/examples/sample_data/AG100.v003.13.-017.0001.h5 +0 -0
  9. {viewtif-0.2.1 → viewtif-0.2.3}/examples/sample_data/ECOSTRESS_LST.tif +0 -0
  10. {viewtif-0.2.1 → viewtif-0.2.3}/examples/sample_data/HLS_B02.tif +0 -0
  11. {viewtif-0.2.1 → viewtif-0.2.3}/examples/sample_data/HLS_B03.tif +0 -0
  12. {viewtif-0.2.1 → viewtif-0.2.3}/examples/sample_data/HLS_B04.tif +0 -0
  13. {viewtif-0.2.1 → viewtif-0.2.3}/examples/sample_data/Zip_Codes.cpg +0 -0
  14. {viewtif-0.2.1 → viewtif-0.2.3}/examples/sample_data/Zip_Codes.dbf +0 -0
  15. {viewtif-0.2.1 → viewtif-0.2.3}/examples/sample_data/Zip_Codes.prj +0 -0
  16. {viewtif-0.2.1 → viewtif-0.2.3}/examples/sample_data/Zip_Codes.shp +0 -0
  17. {viewtif-0.2.1 → viewtif-0.2.3}/examples/sample_data/Zip_Codes.shx +0 -0
{viewtif-0.2.1 → viewtif-0.2.3}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: viewtif
3
- Version: 0.2.1
3
+ Version: 0.2.3
4
4
  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].
5
5
  Project-URL: Homepage, https://github.com/nkeikon/tifviewer
6
6
  Project-URL: Source, https://github.com/nkeikon/tifviewer
@@ -16,12 +16,16 @@ Requires-Dist: rasterio>=1.3
16
16
  Provides-Extra: geo
17
17
  Requires-Dist: geopandas>=0.13; extra == 'geo'
18
18
  Requires-Dist: shapely>=2.0; extra == 'geo'
19
+ Provides-Extra: netcdf
20
+ Requires-Dist: cartopy>=0.22; extra == 'netcdf'
21
+ Requires-Dist: netcdf4>=1.6; extra == 'netcdf'
22
+ Requires-Dist: pandas>=2.0; extra == 'netcdf'
23
+ Requires-Dist: xarray>=2023.1; extra == 'netcdf'
19
24
  Description-Content-Type: text/markdown
20
25
 
21
26
  # viewtif
22
27
  [![Downloads](https://static.pepy.tech/badge/viewtif)](https://pepy.tech/project/viewtif)
23
28
  [![PyPI version](https://img.shields.io/pypi/v/viewtif)](https://pypi.org/project/viewtif/)
24
- [![Python versions](https://img.shields.io/pypi/pyversions/viewtif)](https://pypi.org/project/viewtif/)
25
29
 
26
30
  A lightweight GeoTIFF viewer for quick visualization directly from the command line.
27
31
 
@@ -53,6 +57,11 @@ pip install GDAL
53
57
  ```
54
58
  > **Note:** GDAL is required to open `.hdf`, .`h5`, and `.hdf5` files. If it’s missing, viewtif will display: `RuntimeError: HDF support requires GDAL.`
55
59
 
60
+ #### NetCDF support
61
+ ```bash
62
+ brew install "viewtif[netcdf]"
63
+ ```
64
+ > **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.
56
65
  ## Quick Start
57
66
  ```bash
58
67
  # View a GeoTIFF
@@ -84,14 +93,11 @@ viewtif AG100.v003.33.-107.0001.h5 --subset 1 --band 3
84
93
  `[WARN] raster lacks CRS/transform; cannot place overlays.`
85
94
 
86
95
  ### Update in v1.0.7: File Geodatabase (.gdb) support
87
- `viewtif` can now open raster datasets stored inside Esri File Geodatabases (`.gdb`).
88
- When you open a .gdb directly, `viewtif` will list available raster datasets first, then you can choose one to view.
96
+ `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.
89
97
 
90
98
  Most Rasterio installations already include the OpenFileGDB driver, so .gdb datasets often open without installing GDAL manually.
91
99
 
92
- If you encounter:
93
- RuntimeError: GDB support requires GDAL,
94
- install GDAL as shown above to enable the driver.
100
+ If you encounter: RuntimeError: GDB support requires GDAL, install GDAL as shown above to enable the driver.
95
101
 
96
102
  ```bash
97
103
  # List available raster datasets
@@ -107,6 +113,19 @@ As of v1.0.7, `viewtif` automatically checks the raster size before loading.
107
113
  If the dataset is very large (e.g., >20 million pixels), it will pause and warn that loading may freeze your system.
108
114
  You can proceed manually or rerun with the `--scale` option for a smaller, faster preview.
109
115
 
116
+ ### Update in v0.2.2: NetCDF support with optional cartopy visualization
117
+ `viewtif` now supports NetCDF (`.nc`) files with xarray and optional cartopy geographic visualization.
118
+
119
+ #### Installation with NetCDF support
120
+ ```bash
121
+ pip install "viewtif[netcdf]"
122
+ ```
123
+
124
+ #### Examples
125
+ ```bash
126
+ viewtif data.nc
127
+ ```
128
+
110
129
  ## Controls
111
130
  | Key | Action |
112
131
  | -------------------- | --------------------------------------- |
@@ -142,4 +161,4 @@ This project is released under the MIT License.
142
161
 
143
162
  ## Contributors
144
163
  - [@HarshShinde0](https://github.com/HarshShinde0) — added mouse-wheel and trackpad zoom support; added NetCDF support with [@nkeikon](https://github.com/nkeikon)
145
- - [@p-vdp](https://github.com/p-vdp) — added File Geodatabase (.gdb) raster support
164
+ - [@p-vdp](https://github.com/p-vdp) — added File Geodatabase (.gdb) raster support
{viewtif-0.2.1 → viewtif-0.2.3}/README.md RENAMED
@@ -1,7 +1,6 @@
1
1
  # viewtif
2
2
  [![Downloads](https://static.pepy.tech/badge/viewtif)](https://pepy.tech/project/viewtif)
3
3
  [![PyPI version](https://img.shields.io/pypi/v/viewtif)](https://pypi.org/project/viewtif/)
4
- [![Python versions](https://img.shields.io/pypi/pyversions/viewtif)](https://pypi.org/project/viewtif/)
5
4
 
6
5
  A lightweight GeoTIFF viewer for quick visualization directly from the command line.
7
6
 
@@ -33,6 +32,11 @@ pip install GDAL
33
32
  ```
34
33
  > **Note:** GDAL is required to open `.hdf`, .`h5`, and `.hdf5` files. If it’s missing, viewtif will display: `RuntimeError: HDF support requires GDAL.`
35
34
 
35
+ #### NetCDF support
36
+ ```bash
37
+ brew install "viewtif[netcdf]"
38
+ ```
39
+ > **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.
36
40
  ## Quick Start
37
41
  ```bash
38
42
  # View a GeoTIFF
@@ -64,14 +68,11 @@ viewtif AG100.v003.33.-107.0001.h5 --subset 1 --band 3
64
68
  `[WARN] raster lacks CRS/transform; cannot place overlays.`
65
69
 
66
70
  ### Update in v1.0.7: File Geodatabase (.gdb) support
67
- `viewtif` can now open raster datasets stored inside Esri File Geodatabases (`.gdb`).
68
- When you open a .gdb directly, `viewtif` will list available raster datasets first, then you can choose one to view.
71
+ `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.
69
72
 
70
73
  Most Rasterio installations already include the OpenFileGDB driver, so .gdb datasets often open without installing GDAL manually.
71
74
 
72
- If you encounter:
73
- RuntimeError: GDB support requires GDAL,
74
- install GDAL as shown above to enable the driver.
75
+ If you encounter: RuntimeError: GDB support requires GDAL, install GDAL as shown above to enable the driver.
75
76
 
76
77
  ```bash
77
78
  # List available raster datasets
@@ -87,6 +88,19 @@ As of v1.0.7, `viewtif` automatically checks the raster size before loading.
87
88
  If the dataset is very large (e.g., >20 million pixels), it will pause and warn that loading may freeze your system.
88
89
  You can proceed manually or rerun with the `--scale` option for a smaller, faster preview.
89
90
 
91
+ ### Update in v0.2.2: NetCDF support with optional cartopy visualization
92
+ `viewtif` now supports NetCDF (`.nc`) files with xarray and optional cartopy geographic visualization.
93
+
94
+ #### Installation with NetCDF support
95
+ ```bash
96
+ pip install "viewtif[netcdf]"
97
+ ```
98
+
99
+ #### Examples
100
+ ```bash
101
+ viewtif data.nc
102
+ ```
103
+
90
104
  ## Controls
91
105
  | Key | Action |
92
106
  | -------------------- | --------------------------------------- |
@@ -122,4 +136,4 @@ This project is released under the MIT License.
122
136
 
123
137
  ## Contributors
124
138
  - [@HarshShinde0](https://github.com/HarshShinde0) — added mouse-wheel and trackpad zoom support; added NetCDF support with [@nkeikon](https://github.com/nkeikon)
125
- - [@p-vdp](https://github.com/p-vdp) — added File Geodatabase (.gdb) raster support
139
+ - [@p-vdp](https://github.com/p-vdp) — added File Geodatabase (.gdb) raster support
{viewtif-0.2.1 → viewtif-0.2.3}/pyproject.toml RENAMED
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "viewtif"
7
- version = "0.2.1"
7
+ version = "0.2.3"
8
8
  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]."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.9"
@@ -20,6 +20,12 @@ dependencies = [
20
20
 
21
21
  [project.optional-dependencies]
22
22
  geo = ["geopandas>=0.13", "shapely>=2.0"]
23
+ netcdf = [
24
+ "xarray>=2023.1",
25
+ "netCDF4>=1.6",
26
+ "cartopy>=0.22",
27
+ "pandas>=2.0"
28
+ ]
23
29
 
24
30
  [project.scripts]
25
31
  viewtif = "viewtif.tif_viewer:main"
@@ -30,5 +36,4 @@ viewtif = "viewtif.tif_viewer:main"
30
36
  "Issues" = "https://github.com/nkeikon/tifviewer/issues"
31
37
 
32
38
  [tool.hatch.build.targets.wheel]
33
- packages = ["src/viewtif"]
34
-
39
+ packages = ["src/viewtif"]