Class RadarChart

Implementation of the RadarChart, a "spidernet"-like chart. It works best when displaying 5-10 entries per DataSet.

Hierarchy (View Summary)

Constructors

constructor

Properties

animator chartTouchListener customRenderer defaultValueFormatter descPaint disableScrollEnabled doubleTapGestureOptions dragDecelerationEnabled dragDecelerationFrictionCoef drawHighlight drawMarkersEnabled drawWeb extraBottomOffset extraLeftOffset extraRightOffset extraTopOffset highlighter highlightsFilterByAxis indicesToHighlight jobs legendRenderer marker maxHighlightDistance mData mDescription mDisallowInterceptTouchEvent mHighlightPerTapEnabled mInfoPaint minOffset mLegend mRotateEnabled noComputeAutoScaleOnNextDraw noComputeAxisOnNextDraw noDataText offsetsCalculated panGestureOptions pinchGestureOptions renderer rotationGestureOptions tapGestureOptions viewPortHandler webAlpha webColor webColorInner webLineWidth webLineWidthInner xAxis xAxisRenderer yAxis yAxisRenderer

Accessors

center centerOffsets centerOfView chartBitmap contentRect data description diameter extraOffsets factor hasValuesToHighlight highlighted highlightPerTapEnabled infoPaint lastHighlighted legend length maxVisibleValueCount noDataTextColor noDataTextTypeface radius rawRotationAngle requiredBaseOffset requiredLegendOffset rotationAngle rotationEnabled skipWebLineCount sliceAngle viewPortScaleX viewPortScaleY xChartMax xChartMin xRange yChartMax yChartMin yMax yMin yRange

Methods

addEventListener addViewportJob animateX animateXY animateY calcMinMax calculateOffsets clear clearAllViewportJobs clearValues disableScroll disposeNativeView distanceToCenter draw drawDescription drawMarkers enableScroll getAngleForPoint getHighlightByTouchPoint getHighlightByXValue getHighlightsByTouchPoint getIndexForAngle getJobs getMarkerPosition getOrCreateTouchListener getPosition highlight highlights highlightValue highlightValues init initNativeView notifyDataSetChanged onDraw onLayout onSetWidthHeight onSizeChanged removeEventListener removeViewportJob resetTracking setExtraOffsets setupDefaultFormatter

Constructors

constructor

Properties

animator

animator: ChartAnimator

object responsible for animations

chartTouchListener

chartTouchListener: PieRadarChartTouchListener

customRenderer

customRenderer: CustomRenderer

defaultValueFormatter

defaultValueFormatter: DefaultValueFormatter

the default IValueFormatter that has been determined by the chart considering the provided minimum and maximum values, number of digits depends on provided chart-data

descPaint

descPaint: Paint

palet object used for drawing the description text in the bottom right corner of the chart

disableScrollEnabled

disableScrollEnabled: boolean

Wether to disable scroll while touching the chart. Default to true

doubleTapGestureOptions

doubleTapGestureOptions: TapGestureHandlerOptions & { gestureTag?: number }

dragDecelerationEnabled

dragDecelerationEnabled: boolean

If set to true, chart continues to scroll after touch up

dragDecelerationFrictionCoef

dragDecelerationFrictionCoef: number

Deceleration friction coefficient in [0 ; 1] interval, higher values indicate that speed will decrease slowly, for example if it set to 0, it will stop immediately. value must be < 1.0

drawHighlight

drawHighlight: boolean

drawMarkersEnabled

drawMarkersEnabled: boolean

if set to true, the marker view is drawn when a value is clicked

drawWeb

drawWeb: boolean

flag indicating if the web lines should be drawn or not

extraBottomOffset

extraBottomOffset: number

extraLeftOffset

extraLeftOffset: number

extraRightOffset

extraRightOffset: number

extraTopOffset

extraTopOffset: number

Extra offsets to be appended to the viewport

highlighter

highlighter: IHighlighter

highlightsFilterByAxis

highlightsFilterByAxis: boolean

Wether to filter highlights by axis. Default is true

indicesToHighlight

indicesToHighlight: Highlight<Entry>[]

array of Highlight objects that reference the highlighted slices in the chart

Protectedjobs

jobs: any[]

tasks to be done after the view is setup

legendRenderer

legendRenderer: LegendRenderer

Gesture listener for custom callbacks when making gestures on the chart.

marker

marker: IMarker

the view that represents the marker

maxHighlightDistance

maxHighlightDistance: number

The maximum distance in dp away from an entry causing it to highlight.

ProtectedmData

mData: RadarData

