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();

通过以上过程即可完成线型图的绘制。