MPAndroidChart 教程:设置数据 Setting Data

简介: 本章主题是介绍为各种图表设置数据线型图如果要将值(数据)添加到图表中,则必须通过public void setData(ChartData data) { ... }基类ChartData(ChartData)类封装了呈现期间图表所需的所有数据和信息。

本章主题是介绍为各种图表设置数据

线型图

如果要将值(数据)添加到图表中,则必须通过

public void setData(ChartData data) { ... }

基类ChartData(ChartData)类封装了呈现期间图表所需的所有数据和信息。对于每种类型的图表,存在应该用于设置图表数据的不同子类ChartData(例如LineData)。在构造函数中,您可以将一个List<? extends IDataSet>作为要显示的值移交。下面是类LineData(extends ChartData)的示例,用于将数据添加到LineChart:

 /** List constructor */
    public LineData(List<ILineDataSet> sets) { ... }

    /** Constructor with one or multiple ILineDataSet objects */
    public LineData(ILineDataSet...) { ... }

那么,什么是DataSet,需要它的原因是什么?这实际上非常简单。一个DataSet对象表示Entry图表中属于一起的一组条目(例如,类条目)。它旨在逻辑上分离图表中的不同值组。对于每种类型的图表,存在允许特定样式的扩展DataSet(例如LineDataSet)的不同对象。

例如,您可能希望在一年内显示两年内两家公司的季度收入LineChart。在这种情况下,建议创建两个不同的LineDataSet对象,每个对象包含四个值(每个季度一个)。

当然,也可以只提供一个LineDataSet包含两个公司的所有8个值的对象。

那么如何设置LineDataSet对象呢?

public LineDataSet(List<Entry> entries, String label) { ... }

当查看构造函数(不同的构造函数可用)时,可以看到LineDataSet需要一个类型为Entry的List和一个用于描述LineDataSet的String以及一个用于Legend的标签。此外,该标签可用于在LineData对象中的其他LineDataSet对象中查找LineDataSet。

Entry类型列表封装了图表的所有值。Entry对象是图表中具有x值和y值的条目的附加包装器:

public Entry(float x, float y) { ... }

总而言之(两家公司的季度收入超过一年的例子):

首先,创建将保存您的值的Entry类型列表:

   List<Entry> valsComp1 = new ArrayList<Entry>();
   List<Entry> valsComp2 = new ArrayList<Entry>();

然后,用Entry对象填充列表。确保条目对象包含x轴的正确索引。(当然,这里可以使用循环,在这种情况下,循环的计数器变量可以是x轴上的索引)。

    Entry c1e1 = new Entry(0f, 100000f); // 0 == quarter 1
    valsComp1.add(c1e1);
    Entry c1e2 = new Entry(1f, 140000f); // 1 == quarter 2 ...
    valsComp1.add(c1e2);
    // and so on ...
    
    Entry c2e1 = new Entry(0f, 130000f); // 0 == quarter 1
    valsComp2.add(c2e1);
    Entry c2e2 = new Entry(1f, 115000f); // 1 == quarter 2 ...
    valsComp2.add(c2e2);
    //...

现在我们有了Entry对象列表,可以创建LineDataSet对象:

   LineDataSet setComp1 = new LineDataSet(valsComp1, "Company 1");
    setComp1.setAxisDependency(AxisDependency.LEFT);
    LineDataSet setComp2 = new LineDataSet(valsComp2, "Company 2");
    setComp2.setAxisDependency(AxisDependency.LEFT);

通过调用setAxisDependency(...),DataSet指定应绘制的轴。最后但同样重要的是,我们创建了一个IDataSets列表并构建了我们的ChartData对象:

   // use the interface ILineDataSet
    List<ILineDataSet> dataSets = new ArrayList<ILineDataSet>();
    dataSets.add(setComp1);
    dataSets.add(setComp2);
    
    LineData data = new LineData(dataSets);
    mLineChart.setData(data);
    mLineChart.invalidate(); // refresh

调用invalidate()图表后刷新并绘制提供的数据。

如果我们想要为x轴添加更多描述性值(而不是不同季度的0到3之间的数字),我们可以通过使用IAxisValueFormatter接口来实现。此接口允许自定义XAxis上绘制的值的样式。在此示例中,formatter可能如下所示:

// the labels that should be drawn on the XAxis
final String[] quarters = new String[] { "Q1", "Q2", "Q3", "Q4" };

IAxisValueFormatter formatter = new IAxisValueFormatter() {

    @Override
    public String getFormattedValue(float value, AxisBase axis) {
        return quarters[(int) value];
    }

    // we don't draw numbers, so no decimal digits needed
    @Override
    public int getDecimalDigits() {  return 0; }
};

XAxis xAxis = mLineChart.getXAxis();
xAxis.setGranularity(1f); // minimum axis-step (interval) is 1
xAxis.setValueFormatter(formatter);

有关IAxisValueFormatter界面的详细信息,请参见此处

