⚠️ Important: We are phasing out TagReader, and the code will no longer be maintained.
For employees in Equinor we recommend using Omnia Timeseries
tagreader-python
Tagreader is a Python package for reading timeseries data from the OSIsoft PI and Aspen Infoplus.21 Information Management Systems (IMS). It is intended to be easy to use, and present as similar interfaces as possible to the backend plant historians.
Installation
You can install tagreader directly into your project from pypi by using pip or another package manager. Supports Python version 3.9.2 and above.
pip install tagreader
Usage
Tagreader is easy to use for both Equinor internal IMS services, and non-internal usage. For non-internal usage you simply need to provide the corresponding IMS service URLs and IMSType. See data source for details.
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)
Note, you can add a timeout argument to the search method in order to avoid long-running search queries.
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]
The quickstart Jupyter Notebook can be found here
For more details, see the Tagreader Docs.
Documentation
The full documentation can be found in Tagreader Docs
1 maintainer
Metadata
1 maintainer
Release files for tagreader 6.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tagreader-6.3.0.tar.gz | 23.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tagreader-6.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 49.5 kB
Release files / tagreader-6.3.0.tar.gz
| Download URL | tagreader-6.3.0.tar.gz |
|---|---|
| Size | 23.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
69ca1f0618e863f18c4025f5368c3af0f68ffca2454e160337c79e05d352f890
|
|
BLAKE2b-256 checksum How to use checksums |
7424427865bcddf05b54f2b57ce0668cc23208f8f1b67b2b4fec1ee5268d4c69
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.5.1 CPython/3.12.10 Windows/2025Server
|
Release files / tagreader-6.3.0-py3-none-any.whl
| Download URL | tagreader-6.3.0-py3-none-any.whl |
|---|---|
| Size | 25.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
492b6fb144ce2a1059d5618fbacc334ac7329e9b0a0d077d3e40efe8ca67fe86
|
|
BLAKE2b-256 checksum How to use checksums |
bc534e7184e52ee503b62189e916032fc4d3f85e1b02e50a0e739e0da5ab742e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.5.1 CPython/3.12.10 Windows/2025Server
|
