Documentation / @finchart/core / Series

Interface: Series<T>

Defined in: packages/core/src/series/types.ts:61

같은 무대(Plot) 위에서 교체되는 데이터 표현.

그리드·축·pan/zoom·레이어는 Plot 소유이므로 시리즈가 바뀌어도 그대로다. 시리즈가 책임지는 건 두 가지뿐이다 — y축을 얼마나 차지하는가, 어떻게 그리는가.

Type Parameters

T

T extends BaseDataPoint = BaseDataPoint

Properties

coordinates?

readonly optional coordinates?: CoordinateAccessor<T>

Defined in: packages/core/src/series/types.ts:87

자기 점에서 좌표를 읽는 법. 생략하면 x·y를 그대로 읽는다. decimation과 같은 이유로 여기 있다 — 캔들의 값은 close인데 (OHLC에는 y가 없다) 그걸 아는 것은 캔들뿐이다.

---

decimation?

readonly optional decimation?: DecimationPolicy<T>

Defined in: packages/core/src/series/types.ts:80

이 표현에 맞는 솎기 정책. 생략하면 배선이 정한다 — 시리즈의 세 번째 책임이다. 캔들은 솎아내는 것이 아니라 합쳐야 하고(구간의 고가·저가가 사라진다) 픽셀당 하나가 상한이다. 등록이 덮어쓸 수 있다 (SeriesRegistration.decimation).

Methods

draw()

draw(target, context): void

Defined in: packages/core/src/series/types.ts:72

Parameters

target

DrawTarget

context

SeriesContext<T>

Returns

void

---

valueExtent()

valueExtent(data): Range | null

Defined in: packages/core/src/series/types.ts:70

이 표현이 y축에서 차지하는 범위. 라인은 점 하나라 min === max지만, 캔들은 low~high 구간을 차지한다 — 숫자 하나로는 표현할 수 없어서 Range를 돌려준다.

잴 것이 없으면 null이다 — { min: 0, max: 0 }을 내면 아직 안 도착한 시리즈가 값 축을 0으로 끌어당긴다.

Parameters

data

T[]

Returns

Range | null