object that holds all data that was originally set for the chart, before it was modified or any filtering algorithms had been applied

mDescription

mDescription: Description

the object responsible for representing the description text

mDisallowInterceptTouchEvent

mDisallowInterceptTouchEvent: boolean

ProtectedmHighlightPerTapEnabled

mHighlightPerTapEnabled: boolean

Flag that indicates if highlighting per tap (touch) is enabled

mInfoPaint

mInfoPaint: Paint

palet object for drawing the information text when there are no values in the chart

minOffset

minOffset: number

Sets the minimum offset (padding) around the chart, defaults to 0

ProtectedmLegend

mLegend: Legend

the legend object containing all data associated with the legend

ProtectedmRotateEnabled

mRotateEnabled: boolean

flag that indicates if rotation is enabled or not

noComputeAutoScaleOnNextDraw

noComputeAutoScaleOnNextDraw: boolean

let the chart know it does not need to compute autoScale (it can used the cached ones)

noComputeAxisOnNextDraw

noComputeAxisOnNextDraw: boolean

let the chart know it does not need to compute axis and legends (it can used the cached ones)

noDataText

noDataText: any

text that is displayed when the chart is empty

ProtectedoffsetsCalculated

offsetsCalculated: any

flag that indicates if offsets calculation has already been done or not

panGestureOptions

panGestureOptions: PanGestureHandlerOptions & { gestureTag?: number }

pinchGestureOptions

pinchGestureOptions: PinchGestureHandlerOptions & { gestureTag?: number }

renderer

renderer: RadarChartRenderer

object responsible for rendering the data

rotationGestureOptions

rotationGestureOptions: RotationGestureHandlerOptions & { gestureTag?: number }

tapGestureOptions

tapGestureOptions: TapGestureHandlerOptions & { gestureTag?: number }

viewPortHandler

viewPortHandler: ViewPortHandler

object that manages the bounds and drawing constraints of the chart

webAlpha

webAlpha: number

transparency the grid is drawn with (0-255)

webColor

webColor: string | Color

color for the main web lines

webColorInner

webColorInner: string | Color

color for the inner web

webLineWidth

webLineWidth: number

width of the main web lines

webLineWidthInner

webLineWidthInner: number

width of the inner web lines

xAxis

xAxis: XAxis

the object representing the labels on the x-axis

xAxisRenderer

xAxisRenderer: XAxisRendererRadarChart

yAxis

yAxis: YAxis

the object reprsenting the y-axis labels

yAxisRenderer

yAxisRenderer: YAxisRendererRadarChart

Accessors

center

  • get center(): { x: number; y: number }

  • Returns a recyclable MPPointF instance. Returns the center polet of the chart (the whole View) in pixels.

    Returns { x: number; y: number }

centerOffsets

  • get centerOffsets(): { x: number; y: number }

  • Returns a recyclable MPPointF instance. Returns the center of the chart taking offsets under consideration. (returns the center of the content rectangle)

    Returns { x: number; y: number }

centerOfView

  • get centerOfView(): { x: number; y: number }

  • Returns a recyclable MPPointF instance.

    Returns { x: number; y: number }

chartBitmap

  • get chartBitmap(): any

  • Returns the bitmap that represents the chart.

    Returns any

contentRect

  • get contentRect(): RectF

  • Returns the rectangle that defines the borders of the chart-value surface (into which the actual values are drawn).

    Returns RectF

data

  • get data(): T

  • Returns the ChartData object that has been set for the chart.

    Returns T

  • set data(data: T): void

  • Sets a new data object for the chart. The data object contains all values and information needed for displaying.

    Parameters

    • data: T

    Returns void

description

  • get description(): Description

  • Returns the animator responsible for animating chart values.

    Returns Description

diameter

  • get diameter(): number

  • returns the diameter of the pie- or radar-chart

    Returns number

extraOffsets

  • set extraOffsets(value: [number, number, number, number]): void

  • Sets extra offsets (around the chart view) to be appended to the auto-calculated offsets.

    Parameters

    • value: [number, number, number, number]

    Returns void

factor

  • get factor(): number

  • Returns the factor that is needed to transform values into pixels.

    Returns number

hasValuesToHighlight

  • get hasValuesToHighlight(): boolean

  • Returns true if there are values to highlight, false if there are no values to highlight. Checks if the highlight array is null, has a length of zero or if the first object is null.

    Returns boolean

highlighted

  • get highlighted(): Highlight<Entry>[]

  • Returns the array of currently highlighted values. This might a null or empty array if nothing is highlighted.

    Returns Highlight<Entry>[]