如果应用了其他样式,此示例生成的LineChart应类似于下面的那个:

设置标准BarChart,ScatterChart,BubbleChart和CandleStickChart的数据类似于LineChart。一个特例是BarChart带有多个(分组)条形,下面将对其进行说明。

条目的顺序

请注意,此库没有正式支持从未按条目的x位置升序方式排序的LineChart的Entry列表中绘制数据。以未排序的方式添加条目可能会正确绘制,但也可能导致意外行为。List的Entry对象可以使用手动进行排序或使用EntryXComparator:

List<Entry> entries = ...; Collections.sort(entries, new EntryXComparator());

之所以需要这样做是因为该库使用二进制搜索算法以获得更好的性能,仅用于排序列表。

BarChart

为BarChart设置数据的方式与LineChart非常相似。主要区别是需要用于设置数据的数据对象(例如,BarEntry而不是Entry)。除此之外,BarChart还有不同的类型选择。

请考虑以下填充BarChart数据的示例:

List<BarEntry> entries = new ArrayList<>();
entries.add(new BarEntry(0f, 30f));
entries.add(new BarEntry(1f, 80f));
entries.add(new BarEntry(2f, 60f));
entries.add(new BarEntry(3f, 50f)); 
                                    // gap of 2f
entries.add(new BarEntry(5f, 70f));
entries.add(new BarEntry(6f, 60f));

BarDataSet set = new BarDataSet(entries, "BarDataSet");

在上面的示例中,BarEntry创建了五个对象并将其添加到一个 BarDataSet。请注意,第四个和第五个条目之间的x位置存在“2”的间隙。在这个例子中,这个间距用于解释BarChart中柱的定位是如何工作的。本教程末尾的屏幕截图将显示BarChart给定数据的结果。下一步,BarData需要创建一个对象:

BarData data = new BarData(set);
data.setBarWidth(0.9f); // set custom bar width
chart.setData(data);
chart.setFitBars(true); // make the x-axis fit exactly all bars
chart.invalidate(); // refresh

在上面的代码片段中,创建了一个BarData对象。创建图表的BarEntry对象时,我们在每个条形(中心)之间的x轴上留下了“1f”的空间。通过将条宽设置为0.9f,我们有效地在每个条之间创建0.1f的空间。该setFitBars(true)调用将告诉图表调整其x轴值的范围以完全适合所有条形,并且两侧不会切断条形。

创建BarData对象后,我们将其设置为图表并刷新。结果应该看起来接近下面显示的结果:

Grouped BarChart

从版本v3.0.0开始,MPAndroidChart支持明确分组的绘图条(在这种情况下,库将处理x位置)或用户定义,这意味着用户可以通过更改x轴位置将条型放置在他想要的任何位置。

本节将重点介绍显式分组BarChart,这意味着库将处理条形的x轴位置。请考虑以下示例设置:

YourData[] group1 = ...;
YourData[] group2 = ...;

List<BarEntry> entriesGroup1 = new ArrayList<>();
List<BarEntry> entriesGroup2 = new ArrayList<>();

// fill the lists
for(int i = 0; i < group1.length; i++) {
    entriesGroup1.add(new BarEntry(i, group1.getValue()));
    entriesGroup2.add(new BarEntry(i, group2.getValue()));
}

BarDataSet set1 = new BarDataSet(entriesGroup1, "Group 1");
BarDataSet set2 = new BarDataSet(entriesGroup2, "Group 2");

在这个示例中,我们将有两组条形图,每个都由一个单独的BarDataSet表示。在显式(库处理)组的情况下,条目的实际x位置无关紧要。基于条目列表中BarEntry的位置执行分组。

float groupSpace = 0.06f;
float barSpace = 0.02f; // x2 dataset
float barWidth = 0.45f; // x2 dataset
// (0.02 + 0.45) * 2 + 0.06 = 1.00 -> interval per "group"

BarData data = new BarData(set1, set2);
data.setBarWidth(barWidth); // set the width of each bar
barChart.setData(data);
barChart.groupBars(1980f, groupSpace, barSpace); // perform the "explicit" grouping
barChart.invalidate(); // refresh

在上面的代码片段中,BarDataSet对象被添加到一个BarChart。该groupBars(...)方法执行两个BarDataSet对象的分组。该方法采用以下参数:

public void groupBars(float fromX, float groupSpace, float barSpace) { ... }

fromX参数确定XAxis分组条的起始位置(在本例中为“1980”),groupSpace确定每组条之间留下的空间,barSpace确定组中各个条之间的间距。基于这些参数,该groupBars(...)方法改变每个条形XAxis朝向分组外观的位置,保持各个BarEntry对象的顺序。

每个组在XAxis上具有的“间隔”(占用空间)也由groupSpace和barSpace参数以及barWidth定义。

效果应该看起来像这样:

 

当然,也可以在不使用groupBars(...)方法的情况下实现BarChart的分组,只需手动将各个条正确放置在XAxis上即可。

