ChartData (MPChartLib v2.1.6 API)

java.lang.Object
- com.github.mikephil.charting.data.ChartData<T>

Direct Known Subclasses:

BarLineScatterCandleBubbleData, PieData, RadarData
```
public abstract class ChartData<T extends DataSet<? extends Entry>>
extends java.lang.Object
```
Class that holds all relevant data that represents the chart. That involves at least one (or more) DataSets, and an array of x-values.

Field Summary

Fields
Modifier and Type	Field and Description
`protected java.util.List<T>`	`mDataSets` array that holds all DataSets the ChartData object represents
`protected int`	`mLastEnd` the last end value used for calcMinMax
`protected int`	`mLastStart` the last start value used for calcMinMax
`protected float`	`mLeftAxisMax`
`protected float`	`mLeftAxisMin`
`protected float`	`mRightAxisMax`
`protected float`	`mRightAxisMin`
`protected java.util.List<java.lang.String>`	`mXVals` holds all x-values the chart represents
`protected float`	`mYMax` maximum y-value in the y-value array across all axes
`protected float`	`mYMin` the minimum y-value in the y-value array across all axes

Constructor Summary

Constructors
Constructor and Description
`ChartData()`
`ChartData(java.util.List<java.lang.String> xVals)` Constructor for only x-values.
`ChartData(java.util.List<java.lang.String> xVals, java.util.List<T> sets)` constructor for chart data
`ChartData(java.lang.String[] xVals)` Constructor for only x-values.
`ChartData(java.lang.String[] xVals, java.util.List<T> sets)` constructor that takes string array instead of List string

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addDataSet(T d)` Adds a DataSet dynamically.
`void`	`addEntry(Entry e, int dataSetIndex)` Adds an Entry to the DataSet at the specified index.
`void`	`addXValue(java.lang.String xVal)` Adds a new x-value to the chart data.
`void`	`calcMinMax(int start, int end)` calc minimum and maximum y value over all datasets
`protected void`	`calcYValueCount()` Calculates the total number of y-values across all DataSets the ChartData represents.
`protected void`	`calcYValueSum()` calculates the sum of all y-values in all datasets
`void`	`clearValues()` Clears this data object from all DataSets and removes all Entries.
`boolean`	`contains(Entry e)` Checks if this data object contains the specified Entry.
`boolean`	`contains(T dataSet)` Checks if this data object contains the specified DataSet.
`static java.util.List<java.lang.String>`	`generateXVals(int from, int to)` Generates an x-values array filled with numbers in range specified by the parameters.
`float`	`getAverage()` Returns the average value across all entries in this Data object (all entries from the DataSets this data object holds)
`int[]`	`getColors()` Returns all colors used across all DataSet objects this object represents.
`T`	`getDataSetByIndex(int index)` Returns the DataSet object at the given index.
`T`	`getDataSetByLabel(java.lang.String label, boolean ignorecase)` Returns the DataSet object with the given label.
`int`	`getDataSetCount()` returns the number of LineDataSets this object contains
`T`	`getDataSetForEntry(Entry e)` Returns the DataSet that contains the provided Entry, or null, if no DataSet contains this Entry.
`protected int`	`getDataSetIndexByLabel(java.util.List<T> dataSets, java.lang.String label, boolean ignorecase)` Retrieve the index of a DataSet with a specific label from the ChartData.
`protected java.lang.String[]`	`getDataSetLabels()` Returns the labels of all DataSets as a string array.
`java.util.List<T>`	`getDataSets()` Returns an the array of DataSets this object holds.
`Entry`	`getEntryForHighlight(Highlight highlight)` Get the Entry for a corresponding highlight object
`T`	`getFirstLeft()` Returns the first DataSet from the datasets-array that has it's dependency on the left axis.
`T`	`getFirstRight()` Returns the first DataSet from the datasets-array that has it's dependency on the right axis.
`int`	`getIndexOfDataSet(T dataSet)` Returns the index of the provided DataSet inside the DataSets array of this data object.
`float`	`getXValAverageLength()` returns the average length (in characters) across all values in the x-vals array
`int`	`getXValCount()` returns the total number of x-values this ChartData object represents (the size of the x-values array)
`java.util.List<java.lang.String>`	`getXVals()` returns the x-values the chart represents
`float`	`getYMax()` Returns the greatest y-value the data object contains.
`float`	`getYMax(YAxis.AxisDependency axis)` Returns the maximum y-value for the specified axis.
`float`	`getYMin()` Returns the smallest y-value the data object contains.
`float`	`getYMin(YAxis.AxisDependency axis)` Returns the minimum y-value for the specified axis.
`int`	`getYValCount()` Returns the total number of y-values across all DataSet objects the this object represents.
`float`	`getYValueSum()` Returns the total y-value sum across all DataSet objects the this object represents.
`protected void`	`init()` performs all kinds of initialization calculations, such as min-max and value count and sum
`boolean`	`isHighlightEnabled()` Returns true if highlighting of all underlying values is enabled, false if not.
`void`	`notifyDataChanged()` Call this method to let the CartData know that the underlying data has changed.
`boolean`	`removeDataSet(int index)` Removes the DataSet at the given index in the DataSet array from the data object.
`boolean`	`removeDataSet(T d)` Removes the given DataSet from this data object.
`boolean`	`removeEntry(Entry e, int dataSetIndex)` Removes the given Entry object from the DataSet at the specified index.
`boolean`	`removeEntry(int xIndex, int dataSetIndex)` Removes the Entry object at the given xIndex from the DataSet at the specified index.
`void`	`removeXValue(int index)` Removes the x-value at the specified index.
`void`	`setDrawValues(boolean enabled)` Enables / disables drawing values (value-text) for all DataSets this data object contains.
`void`	`setHighlightEnabled(boolean enabled)` Enables / disables highlighting values for all DataSets this data object contains.
`void`	`setValueFormatter(ValueFormatter f)` Sets a custom ValueFormatter for all DataSets this data object contains.
`void`	`setValueTextColor(int color)` Sets the color of the value-text (color in which the value-labels are drawn) for all DataSets this data object contains.
`void`	`setValueTextSize(float size)` Sets the size (in dp) of the value-text for all DataSets this data object contains.
`void`	`setValueTypeface(android.graphics.Typeface tf)` Sets the Typeface for all value-labels for all DataSets this data object contains.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - mYMax
```
protected float mYMax
```
    maximum y-value in the y-value array across all axes
  - mYMin
```
protected float mYMin
```
    the minimum y-value in the y-value array across all axes
  - mLeftAxisMax
```
protected float mLeftAxisMax
```
  - mLeftAxisMin
```
protected float mLeftAxisMin
```
  - mRightAxisMax
```
protected float mRightAxisMax
```
  - mRightAxisMin
```
protected float mRightAxisMin
```
  - mLastStart
```
protected int mLastStart
```
    the last start value used for calcMinMax
  - mLastEnd
```
protected int mLastEnd
```
    the last end value used for calcMinMax
  - mXVals
```
protected java.util.List<java.lang.String> mXVals
```
    holds all x-values the chart represents
  - mDataSets
```
protected java.util.List<T extends DataSet<? extends Entry>> mDataSets
```
    array that holds all DataSets the ChartData object represents
- Constructor Detail
  - ChartData
```
public ChartData()
```
  - ChartData
```
public ChartData(java.util.List<java.lang.String> xVals)
```
    Constructor for only x-values. This constructor can be used for setting up an empty chart without data.
    
    Parameters:
    
    xVals -
  - ChartData
```
public ChartData(java.lang.String[] xVals)
```
    Constructor for only x-values. This constructor can be used for setting up an empty chart without data.
    
    Parameters:
    
    xVals -
  - ChartData
```
public ChartData(java.util.List<java.lang.String> xVals,
                 java.util.List<T> sets)