highlightPerTapEnabled

  • get highlightPerTapEnabled(): boolean

  • Returns boolean

  • set highlightPerTapEnabled(enabled: boolean): void

  • Parameters

    • enabled: boolean

    Returns void

infoPaint

  • get infoPaint(): Paint

  • Returns Paint

ProtectedlastHighlighted

  • set lastHighlighted(highs: any): void

  • Sets the last highlighted value for the touchlistener.

    Parameters

    • highs: any

    Returns void

legend

  • get legend(): Legend

  • Returns the Legend object of the chart. This method can be used to get an instance of the legend in order to customize the automatically generated Legend.

    Returns Legend

length

  • get length(): boolean

  • Returns true if the chart is empty (meaning it's data object is either null or contains no entries).

    Returns boolean

maxVisibleValueCount

  • get maxVisibleValueCount(): number

  • Returns number

noDataTextColor

  • set noDataTextColor(color: any): void

  • Sets the color of the no data text.

    Parameters

    • color: any

    Returns void

noDataTextTypeface

  • set noDataTextTypeface(tf: Font): void

  • Sets the typeface to be used for the no data text.

    Parameters

    • tf: Font

    Returns void

radius

  • get radius(): number

  • Returns the radius of the chart in pixels.

    Returns number

rawRotationAngle

  • get rawRotationAngle(): number

  • gets the raw version of the current rotation angle of the pie chart the returned value could be any value, negative or positive, outside of the 360 degrees. this is used when working with rotation direction, mainly by gestures and animations.

    Returns number

ProtectedrequiredBaseOffset

  • get requiredBaseOffset(): number

  • Returns the base offset needed for the chart without calculating the legend size.

    Returns number

ProtectedrequiredLegendOffset

  • get requiredLegendOffset(): number

  • Returns the required offset for the chart legend.

    Returns number

rotationAngle

  • get rotationAngle(): number

  • gets a normalized version of the current rotation angle of the pie chart, which will always be between 0.0 < 360.0

    Returns number

  • set rotationAngle(angle: number): void

  • Set an offset for the rotation of the RadarChart in degrees. Default 270 --> top (NORTH)

    Parameters

    • angle: number

    Returns void

rotationEnabled

  • get rotationEnabled(): boolean

  • Returns true if rotation of the chart by touch is enabled, false if not.

    Returns boolean

  • set rotationEnabled(enabled: boolean): void

  • Set this to true to enable the rotation / spinning of the chart by touch. Set it to false to disable it. Default: true

    Parameters

    • enabled: boolean

    Returns void

skipWebLineCount

  • get skipWebLineCount(): number

  • Returns the modulus that is used for skipping web-lines.

    Returns number

  • set skipWebLineCount(count: number): void

  • Sets the number of web-lines that should be skipped on chart web before the next one is drawn. This targets the lines that come from the center of the RadarChart.

    Parameters

    • count: number

      if count = 1 -> 1 line is skipped in between

    Returns void

sliceAngle

  • get sliceAngle(): number

  • Returns the angle that each slice in the radar chart occupies.

    Returns number

viewPortScaleX

  • get viewPortScaleX(): number

  • Returns number

viewPortScaleY

  • get viewPortScaleY(): number

  • Returns number

xChartMax

  • get xChartMax(): number

  • Returns the maximum x value of the chart, regardless of zoom or translation.

    Returns number

xChartMin

  • get xChartMin(): number

  • Returns the minimum x value of the chart, regardless of zoom or translation.

    Returns number

xRange

  • get xRange(): number

  • Returns number

yChartMax

  • get yChartMax(): number

  • Returns the maximum value this chart can display on it's y-axis.

    Returns number

yChartMin

  • get yChartMin(): number

  • Returns the minimum value this chart can display on it's y-axis.

    Returns number

yMax

  • get yMax(): number

  • returns the current y-max value across all DataSets

    Returns number

yMin

  • get yMin(): number

  • returns the current y-min value across all DataSets

    Returns number

yRange

  • get yRange(): number

  • Returns the range of y-values this chart can display.

    Returns number

Methods

addEventListener

  • addEventListener(
        arg: string | GestureTypes,
        callback: (data: EventData) => void,
        thisArg?: any,
    ): void

  • Parameters

    • arg: string | GestureTypes
    • callback: (data: EventData) => void
    • OptionalthisArg: any

    Returns void

addViewportJob

  • addViewportJob(job: ViewPortJob): void

  • Either posts a job immediately if the chart has already setup it's dimensions or adds the job to the execution queue.

    Parameters

    Returns void

animateX

  • animateX(durationMillis: any, easing?: EasingFunction): void

  • Animates the rendering of the chart on the x-axis with the specified animation time. If animate(...) is called, no further calling of invalidate() is necessary to refresh the chart. ANIMATIONS ONLY WORK FOR API LEVEL 11 (Android 3.0.x) AND HIGHER.

    Parameters

    • durationMillis: any
    • Optionaleasing: EasingFunction

      a custom easing function to be used on the animation phase

    Returns void

animateXY

  • animateXY(
        durationMillisX: any,
        durationMillisY: any,
        easingX?: EasingFunction,
        easingY?: EasingFunction,
    ): void

  • Animates the drawing / rendering of the chart on both x- and y-axis with the specified animation time. If animate(...) is called, no further calling of invalidate() is necessary to refresh the chart. ANIMATIONS ONLY WORK FOR API LEVEL 11 (Android 3.0.x) AND HIGHER.

    Parameters

    • durationMillisX: any
    • durationMillisY: any
    • OptionaleasingX: EasingFunction

      a custom easing function to be used on the animation phase

    • OptionaleasingY: EasingFunction

      a custom easing function to be used on the animation phase

    Returns void

animateY

  • animateY(durationMillis: any, easing?: EasingFunction): void

  • Animates the rendering of the chart on the y-axis with the specified animation time. If animate(...) is called, no further calling of invalidate() is necessary to refresh the chart. ANIMATIONS ONLY WORK FOR API LEVEL 11 (Android 3.0.x) AND HIGHER.

    Parameters

    • durationMillis: any
    • Optionaleasing: EasingFunction

      a custom easing function to be used on the animation phase

    Returns void

ProtectedcalcMinMax

  • calcMinMax(): void

  • Calculates the y-min and y-max value and the y-delta and x-delta value

    Returns void

calculateOffsets

  • calculateOffsets(): void

  • Calculates the offsets of the chart to the border depending on the position of an eventual legend or depending on the length of the y-axis and x-axis labels and their position

    Returns void

clear

  • clear(): void

  • Clears the chart from all data (sets it to null) and refreshes it (by calling invalidate()).

    Returns void

clearAllViewportJobs

clearValues

  • clearValues(): void

  • Removes all DataSets (and thereby Entries) from the chart. Does not set the data object to null. Also refreshes the chart by calling invalidate().

    Returns void

disableScroll

  • disableScroll(): void

  • disables intercept touchevents

    Returns void

disposeNativeView

  • disposeNativeView(): void

  • Clean up references to the native view.

    Returns void

distanceToCenter

  • distanceToCenter(x: number, y: number): number

  • Returns the distance of a certain polet on the chart to the center of the chart.

    Parameters

    • x: number
    • y: number

    Returns number

draw

  • draw(c: Canvas): void

  • Parameters

    • c: Canvas

    Returns void

ProtecteddrawDescription

  • drawDescription(c: Canvas): void

  • Draws the description text in the bottom right corner of the chart (per default)

    Parameters

    • c: Canvas

    Returns void

ProtecteddrawMarkers

  • drawMarkers(canvas: Canvas): void

  • draws all MarkerViews on the highlighted positions

    Parameters

    • canvas: Canvas

    Returns void

enableScroll

  • enableScroll(): void

  • enables intercept touchevents

    Returns void

getAngleForPoint

  • getAngleForPoint(x: any, y: any): number

  • Returns the angle relative to the chart center for the given polet on the chart in degrees. The angle is always between 0 and 360°, 0° is NORTH, 90° is EAST, ...

    Parameters

    • x: any
    • y: any

    Returns number

getHighlightByTouchPoint

  • getHighlightByTouchPoint(x: any, y: any): Highlight<Entry>

  • Returns the Highlight object (contains x-index and DataSet index) of the selected value at the given touch polet inside the Line-, Scatter-, or CandleStick-Chart.

    Parameters

    • x: any
    • y: any

    Returns Highlight<Entry>

getHighlightByXValue

  • getHighlightByXValue(xValue: any): Highlight<Entry>[]

  • Returns the Highlight object (contains x-index and DataSet index) of the selected value at the given touch polet inside the Line-, Scatter-, or CandleStick-Chart.

    Parameters

    • xValue: any

    Returns Highlight<Entry>[]

getHighlightsByTouchPoint

  • getHighlightsByTouchPoint(x: any, y: any): Highlight<Entry>[]

  • Returns the Highlights (contains x-index and DataSet index) of the selected value at the given touch polet inside the Line-, Scatter-, or CandleStick-Chart.

    Parameters

    • x: any
    • y: any

    Returns Highlight<Entry>[]

getIndexForAngle

  • getIndexForAngle(angle: number): number

  • Returns the xIndex for the given angle around the center of the chart. Returns -1 if not found / outofbounds.

    Parameters

    • angle: number

    Returns number

getJobs

  • getJobs(): any[]

  • Returns all jobs that are scheduled to be executed after onSizeChanged(...).

    Returns any[]

ProtectedgetMarkerPosition

getOrCreateTouchListener

getPosition

  • getPosition(
        center: MPPointF,
        dist: number,
        angle: number,
        outputPoint?: MPPointF,
    ): MPPointF

  • Returns a recyclable MPPointF instance. Calculates the position around a center point, depending on the distance from the center, and the angle of the position around the center.

    Parameters

    • center: MPPointF
    • dist: number
    • angle: number

      in degrees, converted to radians internally

    • OptionaloutputPoint: MPPointF

    Returns MPPointF

highlight

  • highlight(
        high: Highlight<Entry> | Highlight<Entry>[],
        callListener?: boolean,
    ): void

  • Highlights the value selected by touch gesture. Unlike highlightValues(...), this generates a callback to the OnChartValueSelectedListener.

    Parameters

    Returns void

highlights

  • highlights(highs: Highlight<Entry>[], callListener?: boolean): void

  • Highlights the value selected by touch gesture. Unlike highlightValues(...), this generates a callback to the OnChartValueSelectedListener.

    Parameters

    • highs: Highlight<Entry>[]
    • OptionalcallListener: boolean

      call the listener

    Returns void

highlightValue

  • highlightValue(x: any, y: any, dataSetIndex: any, callListener?: boolean): void

  • Highlights any y-value at the given x-value in the given DataSet. Provide -1 as the dataSetIndex to undo all highlighting.

    Parameters

    • x: any

      The x-value to highlight

    • y: any

      The y-value to highlight. Supply NaN for "any"

    • dataSetIndex: any

      The dataset index to search in

    • OptionalcallListener: boolean

      Should the listener be called for this change

    Returns void

highlightValues

  • highlightValues(highs: any): void

  • Highlights the values at the given indices in the given DataSets. Provide null or an empty array to undo all highlighting. This should be used to programmatically highlight values. This method will not call the listener.

    Parameters

    • highs: any

    Returns void

Protectedinit

  • init(): void

  • initialize all paints and stuff

    Returns void

initNativeView

  • initNativeView(): void

  • Initializes properties/listeners of the native view.

    Returns void

notifyDataSetChanged

  • notifyDataSetChanged(): void

  • Lets the chart know its underlying data has changed and performs all necessary recalculations. It is crucial that this method is called everytime data is changed dynamically. Not calling this method can lead to crashes or unexpected behaviour.

    Returns void

onDraw

  • onDraw(canvas: Canvas): void

  • Parameters

    • canvas: Canvas

    Returns void

onLayout

  • onLayout(left: number, top: number, right: number, bottom: number): void

  • Called from layout when this view should assign a size and position to each of its children. Derived classes with children should override this method and call layout on each of their children.

    Parameters

    • left: number

      Left position, relative to parent

    • top: number

      Top position, relative to parent

    • right: number

      Right position, relative to parent

    • bottom: number

      Bottom position, relative to parent

    Returns void

onSetWidthHeight

  • onSetWidthHeight(w: number, h: number): void

  • Parameters

    • w: number
    • h: number

    Returns void

onSizeChanged

  • onSizeChanged(w: number, h: number, oldw: number, oldh: number): void

  • Parameters

    • w: number
    • h: number
    • oldw: number
    • oldh: number

    Returns void

removeEventListener

  • removeEventListener(
        arg: string | GestureTypes,
        callback?: any,
        thisArg?: any,
    ): void

  • Parameters

    • arg: string | GestureTypes
    • Optionalcallback: any
    • OptionalthisArg: any

    Returns void

removeViewportJob

resetTracking

  • resetTracking(): void

  • RESET PERFORMANCE TRACKING FIELDS

    Returns void

setExtraOffsets

  • setExtraOffsets(left: any, top: any, right: any, bottom: any): void

  • Sets extra offsets (around the chart view) to be appended to the auto-calculated offsets.

    Parameters

    • left: any
    • top: any
    • right: any
    • bottom: any

    Returns void

ProtectedsetupDefaultFormatter

  • setupDefaultFormatter(min: any, max: any): void

  • Calculates the required number of digits for the values that might be drawn in the chart (if enabled), and creates the default-value-formatter

    Parameters

    • min: any
    • max: any

    Returns void

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods