환경설정

R 및 Positron 설치

R(계산 엔진)과 편집기(작업 환경)는 별개의 프로그램으로, R을 먼저 설치한 후 편집기를 설치

본 수업에서는 Posit의 새 데이터과학 IDE인 Positron을 사용 (RStudio도 계속 지원되므로 기존 환경을 유지해도 무리는 없음. 아래 RStudio에서 옮겨오기 참고)

• R 다운로드 및 설치: 현재 최신 버전은 R 4.6.1 (Positron은 R 4.2 이상 필요)
  • Windows인 경우: Download R for Windows > base 설치
  • Mac인 경우: Download R for macOS
    • Apple silicon (M1 이상): R-4.x.x-arm64.pkg — macOS 14(Sonoma) 이상
    • older Intel Macs: R-4.x.x-x86_64.pkg — macOS 11(Big Sur) 이상
• Positron 다운로드 및 설치
  • Windows 10/11, macOS 11(Big Sur) 이상
  • Windows는 system level / user level 설치 중 선택 (권한 문제가 있으면 user level)
  • Positron은 Elastic License 2.0로 배포되며, 개인·학술·상업적 용도 모두 무료
  • 설치 후 처음 실행하면 시스템에 설치된 R을 자동으로 찾아 세션을 시작함

이미 R/RStudio가 설치되어 있는 경우

• 버전 확인: 콘솔에서 R.version.string
• R은 새 버전을 설치하면 기존 버전과 별도로 설치됨 → Positron 상단 인터프리터 선택기에서 사용할 R 버전을 고를 수 있음
• R의 x.y 버전이 올라가면(예: 4.5 → 4.6) 패키지를 다시 설치해야 함: install.packages("tidyverse")
• 패키지 최신화: update.packages(ask = FALSE)
• RStudio를 지우지 않아도 됨. 같은 폴더/스크립트를 두 편집기에서 번갈아 써도 문제 없음

R 버전을 여러 개 쓰는 경우 (선택)

Mac/Linux에서는 rig(R Installation Manager)로 R을 설치·관리하는 것을 권장. CRAN 설치본은 최신 버전 하나만 깔끔하게 인식되는 구조라, 여러 버전을 병행하려면 rig가 편함.

# Mac (Homebrew)
brew install --cask rig
rig add release

Windows에서 패키지를 소스로 컴파일해야 하는 경우 Rtools가 추가로 필요 (Positron에 포함되어 있지 않음).

Positron 소개

화면 구성

• Editor (가운데): 코드를 작성하는 곳
• Panel (아래): Console(R 명령 실행)과 Terminal
• Secondary Side Bar (오른쪽): Session(Variables + Plots), Help, Viewer, History, Connections
• Primary Side Bar (왼쪽): Explorer(폴더/파일 목록), Search, Source Control, Packages, Assistant
• Activity Bar (맨 왼쪽 아이콘 줄): Primary Side Bar에 표시할 화면 선택
• Top Bar (위): 파일 검색, 프로젝트 전환, 인터프리터 선택기(R 버전 선택 / 시작 / 중지 / 재시작)
• Status Bar (맨 아래): git 브랜치, 언어 모드, 커서 위치 등

레이아웃 프리셋: Command Palette에서 검색

• Stacked (기본): Editor 위, Console 아래, Variables/Plots 오른쪽 — RStudio와 가장 비슷
• Side-by-side: Editor와 Console을 좌우로 (넓은 화면에 적합)
• Notebook, Assistant
• 대부분의 패널은 드래그로 위치 변경 가능. Customize Layout… 명령으로 세부 조정

Important

Command Palette: Ctrl+Shift+P (Win)   |   Shift+Command+P (Mac)

Positron의 거의 모든 기능은 메뉴가 아니라 Command Palette에서 이름으로 검색해 실행함. 메뉴에서 찾기 어려운 기능은 일단 여기서 검색해 볼 것.

폴더(Project) 단위로 분석

RStudio의 Project(.Rproj 파일)에 해당하는 개념이 Positron에서는 폴더(workspace)

• File > Open Folder… 로 작업할 폴더를 열면, 그 폴더가 곧 working directory
• 별도의 프로젝트 파일(.Rproj)을 만들 필요 없음 (기존 .Rproj가 있어도 무해하니 그냥 두면 됨)
• 새 폴더를 만들며 시작: File > New Folder from Template → R 템플릿 선택 (폴더 구조, git, renv 등을 함께 설정)
• 폴더 안의 파일은 상대경로로 지시: 예) data/file.sav
• 여러 프로젝트를 동시에 작업하려면 창을 여러 개 띄움 (File > New Window)
• 현재 working directory 확인: getwd()

Workspace(.RData) 저장이 없습니다

RStudio는 종료 시 workspace를 .RData로 저장/복원하는 기능이 있었으나, Positron에는 이 기능이 없음.

분석 과정은 workspace가 아니라 R script로 재현하는 것이 원칙이므로, 오히려 권장되는 방식. 필요한 결과물은 saveRDS() / write_csv() 등으로 명시적으로 저장할 것.

Session (R 세션)

