This release is a pre-release and may not be stable for production use.
Python Eigen Ingenuity SDK
Overview
Python Eigen Ingenuity is a comprehensive Python library for accessing industrial data from Eigen Ingenuity instances. It enables seamless integration with time-series data, asset models, event logs, and SQL databases for analytics, automation, and ML workflows.
Supports Python 3.12+
Table of Contents
Core Modules
Each module is queried by first instantiating a client object that manages onnection to a certain api. e.g. get_histoiran_multi() then all queries are performed as methods on the returned class
e.g.
hm = get_historian_multi("demo.eigen.co", "Demo-influxdb")
current = hm.getCurrentDataPoints("DEMO_02TI301.PV")
1. Historian Multi
Query time-series data from multiple historians simultaneously. Handles reading, writing, and managing data point metadata.
Connection Function:
get_historian_multi— Initialize Historian Multi client
Reading Data Functions:
getCurrentDataPoints— Fetch the latest tag values instantlygetInterpolatedPoints— Retrieve interpolated data at specific timestampsgetInterpolatedRange— Get interpolated data across a time rangegetRawDatapoints— Fetch raw historian data without interpolationgetClosestRawPoint— Find the nearest raw data point to a specific time
Aggregation Functions:
getAggregates— Compute statistics (min, max, avg, stdDev, median, count, etc.)getAggregateIntervals— Calculate aggregates over regular time intervals
Metadata Functions:
listHistorians— List all available historian connectionslistDataTags— Retrieve all data tags from a historiangetMetaData— Fetch metadata for specific tagscreateTag— Create a new data tagupdateTag— Modify existing tag configuration
Writing Data Functions:
writePoints— Write individual data points to tagswritePointsBatch— Batch write multiple data points efficientlycreatePoint— Create a formatted data point objectcreateAndPopulateTag— Create a new tag and immediately populate it with data
2. Asset Model
Navigate the Neo4J asset model to browse assets, their properties, related assets, and associated measurements.
Connection Function:
get_assetmodel— Initialize Asset Model Client
Core Functions:
getRelatedAssets— Retrieve all instruments or components related to an assetgetProperties— Get metadata fields and custom properties from assetsgetMeasurements— Fetch all timeseries measurements configured for an assetexecuteRawQuery— Run custom Neo4J Cypher queries against the asset modelgetDocuments— Retrieve reference documents attached to assetsgetLabels— Get asset classification labelsgetMatchingNodes— Find assets matching specific criteria
3. Eventlog
Query, filter, and manage event records in the Ingenuity event log system.
Connection Function:
get_eventlog— Initialize Eventlog client
Query Functions:
getEvents— Execute raw queries with filters (severity, type, source, etc.)getEventsBySource— Filter events by source identifier (partial or exact match)getEventsByType— Filter events by event typegetEventsById— Retrieve events by event ID, external ID, or episode ID
Management Functions:
pushToEventlog— Create and push new events to the event logdeleteEventsById— Remove unwanted events in bulk
4. SQL
Execute read-only queries against SQL databases connected to Ingenuity instances.
Connection Function:
get_sql— Initialize SQL client
Query Functions:
executeRawQuery— Execute raw SQL queries with multiple output formats (JSON, DataFrame, CSV file)listDatabases— Retrieve list of available SQL databaseslistTables— List tables within a specific database
5. Common Menu
Query asset relationships, measurements, properties, and documents through a unified interface.
Connection Function:
get_common_menu— Initialize Common Menu client
Functions:
getRelatedAssets— Query related assetsgetProperties— Fetch asset propertiesgetMeasurements— Get measurements for assetsgetDocuments— Retrieve associated documentsgetEvents— Query events from the Common Menu perspectivegetDrivers— Get driver information
6. Elastic (Deprecated)
Legacy module for querying Elasticsearch-backed data sources. Flagged for removal in a future release. Use Eventlog instead.
Connection Function:
get_elastic— Initialize legacy Elastic client
7. Historian (Deprecated)
Legacy single-historian client. Flagged for removal in a future release. Use Historian Multi instead.
Connection Function:
get_historian— Initialize legacy Historian client for a single data source
Authentication
The library supports Azure authentication with:
- User Credentials Flow — Interactive authentication
- CLIENT_CREDENTIALS Flow — Service principal authentication
- API Token — Direct token-based access
Configuration Functions:
set_azure_tenant_id— Specify Azure tenantset_azure_client_id— Specify client/application IDset_azure_client_secret— Specify client secret (for CLIENT_CREDENTIALS)set_api_token— Set API token alternative to Azure authset_auth_scope— Configure OAuth scopedisable_azure_auth— Skip Azure authenticationdisable_auth_token_cache— Disable token caching for securityclear_auth_token_cache— Remove cached tokens
Key Features
✅ Multi-Source Data Access — Query historians, asset models, SQL, and events in one library
✅ Aggregations & Statistics — Built-in support for min, max, average, standard deviation, median, and more
✅ Batch Operations — Efficient bulk writes and queries
✅ Azure Authentication — Enterprise authentication support
✅ Flexible Output — JSON, DataFrames, files, or raw responses
✅ Time-Series Focused — Purpose-built for industrial data workflows
✅ Neo4J Integration — Direct access to asset model graph database
Further Documentation
For complete function signatures, detailed parameters, and code examples, visit:
📖 https://docs.eigeningenuity.co/ingenuity/developing-with-eigen/python-library/overview/
Support
- Documentation Portal: https://docs.eigeningenuity.co/
- Support Tickets: https://eigen.freshdesk.com
1 maintainer
Metadata
1 maintainer
Release files for python-eigen-ingenuity 0.5.35b3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| python_eigen_ingenuity-0.5.35b3.tar.gz | 114.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| python_eigen_ingenuity-0.5.35b3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 271.0 kB
Release files / python_eigen_ingenuity-0.5.35b3.tar.gz
| Download URL | python_eigen_ingenuity-0.5.35b3.tar.gz |
|---|---|
| Size | 114.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4d5d2cc0094ac0264a00486f99da38b6ce30f8965f9caaee1d6245aa4f9f44cb
|
|
BLAKE2b-256 checksum How to use checksums |
4e60cddf286f054f13a3f2f8b61be2339b63c6991c6719cecd3082ea38fa30b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.4
|
Release files / python_eigen_ingenuity-0.5.35b3-py3-none-any.whl
| Download URL | python_eigen_ingenuity-0.5.35b3-py3-none-any.whl |
|---|---|
| Size | 156.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
561c2e8a56efbc716bf068633c5f17e054fee270400c3fdf3b1dd6f78435d1e5
|
|
BLAKE2b-256 checksum How to use checksums |
59e43e7e73799065f13dcf2a337c9671f4568e03993c44edf831afccd8b06b5a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.4
|
Security for python-eigen-ingenuity 0.5.35b3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
