aachartmodel / aachartcore Goto Github PK

📈📊☕️☕️☕️An elegant modern declarative data visualization chart framework for Android. Extremely powerful, supports line, spline, area, areaspline, column, bar, pie, scatter, angular gauges, arearange, areasplinerange, columnrange, bubble, box plot, error bars, funnel, waterfall and polar chart types.极其精美而又强大的 Android 数据可视化图表框架,支持柱状图、条形图、折线图、曲线图、折线填充图、曲线填充图、气泡图、扇形图、环形图、散点图、雷达图、混合图等各种类型的多达几十种的信息图图表,完全满足工作所需.

License: Apache License 2.0

Java 99.13% HTML 0.11% JavaScript 0.75%

charts column-chart bar-chart line-chart area-chart radar-chart hybrid webview chart pie-chart

aachartcore's Introduction

AAChartCore

English Document 🇬🇧 | 简体中文文档 🇨🇳

There is the link of Kotlin version of `AAChartCore` as follow

https://github.com/AAChartModel/AAChartCore-Kotlin

Preface

AAChartCore is the Java language version of AAChartKit which is object-oriented, a set of easy-to-use, extremely elegant graphics drawing controls,based on the popular open source front-end chart library Highcharts. It makes it very fast to add interactive charts to your mobile projects. It supports single touch-drag for data inspection, multi-touch for zooming, and advanced responsiveness for your apps .

Features

🎂 Environment friendly. Support all Android platforms. Totally support Java language, and there are more types version such as Kotlin language version AAInfographics、Swift language version AAChartKit-Swift 、 Objective-c language version AAChartKit . To get more details you can see the source code links list.
🚀 Powerful and easy to use. It supports column chart, bar chart, area chart, areaspline chart, line chart, spline chart, radar chart, polar chart, pie chart, bubble chart, pyramid chart, funnel chart, columnrange chart, arearange chart, mixed chart and other graphics. Support for more chart types is planned.
📝 Modern Declarative Syntax. Unlike previous imperative programming techniques, drawing any custom chart in AAChartKit, you don't need to care about the inner implementation details which is annoying && boring. Describe what you want, you will get what you described.
🎮 Interactive and animated. The charts animation effect is exquisite, delicate, smooth and beautiful.
⛓ Chain programming. Supports concise chain programming syntax .
🦋 Minimalist. AAChartView + AAChartModel = Chart. The AAChartKit follows a minimalist formula: Chart view + Chart model = The chart you want, just like the powerful and beautiful charts lib AAInfographics.
🖱 Interaction event callback. Support for monitoring user click events and single finger move over events, which can be used to achieve double charts linked-working and even multiple charts linkage, as well as other more complex custom user interaction effects.

Appreciation

Installation

JitPack (Recommend)

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    ...
    implementation 'com.github.AAChartModel:AAChartCore:-SNAPSHOT'
}

Usage

Creat the instance object of chart view:AAChartView

<com.github.AAChartModel.AAChartCore.AAChartCreator.AAChartView
    android:id="@+id/AAChartView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

aaChartView = findViewById(R.id.AAChartView)

Configure the properties of chart model:AAChartModel

AAChartModel aaChartModel = new AAChartModel()
    .chartType(AAChartType.Area)
    .title("THE HEAT OF PROGRAMMING LANGUAGE")
    .subtitle("Virtual Data")
    .backgroundColor("#4b2b7f")
    .categories(new String[]{"Java", "Swift", "Python", "Ruby", "PHP", "Go", "C", "C#", "C++"})
    .dataLabelsEnabled(false)
    .yAxisGridLineWidth(0f)
    .series(new AASeriesElement[]{
        new AASeriesElement()
            .name("Tokyo")
            .data(new Object[]{7.0, 6.9, 9.5, 14.5, 18.2, 21.5, 25.2, 26.5, 23.3, 18.3, 13.9, 9.6}),
        new AASeriesElement()
            .name("NewYork")
            .data(new Object[]{0.2, 0.8, 5.7, 11.3, 17.0, 22.0, 24.8, 24.1, 20.1, 14.1, 8.6, 2.5}),
        new AASeriesElement()
            .name("London")
            .data(new Object[]{0.9, 0.6, 3.5, 8.4, 13.5, 17.0, 18.6, 17.9, 14.3, 9.0, 3.9, 1.0}),
        new AASeriesElement()
            .name("Berlin")
            .data(new Object[]{3.9, 4.2, 5.7, 8.5, 11.9, 15.2, 17.0, 16.6, 14.2, 10.3, 6.6, 4.8})
    });

