Sigma.js
저수준 코드Low-level codegraphology를 기반으로 브라우저에서 대규모 네트워크 그래프를 렌더링하고 탐색하는 WebGL 라이브러리이며, 2026년 10월에 버전 4가 나왔습니다.A WebGL library for rendering and exploring large network graphs in the browser, built on graphology; version 4 shipped in October 2026.
현재 버전Current version: 4.0.3, 정보 확인일 2026-10-24facts checked 2026-10-24
개요Overview
Sigma.js는 브라우저에서 수천 개 이상의 노드와 엣지로 이루어진 그래프를 WebGL로 그리고 탐색하게 해 주는 오픈소스 JavaScript 라이브러리입니다. 데이터 모델은 graphology가 맡고 Sigma.js는 렌더링과 상호작용만 맡습니다. 노드 수가 수백 개를 넘어 SVG 기반 포스 레이아웃이 버거워질 때 먼저 검토하는 도구입니다.
Sigma.js is an open-source JavaScript library that draws and explores graphs with thousands of nodes and edges in the browser using WebGL. graphology handles the data model, and Sigma.js handles only rendering and interaction. It is the first tool to consider when a network grows past a few hundred nodes and an SVG-based force layout becomes sluggish.
Sigma.js의 초기 개발은 파리 시앙스포(Sciences Po) médialab의 지원을 받았고, 이후 OuestWare가 알렉시스 자코미(Alexis Jacomy)와 브누아 시마르(Benoît Simard)를 통해 개발을 이어 왔습니다. 소셜 네트워크, 인용 네트워크, 지식 그래프, 생물학적 네트워크처럼 관계가 핵심인 분야에서 쓰이며, Gephi로 만든 그래프를 웹에 공개하는 용도로도 자주 쓰입니다.
Initial development of Sigma.js was supported by Sciences Po médialab, and OuestWare has continued it through Alexis Jacomy and Benoît Simard. It is used where relationships are the point, such as social networks, citation networks, knowledge graphs and biological networks, and it is often used to publish graphs built in Gephi on the web.
2026년 10월 8일에 버전 4.0.0이 나왔고, 현재는 4.0.3(2026년 10월 15일)입니다. v4는 프로그램(렌더러) 시스템을 처음부터 다시 쓴 메이저 버전이라서, 2026년 이전의 튜토리얼과 AI가 학습한 예제 코드는 v3 방식인 경우가 많습니다. 학습할 때는 공식 문서의 v3에서 v4로 옮기는 안내를 함께 확인하십시오.
Version 4.0.0 was released on October 8, 2026, and the current version is 4.0.3 (October 15, 2026). v4 is a major version that rewrote the programs (renderer) system from scratch, so tutorials from before 2026 and example code in AI training data are often written for v3. When learning, check the official migration guide from v3 to v4 alongside any older example.
2026년 현재What's new in 2026
- Sigma.js 4.0.0(2026년 10월 8일): 프로그램 시스템을 전면 재작성했습니다. 4.0.1부터 4.0.3까지 패치가 10월 15일까지 이어졌습니다.
- Sigma.js 4.0.0 (October 8, 2026): the programs system was rewritten completely, with patch releases 4.0.1 through 4.0.3 following until October 15.
- 라벨을 SDF(부호 있는 거리장) 방식으로 WebGL에서 그립니다. 그리기 층이 하나로 합쳐졌고, 깊이 레이어와 라벨 부착물, 라벨 배경 기능이 추가되었습니다.
- Labels are now drawn in WebGL with signed distance fields. The drawing layers were merged into one, and depth layers, label attachments and label backdrops were added.
- WebGL 1 지원이 사라지고 WebGL 2가 필요합니다.
- WebGL 1 support was dropped, and WebGL 2 is required.
- 새로운 "primitives"와 선언형 "styles" API가 들어와서 이전에 nodeReducer와 edgeReducer로 하던 일의 상당수를 대체합니다.
- New "primitives" and declarative "styles" APIs replace much of what used to be done with nodeReducer and edgeReducer.
- 엣지 경로(직선, 곡선, 계단형, 루프)가 기본으로 들어 있습니다.
- Edge paths (straight, curved, step and loop) are built in.
- 동반 패키지로 @sigma/node-image, @sigma/node-border, @sigma/node-piechart, @sigma/layer-leaflet, @sigma/layer-maplibre, @sigma/export-image 등이 있습니다.
- Companion packages include @sigma/node-image, @sigma/node-border, @sigma/node-piechart, @sigma/layer-leaflet, @sigma/layer-maplibre and @sigma/export-image.
강점Strengths
- WebGL 렌더링으로 수천 개 이상의 노드와 엣지를 확대, 이동하며 탐색할 수 있습니다.
- WebGL rendering lets you zoom and pan through graphs with thousands of nodes and edges.
- graphology로 그래프 구조를 다루므로 중심성, 커뮤니티 탐지, 레이아웃 같은 알고리즘 패키지를 함께 쓸 수 있습니다.
- Because the graph lives in graphology, you can combine it with packages for centrality, community detection and layouts.
- 노드와 엣지의 크기, 색, 라벨을 데이터 속성에 따라 지정하고, 호버나 클릭 같은 이벤트로 이웃 하이라이트를 만들 수 있습니다.
- Node and edge size, color and label can follow data attributes, and events such as hover and click let you highlight neighbors.
- 이미지 노드, 테두리 노드, 파이 차트 노드, 지도 배경 레이어, 이미지 내보내기를 공식 동반 패키지로 쓸 수 있습니다.
- Image nodes, bordered nodes, pie-chart nodes, map background layers and image export are available as official companion packages.
- TypeScript로 작성되어 타입 지원이 좋습니다.
- Written in TypeScript with good type support.
- 렌더링 하나에 집중해서 번들이 작고 구조가 단순합니다.
- Focusing on rendering alone keeps the package small and the structure simple.
한계Limitations
- 네트워크 시각화 전용입니다. 막대나 선 같은 일반 차트는 다른 도구가 필요합니다.
- It is for network visualization only; general charts such as bars and lines need another tool.
- v4가 나온 지 얼마 되지 않았습니다. 인터넷의 예제와 AI가 만든 코드는 v3 기준일 수 있어서 직접 실행해 확인해야 합니다.
- v4 is new. Examples on the web and AI-generated code may target v3, so run and check them yourself.
- 레이아웃은 Sigma.js에 포함되지 않아 graphology-layout 계열 패키지나 Gephi 같은 외부 도구로 좌표를 계산해야 합니다.
- Layouts are not part of Sigma.js, so you must compute coordinates with graphology-layout packages or an external tool such as Gephi.
- 범례, 축, 주석처럼 일반 차트에 있는 요소가 기본으로 없습니다.
- Elements common in regular charts, such as legends, axes and annotations, are not included.
- 노드가 많으면 라벨이 겹치므로 어떤 라벨을 보일지 설정으로 조절해야 합니다.
- With many nodes labels overlap, so you must configure which labels are shown.
- 접근성(스크린 리더, 키보드 탐색)은 캔버스 기반 렌더링의 한계 때문에 별도 대안이 필요합니다.
- Accessibility (screen readers, keyboard navigation) needs separate alternatives because of the limits of canvas-based rendering.
- 많은 노드를 보여 주는 것과 읽기 쉬운 것은 다릅니다. 헤어볼처럼 보이는 그래프는 필터나 집계가 필요합니다.
- Showing many nodes is not the same as being readable. A graph that looks like a hairball needs filtering or aggregation.
이런 용도에 최적Best For
그래프의 핵심이 노드와 연결이고, 노드가 수천 개 이상이며, 확대와 클릭으로 탐색해야 하는 경우에 적합합니다. 인용 네트워크 탐색기, 소셜 네트워크 시각화, 지식 그래프 브라우저, Gephi 분석 결과를 웹으로 공개하는 작업이 대표적입니다.
It fits when the point of the graph is nodes and their connections, there are thousands of nodes or more, and the reader needs to explore by zooming and clicking. Typical uses are citation network explorers, social network visualizations, knowledge graph browsers and publishing Gephi analysis results on the web.
노드가 수십에서 수백 개이고 모양을 세밀하게 다듬어야 한다면 D3의 포스 레이아웃이 더 유연합니다. 연구 결과를 정적인 그림으로 내야 한다면 Gephi나 Python의 네트워크 라이브러리가 더 간단합니다.
If you have dozens to hundreds of nodes and need to polish the look in detail, D3's force layout is more flexible. If the result is a static figure for a paper, Gephi or a Python network library is simpler.
시작하기Getting Started
npm install sigma graphology로 설치합니다. 레이아웃이 필요하면graphology-layout-forceatlas2를 함께 설치합니다.- Install with
npm install sigma graphology. If you need a layout, also installgraphology-layout-forceatlas2. - HTML에 높이가 지정된 컨테이너를 만듭니다. 높이가 0이면 아무것도 보이지 않습니다.
- Add a container with an explicit height to your HTML. If the height is 0, nothing is drawn.
- graphology로 그래프를 만들고, 노드에 x, y 좌표와 크기, 색을 줍니다.
- Build the graph with graphology and give each node x and y coordinates, a size and a color.
- 컨테이너와 그래프를 Sigma에 넘겨 렌더링합니다. 이 생성자 형태는 v4에서도 같습니다.
- Pass the graph and the container to Sigma to render it. This constructor form is the same in v4.
- v3 시절 예제의 설정이나 리듀서 코드를 가져오기 전에 v4 문서의 styles와 primitives 설명을 확인합니다.
- Before copying settings or reducer code from a v3-era example, read the styles and primitives pages in the v4 docs.
<div id="container" style="width: 100%; height: 500px"></div>
import Graph from "graphology";
import Sigma from "sigma";
import forceAtlas2 from "graphology-layout-forceatlas2";
const graph = new Graph();
graph.addNode("1", { label: "Node 1", x: 0, y: 0, size: 12, color: "#e63946" });
graph.addNode("2", { label: "Node 2", x: 1, y: 1, size: 8, color: "#457b9d" });
graph.addNode("3", { label: "Node 3", x: 1, y: -1, size: 8, color: "#2a9d8f" });
graph.addEdge("1", "2", { size: 3 });
graph.addEdge("1", "3", { size: 3 });
graph.addEdge("2", "3", { size: 1 });
// Compute positions for a real graph that has no coordinates yet
forceAtlas2.assign(graph, {
iterations: 100,
settings: forceAtlas2.inferSettings(graph),
});
const renderer = new Sigma(graph, document.getElementById("container")!);
Gephi에서 내보낸 GEXF 파일은 graphology-gexf로 읽을 수 있습니다.
A GEXF file exported from Gephi can be read with graphology-gexf.
import Graph from "graphology";
import Sigma from "sigma";
import { parse } from "graphology-gexf/browser";
const text = await (await fetch("network.gexf")).text();
const graph = parse(Graph, text);
new Sigma(graph, document.getElementById("container")!);
지원 차트 유형Supported Chart Types
Sigma.js는 노드와 엣지로 이루어진 네트워크 다이어그램 하나에 집중합니다. 방향 그래프와 무방향 그래프, 가중 엣지, 속성에 따른 노드 크기와 색, 엣지의 색과 두께를 지원하고, v4에서는 직선, 곡선, 계단형, 루프 엣지 경로가 기본으로 들어 있습니다.
Sigma.js focuses on one visualization type: the node-link network diagram. It supports directed and undirected graphs, weighted edges, node size and color by attribute, and edge color and thickness, and v4 includes straight, curved, step and loop edge paths out of the box.
동반 패키지로 이미지 노드, 테두리 노드, 파이 차트 노드를 그릴 수 있고, 지도 위에 그래프를 얹는 레이어도 있습니다. 검색, 필터, 호버 하이라이트, 이웃 탐색 같은 인터랙션은 이벤트와 graphology 기능으로 직접 구성합니다.
Companion packages add image nodes, bordered nodes and pie-chart nodes, and there are layers for placing a graph over a map. Interactions such as search, filtering, hover highlight and neighbor exploration are built by hand from events and graphology features.