데이터 모델 및 소유권

타입드 배열 형태, 검증 규칙, 결측치 및 Worker로의 소유권 이전

Sixtyfold는 수백만 개의 행 객체로 전달하는 대신 각 숫자 필드를 고유한 Float64Array로 받습니다. 이러한 열 형태는 Worker로의 전송과 렌더링을 예측 가능하게 합니다.

아래 형태들은 line 메서드과 stock 메서드이 허용하는 입력입니다.

선형 데이터

단일 시리즈 데이터셋은 하나의 정렬된 X 열과 하나의 Y 열을 가집니다:

interface TimeSeriesData {
  x: Float64Array;
  y: Float64Array;
  length: number;
}

다중 시리즈 데이터는 모든 시리즈에서 X를 공유합니다:

interface MultiSeriesData {
  x: Float64Array;
  series: Array<Float64Array | {
    low: Float64Array;
    high: Float64Array;
    y?: Float64Array;
  }>;
  length: number;
  seriesCount: number;
}

범위 객체는 range 또는 band 시리즈에만 사용하십시오. low와 high는 외피를 정의하며, 선택적 y는 그 명시적 중심 스트로크를 제공합니다. 합성된 중간점이 오해의 소지가 있을 경우 y를 생략하거나 시리즈 폭을 0으로 설정하십시오.

X 값은 유한하고 오름차순이어야 합니다. 타임스탬프는 일반 숫자이며 epoch 밀리초가 관례적이지만 필수는 아닙니다. minViewportRange, 뷰포트 값, 마커 타임스탬프 및 기타 모든 X-도메인 옵션은 X와 동일한 단위를 사용합니다.

실제 누락 관측치에는 Y, range-low 또는 range-high 배열에서 NaN을 사용하십시오. 연결된 렌더러는 간격을 통해 그리지 않고 경로를 끊습니다.

OHLCV 데이터

interface OHLCVData {
  timestamp: Float64Array;
  open: Float64Array;
  high: Float64Array;
  low: Float64Array;
  close: Float64Array;
  volume: Float64Array;
  length: number;
}

여섯 개의 열은 모두 동일한 길이여야 합니다. StockChart.setData은 타임스탬프 열에서 유효 길이를 결정하고 유한하며 단조롭게 오름차순 또는 내림차순인 타임스탬프를 검증하기 위해 normalizeOHLCVData을 사용합니다. 정적 이력에는 동일한 타임스탬프가 허용됩니다. 오름차순 입력은 배열을 그대로 유지하고, 내림차순 입력은 호출자를 변경하지 않고 복사하여 역순으로 만듭니다.

타임스탬프를 규칙적으로 만들기 위해 거래소 폐쇄나 누락된 피드 간격을 합성하지 마십시오. timeScale: "market"는 레이블, 이벤트 및 마커가 실제 타임스탬프를 유지하는 동안 누락된 간격을 시각적으로 압축합니다.

버퍼 소유권

Worker 모드에서는 대량 setData, setMultiSeriesData, addVectors, StockChart.setData 및 주식 배치 API가 최적 경로를 위해 타입화된 배열 버퍼를 렌더러로 전송합니다. 전송된 버퍼는 분리(detached)되며 호출자가 읽거나 재사용해서는 안 됩니다.

애플리케이션이 자체 복사본을 유지해야 할 경우 명시적으로 복제하십시오:

chart.setData({
  x: sourceX.slice(),
  y: sourceY.slice(),
  length: sourceX.length,
});

소유권을 유지하려면 메인 스레드 폴백 동작에 의존하지 마십시오. 대량 입력은 해결된 렌더러와 무관하게 이전된 것으로 취급하여 브라우저 변경이나 CSP 정책 변경이 애플리케이션의 정확성에 영향을 주지 않도록 하십시오.

스트리밍

라인 스트리밍은 initStreaming(seriesCount, maxPoints)으로 초기화된 고정 크기 링 버퍼를 사용합니다. 스톡 스트리밍은 initStreaming(maxCandles)을 사용합니다. 용량과 라인 시리즈 수는 양의 정수여야 합니다. 용량에 도달하면 가장 오래된 관측값이 교체되며 연대기적 렌더링은 유지됩니다.

데이터가 이미 열 단위로 도착할 때는 벡터 또는 캔들 배치 메서드를 사용하십시오. 단일 관측 메서드는 requestAnimationFrame을 통해 배치하며 대량 추가와의 상대적 순서를 유지합니다. 라인 addVector은 큐에 넣기 전에 값을 복사하므로 스칼라 값 배열을 즉시 재사용할 수 있습니다.

라인 추가에는 유한한 타임스탬프와 정렬된 시리즈 열이 필요합니다. X는 오름차순을 유지해야 하며 결측은 Y 열에만 표시해야 합니다. 스톡 추가의 경우 호출 간, 대기 중인 캔들, 및 각 청크에 대해 타임스탬프가 엄격히 증가해야 하며 타임스탬프를 반복하는 것은 업데이트 작업이 아닙니다.

대량 유효성 검사는 대기 샘플을 플러시하거나 입력을 전송하기 전에 실행됩니다. 길이 또는 타임스탬프가 거부되면 보류 중인 샘플은 변경되지 않고 호출자 버퍼는 연결된 상태를 유지합니다; addCandleBatches는 어느 것을 전송하기 전에 모든 청크를 검증합니다. 이러한 검사들은 단위, 가격, 거래량 또는 기타 피드 의미론에 대한 애플리케이션 측 검증을 대체하지 않습니다. 방법별 계약은 Line streaming 및 Stock streaming을 참조하십시오.