```
    constructor for chart data
    
    Parameters:
    
    xVals - The values describing the x-axis. Must be at least as long as the highest xIndex in the Entry objects across all DataSets.
    
    sets - the dataset array
  - ChartData
```
public ChartData(java.lang.String[] xVals,
                 java.util.List<T> sets)
```
    constructor that takes string array instead of List string
    
    Parameters:
    
    xVals - The values describing the x-axis. Must be at least as long as the highest xIndex in the Entry objects across all DataSets.
    
    sets - the dataset array
- Method Detail
  - init
```
protected void init()
```
    performs all kinds of initialization calculations, such as min-max and value count and sum
  - notifyDataChanged
```
public void notifyDataChanged()
```
    Call this method to let the CartData know that the underlying data has changed.
  - calcMinMax
```
public void calcMinMax(int start,
                       int end)
```
    calc minimum and maximum y value over all datasets
  - calcYValueSum
```
protected void calcYValueSum()
```
    calculates the sum of all y-values in all datasets
  - calcYValueCount
```
protected void calcYValueCount()
```
    Calculates the total number of y-values across all DataSets the ChartData represents.
  - getDataSetCount
```
public int getDataSetCount()
```
    returns the number of LineDataSets this object contains
    
    Returns:
  - getAverage
```
public float getAverage()
```
    Returns the average value across all entries in this Data object (all entries from the DataSets this data object holds)
    
    Returns:
  - getYMin
```
public float getYMin()
```
    Returns the smallest y-value the data object contains.
    
    Returns:
  - getYMin
```
public float getYMin(YAxis.AxisDependency axis)
```
    Returns the minimum y-value for the specified axis.
    
    Parameters:
    
    axis -
    
    Returns:
  - getYMax
```
public float getYMax()
```
    Returns the greatest y-value the data object contains.
    
    Returns:
  - getYMax
```
public float getYMax(YAxis.AxisDependency axis)
```
    Returns the maximum y-value for the specified axis.
    
    Parameters:
    
    axis -
    
    Returns:
  - getXValAverageLength
```
public float getXValAverageLength()
```
    returns the average length (in characters) across all values in the x-vals array
    
    Returns:
  - getYValueSum
```
public float getYValueSum()
```
    Returns the total y-value sum across all DataSet objects the this object represents.
    
    Returns:
  - getYValCount
```
public int getYValCount()
```
    Returns the total number of y-values across all DataSet objects the this object represents.
    
    Returns:
  - getXVals
```
public java.util.List<java.lang.String> getXVals()
```
    returns the x-values the chart represents
    
    Returns:
  - addXValue
```
public void addXValue(java.lang.String xVal)
```
    Adds a new x-value to the chart data.
    
    Parameters:
    
    xVal -
  - removeXValue
```
public void removeXValue(int index)
```
    Removes the x-value at the specified index.
    
    Parameters:
    
    index -
  - getDataSets
```
public java.util.List<T> getDataSets()
```
    Returns an the array of DataSets this object holds.
    
    Returns:
  - getDataSetIndexByLabel
```
protected int getDataSetIndexByLabel(java.util.List<T> dataSets,
                                     java.lang.String label,
                                     boolean ignorecase)
