Sartorius Stedim Data Analytics SimApis

A SimApi is a software interface between a Sartorius Stedim Data Analytics software and a data source. The primary purpose of a SimApi is to provide data to SIMCA-online and SIMCA from the data source.

Sartorius Stedim Data Analytics develops SimApis for many different data sources, such as process historians and general purpose databases.

The SimApi specification is public, so anyone can develop SimApis for data sources that Sartorius Stedim Data Analytics does not currently support. Learn more

Obtaining SimApis

This web page provides documentation for all SimApis, and links to SimApis which are offered from partners and other companies. Consult the feature matrix below to learn more about SimApi functionality and which SimApis support which features.

All SimApis built in-house are available for download. 

 Contact your sales representative to obtain the password for a zip-file. 

SimApi Overview User Guide

For details about a specific SimApi, see its User Guide (available below).

Download and read the  SimApi Overview User Guide for SimApi planning, installation instructions and troubleshooting tips.

OPC HDA

The Sartorius Stedim Data Analytics HDA SimApi connects to a data source using the industry standard OPC HDA.

  OPC HDA User Guide       OPC HDA 2.1.1 (zip password)

OPC DA

The Sartorius Stedim Data Analytics DA SimApi connects to a data source using the industry standard OPC DA.

  OPC DA User Guide       OPC DA 2.1.0 (zip password)

ODBC

The Sartorius Stedim Data Analytics ODBC SimApi connects to a SQL database with process data. The required database schema is described in the user guide.

  ODBC User Guide       ODBC 2.1.6 (zip password)

IP21

The Sartorius Stedim Data Analytics IP21 SimApi connects to an AspenTech InfoPlus.21 data source.

  IP21 User Guide       IP21 2.1.6 (zip password)

IP21 Batch

The Sartorius Stedim Data Analytics IP21 Batch SimApi connects to an AspenTech InfoPlus.21 Batch Historian data source. Multiple batch historians are supported simultaneously.

  IP21 Batch User Guide       IP21 Batch 2.1.2 (zip password)

Discoverant

The Sartorius Stedim Data Analytics Discoverant Simapi connects to a Accelrys Discoverant data source.

  Discoverant User Guide       Discoverant 2.2.1 zip (zip password)

BioPAT® Spectro

The Sartorius Stedim Data Analytics BioPAT® Spectro SimApi connects to a BioPAT® Spectro NIR-online spectrometer. Contact Sartorius for more information.

This SimApi is not available for download. Contact Sartorius Stedim Data Analytics to obtain it.

Batch Table Wrapper

The Sartorius Stedim Data Analytics Batch Table Wrapper SimApi can be used to generate a batch node from process data in a system where batch information is otherwise not available. This makes it possible to execute batch projects in SIMCA-online. Batch Table Wrapper can also make batch identifiers unique to SIMCA-online by modifying data from an existing batch node.

  Batch Table Wrapper User Guide       Batch Table Wrapper 2.1.3 (zip password)

CSV File Reader

The Sartorius Stedim Data Analytics CSV SimApi reads the most recent data from text files with comma separated values (CSV).

  CSV User Guide       CSV 2.0.2 (zip password)

PI AF

The Sartorius Stedim Data Analytics PI AF SimApi connects to an OSIsoft PI Server, specifically the PI Data Archive and the PI AF (Asset Framework) Server. 

This SimApi is built by and fully supported by Sartorius Stedim Data Analytics unlike the OSIsoft PI SimApi described in the next section.

  PI AF User Guide       PI AF 2.2.1 zip (zip password)

PI (from OSIsoft)

The OSIsoft PI interface connects to to an OSIsoft PI Server, specifically the PI Data Archive. The interface can connect to both the PI Batch Database and the PI Asset Framework (AF). Read more at the OSIsoft Partner Solutions Showcase.

This interface is offered by OSIsoft who in their terminology refers to it as the PI interface for SIMCA-online or SimBatchOL, with part number PI-IN-SIM-BO-NT.

Download documentation and view the latest technical news at OSIsoft (registration required). The installation kits for the interface must be obtained by contacting OSIsoft.

2017-09-30: OSIsoft will continue supporting this interface but will stop selling it. Customers should instead use the Sartorius Stedim Data Analytics PI AF SimApi (see above).

