Library for reading from Aspen InfoPlus.21 and OSIsoft PI IMS servers
Project description
Tagreader
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.7 with the following packages:
- pandas >= 1.0.0
- tables (*)
- requests
- requests-kerberos
- certifi >= 2020.04.05
- pyodbc (**)
*) If tables is not installed, caching of fetched data will be disabled. Tables will be installed alongside Tagreader unless the installation is known to fail, which is the case for Macs with M1 chip.
**) 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
Usage example
import tagreader
c = tagreader.IMSClient("mysource", "aspenweb")
print(c.search("tag*"))
df = c.read_tags(["tag1", "tag2"], "18.06.2020 08:00:00", "18.06.2020 09:00:00", 60)
Also see the quickstart document and the manual for more information.
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
Built Distribution
Hashes for tagreader-3.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c518c083bcb98f6653df94cc4e2022c42c1fd84248323773d959e2e1c646e021 |
|
MD5 | bb368631e084139247d8ad17b6145320 |
|
BLAKE2b-256 | 9bf25c00454344ab67fe9d593ab58f5730a761b90f567de735e31fc9ef449d12 |