Getting Started

Setup

For using a LineChart, BarChart, ScatterChart, CandleStickChart, PieChart, BubbleChart or RadarChart , define it in .xml:

    <com.github.mikephil.charting.charts.LineChart
        android:id="@+id/chart"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

And then retrieve it from your Activity, Fragment or whatever:

    // in this example, a LineChart is initialized from xml
    LineChart chart = (LineChart) findViewById(R.id.chart);

or create it in code (and then add it to a layout):

    LineChart chart = new LineChart(Context);

    RelativeLayout rl = (RelativeLayout) findViewById(R.id.relativeLayout);
    rl.add(chart);

Refreshing

• invalidate(): Calling this method on the chart will redraw (refresh) it.
• notifyDataSetChanged(): Lets the chart know its underlying data has changed and performs all necessary recalculations (offsets, legend, maxima, minima, ...).

Logging

• setLogEnabled(boolean enabled): Setting this to true will activate chart logcat output.

General Chart Styling

Here are some general styling methods you can directly use on the chart:

• setBackgroundColor(int color): Sets the background color that will cover the whole chart-view. In addition, a background-color can be set via .xml in the layout file.
• setDescription(String desc): Set a description text that appears in the bottom right corner of the chart.
• setDescriptionColor(int color): Sets the color of the description text.
• setDescriptionPosition(float x, float y): Sets a custom position for the description text in pixels on the screen.
• setDescriptionTypeface(Typeface t): Sets the Typeface used for drawing the description text.
• setDescriptionTextSize(float size): Sets the size of the description text in pixels, min 6f, max 16f.
• setNoDataTextDescription(String desc): Sets the text that should appear if the chart is empty.
• setDrawGridBackground(boolean enabled): If enabled, the background rectangle behind the chart drawing-area will be drawn.
• setGridBackgroundColor(int color): Sets the color the grid-background should be drawn with.
• setDrawBorders(boolean enabled): Enables / disables drawing the chart borders (lines surrounding the chart).
• setBorderColor(int color): Sets the color of the chart border lines.
• setBorderWidth(float width): Sets the width of the chart border lines in dp.
• setMaxVisibleValueCount(int count): Sets the number of maximum visible drawn value-labels on the chart. This only takes affect when setDrawValues() is enabled.