Pyaez

We are excited to announce a new update for PyAEZv2.2, an open-source Python library for working with the Agro-Ecological Zonation (AEZ) methodology. This update includes several logic and input data enhancements and bug fixes to improve the functionality and user experience of the library.

The improvement of the overall accuracy and reliability of the AEZ methodology is covered in the new version in Modules 2, and 3, and input data usage is modified in Modules 4 & 5. The key updates are listed as follows:

**Module 2:**
- New parameters added in reading crop/crop cycle parameters from Excel sheet (minimum and maximum cycle lengths, plant height)
- Revised algorithm flow for overall perennial/annual crop simulations.
- New logic: kc factor adjustment based on local climate (Crop Water Requirement)
- Revised logic: Daily value interpolations of Ac, Bc, Bo, and Pm based on GAEZ (Biomass Calculation)

**Module 3:**
- Look-up tables of agro-climatic constraints can be provided as Excel sheets.
- Validated calculation procedures of fc3 map.

**Module 4:**
- Soil Requirement Suitability factors can now be prepared and provided as Excel sheets.
- New routine: 7-soil layer inputs of soil characteristics to evaluate soil suitability (based on HWSD v2.0) (Experimental).
- New output: soil suitability rating map (fc4).

**Module 5**
- Terrain constraint factors can now be prepared and provided as Excel sheets.
- New output: terrain suitability map (fc5).


User-guide and tutorial Jupyter notebooks are updated for the new version.

We would like to express our gratitude to the PyAEZ community for their valuable feedback and contributions. Your input has been instrumental in shaping this update and making PyAEZ more robust and user-friendly.

To get started with the latest version of PyAEZ, please visit our GitHub repository: https://github.com/gicait/PyAEZ. Detailed installation instructions and documentation can be found in the repository's README file.

If you encounter any issues or have suggestions for further improvements, please don't hesitate to open an issue on our GitHub repository. We appreciate your continued support and involvement in the PyAEZ project.

Thank you for choosing PyAEZ, and we hope this update enhances your experience and enables you to gain deeper insights into the Agro-Ecological Zonation methodology.



Best regards
PyAEZ Team

Asian Institute of Technology, Thailand
Food and Agriculture Organization of the United Nations

Release Note PyAEZv2.1 (kboonma NokuzaSezo97)
The goal of this release is to improve the overall accuracy and reliability of the AEZ methodology in Module 1, 2, and 3. The key updates are as follows:

**Module 1**:
- Major improvements in the Length of Growing Period (LGP) calculation routine through the implementation of Numba (a Python package to speed up the calculation) and cross-checking the methodology with the Global AEZ from IIASA.
- All the climatic indicators had been thoroughly cross-checked and verified with the Global AEZ outputs.

**Module 2**:
- Reading crop/crop cycle parameters from excel sheet.
- Updated algorithm for TSUM screening and parameter settings.
- New thermal screening logics: permafrost screening, crop-specific rule screening.
- Updated algorithm for perennial crop simulations.
- New outputs: thermal reduction factor maps (fc1), yield reduction due to moisture deficit (fc2) and optimum starting date, for both rainfed and irrigated conditions.

**Module 3**:
- New look-up table setting for agro-climatic reduction factors for both rainfed and irrigated conditions.
- Updated algorithm related to agro-climatic constraints calculation.
- New outputs: Adjusted Length of Growing Period for agro-climatic constraints, agro-climatic constraint map (fc3).



**Full Changelog**: https://github.com/gicait/PyAEZ/compare/v2.0.0...v2.1

What's changed?
- Improvement in AEZ algorithms in Climate Regime analysis
- Cross-checked and verified with the Global-AEZ v4
- Updated Technical Documentation
- Updated Examples Notebooks, with better walk-throughs

What's Changed
* Required updated on `cropWatCalc`, `ETOCalc` etc by Zahira1 and sriramreddyM
* conda installation setup by iamtekson in https://github.com/gicait/PyAEZ/pull/3
* added installation guideline in readme by iamtekson in https://github.com/gicait/PyAEZ/pull/4
* PR for CSV branch by iamtekson in https://github.com/gicait/PyAEZ/pull/5
* remove tutorials/A_data_preparation upzip file by iamtekson in https://github.com/gicait/PyAEZ/pull/6

New Contributors
* sriramreddyM made their first contribution
* Zahira1 made their first contribution

**Full Changelog**: https://github.com/gicait/PyAEZ/compare/v1.0.0...v1.1.0

Notice for end users using v1.1.0 (Date: 8.6.2022) by NokuzaSezo97
* This release is to inform that the new version of PyAEZ v.1.1.0 is still in experimental progress. Users are advised not to use v1.1.0, instead use the first earlier version 1.0.0 in order to avoid bugs and errors. For installation, kindly use **pip install pyaez==1.0.0**. Thank you.

What's Changed
* conda recipe by iamtekson in https://github.com/gicait/PyAEZ/pull/3
* added installation guideline in readme by iamtekson in https://github.com/gicait/PyAEZ/pull/4
* merge CSV branch by iamtekson in https://github.com/gicait/PyAEZ/pull/5
* remove tutorials/A_data_preparation upzip file by iamtekson in https://github.com/gicait/PyAEZ/pull/6


**Full Changelog**: https://github.com/gicait/PyAEZ/compare/v1.0.0...v1.0.1

What is PyAEZ?
PyAEZ is a python package consisting of many algorithms related to the Agro-ecological zoning (AEZ) framework. PyAEZ tries to encapsulate all complex calculations in AEZ and provide user-friendly, and intuitive ways to input data and output results after calculations.

Installation
If all the dependencies (mainly gdal) are installed correctly, it can be installed using the pip command,

python
pip install pyaez


What is included in this package?
It consists of six main modules,
- 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

And three major algorithms related to AEZ,
- Biomass Calculations
- Evapotranspiration Calculations
- CropWat Calculations

Dependencies
- numpy
- scipy
- gdal
- numba (optional)

Tutorials
All the tutorials related to this package are available under [tutorials folder](https://github.com/gicait/PyAEZ/tree/master/tutorials)

Documentation
For the time being, we keep the pdf documentation inside the [docs folder](https://github.com/gicait/PyAEZ/tree/master/docs). But later we are planning to write the better documentation using [read the docs](https://readthedocs.org/) or any other package.

What's Changed
* All the code structure is designed by lakmalnd and developed by lakmalnd and thailengthol
* Package released by iamtekson
* Update gdal imports for Windows by slibby in https://github.com/gicait/PyAEZ/pull/2

New Contributors
* slibby made their first contribution in https://github.com/gicait/PyAEZ/pull/2

**Full Changelog**: https://github.com/gicait/PyAEZ/commits/v1.0.0