라인 차트

대규모로 선, 스텝, 범위, 점, 막대 및 누적 영역을 렌더링합니다.

프레임워크 빠른 시작

같은 선 차트를 여섯 가지 방식으로 렌더링

명령형 TypeScript API 또는 얇은 프레임워크 어댑터를 선택하세요. 모든 탭은 같은 타입 배열 데이터와 차트 옵션을 사용합니다.
chart.ts@sixtyfold/line
import { 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 참조에 나와 있습니다.

시리즈 기하학

유형입력의도된 사용
lineFloat64Array직선 또는 구성된 보간으로 연속 관측.
step-before, step-after, step-midFloat64Array구간에 적용되는 값. step 별칭 step-after.
range{ low, high, y? }불확실성, 최소/최대, 백분위수 또는 다른 범위(envelope). band 는 동의어입니다.
scatterFloat64Array독립적인 점들. points 는 동의어입니다.
barFloat64Array구성 가능한 기준선에서 렌더링된 값들. column 는 동의어입니다.
stacked-areaFloat64Array누적 기하로 합산된 정렬된 기여들.

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,
  },
});
옵션기본값허용 범위의미
density0.750.25–2CSS 픽셀당 목표 표시 열 수. 더 많은 열은 지역 세부 정보를 보존하며 더 많은 작업 비용이 듭니다.
rebaseRatio1.251.05–2점착형 그리드가 변경되기 전의 최대 예상 폭 드리프트입니다.
quantizationStep0.250.05–1각 이진 옥타브 내부에서 사용 가능한 간격입니다. 더 작은 단계는 표현 변경을 더 미세하게 만듭니다.

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은 새 드러냄 경계 앞에서 이전 플롯을 유지합니다. 이를 사용하려면 앞선 드러냄이 완료된 후에만 사용하고, 미리보기를 전체 데이터셋으로 교체할 때 뷰포트를 즉시 복원하십시오.