Skip to main content

Aspect-based Forecasting Accuracy

Project description

Model Radar 🎯

A framework for aspect-based evaluation of time series forecasting models based on Nixtla's ecosystem.

PyPi Version GitHub Downloads

Overview

Model Radar introduces a novel aspect-based forecasting evaluation approach that goes beyond traditional aggregate metrics. Our framework enables:

  • Fine-grained performance analysis across different forecasting aspects
  • Better understanding of model behavior in varying conditions
  • More informed model selection based on specific use case requirements

🚀 Getting Started

Check the notebooks folder for usage examples and tutorials.

Installation

You can install modelradar using pip:

pip install modelradar

[Optional] Installation from source

To install modelradar from source, clone the repository and run the following command:

git clone https://github.com/vcerqueira/modelradar
pip install -e modelradar

Prerequisites

Required dependencies:

utilsforecast==0.2.11
numpy==1.26.4
plotnine==0.14.5

Example outputs

  • Spider chart with overall view on several dimensions:

radar

  • Parallel coordinates chart with overall view on several dimensions:

radar2

  • Barplot chart controlling for a given variable (in this case, anomaly status):

radar2

  • Grouped bar plot showing win/draw/loss ratios wrt different models:

radar2

📑 References

Cerqueira, V., Roque, L., & Soares, C. (2024). "Forecasting with Deep Learning: Beyond Average of Average of Average Performance." arXiv preprint arXiv:2406.16590

Check DS24 folder to reproduce the experiments published on this paper. The main repository and package contains an updated framework.

⚠️ WARNING

modelradar is in the early stages of development. The codebase may undergo significant changes. If you encounter any issues, please report them in GitHub Issues

Project Funded by

Agenda “Center for Responsible AI”, nr. C645008882-00000055, investment project nr. 62, financed by the Recovery and Resilience Plan (PRR) and by European Union - NextGeneration EU.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

modelradar-0.1.3.tar.gz (5.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

modelradar-0.1.3-py3-none-any.whl (11.8 kB view details)

Uploaded Python 3

File details

Details for the file modelradar-0.1.3.tar.gz.

File metadata

  • Download URL: modelradar-0.1.3.tar.gz
  • Upload date:
  • Size: 5.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.10.15

File hashes

Hashes for modelradar-0.1.3.tar.gz
Algorithm Hash digest
SHA256 f4c22704e65005fe573d6b156deeb1e92e5f49b1204075d6fe7eae4423af2de6
MD5 ff2e38bb7cca7cf2cbcd2dbe90d9e401
BLAKE2b-256 58b83193c6f6babd5404a6b09c1cdeef878005b7d54e9579bda33c85f195f025

See more details on using hashes here.

File details

Details for the file modelradar-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: modelradar-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 11.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.10.15

File hashes

Hashes for modelradar-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 a9e4c5dad09ed9d893e9e835f3127c557480285f20d35eb3f3d0349fa8bde9fe
MD5 98d7dfa3b7d9a908231722ed66fbe6b3
BLAKE2b-256 62efae386546cfa5036dfb42b281f70e712ff53027444075f676b65d3e09f4ad

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page