PIPoint.PlotValues Method
- Last UpdatedNov 18, 2025
- 3 minute read
- PI System
- AF SDK 2024 R2
- Developer
Retrieves values over the specified time range suitable for plotting over the number of intervals (typically represents pixels).
Namespace: OSIsoft.AF.PI
Assembly: OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182
Syntax
public AFValues PlotValues( AFTimeRange timeRange, int intervals )
Public Function PlotValues ( timeRange As AFTimeRange, intervals As Integer ) As AFValues Dim instance As PIPoint Dim timeRange As AFTimeRange Dim intervals As Integer Dim returnValue As AFValues returnValue = instance.PlotValues(timeRange, intervals)
public: AFValues^ PlotValues( AFTimeRange timeRange, int intervals )
member PlotValues : timeRange : AFTimeRange * intervals : int -> AFValues
Parameters
- timeRange
- Type: OSIsoft.AF.TimeAFTimeRange
The bounding time range for the plot values request. - intervals
- Type: SystemInt32
The number of intervals to plot over. Typically, this would be the number of horizontal pixels in the trend.
Return Value
Type: AFValuesReturns an AFValues collection with values that will produce the most accurate plot over the time range while minimizing the amount of data returned.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The intervals must be greater than zero. |
| PIException | Error returned by the PI Data Archive. |
Remarks
For each interval, the data available is examined and significant values are returned. Each interval can produce up to 5 values if they are unique, the first value in the interval, the last value, the highest value, the lowest value and at most one exceptional point (bad status or digital state).
| The PI Data Archive imposes a limit on the maximum number of events that can be returned with a single call. As of PI 3.4.380, the default is set at 1.5M. This behavior can be changed on the server by editing the server's PITimeout table and adding or editing the value associated with the parameter ArcMaxCollect. |
| This method, property, or class is not available in the legacy .NET 3.5 version of the SDK. |