Skip to content

Latest commit

 

History

History
213 lines (144 loc) · 11.1 KB

README.md

File metadata and controls

213 lines (144 loc) · 11.1 KB
Raw

Android Arsenal ![Release](https://img.shields.io/github/release/PhilJay/MPAndroidChart.svg?label=maven central) API

Remember: It's all about the looks.

alt tag

MPAndroidChart is a powerful & easy to use chart library for Android, supporting line-, bar-, scatter-, candlestick-, bubble-, pie- and radarcharts (spider web), as well as scaling, dragging (panning), selecting and animations. Works on Android 2.2 (API level 8) and upwards.

An iOS version of this library is now available, go check it out: ios-charts

Are you using this library? Add your project to the references.

Donations

This project needs you! If you would like to support this project's further development, the creator of this project or the continuous maintenance of this project, feel free to donate. Your donation is highly appreciated (and I love food, coffee and beer). Thank you!

PayPal

Spread the word

Follow me on Twitter: @PhilippJahoda

Look me up on StackOverflow: Philipp Jahoda

Demo

For a brief overview of the most important features, please download the PlayStore Demo MPAndroidChart Example.apk and try it out. The corresponding code for the demo-application is also included in this repository inside the MPChartExample folder.

ScreenShot

Questions & Issues

If you are having questions or problems, you should:

  • Make sure you are using the latest version of the library. Check the release-section.
  • Study the Documentation-Wiki
  • Search or open questions on stackoverflow with the mpandroidchart tag
  • Search known issues for your problem (open and closed)
  • Create new issues (please search known issues before, do not create duplicate issues)

Features

Core features:

  • 8 different chart types
  • Scaling on both axes (with touch-gesture, axes separately or pinch-zoom)
  • Dragging / Panning (with touch-gesture)
  • Combined-Charts (line-, bar-, scatter-, candle-data)
  • Dual (separate) Y-Axis
  • Finger drawing (draw values into the chart with touch-gesture)
  • Highlighting values (with customizeable popup-views)
  • Multiple / Separate Axes
  • Save chart to SD-Card (as image, or as .txt file)
  • Predefined color templates
  • Legends (generated automatically, customizeable)
  • Customizeable Axes (both x- and y-axis)
  • Animations (build up animations, on both x- and y-axis)
  • Limit lines (providing additional information, maximums, ...)
  • Fully customizeable (paints, typefaces, legends, colors, background, gestures, dashed lines, ...)
  • Smooth zooming and scrolling for up to 30.000 data points in Line- and BarChart

Chart types:

  • LineChart (with legend, simple design) alt tag

  • LineChart (with legend, simple design) alt tag

  • LineChart (cubic lines) alt tag

  • LineChart (single DataSet) alt tag

  • Combined-Chart (bar- and linechart in this case) alt tag

  • BarChart (with legend, simple design)

alt tag

  • BarChart (grouped DataSets)

alt tag

  • Horizontal-BarChart

alt tag

  • PieChart (with selection, ...)

alt tag

  • ScatterChart (with squares, triangles, circles, ... and more)

alt tag

  • CandleStickChart (for financial data)

alt tag

  • BubbleChart (area covered by bubbles indicates the value)

alt tag

  • RadarChart (spider web chart)

alt tag

Usage

In order to use the library, there are 4 options:

1. Gradle dependency

  • Add the following to your build.gradle:
repositories {
       maven { url "https://jitpack.io" }
}

dependencies {
       compile 'com.github.PhilJay:MPAndroidChart:v2.1.3'
}

2. Maven

  • Add the following to your pom.xml:
<repository>
      	<id>jitpack.io</id>
       <url>https://jitpack.io</url>
</repository>

<dependency>
       <groupId>com.github.PhilJay</groupId>
       <artifactId>MPAndroidChart</artifactId>
       <version>v2.1.3</version>
</dependency>

3. jar file only

  • Download the latest .jar file from the releases section
  • Copy the mpandroidchartlibrary-version.jar file into the libs folder of your Android application project
  • Start using the library

4. clone whole repository

  • Open your commandline-input and navigate to your desired destination folder (where you want to put the library)
  • Use the command git clone https://github.com/PhilJay/MPAndroidChart.git to download the full MPAndroidChart repository to your computer (this includes the folder of the library project as well as the example project)
  • Import the library folder (MPChartLib) into your Eclipse workspace
  • Add it as a reference to your project: referencing library projects in Eclipse

Proguard

In case you are using Proguard, you will need to whitelist MPAndroidChart, which requires to add the following line to your Proguard configuration file.

-keep class com.github.mikephil.charting.** { *; }

If you don't do this, animations might not work.

Documentation

For a detailed documentation, please have a look at the Wiki.

Furthermore, you can also rely on the MPChartExample folder and check out the example code in that project. The corresponding application to the example project is also available in the Google PlayStore.

You have a problem that cannot be solved by having a look at the example project and documentation? No problem, let's talk: Gitter

License

Copyright 2015 Philipp Jahoda

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Special thanks to danielgindi, mikegr, ph1lb4 and jitpack.io for their contributions to this project.