添加數據的方法

---

立即下載LightningChart JS

本指南主要是關于ChartXY的，其他圖表類型的數據輸入方法可能略有不同。

添加

大多數ChartXY特性都使用XY坐標列表，在最簡單的層次上這些可以定義并推入級數，如下所示：

const dataSet = [ 
{ x: 0, y: 10 }, 
{ x: 1, y: 12 }, 
{ x: 2, y: 15 }, 
] 
const lineSeries = chart.addLineSeries({ dataPattern: { pattern: "ProgressiveX" } }) 
.add(dataSet)

但根據具體情況，不同的數據附加方法可能更方便。

addArrayY, addArrayX

這些方法只在一個軸上推送一個值列表，導致另一個維度被自動“索引”，例如：

lineSeries.addArrayY([ 0, 10, 5, 8, 6 ]) 
// same as add([ { x: 0, y: 0 }, { x: 1, y: 10 }, { x: 2, y: 5 }, { x: 3, y: 8 }, { x: 4, y: 6 } ])

自動索引從最后一個X坐標開始，所以這些方法即使在實時用例中也可以很容易地使用：

setInterval(() => { 
lineSeries.addArrayY([ Math.random() ]) 
}, 1000)

此外，索引行為可以通過可選參數step和start來控制：

lineSeries.addArrayY([ 0, 10, 5, 8, 6 ], 0.1, 10) 
// same as add([ { x: 10, y: 0 }, { x: 10.1, y: 10 }, { x: 10.2, y: 5 }, { x: 10.3, y: 8 }, { x: 10.4, y: 6 } ])

addArrayX的行為與addArrayY完全相同，只是維度顛倒了(Y被自動索引，而不是X)。

addArraysXY

此方法可用于輸入X和Y值，但要從不同的列表中輸入，例如：

lineSeries.addArraysXY([0, 1, 2, 3], [10, 5, 8, 6]) 
// same as add([ { x: 0, y: 10 }, { x: 1, y: 5 }, { x: 2, y: 8 }, { x: 3, y: 6 } ])

如果你的數據是二進制格式，這是一個很好的方法：

// timestamps: Float32Array 
// measurements: Float32Array 
lineSeries.addArraysXY(timestamps, measurements)

LightningChart JS使用WebGL可視化數據，WebGL限制為32位浮點精度。如果您使用二進制格式傳輸數據(例如，使用WebSocket)，為了降低帶寬使用，將數據精度限制為32位替代完整的64位可能更好。

Clear

最后，可以使用clear()方法清除任何先前推送的數據，例如要完全覆蓋顯示的數據：

// myDataSet: Array<{ x: number, y: number }> 
lineSeries.clear().add(myDataSet)