StationData는 스테이션에 대한 정보를 포함하는 데이터 입니다. 사용자는 StationData를 이용하여 다음과 같은 작업을 수행할 수 있습니다.
• 스테이션 이름, 설명 등 기본 정보를 조회할 수 있습니다.
• 스테이션에 속한 포인트 목록 및 각 포인트 값을 조회할 수 있습니다.
• 스테이션이 계층구조로 되어 있는 경우 현재 스테이션의 하위(자식) 스테이션 정보를 조회할 수 있습니다.
StationData를 얻기 위해서는, scada.getStation 함수를 호출해서 얻어 올수 있으며, 이때 함수의 인자로 조회하려는 스테이션 이름을 지정할 수 있습니다. 스테이션 이름을 지정하지 않은 경우, 최상위 스테이션 정보를 반환합니다.
Methods
analogData getAnalogData
( pointName : 포인트 이름)
|
스테이션에 속한 지정된 아날로그 포인트 데이터를 읽어 옵니다. 아래 예시는 해당 스테이션 구조에서 풍향 포인트 데이터를 읽어 오는 방법을 보여줍니다.
예)
# 읽어올 포인트가 포함된 스테이션을 얻습니다.
station = scada.getStation('제주.신제주')
# 제주/신제주 스테이션에 속한 '풍향' 포인트 데이터를 읽습니다.
data = station.getAnalogData('풍향')
|
|
list<str> getAnalogPointNameList
()
|
스테이션에 속한 아날로그 포인트 이름 목록을 조회합니다. 아래 예제에서는 그림과 같은 스테이션 구조에서 '강원.속초.척산간 7' 스테이션에 속한 아날로그 포인트 목록을 읽어오는 방법을 보여줍니다.
예)
# 스테이션을 얻어 옵니다
station = scada.getStation('강원.속초.척산간 7')
# 제주/신제주 스테이션에 속한 '풍향' 포인트를 읽습니다.
lst = station.getAnalogPointNameList( )
for name in lst:
print name
|
결과)
풍속
풍향
풍향이벤트
풍속이벤트
최대풍속
평균풍속
최대/평균 풍속 기준값
|
|
list<StationData> getChildren
()
|
현재 스테이션의 하위 스테이션을 조회 합니다. 아래 예제에서는 '강원.속초' 스테이션에 속한 하위 스테이션을 조회 하는 방법 보여 줍니다.
예)
# 스테이션을 얻어 옵니다
parent = scada.getStation('강원.속초')
# 강원.속초 스테이션의 하위 스테이션을 불러옵니다.
subStations = parent.getChildren( )
for station in subStations:
print station.getStationName()
|
결과)
척산간 7
척산간 158
도문지 49
통일간 185
통일간 403
고성간 445
외옹간 85
토성간 285
노학간 SW11R38
토성간 172
노학간73R1
도문지21R129
원암지2
|
|
int getChildCount
()
|
현재 스테이션의 하위 스테이션 갯수를 반환 합니다. 아래 예제에서는 '강원.속초' 스테이션에 속한 하위 스테이션을 갯수를 읽는 방법을 보여 줍니다.
예)
# 스테이션을 얻어 옵니다
parent = scada.getStation('강원.속초')
# 강원.속초 스테이션의 하위 스테이션 갯수를 읽습니다
print parent.getChildCount( )
|
결과)
|
StationData getChildStation (stationName : 하위 스테이션 이름)
|
현재 스테이션에서 지정한 이름의 하위 스테이션을 불러 옵니다.
예)
# 스테이션을 얻어 옵니다
parent = scada.getStation('강원.속초')
# 강원.속초 스테이션 하위의 도문지 49 스테이션을 읽습니다.
domun = parent.getChildStation( '도문지 49')
print domun.getStationName() , domun.getDescription()
|
결과)
|
StationData getChildStation
(index : 하위 스테이션 인덱스)
|
현재 스테이션에서 지정한 인덱스 번호로 하위 스테이션을 불러 옵니다.
예)
# 스테이션을 얻어 옵니다
parent = scada.getStation('강원.속초')
# 강원.속초 스테이션의 하위 스테이션 갯수를 가져옵니다
count = parent.getChildCount( )
for index in range(0,count) :
station = parent.getChildStation(index)
print station.getStationName()
|
결과)
척산간 7
척산간 158
도문지 49
통일간 185
통일간 403
고성간 445
외옹간 85
토성간 285
노학간 SW11R38
토성간 172
노학간73R1
도문지21R129
원암지2
|
|
str getDescription
()
|
스테이션 설명을 읽습니다.
예)
# 스테이션을 얻어 옵니다
station = scada.getStation('강원.속초')
# 강원.속초 스테이션의 설명을 읽습니다
print station.getDescription( )
|
|
str getPathName
()
|
스테이션의 상위 스테이션을 포함한 전체 경로 이름을 불러 옵니다.
예)
# 스테이션을 얻어 옵니다
station = scada.getStation('강원.속초.척산간 7')
# 강원.속초 스테이션의 하위 스테이션 갯수를 읽습니다
print station.getPathName( )
|
결과)
|
list<str> getPointNameList
()
|
스테이션에 속한 전체 포인트 이름 목록을 조회합니다.
예)
# 스테이션을 얻어 옵니다
station = scada.getStation('강원.속초.척산간 7')
# 강원.속초.척산간 7 스테이션에 속한 포인트 이름을 얻어 옵니다
lst = station.getPointNameList( )
for name in lst:
print name
|
결과)
|
str getStationName
()
|
해당 스테이션의 이름을 반환 합니다.
※스테이션 전체 이름을 읽기 위해서는 getPathName( )을 호출합니다.
예)
# 스테이션을 얻어 옵니다
station = scada.getStation('강원.속초.척산간 7')
# 강원.속초 스테이션의 하위 스테이션 갯수를 읽습니다
print station.getStationName( )
|
결과)
|
statusData getStatusData
( pointName : 포인트 이름)
|
스테이션에 속한 지정된 상태 포인트 데이터를 읽어 옵니다.
예)
# 읽어올 포인트가 포함된 스테이션을 얻습니다.
station = scada.getStation('제주.신제주')
# 제주/신제주 스테이션에 속한 '통신 상태' 포인트 데이터를 읽습니다.
data = station.getStatusData('통신 상태')
|
|
list<str> getStatusPointNameList
()
|
스테이션에 속한 상태 포인트 이름을 조회합니다.
예)
# 스테이션을 얻어 옵니다
station = scada.getStation('강원.속초.척산간 7')
# 제주/신제주 스테이션에 속한 '풍향' 포인트를 읽습니다.
lst = station.getStatusPointNameList( )
for name in lst:
print name
|
결과)
|
variant getValue
(pointName:포인트 이름)
|
스테이션에 속한 지정된 포인트의 값를 읽어 옵니다.
예)
# 스테이션을 얻어 옵니다
station = scada.getStation('강원.속초.척산간 7')
# 강원.속초.척산간 7 스테이션에 속한 포인트 이름을 얻어 옵니다
lst = station.getPointNameList( )
for name in lst:
print name , ':', station.getValue(name)
|
결과)
Cold Restart : 0
풍속 : 0.0
풍향 : 0.0
풍향이벤트 : 0.0
풍속이벤트 : 0.0
최대풍속 : 0.0
평균풍속 : 0.0
최대/평균 풍속 기준값 : 0.0
|
|