timesat-cli 0.0.0__py3-none-any.whl

timesat_cli/writers.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+from typing import List, Tuple
+import rasterio
+from rasterio.windows import Window
+
+__all__ = ["prepare_profiles", "write_vpp_layers", "write_st_layers"]
+
+
+def prepare_profiles(img_profile, p_nodata: float, scale: float, offset: float):
+    import copy
+    img_profile_st = copy.deepcopy(img_profile)
+    img_profile_st.update(compress='lzw')
+    if scale != 0 or offset != 0:
+        img_profile_st.update(dtype=rasterio.float32)
+
+    img_profile_vpp = copy.deepcopy(img_profile)
+    img_profile_vpp.update(nodata=p_nodata, dtype=rasterio.float32, compress='lzw')
+
+    img_profile_ns = copy.deepcopy(img_profile)
+    img_profile_ns.update(nodata=255, compress='lzw')
+    return img_profile_st, img_profile_vpp, img_profile_ns
+
+
+def write_vpp_layers(paths: List[str], arrays, window: Tuple[int, int, int, int], img_profile_vpp):
+    x_map, y_map, x, y = window
+    for i, arr in enumerate(arrays, 1):
+        with rasterio.open(paths[i - 1], 'r+', **img_profile_vpp) as outvppfile:
+            outvppfile.write(arr, window=Window(x_map, y_map, x, y), indexes=1)
+
+
+def write_st_layers(paths: List[str], arrays, window: Tuple[int, int, int, int], img_profile_st):
+    x_map, y_map, x, y = window
+    for i, arr in enumerate(arrays, 1):
+        with rasterio.open(paths[i - 1], 'r+', **img_profile_st) as outstfile:
+            outstfile.write(arr, window=Window(x_map, y_map, x, y), indexes=1)

