historicalStatusData

The result value of readData, readDataOnTime, readStatusLog, readStatusLogOnTime returns the history information of status points according to that search information. History information is returned as a historicalAnalogData object.

The information contains various information.

Normal / Abnormal data
The moment value
On-state time
Off-state time
On count
Off count
History storage time

readData, readDataOnTime are the collection period stored on history data groups. readStatusLog, readStatusLogOnTime are type.

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.
int	onDuration()	Read the On-state time of the obtained history information period.
int	offDuration()	Read the Off-state time of the obtained history information period.
int	onCount()	Read the On count of the obtained history information period.
int	offCount()	Read the Off count of the obtained history information period.
datetime	time()	Read the storage time of the obtained history informatioin period.

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 = logStatus.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 = logStatus.readData('History data group1', 'Station1.Power', st, et )

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

int onDuration()

onDuration() returns the On-state time of that period of history information.

ㆍ The return value is the number computed in seconds.

Example)

data_list = logStatus.readData('History data group1', 'Station1.Power', st, et )

RT = data_list[0].onDuration() << RT saves the On-state time of the first search period of Station1.Power.

tm = datetime.datetime.fromtimestamp( RT ); << It is able to convert the number of seconds into Python date format.

int offDuration()

offDuration returns the Off-state of that period of history information.

ㆍ The return value is the number computed in seconds

Example)

data = logStatus.readDataOnTime('History data group1', 'Station1.Power', time )

RT = data.offDuration() << RT saves the Off-state time of the first search time of Station1.Power.

tm = datetime.datetime.fromtimestamp( RT ); << It is able to convert the number of seconds into Python date format.

int onCount()

onCount() returns the On count of that period of history information.

Example)

data = logStatus.readDataOnTime('History data group1', 'Station1.Power', time )

RT = data.onCount() << RT saves the On count of Station1.Power.

int offCount()

offCount() returns the off count of that period of history information.

Example)

data = logStatus.readDataOnTime('History data group1', 'Station1.Power', time )

RT = data.offCount() << RT saves the off count of Station1.Power.

datetime time()

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

※ Refer Python script datetime object usage.

Example)

data_list = logStatus.readData('History data group1', 'Station1.Power', st, et )

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