Historian Concepts
Historian Concepts
formerly Wonderware
aveva.com
        © 2022 AVEVA Group plc and its subsidiaries. All rights reserved.
        No part of this documentation shall be reproduced, stored in a retrieval system, or transmitted by any means,
        electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of AVEVA.
        No liability is assumed with respect to the use of the information contained herein.
        Although precaution has been taken in the preparation of this documentation, AVEVA assumes no responsibility
        for errors or omissions. The information in this documentation is subject to change without notice and does not
        represent a commitment on the part of AVEVA. The software described in this documentation is furnished under
        a license agreement. This software may be used or copied only in accordance with the terms of such license
        agreement.
        ArchestrA, Avantis, Citect, DYNSIM, eDNA, EYESIM, InBatch, InduSoft, InStep, IntelaTrac, InTouch, OASyS,
        PIPEPHASE, PRiSM, PRO/II, PROVISION, ROMeo, SIM4ME, SimCentral, SimSci, Skelta, SmartGlance, Spiral
        Software, WindowMaker, WindowViewer, and Wonderware are trademarks of AVEVA and/or its subsidiaries. An
        extensive listing of AVEVA trademarks can be found at: https://sw.aveva.com/legal. All other brands may be
        trademarks of their respective owners.
        Publication date: Thursday, May 12, 2022
        Contact Information
        AVEVA Group plc
        High Cross
        Madingley Road
        Cambridge
        CB3 0HB. UK
        https://sw.aveva.com/
        For information on how to contact sales and customer training, see https://sw.aveva.com/contact.
        For information on how to contact technical support, see https://sw.aveva.com/support.
        To access the AVEVA Knowledge and Support center, visit https://softwaresupport.aveva.com.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                Page 2
Contents
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                                                                           Page 3
Welcome to AVEVA Historian
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                      Page 4
                                                                                           AVEVA™ Historian Concepts Guide
                                                                                                Welcome to AVEVA Historian
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                     Page 5
Process data: About tags and values
        AVEVA Historian acquires and stores process data, which is any information related to successfully running a
        process. That data is stored as tags.
        The term "tag" originally referred to physical label on a mechanical part or device on the plant floor. Each tag
        identifies the corresponding device to AVEVA Historian. As each device sends values to the historian, they are
        recorded by tag.
        For example, a boiler might have two tags – one for the temperature gauge and one for the volume meter.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                     Page 6
                                                                                              AVEVA™ Historian Concepts Guide
                                                                                             Process data: About tags and values
          • Configuration data
            This data describes your system’s configuration and answers questions like "What types of I/O Servers am I
            using?"
        Process data analysis can help improve performance, enhance quality, and reduce costs.
        For more information about defining and using tags, see Defining Tags in the AVEVA Historian Administration
        Guide.
        Value + Time
         Recording each value with a timestamp
         allows you to see trends, pinpoint process
         errors, etc.
         Historian tracks when a record is sent by the
         device and when it is received by Historian.
         This helps to clarify the information if there
         is a data lag, or if values are added or
         updated later.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                        Page 7
                                                                                              AVEVA™ Historian Concepts Guide
                                                                                             Process data: About tags and values
Types of tags
        AVEVA Historian can handle a wide range of data by supporting these tag types:
           • Analog
             Measures a continuous physical quantity, such as a tank’s
             volume or a boiler's temperature.
           • Discrete
             Records one of two states for the tag. For example: on/off,
             open/closed, jam/cleared.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                        Page 8
                                                                                       AVEVA™ Historian Concepts Guide
                                                                                      Process data: About tags and values
           • String
             Captures a text expression--with no special format--that is
             treated as a single data item. A string tag could be used to
             capture the state of a machine; for example: "started",
             "stopped", "jammed", or "cleared".
           • Event
             Records an instance when a tag meets a preset requirement. For
             example, a process event tag can let you know when a batch
             number changes.
           • System
             Reflects a predefined system variable. System tags are used to
             collect the system's performance data. AVEVA Historian system
             tags have a "Sys" prefix (for example, SysTimeSec).
           • Analog summary
             Reflects summarized data (minimum, maximum, average, and so on) that is configured to be
             replicated from one historian to another.
           • State summary
             Reflects summarized data (minimum time in state, maximum time in state, average time in state, and
             so on) that is configured to be replicated from one historian to another, or stored locally.
        You can configure analog, discrete, string, and legacy history event tags through the Operations Control
        Management Console (OCMC). For more information, see Viewing and Configuring Tags in the AVEVA Historian
        Administration Guide.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                 Page 9
