adding IP21 support

Author: cloud-rocket

README.md

@@ -18,16 +18,14 @@ and historians.
 The following systems are currently supported:
 
 * [Osisoft PI](https://github.com/imubit/data-agent-osisoft-pi)
+* [AspenTech InfoPlus.21](https://github.com/imubit/data-agent-aspen-ip21)
 
 It supports browsing and selecting tags on the target system and extract periods of data into zipped CSVs.
 
 ## Installation
 
 Please use https://github.com/imubit/qt-data-extractor/releases to download the latest version of the extractor.
 
-If you would like to extract data from Osisoft PI historian (which is the only one supported at this point). Please
-make sure you have [PI SDK](https://techsupport.osisoft.com/Products/PI-System-Access/PI-SDK/Overview) and AF SDK installed and configured on your workstation.
-
 ## Getting Started
 
 * Configure the target historian using `Server` drop down.
@@ -38,10 +36,17 @@ make sure you have [PI SDK](https://techsupport.osisoft.com/Products/PI-System-A
 * Click `Extract` and confirm your selection.
 * Wait until extraction is finished.
 
+### Osisoft PI historian prerequisites
+
+Please make sure you have [PI SDK](https://techsupport.osisoft.com/Products/PI-System-Access/PI-SDK/Overview) and AF SDK installed and configured on your workstation before attempting to access PI historian
+
+
 ## Development
 
 ### Python Install
 
+Python package distribution is available in addition to Windows installer.
+
 ```python
 pip install qt-data-extractor
 ```

data-extractor.spec

@@ -12,6 +12,7 @@ a = Analysis(
     runtime_hooks=[],
     excludes=[],
     noarchive=False,
+    optimize=0,
 )
 pyz = PYZ(a.pure)
 

docs/aspen-ip21.md

@@ -0,0 +1,18 @@
+# Extracting Data from AspenTech IP21
+
+## Prerequisites
+
+* Please make sure "AspenTech SQLplus" ODBC driver is installed on your local workstation.
+
+## Getting Started
+
+* Select "Add New Connection" from Server drop down or from "Connections" menu.
+* Select "aspen-ip21" from "Connection Type" dropdown.
+* Set "Connection Name" to a string you can later recognize (i.e. "Ip21-left-wing").
+* Leave "Connection String" empty if you plan to select "Server Host" IP or DNS name.
+* "Default Group" should be set to a name of the table your tags are stored at, when accessing from SQLplus. (It is usually one of the - `IP_AIDef`, `IP_DIDef`, `IP_CalcDef`).
+* Select "ODBC Driver" (most often it would be "AspenTech SQLplus").
+* Set "Server Host" to be an IP address or DNS name of the IP21 server.
+
+At this point tags from a specific "Default Group" can be accessed per single connection.
+If you'd like to access tags from more than a single group - please create multiple connections.

docs/index.md

@@ -1,17 +1,7 @@
-# qt-data-extractor
+# Industrial Data Extractor
 
-Add a short description here!
-
-
-## Note
-
-> This is the main page of your project's [Sphinx] documentation. It is
-> formatted in [Markdown]. Add additional pages by creating md-files in
-> `docs` or rst-files (formatted in [reStructuredText]) and adding links to
-> them in the `Contents` section below.
->
-> Please check [Sphinx] and [MyST] for more information
-> about how to document your project and how to configure your preferences.
+Industrial Data Extractor is an open-source Windows application to extract process data from industrial systems
+and historians.
 
 
 ## Contents
@@ -20,6 +10,8 @@ Add a short description here!
 :maxdepth: 2
 
 Overview <readme>
+Extracting data from Osisoft PI <osisoft-pi>
+Extracting data from AspenTech IP21 <aspen-ip21>
 Contributions & Help <contributing>
 License <license>
 Authors <authors>

docs/osisoft-pi.md

@@ -0,0 +1,5 @@
+# Extracting Data from Osisoft PI
+
+## Prerequisites
+
+Please make sure you have [PI SDK](https://techsupport.osisoft.com/Products/PI-System-Access/PI-SDK/Overview) and AF SDK installed and configured on your workstation before attempting to access PI historian

setup.cfg

@@ -54,6 +54,7 @@ install_requires =
     PySide6
     data-agent>=0.2.0
     data-agent-osisoft-pi>=0.3.0
+    data-agent-aspen-ip21
     data-agent-zip
 
 [options.packages.find]