A module for downscaling high-resolution spatial information and organizing it into an xarray dataset.
To install the module run
pip install AgriSatRef@git+https://github.com/Aranil/AgriSatRef.git@main to install package
For SQLite database functionality, the dbflow package can be installed to manage database connections and execute SQL queries efficiently.
Custom Folder: If your database contains geoinformation or requires additional organization, you can create a custom folder within the module to store your SQL queries.
Main Script: SQL queries can alternatively be defined directly in the main script if a separate folder is not needed.
To streamline setup and customization, an INI configuration file can be created. This file allows you to define custom paths, including the location of the custom SQL query folder and other relevant settings.
Paths should be defined relative to the location of this config.ini file.
Use forward slashes (/) for cross-platform compatibility.
[paths]
custom_sql_dir = ./custom/sql
custom_db_structure = ./custom/db_structure.py
executed_sql_dir = ../_sql_executedThe script main.py demonstrates the case example for the RCM Project, covering all steps presented in Figure 1.
As an input, it requires high-resolution classification and a coarse-resolution data grid to be downscaled to.
Step 4 is currently under development.
STAC Conversion & Zenodo Bulk Upload Status
Certain parts of the scripts for converting data to STAC format and uploading bulk data to Zenodo are still under development. These functionalities are in progress, and some features may not be fully operational. Users should expect potential modifications and improvements in upcoming updates.
- io_handler/stac_generator.py
- io_handler/zenodo_helper.py
Examples of how to use the module AgriSatRef, along with sample input data, are located in the examples/ folder. The example files are numbered for easy reference.
| Folder | Description |
|---|---|
data/Classification/ |
Input for Step 1a (Classification of high-resolution data) |
data/Fboundary/ |
Input for Step 1a (Field boundary data) |
data/S1_grid/ |
Input for Step 1b (Sentinel-1 Grid data) |
data/output_zarr/ |
Input for Step 1b (Processed Sentinel-1 Zarr dataset) |
| Folder | Description |
|---|---|
ref_dataset/ |
Stores the results of Step 2 and 3 |
- Ensure all input data is correctly placed in the respective folders before running the module.
- Intermediate results will be generated inside the
data/directory as processing steps progress. - Final outputs are stored in the
ref_dataset/folder.
Contributors: Panagiotis Koutsikos, Christoph Liedel
If you use this project in your work, please cite it using the information in the CITATION.cff file or via the "Cite this repository" button on GitHub.
Thank you for supporting open science! 🙌