커리큘럼
아카데미모듈 2 · 지식그래프 키우기
그래프 컨트롤: 필터·검색·내보내기
이 레슨에서 배우는 것
- "보기 설정"에서 캔버스에 보이는 것들을 조절할 수 있습니다: "정보량", 고립 노드, 코드 레이어, "타입별 색", "최소 연결 수"
- "그래프에서 찾기"로 그래프를 검색하고 키보드로 결과 사이를 이동할 수 있습니다
- 리셋 버튼으로 격리 상태를 한 겹씩 되돌릴 수 있습니다
- 그래프 전체를 PNG, 반복 GIF, 영상으로 내보내면서 효과, 품질, 속도를 알맞게 고를 수 있습니다
그래프가 몇 주 사이 부쩍 자랐습니다. 천천히 도는 저 노드 구름 속에는 정말 중요한 허브 몇 개가 숨어 있죠. 그 허브들만 남겨서 보고 싶고, 내일 발표 슬라이드에는 그래프 전체가 도는 매끄러운 반복 애니메이션을 넣고 싶습니다.
두 가지에 필요한 도구는 모두 그래프 캔버스 위에 떠 있는 몇 개의 컨트롤에 들어 있습니다. 이번 레슨에서는 플로팅 버튼 세 개부터 그래프를 PNG, GIF, 영상으로 저장하는 내보내기 대화상자까지 차례로 짚습니다.
플로팅 버튼 세 개
그래프는 화면을 가리지 않도록 컨트롤을 위쪽 구석에 모아 둡니다. 한쪽 구석에는 회전, 이동, 줌 조작법을 알려 주는 마우스 아이콘 세 줄, 곧 힌트 오버레이가 떠 있죠. 반대쪽 구석에는 둥근 버튼 세 개, 이른바 FAB(플로팅 액션 버튼)가 있습니다.
| 버튼 | 툴팁 | 하는 일 |
|---|---|---|
| 원형 화살표 | "홈 뷰로 리셋" | 그래프 전체를 다시 잡아 줍니다. 격리나 컬렉션, 테마 포커스가 켜져 있으면 한 겹만 되돌립니다 |
| 눈 모양 아이콘 | "보기 설정" | 표시 관련 모든 조절 손잡이와 실시간 통계, 내보내기 메뉴가 담긴 드롭다운을 엽니다 |
| 겹친 사각형 | "컬렉션" | 컬렉션 팝오버를 엽니다. 컬렉션이 투영된 동안에는 개수 배지가 붙습니다 |
"보기 설정" 들여다보기
눈 모양 버튼을 누르면 캔버스에 보이는 모든 것을 조절하는 작은 드롭다운이 하나 열립니다. 컨트롤마다 맡은 일이 하나씩 분명합니다.
| 컨트롤 | 기본값 | 하는 일 |
|---|---|---|
| "정보량" 슬라이더 | 0.7 | 뷰가 얼마나 많이 보여줄지 정하는 단 하나의 손잡이입니다. 높일수록 라벨이 많아지고 깊이 안개가 걷히며, 최대로 올리면 범위 안 라벨이 전부 그려집니다 |
| "고립 노드 표시" | 켬 | 어디와도 연결되지 않은 노드를 보여주거나 숨깁니다 |
| "코드 표시" | 켬 | 코드 레이어, 즉 소스 파일 노드와 코드 엣지를 켜고 끕니다 |
| "타입별 색" | 끔 | 엔티티를 사람, 조직, 장소 같은 종류별로 색칠합니다. 타입 없는 엔티티는 중립색으로 남습니다 |
| "최소 연결 수" | "끔" (0) | 보이는 연결이 기준보다 적은 엔티티를 숨깁니다(값은 "≥ N"으로 표시). 빽빽한 그래프를 허브만 남기고 접어 줍니다 |
| "맵 모드" | 끔 | 그래프를 주제당 한 노드로 접습니다. 주제 지도를 만든 뒤에야 목록에 나타납니다 |
토글 아래에는 실시간 통계("노드", "엣지", "테마", "고립")가 있고, 그 아래에 동작이 두 개 있습니다. 내보내기 대화상자를 여는 "이미지·영상으로 저장", 그리고 모든 설정을 위의 기본값으로 되돌리는 "모든 설정 리셋"입니다.
이해도 체크
오래된 워크스페이스에서 "보기 설정"을 열었는데 "타입별 색" 토글이 아예 보이지 않습니다. 왜일까요?
"그래프에서 찾기"와 리셋 버튼
그래프 탭이 활성일 때 ⌘F를 누르면 타이틀바 검색이 "그래프에서 찾기"로 바뀝니다. 입력하는 동안 일치하는 노드는 맥동하고 나머지 엣지는 어두워지며, 카운터에 "n/m"이 표시됩니다. 타이핑만으로는 카메라가 움직이지 않습니다.
Mod+Shift+G 지식 그래프 탭 열기/닫기
Cmd/Ctrl+F "그래프에서 찾기" (그래프 탭이 활성일 때)
Enter 다음 결과로 이동(끝에서 처음으로 순환)
Shift+Enter 이전 결과로 이동(끝에서 처음으로 순환)
Esc 검색 지우기 / 팝오버 닫기리셋 버튼("홈 뷰로 리셋")은 누를 때마다 한 겹씩 벗겨냅니다. 테마 안으로 드릴다운한 상태에서는 테마 맵으로, 컬렉션 멤버를 파고든 상태에서는 컬렉션 세트로, 세트에서는 그래프 전체로 돌아갑니다. 확대에 갇힌 느낌이 들면 한 번 더 누르세요.
"컬렉션" 버튼, 짧게
겹친 사각형 버튼은 "컬렉션" 팝오버를 엽니다. 컬렉션은 규칙으로 정의해 저장해 두는 엔티티 묶음입니다.
저장된 행을 클릭하면 그 묶음이 캔버스에 투영되어, 멤버만 격리되고 "타입별 색"이 자동으로 켜집니다(해제하면 이전 설정이 돌아옵니다). 투영 중에는 버튼에 개수 배지가 붙고 팝오버에 "적용됨" 배너와 "지우기" 버튼이 나타납니다. 컬렉션을 정의하는 규칙을 직접 쓰는 방법은 따로 한 레슨에서 다룹니다.
- FAB
- 플로팅 액션 버튼. 그래프 캔버스 위에 떠 있는 둥근 버튼들입니다.
- 정보량 (Detail)
- 표시량을 정하는 단 하나의 손잡이(0에서 1)입니다. 높일수록 라벨이 많아지고 깊이 안개가 옅어집니다.
- 고립 노드
- 어디와도 연결되지 않은 노드입니다. "고립 노드 표시"로 켜고 끕니다.
- 최소 연결 수
- 연결이 기준보다 적은 엔티티를 숨겨 허브만 남기는 필터입니다.
- 맵 모드
- 그래프를 테마당 슈퍼 노드 하나로 접는 보기입니다.
- 컬렉션
- 엔티티 묶음을 정의하는 저장된 레시피입니다. 볼 때마다 현재 그래프 기준으로 다시 계산됩니다.
"이미지·영상으로 저장"
"보기 설정" 맨 아래에 "이미지·영상으로 저장"이 있습니다. 누르면 "지식 그래프 저장" 대화상자가 열립니다. 노드와 연결, 라벨까지 그래프 전체를 이미지 한 장이나 반복 애니메이션으로 내보내는 창이죠. 먼저 형식 카드 세 장이 나옵니다.
| 형식 | 결과물 | 어울리는 곳 |
|---|---|---|
| "이미지" | "정지 이미지 한 장 (PNG)." "배경 색 포함하기"를 끄면 투명 PNG가 됩니다 | 문서, 슬라이드, 인쇄 |
| "GIF" | "한 바퀴 회전해 매끄럽게 반복됩니다. 어디서나 재생돼요." | 채팅, README처럼 영상이 안 붙는 곳 |
| "영상" | "한 바퀴 회전해 반복됩니다. GIF보다 작고 선명해요." macOS는 mp4, 그 외는 webm | 발표, 소셜 포스트처럼 선명함이 중요한 곳 |
- "효과"(애니메이션 전용): 턴테이블은 단순 회전입니다. 기본값인 궤도는 대각선으로 기울어진 궤도를 돕니다. 호흡은 카메라가 가까워졌다 멀어집니다. 펄스는 그래프 전체가 맥동합니다. 쇼케이스는 궤도와 펄스를 합칩니다.
- "품질": 원본 / 높음 / 보통 / 작게. 원본은 라이브 화면 그대로이고, 높음, 보통, 작게는 긴 변을 각각 1600, 1080, 720px로 맞춰 더 가벼운 파일을 만듭니다.
- "회전 속도"(애니메이션 전용): 느리게 / 보통 / 빠르게로, 한 바퀴에 각각 10초, 6초, 3초입니다.
- "프레임 레이트"(영상 전용): 24 / 30 / 60 fps, 기본값은 30.
- "배경 색 포함하기"(PNG 전용, 기본 켬): 그래프 뒤에 라이트/다크 배경색을 칠합니다. 애니메이션은 항상 배경이 포함됩니다.
애니메이션은 정확히 한 바퀴를 렌더링하기 때문에 이음매 없이 반복됩니다. 저장하는 동안 "프레임 렌더링 중 {done}/{total}…"과 "인코딩 중…"이 차례로 보이고, 기본 파일 이름은 knowledge-graph입니다.
이해도 체크
컨퍼런스 대형 화면에 띄울, 가장 선명한 반복 애니메이션이 필요합니다. 무엇을 골라야 할까요?
이것이 그래프 컨트롤의 전부입니다. 버튼 세 개, 드롭다운 하나, 검색창 하나, 내보내기 대화상자 하나로 수천 노드의 엉킴을 화면에서든 파일로든 딱 필요한 그림으로 바꿉니다. 다음 레슨에서는 파일이 바뀌는 동안 그래프가 어떻게 스스로 최신 상태를 유지하는지 살펴봅니다.