Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/AAChartModel/AAChartKit-Swift

๐Ÿ“ˆ๐Ÿ“Š๐Ÿ“ฑ๐Ÿ’ป๐Ÿ–ฅ๏ธAn elegant modern declarative data visualization chart framework for iOS, iPadOS and macOS. 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. ๆžๅ…ถ็ฒพ็พŽ่€Œๅˆๅผบๅคง็š„็ŽฐไปฃๅŒ–ๅฃฐๆ˜Žๅผๆ•ฐๆฎๅฏ่ง†ๅŒ–ๅ›พ่กจๆก†ๆžถ,ๆ”ฏๆŒๆŸฑ็Šถๅ›พใ€ๆกๅฝขๅ›พใ€ๆŠ˜็บฟๅ›พใ€ๆ›ฒ็บฟๅ›พใ€ๆŠ˜็บฟๅกซๅ……ๅ›พใ€ๆ›ฒ็บฟๅกซๅ……ๅ›พใ€ๆฐ”ๆณกๅ›พใ€ๆ‰‡ๅฝขๅ›พใ€็Žฏๅฝขๅ›พใ€ๆ•ฃ็‚นๅ›พใ€้›ท่พพๅ›พใ€ๆททๅˆๅ›พ็ญ‰ๅ„็ง็ฑปๅž‹็š„ๅคš่พพๅ‡ ๅ็ง็š„ไฟกๆฏๅ›พๅ›พ่กจ,ๅฎŒๅ…จๆปก่ถณๅทฅไฝœๆ‰€้œ€.
https://github.com/AAChartModel/AAChartKit-Swift

animation area-chart bar-chart bubble-chart chart column-chart data-analysis data-visualization draw graph graphics ios line-chart model objective-c pie plot spline-chart swift view

Last synced: about 2 months ago
JSON representation

๐Ÿ“ˆ๐Ÿ“Š๐Ÿ“ฑ๐Ÿ’ป๐Ÿ–ฅ๏ธAn elegant modern declarative data visualization chart framework for iOS, iPadOS and macOS. 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. ๆžๅ…ถ็ฒพ็พŽ่€Œๅˆๅผบๅคง็š„็ŽฐไปฃๅŒ–ๅฃฐๆ˜Žๅผๆ•ฐๆฎๅฏ่ง†ๅŒ–ๅ›พ่กจๆก†ๆžถ,ๆ”ฏๆŒๆŸฑ็Šถๅ›พใ€ๆกๅฝขๅ›พใ€ๆŠ˜็บฟๅ›พใ€ๆ›ฒ็บฟๅ›พใ€ๆŠ˜็บฟๅกซๅ……ๅ›พใ€ๆ›ฒ็บฟๅกซๅ……ๅ›พใ€ๆฐ”ๆณกๅ›พใ€ๆ‰‡ๅฝขๅ›พใ€็Žฏๅฝขๅ›พใ€ๆ•ฃ็‚นๅ›พใ€้›ท่พพๅ›พใ€ๆททๅˆๅ›พ็ญ‰ๅ„็ง็ฑปๅž‹็š„ๅคš่พพๅ‡ ๅ็ง็š„ไฟกๆฏๅ›พๅ›พ่กจ,ๅฎŒๅ…จๆปก่ถณๅทฅไฝœๆ‰€้œ€.

Awesome Lists containing this project

README

        

![AAInfographics-LOGO]( https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAInfographics/AAInfographics-Logo.png)

# AAInfographics

