Data

Tools

Indexes

Applications

Experiments

Open Source Science

pyaez

PyAEZ is a python package consisted of many algorithms related to Agro-ecalogical zoning (AEZ) framework.

https://github.com/gicait/pyaez

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ○
    Committers with academic emails
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (16.1%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

PyAEZ is a python package consisted of many algorithms related to Agro-ecalogical zoning (AEZ) framework.

Basic Info
  • Host: GitHub
  • Owner: gicait
  • License: mit
  • Language: Jupyter Notebook
  • Default Branch: master
  • Homepage:
  • Size: 48.3 MB
Statistics
  • Stars: 99
  • Watchers: 8
  • Forks: 57
  • Open Issues: 48
  • Releases: 6
Created about 6 years ago · Last pushed about 1 year ago
Metadata Files
Readme License

README.md

Downloads PyPI version License: MIT

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.

Installation

Now the package can be installed using pip command as below,

shell pip install pyaez==2.2

Alternatively, can be installed using using conda command as below,

shell conda install -c conda-forge pyaez

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

Step-by-step Process

Following 6 Jupyter notebooks in the GitHub 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: NB2CropSimulation.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 compatible manner as well. Numba translates Python functions to optimized machine code at runtime, allowing calculation speeds close to C or FORTRAN.

Release Note PyAEZv2.2

The improvement of the overall accuracy and reliability of the AEZ methodology is covered in new version in Module 2, 3, and input data usage is modified in Module 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).

Documentation

API Documentation is located in "docs" folder.

Citation

Use this bibtex to cite us.

@misc{PyAEZ(v2.2), title={PyAEZ Python Package for Agro-ecological zoning (AEZ)}, author={Swun Wunna Htet, Kittiphon Boonma, Guenther Fischer, Gianluca Franceschini, N. Lakmal Deshapriya, Thaileng Thol, Kavinda Gunasekara, Rajendra Shrestha, Freddy Nachtergaele, Monica Petri, Beau Damen}, year={2023}, publisher={Github}, journal={GitHub repository}, howpublished={\url{https://github.com/gicait/PyAEZ}}, }

Developed by

Geoinformatics Center of Asian Institute of Technology.

Funding

Food and Agriculture Organization of the United Nations (FAO) and FAO SAMIS (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.

Owner

  • Name: GIC-AIT
  • Login: gicait
  • Kind: organization
  • Email: geoinfo@ait.asia
  • Location: Pathum Thani, Thailand

GitHub Events

Total
  • Issues event: 6
  • Watch event: 14
  • Delete event: 3
  • Issue comment event: 15
  • Push event: 22
  • Pull request event: 6
  • Fork event: 6
  • Create event: 4
Last Year
  • Issues event: 6
  • Watch event: 14
  • Delete event: 3
  • Issue comment event: 15
  • Push event: 22
  • Pull request event: 6
  • Fork event: 6
  • Create event: 4

Committers

Last synced: 11 months ago

All Time
  • Total Commits: 267
  • Total Committers: 14
  • Avg Commits per committer: 19.071
  • Development Distribution Score (DDS): 0.749
Past Year
  • Commits: 20
  • Committers: 3
  • Avg Commits per committer: 6.667
  • Development Distribution Score (DDS): 0.5
Top Committers
Name Email Commits
N. Lakmal Deshapriya 6****d 67
Kittiphon Boonma k****b@g****m 66
Zahira1 s****0@g****m 29
gic 6****c 28
Swun Wunna Htet 7****7 20
Thaileng Thol 6****l 15
sriramreddyM s****i@g****m 13
iamtekson t****a@g****m 9
thailengthol t****2@g****m 6
Tek Kshetri 3****n 6
kerriegeil k****t@g****m 4
Sam Libby s****y@e****m 2
Joel Ferguson 4****g 1
kavinda K****a 1
Committer Domains (Top 20 + Academic)
esri.com: 1

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 65
  • Total pull requests: 83
  • Average time to close issues: about 1 month
  • Average time to close pull requests: about 19 hours
  • Total issue authors: 27
  • Total pull request authors: 7
  • Average comments per issue: 3.08
  • Average comments per pull request: 0.01
  • Merged pull requests: 78
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 8
  • Pull requests: 3
  • Average time to close issues: N/A
  • Average time to close pull requests: about 10 hours
  • Issue authors: 7
  • Pull request authors: 2
  • Average comments per issue: 1.25
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • WeirdCxychen (12)
  • maobw12 (11)
  • LEEgiser (6)
  • handuGIS (5)
  • yelvk (5)
  • kidstoneszk (3)
  • Yuuko843 (2)
  • taynaravaleriano (1)
  • Dhouha-ouerf (1)
  • kone-colab (1)
  • KaixuanDai (1)
  • Jane-blubb (1)
  • syqalibrary (1)
  • lixuan-code (1)
  • milosara (1)
Pull Request Authors
  • kboonma (60)
  • NokuzaSezo97 (14)
  • iamtekson (5)
  • kerriegeil (2)
  • slibby (1)
  • joelferg (1)
  • StellaHtet92 (1)
Top Labels
Issue Labels
Pull Request Labels
bug (5)

Packages

  • Total packages: 4
  • Total downloads:
    • pypi 77 last-month
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 1
    (may contain duplicates)
  • Total versions: 17
  • Total maintainers: 2
proxy.golang.org: github.com/gicait/PyAEZ
  • Versions: 4
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 10 months ago
proxy.golang.org: github.com/gicait/pyaez
  • Versions: 4
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 10 months ago
pypi.org: pyaez

PyAEZ is a python package consisted of many algorithms related to Agro-ecalogical zoning (AEZ) framework.

  • Versions: 7
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 77 Last month
Rankings
Forks count: 6.0%
Stargazers count: 8.5%
Dependent packages count: 10.1%
Average: 11.7%
Downloads: 12.3%
Dependent repos count: 21.5%
Maintainers (2)
iamtekson kboonma
Last synced: 10 months ago
conda-forge.org: 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.

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Forks count: 29.4%
Dependent repos count: 34.0%
Average: 38.6%
Stargazers count: 39.6%
Dependent packages count: 51.2%
Last synced: 10 months ago

Dependencies

.github/workflows/release_to_pypi.yml actions
  • actions/checkout v2 composite
  • actions/create-release v1 composite
  • actions/setup-python v2 composite
  • actions/upload-release-asset v1 composite
  • pypa/gh-action-pypi-publish master composite
conda-recipe/meta.yml cpan
requirements.txt pypi
  • GDAL >=3.4.3
  • llvmlite >=0.40.1
  • numba >=0.56
  • numpy >=1.23
  • pandas =1.5.3
setup.py pypi
  • gdal *
  • numba *
  • numpy *
  • pandas *
  • scipy *