Draw the chart(This method is called only for the first time after you create an AAChartView instance object)

        //The chart view object calls the instance object of AAChartModel and draws the final graphic
        aaChartView.aa_drawChartWithChartModel(aaChartModel)

🌹🌹🌹Congratulations! Everything was done!!! You will get what you want!!!

Update chart content

if you want to refresh chart content,you should do something as follow.According to your actual needs, select the function that fits you.

Only refresh the chart data(This method is recommended to be called for updating the series data dynamically)

        //Only refresh the chart series data
        aaChartView.aa_onlyRefreshTheChartDataWithChartModelSeries(chartModelSeriesArray)

Refresh the chart, minus the chart data (this method is recommended for subsequent refreshes after the first drawing of graphics has completed. If you want to update the chart data only, you should use the function aa_onlyRefreshTheChartDataWithChartModelSeries)

        //Refresh the chart after the AAChartModel whole content is updated
        aaChartView.aa_refreshChartWholeContentWithChartModel(aaChartModel)

Infographics sample

line chart

column chart

bar chart

special area chart one

special area chart two

special area chart three

polar chart

radar chart

pie chart

bubble chart

scatter chart

arearange chart

step area chart

mixed chart

More graphics

Note: The following DEMO picture is a GIF dynamic picture which has a size of around 6M. If you don't see any dynamic preview, then this is because the picture resources were not fully loaded. In such a case please be patient and wait for the contents to finish loading. Maybe you need to reload this page.

Special instructions

Support user click events and move over events

you can monitor the user touch events message through implementing delegate function for AAChartView instance object

      public interface AAChartViewCallBack {
        void chartViewMoveOverEventMessage(AAChartView aaChartView, AAMoveOverEventMessageModel messageModel);
    }

The received touch events message contain following content

public class AAMoveOverEventMessageModel {
    public String name;
    public Double x;
    public Double y;
    public String category;
    public LinkedTreeMap offset;
    public Double index;
}

Support for custom the style of chart `AATooltip` through `JavaScript` function

As we all know, AAInfographics support using HTML String. Most of time, the headerFormat 、pointFormat、footerFormat HTML string is enough for customizing chart tooltip string content, However, sometimes the needs of APP is so weird to satified, in this time, you can even customize the chart tooltip style through JavaScript function.

For example, configuring AATooltip instance object properties as follow:

    AATooltip aaTooltip = new AATooltip()
                .useHTML(true)
                .formatter(" function () {\n" +
                        "        return ' 🌕 🌖 🌗 🌘 🌑 🌒 🌓 🌔 <br/> '\n" +
                        "        + ' Support JavaScript Function Just Right Now !!! <br/> '\n" +
                        "        + ' The Gold Price For <b>2020 '\n" +
                        "        +  this.x\n" +
                        "        + ' </b> Is <b> '\n" +
                        "        +  this.y\n" +
                        "        + ' </b> Dollars ';\n" +
                        "        }")
                .valueDecimals(2)
                .backgroundColor("#000000")
                .borderColor("#000000")
                .style(new AAStyle()
                        .color("#FFD700")
                        .fontSize("12 px")
                );

you can get the customized tooltip style chart like this👇

Support value range segmentation

chart with value range segmentation bands 🎀
chart with value range segmentation lines 🧶
chart with value range segmentation zones 🧱

Support scrolling update chart data

Support data sorting with animation effect

Supported chart type for now

   public interface AAChartType {
        String Column          = "column";
        String Bar             = "bar";
        String Area            = "area";
        String AreaSpline      = "areaspline";
        String Line            = "line";
        String Spline          = "spline";
        String Scatter         = "scatter";
        String Pie             = "pie";
        String Bubble          = "bubble";
        String Pyramid         = "pyramid";
        String Funnel          = "funnel";
        String Columnrange     = "columnrange";
        String Arearange       = "arearange";
        String Areasplinerange = "areasplinerange";
        String Boxplot         = "boxplot";
        String Waterfall       = "waterfall";
    }

Supported zoom guesture types for now

    public interface AAChartZoomType {
        String None = "none";
        String X  = "x";
        String Y  = "y";
        String XY = "xy";
    }