```
    Retrieve the index of a DataSet with a specific label from the ChartData. Search can be case sensitive or not. IMPORTANT: This method does calculations at runtime, do not over-use in performance critical situations.
    
    Parameters:
    
    dataSets - the DataSet array to search
    
    label -
    
    ignorecase - if true, the search is not case-sensitive
    
    Returns:
  - getXValCount
```
public int getXValCount()
```
    returns the total number of x-values this ChartData object represents (the size of the x-values array)
    
    Returns:
  - getDataSetLabels
```
protected java.lang.String[] getDataSetLabels()
```
    Returns the labels of all DataSets as a string array.
    
    Returns:
  - getEntryForHighlight
```
public Entry getEntryForHighlight(Highlight highlight)
```
    Get the Entry for a corresponding highlight object
    
    Parameters:
    
    highlight -
    
    Returns:
    
    the entry that is highlighted
  - getDataSetByLabel
```
public T getDataSetByLabel(java.lang.String label,
                           boolean ignorecase)
```
    Returns the DataSet object with the given label. Search can be case sensitive or not. IMPORTANT: This method does calculations at runtime. Use with care in performance critical situations.
    
    Parameters:
    
    label -
    
    ignorecase -
    
    Returns:
  - getDataSetByIndex
```
public T getDataSetByIndex(int index)
```
    Returns the DataSet object at the given index.
    
    Parameters:
    
    index -
    
    Returns:
  - addDataSet
```
public void addDataSet(T d)
```
    Adds a DataSet dynamically.
    
    Parameters:
    
    d -
  - removeDataSet
```
public boolean removeDataSet(T d)
```
    Removes the given DataSet from this data object. Also recalculates all minimum and maximum values. Returns true if a DataSet was removed, false if no DataSet could be removed.
    
    Parameters:
    
    d -
  - removeDataSet
```
public boolean removeDataSet(int index)
```
    Removes the DataSet at the given index in the DataSet array from the data object. Also recalculates all minimum and maximum values. Returns true if a DataSet was removed, false if no DataSet could be removed.
    
    Parameters:
    
    index -
  - addEntry
```
public void addEntry(Entry e,
                     int dataSetIndex)
```
    Adds an Entry to the DataSet at the specified index. Entries are added to the end of the list.
    
    Parameters:
    
    e -
    
    dataSetIndex -
  - removeEntry
```
public boolean removeEntry(Entry e,
                           int dataSetIndex)
```
    Removes the given Entry object from the DataSet at the specified index.
    
    Parameters:
    
    e -
    
    dataSetIndex -
  - removeEntry
```
public boolean removeEntry(int xIndex,
                           int dataSetIndex)
