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')

Metadata

Release files for ETo 2.2.1

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.2.1
File Size Uploaded
eto-2.2.1.tar.gz 125.1 kB Details

Built distribution (wheel)

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

Total release size: 252.5 kB

Release files / eto-2.2.1.tar.gz

Download URL eto-2.2.1.tar.gz
Size 125.1 kB
Tags Source
SHA-256 checksum
How to use checksums
8c88808d9eae19ca638049267e1d6837da97f107ace58fbfd90701b8adfab91d
BLAKE2b-256 checksum
How to use checksums
bd9ab1487a328b4851bbdec3728d0e07d07657b23462ea26a997ad8d306a103c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.7

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

Download URL eto-2.2.1-py3-none-any.whl
Size 127.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4e042675543c90fb60cd37c462b43a19217bc190cf83cae5903fd155985612c0
BLAKE2b-256 checksum
How to use checksums
b173c6b90ff9a20dd26dd119fb003d81db71f11ba9155d6e434391e007e2ea85
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.2.1 This release

2 release files

2.2.0

2 release files

2.1.0

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