Supported animation type for now

   public interface AAChartAnimationType {
        String EaseInQuad     = "easeInQuad";
        String EaseOutQuad    = "easeOutQuad";
        String EaseInOutQuad  = "easeInOutQuad";
        String EaseInCubic    = "easeInCubic";
        String EaseOutCubic   = "easeOutCubic";
        String EaseInOutCubic = "easeInOutCubic";
        String EaseInQuart    = "easeInQuart";
        String EaseOutQuart   = "easeOutQuart";
        String EaseInOutQuart = "easeInOutQuart";
        String EaseInQuint    = "easeInQuint";
        String EaseOutQuint   = "easeOutQuint";
        String EaseInOutQuint = "easeInOutQuint";
        String EaseInSine     = "easeInSine";
        String EaseOutSine    = "easeOutSine";
        String EaseInOutSine  = "easeInOutSine";
        String EaseInExpo     = "easeInExpo";
        String EaseOutExpo    = "easeOutExpo";
        String EaseInOutExpo  = "easeInOutExpo";
        String EaseInCirc     = "easeInCirc";
        String EaseOutCirc    = "easeOutCirc";
        String EaseInOutCirc  = "easeInOutCirc";
        String EaseOutBounce  = "easeOutBounce";
        String EaseInBack     = "easeInBack";
        String EaseOutBack    = "easeOutBack";
        String EaseInOutBack  = "easeInOutBack";
        String Elastic        = "elastic";
        String SwingFromTo    = "swingFromTo";
        String SwingFrom      = "swingFrom";
        String SwingTo        = "swingTo";
        String Bounce         = "bounce";
        String BouncePast     = "bouncePast";
        String EaseFromTo     = "easeFromTo";
        String EaseFrom       = "easeFrom";
        String EaseTo         = "easeTo";
    }

Here are the ten concrete animation types of AAInfographics

Back	Bounce	Circ	Cubic	Elastic

Expo	Quad	Quart	Quint	Sine

About AAChartModel

AAChartModel:chart basic properties instruction

Property name	Description	Value Range
title	The chart title	Any valid string
subtitle	The chart subtitle	Any valid string
chartType	The default series type for the chart. Can be any of the chart types listed under `AAChartType`.	AAChartType.Column, AAChartType.Bar, AAChartType.Area, AAChartType.AreaSpline, AAChartType.Line, AAChartType.Spline, AAChartType.Pie, AAChartType.Bubble, AAChartType.Scatter, AAChartType.Pyramid, AAChartType.Funnel, AAChartType.Arearange, AAChartType.Columnrange
stacking	Whether to stack the values of each series on top of each other. Possible values are null to disable, "normal" to stack by value or "percent". When stacking is enabled, data must be sorted in ascending X order	AAChartStackingType.None, AAChartStackingType.Normal, AAChartStackingType.Percent
symbol	A predefined shape or symbol for the marker. When null, the symbol is pulled from options.symbols. Other possible values are "circle", "square", "diamond", "triangle" and "triangle-down"	AAChartSymbolType.Circle, AAChartSymbolType.Square, AAChartSymbolType.Diamond, AAChartSymbolType.Triangle, AAChartSymbolType.TriangleDown
colorsTheme	the colors theme of chart style	default value is `new String[]{"#fe117c","#ffc069","#06caf4","#7dffc0"}`
series	the series data of chart	a list made of AASeriesElement instance objects ,every AASeriesElement has its own type 、name、data、color、opacity value ect

AAChartModel:chart all properties list

public String  animationType;        
public Integer animationDuration;    
public String  title;                 
public String  subtitle;             
public String  chartType;           
public String  stacking;              
public String  symbol;               
public String  symbolStyle;
public String  zoomType;             
public Boolean pointHollow;           
public Boolean inverted;              
public Boolean xAxisReversed;       
public Boolean yAxisReversed;        
public Boolean tooltipEnabled;        
public String  tooltipValueSuffix;    
public Boolean tooltipCrosshairs;     
public Boolean gradientColorEnable;  
public Boolean polar;                
public Float   marginLeft;
public Float   marginRight;
public Boolean dataLabelEnabled;     
public Boolean xAxisLabelsEnabled;    
public String[]categories;            
public Integer xAxisGridLineWidth;    
public Boolean xAxisVisible;          
public Boolean yAxisVisible;         
public Boolean yAxisLabelsEnabled;   
public String  yAxisTitle;            
public Float   yAxisLineWidth;        

public Integer yAxisGridLineWidth;    
public Object[]colorsTheme;          
public Boolean legendEnabled;         
public String  legendLayout;          
public String  legendAlign;           
public String  legendVerticalAlign;  
public String  backgroundColor;       
public Boolean options3dEnable;       
public Integer options3dAlphaInt;
public Integer options3dBetaInt;
public Integer options3dDepth;        
public Integer borderRadius;          
public Integer markerRadius;          
public AASeriesElement[] series;
public String  titleColor;            
public String  subTitleColor;         
public String  axisColor;

