← 포털 홈

BOKDPM 실습 · 학생용

JupyterLab 설치·실습 가이드

한국은행 동태예측모형(BOKDPM)의 데이터 입수 → 모형 추정 → 시나리오 전망을 각자 컴퓨터에서 직접 실행해 보는 방법입니다. Windows 기준이며, 순서대로 따라 하면 됩니다.

무엇을 실습하나 01 데이터입수·검증 02 모형추정(베이지언) 03 기준선전망·시나리오

01은 Python만으로, 02(추정)는 Octave+Dynare가 추가로 필요합니다.

준비물

설치와 실행

1

Python 설치

python.org에서 Python 3.12를 내려받아 설치합니다. 설치 화면에서 “Add python.exe to PATH”를 반드시 체크하세요.

설치 확인(명령 프롬프트):

python --version
2

JupyterLab과 라이브러리 설치

명령 프롬프트에 한 줄씩 실행합니다.

python -m pip install --upgrade pip
python -m pip install jupyterlab pandas numpy statsmodels requests matplotlib koreanize_matplotlib
3

프로젝트 폴더 준비

실습 폴더 bokdpm_pipeline에는 다음이 들어 있습니다.

파일내용
config_env.py경로·인증키·도구 위치 정의(키는 저장하지 않고 읽기만)
01_데이터입수.ipynbECOS/FRED 수집 → 20개 관측변수 → 원본 대조
02_모형추정.ipynbOctave+Dynare로 베이지언 추정·식별표
03_기준선전망_시나리오.ipynb장기전망·시나리오 생성
data/ · mod/ · output/데이터 · 모형파일 · 산출물
4

인증키 설정 (중요·안전)

키는 코드에 적지 말고 환경변수로 둡니다. 무료 발급: ECOS 인증키 · FRED API key.

발급받은 키를 환경변수로 등록(명령 프롬프트, 재시작 후 유효):

setx API_KEY_BOK  "여기에_ECOS_키"
setx API_KEY_FRED "여기에_FRED_키"
주의: 인증키를 노트북·발표자료·깃허브에 그대로 붙여넣지 마세요. config_env.py는 환경변수에서만 읽으므로 키가 파일에 남지 않습니다.
5

JupyterLab 실행

프로젝트 폴더에서 실행하면 브라우저가 자동으로 열립니다.

cd C:\Temp\VAForecast\bokdpm_pipeline
python -m jupyterlab

왼쪽 파일 목록에서 01_데이터입수.ipynb를 더블클릭해 엽니다.

6

노트북 실행 순서

각 셀을 위에서부터 Shift+Enter로 차례로 실행합니다. 첫 셀에서 다음이 뜨면 준비 완료입니다.

ECOS 키 : 설정됨
FRED 키 : 설정됨

01 → 02 → 03 순서로 진행합니다. 01만 해도 데이터 수집·검증(원본 대조)까지 확인할 수 있습니다.

7

(추정 실습) Octave + Dynare 설치

02 추정 노트북은 무료 도구 OctaveDynare가 필요합니다.

설치 후 config_env.pyOCTAVE_CLI·DYNARE_MATLAB 경로를 본인 환경에 맞게 수정하거나, 같은 이름의 환경변수를 지정합니다.

자주 겪는 문제

증상해결
키가 “없음”으로 표시4단계 setx 후 명령 프롬프트를 새로 열고 다시 실행
그래프에서 한글이 깨짐koreanize_matplotlib 설치 확인(2단계)
ModuleNotFoundError해당 라이브러리를 python -m pip install 이름으로 설치
ECOS 오류 메시지키 오탈자·일일 호출한도 확인, 잠시 후 재시도
02에서 Octave/Dynare 못 찾음7단계 경로 확인(config_env.setup()이 OK/없음 표시)
이 실습은 6단계 로드맵의 1–4단계에 해당합니다. 데이터 처리·변수 설명은 관측 20변수 검증, 추정 결과는 파라미터·식별표를 참고하세요.