(그림 3-1-1) CLIK 플랫폼 메뉴 구성

기후서비스 CLIK 플랫폼(https://cliks.apcc21.org)의 메뉴는 위 그림과 같이 Home, Dataset, Processing, CLIK API, Manual, Help Desk, Member로 구성됩니다.

가. Home

Homepage 메뉴에서 왼쪽 위에 있으며, 어느 화면에서든 Home 버튼을 누르게 되면 초기 페이지로 이동하게 됩니다.

나. Dataset

CLIK은 APCC 계절예측 자료인 다중모델 앙상블(Multi-Model Ensemble, MME), 개별모델 자료, 여름철 계절내 진동(BSISO, Boreal Summer Intraseasonal Oscillation) 지수의 감시 및 예측정보, 그리고 대기해양접합 대순환모델 상호비교 프로젝트(Coupled Model Intercomparison Project Phase 5, CMIP5) 자료 일부를 지역별로 나누어 제공하고 있습니다. 각 Dataset은 Overview와 Download로 나누어져 있습니다. Overview에서는 자료에 대하여 설명하고 Download에서는 사용자가 원하는 자료를 선택하여 요청할 수 있습니다.

다. Processing

Processing 메뉴는 사용자 맞춤형 계절예측 및 검증 서비스와 Clipping, Composite 등의 자료처리 서비스로 구성되어 있습니다.

라. CLIK 플랫폼 API

사용자가 공개 응용프로그래밍 인터페이스(Open API) 서비스를 이용하여 프로그램에 자료 다운로드 코드를 삽입하는 방법에 대하여 설명하고 활용 가능한 예제를 제공합니다.

마. Manual

기후서비스 CLIK 플랫폼을 설명하는 매뉴얼을 한글/영어 두 가지 언어로 제공합니다.

바. Dataset

APCC 온라인 고객 지원 서비스로 이동할 수 있는 링크가 제공됩니다. 자세한 사항은 문의 방법을 참고하시기 바랍니다.

가. MME-3MON  Link

MME-3MON 메뉴는 3개월 계절예측 MME 자료를 제공합니다. 자료에 대한 상세한 설명은 Overview 페이지를 참고하여 주시기 바랍니다.

(그림 3-2-1) MME Dataset 페이지

사용자는 Download 탭에서 다음과 같은 방법으로 자료를 요청할 수 있습니다.

- Type: 자료 타입 선택

(그림 3-2-2) 자료 타입 선택

- Method: MME 예측 방법 선택
      > SCM (Simple Composite Method): 결정론적 MME (DMME)
      > GAUS (Gaussian Fitting Method): 확률론적 MME (PMME)

(그림 3-2-3) MME 예측 방법 선택

- Variables: 변수 선택(변수의 상세 내용은 Overview 탭 참고)

(그림 3-2-4) MME 변수 선택

- Period: 자료 평균 기간 선택 (Seasonal mean은 Monthly mean의 평균)

(그림 3-2-5) MME 평균 기간 선택

- Date: 다운로드할 자료의 기간 선택 (테이블에서 연도, 시즌을 선택하면 전체 년, 시즌을 한번에 선택 가능)
      > FORECAST의 "Download last season" 버튼: 선택한 Method의 마지막 시즌 전체 자료 다운로드
      > HINDCAST의 "Download last season" 버튼: 선택한 Method의 마지막 시즌 전체 자료 다운로드

(그림 3-2-6) 대상 자료 기간 선택

- "Request" 또는 "Create script" 버튼 선택

(그림 3-2-7) 자료 요청

위의 그림에서 “Request” 버튼을 선택하면 자료 다운로드를 위한 Job이 등록됩니다. 사용자가 로그인하지 않았을 경우 아래의 그림과 같이 “Request” 버튼은 비활성화됩니다.

(그림 3-2-8) 로그인하지 않았을 때 Request 버튼

”Create script“ 버튼은 사용자의 로컬 서버나 컴퓨터에서 wget 명령을 이용하여 자료를 직접 내려받을 수 있는 스크립트를 전송하여 스크립트(리눅스 시스템 기준) 파일이 즉시 다운로드 됩니다.

(그림 3-2-9) wget을 이용한 다운로드 스크립트

- certificate_option:

https 통신에 사용되는 인증서를 사용자의 서버나 컴퓨터에서 검증하지 않을 때 ”--no-check-certificate“를 설정하여 줍니다.

- ”-O“ 옵션:

실제로 저장할 파일의 위치 및 파일명을 지정할 수 있습니다.

다운로드할 자료의 URL은 아래의 표와 같이 구성됩니다. 표에서 대괄호(”[ ]“) 안의 값은 아래의 선택 값을 참고합니다.

- Type: 자료 타입 선택
      > Lead Month: 3-MON (6개월 예측자료는 6-MON)
      > Month: JAN, FEB와 같은 각 월의 약자
      > Season: Date 테이블 상단의 JFM(Jan Feb Mar), FMA(Feb Mar Apr) 등과 같은 계절을 나타내는 값

[표 1] MME 다운로드 URL

Period	URL
Monthly Mean	https://download.apcc21.org/MME/ [Lead Month] / [Type] / [Method] / [Month] / [Year] / [Variable].nc
Seasonal Mean	https://download.apcc21.org/MME/ [Lead Month] / [Type] / [Method] / [Month] / [Season] / [Year] / [Variable].nc

※ 개별모델 및 다중모델앙상블(MME) 자료를 사용하여 연구를 수행하시는 경우 보고서 및 논문에 들어갈 감사 문구를 다음과 같이 요청합니다. “연구에 사용된 다중모델 앙상블 자료는 APCC MME Producing Centres (PCs)에 의해 생산된 hindcast/forecast 자료를 바탕으로 APCC가 수집, 재가공하였으며 자료를 생산/제공해주신 APEC 기후센터에 감사드립니다.”

나. MME-6MON  Link

MME-6MON 메뉴는 6개월 계절예측 MME 자료를 제공합니다. 6개월 MME 예보 다운로드 방법은 3개월 예보와 같습니다.

다. MME-MODEL  Link

MME-MODEL 메뉴는 MME 개별모델 자료를 제공합니다. 자료에 대한 설명은 Overview 페이지를 참고하시면 됩니다. 사용자는 다음과 같이 Download 탭에서 다운로드를 요청할 수 있습니다.

- Type: 자료 타입 선택

(그림 3-2-10) 자료 타입 선택

- Year: 자료 타입이 HINDCAST일 경우 자료 생산년도 선택

(그림 3-2-11) HINDCAST 생산년도 선택

- Institute: 모델 제공 기관 선택

(그림 3-2-12) HINDCAST 생산년도 선택

- Model: 기후모델 이름 선택

(그림 3-2-13) MME 참여 모델 선택

- Variables: 변수 선택(변수의 상세 내용은 Overview 탭 참고)

(그림 3-2-14) 변수 선택

- Date: 다운로드할 자료의 기간 선택(테이블의 연도, 월을 선택하면 전체 년, 월을 한번에 선택 가능)

(그림 3-2-15) 다운로드 기간 선택

- “Request” 또는 “Create script” 버튼 선택

(그림 3-2-16) 자료 요청

“Request“ 버튼을 선택하면 자료 다운로드를 위한 Job이 등록됩니다. 사용자가 로그인하지 않았을 경우 아래 그림과 같이 “Request” 버튼은 비활성화됩니다.

(그림 3-2-17) 로그인하지 않았을때 Request 버튼

”Create script“ 버튼은 사용자의 로컬 서버나 컴퓨터에서 wget 명령을 이용하여 자료를 직접 내려받을 수 있는 스크립트(리눅스 시스템 기준) 파일이 즉시 다운로드 됩니다.

(그림 3-2-18) wget을 이용한 모델 자료 다운로드 스크립트

스크립트를 이용하여 자료를 내려받기 위해서 사용자는 스크립트를 자신의 환경에 맞게 수정할 필요가 있습니다.

- userid, password: 자신의 아이디, 비밀번호를 입력합니다.
- cookie_option: 웹 사이트의 쿠키 저장을 원하지 않으면 cookie_option의 내용을 비우면 됩니다. 쿠키를 저장하지 않으면 자료 파일을 다운로드할 때마다 사용자 인증을 거치게 되어 자료 전송이 지연될 수 있습니다.
- certificate_option: https 통신에 사용되는 인증서를 사용자의 서버나 컴퓨터에서 검증하지 않을 때 ”--no-check-certificate“를 설정합니다.
- ”-O“ 옵션: 실제로 저장할 파일의 위치 및 파일명을 지정할 수 있습니다.

다운로드할 자료의 URL은 아래의 표와 같이 구성됩니다. 표에서 대괄호(”[ ]“) 안의 값은 아래의 선택 값을 참고합니다.
      > Lead Month: 3-MON (6개월 예측자료는 6-MON)

[표 2] MME 모델의 다운로드 URL

	URL
FORECAST	https://sdownload.apcc21.org/MODEL/FORECAST/ [Institute]_[Model] / [Month] / [Year] / [Variable].nc
HINDCAST	https://sdownload.apcc21.org/MODEL/ HINDCAST[Hindcast Year] / [Institute]_[Model] / [Month] / [Year] / [Variable].nc

※ 개별모델 및 다중모델앙상블(MME) 자료를 사용하여 연구를 수행하시는 경우 보고서 및 논문에 들어갈 감사 문구를 다음과 같이 요청합니다. “연구에 사용된 다중모델 앙상블 자료는 APCC MME Producing Centres (PCs)에 의해 생산된 hindcast/forecast 자료를 바탕으로 APCC가 수집, 재가공하였으며 자료를 생산/제공해주신 APEC 기후센터에 감사드립니다.”

라. High Resolution MME  Link

고해상도 MME 자료는 일반 저해상도 MME 자료와는 달리 홈페이지에서 다운로드 서비스를 제공하지 않고 wget 다운로드 서비스만 제공합니다. 아래 그림의 Download 페이지에서는 wget을 이용하여 자료를 다운로드하는 방법을 설명하고 다운로드 명령 샘플도 제공하고 있습니다.

(그림 3-2-19) 고해상도 MME 다운로드

사용자는 다음 그림과 같이 다운로드 할 MME 자료의 선택 옵션들을 선택하여 wget 명령을 이용하여 자료를 다운로드 할 수 있습니다.

(그림 3-2-20) 고해상도 MME 다운로드 - MME

각 선택 사항은 일반 저해상도 MME와 유사합니다. 다운로드할 자료의 URL은 아래의 표와 같이 구성됩니다. 표에서 대괄호(”[ ]“) 안의 값은 아래의 선택 값을 참고합니다.
-Lead Month: 3-MON (6개월 예측자료는 6-MON)
-Month: JAN, FEB와 같은 각 월의 약자
-Season: Date 테이블 상단의 JFM(Jan Feb Mar), FMA(Feb Mar Apr) 등과 같은 계절을 나타내는 값

[표 3] 고해상도 MME 다운로드 URL

	URL
FORECAST	https://download.apcc21.org/MME-HRES/ [Lead Month] / [Type] / [Method] / [Month] / [Year] / [Variable].nc
HINDCAST	https://download.apcc21.org/MME-HRES/ [Lead Month] / [Type] / [Method] / [Month] / [Season] / [Year] / [Variable].nc

※ 개별모델 및 다중모델앙상블(MME) 자료를 사용하여 연구를 수행하시는 경우 보고서 및 논문에 들어갈 감사 문구를 다음과 같이 요청합니다. “연구에 사용된 다중모델 앙상블 자료는 APCC MME Producing Centres (PCs)에 의해 생산된 hindcast/forecast 자료를 바탕으로 APCC가 수집, 재가공하였으며 자료를 생산/제공해주신 APEC 기후센터에 감사드립니다.”

(그림 3-2-21) 고해상도 MME 다운로드 – MME Model

Model 자료 또한 위의 그림과 아래의 표와 같이 옵션을 선택하여 자료를 다운로드 할수 있습니다. wget 과 같은 명령어를 사용할 때 저해상도 MME Model 자료 다운로드와 같이 사용자 아이디와 비밀번호를 입력해야 합니다.

[표 4] 고해상도 MME 모델의 다운로드 URL

	URL
FORECAST	https://sdownload.apcc21.org/MODEL-HRES/FORECAST/ [Institute]_[Model] / [Month] / [Year] / [Variable].nc
HINDCAST	https://sdownload.apcc21.org/MODEL-HRES/ HINDCAST[Hindcast Year] / [Institute]_[Model] / [Month] / [Year] / [Variable].nc

다운로드할 자료의 URL은 위의 표와 같이 구성됩니다. 표에서 대괄호(”[ ]“) 안의 값은 아래의 선택 값을 참고합니다.
-Month: JAN, FEB와 같은 각 월의 약자

※ 개별모델 및 다중모델앙상블(MME) 자료를 사용하여 연구를 수행하시는 경우 보고서 및 논문에 들어갈 감사 문구를 다음과 같이 요청합니다. “연구에 사용된 다중모델 앙상블 자료는 APCC MME Producing Centres (PCs)에 의해 생산된 hindcast/forecast 자료를 바탕으로 APCC가 수집, 재가공하였으며 자료를 생산/제공해주신 APEC 기후센터에 감사드립니다.”

마. BSISO  Link

APCC 계절내 예측 BSISO 자료는 5~10월 사이에 생산되며 일부 자료는 매일 업데이트됩니다. BSISO 자료는 예측정보(FORECAST), 감시정보(MONITORING)로 나뉘어 제공됩니다. 사용자는 Download 탭에서 다음과 같은 방법으로 자료 종류, 기관, Model 등의 속성을 선택하여 예측자료 다운로드를 요청할 수 있습니다.

- Type: 자료 타입 선택

(그림 3-2-22) 자료 타입 선택

- Institute: 자료 제공 기관 선택(FORECAST)

(그림 3-2-23) 자료 제공 기관 선택

- Model: 모델 선택(FORECAST)

(그림 3-2-24) 모델 선택

- Date: 다운로드 기간(연도, 월) 선택(FORECAST)

(그림 3-2-25) 다운로드 기간 선택

- 다운로드 파일 선택
      > FORECAST의 “All” 체크박스 선택: 목록의 모든 파일 선택
      > 파일명 선택: 해당 파일 즉시 다운로드
      > FORECAST의 “Download historical data” 버튼: 선택한 모델의 전체 FORECAST 자료(zip 압축) 즉시 다운로드
      > 감시(MONITORING) 자료는 하나의 파일이 1년간의 자료를 포함합니다.
      > MONITORING의 “Download all data” 버튼: 전체 MONITORING 자료 즉시 다운로드

(그림 3-2-26) 다운로드 파일 선택

- “Request” 또는 “Create script” 버튼 선택

(그림 3-2-27) 자료 요청

“Request“ 버튼을 선택하면 자료 다운로드를 위한 Job이 등록됩니다. 사용자가 로그인하지 않았을 경우 아래 그림과 같이 “Request” 버튼은 비활성화됩니다.

(그림 3-2-28) 로그인하지 않았을때 Request 버튼

”Create script“ 버튼은 사용자의 로컬 서버나 컴퓨터에서 wget 명령을 이용하여 자료를 직접 내려받을 수 있는 스크립트(리눅스 시스템 기준) 파일이 즉시 다운로드 됩니다.

(그림 3-2-29) wget을 이용한 BSISO 자료 다운로드 스크립트

바. CMIP5  Link

CMIP5 페이지에서는 지역별로 잘린 CMIP5 자료를 선택하여 다음과 같이 요청할 수 있습니다. 각 지역의 CODE를 마우스로 가리키면 해당 지역의 경위도 값을 확인할 수 있습니다. 제공하는 국가의 범위가 방대하여 주 단위로 나누어 제공되는 국가는 다음과 같습니다.

[내려받을 국가 혹은 주 선택]
- 미국
- 러시아
- 중국
- 캐나다

(그림 3-2-30) CMIP5 자료 국가 목록

- “Request” 또는 “Create script” 버튼 선택

(그림 3-2-31) 자료 요청

“Request“ 버튼을 선택하면 자료 다운로드를 위한 Job이 등록됩니다. 사용자가 로그인하지 않았을 경우 아래 그림과 같이 “Request” 버튼은 비활성화됩니다.

(그림 3-2-32) 로그인하지 않았을때 Request 버튼

”Create script“ 버튼은 사용자의 로컬 서버나 컴퓨터에서 wget 명령을 이용하여 자료를 직접 내려받을 수 있는 스크립트를 전송하여 스크립트(리눅스 시스템 기준) 파일이 즉시 다운로드 됩니다.

CMIP5 자료는 사용자 인증 없이 다운로드 가능하므로 사용자 설정, 쿠키 설정이 필요하지 않습니다. 자료의 다운로드 URL은 다음 표와 같이 구성됩니다. 표에서 대괄호(”[ ]“) 안의 값은 CMIP5 자료 국가 목록의 CODE 값입니다.

[표 5] CMIP5 다운로드 URL

URL
https://download.apcc21.org/CMIP5/cmip5_daily_[CODE].zip

※ 개별모델 및 다중모델앙상블(MME) 자료를 사용하여 연구를 수행하시는 경우 보고서 및 논문에 들어갈 감사 문구를 다음과 같이 요청합니다. “연구에 사용된 다중모델 앙상블 자료는 APCC MME Producing Centres (PCs)에 의해 생산된 hindcast/forecast 자료를 바탕으로 APCC가 수집, 재가공하였으며 자료를 생산/제공해주신 APEC 기후센터에 감사드립니다.”

사. ERA5  Link

ERA5 페이지는 유럽중기예보센터(ECMWF)의 ERA5 재분석자료를 내려받는 방법을 안내하고 있습니다. CLIK에서 제공하는 ERA5는 APCC가 코페르니쿠스 기후변화 서비스 데이터 저장소(CDS, Copernicus Climate Change Service Data Store)로부터 수집하여 제공하는 자료로, 이에 대한 자세한 내용은 아래 그림에 나타난 Overview 탭과 CDS 홈페이지(https://cds.climate.copernicus.eu)를 참고하시기 바랍니다.

(그림 3-2-33) ERA5 Overview 페이지

ERA5 재분석자료는 Daily (6시간 단위), Hourly, Monthly 자료로 구성되어 있으며, pressure(multiple level, single level)로 분류하여 제공됩니다. 자료의 Temporal resolution (timestep), level, 변수에 관련한 사항은 Overview 탭에서 확인할 수 있습니다.CLIK은 wget, CLIK API 두 가지 방식을 통해 ERA5 다운로드 서비스를 제공합니다. wget을 이용하여 아래의 그림과 같이 자료를 내려받을 수 있으며, 자료 저장 구조는 Data structure 탭에서 확인할 수 있습니다.

(그림 3-2-34) wget을 활용한 ERA5 재분석자료 다운로드 방법

또한 사용자는 다음 그림과 같이 CLIK API를 이용하여 자료를 내려받을 수 있습니다. DAILY, HOURLY, MONTHLY sample을 선택하면 각 temporal resolution 별로 활용할 수 있는 예제 코드를 제공하고 있습니다.

(그림 3-2-35) CLIK API를 사용한 ERA5 재분석자료 다운로드 방법

아. NCEP Reanalysis  Link

NCEP Reanalysis 페이지에서는 NCEP1, NCEP2 재분석자료를 다운로드 하는 방법을 안내하고 있습니다. NCEP 자료 관련 상세 설명은 아래 NCEP Reanalysis 페이지의 Overview 탭에서 제공합니다.

원본 자료에 대한 자세한 내용은 NCEP Reanalysis 1 홈페이지(https://psl.noaa.gov/data/gridded/data.ncep.reanalysis.html), NCEP Reanlysis 2 홈페이지(https://psl.noaa.gov/data/gridded/data.ncep.reanalysis2.html)를 참고하십시오.

(그림 3-2-36) NCEP 재분석 자료 - Overview

CLIK은 NCEP 자료 다운로드를 위해 wget과 CLIK API 서비스를 제공합니다. 자료 다운로드 방법은 Download 탭에서 확인할 수 있습니다.

(그림 3-2-37) NCEP 재분석 자료 - Download

NCEP 자료는 위 그림의 Wget download 탭과 CLIK API Download 탭의 샘플을 참고하여 다운로드 받을 수 있습니다. 사용자는 다운받고자 하는 데이터의 [timestep], [level], [variable name]과 [file name]을 선택하여 wget 또는 CLIK API 스크립트를 작성하여 원하는 데이터를 다운로드 받을 수 있습니다.

(그림 3-2-38) NCEP 재분석 자료 – wget 다운로드 방법

(그림 3-2-39) NCEP 재분석 자료 – CLIK API 다운로드 방법

가. Prediction   Link

APCC에서 제공하는 계절예측 시스템을 기반으로 개발된 CLIK 플랫폼의 Prediction 메뉴로서, 사용자는 제공되는 옵션을 조합하여 원하는 계절예측 결과를 얻을 수 있습니다.

(그림 3-3-1) Prediction 페이지

Prediction의 경우에는 사용자가 로그인해야만 서비스를 이용할 수 있습니다. 로그인하지 않으면 아래 그램과 같이 버튼이 비활성화되어 있습니다.

(그림 3-3-2) 메뉴 비활성화(비로그인 상태)

아래의 그림은 사용자가 정상적으로 로그인을 하여 Prediction 기능을 이용할 수 있는 상태를 보여줍니다.

(그림 3-3-3) 메뉴 활성화(로그인 상태)

Year / Season : 사용자가 계절예측을 하고자 하는 연도와 시즌을 선택합니다.

(그림 3-3-4) 연도와 시즌을 선택

Methods : CLIK 플랫폼에 제공되는 단정(Deterministic) 및 확률(Probabilistic) 예측 두가지 방법 중에서 사용자가 원하는 방법을 선택합니다.

(그림 3-3-5) Methods 선택

Models : 사용자가 원하는 모델을 선택합니다. 해당 모델의 목록은 해당 연도와 월에 업데이트된 모델 목록으로서, 매달 업데이트되는 결과에 따라 모델 목록이 달라집니다.

(그림 3-3-6) Prediction Model 목록

Predict : 사용자가 선택한 조건으로 예측 결과를 생성합니다. 만약 같은 조건의 결과가 있으면 바로 표출이 되고, 사용자가 선택한 조건의 결과가 없을 때는 선택 조건으로 결과를 생성합니다.

(그림 3-3-7) Predict 버튼을 누르면 계절예측 결과를 생성

결과 이미지가 있는 경우 : 사용자가 선택한 조건으로 다른 사용자가 이미 생성한 경우입니다. 이 경우에는 따로 작업을 생성하지 않고 바로 화면에 결과를 표출합니다. CLIK 플랫폼에서는 사용자 선택의 조합 결과를 요청한 사용자 별로 관리하지 않고 전체 공유하므로 다른 사용자가 이미 생성한 결과가 있으면 바로 확인을 할 수 있습니다.

(그림 3-3-8) Predict 생성 결과

결과 이미지를 클릭하면 팝업으로 큰 화면의 원본 이미지를 볼 수 있습니다.

(그림 3-3-9) Predict 결과 화면에서 이미지 클릭 시 원본 화면으로 확인

결과 이미지가 없는 경우 : 사용자가 선택한 조건에 해당하는 결과가 없는 경우에는 생성 작업을 수행하게 됩니다. 이미지 생성은 Queue를 통해서 작업을 수행하고, 진행상황은 My Jobs 페이지를 통해서 확인할 수 있습니다. 작업이 완료되면 회원가입 시 등록한 이메일로 작업 완료 이메일이 발송됩니다.

(그림 3-3-10) 조회 결과가 없을 때 이미지를 생성

파일 다운로드 : 파일 다운로드 기능의 경우에는 이미지 형식과 nc 파일 두 가지 형식으로 제공하고 있습니다. 파일 다운로드는 결과가 있는 경우에만 다운로드 파일을 제공합니다.

(그림 3-3-11) 결과 이미지 및 nc 파일 다운로드 버튼

나. Verification   Link

APCC의 검증 시스템을 기반으로 개발된 CLIK 플랫폼의 Verification 메뉴로서, 사용자는 제공되는 옵션을 조합하여 원하는 검증 결과를 얻을 수 있습니다.

(그림 3-3-12) Verification 페이지

Verification 서비스도 Prediction과 마찬가지로 로그인을 해야만 서비스를 이용할 수 있습니다. 로그인하지 않으면 그림과 같이 버튼이 비활성화되어 있고, 로그인을 하게 되면 버튼이 활성화되어 서비스를 이용할 수 있습니다.

(그림 3-3-13) 로그인 전과 후에 따른 이미지 활성화 (좌측 : 로그인 전, 우측 : 로그인 후)

Year / Month : 사용자가 원하는 연도도 와 월을 선택합니다

(그림 3-3-14) 연도와 월을 선택

Skills : CLIK 플랫폼에서 제공되는 4가지 검증 방법 가운데 하나를 선택합니다.

(그림 3-3-15) CLIK 플랫폼에서 제공되는 검증 방법 중 선택

Variable : Verification 메뉴에서는 CLIK 플랫폼에서 제공되는 6개의 변수 중에서 한가지 변수를 선택하여 결과를 얻을 수 있습니다.

(그림 3-3-16) CLIK 플랫폼에서 제공되는 변수 중 선택

Models : 사용자가 원하는 모델을 선택합니다. 해당 모델의 목록은 해당 연도와 월에 업데이트된 모델 목록으로서, 매달 업데이트되는 결과에 따라 모델 목록이 달라집니다.

(그림 3-3-17) Verification 모델 목록

Verify : 사용자가 선택한 조건으로 결과를 생성합니다. 만약 같은 조건의 결과가 있으면 바로 표출이 되고, 사용자가 선택한 조건의 결과가 없을 때는 선택 조건으로 결과를 생성합니다.

(그림 3-3-18) Verify 버튼을 누르면 검증결과가 생성

결과 이미지가 있는 경우 : 사용자가 선택한 조건으로 다른 사용자가 이미 생성한 경우입니다. 이 경우에는 따로 작업을 생성하지 않고 바로 결과를 표출해 줍니다. CLIK 플랫폼에서는 사용자 선택의 조합 결과를 요청한 사용자 별로 관리하지 않고 전체 공유하므로 다른 사용자가 이미 생성한 결과가 있으면 바로 확인을 할 수 있습니다.

(그림 3-3-19) Verification 생성 결과

화면 하단의 결과 이미지를 클릭하면 팝업으로 큰 화면의 원본 이미지를 볼 수 있습니다.

(그림 3-3-20) Verification 결과 화면에서 이미지 클릭시 원본 화면으로 확인

결과 이미지가 없는 경우 : 사용자가 선택한 조건에 해당하는 결과가 없는 경우에는 생성 작업을 하게 됩니다. 이미지 생성은 Queue를 통해서 작업을 수행하고, 진행 상황은 My Jobs 페이지를 통해서 확인할 수 있습니다. 작업이 완료되면 회원 가입할 때 등록한 이메일로 작업 완료 이메일이 발송됩니다.

(그림 3-3-21) 조회 결과가 없을 경우 이미지를 생성

파일 다운로드 : 파일 다운로드 기능의 경우에는 이미지 형식과 nc 파일 두 가지 형식으로 제공하고 있습니다. 파일 다운로드는 결과가 있는 경우에만 다운로드 파일을 제공합니다.

(그림 3-3-22) 결과 이미지 및 nc 파일 다운로드 버튼

다. Downscale  Link

Downscale 메뉴에서는 관측자료와 모델자료를 이용한 예측정보 상세화 기능을 제공합니다. Downscale 서비스도 로그인을 해야만 서비스를 이용할 수 있습니다.

(그림 3-3-23) 로그인 전과 후에 따른 Downscale 메뉴 활성화

예측정보 상세화 실행에는 관측지점의 관측값이 필요합니다. 이에 사용자가 관측자료를 입력 및 편집할 수 있는 기능을 제공합니다. Downscale 메뉴를 선택하면 아래 그림과 같은 테이블이 출력됩니다. 사용자는 먼제 테이블에서 관측자료를 추가하거나 선택해야 합니다. 관측자료를 선택하면 하단의 지도에 관측지점이 출력됩니다. 사용자는 지도에서 관측지점을 선택하여 상세화 실행을 요청할 수 있습니다.

(그림 3-3-24) 관측자료 리스트

사용자가 관측자료를 추가할 경우 관측자료 리스트 화면에서 ‘Create’ 버튼을 선택하면 아래 그림과 같이 새로운 관측자료 이름과 설명을 입력할 수 있는 화면이 출력됩니다.

(그림 3-3-25) 신규 데이터셋 생성

이름과 설명을 입력한 후 ‘Create’ 버튼을 선택하면 아래와 같이 관측자료 테이블에 새로운 관측자료가 추가됩니다.

(그림 3-3-26) 신규 데이터셋 추가 후 관측자료 테이블

사용자는 자신만의 관측자료를 생성하고 관리할 수 있습니다. 관측자료를 편집하려면 위의 그림과 같이 편집할 관측자료를 테이블에서 선택한 후 ‘Edit’ 버튼을 선택합니다. 관측자료 dataset에 관측지점 및 관측값이 추가되어 있는 경우에는 아래 그림과 같이 그 내용이 출력됩니다.

(그림 3-3-27 관측자료 수정화면

사용자는 관측지점을 등록, 수정, 삭제할 수 있으며, 각 관측지점에 관측값을 추가하고 수정, 삭제할 수 있습니다. Import 기능을 이용하여 CSV 형식으로 작성한 파일의 내용을 일관적으로 입력할 수 있고, Export 기능을 이용하여 현재 입력된 자료를 CSV 형식의 파일로 내려받을 수 있습니다.

(그림 3-3-28 등록한 관측 데이터 전체 공개 설정

위의 그림에서 ‘PUBLIC’에 체크하면 사용자가 직접 등록한 관측자료를 서비스를 이용하는 모든 사용자에게 공개할 수 있습니다.

사용자는 관측자료 수정화면에서 Stations 영역에 있는 버튼들을 이용하여 관측지점을 관리할 수 있습니다. 사용자는 ‘Insert’ 버튼을 선택하여 아래 그림과 같이 관측지점(Station)을 직접 입력 할 수 있습니다.

(그림 3-3-29) 관측지점(Stations) 정보 등록

관측지점의 정보를 입력한 후 ‘Save’ 버튼을 선택하면 해당 관측지점이 테이블에 추가됩니다. 여러 관측지점을 한번에 입력하려면 ‘Import’ 버튼을 선택합니다.

(그림 3-3-30) 관측지점 Import

‘Import’ 버튼을 선택하면 위 그림과 같이 파일 업로드할 수 있는 GUI가 출력됩니다. 국가명을 선택하고 ‘Browse file’을 누른 후 나타난 파일 선택 창에서 CSV 파일을 선택하고 ‘Upload’ 버튼을 누르면 CSV 파일에 저장된 관측지점 정보가 추가됩니다.

(그림 3-3-31) 관측지점 Import 결과

CSV 작성 규칙은 관측지점 Import 화면에서 ‘example’ 버튼을 선택하면 확인할 수 있습니다.

(그림 3-3-32) 관측지점 파일 샘플

‘Download comma separated sample.’ 버튼을 선택하면 샘플 CSV 파일을 내려받을 수 있습니다.

Import 기능과 반대로 ‘Export’ 버튼을 선택하면 현재 입력된 관측지점을 모두 내려 받을 수 있습니다. 또한 관측지점을 선택한 후 ‘Remove’ 버튼을 누르면 선택한 관측지점 자료를 삭제할 수 있습니다. 관측지점을 삭제하면 해당 관측지점의 관측값도 모두 삭제됩니다. ‘Remove All’ 버튼을 선택하여 현재 입력된 모든 관측지점 자료를 삭제할 수 있습니다.

관측값 관리는 관측지점 관리 방법과 동일합니다.

사용자가 관측자료를 추가한 후 상세화 실행을 요청하려면 먼저 관측지점을 선택해야 합니다. 아래 그림과 같이 관측자료 목록에서 관측자료를 선택하면 지도에 관측지점의 위치가 표시됩니다. Shift 키와 마우스 왼쪽 버튼을 누르고 지도를 drag 하면 해당 영역내의 관측지가 선택됩니다.

(그림 3-3-33) 관측자료 리스트

(그림 3-3-34) 관측지점 선택

지도에서 관측지점을 선택한 후 ‘Add Selected’ 버튼을 선택하면 위 그림과 같이 하단의 테이블에 관측지점이 추가됩니다. ‘How to use?’ 버튼을 선택하면 지도에서 관측지점을 선택하는 좀더 상세한 방법을 알수 있습니다. 테이블에서 원하는 관측지점 1개를 선택한 후 ‘Input Downscale Job’ 버튼을 선택하면 예측정보 상세화 작업을 입력할 수 있습니다.

관측지점을 선택하고 상세화 작업 입력을 요청하면 아래 그림과 같은 실행 조건을 입력할 수 있는 GUI가 출력됩니다.

(그림 3-3-35) 상세화 작업 입력 화면

GUI는 총 4개의 부분으로 나뉘어져 있습니다. Station information 부분에는 사용자가 선택한 관측지점 정보가 출력됩니다. Predictand 부분에서 사용자는 상세화 시즌(년도, 월)과 관측값 변수를 선택할 수 있습니다.

Predictor 부분에서는 예측정보를 선택합니다. 변수(Variable)를 선택하면 변수를 포함하고 있는 예측모델이 출력됩니다. 모델 목록에서 원하는 모델을 선택한 후 Training 기간을 선택합니다. Advanced Options 부분은 기본 값이 선택되어 있으며 원하는 경우 변경할 수 있습니다.

Domain 부분에서는 예측인자 영역을 선택합니다. Shift 키와 마우스 왼쪽 버튼을 누른 상태에서 지도를 drag하여 지역을 선택하거나 GUI에 직접 입력할 수 있습니다. 지역 선택 시 도움이 되도록 correlation map을 제공합니다. “Check pattern”을 선택하면 아래 그림과 같은 correlation map이 출력됩니다.

마지막으로 상세화 작업 입력 화면의 “Downscale” 버튼을 선택하면 상세화 작업이 입력됩니다.

(그림 3-3-36) Correlation map

상세화 작업이 입력된 후에는 My Jobs 메뉴에서 진행상황을 확인할 수 있습니다. 상세화 작업은 선택한 관측정보, 입력한 모델 및 예측인자 영역에 따라 결과가 다르게 나타나며 적합한 결과가 도출되지 않아 실패할 확률도 높습니다. 상세화 작업이 성공한 경우에는 아래 그림과 같이 ‘Download’, ‘Edit’, ‘Result’ 버튼을 출력됩니다.

(그림 3-3-37) Downscale 결과 화면

‘Download’ 버튼을 선택하면 실행결과 파일이 다운로드 됩니다. ‘Edit’ 버튼을 선택하면 사용자가 입력한 실행 조건이 출력됩니다. 실행 조건을 조정하여 다시 작업을 요청할 수 있습니다.

‘Result’ 버튼을 선택하면 상세화 실행 결과가 출력됩니다. 상단에는 아래 그림과 같은 사용자가 입력한 실행 조건이 출력됩니다.

(그림 3-3-38) 상세화 실행 결과 – 사용자 입력한 실행 조건

모델 목록에서 사용자가 원하는 목록을 선택하게 되면 아래 그림과 같은 결과가 출력됩니다.

(그림 3-3-39) 상세화 실행 결과

라. Clipping  Link

자료 추출 서비스(Clipping) 기능은 Processing 메뉴의 Clipping에서 확인할 수 있습니다. (단 자료 추출 서비스는 로그인 상태에서만 활성화됩니다.) 자료 추출 서비스는 사용자가 추출에 사용할 데이터(APCC-MME, Individual Model)에 따라 초기화면과 구성이 달라집니다.

최상단에 위치한 탭에서 MME를 선택하여 APCC 다중 모델 앙상블이나 Individual을 선택하여 각 기관에서 생산된 개별모델을 선택하여 각각의 자료를 처리할 수 있습니다.

APCC MME 모델을 선택했을 경우 자료추출 서비스 초기 화면의 메뉴 구성은 아래와 같습니다.

(그림 3-3-40) 자료추출서비스 APCC MME 초기 화면

- Leadtime : MME 모델에서는 3개월과 6개월을 제공합니다. 원하는 기간을 선택할 수 있습니다.

- Year/Month : 추출할 MME 모델의 연/월을 선택할 수 있습니다. MME 모델 자료는 매달 15일 경 최신으로 업데이트 됩니다.

- Method : Deterministic(결정론적 MME)과 Probabilistic(확률론적 MME) 방법을 제공하고 있습니다.

- Period : 계절 평균과 월별 평균을 선택할 수 있습니다.

- Variable : 각 모델에 포함된 각각의 변수를 선택할 수 있습니다.

- Coordinate : 사용자가 추출하고자 하는 위/경도 좌표 입력을 통하여 원하는 지역을 설정할 수 있습니다.

- Region : 대표적으로 많이 사용하는 지역을 미리 정의하여 Global, Australia, Australia_S.Pacific, East Asia, Middle East, North America, Russia, South America, South Asia 등을 선택할 수 있습니다.

- Country : 선택된 국가의 최대 경계값을 기준으로 자료를 추출합니다.

APCC Individual Model을 선택했을 경우 자료추출 서비스 메뉴 구성은 아래와 같습니다.

(그림 3-3-41) 자료추출서비스 APCC MME 초기 화면

- Year/Month : 추출할 MME 모델의 연/월을 선택할 수 있습니다.

- Institute : 모델을 제공하는 기관명을 선택할 수 있습니다. 기관명이 선택되면 Model명이 자동으로 변경됩니다.원하는 기간을 선택할 수 있습니다.

- Variable : 각 모델에 포함된 각각의 변수를 선택할 수 있습니다.

Clipping Area(Coordinates, Region, Country)는 MME와 동일한 방식으로 구성되어 있습니다. 계절 평균과 월별 평균을 선택할 수 있습니다.

위의 설정값을 사용자가 원하는 대로 설정한 후 화면 중앙의 Data Plot 버튼을 누르게 되면 아래와 같은 결과 화면이 나타납니다.

(그림 3-3-42) SCOPS 모델의 강수에 대한 Anomaly 6개월 자료 결과

결과 화면을 사용자가 자세히 보고 싶을 경우, 화면을 클릭하게 되면 아래 그림과 같이 큰 화면으로 나타나서 사용자는 자세하게 확인할 수 있습니다.

(그림 3-3-43) 결과 이미지를 클릭하여 나타난 큰 화면

또한, 화면 하단의 Download Result 버튼을 통해서 원하는 파일 형식(NetCDF, Excel)의 데이터를 다운로드 받을 수 있습니다.

(그림 3-3-44) 결과 파일(NetCDF, Excel) 다운로드 버튼 화면

마. Composite  Link

Processing – Composite 메뉴에서는 예측/관측자료를 연도, 월 등의 기간으로 합성하는 기능을 제공합니다. 사용자는 원하는 연도와 월에 대하여 선택하여 원하는 합성 결과에 대한 조건을 입력하여 원하는 결과를 도출할 수 있습니다.

Composite 메뉴로 진입하게 되면 사용자는 하단의 조건 설정 화면을 확인할 수 있습니다. 조건 확인 화면의 메뉴 구성은 아래와 같습니다.

(그림 3-3-45) 예측자료와 관측자료의 합성을 위한 조건을 입력하는 화면

- Variable : 예측 자료의 변수를 선택할 수 있습니다.

- Forecast Length : MME자료의 3개월/6개월을 선택할 수 있습니다.

- LeadTime : 사용자가 합성하고 싶은 Lead Time을 선택합니다.

- Date : 사용자가 합성하고 싶은 연/월을 선택할 수 있습니다. 연도나 월을 표시하는 숫자를 선택하게 되면 일괄적으로 해당되는 모든 연/월을 선택하게 됩니다.

자료 합성 서비스에서는 계절예측 자료와 관측자료를 활용하여 다양한 조건으로 자료를 분석할 수 있습니다.

사용자가 원하는 비교 값을 입력 후 하단의 Plot 버튼을 누르게 되면 아래와 같은 Composite Map 결과 값이 나타납니다.

(그림 3-3-46) Composite Map 결과 화면

바. Masking  Link

Processing – Masking 메뉴에서는 정밀한 지역에 대한 자료추출을 지원하는 지리정보 기반의 마스킹 정보를 제공하고 있습니다. 사용자는 원하는 연도와 월, 지역을 선택하여 원하는 결과를 도출할 수 있습니다.

(그림 3-3-47) Masking 초기화면

- Leadtime : MME 모델에서는 3개월과 6개월을 제공합니다. 원하는 기간을 선택할 수 있습니다.

- Year/Month : 추출할 MME 모델의 연/월을 선택할 수 있습니다. MME 모델 자료는 매달 15일 경 최신으로 업데이트 됩니다.

- Method : Deterministic(결정론적 MME)과 Probabilistic(확률론적 MME) 방법을 제공하고 있습니다.

- Period : 계절 평균과 월별 평균을 선택할 수 있습니다.

- Variable : 예측 자료의 변수를 선택할 수 있습니다.

- Masking Operator : Masking 기능에서는 총 4종류의 Masking Operator를 제공하고 있습니다.
      > Point in Polygon : 점이 주어진 다각형 내에 있는지 여부를 판별하는 알고리즘으로, 다각형의 경계와 내부를 구분하여 점이 내부에 속하는지 확인하여 내부에 속하면 그 영역을 표시합니다.
      > Point in MBR(Minimum Bounding Rectangle) : 점이 주어진 MBR에 속하는지 여부를 판별하는 알고리즘으로 MBR은 국가 경계를 둘러싸는 최소 크기의 사각형입니다.
      > Point in Expanded MBR(Minimum Bounding Rectangle) : 점이 MBR을 확장(Distance값 참조)한 영역에 속하는지 여부를 판별하는 알고리즘으로, 국가 경계의 MBR을 확장시켜 생성된 사각형 영역을 사용하여 판별합니다.
      > Rectangle(Cell Boundary) Intersects Polygon : 이 알고리즘은 직사각형(셀 경계)과 다각형이 교차하는지 여부를 판별하는 알고리즘입니다. 셀 경계와 다각형이 겹치거나 교차하는 경우를 확인하여 교차 여부를 결정합니다.

(그림 3-3-48) Masking Operator 비교

사용자가 추출하기 원하는 값을 선택한 후 하단의 Plot 버튼을 누르게 되면 아래와 같은 Masking 결과 값이 나타납니다.

(그림 3-3-49) Masking 결과 창

결과 화면에서 Download XML Result 버튼을 선택하게 되면, 마스킹 결과에 대한 값을 XML 형식으로 다운로드 받을 수 있습니다.

사. AIMS(APCC Integrated Modeling Solution)  Link

AIMS는 기후변화 시나리오 및 계절예측에 대한 통계적 상세화/평가 정보를 생산하는 도구입니다. 하나의 프로그램에 많은 기능을 포함하여 사용자들에게 사용하기 쉬운 기후변화 시나리오 상세화 도구를 제공하는 것이 이 프로젝트의 목적입니다.

(그림 3-3-50) AIMS 메뉴 화면

AIMS는 웹 브라우저에서 실행되는 웹 프로그램이 아닌 마이크로소프트 윈도우 운영체제가 설치된 사용자 PC에 Stand-Alone 프로그램 설치 후 활용할 수 있습니다. 기후서비스 플랫폼의 Processing – AIMS 메뉴에서는 AIMS에 대한 소개와 AIMS 클라이언트 프로그램/매뉴얼/예제데이터를 내려받을 수 있는 링크를 제공합니다.

(그림 3-3-51) AIMS 페이지 초기화면

AIMS는 Windows 7 또는 그 이상의 64비트 마이크로소프트 윈도우 시스템에서 동작하며, 8GB 이상의 메모리와 100GB 이상의 저장공간이 필요합니다. 자세한 사항과 기능에 대한 설명은 AIMS 페이지에서 제공하는 매뉴얼에서 자세하게 안내하고 있습니다.

가. Message Queue

Dataset 의 Download 탭 및 Processing 메뉴에서 자료를 요청하면 화면의 다음 그림과 같이 오른쪽 위 끝에서 Job 아이디를 확인할 수 있습니다. Job 아이디 알림 메시지는 출력 후 곧 사라집니다. CLIK 플랫폼의 대부분의 사용자 요청은 Job으로 관리되며 모든 사용자의 Job은 순차적으로 처리됩니다. 사용자가 동시에 요청할 수 있는 Job의 수는 제한되어 있습니다.

(그림 3-4-1) Job 아이디 알림 메시지

사용자는 My Jobs 메뉴에서 요청한 Job 목록 및 진행 상황을 확인할 수 있습니다.

상단의 “Auto Refresh”를 선택하면 Job 목록은 30초마다 자동으로 업데이트됩니다.

Job 목록은 Job의 종류, 입력 시간, 종료 시각, 진행 상황을 보여줍니다.

Job은 대기(Queued), 실행(Running), 실패(Failed), 완료(Completed)의 4가지 상태로 분류됩니다.

(그림 3-4-2) Job 목록

Job이 성공적으로 완료되었을 때 Job의 상태는 Download로 변경되고, “Download” 버튼을 선택하면 결과 자료가 다운로드 됩니다.

“Auto Refresh”를 선택하지 않은 상태에서 목록의 Job type(MME_3MONTH, MODEL, Prediction, Verification 등)을 선택하면 Job의 상세 내용을 확인할 수 있습니다.

아래의 그림과 같이 실패한 Job의 경우 오류의 원인이 출력되는 것을 살펴볼 수 있습니다.

(그림 3-4-3) Job의 상세정보

CLIK Open Application Program Interface (API)는 사용자가 프로그래밍을 이용하여 자료를 사용할 수 있도록 하는 서비스입니다. API를 이용하여 자신의 코드내에 자료를 다운로드하는 코드를 추가할 수 있습니다. CLIK 플랫폼은 현재 API를 사용할 수 있는 API Client를 Python, Java 두 가지 언어로 제공하고 있습니다. 이 튜토리얼에서는 Python 언어를 이용하는 방법을 소개합니다.

가. API Key 설정

API Key는 API를 사용할 때 필수적입니다. 사용자 Key는 다음과 같이 설정할 수 있습니다.

사용자 계정이 없으면 “Registration” 메뉴에서 사용자 가입

로그인한 후 “Member Info” 메뉴에서 “Get key” 버튼을 선택하여 Key 발급

(그림 3-5-1) 사용자 Key 발급

다음의 내용을 $HOME/apccapi.properties 파일에 기록 ($HOME 설정은 부록을 참고)

[코드 1] apccapi.properties

나. API Client 설치

CLIK은 Python 언어로 작성된 API Client를 제공하고 있습니다. 다음과 같은 방법으로 API Client를 설치할 수 있습니다.

CLIK API 페이지에서 API client를 다운로드하거나 wget을 이용하여 직접 다운로드

작업 폴더에 다음과 같은 방법으로 API Client 설치

[코드 2] API Client 다운로드 및 설치

다. API Client 사용

API Client를 설치한 후 사용자는 프로그램 내에서 자료를 요청하기 위해서 API를 호출할 수 있습니다.

사용자는 Python을 사용하여 다음과 같이 3개월, 6개월 MME 자료를 내려받을 수 있습니다. 예제의 type, method, variable 등의 선택사항은 Dataset 다운로드 페이지에서 확인할 수 있습니다

[코드 3] Python 예제: MME (3-Month)

[코드 4] Python 예제: MME (6-Month)

사용자는 Python을 사용하여 다음과 같이 MME 모델 자료를 내려받을 수 있습니다. 예제의 type, institute, model, variable 등의 선택사항은 Dataset 다운로드 페이지에서 확인할 수 있습니다.

[코드 5] Python 예제: Model

사용자는 Python을 사용하여 다음과 같이 CMIP5 자료를 내려받을 수 있습니다. 예제의 code 값은 Dataset 다운로드 페이지에서 확인할 수 있습니다.

[코드 6] Python 예제: CMIP5