```
    Removes the Entry object at the given xIndex from the DataSet at the specified index. Returns true if an Entry was removed, false if no Entry was found that meets the specified requirements.
    
    Parameters:
    
    xIndex -
    
    dataSetIndex -
    
    Returns:
  - getDataSetForEntry
```
public T getDataSetForEntry(Entry e)
```
    Returns the DataSet that contains the provided Entry, or null, if no DataSet contains this Entry.
    
    Parameters:
    
    e -
    
    Returns:
  - getColors
```
public int[] getColors()
```
    Returns all colors used across all DataSet objects this object represents.
    
    Returns:
  - getIndexOfDataSet
```
public int getIndexOfDataSet(T dataSet)
```
    Returns the index of the provided DataSet inside the DataSets array of this data object. Returns -1 if the DataSet was not found.
    
    Parameters:
    
    dataSet -
    
    Returns:
  - getFirstLeft
```
public T getFirstLeft()
```
    Returns the first DataSet from the datasets-array that has it's dependency on the left axis. Returns null if no DataSet with left dependency could be found.
    
    Returns:
  - getFirstRight
```
public T getFirstRight()
```
    Returns the first DataSet from the datasets-array that has it's dependency on the right axis. Returns null if no DataSet with right dependency could be found.
    
    Returns:
  - generateXVals
```
public static java.util.List<java.lang.String> generateXVals(int from,
                                                             int to)
```
    Generates an x-values array filled with numbers in range specified by the parameters. Can be used for convenience.
    
    Returns:
  - setValueFormatter
```
public void setValueFormatter(ValueFormatter f)
```
    Sets a custom ValueFormatter for all DataSets this data object contains.
    
    Parameters:
    
    f -
  - setValueTextColor
```
public void setValueTextColor(int color)
```
    Sets the color of the value-text (color in which the value-labels are drawn) for all DataSets this data object contains.
    
    Parameters:
    
    color -
  - setValueTypeface
```
public void setValueTypeface(android.graphics.Typeface tf)
```
    Sets the Typeface for all value-labels for all DataSets this data object contains.
    
    Parameters:
    
    tf -
  - setValueTextSize
```
public void setValueTextSize(float size)
```
    Sets the size (in dp) of the value-text for all DataSets this data object contains.
    
    Parameters:
    
    size -
  - setDrawValues
```
public void setDrawValues(boolean enabled)
```
    Enables / disables drawing values (value-text) for all DataSets this data object contains.
    
    Parameters:
    
    enabled -
  - setHighlightEnabled
```
public void setHighlightEnabled(boolean enabled)
```
    Enables / disables highlighting values for all DataSets this data object contains. If set to true, this means that values can be highlighted programmatically or by touch gesture.
  - isHighlightEnabled
```
public boolean isHighlightEnabled()
```
    Returns true if highlighting of all underlying values is enabled, false if not.
    
    Returns:
  - clearValues
```
public void clearValues()
```
    Clears this data object from all DataSets and removes all Entries. Don't forget to invalidate the chart after this.
  - contains
```
public boolean contains(Entry e)
```
    Checks if this data object contains the specified Entry. Returns true if so, false if not. NOTE: Performance is pretty bad on this one, do not over-use in performance critical situations.
    
    Parameters:
    
    e -
    
    Returns:
  - contains
```
public boolean contains(T dataSet)
```
    Checks if this data object contains the specified DataSet. Returns true if so, false if not.
    
    Parameters:
    
    dataSet -
    
    Returns:

Class ChartData<T extends DataSet<? extends Entry>>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

mYMax

mYMin

mLeftAxisMax

mLeftAxisMin

mRightAxisMax

mRightAxisMin

mLastStart

mLastEnd

mXVals

mDataSets

Constructor Detail

ChartData

ChartData

ChartData

ChartData

ChartData

Method Detail

init

notifyDataChanged

calcMinMax

calcYValueSum

calcYValueCount

getDataSetCount

getAverage

getYMin

getYMin

getYMax

getYMax

getXValAverageLength

getYValueSum

getYValCount

getXVals

addXValue

removeXValue

getDataSets

getDataSetIndexByLabel

getXValCount

getDataSetLabels

getEntryForHighlight

getDataSetByLabel

getDataSetByIndex

addDataSet

removeDataSet

removeDataSet

addEntry

removeEntry

removeEntry

getDataSetForEntry

getColors

getIndexOfDataSet

getFirstLeft

getFirstRight

generateXVals

setValueFormatter

setValueTextColor

setValueTypeface

setValueTextSize

setDrawValues

setHighlightEnabled

isHighlightEnabled

clearValues

contains

contains