Created By

An An

 "CODE IS FAR AWAY FROM BUG WITH THE ANIMAL PROTECTING"
 
 *          ##2      ##2
 *       ┏-##1　  ┏-##1
 *    ┏_┛ ┻---━┛_┻━━┓
 *    ┃　　　        ┃　　　　 
 *    ┃　　 ━　      ┃　　　 
 *    ┃ @^　  @^    ┃　　 
 *    ┃　　　　　　  ┃
 *    ┃　　 ┻　　　 ┃
 *    ┃_　　　　　 _┃
 *     ┗━┓　　　┏━┛
 *    　　┃　　　┃神兽保佑
 *    　　┃　　　┃永无BUG！
 *    　　┃　　　┗━━━┓----|
 *    　　┃　　　　　　　  ┣┓}}}
 *    　　┃　　　　　　　  ┏┛
 *    　　┗┓&&&┓-┏&&&┓┏┛-|
 *    　　　┃┫┫　 ┃┫┫
 *    　　　┗┻┛　 ┗┻┛
 *
 *
 "CODE IS FAR AWAY FROM BUG WITH THE ANIMAL PROTECTING"

Source Code⛓

Language Version	Project Name	Target Platform	Source Code Link
Kotlin	AAInfographics	Android	https://github.com/AAChartModel/AAChartCore-Kotlin
Java	AAChartCore	Android	https://github.com/AAChartModel/AAChartCore
Swift	AAInfographics	iOS	https://github.com/AAChartModel/AAChartKit-Swift
Objective C	AAChartKit	iOS	https://github.com/AAChartModel/AAChartKit

LICENSE

AAInfographics is available under the MIT license. See the LICENSE file for more information.

Contact

🌕 🌖 🌗 🌘 WARM TIPS!!! 🌑 🌒 🌓 🌔
Please contact me on GitHub,if there are any problems encountered in use.
GitHub Issues : https://github.com/AAChartModel/AAChartCore/issues

And if you want to contribute for this project, please contact me as well
GitHub : https://github.com/AAChartModel
StackOverflow : https://stackoverflow.com/users/7842508/codeforu
JianShu : http://www.jianshu.com/u/f1e6753d4254
SegmentFault : https://segmentfault.com/u/huanghunbieguan

Todo list

aachartcore's People

Stargazers

Watchers

Forkers

jackshine gejiezhang shileiit liyun1030 duxiux biangkerok32 patelmanthan777 wangrui-spidernet qiuzy008 golicen michealwen chuck-0123 spenceacc a13377766460 flynihao53 jz-arch rushikeshathare jianghushrimp syng1e t32li loadmail cizkey ave838 codingcoderscode qintaiyuan alexskinner7 neerajitdose maiduoduo cnm7625904 ca-ad verycure laiyongshan bitmess le-power cbuemc kingqian zhangshu345 starsw001 culturer fn-xiaobo just-d bigwolfdean mumo8 account-001 banxiawenwen devilmrtank vurtex taxifaraway elvisgh carythh q3920687 liuyunlong-pro cxjamess cying112115 xinyuloving xayo69 gentlery zhufan073 whitegl0ves peterjiao88 erhaa233 krguang zhaozhenqiang oliver-star cybkw yunyangh qautry walker0406 extpune jabincui goundam heiduo zhaolin2633 luotianming123 tommyteavee tuanha1305 thatisray meijianxue94121 liwanlian 6mad chenlongxiang liao00 zhangzhenguo-git eszhanghome nicknghk bobin168 ammar-abyte boldfruit 2silver2 dongfang-wangdaren trongluan2809 fjg2016 hailong123 mariodantas rbqren000 songliuding irmobydick ylmyg ajunlonglive wensincai

aachartcore's Issues

向右拖动会出现一片白色区域

多条曲线时，Y轴数据对不上，各个点的数据偏大

【功能】请问，数据刷新支持像 x

请问Android版的X轴想做出设置固定长度，然后可以左右滑动的效果，怎么设置才行

数据过多的时候可以加个纵向滑动么？？

can we detect touch event now for android ?

Long datalabels is not show fully in Pie chart.

As you can see data labels is not showing fully. How can I fix it?

android版本状态AAChartType.Gauge