为了确保XAxis的标签位于组上方,如上面的屏幕截图所示,您可以使用以下setCenterAxisLabels(...)方法:

XAxis xAxis = chart.getXAxis();
xAxis.setCenterAxisLabels(true);

Stacked BarChart

堆叠的BarChart设置与普通的BarChart完全相似,但创建单个BarEntry对象的方式除外。如果是堆叠条形,则必须使用BarEntry的不同构造函数:

public BarEntry(float x, float [] yValues) { ... }

此构造函数允许提供多个yValues,表示每个条的“堆栈”的值。请考虑以下示例对象:

BarEntry stackedEntry = new BarEntry(0f, new float[] { 10, 20, 30 });

BarEntry由三个值组成,具有“高度”为“10”,“20”和“30”。

PieChart

与其他图表类型不同,PieChart以PieEntry对象的形式获取数据。这些对象的构造函数如下所示:

public PieEntry(float value, String label) { ... }

构造函数的第一个参数用于实际的“值”,该值应该作为PieChart中的饼图绘制。名为“label”的第二个String参数用于提供切片的其他描述。请考虑以下PieChart示例设置:

List<PieEntry> entries = new ArrayList<>();

entries.add(new PieEntry(18.5f, "Green"));
entries.add(new PieEntry(26.7f, "Yellow"));
entries.add(new PieEntry(24.0f, "Red"));
entries.add(new PieEntry(30.8f, "Blue"));

PieDataSet set = new PieDataSet(entries, "Election Results");
PieData data = new PieData(set);
pieChart.setData(data);
pieChart.invalidate(); // refresh

PieEntry对象不保存x位置的值,因为图表中显示的PieEntry对象的顺序由它们在条目列表中的顺序确定。

添加一些额外的样式时,PieChart上面使用的数据结果可能类似于:

 

 

相关文章
|
7月前
|
索引
filebeat 设置索引的 max_result_window
在 Filebeat 中设置索引的 max_result_window 需要修改 Elasticsearch 的索引模板。max_result_window 参数定义了在 Elasticsearch 中执行搜索时,最大返回文档的数量。默认情况下,该值为 10000。 要修改该值,可以按照以下步骤操作: 打开 Filebeat 的配置文件。 找到输出部分,其中定义了 Elasticsearch 输出。 在 Elasticsearch 输出配置中,找到索引模板相关的配置。 确保你已经定义了自定义的索引模板(如果没有,请创建一个)。 在索引模板中,设置 max_result_window 参数为
116 1
|
7月前
|
Shell Android开发 开发者
Android系统 自定义动态修改init.custom.rc
Android系统 自定义动态修改init.custom.rc
387 0
页面中的位置:client、page、screen、offset、以及元素视图位置的区别和方法
页面中的位置:client、page、screen、offset、以及元素视图位置的区别和方法
|
7月前
|
XML Java 数据格式
面试题:怎样把所有的组件的lazy-init值都设置为默认true?
面试题:怎样把所有的组件的lazy-init值都设置为默认true?
52 0
|
Docker 容器
dockers --cap-add 哪些值可以设置
`--cap-add` 参数可以用于向 Docker 容器添加不同的权限。除了 `NET_ADMIN`,还有一些其他常用的权限值,包括: 1. `SYS_ADMIN`:添加系统管理员权限,允许容器内的进程执行系统级别的管理操作,如挂载文件系统、设置时间、修改主机名等。 2. `SYS_PTRACE`:添加系统追踪权限,允许容器内的进程使用 `ptrace` 系统调用,用于调试和监视其他进程。 3. `SYS_CHROOT`:添加切换根目录权限,允许容器内的进程使用 `chroot` 系统调用,在指定的目录下创建一个新的根文件系统环境。 4. `SYS_MODULE`:添加模块加载/卸载
807 1
|
数据可视化 定位技术 数据格式
Eccharts加载geojson环形GeometryCollection格式的解决方案:Cannot read property ‘length‘ of undefined
Eccharts加载geojson环形GeometryCollection格式的解决方案:Cannot read property ‘length‘ of undefined
226 0
|
存储 算法 API
|
IDE Java API
Gradle | 全局配置、Log开关控制、Build Variant、meta-data等配置
Gradle是一个先进的构建系统,也是一个允许通过插件创建自定义构建逻辑先进的构建工具。
482 0
|
存储
使用Dynamic Data Display控件绘图时无法删除已经画好的曲线
最近在使用Dynamic Data Display画图的时候发现,多次画图时,之前画的图无法清除,造成图像混乱。找了好久发现这样可以消除。 在调用AddLineGraph时,使用一个全局的变量来存储这个方法返回的对象(LineGraph), 点击...
923 0
|
XML Android开发 数据格式
Android逆向:二进制xml文件解析(Start Tag Chunk)
在Android中,xml文件经过编译后都是不可读的二进制文件。今天我们来解析一下这个二进制文件的内容,看看如何与我们的源码进行对应。
524 0