This project contains Python code for computing the Temperature-Vegetation Dryness Index for assessing soil moisture and evaporative fraction with remote sensing data combining a vegetation index and radiometric surface temperature.
The project consists of:
-
lower-level modules with the basic functions needed in TVDI calculation.
-
higher-level scripts for easily running pyTVDI from imagery.
Download the project to your local system, enter the download directory and then type
python setup.py install
.
if you want to install pyTVDI and its low-level modules in your Python distribution.
The following Python libraries will be required for running pyTVDI:
- Numpy
- GDAL
The easiest way to get a feeling of pyTVDI and its configuration is through the provided ipython/jupyter notebooks. In a terminal shell, navigate to your working folder and type
jupyter notebook TVDIgui.ipynb
.
In addition, you can also run TVDI with the scripts MAIN_TVDI.py, which will read an input configuration file (defaults are Config_TVDI.txt). You can edit these configuration files or make a copy to fit your data and site characteristics and either run any of these two scripts in a Python GUI or in a terminal shell:
python MAIN_TVDI.py <configuration file>.
.
where <configuration file> points to a customized configuration file... leave it blank if you want to use the default file Config_TVDI.txt.
You can obtain TVDI/EF images by importing the module tvdi, which contains all the methods for estimating the dry and wet edges and computing TVDI or Evaporative Fraction.
import pyTVDI
output=pyTVDI.tvdi(io_inf, roi_inf, alg_inf)
You can type
help(pyTVDI.tvdi)
to understand better the inputs needed and the outputs returned
- .src/pyTVDI.py, class object for TSEB scripting.
- TVDI_GUI.ipynb notebook for using pyTVDI and configuring TSEB through a Graphical User Interface, GUI.
- MAIN_TVDI.py, high level scripts for running TVDI through a configuration file (Config_TVDI.txt).
The low-level module in this project is aimed at providing customisation and more flexibility in running the Ts-VI triangle method. The following modules are included
- .src/pyTVDI.py.
core functions for running TVDI.
http://pytvdi.readthedocs.org/en/latest/index.html
-
Sandholt, I.; Rasmussen, K. & Andersen, J. A simple interpretation of the surface temperature/vegetation index space for assessment of surface moisture status. Remote Sensing of Environment , 2002, 79, 213 - 224.
-
Stisen S.; Sandholt I.; Nørgaard A.; Fensholt R. & Jensen, K. Combining the triangle method with thermal inertia to estimate regional evapotranspiration - Applied to MSG-SEVIRI data in the Senegal River basin. Remote Sensing of Environment, 2008, 112, 1242-1255.
-
de Tomás, A.; Nieto, H.; Guzinski, R.; Salas, J.; Sandholt, I. & Berliner, P. Validation and scale dependencies of the triangle method for the evaporative fraction estimation over heterogeneous areas. Remote Sensing of Environment , 2014, 152, 493 - 511.
The folder ./Input contains examples for running pyTVDI. Just run the high-level scripts with the configuration files provided by default and compare the resulting outputs with the files stored in ./Output/
- Hector Nieto hnieto@ias.csic.es hector.nieto.solana@gmail.com main developer
- Radoslaw Guzinski main developer
- Inge Sandholt TVDI principal investigator
pyTVDI: a Python Temperature-Vegetation Dryness Index
Copyright 2016 Hector Nieto and contributors.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.