发现ios的Gauge仪表盘可以使用,android的怎么使用?

Linear类型动画无法控制动画时间

在使用linear动画的时候，发现无法控制动画显示时间，经过定位发现是AAOptionsConstructor类的

if (!aaChartModel.animationType.equals(AAChartAnimationType.Linear))

一句代码存在问题，导致没有设置animationDuration。

X axis methods missing

Android lacks a lot of methods, similar to X-axis sliding. At present, loading is slow. What's the best way?

请问android版本的什么时候可用呢?

怎么设置chart的大小

你好我正在使用你的项目，但是我不知道怎么设置chart的大小

为什么我提问的两个问题都给删了？

请问安卓端的AASeriesElement取不到showInLegendSet(NO)IOS却可以你能不能补一下啊！我有个需求要这个属性。或者你告诉我怎么弄？谢谢了好人一生平安啊

图表设置Y轴最大数字yAxisMax(100f)无用

请问Android的图表设置Y轴最大数字yAxisMax(100f)无用，应该如何解决

InflateException

Caused by: android.view.InflateException: Binary XML file line #10: Error inflating class com.example.jz.medicalwaste.aachartcorelib.aachartconfiger.AAChartView

在手机上运行时没有问题,在一台安卓5.1.1的手持机上运行时,xml文件报错了,但是AAChartView路径是没问题的

怎么导入。。看不懂

你好，我现在导入还不成功，你说导入项目就可以了可是我不知道具体放在哪个文件夹
我把他们全放在了sec->main->java里面，但是全红了，之前看到说改包名，但我还是不清楚改哪里的包名，是指把拷贝的每个java文件上面的package都改成自己应用的包名吗？

Refresh

//Refresh

绘制响应较慢有什么解决方法吗(已解决)

点击按钮后要等1到2秒才能绘制图案，有什么解决方法吗？

请问下怎么样自定义扇形图的颜色？谢谢

tooltip 浮动提示框的显示效果

您好，当前的浮动提示框无法满足我的业务需要。您的轮子是否可以自定义提示框的布局，我看到是能通过js的方式修改的，但是看上去还是一个模板的样子。我想要的效果是：比如有两条折线点击某个横坐标时，可以出现两行描述信息，这个描述信息是可以自己拼接的第三行显示他们的差值。请大佬提供一个思路...感谢感谢

请问支持动态渲染吗，我想要用它做实时反馈图表，如果可以请告诉我该怎么做，不胜感激。

请问series的数据可以动态刷新吗？

项目demo里series的值都是写死的我现在想要动态获取数值可以做到吗？我做到是个蓝牙温度计的项目需要动态获取数值

Support double layers && even more layers pie chart 支持双重甚至更多重扇形图样式

跪求X轴数据比较多的时候加个滑动！！！给跪了

您好问一下 x轴数据比较多展示不下时可以滑动的功能现在有了嘛

断点重连

安卓版本怎么实现断点重连。就是有个数据集合，但是其中某个点的值为NULL 想实现的是跳过这个点但是前后各有一条连续的折线

支持三重Y轴的混合图表

Android lacks a lot of methods

Android lacks a lot of methods, similar to X-axis sliding. At present, loading is slow. What's the best way?

图表数据变成0时，那条变成0的数据会依附在其他线条上，Android-kotlin

之后变成下图

下图是隐藏其他数据只显示变为0的数据，证实的确数据发生改变

官方的demo我将数据变为0也会出现这样的情况

你好我使用的时候遇到这个问题 I/chromium: [INFO:CONSOLE(10)] "Uncaught Error: Highcharts error #17: www.highcharts.com/errors/17", source: file:///android_asset/AAHighchartsLib.js (10) 请问您知道什么原因吗

你好我使用的时候遇到这个问题
I/chromium: [INFO:CONSOLE(10)] "Uncaught Error: Highcharts error #17: www.highcharts.com/errors/17", source: file:///android_asset/AAHighchartsLib.js (10)
请问您知道什么原因吗

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.

aachartmodel / aachartcore Goto Github PK

aachartcore's Introduction

AAChartCore

English Document 🇬🇧 | 简体中文文档 🇨🇳

There is the link of Kotlin version of AAChartCore as follow

Preface

Features

Appreciation

Installation

JitPack (Recommend)

Usage

Update chart content

Infographics sample

line chart

column chart

bar chart

special area chart one

special area chart two

special area chart three

polar chart

radar chart

pie chart

bubble chart

scatter chart

arearange chart

step area chart

mixed chart