MPAndroidChart的使用

MPAndroidChart 時Android軟件中常用的開源圖表庫。利用它可以繪製各類統計圖表，包括線型圖、餅圖、柱狀圖等。

它的github地址是：https://github.com/PhilJay/MPAndroidChart

1. 線型圖簡單使用

在項目中有用到線型圖用於實時顯示曲線。現對其的使用過程進行總結。

在使用MPAndroidChart的線型圖時，使用到的控件：

<com.github.mikephil.charting.charts.LineChart
	android:id="@+id/chart_test_temperature"
	android:layout_width="match_parent"
	android:layout_height="match_parent"/>

使用到的類主要有LineChart、XAxis、YAxis、LineDataSet、LineData。

• LineChart類爲線形圖對象，通過findViewById方法獲取；
• XAxis類爲線形圖的橫軸；
• YAxis類爲線型圖的縱軸；
• LineData爲線形圖的所有曲線數據集；
• LineDataSet爲線形圖某條曲線的數據集；

關於MPAndroidChart的線型圖的使用過程，我將其分爲以下幾個步驟：

1.1 線型圖整體設置

線型圖的整體設置主要是設置圖標的一些特性，包括：背景、縮放、拖拽等特性。

首先先獲取一個LineChart對象：

LineChart lineChart=(LineChart) activity.findViewById(R.id.chart_test_result);

然後對該對象進行設置，包括（不僅限於）以下幾個特性：

private void chartStyleSettings(LineChart lineChart) {
	lineChart.setTouchEnabled(true); 
	lineChart.setDragEnabled(true);// 可拖曳
	lineChart.setScaleEnabled(true);// 可縮放
	lineChart.setPinchZoom(true);
	lineChart.setBackgroundColor(backgroundColor);// 設置圖表的背景顏色
	lineChart.setDrawGridBackground(false);
	lineChart.setNoDataText("");//沒有數據時顯示的文字
	lineChart.setNoDataTextDescription("");
	lineChart.getLegend().setEnabled(false);//取消圖例
	lineChart.setDescription("");//取消描述
}

1.2 座標軸設置

在MPAndroidChart的線型圖中，有三個座標軸，分別是X軸，Y左軸，Y右軸。分別對其進行設置，包括字體大小、是否顯示燈，如下：

XAxis xAxis;
YAxis yAxisLeft;
YAxis yAxisRight;
xAxis=lineChart.getXAxis();//獲取X軸對象
yAxisLeft=lineChart.getAxisLeft();//獲取左側Y軸對象
yAxisRight=lineChart.getAxisRight();//獲取右側Y軸對象

xAxis.setTextSize(16f);
xAxis.setPosition(XAxisPosition.BOTTOM);//設置座標位置，默認爲在上端
yAxisLeft.setTextSize(16f);//設置字體大小
yAxisRight.setEnabled(false);//隱藏

1.3 增加線型圖數據

在MPAndroidChart中，與線型圖數據相關的類有LineDataSet和LineData。
在使用過程中，我將這兩個類理解爲：

• LineData爲這個LineChart的所有數據；
• LineDataSet爲LineChart中某條曲線相關的屬性；
• LineDataSet中，數據的添加通過addEntry()方法實現；
• 通過LineData類的addDataSet方法將某條曲線的LineDataSet添加到LineChart中；

在MPAndroidChart的線型圖中，其橫座標表示的是一個List<String>集合，即每個刻度表示的是一個字符串，不是一個數字。
而每個點的縱座標採用List<Entry>集合表示，Entry表示的是一個float型的數。
橫縱座標是通過List中的元素位置一一對應的。

1.4 針對每條曲線進行設置

對每條曲線的設置（粗細、顏色、樣式等）是通過曲線的LineDataSet對象實現的，常用的設置如下：

ArrayList<Entry> entries = new ArrayList<Entry>();
LineDataSet lineDataSet = new LineDataSet(entries, "a");
//設置線條顏色
lineDataSet.setColor(Color.RED);
//設置座標點顏色
lineDataSet.setCircleColor(Color.RED);
//設置線寬
lineDataSet.setLineWidth(3f);
//設置是否顯示座標點
lineDataSet.setDrawCircles(false);
//設置線型（曲線擬合true或折線false）
lineDataSet.setDrawCubic(true);
//設置曲線值的圓點是實心還是空心
lineDataSet.setDrawCircleHole(false);
lineDataSet.setValueTextSize(10f);
//設置折線圖填充
lineDataSet.setDrawFilled(false);
//不顯示數字
lineDataSet.setDrawValues(false);

1.5 顯示線型圖/更新線型圖

當設置好上面的幾項後，即可將線型圖顯示出來：

LineData lineData=lineChart.getLineData();
if(lineData == null) {
	lineChart.setData(new LineData(xValue, lineDataSet));//xValue爲橫座標List<String>，lineDataSet爲1.3和1.4所說的某條曲線
}
else {
	lineChartLineData.addDataSet(lineDataSet);//對於已經存在的線型圖，使用該方法進行曲線添加
}

如果要動態更新曲線，可以使用以下方法添加數據：

Entry entry = new Entry(newData, lineDataSet.getEntryCount());//第一個參數爲添加的數據，float型；第二個參數時添加的位置，該寫法表示添加到末尾
lineChart.getData().addEntry(entry, 0);//第二個參數表示將新的entry添加到的指定的曲線
//更新曲線
lineChart.notifyDataSetChanged();
lineChart.invalidate();

通過以上過程即可完成線型圖的繪製。