springtime

0.2.2 verified Sat May 09 auth: no python

Springtime is a Python library for spatiotemporal phenology research with interpretable models. Current version 0.2.2 (released 2025-06-30), supports Python >=3.10. It provides data loaders for phenological datasets (Daymet, Appeears) and standardized data classes. Release cadence: irregular, with major updates ~6 months.

pip install springtime

Common errors

error ModuleNotFoundError: No module named 'springtime.data' ↓

cause Incorrect import path; loaders are not in springtime.data.

fix

Use 'from springtime.loaders import DaymetPointLoader'.

error KeyError: 'DAYMET_KEY' ↓

cause Environment variable DAYMET_KEY not set when using DaymetPointLoader.

fix

Set the environment variable: os.environ['DAYMET_KEY'] = 'your_key' or use .env file.

Warnings

breaking Direct R calls via Rpy2 have been removed in v0.2.0. Existing workflows relying on Rpy2 will break. ↓

fix Use command-line R scripts instead of direct Rpy2. See user guide for migration.

deprecated The old class DataLoader (without Phenology prefix) is deprecated in v0.2.0 and will be removed in a future release. ↓

fix Use PhenologyDataLoader instead.

gotcha Data for Daymet point downloader requires setting the environment variable DAYMET_KEY. If not set, load() fails with a non-obvious error. ↓

fix Set DAYMET_KEY in environment before calling loader.load().

Imports

PhenologyDataLoader
wrong
```
from springtime.data import PhenologyDataLoader
```
correct
```
from springtime import PhenologyDataLoader
```
PhenologyDataLoader is exposed at package level, not under springtime.data.

DaymetPointLoader

wrong

from springtime.data import DaymetPointLoader

correct

from springtime.loaders import DaymetPointLoader

Loaders are in springtime.loaders module.

Quickstart

Basic usage: load phenology data from Daymet point data.

from springtime import PhenologyDataLoader
from springtime.loaders import DaymetPointLoader

# Load Daymet point data (requires API key; set env var DAYMET_KEY)
loader = DaymetPointLoader(latitude=44.5, longitude=-89.5, years=[2020, 2021])
data = loader.load()
print(data.head())