Skip to main content

ETo

A Python package for calculating reference and crop evapotranspiration


ETo calculates reference evapotranspiration (ETo) and crop evapotranspiration (ETc) using the UN-FAO 56 paper methodology. It estimates missing meteorological parameters from available data and supports daily, hourly, and monthly time steps.

Features

  • FAO 56 Penman-Monteith reference ET (short and tall reference crops)
  • Hargreaves simplified daily ET
  • Crop evapotranspiration — single Kc, dual Kc (Kcb + Ke), and water stress adjustment (Ks)
  • Built-in crop coefficients for 23 major crops (FAO 56 Table 12)
  • Automatic parameter estimation with quality tracking
  • Input validation with configurable warnings
  • Derived outputs — VPD, T_dew (back-calculated), clear-sky radiation

Documentation

Full documentation is available at mullenkamp.github.io/ETo.

Installation

pip install eto

or:

conda install -c mullenkamp eto

The only dependency is NumPy.

Quick Example

import numpy as np
from eto import ETo

data = {
    'T_min': np.array([10.0, 12.0, 8.0]),
    'T_max': np.array([25.0, 28.0, 22.0]),
}
dates = np.arange('2020-01-01', '2020-01-04', dtype='datetime64[D]')

et = ETo(data, freq='D', z_msl=500, lat=-43.6, dates=dates)

# Reference ET
eto = et.eto_fao()  # np.ndarray of ETo in mm

# Crop ET (single Kc)
etc = et.etc(crop='maize_grain', stage='mid')  # ETc = Kc × ETo

# Tall reference crop (ASCE alfalfa)
etr = et.eto_fao(ref_crop='tall')

Release files for ETo 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ETo 2.1.0
File Size Uploaded
eto-2.1.0.tar.gz 118.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ETo 2.1.0
File Interpreter ABI Platform
eto-2.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 238.3 kB

Release files / eto-2.1.0.tar.gz

Download URL eto-2.1.0.tar.gz
Size 118.1 kB
Tags Source
SHA-256 checksum
How to use checksums
e646956d0ba68a47c6049585879d2d9bc872758311b1647575f2811b01290530
BLAKE2b-256 checksum
How to use checksums
e08423c2c43daa83e6ac3284de1fd563fb519698b67aa23a1f73b9c8d6c2d38d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.7

Release files / eto-2.1.0-py3-none-any.whl

Download URL eto-2.1.0-py3-none-any.whl
Size 120.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d3a63a75ad673815b122ce22ec42288e4806091d5069134e8529b7bb26927c43
BLAKE2b-256 checksum
How to use checksums
1d3ec34bff77b2ed9ce4663633bbf5603bb287dbe61bfed45df921f71134ce46
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.7

Release history Release notifications | RSS feed

This release

2.1.0 This release

2 release files

2.0.0

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

1 release file

1.0.9

1 release file

1.0.8

1 release file

1.0.7

1 release file

1.0.6

1 release file

1.0.5

1 release file

1.0.4

1 release file

1.0.3

1 release file

1.0.2

1 release file

1.0.1

1 release file

1.0.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page