SIPAT

The Siemens SIPAT SimApi connects to a Siemens SIPAT data source.

This SimApi is provided by Siemens, please contact Siemens for further details.

SynTQ

The Optimal SynTQ SimApi connects to a SynTQ system and permits the extraction of data from a SynTQ database. The SimApi allows historical data to be retrieved for analysis and also allows current data to be obtained from a running orchestration. It is not possible to write data to the SynTQ database.

The SynTQ SimApi is available directly from Optimal. Please contact contact Optimal for further details.

  SynTQ User Guide

Wonderware Historian

The Sartorius Stedim Data Analytics Wonderware Historian SimApi connects to a Wonderware Historian data source.

  Wonderware Historian SimApi User Guide        Wonderware Historian SimApi 2.0.2 (zip password)

 

Feature matrix

A SimApi need not implement all functions in the specification. For this reason, different SimApis offer different functionality. The following table lists all available SimApis and their features. The individual features are explained below the table. Notice that tha table has separate columns to show which features are available in SIMCA-online and Easy Analytics/SIMCA respectively.

Feature

Purpose

SIMCA-online usage

SIMCA usage

Current data

Read the most current value from the data source.

Real-time normal execution

 

Historical data

Read historical data from the data source.

Catch-up and repredict of past data

Database Import Wizard to import process data for model creation.

Discrete data

Read laboratory/IPC data from the data source. Discrete data can be used for batch configurations when data needs to be re-read during the batch evolution. Many observations per batch.

Batch phases configured for discrete data retrieval.

 

Batch data

Read batch conditions and final quality attributes (or other MES type data). One observation per batch.

Batch conditions or local centering.

Database Import Wizard to read batch conditions for batch level model creation.

Batch context node

Read the start time and the end time (empty for active batches) for a specific batch. Enumerate all batches that existed in a time range.

Required for execution of batch configurations.

Database Import Wizard to select batches to import data for.

Write back - continuous data

Write continuous data, such as predictions, back to the data source.

Write back for batch configurations for the batch evolution level or for continuous configurations

 

Write back - discrete

Write discrete data, such as predictions, back to the data source.

Write back for batch configurations at the batch evolution level for phases configured for discrete data retrieval

 

Write back - batch data

Write back batch level data, such as predictions or final quality attributes, to the data source.

Write back for batch configuration for the batch level

 

Node hierarchy

The SimApi supports a hierarchical structure of nodes, similarly to a file system. Each node can contain tags and other nodes. The hierarchy makes is easier to manage a large number of nodes.

Supported in all places where tags are used.

 

Array tag expansion

An array tag stores multiple values. The SimApi expands the array tag to many individual tags, one for each value in the array.

Supported where tags are used for continuous data.

 

Multiple data sources

The SimApi can connect to more than a single data source, or supports multiple instances of itself with individual settings and log files for each instance.

Connect to several different data sources of the same kind. See http://www.umetrics.com/kb/multiple-instances-same-simapi-simca-online-server

 

Connection resiliency

If the SimApi becomes disconnected from the data source, it will try to reestablish the connection on the next call.

The SIMCA-online server doesn't have to be restarted to reestablish connections to the data source.

 

Developed in-house

The SimApi is developed, provided and supported by Sartorius Stedim Data Analytics

   

SimApi usage in SIMCA and SIMCA-online

SIMCA can use a SimApi to retrieve data for project creation and model building as the following picture illustrates.

SIMCA used to obtain data from a data source through a SimApi (click for full size)

SIMCA-online use SimApis to obtain data in real-time for monitoring and control, as well as write back of data to the data source. The following picture shows where the SimApi is located in a system consisting of a data source, SIMCA-online server, and clients.

A SIMCA-online installation with server, SimApi connecting to a data source, and clients (click for full size)

Learn more

The Sartorius Stedim Data Analytics online support team answers technical questions about SimApis, and can also forward requests for enhancement of SimApis to the appropriate people. 

To learn more about the inner workings of SimApis, see the SIMCA-online Technical Guide.

The SimApi specification for developers and a software development kit with sample code can be obtained from The Sartorius Stedim Data Analytics by contacting your sales representative.

Login

For access to downloads you need an account. You will only need to create an account once.