Skip to main content

Diviner: A Grouped Forecasting API

Project description

Diviner is an execution framework wrapper around popular open source time series forecasting libraries. The aim of the project is to simplify the creation, training, orchestration, and MLOps logistics associated with forecasting projects that involve the predictions of many discrete independent events.

Documentation Latest Python Release Apache 2 License Total Downloads

Is this right for my project?

Diviner is meant to help with large-scale forecasting. Instead of describing each individual use case where it may be applicable, here is a non-exhaustive list of projects that it would fit well as a solution for:

  • Forecasting regional sales within each country that a company does business in per day

  • Predicting inventory demand at regional warehouses for thousands of products

  • Forecasting traveler counts at each airport within a country daily

  • Predicting electrical demand per neighborhood (or household) in a multi-state region

Each of these examples has a common theme:

  • The data is temporally homogenous (all of the data is collected daily, hourly, weekly, etc.).

  • There is a large number of individual models that need to be built due to the cardinality of the data.

  • There is no guarantee of seasonal, trend, or residual homogeneity in each series.

  • Varying levels of aggregation may be called for to solve different use cases.

The primary problem that Diviner solves is managing the execution of many discrete time-series modeling tasks. Diviner provides a high-level API and metadata management approach that relieves the operational burden of managing hundreds or thousands of individual models.

Grouped Modeling Wrappers

Currently, Diviner supports the following open source libraries for forecasting at scale:

Installing

Install Diviner from PyPI via:

pip install diviner

Documentation

Documentation, Examples, and Tutorials for Diviner can be found here.

Community & Contributing

For assistance with Diviner, see the docs.

Contributions to Diviner are welcome. To file a bug, request a new feature, or to contribute a feature request, please open a GitHub issue. The team will work with you to ensure that your contributions are evaluated and appropriate feedback is provided. See the contributing guidelines for submission guidance.

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

diviner-0.1.0.tar.gz (3.8 MB view details)

Uploaded Source

Built Distribution

diviner-0.1.0-py3-none-any.whl (59.0 kB view details)

Uploaded Python 3

File details

Details for the file diviner-0.1.0.tar.gz.

File metadata

  • Download URL: diviner-0.1.0.tar.gz
  • Upload date:
  • Size: 3.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.7

File hashes

Hashes for diviner-0.1.0.tar.gz
Algorithm Hash digest
SHA256 d20cf481295b691835a179b37f36add35f265b4537e4918ec162755064c12bfb
MD5 561d03b35880f33fe69bd860650f9e62
BLAKE2b-256 12f8b6e9ddfe07f6b89b51c345f9bdb35038358b7c60c5ca65c7e1f601e9ff42

See more details on using hashes here.

File details

Details for the file diviner-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: diviner-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 59.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.3 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.9.7

File hashes

Hashes for diviner-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bfc35fd0f7b0ed102f4ff3bff204f952d83e0390335d8073adcafb4777cf3e43
MD5 f2521afd4d7a37ad3037846b12ef4a47
BLAKE2b-256 97dc87d72b0568cee3eb61377ee8858ea76492eec9a876ff5ee9d39724f92b04

See more details on using hashes here.

Supported by

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