aquacrop

AquaCrop-OSPy: Python implementation of AquaCrop-OS

https://github.com/aquacropos/aquacrop

Science Score: 36.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
  • DOI references
    Found 4 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
    2 of 12 committers (16.7%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.8%) to scientific vocabulary

Keywords

aquacrop aquacrop-os aquacrop-ospy irrigation python
Last synced: 6 months ago · JSON representation

Repository

AquaCrop-OSPy: Python implementation of AquaCrop-OS

Basic Info
Statistics
  • Stars: 124
  • Watchers: 13
  • Forks: 88
  • Open Issues: 27
  • Releases: 26
Topics
aquacrop aquacrop-os aquacrop-ospy irrigation python
Created about 5 years ago · Last pushed about 1 year ago
Metadata Files
Readme Contributing License

README.md

AquaCrop-OSPy

Soil-Crop-Water model based on AquaCrop-OS.

checks release last-commit license python-version image Downloads

```python from aquacrop import AquaCropModel, Soil, Crop, InitialWaterContent from aquacrop.utils import prepareweather, getfilepath

weatherfilepath = getfilepath('tunisclimate.txt') modelos = AquaCropModel( simstarttime=f"{1979}/10/01", simendtime=f"{1985}/05/30", weatherdf=prepareweather(weatherfilepath), soil=Soil(soiltype='SandyLoam'), crop=Crop('Wheat', plantingdate='10/01'), initialwatercontent=InitialWaterContent(value=['FC']), ) modelos.runmodel(tilltermination=True) modelresults = modelos.getsimulationresults().head() print(model_results) ```

About

AquaCrop-OSPy is an open-source Python crop-water model developed by Tim Foster and others (Tom Kelly and Chris Bowden) within the Agriculture, Water and Climate research group at the University of Manchester. The AquaCrop-OSPy code has been developed with support from the the University of Manchester, Daugherty Water for Food Global Institute, Imperial College London, along with input from the United Nations Food and Agriculture Organization's (FAO) AquaCrop Core Development Group.

Please note that AquaCrop-OSPy is not an official implementation or version of the FAO AquaCrop model. AquaCrop-OSPy currently mirrors most features available in version 7.1 of the official FAO AquaCrop model, with the exception of routines for salinity and fertility stress, weed management, and perennial herbaceous crops that are still to be developed. AquaCrop-OSPy has been rigorously tested to verify that the model reproduces accurately the calculations and outputs performed by the official FAO AquaCrop model. However, some bugs or errors may still be found. Please use the Issues tab to raise any issues encountered with the AquaCrop-OSPy. More details about the official FAO AquaCrop model on which AquaCrop-OSPy is based can be obtained here .

For further information about the AquaCrop-OSPy model, you can consult the accompanying open-access journal paper on the code here . There is also an extensive documentation for the model, along with a series of tutorials to help you get started with the Python code (see Quickstart below). AquaCrop-OSPy builds upon an earlier version of code developed in Matlab, more information about which can be found here .

More information about the official FAO AquaCrop model on which AquaCrop-OSPy is based can be obtained here , where you can also access the official raw source AquaCrop code, compiled executables, and most recent code releases that are developed and provided by FAO.

Install

bash pip install aquacrop

Quickstart

A number of tutorials has been created (more to be added in future) to help users jump straight in and run their first simulation. Run these tutorials instantly on Google Colab:

  1. Running an AquaCrop-OSPy model
  2. Estimation of irrigation water demands
  3. Optimisation of irrigation management strategies
  4. Projection of climate change impacts

Installation troubleshooting

