Skip to content

Exporting Quix data to Jupyter Notebook

In this documentation, you learn how to use Jupyter Notebook to analyze data persisted in Quix.

Why this is important

Although Quix is a real-time platform, to build real-time in-memory models and data processing pipelines, you need to understand data first. To help with that, Quix offers the option to persist data in topics. This data can be accessed using the Query API. This helps make data discovery and analysis easier.

Prerequisites

You'll need some data stored in Quix. You can use any of the Quix data sources available in the Quix Code Samples.

You can also follow the onboarding process when you sign-up to Quix. This process helps you create a source.

You also need Python 3 environment set up in your local environment.

Install Jupyter Notebook as directed here.

Create a new notebook file

You can now run Jupyter from the Windows start menu, or with the following command in an Anaconda Powershell Prompt, or the equivalent for your operating system:

jupyter notebook

Then create a new Python 3 notebook:

Jupyter new file

Connecting Jupyter Notebook to persisted data

The Quix web application has a Python code generator to help you connect your Jupyter notebook with Quix.

You need to be logged into Quix for this. To import persisted data:

  1. Select an environment.

  2. In the main left-hand navigation, click Data explorer.

  3. Add a query to visualize some data. Select parameters, events, aggregation and time range.

  4. Select the Code tab.

  5. Ensure Python is the selected language:

    Jupyter connect Python

  6. Copy the Python code to your Jupyter notebook and click Run:

    Jupyter results

Tip

If you want to use this generated code for a long time, replace the temporary token with a Personal Access Token.

Too much data

If you find that the query results in more data than can be handled by Jupyter Notebook, then try using the aggregation feature to reduce the amount of data returned.

For more info on aggregation you can watch this short video.