Metadata-Version: 2.1
Name: PyAEZ
Version: 1.0.0
Summary: PyAEZ is a python package consisted of many algorithms related to Agro-ecalogical zoning (AEZ) framework.
Home-page: https://github.com/gicait/PyAEZ
Author: Geoinformatics Center, Asian Institute of Technology, Thailand
Author-email: geoinfo@ait.asia
License: MIT License
Description: # PyAEZ
        PyAEZ is a python package consisted of many algorithms related to Agro-ecalogical zoning (AEZ) framework. PyAEZ tries to encapsulate all complex calculations in AEZ and try to provide user friendly, and intuitive ways to input data and output results after calculations.
        
        ### Introduction
        PyAEZ includes 6 main modules as below. Additionally to that, UtilityCalculations module is also included in PyAEZ to perform additional related utility calculations.
        
        * Module I: Climate Regime
        * Module II: Crop Simulations
        * Module III: Climate Constraints
        * Module IV: Soil Constraints
        * Module V: Terrain Constraints
        * Module VI: Economic Suitability Analysis
        * UtilityCalculations Module
        
        Other than 6 main modules and utility module, following 3 major algorithms related to AEZ also are included in PyAEZ. Those 3 major algorithms can be utilized individually without running whole PyAEZ.
        
        * Biomass Calculations
        * Evapotranspiration Calculations
        * CropWat Calculations
        
        ### Dependencies
        * numpy
        * scipy
        * gdal
        * numba (optional)
        
        ### Step-by-step Process
        Following 6 Jupyter notebooks in the repository can be used as worked full example for PyAEZ 6 major modules.
        * NB1_ClimateRegime.ipynb
        * NB2_CropSimulation.ipynb
        * NB3_ClimaticConstraints.ipynb
        * NB4_SoilConstraints.ipynb
        * NB5_TerrainConstraints.ipynb
        * NB6_EconomicSuitability.ipynb
        
        __Note__: *NB2_CropSimulation.ipynb* takes a huge amount of time due to automatic crop calendar calculations. Hence, we have rewritten core parts of PyAEZ (*CropWatCalc.py*, *BioMassCalc.py* and *ETOCalc.py*) with [Numba](http://numba.pydata.org/) compatible manner as well. Numba translates Python functions to optimized machine code at runtime, allowing calculation speeds close to C or FORTRAN. If you are using [Numba](http://numba.pydata.org/), you can replace *CropWatCalc.py*, *BioMassCalc.py* and *ETOCalc.py* files in *PyAEZ/code/* with Numba version of those files located in *PyAEZ/code/numba_core/* when you are running *NB2_CropSimulation.ipynb*.
        
        
        
        ### Documentation
        API Documentation is located in "docs" folder.
        
        ### Citation
        Use this bibtex to cite us.
        ```
        @misc{PyAEZ_2020,
          title={PyAEZ Python Package for Agro-ecological zoning (AEZ)},
          author={N. Lakmal Deshapriya, Thaileng Thol, Kavinda Gunasekara, Rajendra Shrestha, Gianluca Franceschini, Freddy Nachtergaele, Monica Petri, Beau Damen},
          year={2020},
          publisher={Github},
          journal={GitHub repository},
          howpublished={\url{https://github.com/gicait/PyAEZ}},
        }
        ```
        
        ### Developed by
        [Geoinformatics Center](www.geoinfo.ait.ac.th) of [Asian Institute of Technology](www.ait.ac.th).
        
        Principal Investigators (PIs) of the project:
        * Dr. Kavinda Gunasekara (kavinda@ait.asia)
        * Prof. Rajendra Shrestha (rajendra@ait.ac.th)
        
        ### Funding
        Food and Agriculture Organization of the United Nations ([FAO](http://www.fao.org/home/en/)) and [FAO SAMIS](http://www.fao.org/in-action/samis/en/) (Strengthening Agro-climatic Monitoring and Information System) Project in Lao PDR.
        
        ### Sample Data Source
        * Abatzoglou, J.T., S.Z. Dobrowski, S.A. Parks, K.C. Hegewisch, 2018, Terraclimate, a high-resolution global dataset of monthly climate and climatic water balance from 1958-2015, Scientific Data,
        
        ### Major AEZ References
        * de Wit, C. T. (1965). Photosynthesis of leaf canopies. Agricultural Research Report No. 663. PUDOC, Wageningen, 57 .
        * FAO. (1992). Cropwat: A computer program for irrigation planning and management. Land and Water Development Division, Rome, Italy, FAO Irrigation and Drainage Paper no 46 .
        * FAO. (1998). Crop evapotranspiration. FAO Irrigation and Drainage Paper no.56 Rome, Italy.
        * FAO. (2017). Final Report: National Agro-Economic Zoning for Major Crops in Thailand (NAEZ).
        * Fischer, G., van Velthuizen, H., Shah, M., & Nachtergaele, F. (2002a). Global agroecological assessment for agriculture in the 21st century: Methodology and results. IIASA RR-02-02, IIASA, Laxenburg, Austria.
        * Monteith, J. L. (1965). Evapotranspiration and the environment. In The State and Movement of Water in Living Organisms, 205-234.
        * Monteith, J. L. (1981). Evapotranspiration and surface temperature. Quarterly Journal Royal Meteorological Society, 107 , 1-27.
        
Keywords: AEZ,Python,Agro-ecological Zoning,Climate Regime,Crop Simulations,Climate Constraints,Soil Constraints,Terrain Constraints,Economic Suitability Analysis,Utility Calculation,Biomass Calculations,Evapotranspiration Calculation,CropWat calculations
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: dev
