Time Series Forecasting Python* Demo

This README describes the Time Series Forecasting demo application.

How It Works

On startup the demo application reads command line parameters and loads a network to Inference Engine.

The program provides an interactive CLI interface that gets a test dataset in .pickle format as input and draws predicted quantiles and ground truth curves.

Preparing to Run

Install required dependencies with command:

pip install -r requirements.txt

The list of models supported by the demo is in <omz_dir>/demos/whiteboard_inpainting_demo/python/models.lst file. This file can be used as a parameter for Model Downloader and Converter to download and, if necessary, convert models to OpenVINO Inference Engine format (*.xml + *.bin).

An example of using the Model Downloader:

python3 <omz_dir>/tools/downloader/downloader.py --list models.lst

An example of using the Model Converter:

python3 <omz_dir>/tools/downloader/converter.py --list models.lst

Supported Models

  • time-series-forecasting-electricity-0001

NOTE: Refer to the tables Intel's Pre-Trained Models Device Support and Public Pre-Trained Models Device Support for the details on models inference support at different devices.

Supported datasets

Prepare dataset

The demo works with the test dataset in the .pickle format provided by accuracy_checker.

  • Install accuracy_checker following to the instruction.
  • Convert test dataset:
wget https://archive.ics.uci.edu/ml/machine-learning-databases/00321/LD2011_2014.txt.zip
unzip LD2011_2014.txt.zip
convert_annotation electricity --data_path_file LD2011_2014.txt

Running the Demo

Running the application with the -h option yields the following usage message:

usage: time_series_forecasting_demo.py [-h] -m MODEL [--input-name INPUT_NAME] [--output-name OUTPUT_NAME] [--data-path DATA_PATH] [--quantiles QUANTILES]
optional arguments:
-h, --help show this help message and exit
-m MODEL, --model MODEL
Required. Path to an .xml file with a trained model
--input-name INPUT_NAME
Optional. Name of the models input node.
--output-name OUTPUT_NAME
Optional. Name of the models output node.
-i INPUT, --input INPUT
Required. Path to the dataset file in .pickle format.
--quantiles QUANTILES
Optional. Names of predicted quantiles.

Running the application with the empty list of options yields the usage message given above and an error message.

You can use the following command to do inference on CPU on the converted dataset using a pre-trained time-series-forecasting-electricity network:

python3 time_series_forecasting_demo.py -i electricity.pickle -m <path_to_model>/time-series-forecasting-electricity-0001.xml

Demo Output

The application draws predicted quantiles and ground truth curves.

See Also