Data acquisition: Getting data into
Historian
Sources of data
        Historian can accept data from a number of sources. The most typical scenario is data acquisition from an I/O
        server.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                        Page 10
                                                                                              AVEVA™ Historian Concepts Guide
                                                                                      Data acquisition: Getting data into Historian
        Then the values are sent through the Historian Client Access Layer (HCAL) to a Historian Client Access Point
        (HCAP) on the Historian server, and then to storage. HCAL is a client-side software layer that provides
        programmatic access to storage, retrieval, and system configuration functionality in the AVEVA Historian.
        Historian accepts and historizes each data value according to the storage rules for the tag to which the data value
        belongs.
        For more details, see Configuring Data Acquisition in the AVEVA Historian Administration Guide.
        Other data acquisition options
        As this diagram illustrates, AVEVA Historian can accept data from a range of sources.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                         Page 11
                                                                                             AVEVA™ Historian Concepts Guide
                                                                                     Data acquisition: Getting data into Historian
        In addition to I/O servers, Historian can acquire data from these sources:
          • TransactSQL INSERT and UPDATE statements
            You can insert or update history data in the AVEVA Historian extension tables using Transact-SQL INSERT and
            UPDATE statements.
             For more information, see Importing, Inserting, or Updating History Data in the AVEVA Historian
             Administration Guide.
          • CSV and LGH files
            Using the Historian Data Importer utility (aahImport), you can add history data from a file to AVEVA
            Historian. This utility reads data from InTouch history (LGH) files or comma-separated value (CSV) files, and
            then sends the data to the Historian server via HCAL.
             Imported data is integrated with data currently stored in history blocks, providing you with seamless access
             to all your data.
             For more information, see Importing, Inserting, or Updating History Data in the AVEVA Historian
             Administration Guide.
          • App Server, custom SDK client applications, tier-1 replication, and other sources
            These sources are also able to use HCAL to send data to Historian.
          • AVEVA Historian itself
            Configuration data comes from the Historian itself.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                        Page 12
                                                                                           AVEVA™ Historian Concepts Guide
                                                                                   Data acquisition: Getting data into Historian
Store-and-forward safeguards
        Historian uses a store-and-forward method to protect against data loss if communication is interrupted between
        the data source and Historian.
        Systems using the Data Acquisition Subsystem (IDAS) or Historian Client Access Layer (HCAL) to send data to
        Historian are able to use the store-and-forward method in case of communication breaks. If the data source
        loses communication with Historian, the source stores the collected data until communication is reestablished.
        Then, it forwards the stored data to Historian.
Data categories
        AVEVA Historian is able to process and store data in a variety of ways. It categorizes each data record by type to
        provide a consistent framework for data operations. Each category of data has a separate set of characteristics
        and is handled differently by the historian.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                      Page 13
                                                                                              AVEVA™ Historian Concepts Guide
                                                                                      Data acquisition: Getting data into Historian
          • Revision data, by contrast, is data that corrects or appends original data. Revision data operations are
            performed on a per-tag basis and typically have far lower volumes than original data.
        Streamed versus non-streamed data
        Original data can be streamed or non-streamed.
          • Streamed: If the data source is able to enforce time order for its output, the data is streamed data. Streamed
            data has three subtypes:
               • Real-time data is in time order, where the timestamp is in the past relative to the current AVEVA
                 Historian time.
               • Late data is in time order, where the timestamp is far in the past compared to the current AVEVA
                 Historian time.
               • Replication data is data that has been replicated from a tier-1 historian to a tier-2 historian.
          • Non-streamed: If the time order is not enforced, the data is non-streamed.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                         Page 14