[![Support](https://img.shields.io/badge/support-iOS%208%2B%20-blue.svg?style=flat)](https://www.apple.com/nl/ios/)
[![](https://img.shields.io/badge/license-MIT-brightgreen.svg)](https://github.com/AAChartModel/AAChartKit-Swift/blob/master/LICENSE)
[![](https://img.shields.io/badge/language-Swift-green.svg)](https://github.com/AAChartModel/AAChartKit-Swift)
[![](https://img.shields.io/badge/support-Animation-yellow.svg)](https://github.com/AAChartModel/AAChartKit-Swift#supported-animation-type-for-now)
[![](https://img.shields.io/badge/support-OC-orange.svg)](https://github.com/AAChartModel/AAChartKit)
[![](https://jaywcjlove.github.io/sb/lang/chinese.svg)](https://github.com/AAChartModel/AAChartKit-Swift/blob/master/CHINESE-README.md)
[![](https://jaywcjlove.github.io/sb/lang/english.svg)](https://github.com/AAChartModel/AAChartKit-Swift)
[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/AAChartModel/AAChartKit-Swift.svg)](http://isitmaintained.com/project/AAChartModel/AAChartKit-Swift "Average time to resolve an issue")
[![Percentage of issues still open](http://isitmaintained.com/badge/open/AAChartModel/AAChartKit-Swift.svg)](http://isitmaintained.com/project/AAChartModel/AAChartKit-Swift "Percentage of issues still open")
[![](https://img.shields.io/badge/AAChartKitSwift-StarHistory-blue.svg)](https://star-history.t9t.io/#AAChartModel/AAChartKit-Swift)

## [ **English Document ๐Ÿ‡ฌ๐Ÿ‡ง** ](https://github.com/AAChartModel/AAChartKit-Swift) | [ **็ฎ€ไฝ“ไธญๆ–‡ๆ–‡ๆกฃ ๐Ÿ‡จ๐Ÿ‡ณ** ](https://github.com/AAChartModel/AAChartKit-Swift/blob/master/CHINESE-README.md)
### There is the link of **Objective-C version** of `AAChartKit` as follow
#### *https://github.com/AAChartModel/AAChartKit*

## Preface

***AAInfographics*** is the `Swift` language version of [AAChartKit](https://github.com/AAChartModel/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 `iOS `ใ€`iPadOS` and `macOS`. Totally support `Swift` language, and there are more types version such as `Objective-C` language version [AAChartKit](https://github.com/AAChartModel/AAChartKit) ใ€ `Java` language version [AAChartCore](https://github.com/AAChartModel/AAChartCore) ใ€`Kotlin` language version [AAInfographics](https://github.com/AAChartModel/AAChartCore-Kotlin) . To get more details you can see the [source code links list](https://github.com/AAChartModel/AAChartKit-Swift#source-code-Links).

* ๐Ÿš€ **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 `chain programming syntax` like *SwiftUI* and *Jetpack Compose*.

* ๐Ÿฆ‹ **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 framework [AAChartKit](https://github.com/AAChartModel/AAChartKit).

* ๐Ÿ–ฑ **Interaction event callback**. Support for monitoring [user click events and single finger move over events](https://github.com/AAChartModel/AAChartKit-Swift#support-user-click-events-and-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

| Column Chart | Column Range Chart | Area Chart |
| :----: | :----: | :----: |
| ![image1](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAChartKit/BeautyAppreciation/ColumnChart.png) | ![image1](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAChartKit/BeautyAppreciation/BarChart.png) | ![image1](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAChartKit/BeautyAppreciation/AreaChart.png) |

| Line Chart | Step Area Chart | Step Line Chart |
| :----: | :----: | :----: |
| ![image1](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAChartKit/BeautyAppreciation/LineChart.png) | ![image1](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAChartKit/BeautyAppreciation/StepAreaChart.png) | ![image1](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAChartKit/BeautyAppreciation/StepLineChart.png) |

| Spline Chart | Areaspline Chart | Stacked Polar Chart |
| :----: | :----: | :----: |
| ![image1](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/splineChart.png) | ![image1](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/areasplineChart.png) | ![image1](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/percentStackingAreasplineChart.png) |

| Bubble Chart | Arearange Average Value Chart | Column Mixed Line Chart |
| :----: | :----: | :----: |
| ![image1](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAInfographics/BubbleChart.png) | ![image1](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAInfographics/ArearangeAverageValueChart.png) | ![image1](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAInfographics/ColumnMixedLineChart.png) |

| Scatter Chart | Boxplot Chart | Mirror Column Chart |
| :----: | :----: | :----: |
| ![image1](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/scatterChart.png) | ![image1](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/boxplotChart.png) | ![image1](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/MirrorColumnChart.png) |

## Installation

### CocoaPods (recommended)

1. Add following content
```ruby
pod 'AAInfographics', :git => 'https://github.com/AAChartModel/AAChartKit-Swift.git'

```
to your project Podfile.

2. Run `pod install` or `pod update`.
3. Import `AAInfographics`.

### Carthage

1. Add following content
```ruby
github "https://github.com/AAChartModel/AAChartKit-Swift.git" ~> 1.0

```
to your project Cartfile.

2. Run `carthage bootstrap` or `carthage update`.
3. Import `AAInfographics`.

### Manually (old school way)

1. Download whole project demo of `AAInfographicsDemo`
2. Drag the folder `AAInfographics` into your project.

## Usage

1. Creat the instance object of chart view:`AAChartView`

```swift
let chartViewWidth = self.view.frame.size.width
let chartViewHeight = self.view.frame.size.height
aaChartView = AAChartView()
aaChartView?.frame = CGRect(x: 0,
y: 60,
width: chartViewWidth,
height: chartViewHeight)
// set the content height of aachartView
// aaChartView?.contentHeight = self.view.frame.size.height
self.view.addSubview(aaChartView!)
```
2. Configure the properties of chart model:`AAChartModel`

``` swift
let aaChartModel = AAChartModel()
.chartType(.area)//Can be any of the chart types listed under `AAChartType`.
.animationType(.bounce)
.title("TITLE")//The chart title
.subtitle("subtitle")//The chart subtitle
.dataLabelsEnabled(false) //Enable or disable the data labels. Defaults to false
.tooltipValueSuffix("USD")//the value suffix of the chart tooltip
.categories(["Jan", "Feb", "Mar", "Apr", "May", "Jun",
"Jul", "Aug", "Sep", "Oct", "Nov", "Dec"])
.colorsTheme(["#fe117c","#ffc069","#06caf4","#7dffc0"])
.series([
AASeriesElement()
.name("Tokyo")
.data([7.0, 6.9, 9.5, 14.5, 18.2, 21.5, 25.2, 26.5, 23.3, 18.3, 13.9, 9.6]),
AASeriesElement()
.name("New York")
.data([0.2, 0.8, 5.7, 11.3, 17.0, 22.0, 24.8, 24.1, 20.1, 14.1, 8.6, 2.5]),
AASeriesElement()
.name("Berlin")
.data([0.9, 0.6, 3.5, 8.4, 13.5, 17.0, 18.6, 17.9, 14.3, 9.0, 3.9, 1.0]),
AASeriesElement()
.name("London")
.data([3.9, 4.2, 5.7, 8.5, 11.9, 15.2, 17.0, 16.6, 14.2, 10.3, 6.6, 4.8]),
])
```

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

```swift
//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)

```swift
//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`)

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

## Infographics sample

- ### line chart

![line chart](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/LineChart.png)

- ### column chart

![IMG_1873.JPG](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/ColumnChart.png)

- ### bar chart

![bar chart](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/BarChart.png)

- ### special area chart one

![IMG_1869.JPG](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/IMG_1482.JPG)

- ### special area chart two

![IMG_1871.JPG](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/AreaChartOne.png)

- ### special area chart three

![IMG_1863.JPG](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/AreaChartTwo.png)

- ### polar chart

![polar chart](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/PolarChart.png)

- ### radar chart

![radar chart](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/RadarChart.png)

- ### pie chart

![pie chart](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/PieChart.png)

- ### bubble chart

![bubble chart](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/BubbleChart.png)

- ### scatter chart

![scatter chart](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/ScatterChart.png)

- ### arearange chart

![arearange chart](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/ArearangeChart.png)

- ### step area chart

![step area chart](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/StepAreaChart.png)

- ### mixed chart

![mixed chart](https://raw.githubusercontent.com/AAChartModel/loadHtmlCssJsDemo-master/master/AAInfographics/MixedChart.png)

## 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.

![AAChartKit-Live](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/AAChartKit-Live.gif)

## Special instructions

### Support user click events and move over events

you can monitor the user cick or finger move over events message through implementing delegate function for AAChartView instance object

```swift
//Set AAChartView events delegate
aaChartView!.delegate = self as AAChartViewDelegate

//implement AAChartView user click or finger move over events delegate function
extension BasicChartVC: AAChartViewDelegate {
open func aaChartView(_ aaChartView: AAChartView, clickEventMessage: AAClickEventMessageModel) {
print(
"""

clicked point series element name: \(clickEventMessage.name ?? "")
๐Ÿ–ฑ๐Ÿ–ฑ๐Ÿ–ฑWARNING!!!!!!!!!!!!!!!!!!!! Click Event Message !!!!!!!!!!!!!!!!!!!! WARNING๐Ÿ–ฑ๐Ÿ–ฑ๐Ÿ–ฑ
==========================================================================================
------------------------------------------------------------------------------------------
user finger moved over!!!,get the move over event message: {
category = \(String(describing: clickEventMessage.category))
index = \(String(describing: clickEventMessage.index))
name = \(String(describing: clickEventMessage.name))
offset = \(String(describing: clickEventMessage.offset))
x = \(String(describing: clickEventMessage.x))
y = \(String(describing: clickEventMessage.y))
}
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++


"""
)
}

open func aaChartView(_ aaChartView: AAChartView, moveOverEventMessage: AAMoveOverEventMessageModel) {
print(
"""

moved over point series element name: \(moveOverEventMessage.name ?? "")
โœ‹๐Ÿปโœ‹๐Ÿปโœ‹๐Ÿปโœ‹๐Ÿปโœ‹๐ŸปWARNING!!!!!!!!!!!!!! Move Over Event Message !!!!!!!!!!!!!! WARNINGโœ‹๐Ÿปโœ‹๐Ÿปโœ‹๐Ÿปโœ‹๐Ÿปโœ‹๐Ÿป
==========================================================================================
------------------------------------------------------------------------------------------
user finger moved over!!!,get the move over event message: {
category = \(String(describing: moveOverEventMessage.category))
index = \(String(describing: moveOverEventMessage.index))
name = \(String(describing: moveOverEventMessage.name))
offset = \(String(describing: moveOverEventMessage.offset))
x = \(String(describing: moveOverEventMessage.x))
y = \(String(describing: moveOverEventMessage.y))
}
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++


"""
)
}
}
```

The received user click or finger move over events contain following content

```swift
public class AAEventMessageModel: NSObject {
public var name: String?
public var x: Float?
public var y: Float?
public var category: String?
public var offset: [String: Any]?
public var index: Int?
}

public class AAClickEventMessageModel: AAEventMessageModel {}

public class AAMoveOverEventMessageModel: AAEventMessageModel {}
```

Monitoring user click events can achieve a variety of custom functions. For example, you can implement **Double Charts Linkage** through user click event callbacks. The example effects are as follows

![doubleChartsLinkage](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/doubleChartsLinkage.gif)

### Support for customizing 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:

```js
aaOptions.tooltip?
.useHTML(true)
.formatter("""
function () {
return ' ๐ŸŒ• ๐ŸŒ– ๐ŸŒ— ๐ŸŒ˜ ๐ŸŒ‘ ๐ŸŒ’ ๐ŸŒ“ ๐ŸŒ”
'
+ ' Support JavaScript Function Just Right Now !!!
'
+ ' The Gold Price For 2020 '
+ this.x
+ '
Is '
+ this.y
+ '
Dollars ';
}
""")
.valueDecimals(2)//่ฎพ็ฝฎๅ–ๅ€ผ็ฒพ็กฎๅˆฐๅฐๆ•ฐ็‚นๅŽๅ‡ ไฝ//่ฎพ็ฝฎๅ–ๅ€ผ็ฒพ็กฎๅˆฐๅฐๆ•ฐ็‚นๅŽๅ‡ ไฝ
.backgroundColor("#000000")
.borderColor("#000000")
.style(AAStyle()
.color("#FFD700")
.fontSize(12)
)
```

you can get the customized tooltip style chart like this๐Ÿ‘‡
![](https://user-images.githubusercontent.com/16357599/56589690-543c5880-6618-11e9-9d18-6bc0fe2fa53f.png)

* configuring AATooltip instance object properties as follow:

```js
aaOptions.tooltip?
.useHTML(true)
.formatter(#"""
function () {
let wholeContentStr ='โ—‰ Time: ' + this.x + ' year
';
let length = this.points.length;
for (let i = 0; i < length; i++) {
let thisPoint = this.points[i];
let yValue = thisPoint.y;
if (yValue != 0) {
let spanStyleStartStr = 'โ—‰ ';
let spanStyleEndStr = '

';
wholeContentStr += spanStyleStartStr + thisPoint.series.name + ': ' + thisPoint.y + 'โ„ƒ' + spanStyleEndStr;
}
}
return wholeContentStr;
}
"""#)
.backgroundColor("#050505")
.borderColor("#050505")
```

you can get the customized tooltip style chart like this๐Ÿ‘‡
![colorfulTooltipChart](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/colorfulTooltipChart.png)

### Support value range segmentation

* chart with value range segmentation `bands ๐ŸŽ€`
![plotBandsChart](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/plotBandsChart.png)

* chart with value range segmentation `lines ๐Ÿงถ`
![plotLinesChart](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/plotLinesChart.png)

* chart with value range segmentation `zones ๐Ÿงฑ`
![seriesZonesChart](https://raw.githubusercontent.com/AAChartModel/Gallery/master/AAChartKit/seriesZonesChart.png)

### Support scrolling update chart data





### Support data sorting with animation effect





### Supported chart type for now

```swift
public enum AAChartType: String {
case column //Column series display one column per value along an X axis.
case bar //A bar series is a special type of column series where the columns are horizontal.
case area //The area series type.
case areaspline //The area spline series is an area series where the graph between the points is smoothed into a spline.
case line //A line series displays information as a series of data points connected by straight line segments.
case spline //A spline series is a special type of line series, where the segments between the data points are smoothed.
case scatter //A scatter plot uses cartesian coordinates to display values for two variables for a set of data.
case pie //A pie chart is a circular graphic which is divided into slices to illustrate numerical proportion.
case bubble //A bubble series is a three dimensional series type where each point renders an X, Y and Z value. Each points is drawn as a bubble where the position along the X and Y axes mark the X and Y values, and the size of the bubble relates to the Z value.
case pyramid //A pyramid series is a special type of funnel, without neck and reversed by default.
case funnel //Funnel charts are a type of chart often used to visualize stages in a sales project, where the top are the initial stages with the most clients. It requires that the modules/funnel.js file is loaded.
case columnrange //The column range is a cartesian series type with higher and lower Y values along an X axis. To display horizontal bars, set chart.inverted to true.
case arearange //The area range series is a carteseian series with higher and lower values for each point along an X axis, where the area between the values is shaded.
case areasplinerange //The area spline range is a cartesian series type with higher and lower Y values along an X axis. The area inside the range is colored, and the graph outlining the area is a smoothed spline.
case boxplot //A box plot is a convenient way of depicting groups of data through their five-number summaries: the smallest observation (sample minimum), lower quartile (Q1), median (Q2), upper quartile (Q3), and largest observation (sample maximum).
case waterfall //A waterfall chart displays sequentially introduced positive or negative values in cumulative columns.
case polygon //A polygon series can be used to draw any freeform shape in the cartesian coordinate system. A fill is applied with the color option, and stroke is applied through lineWidth and lineColor options.
case gauge //Gauges are circular plots displaying one or more values with a dial pointing to values along the perimeter.
case errorbar //Error bars are a graphical representation of the variability of data and are used on graphs to indicate the error, or uncertainty in a reported measurement.
}
```

### Supported zoom gesture types for now
```swift
enum AAChartZoomType: String {
case none = "none"
case x = "x"
case y = "y"
case xy = "xy"
}
```

### Suppported line dash style types for now
```swift
public enum AAChartLineDashStyleType: String {
case solid //โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”โ€”
case shortDash //โ€” โ€” โ€” โ€” โ€” โ€” โ€” โ€” โ€” โ€” โ€” โ€” โ€” โ€” โ€” โ€” โ€” โ€”
case shortDot //โตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆโตˆ
case shortDashDot //โ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€งโ€”โ€ง
case shortDashDotDot //โ€”โ€งโ€งโ€”โ€งโ€งโ€”โ€งโ€งโ€”โ€งโ€งโ€”โ€งโ€งโ€”โ€งโ€งโ€”โ€งโ€งโ€”โ€งโ€งโ€”โ€งโ€งโ€”โ€งโ€งโ€”โ€งโ€งโ€”โ€งโ€ง
case dot //โ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€งโ€ง
case dash //โ€”โ€” โ€”โ€” โ€”โ€” โ€”โ€” โ€”โ€” โ€”โ€” โ€”โ€” โ€”โ€” โ€”โ€” โ€”โ€” โ€”โ€” โ€”โ€”
case longDash //โ€”โ€”โ€” โ€”โ€”โ€” โ€”โ€”โ€” โ€”โ€”โ€” โ€”โ€”โ€” โ€”โ€”โ€” โ€”โ€”โ€” โ€”โ€”โ€” โ€”โ€”โ€”
case dashDot //โ€”โ€”โ€งโ€”โ€”โ€งโ€”โ€”โ€งโ€”โ€”โ€งโ€”โ€”โ€งโ€”โ€”โ€งโ€”โ€”โ€งโ€”โ€”โ€งโ€”โ€”โ€งโ€”โ€”โ€งโ€”โ€”โ€งโ€”โ€”โ€ง
case longDashDot //โ€”โ€”โ€”โ€งโ€”โ€”โ€”โ€งโ€”โ€”โ€”โ€งโ€”โ€”โ€”โ€งโ€”โ€”โ€”โ€งโ€”โ€”โ€”โ€งโ€”โ€”โ€”โ€งโ€”โ€”โ€”โ€งโ€”โ€”โ€”โ€ง
case longDashDotDot //โ€”โ€”โ€”โ€งโ€งโ€”โ€”โ€”โ€งโ€งโ€”โ€”โ€”โ€งโ€งโ€”โ€”โ€”โ€งโ€งโ€”โ€”โ€”โ€งโ€งโ€”โ€”โ€”โ€งโ€งโ€”โ€”โ€”โ€งโ€ง
}
```

### Supported animation type for now

```swift

public enum AAChartAnimationType: String {
case easeInQuad = "easeInQuad"
case easeOutQuad = "easeOutQuad"
case easeInOutQuad = "easeInOutQuad"
case easeInCubic = "easeInCubic"
case easeOutCubic = "easeOutCubic"
case easeInOutCubic = "easeInOutCubic"
case easeInQuart = "easeInQuart"
case easeOutQuart = "easeOutQuart"
case easeInOutQuart = "easeInOutQuart"
case easeInQuint = "easeInQuint"
case easeOutQuint = "easeOutQuint"
case easeInOutQuint = "easeInOutQuint"
case easeInSine = "easeInSine"
case easeOutSine = "easeOutSine"
case easeInOutSine = "easeInOutSine"
case easeInExpo = "easeInExpo"
case easeOutExpo = "easeOutExpo"
case easeInOutExpo = "easeInOutExpo"
case easeInCirc = "easeInCirc"
case easeOutCirc = "easeOutCirc"
case easeInOutCirc = "easeInOutCirc"
case easeOutBounce = "easeOutBounce"
case easeInBack = "easeInBack"
case easeOutBack = "easeOutBack"
case easeInOutBack = "easeInOutBack"
case elastic = "elastic"
case swingFromTo = "swingFromTo"
case swingFrom = "swingFrom"
case swingTo = "swingTo"
case bounce = "bounce"
case bouncePast = "bouncePast"
case easeFromTo = "easeFromTo"
case easeFrom = "easeFrom"
case easeTo = "easeTo"
}
```

Here are the ten concrete animation types of **AAInfographics**

| Back | Bounce | Circ | Cubic | Elastic |
|:---------:|:---------:|:---------:|:---------:|:---------:|
| ![][1] | ![][2] | ![][3] | ![][4] | ![][5] |

| Expo | Quad | Quart | Quint | Sine |
|:---------:|:---------:|:---------:|:---------:|:---------:|
| ![][6] | ![][7] | ![][8] | ![][9] | ![][10] |

## About AAChartModel

* ### AAChartModel:chart basic properties instruction

Property name | Property type | Description | Value Range |
------------ | ------------- | ------------- | ------------- |
title | String | The chart title | Any valid string |
subtitle | String |The chart subtitle | Any valid string |
chartType | AAChartType | The default series type for the chart. Can be any of the chart types listed under `AAChartType`. | .column, .bar, .area, .areaSpline, .line, .spline, .pie, .bubble, .scatter, .pyramid, .funnel, .areaRange, .columnRange |
stacking| AAChartStackingType | 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 | .none, .normal, .percent |
symbol | AAChartSymbolType | 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" | .circle, .square, .diamond, .triangle, .triangleDown |

* ### AAChartModel:chart all properties list
```swift
public class AAChartModel: AAObject {
public var animationType: AAChartAnimationType? //The type of chart animation
public var animationDuration: Int? //The chart rendering animation duration
public var title: String? //The chart title
public var titleStyle: AAStyle? //The chart title style
public var subtitle: String? //The chart subtitle
public var subtitleAlign: AAChartAlignType?//The chart subtitle text align style
public var subtitleStyle: AAStyle? //The chart subtitle style
public var chartType: AAChartType? //The default series type for the chart. Can be any of the chart types listed under `AAChartType`. Defaults to line
public var stacking: AAChartStackingType? //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
public var markerSymbol: AAChartSymbolType? //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"
public var markerSymbolStyle: AAChartSymbolStyleType?
public var zoomType: AAChartZoomType? //Decides in what dimensions the user can zoom by dragging the mouse. Can be one of x, y or xy
public var inverted: Bool? //Whether to invert the axes so that the x axis is vertical and y axis is horizontal. When true, the x axis is reversed by default. If a bar series is present in the chart, it will be inverted automatically.Inverting the chart doesn't have an effect if there are no cartesian series in the chart, or if the chart is polar.Defaults to false
public var xAxisReversed: Bool? //Whether to reverse the axis so that the highest number is closest to the origin. If the chart is inverted, the x axis is reversed by default. Defaults to false
public var yAxisReversed: Bool? //Whether to reverse the axis so that the highest number is closest to the origin. If the chart is inverted, the x axis is reversed by default. Defaults to false
public var polar: Bool? //When true, cartesian charts like line, spline, area and column are transformed into the polar coordinate system. Requires `AAHighchartsMore.js`. Defaults to false
public var margin: [Any?]?
public var dataLabelsEnabled: Bool? //Enable or disable the data labels. Defaults to false
public var dataLabelsStyle: AAStyle? //The data labels style
public var xAxisLabelsEnabled: Bool? //Enable or disable the axis labels. Defaults to true
public var xAxisLabelsStyle: AAStyle? //The x axis labels style
public var categories: [String]? //Set new categories for the axis
public var xAxisGridLineWidth: Float? //The width of the grid lines extending the ticks across the plot area.Defaults to 0
public var xAxisVisible: Bool? //Show the x axis or not
public var xAxisTickInterval: Float? //Custom x axis tick interval,It is useful when the x categories array is too long to show all of them
public var yAxisVisible: Bool? //Show the y axis or not
public var yAxisLabelsEnabled: Bool? //Enable or disable the axis labels. Defaults to true
public var yAxisLabelsStyle: AAStyle? //The y axis labels style
public var yAxisTitle: String? //The actual text of the axis title
public var xAxisTitle: String? //The actual text of the axis title
public var yAxisLineWidth: Float? //The width of y axis line
public var yAxisGridLineWidth: Float? //The width of the grid lines extending the ticks across the plot area. Defaults to 1
public var yAxisMin: Double? //The y axis mini value
public var yAxisMax: Double? //The y axis max value
public var yAxisTickPositions:[Any]? //An array defining where the ticks are laid out on the axis. This overrides the default behaviour of tickPixelInterval and tickInterval.
public var yAxisAllowDecimals: Bool? //The y axis values label allow decimals or not
public var tooltipEnabled: Bool? //Show the tooltip or not
public var tooltipValueSuffix: String? //Custom tooltip value unit suffix
public var colorsTheme: [Any]? //An array containing the default colors for the chart's series. When all colors are used, new colors are pulled from the start again. Defaults to: ["#bb250c","#f67210","#fde680","#257679","#f1c6c5"]
public var series: [Any]? //An array of all the chart's series
public var legendEnabled: Bool? //Enable or disable the legend. Defaults to true
public var backgroundColor: Any? //The background color or gradient for the outer chart area. Defaults to #FFFFFF
public var borderRadius: Float? //The corner radius of the outer chart border. Defaults to 0
public var markerRadius: Float? //The radius of the point marker. Defaults to 4
public var scrollablePlotArea: AAScrollablePlotArea? //Scroll properties if supported

...
...
}
```

## Created By

![](https://avatars1.githubusercontent.com/u/16357599?s=40&v=4)An An
``` java
"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 Linksโ›“

### Normal Versions

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

### Pro Versions

Pro Versions are more powerful data visualization frameworks that support more types beautiful chart like bellcurve, bullet, columnpyramid, cylinder, dependencywheel, heatmap, histogram, networkgraph, organization, packedbubble, pareto, sankey, series, solidgauge, streamgraph, sunburst, tilemap, timeline, treemap, variablepie, variwide, vector, venn, windbarb, wordcloud, xrange charts and so on.

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

## LICENSE

![](https://upload.wikimedia.org/wikipedia/commons/thumb/f/f8/License_icon-mit-88x31-2.svg/128px-License_icon-mit-88x31-2.svg.png)

AAInfographics is available under the MIT license. See the [LICENSE](https://github.com/AAChartModel/AAChartKit-Swift/blob/master/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/AAChartKit-Swift/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

- [x] Support for the user to add delegate events after the graphics content loading was completed
- [x] Support graphics to refresh global content dynamically
- [x] Support graphics to refresh pure data (`series`) content dynamically
- [x] Support color layer gradient effects
- [x] Support 3D graphics effects, valid only for partial graphics such as `column chart`ใ€`bar chart`ใ€`pie charts`ใ€`scatterplot chart`ใ€`bubble chart`, etc
- [x] Support horizontal screen (full screen) effect
- [x] Support setting graphics rendering animation freely
- [x] Support for users to configure `AAOptions` model object properties freely
- [x] Support stacking the graphics
- [x] Support reversing the graphics axis
- [x] Support rendering the scatter chart
- [x] Support rendering the column range map
- [x] Support rendering the area range graph
- [x] Support rendering the polar chart
- [x] Support rendering the step line chart
- [x] Support rendering the step area chart
- [x] Support rendering the rectangular tree hierarchy diagrams
- [x] Support rendering the circular progress bar chart
- [x] Support adding clicked event callbacks for graphics
- [x] Support adding fingerโœ‹๐Ÿป or mouse๐Ÿ–ฑ move over event callbacks for graphics
- [x] Support graphics to refresh pure data in real time and scroll dynamically
- [ ] Support rendered graphics to generate image files
- [ ] Support generating image files saved to the system album

[1]: https://raw.githubusercontent.com/adad184/MMTweenAnimation/master/Images/1.gif
[2]: https://raw.githubusercontent.com/adad184/MMTweenAnimation/master/Images/2.gif
[3]: https://raw.githubusercontent.com/adad184/MMTweenAnimation/master/Images/3.gif
[4]: https://raw.githubusercontent.com/adad184/MMTweenAnimation/master/Images/4.gif
[5]: https://raw.githubusercontent.com/adad184/MMTweenAnimation/master/Images/5.gif
[6]: https://raw.githubusercontent.com/adad184/MMTweenAnimation/master/Images/6.gif
[7]: https://raw.githubusercontent.com/adad184/MMTweenAnimation/master/Images/7.gif
[8]: https://raw.githubusercontent.com/adad184/MMTweenAnimation/master/Images/8.gif
[9]: https://raw.githubusercontent.com/adad184/MMTweenAnimation/master/Images/9.gif
[10]: https://raw.githubusercontent.com/adad184/MMTweenAnimation/master/Images/10.gif