If you receive an error message such as "No module named aquacrop.scripts.initiatelibrary" or "ModuleNotFoundError: No module named 'aquacrop.solution.solutionrootzonewater'", please try the following troubleshooting steps:

  1. Run "python -m aquacrop.scripts.initiatelibrary" in your terminal, if this generates an error such as "RuntimeError: Attempted to compile AOT function without the compiler used by numpy.distutils present. Cannot find suitable msvc.", then you need to download and install an MSVC compiler such as the one included in Visual Studio build tools (see https://www.youtube.com/watch?v=pR3tXSq0KI).

  2. If Step 1 doesn't help, then you can run aquacrop in development mode using the code below. This will turn off some function compilation, resulting in minor increases in runtime:
    import os
    os.environ['DEVELOPMENT'] = 'DEVELOPMENT'

Owner

  • Name: AquaCrop-OS
  • Login: aquacropos
  • Kind: organization

GitHub Events

Total
  • Create event: 2
  • Release event: 3
  • Issues event: 10
  • Watch event: 24
  • Issue comment event: 4
  • Push event: 4
  • Pull request event: 5
  • Pull request review event: 2
  • Fork event: 11
Last Year
  • Create event: 2
  • Release event: 3
  • Issues event: 10
  • Watch event: 24
  • Issue comment event: 4
  • Push event: 4
  • Pull request event: 5
  • Pull request review event: 2
  • Fork event: 11

Committers

Last synced: 6 months ago

All Time
  • Total Commits: 450
  • Total Committers: 12
  • Avg Commits per committer: 37.5
  • Development Distribution Score (DDS): 0.5
Past Year
  • Commits: 15
  • Committers: 3
  • Avg Commits per committer: 5.0
  • Development Distribution Score (DDS): 0.133
Top Committers
Name Email Commits
Chris c****n@l****k 225
Tom Kelly t****k@g****m 128
pacs27 p****5@g****m 58
Chris Bowden 4****n@u****m 12
Ryan Avery r****y@u****u 9
Aron Gergely a****y@r****l 6
Mykhailo Boiko s****2@g****m 4
Oleksandr Mialyk 4****k@u****m 3
thomasdkelly t****2@g****m 2
Francisco Puig Pérez-Barquero 5****7@u****m 1
Tim Foster 8****8@u****m 1
Tim Foster t****r@m****k 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 79
  • Total pull requests: 76
  • Average time to close issues: 7 months
  • Average time to close pull requests: 2 months
  • Total issue authors: 43
  • Total pull request authors: 16
  • Average comments per issue: 1.59
  • Average comments per pull request: 0.96
  • Merged pull requests: 50
  • Bot issues: 0
  • Bot pull requests: 5
Past Year
  • Issues: 12
  • Pull requests: 7
  • Average time to close issues: N/A
  • Average time to close pull requests: 28 days
  • Issue authors: 10
  • Pull request authors: 4
  • Average comments per issue: 0.5
  • Average comments per pull request: 0.0
  • Merged pull requests: 5
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • thomasdkelly (25)
  • xhb-fortunate (4)
  • rbavery (3)
  • git-divyamgarg (3)
  • 1150376430 (3)
  • arongergely (2)
  • SoothingMist (2)
  • NickAlexander18 (2)
  • Remotsensei (1)
  • cgalea15 (1)
  • YuqiLiunx (1)
  • TomasMiskov (1)
  • Rachael001l (1)
  • charalamm (1)
  • Andermutu (1)
Pull Request Authors
  • chris-s-bowden (46)
  • thomasdkelly (19)
  • Bowhaven (10)
  • Han-Su22 (8)
  • dependabot[bot] (5)
  • pacs27 (4)
  • rbavery (2)
  • SongshGeo (2)
  • arongergely (2)
  • AstridVa (2)
  • tfoster88 (2)
  • oleksmialyk (2)
  • atlasul-hub (1)
  • fclof (1)
  • samaranin (1)
Top Labels
Issue Labels
enhancement (8) model mistake (4) documentation (3) code structure (2) minor improvement (2) bug (1) gh-action / build issues (1) dependencies (1) speed/efficiency (1)
Pull Request Labels
dependencies (5)

Packages

  • Total packages: 2
  • Total downloads:
    • pypi 1,884 last-month
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 2
    (may contain duplicates)
  • Total versions: 76
  • Total maintainers: 2
proxy.golang.org: github.com/aquacropos/aquacrop
  • Versions: 23
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 6 months ago
pypi.org: aquacrop

Soil-Crop-Water model based on AquaCrop-OS.

  • Versions: 53
  • Dependent Packages: 0
  • Dependent Repositories: 2
  • Downloads: 1,884 Last month
Rankings
Forks count: 6.0%
Dependent packages count: 7.3%
Stargazers count: 8.3%
Average: 8.4%
Downloads: 8.9%
Dependent repos count: 11.8%
Maintainers (2)
Last synced: 6 months ago

Dependencies

requirements.txt pypi
  • cffi ==1.15.0
  • numba ==0.55.0
  • numpy >=1.18.0,<1.22.0
  • pandas >=1.3.5
  • tqdm >=4.64.0
.github/workflows/docs.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
.github/workflows/pypi.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
.github/workflows/test_docs.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
.github/workflows/unittest.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
pyproject.toml pypi
setup.py pypi