Data storage: Preserving huge amounts of
data over time
Storage modes
        Depending on a tag's definition, Historian uses one of these storage modes to retain the values received for that
        tag:
          • No storage - No values are stored.
          • Forced storage - All collected values are stored.
             For comparison's sake, this is what forced storage looks like. The red dots represent collected values. All of
             these values are stored by Historian.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                     Page 15
                                                                                              AVEVA™ Historian Concepts Guide
                                                                        Data storage: Preserving huge amounts of data over time
          • Cyclic storage - Only values that occur at a specified time interval are stored. Using the same collected values
            as shown above, cyclic storage retains only the values represented by red dots.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                      Page 16
                                                                                          AVEVA™ Historian Concepts Guide
                                                                    Data storage: Preserving huge amounts of data over time
        For more information on delta storage modes, see About Delta Storage Mode in the AVEVA Historian
        Administration Guide.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                  Page 17
                                                                                              AVEVA™ Historian Concepts Guide
                                                                        Data storage: Preserving huge amounts of data over time
Auto-summarization
        For every analog tag in the system, AVEVA Historian creates a local replication entity and a one-hour summary
        tag. As values arrive for an analog tag, Historian automatically computes and records a summary.
        Auto-summary values are stored in their own history blocks within the auto-summary partition.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                      Page 18
                                                                                           AVEVA™ Historian Concepts Guide
                                                                     Data storage: Preserving huge amounts of data over time
        With auto-summarization, Historian can quickly and efficiently retrieve large-volume data for a long duration,
        even months or years.
        Note: The auto-summarization feature is enabled by default, but can be disabled.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                   Page 19
Data retrieval: Transforming data into
information
Retrieval modes
        Historian can acquire and store huge amounts of data and allows you to choose from among several retrieval
        modes to view and interpret the data you need.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                              Page 20
                                                                                    AVEVA™ Historian Concepts Guide
                                                                    Data retrieval: Transforming data into information
         Cyclic
         Retrieves one value per cycle. Whatever the
         value is when the cycle begins.
         Delta
         Retrieves a value each time the value changes
         from the previous value. For example, if the
         value of "4" followed an earlier value of "4", it
         would not be retrieved. But if "4’" followed "3",
         it would.
         Full
         Every value within a time period is retrieved.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                             Page 21
                                                                                    AVEVA™ Historian Concepts Guide
                                                                    Data retrieval: Transforming data into information
         Interpolated
         Based on values before and after a certain point
         in time, Historian estimates the value for that
         time.
         In this example, P2 is located exactly at the
         query start time. Because of this, P2 is returned
         at that time without need for interpolation. At
         the following cycle boundary, point PC1 is
         returned, which is the NULL value represented
         by P7 shifted forward to time TC1. At the last
         cycle boundary, point PC2 is returned, which
         has been interpolated using points P11 and P12.
         Best Fit
         "Best fit" retrieval allows for a compromise
         between delta retrieval and cyclic retrieval.
         Delta retrieval can accurately represent a
         process over a long period of time, but requires
         a large number of data values. Cyclic retrieval is
         much more efficient, but less accurate, because
         of fewer values.
         Best fit provides faster retrieval, like cyclic
         retrieval, plus the better representation, like
         delta retrieval.
         Average
         Uses a time-weighted average algorithm to
         calculate the value for each retrieval cycle.
         For the following data values of a tag that uses
         linear interpolation, the time-weighted average
         is computed as:
         Average = (((P1 + P2) / 2) x (T2 - T1)) + (((P2 +
         P3) / 2) x (T3 - T2)) + (((P3 + P4) / 2) x (T4 - T3)) /
         (T4 - T1)
         Minimum
         Returns the minimum value from the actual
         data values within a retrieval cycle. If there are
         no actual data points stored on the historian for
         a given cycle, nothing is returned. If there are
         NULL values in the cycle, NULL is returned for
         that cycle.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                             Page 22
                                                                                    AVEVA™ Historian Concepts Guide
                                                                    Data retrieval: Transforming data into information
         Maximum
         Similarly, this mode returns the maximum value
         of actual data for the retrieval cycle.
         Integral
         Calculates the values at retrieval cycle
         boundaries by integrating the graph described
         by the points stored for the tag. In other words,
         it works much like average retrieval, but it
         additionally applies a scaling factor. This
         retrieval mode is useful for calculating volume
         for a particular tag (for example, gallons of
         water flowing through a valve over a certain
         period).
         Integral retrieval works with analog tags only.
         For all other tags, normal cyclic results are
         returned.
         Slope
         Returns the slope of a line drawn through a
         given point and the point immediately before it,
         thus expressing the rate at which values change.
         For example, two points P1 and P2 occur at
         times T1 and T2. The slope is calculated as:
         (P2 - P1) / (T2 - T1)
         The difference between T1 and T2 is measured
         in seconds, so the returned value represents the
         change in engineering units per second.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                             Page 23
                                                                                    AVEVA™ Historian Concepts Guide
                                                                    Data retrieval: Transforming data into information
         Counter
         The change in a tag’s value from the beginning
         to the end of the period, factoring in any
         rollover value for the counter. This retrieval
         mode is useful for determining how much of an
         item was produced during a particular time
         period.
         ValueState
         Returns information on how long a tag has been
         in a particular value state during each retrieval
         cycle. That is, a time-in-state calculation is
         applied to the tag value.
         RoundTrip
         Like ValueState retrieval, this mode uses state
         occurrences within a period for its calculations.
         RoundTrip retrieval calculates the time between
         consecutive leading edges of the same state.
         Bound Value
         Retrieves either the start bound point or the
         end bound point for a requested point in time.
         For a start bound point, Historian retrieves the
         first value on or before the requested date/
         time. For an end bound point, Historian
         retrieves the first value after the requested
         date/time.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                             Page 24
                                                                                            AVEVA™ Historian Concepts Guide
                                                                            Data retrieval: Transforming data into information
        The computing power of both the client and the server is exploited by optimizing processor intensive operations
        on the server and minimizing data to be transmitted on the network to improve system performance.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                     Page 25
                                                                                      AVEVA™ Historian Concepts Guide
                                                                      Data retrieval: Transforming data into information
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                               Page 26
Data replication: Delivering information to
people who need it
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                          Page 27
                                                                                                AVEVA™ Historian Concepts Guide
                                                                    Data replication: Delivering information to people who need it
           • Many-to-many                                                • Cloud
             When you want to set up a many-to-many                        When you want data available from the cloud.
             relationship between tiers of historians.
        For more information about setting up and using replication, see Managing and Configuring Replication in the
        AVEVA Historian Administration Guide.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                         Page 28
                                                                                                   AVEVA™ Historian Concepts Guide
                                                                       Data replication: Delivering information to people who need it
