라인 차트
대규모로 선, 스텝, 범위, 점, 막대 및 누적 영역을 렌더링합니다.
프레임워크 빠른 시작
같은 선 차트를 여섯 가지 방식으로 렌더링
명령형 TypeScript API 또는 얇은 프레임워크 어댑터를 선택하세요. 모든 탭은 같은 타입 배열 데이터와 차트 옵션을 사용합니다.@sixtyfold/lineimport { LineChart } from "@sixtyfold/line";
const data = {
x: new Float64Array([0, 1, 2, 3]),
y: new Float64Array([3, 7, 4, 9]),
length: 4,
};
const canvas = document.querySelector<HTMLCanvasElement>("#chart")!;
const chart = new LineChart(canvas, {
renderMode: "auto",
axis: { bottom: { format: "time" } },
series: [{ name: "Signal", color: "#4ecca3" }],
});
await chart.initialize();
chart.setData(data);
window.addEventListener("pagehide", () => chart.destroy(), { once: true });@sixtyfold/line는 하나의 정렬된 X 열에 대해 여러 시리즈를 렌더링합니다. 시리즈는 축, 상호작용 및 툴팁을 공유하는 동안 독립적으로 선, 스텝, 범위, 산점, 막대 또는 누적-영역 기하를 사용할 수 있습니다.
정확한 구성과 메서드 시그니처는 생성된 Line options, LineChart methods 및 line data types 참조에 나와 있습니다.
시리즈 기하학
SeriesOptions에는 일반 이름, 색상, 너비, 단위, 채우기 및 마커 필드가 포함됩니다. 기하학별 옵션은 관련 없는 설정이 모호해지지 않도록 band, point, bar 및 stack 아래에 있습니다.
범위 데이터
chart.setMultiSeriesData({
x,
series: [
{ low: temperatureMin, high: temperatureMax },
temperatureMean,
],
length: x.length,
seriesCount: 2,
});진정한 집계가 (low + high) / 2이 아닐 때는 명시적인 평균 시리즈를 사용하십시오. 봉투만으로 의도한 정보를 전달할 경우 범위 중심 스트로크를 0의 시리즈 너비로 숨기고 경계는 band.borderWidth: 0로 비활성화하십시오.
상세도 (LOD)
LOD는 상세도를 의미합니다. 이는 차트가 훨씬 큰 데이터셋의 화면 크기 표현을 먼저 그린 다음 확대할 때 더 세부적인 내용을 드러내게 합니다. 기본 adaptive 정책은 정렬된 끝점, 극값 및 실제 NaN 간격을 보존합니다. 대부분의 애플리케이션은 기본값을 유지해야 합니다.
적응형 그리드는 애니메이션과 관련 없는 재렌더링을 거치는 동안에도 안정적입니다. 현재 상세도 수준을 충분히 벗어나는 연속적인 확대/축소 동작 이후에만 변경됩니다.
const chart = new LineChart(canvas, {
lod: {
mode: "adaptive",
density: 0.75,
rebaseRatio: 1.25,
quantizationStep: 0.25,
},
});rebaseRatio와 quantizationStep을 함께 조정하십시오. 더 부드러운 변경을 위해 1 + quantizationStep 근처에서 시작하고, 예를 들어 1.10–1.12을 0.10와 함께 사용하십시오. 시각적으로 민감한 다중 패스 범위 밴드는 0.05와 1.06–1.08의 이점을 볼 수 있습니다; 대상 브라우저와 디바이스 픽셀 비율에서 비용을 측정하십시오.
차트를 재구성하거나 계층을 재빌드하지 않고 정책을 패치하십시오:
chart.setLODOptions({ density: 0.75, rebaseRatio: 1.12, quantizationStep: 0.1 });mode: "pyramid"는 사전 구축된 전역 최소/최대 레벨 중에서 선택합니다. 누적 영역(스택드 에어리어)은 각 입력을 독립적으로 축소하면 누적 기하가 변경되므로 항상 이 경로를 사용합니다.
표시 및 외형
chart.setSeriesVisible(2, false);
chart.setVisibleSeries([0, 1]);
chart.updateSeriesAppearance(0, { color: "#ffe47a", width: 2 });
chart.setSeriesVisibilityCallback((event) => {
console.log(event.source, event.visibility);
});표시 콜백은 초기화, API 또는 대화형 범례에서 시작된 변경을 식별합니다. legend.allowHideAll는 내장 범례가 최종 표시 시리즈를 숨길 수 있는지를 제어합니다.
스트리밍
initialize() 후에 양의 정수 차원을 가진 고정 용량 스트림을 생성하십시오:
chart.initStreaming(2, 1_000_000);
chart.addVector(timestamp, [phaseL1, phaseL2]);addVector는 유한한 타임스탬프와 구성된 각 시리즈당 하나의 값을 요구합니다. 큐에 넣기 전에 스칼라 값을 복사하므로 호출자는 해당 배열을 즉시 재사용할 수 있습니다. 타임스탬프는 오름차순으로 유지하십시오; 누락된 Y 값에는 NaN를 사용하고, 타임스탬프에는 사용하지 마십시오.
기존 Float64Array 열에는 addVectors(timestamps, valuesBySeries)를 사용하십시오. 구성된 각 시리즈마다 하나의 열을 제공하고, 각 열은 타임스탬프 길이에 맞아야 하며 타임스탬프는 유한해야 합니다. 검증은 큐에 넣은 스칼라 샘플이 플러시되거나 버퍼가 전달되기 전에 완료됩니다. 따라서 검증 실패는 큐를 변경하지 않고 호출자 버퍼를 그대로 보유합니다.
유효한 스칼라 및 벌크 추가는 호출 순서를 유지합니다. 링 버퍼는 래핑 후에도 연대기적 표시를 유지하며, LOD 구성은 추가가 계속되는 동안 완료될 수 있습니다. initStreaming를 다시 호출하면 이전 스트림의 큐에 있는 샘플이 폐기됩니다. 스트리밍을 재설정하거나 데이터를 교체하면 이전 데이터세트의 보류 중인 뷰포트 애니메이션도 취소됩니다.
애니메이션 교체
setData와 setMultiSeriesData은 애니메이션이 활성화되면 왼쪽에서 오른쪽으로 새 시리즈를 드러냅니다. preservePreviousFrame: true은 새 드러냄 경계 앞에서 이전 플롯을 유지합니다. 이를 사용하려면 앞선 드러냄이 완료된 후에만 사용하고, 미리보기를 전체 데이터셋으로 교체할 때 뷰포트를 즉시 복원하십시오.