실습 환경 준비

지윤은 Plotly 설치 페이지를 열었습니다. 터미널을 켜고 명령어 하나를 입력했습니다. 설치가 끝나고 Jupyter에서 첫 번째 차트를 실행했을 때, 브라우저 탭이 하나 더 열리며 인터랙티브 차트가 나타났습니다. 지윤은 자신도 모르게 마우스를 차트 위에서 이리저리 움직여봤습니다.

"이거 생각보다 훨씬 쉽네."

실습 환경을 구성해봅시다.

Python 버전 확인

이 교재는 Python 3.12 이상을 기준으로 작성되었습니다. 먼저 현재 설치된 버전을 확인합니다.

python --version

또는

python3 --version

출력 예시입니다.

Python 3.12.3

3.10 이상이면 대부분의 예제가 동작합니다. 3.8 이하라면 업그레이드를 권장합니다. Python 공식 사이트(python.org)에서 최신 버전을 다운로드할 수 있습니다.

가상 환경 생성 (권장)

전역 환경에 직접 설치해도 되지만, 프로젝트별 가상 환경을 사용하면 패키지 충돌을 방지할 수 있습니다.

# 가상 환경 생성python -m venv plotly-env# 활성화 (macOS / Linux)source plotly-env/bin/activate# 활성화 (Windows)plotly-env\Scripts\activate

활성화되면 터미널 프롬프트 앞에 (plotly-env)가 붙습니다.

Plotly 설치

pip install plotly

Jupyter Notebook에서 사용할 계획이라면 함께 설치합니다.

pip install plotly jupyter notebook

데이터 처리를 위한 Pandas도 설치해둡니다. 이 교재의 후반부에서 사용합니다.

pip install pandas

한 번에 설치하려면 다음 명령어를 사용합니다.

pip install plotly jupyter notebook pandas

버전 확인

설치가 완료되면 버전을 확인합니다. Python 코드로 확인하는 방법입니다.

# 새 파일: check_version.pyimport plotlyimport pandasimport sysprint(f"Python  버전: {sys.version}")print(f"Plotly  버전: {plotly.__version__}")print(f"Pandas  버전: {pandas.__version__}")

이 교재 작성 시점의 버전은 다음과 같습니다.

Python  버전: 3.12.3
Plotly  버전: 6.0.1
Pandas  버전: 2.2.2

Plotly 버전이 5.x라면 이 교재의 예제 대부분이 동작하지만, 일부 최신 기능은 다를 수 있습니다. pip install --upgrade plotly로 업그레이드할 수 있습니다.

Jupyter Notebook 설정

Jupyter Notebook에서 Plotly를 실행하면 셀 출력으로 인터랙티브 차트가 바로 나타납니다. 별도 설정이 필요하지 않습니다.

Jupyter를 시작하는 방법입니다.

jupyter notebook

브라우저에서 자동으로 Jupyter 대시보드가 열립니다. 새 노트북을 만들고 다음 코드를 실행해봅니다.

# 새 파일: first_chart.ipynb (첫 번째 셀)import plotly.express as pxfig = px.line(    x=[1, 2, 3, 4, 5],    y=[2, 4, 3, 6, 5],    title="첫 번째 Plotly 차트")fig.show()

셀 아래에 인터랙티브 차트가 나타나면 환경 설정이 완료된 것입니다.

VS Code 설정

VS Code에서 Jupyter 노트북을 사용할 수도 있습니다. Python 확장과 Jupyter 확장을 설치하면 됩니다.

설치할 확장

• Python (Microsoft 제공)
• Jupyter (Microsoft 제공)

확장 설치 후 .ipynb 파일을 열거나 새로 만들면 VS Code 내에서 Jupyter 노트북을 실행할 수 있습니다. Plotly 차트는 출력 영역에 인터랙티브 형태로 표시됩니다.

.py 파일로 실습하는 경우, fig.show()를 호출하면 기본 브라우저에서 차트가 열립니다.

정적 이미지 내보내기 (선택)

Plotly 차트를 PNG나 SVG로 저장하려면 추가 패키지가 필요합니다. 당장 필요하지 않으면 나중에 설치해도 됩니다.

pip install kaleido

설치 후 다음과 같이 사용합니다.

# 새 파일: save_image.pyimport plotly.express as pxfig = px.line(x=[1, 2, 3], y=[1, 4, 9], title="저장 테스트")fig.write_image("chart.png")   # PNG 저장fig.write_image("chart.svg")   # SVG 저장fig.write_html("chart.html")   # HTML 저장 (kaleido 불필요)

HTML 저장은 kaleido 없이도 동작합니다. HTML 파일 하나로 인터랙티브 차트를 공유할 수 있어서 가장 많이 사용하는 방식입니다.

설치 요약

환경이 준비되었습니다. 다음 PART부터 본격적으로 차트를 그려보겠습니다.