AquaCrop-OSPy
Soil-Crop-Water model based on AquaCrop-OS.
from aquacrop import AquaCropModel, Soil, Crop, InitialWaterContent
from aquacrop.utils import prepare_weather, get_filepath
weather_file_path = get_filepath('tunis_climate.txt')
model_os = AquaCropModel(
sim_start_time=f"{1979}/10/01",
sim_end_time=f"{1985}/05/30",
weather_df=prepare_weather(weather_file_path),
soil=Soil(soil_type='SandyLoam'),
crop=Crop('Wheat', planting_date='10/01'),
initial_water_content=InitialWaterContent(value=['FC']),
)
model_os.run_model(till_termination=True)
model_results = model_os.get_simulation_results().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
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:
- Running an AquaCrop-OSPy model
- Estimation of irrigation water demands
- Optimisation of irrigation management strategies
- Projection of climate change impacts
Installation troubleshooting
If you receive an error message such as "No module named aquacrop.scripts.initiate_library" or "ModuleNotFoundError: No module named 'aquacrop.solution.solution_root_zone_water'", please try the following troubleshooting steps:
-
Run "python -m aquacrop.scripts.initiate_library" 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=p_R3tXSq0KI).
-
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'
2 maintainers
Metadata
2 maintainers
Release files for aquacrop 3.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aquacrop-3.1.0.tar.gz | 10.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aquacrop-3.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 21.3 MB
Release files / aquacrop-3.1.0.tar.gz
| Download URL | aquacrop-3.1.0.tar.gz |
|---|---|
| Size | 10.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fbf5a06e7e8ed8eeff0bb58c80e9023823cbd0908e0831322ae1df092b55f225
|
|
BLAKE2b-256 checksum How to use checksums |
3aac0fa3858bea3d0bff315310e5ddb7e523c252d2cde11d46698bf94fe0736b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / aquacrop-3.1.0-py3-none-any.whl
| Download URL | aquacrop-3.1.0-py3-none-any.whl |
|---|---|
| Size | 10.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1d72e30aa64b5ef1ba02af64a0c5ed3911903d9291870479d65b5c1cefd77458
|
|
BLAKE2b-256 checksum How to use checksums |
c13e257f99c55a03637d1c01ac127ad840a34d80bd076a4656463ec301bed614
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