timesat_cli-0.0.0.dist-info/METADATA

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: timesat-cli
+Version: 0.0.0
+Summary: Python-based command line interface for TIMESAT
+Author: Zhanzhang Cai
+License: GPL-3.0-only
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.10
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: rasterio
+Requires-Dist: timesat
+Provides-Extra: parallel
+Requires-Dist: ray; extra == 'parallel'
+Description-Content-Type: text/markdown
+
+# TIMESAT CLI
+
+`TIMESAT CLI` is a command line interface and workflow manager for the [TIMESAT](https://pypi.org/project/timesat/) package. 
+It provides a convenient way to configure and execute TIMESAT processing pipelines directly from the command line or automated scripts. 
+
+---
+
+## Requirements
+
+Before you begin, make sure you have:
+
+- **Miniconda** or **Anaconda** (for environment management)  
+  Download: [https://docs.conda.io/en/latest/miniconda.html](https://docs.conda.io/en/latest/miniconda.html)
+- **Python 3.10+**
+
+---
+
+## Installation
+
+`timesat-cli` is available on **PyPI** and can be installed using **pip** or **uv**.  
+Although it is not published on Conda, you can safely install it *inside* a Conda environment.
+
+### Option 1 — Install inside a Conda environment
+
+```bash
+conda create -n timesat-cli python=3.12
+conda activate timesat-cli
+pip install timesat-cli
+```
+
+> This approach uses Conda only for environment isolation.  
+> The installation itself is handled by pip, which will automatically install `timesat` and all required dependencies.
+
+---
+
+### Option 2 — Install via uv (recommended for pure Python environments)
+
+[`uv`](https://github.com/astral-sh/uv) is a modern, high-performance alternative to pip and venv.
+
+1. Install `uv`:
+
+   ```bash
+   pip install uv
+   # or
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   ```
+
+2. Create a virtual environment and install the package:
+
+   ```bash
+   uv venv .venv
+   source .venv/bin/activate
+   uv pip install timesat-cli
+   ```
+
+> `uv` provides faster dependency resolution and caching.  
+> It will automatically install `timesat` and related dependencies.
+
+---
+
+### Option 3 — Direct installation with pip
+
+If you already have Python 3.10+ installed:
+
+```bash
+pip install timesat-cli
+```
+
+---
+
+## ⚙️ Optional: Parallel Processing Support
+
+`timesat-cli` provides an optional extra for **parallel execution** using [`ray`](https://www.ray.io/).
+
+To install with parallel-processing support:
+
+```bash
+pip install timesat-cli[parallel]
+```
+
+This installs the base package plus the ray dependency.
+
+---
+
+## Running the Application
+
+After installation, start the GUI with:
+
+```bash
+timesat-cli path/to/settings.json
+```
+
+or equivalently:
+
+```bash
+python -m timesat_cli path/to/settings.json
+```
+
+---
+
+## Advanced Usage
+
+If you wish to customize or extend the workflow, you can also run or modify the main script directly:
+
+```bash
+python timesat_run.py
+```
+
+The file 'timesat_run.py' contains the full example pipeline that invokes core modules from the 'timesat_cli' package, including configuration loading, file management, TIMESAT processing, and output writing.
+
+---
+
+## HRVPP Notes — QFLAG2 weights
+If you work with HRVPP quality flags (`QFLAG2`), the following weights `w` are commonly applied:
+
+| QFLAG2 value | Weight `w` |
+|---:|---:|
+| 1     | 1.0 |
+| 4097  | 1.0 |
+| 8193  | 1.0 |
+| 12289 | 1.0 |
+| 1025  | 0.5 |
+| 9217  | 0.5 |
+| 2049  | 0.5 |
+| 6145  | 0.5 |
+| 3073  | 0.5 |
+
+Example (settings.json):
+
+```python
+"p_a": {
+  "value": [
+    [1, 1.0],
+    [4097, 1.0],
+    [8193, 1.0],
+    [12289, 1.0],
+    [1025, 0.5],
+    [9217, 0.5],
+    [2049, 0.5],
+    [6145, 0.5],
+    [3073, 0.5]
+  ],
+  "description": "QA weighting rules. Leave empty [] to keep original QA values. Use [qa_value, weight] for exact matches or [min, max, weight] for ranges."
+}
+```
+
+---
+
+## License
+
+**TIMESAT-CLI** is released under the **GNU General Public License (GPL)**.  
+You are free to use, modify, and distribute this software under the terms of the GPL.
+
+The GPL license applies **only to the TIMESAT-CLI source code and assets** provided in this repository.
+
+### 📦 Dependency Licenses
+
+- `timesat` may install additional open-source dependencies (e.g., Flask, pandas, NumPy).  
+- Each dependency retains its own license (MIT, BSD, Apache, etc.).  
+- Before redistributing or bundling this software, review the license terms of each dependency carefully.
+
+### ⚖️ Summary
+
+| Component        | License Type | Notes |
+|------------------|--------------|-------|
+| TIMESAT-CLI      | GPL v3       | Open source, modification and redistribution permitted under GPL. |
+| TIMESAT          | Proprietary  | All rights reserved. Redistribution and modification prohibited without written consent. |
+| Other Dependencies | Various (MIT/BSD/Apache) | Check individual package licenses before redistribution. |
+
+For detailed license information, refer to the license files distributed with each installed package.
+
+---
+
+## Citation
+
+If you use **TIMESAT**, **TIMESAT-CLI** or **TIMESAT-GUI** in your research, please cite the corresponding release on Zenodo:
+
+> Cai, Z., Eklundh, L., & Jönsson, P. (2025). *TIMESAT4:  is a software package for analysing time-series of satellite sensor data* (Version 4.1.x) [Computer software]. Zenodo.   
+> [https://doi.org/10.5281/zenodo.17369757](https://doi.org/10.5281/zenodo.17369757)
+
+---
+
+## Acknowledgments
+
+- [TIMESAT](https://www.nateko.lu.se/TIMESAT) — Original analysis framework for satellite time-series data.  
+- This project acknowledges the Swedish National Space Agency (SNSA), the European Environment Agency (EEA), and the European Space Agency (ESA) for their support and for providing access to satellite data and related resources that made this software possible.
+
+---
+

timesat_cli-0.0.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+timesat_cli/__init__.py,sha256=P1Vnot2l024uaeErIc7pMDWOCkBjI4NuYjPsW77HYN4,358
+timesat_cli/__main__.py,sha256=UCWmnb2ksBxOVxqjHKfViMBEEqUsSOAlGyPDEp8mX3A,356
+timesat_cli/config.py,sha256=VzlivmYqyzeQEzkH8nhJSSYG55DAnF43W3QQSv9RszY,4772
+timesat_cli/csvutils.py,sha256=M5Y9E_ropVwF3oFqVGboGZEC8sJ62AmPnskxAYBgJiI,3431
+timesat_cli/fsutils.py,sha256=yCI39sKyEZ0ucHU_4Mje3LoXQe_0J5REZqJXUu0HF9w,893
+timesat_cli/parallel.py,sha256=ZoQ9nHDcc3dUgjvYKEyFeAjRGn-3-z5XD2SfRx9mmbA,816
+timesat_cli/processing.py,sha256=iJzgigRN93BMBSNvc0VyXD6vK8XWAeGAFTvVvdMWLAs,7463
+timesat_cli/qa.py,sha256=kd4Z7t50YnSfRXaFcMdSlHFx3VobPKOdz0Y5wVclFYg,705
+timesat_cli/readers.py,sha256=NMapVHthV3BJhoYZr0jrXJ8ZOyGn36qRljftFnim9Pw,5393
+timesat_cli/writers.py,sha256=zsiugWhh6EojRnqP5bO6NoxCTuIiDnGiXHLsn6zS2Lg,1427
+timesat_cli-0.0.0.dist-info/METADATA,sha256=u7MpyOScKJujOTxRt_JZMY_xyiX0t7sHo0Vyehso0ZI,6081
+timesat_cli-0.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+timesat_cli-0.0.0.dist-info/entry_points.txt,sha256=yvKIc4riurmeZCWKF04KUlD4hJu4iEePjbulDQAm7-Y,94
+timesat_cli-0.0.0.dist-info/licenses/LICENSE,sha256=YF6QR6Vjxcg5b_sYIyqkME7FZYau5TfEUGTG-0JeRK0,35129
+timesat_cli-0.0.0.dist-info/RECORD,,

timesat_cli-0.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

timesat_cli-0.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+timesat = timesat_cli.__main__:main
+timesat-cli = timesat_cli.__main__:main