InterpolatedValues Method (PIData object)

                    

 

The method returns interpolated values from the archive over the specified time range as a PIValues collection. This method differs from IPIData2.InterpolatedValues2 only in how the sampling intervals are specified. In InterpolatedValues, the caller specifies number of intervals and the PISDK computes the interval length based on start time, end time and the number of intervals. The interval length is constant throughout the period. In IPIData2.InterpolatedValues2, the caller specifies the interval length as a variant in the SampleInterval argument. The interval length could change within the requested time period.

Syntax

object.InterpolatedValues StartTime, EndTime, nValues, [FilterExp], [ShowFiltered], [AsynchStatus]

The InterpolatedValues method syntax has these parts:

Part Description
object An object expression that evaluates to a PIData object.
StartTime A Variant containing the desired start time. See the Settings section for allowable values.
EndTime A Variant containing the desired end time. See the Settings section for allowable values. When the specified StartTime is earlier than the EndTime, the resulting PIValues collection will be indexed in time ascending direction. If the StartTime is more recent than the EndTime, the resulting PIValues collection will be indexed in time descending direction.
nValues Number of values to return - granularity of interpolation.
FilterExp A string containing a filter expression [Optional]
ShowFiltered An value from the FilteredViewConstants enumeration that controls whether filtered events are returned with a filter status or not shown at all. [Optional] See the Settings section for allowable values. 
AsyncStatus A PIAsynchStatus object for launching an asynchronous call, determining the progress of, or cancelling a lengthy call. [Optional]

Settings

The possible values in the variant for StartTime and EndTime are:


 

The possible values for ShowFiltered are:


Remarks

 

Trappable Errors

In addition to generic errors (such as Out of Memory), the following errors may occur:

Error Description
E_INVALIDARG Some of the function argument are not valid.
E_NOTIMPL This combination of the function arguments is not implemented at current PISDK version or not supported by this version of the PI Server.
PISDK_E_ERRCONVINPUT Problem converting input arguments to PI Server calling arguments.
E_ACCESSDENIED No read access to PI Server
PISDK_E_DATENOTONLINE Archive not online for specified time range
PISDK_E_EVENTSRETRIEVE Other calculation error from the PI Server
PISDK_E_ERRCONVOUTPUT Error converting PI Server result to PISDK result format
Enabling Operational Intelligence