Skip to main content

The Seeq SDK for Python

Project description

The seeq Python library is used to interface with Seeq Server (http://www.seeq.com).

IMPORTANT:

This module does NOT follow semantic versioning.

The major and minor version of this module needs to match the version of Seeq Server that you are using. (Ignore the "R number" of the Seeq Server version - i.e. "R21", "R22" etc.)

PIP version matching can be used to select the correct version.

Here are some examples:

Seeq Server Version PIP Install Command
R21.0.44.00 pip install -U seeq~=0.44.0
R22.0.45.02 pip install -U seeq~=0.45.2

The last part of the version of this seeq module (the Z of w.x.y.Z) is referred to as the functional version and refers to the level of functionality (and bug fixes) present in the package for the Spy module. For example, 0.44.0.118 and 0.45.2.118 have the same level of Spy functionality but are built for the respective versions of Seeq Server (R21.0.44.00 and R22.0.45.02).

seeq.spy

The Seeq Spy module is a friendly set of functions that are optimized for use with Jupyter, Pandas and NumPy.

The Spy module is the best choice if you're trying to do any of the following:

  • Search for signals, conditions, scalars, assets
  • Pull data out of Seeq
  • Import data in a programmatic way (when Seeq Workbench's CSV Import capability won't cut it)
  • Calculate new data in Python and push it into Seeq
  • Create an asset model

To start exploring the Spy module, execute the following lines of code in Jupyter:

from seeq import spy
spy.docs.copy()

Your Jupyter folder will now contain a Spy Documentation folder that has a Tutorial and Command Reference notebook that will walk you through common activities.

For more advanced tasks, you may need to use the SDK module described below.

seeq.sdk

The Seeq SDK module is a set of Python bindings for the Seeq Server REST API. You can experiment with the REST API by selecting the API Reference menu item in the upper-right "hamburger" menu of Seeq Workbench.

Login is accomplished with the following pattern:

import seeq
import getpass

api_client = seeq.sdk.ApiClient('http://localhost:34216/api')

# Change this to False if you're getting errors related to SSL
seeq.sdk.Configuration().verify_ssl = True

auth_api = seeq.sdk.AuthApi(api_client)
auth_input = seeq.sdk.AuthInputV1()

# Use raw_input() instead of input() if you're using Python 2
auth_input.username = input('Username:').rstrip().lower()
auth_input.password = getpass.getpass()
auth_input.auth_provider_class = "Auth"
auth_input.auth_provider_id = "Seeq"
auth_api.login(body=auth_input)

The api_client object is then used as the argument to construct any API object you need, such as seeq.sdk.ItemsApi. Each of the root endpoints that you see in the API Reference webpage corresponds to a seeq.sdk.XxxxxApi class.


In case you are looking for the Gencove package, it is available here: https://pypi.org/project/gencove/

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seeq-0.45.2.128.tar.gz (2.2 MB view hashes)

Uploaded Source

Built Distribution

seeq-0.45.2.128-py3-none-any.whl (2.5 MB view hashes)

Uploaded Python 3

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