historicalAnalogData



 The value using readData, readDataOnTime, readAnalogLog return the history information of analog points based on specified search information.

The return value contains various information.


    • Normal / Abnormal data
    • The moment value
    • The maximum value
    • The minimum value
    • The average value
    • The cumulative value
    • The variation
    • The time of the maximum value
    • The time of the minimum value
    • Storage period



Methods




Return Type

Method

Description

  boolean

isGood()

Read whether the obtained history information is normal or abnormal.

  float

curValue()

Read the moment value of the obtained history information period.

  float

maxValue()

Read the maximum value of the obtained history information period.

  float

minValue()

Read the minimum value of the obtained history information period.

  float

deltaValue()

Read the variation of the obtained history information period.

  float

avgValue()

Read the average value of the obtained history information period.

  float

accValue()

Read the cumulative value of the obtained history information period.

  datetime

minTime()

Read the time of the minimum value of the obtained history information period.

  datetime

maxTime()

Read the time of the maximum value of the obtained history information period.

  datetime

time()

Read the storage period of the obtained history information.


  boolean isGood()

 

  isGood() can decide whether the history information is normal or abnormal.


        ㆍIf it returns TRUE, it is normal data.

        ㆍIf it returns FALSE, it is abnormal data.



  Example)

   


       data_list = logAnalog.readData('History data group1', 'Station1.Temperature', st, et )

       RT = data_list[0].isGood() << RT saves Whether the data is normal or abnormal.


   



  float curValue()

 

  curValue() returns the moment value of that period of history information.



  Example)

   


       data_list = logAnalog.readData('History data group1', 'Station1.Temperature', st, et )

       RT = data_list[0].curVal() << RT saves the moment value of the first search period of Station1.Temperature.


   



  float maxValue()

 

  maxValue() returns the maximum value of that period of history information.



  Example)

   


       data = logAnalog.readDataOntime('History data group1', 'Station1.Voltage', time )

       RT = data.maxValue() << RT saves the maximum value of Station1.Voltage.



  float minValue()

 

  minValue() returns the minimum value of that period of history information



  Example)

   


       data = logAnalog.readDataOntime('History data group1', 'Station1.Voltage', time )

       RT = data.minValue() << RT saves the minimum value of Station1.Voltage.



  float deltaValue()

 

  deltaValue() returns the variation of that period of history information.



  Example)

   


       data_list = logAnalog.readData('History data group1', 'Station1.Temperature', st, et )

       RT = data_list[3].deltaValue() << RT saves the 4th variation of Station1.Temperature.



  float avgValue()

 

  avgValue() returns the average value of that period of history information.



  Example)

   


       data_list = logAnalog.readData('History data group1', 'Station1.Temperature', st, et )

       RT = data_list[0].avgValue() << RT saves the average value of the first period of Station1.Temperature.



  float accValue()

 

  accValue() returns the cumulative value of that period of history information.



  Example)

   


       data_list = logAnalog.readData('History data group1', 'Station1.Voltage', st, et )

       RT = data_list[0].accValue() << RT saves the cumulative value of the first period of Station1.Voltage.



  datetime minTime()

 

  minTime() returns the time of the minimum value of historical information. The return type is the Python datetime format.


  ※ Refer Python script datetime object usage.



  Example)

   


       data_list = logAnalog.readData('History data group1', 'Station1.Temperature', st, et )

       RT = data_list[0].minTime() << RT saves the time of the minimum value of history information as Python datetime format.



  datetime maxTime()

 

  maxTime() returns the time of the maximum value of historical information. The return type is the Python datetime format.


  ※ Refer Python script datetime object usage.



  Example)

   


       data_list = logAnalog.readData('History data group1', 'Station1.Temperature', st, et )

       RT = data_list[0].maxTime() << RT saves the time of the maximum value of history information as Python datetime format.



  datetime time()

 

  time() returns the storage time of that period of history information.


  ※ Refer Python script datetime object usage.



  Example)

   


       data_list = logAnalog.readData('History data group1', 'Station1.Temperature', st, et )

       RT = data_list[5].time() << RT saves the 6th storage time of Station1.Temperature as Python datetime format.