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 Build CI Examples CI Core CI 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.1.tar.gz (3.8 MB view details)

Uploaded Source

Built Distribution

diviner-0.1.1-py3-none-any.whl (59.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: diviner-0.1.1.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/37.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.7 tqdm/4.64.0 importlib-metadata/4.11.3 keyring/23.8.2 rfc3986/2.0.0 colorama/0.4.4 CPython/3.8.13

File hashes

Hashes for diviner-0.1.1.tar.gz
Algorithm Hash digest
SHA256 5fcfaa8cd3dc62ca039cc803835d2c5e8cc34b94124419c4ce5f04f646a42e3d
MD5 f53d99bf456bfe243991200a0d316ae9
BLAKE2b-256 9307c224b84f6151851376f897643ca20d77d2fd32c858271433d6d95059e185

See more details on using hashes here.

File details

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

File metadata

  • Download URL: diviner-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 59.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/37.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.7 tqdm/4.64.0 importlib-metadata/4.11.3 keyring/23.8.2 rfc3986/2.0.0 colorama/0.4.4 CPython/3.8.13

File hashes

Hashes for diviner-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6440e295f414f7dff93f65f0aa94bf2dab1ca315455cae52a0fc9574f49b53d5
MD5 f04c9a45509cc9938c7174e4d96698d1
BLAKE2b-256 f485029f2ee112950a306c7e07f30540ea06981e0dd1467076baedf9f7a76d7c

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