Skip to content

Repository files navigation

MeteoShrooms

PyPI - Version Tests PyPI - LicenseGitHub Repo stars

Ruff

With MeteoShrooms, you can keep track of the perfect conditions for mushroom hunting. We take Open Government Data (OGD) from the official Swiss Meteorological Service MeteoSwiss to calculate key metrics.

meteoshrooms start page
ℹ️

Contributors Welcome! See Contributing Guidelines for more info…​

Motivation

While hunting mushrooms happens in nature, a lot of the planning can be carried out beforehand.

Where are possible areas to find king boletes?

Should you leave the house right now or are you already too late?

And will your current small basket be large enough or is it time to invest in something bigger?

Meteorological data, time series of past findings as well as other datasets can give us valuable insights.

Concept

Overarching Vision

The main goal is to develop a model to predict mushrooms occurences using OGD data. I suggest starting with meteo data by MeteoSwiss, soil properties (see for example data.geo.admin.ch or opendata.swiss) and using open mushroom observation data from GBIF.

Spatial

Currently, the MeteoShrooms project is focussed on Switzerland, as the Swiss meteorological agency MeteoSwiss has started to provide access to their data as Open Government Data (OGD).

Technical

A main aim is to have sound results calculated efficiently. Therefore, Python Polars is used for calculations, wherever possible. Its LazyFrames optimize the workflow. Data quality is validated through Pandera. Compressed Parquet-Files save storage space and up-/download bandwith.

Currently, the repository hosts all parts of the modelling process: 1. Data Preparation, 2. Model Calculations and 3. Data Presentation:

  1. Data Preparation: Download data from OGD sources and bring them into form needed for next step. Ensure data quality,

  2. Model Calculations: Perform the calculations to generate predictions from observed data,

  3. Data Presentation: Show results on map and/or dashboard. Include documentation of sources and methodology.

flowchart TD
    ground[(Ground Properties)] --> prep
    meteo[(Meteo Data)] --> prep
    mush[(Mushroom Observations)] --> prep
    prep[Prepare Data] --> train
    train[Train AI Model] --> calc
    train --> model@{ shape: lean-l , label: AI Model}
    calc[Calculate Model Predictions] --> present
    present[Present Results]
Loading

Visualization

Metrics and time series visulizations are currently hosted as a Streamlit dashboard, so check it out.

Roadmap

For a more detailed overview, see either Issues or the detailed Project Planner, where the project is managed.

About

MeteoShrooms calculates key metrics to predict mushroom occurences with MeteoSwiss OGD and visualize them on a dashboard with a map.

Topics

Resources

Contributing

Stars

3 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages