Skip to main content

Tagreader is a Python package for reading trend data from the OSIsoft PI and Aspen Infoplus.21 IMS systems.

Project description

tagreader-python

GitHub Build Status PyPI - Python Version PyPI Downloads

Tagreader is a Python package for reading trend data from the OSIsoft PI and Aspen Infoplus.21 IMS systems. It is intended to be easy to use, and present as similar interfaces as possible to the backend historians.

While originally developed for Windows, Tagreader can since release 3.0.0 also be used on Linux and Windows platforms.

Queries can be performed using either REST API (preferred) or ODBC queries. The use of ODBC queries require installation of proprietary drivers from AspenTech and OSIsoft that are only available for Windows.

Trend data is output as Pandas Dataframes. The HDF5 file format is used to cache results.

Requirements

Python >=3.8 with the following packages:

  • pandas >= 1.0.0
  • requests
  • requests-kerberos
  • certifi >= 2023.5.7
  • diskcache
  • pyodbc (**)

**) If using ODBC connections, you must also install proprietary drivers for PI ODBC and/or Aspen IP.21 SQLPlus. These drivers are only available for Microsoft Windows. Pyodbc will therefore not be installed for non-Windows systems.

Installation

To install and/or upgrade:

pip install --upgrade tagreader

If you wish to use ODBC connections to the IMS servers, you will also need to install some proprietary drivers. There is more information in the manual. Please note that the web APIs should normally be preferred.

Usage example

import tagreader
c = tagreader.IMSClient("mysource", "aspenone")
print(c.search("tag*"))
df = c.read_tags(["tag1", "tag2"], "18.06.2020 08:00:00", "18.06.2020 09:00:00", 60)

Jupyter Notebook Quickstart

Jupyter Notebook examples can be found in /examples. In order to run these examples, you need to install the optional dependencies.

pip install tagreader[notebooks]

Documentation

There is a quickstart example file that should get you going. Also check out the full documentation for more information.

Contributing

All contributions are welcome, including code, bug reports, issues, feature requests, and documentation. The preferred way of submitting a contribution is to either create an issue on GitHub or to fork the project and make a pull request.

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

tagreader-4.3.0.tar.gz (27.6 kB view details)

Uploaded Source

Built Distribution

tagreader-4.3.0-py3-none-any.whl (30.0 kB view details)

Uploaded Python 3

File details

Details for the file tagreader-4.3.0.tar.gz.

File metadata

  • Download URL: tagreader-4.3.0.tar.gz
  • Upload date:
  • Size: 27.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.0 CPython/3.11.4 Darwin/22.6.0

File hashes

Hashes for tagreader-4.3.0.tar.gz
Algorithm Hash digest
SHA256 13fed38c61a52f7d44660c2ff5261987ead3b442cf3dee3590c49abfa763f6fb
MD5 2328eade1ee91551abe1870123b94fd8
BLAKE2b-256 5ea1bc25aa9cbc413fbb4e6bd2c42f163ef95c52ac4c00271cd05e56b867688e

See more details on using hashes here.

File details

Details for the file tagreader-4.3.0-py3-none-any.whl.

File metadata

  • Download URL: tagreader-4.3.0-py3-none-any.whl
  • Upload date:
  • Size: 30.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.0 CPython/3.11.4 Darwin/22.6.0

File hashes

Hashes for tagreader-4.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 95580bdac927744f69b3909ba3565887abb386e7ee535d2b63dc6b5357bbac86
MD5 c7e516d8d264b2d34ee6149db1f617dd
BLAKE2b-256 3e4b7435bbff70005ca4fa9ee7a4f6b19b5f3de9fa3dc82bfa3e6f6bc7511191

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page