• Restart R: Ctrl+Shift+0 (Win)   |   Shift+Command+0 (Mac)
• 재시작하면 메모리의 객체가 모두 사라짐 → 스크립트를 처음부터 다시 실행해 재현되는지 확인하는 습관
• 인터프리터 선택기에서 R 세션을 여러 개 동시에 띄울 수도 있음 (다른 R 버전 포함)

R script 실행

• 새 R 파일: Command Palette > R: Create a new R file (또는 File > New File… > R File)
• 현재 라인(또는 선택 영역) 실행: Ctrl+Enter (Win)   |   Command+Return (Mac)
• 파일 전체 실행(source()): Ctrl+Shift+Enter (Win)   |   Shift+Command+Return (Mac)
• 저장은 Ctrl+S / Command+S (자동 저장은 아래 설정 참고)

Quarto 문서 (.qmd)

Positron에는 Quarto 지원이 내장되어 있어, 본 강의 노트와 같은 .qmd 문서를 바로 편집·렌더할 수 있음

• 코드 셀 삽입: Ctrl+Alt+I (Win)   |   Option+Command+I (Mac)
• 셀 실행: 셀 위의 Run Cell 버튼 또는 Ctrl+Shift+Enter
• 렌더: 편집기 우상단 Preview 버튼
• Source / Visual 편집기 전환 가능 (편집기 우상단)

환경설정: Settings

설정 열기: Ctrl+, (Win)   |   Command+, (Mac)   또는 Command Palette > Preferences: Open Settings (UI)

검색창에 설정 이름을 넣어 찾는 방식. RStudio의 Tools > Global Options에 해당함.

수업에서 권장하는 설정 (Command Palette > Preferences: Open User Settings (JSON)에 붙여넣어도 됨)

{
  // 파이프 연산자: native pipe 사용 (RStudio 습관대로 %>% 를 원하면 "%>%")
  "positron.r.pipe": "|>",

  // RStudio 단축키 사용 (Ctrl+1/2 로 편집기/콘솔 이동 등) — 변경 후 재시작
  "workbench.keybindings.rstudioKeybindings": true,

  // 긴 줄을 창 너비에 맞춰 줄바꿈 (RStudio의 soft-wrap)
  "editor.wordWrap": "on",

  // 글자 크기 및 폰트
  "editor.fontSize": 14,
  "editor.fontFamily": "Menlo, 'Cascadia Mono', monospace",

  // 자동 저장
  "files.autoSave": "afterDelay",

  // 줄 끝 공백 정리
  "files.trimTrailingWhitespace": true,
  "files.insertFinalNewline": true,

  // 저장할 때 R 코드 자동 정렬 (Air formatter)
  "[r]": {
    "editor.formatOnSave": true
  }
}

그 외

• 테마: Command Palette > Preferences: Color Theme (Ctrl+K Ctrl+T / Command+K Command+T)
  • RStudio 테마가 익숙하면 확장(Extensions)에서 Tomorrow Night Bright (R Classic) 설치
• 전체 화면 줌: Ctrl+= / Ctrl+- (Win)   |   Command+= / Command+- (Mac)
• 설정은 User(전체 공통)와 Workspace(현재 폴더 한정) 두 수준이 있음. 위 설정들은 User 수준 권장

패키지의 설치

패키지의 설치경로 확인

패키지의 설치경로를 확인

.libPaths()

다음과 같이 program files만 나오거나 맨 위에 나오면 수정해야 함

C:/Program Files/R/R-4.6.1/library

참고로 install.packages() 자체가 시스템 library에 쓰기 권한이 없음을 발견하면 개인 library를 만들겠느냐고 물어보는 것이 원래 R의 정상 동작

학생에 따라 콘솔에 이어서 개인 library 생성 여부를 묻는 질문이 나타날 수도 있는데, 그 경우에는 Yes를 선택해도 해결됨

해결책

user_lib <- Sys.getenv("R_LIBS_USER")
dir.create(user_lib, recursive = TRUE, showWarnings = FALSE)
.libPaths(c(user_lib, .libPaths()))

잘 되었는지 다음과 같이 다시 경로를 확인해 보고,

.libPaths()

대략 다음처럼 개인 폴더가 맨 위에 나오면 정상

[1] "C:/Users/학생이름/AppData/Local/R/win-library/4.6"
[2] "C:/Program Files/R/R-4.6.1/library"

두 가지 방법

• Packages 패널: Activity Bar의 Packages 아이콘 (또는 Command Palette > View: Packages)
  • 설치된 패키지 목록, 버전, 로드 여부 확인
  • Install Package로 이름 검색해 설치, Update All Packages로 일괄 업데이트
  • 설치/업데이트 후에는 세션 재시작 안내가 뜸 → 재시작해야 반영됨
• 명령어: 콘솔에서 install.packages()

install.packages("name")

# 수업에서 필요한 기본 패키지
install.packages("tidyverse") # 패키지들의 패키지

# 추가 패키지
install.packages(c("mosaicData", "palmerpenguins")) # c(): combine items

패키지 로드: 필요한 패키지는 세션마다 시행해야 함

library(name) # e.g. library(tidyverse)

