semvec/pypi-packages huggingface dataset:
springtime 0.2.2
Spatiotemporal phenology research with interpretable models
Requires Python: >=3.10
Keywords: phenology

[![Documentation Status](https://readthedocs.org/projects/springtime/badge/?version=latest)](https://springtime.readthedocs.io/en/latest/?badge=latest)
[![RSD](https://img.shields.io/badge/RSD-springtime-blue)](https://research-software-directory.org/software/springtime)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7835299.svg)](https://doi.org/10.5281/zenodo.7835299)
[![PyPI version](https://badge.fury.io/py/springtime.svg)](https://badge.fury.io/py/springtime)



For detailed information and instruction, please refer to the
[documentation](https://springtime.readthedocs.io/)

<!--intro-start-->
# Springtime

Springtime is both a project and a python packaged aimed at streamlining
workflows for doing machine learning with phenological datasets.

Phenology is the scientific discipline in which we study the lifecycle of plants
and animals. A common objective is to develop (Machine Learning) models that can
explain or predict the occurrence of phenological events, such as the blooming
of plants. Since there is a variety of data sources and existing tools to
retrieve and analyse phenology data, it is easy to get lost and disorganized.

At the heart of springtime is a data representation following the scikit-learn
standard structure. The springtime python package implements (down)loaders for
various datasets that are able to convert the data to this same structure. Data
loading specifications can be exported to yaml recipes for easy sharing.

The documentation has an extensive user guide that shows how each of the data
loaders convert from the raw to the standardized data format. It also includes
examples of using various (combinations of) models.

The data structure proposed here is still not ideal, and should rather be seen
as a first step in standardizing workflows in phenological modelling. We hope it
will serve as a basis for discussion and further developments.

## Example task

Predict the day of first bloom of the common lilac given indirect observations
(e.g. satellite data) and/or other indicators (e.g. sunshine and temperature).

![illustration_example_use_case](docs/illustration.png)
<!--intro-end-->