Quantum Leap Client Library for Python

Install

pip install -r requirements.txt

python setup.py install

What is it?

'QuantumLeapClient' is a Python client library
that helps QuantumLeap API calls.

Key Features

• Quantum Leap version > 0.7.6
• NGSI v2 support
• Calls QuantumLeap API in python
• Handle datetime object as a parameter
• Get all historical data in QuantumLeap
• Allow visualization/debbugging feature.

Usage

Initialize QuantumLeapClient

Import and initialize QuantumLeapClient.

from quantumleapclient.client import Client

client = Client(host='localhost', port=8668)

Register time series data

Create and register time series data using QuantumLeapClient.

body = {}
body["subscription_id"] = "5947d174793fe6f7eb5e3961" # Random value
entity = {}
entity["id"] = "Room1"
entity["type"] = "Room"
entity["temperature"] = {'type': 'Float', 'value': 23.0}
entity["pressure"] = {'type': 'Integer', 'value': 720}
body["data"] = [entity]

client.post_notify(body=body)

Fetch time series data

Fetch time series data using QuantumLeapClient.

response = client.get_entity_attribute(entity_id='Room1',
                                  attr_name='temperature')
print(response)

The resulting JSON looks like this :

{
    "attrName": "temperature",
    "entityId": "Room1",
    "index": ["2021-01-29T01:44:33.198+00:00"],
    "values": ["23"]
}

API calls with parameters can be made by adding parameter names and values
to the arguments of the QuantumLeapClient function. In QuantumLeapClient, the parameters toDate and fromDate can handle python datetime objects.

from datetime import datetime, timedelta

toDate = datetime.utcnow()
fromDate = toDate - timedelta(days=1)

response = client.get_entity(entity_id='Room1', toDate=toDate,
                             fromDate=fromDate, limit=1)

Quantum Leap can fetch up to 10000 data with one request. By using QuantumLeapClient, it is possible to hide the loop processing when fetching more than 10000 data from QuantumLeap.

Delete time series data

Delete time series data using QuantumLeapClient.

client.delete_entity_id(entity_id='Room1')

Correspondence table between API call and Quantum Leap Client

The QuantumLeapClient functions correspond to each Quantum Leap API call.

QuantumLeap's API call P0ST / config hasn't been implemented yet, so post_config function isn't working properly.

Licencse

Apache 2.0

Attention

The QuantumLeap client library is running in the QuantumLeap version 0.7.6 environment. API calls differ depending on the version of QuantumLeap, so QuantumLeapClient library may not work.