library(tidyverse)
## ── Attaching core tidyverse packages ─────────────── tidyverse 2.0.0 ──
## ✔ dplyr     1.2.1     ✔ readr     2.2.0
## ✔ forcats   1.0.1     ✔ stringr   1.6.0
## ✔ ggplot2   4.0.3     ✔ tibble    3.3.1
## ✔ lubridate 1.9.5     ✔ tidyr     1.3.2
## ✔ purrr     1.2.2
## ── Conflicts ───────────────────────────────── tidyverse_conflicts() ──
## ✖ dplyr::filter() masks stats::filter()
## ✖ dplyr::lag()    masks stats::lag()

패키지들 간의 함수의 충돌(masking)에 대해서…

• 나중에 로드된 패키지의 함수가 앞의 것을 가림
• 특정 패키지의 함수를 명시하려면 패키지명::함수명, e.g. stats::filter()

# 설치된 버전 확인
packageVersion("tidyverse")
sessionInfo() # R 버전 및 로드된 패키지 전체 정보

단축키

기능	Windows	Mac
기본
Command Palette (모든 기능 검색)	Ctrl+Shift+P	Shift+Command+P
자동완성	Tab	Tab
현재 라인/(불럭 선택 영역) 실행	Ctrl+Enter	Command+Return
assignment operator (<-) 삽입	Alt+-	Option+-
파이프 연산자 삽입	Ctrl+Shift+M	Shift+Command+M
undo / redo	Ctrl+Z / Ctrl+Shift+Z	Command+Z / Shift+Command+Z
주석 처리/해제	Ctrl+/	Command+/
콘솔 지우기	Ctrl+L	Ctrl+L
한 걸음 더
파일 전체 실행	Ctrl+Shift+Enter	Shift+Command+Return
줄 복사(위/아래)	Shift+Alt+↑/↓	Shift+Option+↑/↓
줄 이동(위/아래)	Alt+↑/↓	Option+↑/↓
도움말 보기 (커서 위 함수)	F1	F1
설정 열기	Ctrl+,	Command+,
R 세션 재시작	Ctrl+Shift+0	Shift+Command+0
콘솔로 포커스 이동	Ctrl+K, F	Command+K, F

• 삽입되는 파이프는 positron.r.pipe 설정에 따라 native pipe(|>) 또는 magrittr pipe(%>%)가 됨
• 콘솔에서 화살표 키 ↑/↓로 이전에 실행한 명령 불러오기
• 단축키 확인 및 변경: Command Palette > Preferences: Open Keyboard Shortcuts
  • 여기서 기능 이름으로 검색해 원하는 키를 새로 지정할 수 있음

도움말

• Help 패널: 오른쪽 Secondary Side Bar의 Help 탭에 도움말이 표시됨
• 편집기/콘솔에서 함수명에 커서를 두고 F1
• help() 또는 ?: e.g. help(factor), ?factor
• 특정 패키지의 함수: ?dplyr::mutate, help(CPS85, package = "mosaicData")
• 키워드로 검색: ??"linear model"
• 도움말의 예제 실행: example(factor)
• 데이터프레임을 Variables 패널에서 클릭하면 Data Explorer로 열려 열별 요약통계·정렬·필터를 볼 수 있음

참고 자료

• R for Data Science (2판): tidyverse 표준 교재
• tidyverse 패키지 문서
• Posit Cheatsheets: 주요 패키지 요약 정리
• Positron 공식 문서: 기능별 설명
• Positron 마이그레이션 가이드: RStudio 사용자용

RStudio에서 옮겨오기

RStudio와 달라지는 점 정리

RStudio	Positron
Project (.Rproj)	폴더(workspace)를 열면 됨
Files 패널	Explorer (왼쪽)
Environment 패널	Session 패널의 Variables (오른쪽)
Plots 패널	Session 패널의 Plots (오른쪽)
Packages 패널	Packages (Activity Bar)
Tools > Global Options	Settings (Ctrl+, / Command+,)
메뉴에서 기능 찾기	Command Palette (Ctrl+Shift+P / Shift+Command+P)
workspace(.RData) 저장/복원	없음 (스크립트로 재현)
RStudio Addins	Command Palette > R: Run RStudio Addin
Import Dataset 위젯	없음 (readr/haven 함수로 직접 코드 작성)

Positron에서만 되는 것

• R 버전 여러 개, R 세션 여러 개를 동시에 사용
• Data Explorer: 데이터프레임과 CSV/Parquet 파일을 열별 요약통계와 함께 탐색
• Python도 동등하게 지원 (한 창에서 R과 Python 병행)
• 확장(Extensions) 마켓플레이스
• Positron Assistant: AI 코드 보조 (Activity Bar의 Assistant 아이콘)

Tip

RStudio 단축키가 손에 익었다면 "workbench.keybindings.rstudioKeybindings": true 설정을 켤 것. Ctrl+1/2(편집기·콘솔 이동), Ctrl+Shift+C(주석), Ctrl+Shift+S(source) 등 상당수가 RStudio와 같아짐. 설정 변경 후 Positron을 재시작해야 적용됨.

---