Replication tiers
        When you replicate data, it creates a tiered relationship between the historians.
         That is, the tier-1 historian send its replicated data to a
         tier-2 historian.
         AVEVA Historian can replicate process data as well as
         alarms and events.
        Historian supports multi-tier replication. Data originating at tier 1 can be replicated to tier 2, then again to tier 3,
        and so on.
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                            Page 29
                                                                                                 AVEVA™ Historian Concepts Guide
                                                                     Data replication: Delivering information to people who need it
        The following tables show how the replicated data is named as it is replicated in these two scenarios. These
        examples are based on the default naming scheme.
        TagC replicated across 4 tiers (Hist1, Hist2, Hist3, Insight)
         Tier           Computer name                                         Tag name                    Summary tag name
        Note: Summary replication happens between tier 1 and tier 2 only. All data replication to tier 3 and beyond is
        simple replication.
        TagD replicated from Hist1 to Insight
         Tier           Computer name                                          Tag name                    Summary tag name
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved.                                                          Page 30
                                                                                                AVEVA™ Historian Concepts Guide
                                                                    Data replication: Delivering information to people who need it
        Note: Before version 17.3.100, replication to AVEVA Insight used the same default naming as any other tier 2 and
        still included the "DS" prefix (where "DS" is the name of the data source). For example, consider how "TagC" was
        replicated to Insight before and since version 17.3.100:
        - Before 17.3.100: TagC was replicate to Insight as "DS.Hist1.TagC".
        - Since 17.3.100: TagC is replicated to Insight as "DS.TagC".
© 2022 AVEVA Group plc and its subsidiaries. All rights reserved. Page 31