Pre loader

Android Chart Series Selection

Android Chart - Examples

SciChart Android ships with ~90 Android Chart Examples which you can browse, play with, view the source-code and even export each SciChart Android Chart Example to a stand-alone Android Studio project. All of this is possible with the new and improved SciChart Android Examples Suite, which ships as part of our Android Charts SDK.

Download Scichart Android

Demonstrates the use of the SeriesSelectionModifier, which hooks into the ChartModifier API to select series when you tap on it.

Tip!

The selected series is styled via the setSelectedSeriesStyle() method of SeriesSelectionModifier. A blanket style applied to any series which is selected. Also you can use the setSelectedSeriesStyle() on any RenderableSeries to achieve the same effect on an individual series level.

The full source code for the Android Chart Series Selection example is included below (Scroll down!).

Did you know you can also view the source code from one of the following sources as well?

  1. Clone the SciChart.Android.Examples from Github.
  2. Or, view source and export each example to an Android Studio project from the Java version of the SciChart Android Examples app.
  3. Also the SciChart Android Trial contains the full source for the examples (link below).

DOWNLOAD THE ANDROID CHART EXAMPLES

Kotlin: SeriesSelectionFragment.kt
View source code
//******************************************************************************
// SCICHART® Copyright SciChart Ltd. 2011-2021. All rights reserved.
//
// Web: http://www.scichart.com
// Support: support@scichart.com
// Sales:   sales@scichart.com
//
// SeriesSelectionFragment.kt is part of SCICHART®, High Performance Scientific Charts
// For full terms and conditions of the license, see http://www.scichart.com/scichart-eula/
//
// This source code is protected by international copyright law. Unauthorized
// reproduction, reverse-engineering, or distribution of all or any portion of
// this source code is strictly prohibited.
//
// This source code contains confidential and proprietary trade secrets of
// SciChart Ltd., and should at no time be copied, transferred, sold,
// distributed or made available without express written permission.
//******************************************************************************

package com.scichart.examples.fragments.examples2d.tooltipsAndHitTest.kt

import android.view.animation.AccelerateDecelerateInterpolator
import android.view.animation.DecelerateInterpolator
import com.scichart.charting.visuals.SciChartSurface
import com.scichart.charting.visuals.axes.AutoRange.Always
import com.scichart.charting.visuals.axes.AxisAlignment.*
import com.scichart.charting.visuals.pointmarkers.EllipsePointMarker
import com.scichart.charting.visuals.pointmarkers.IPointMarker
import com.scichart.charting.visuals.renderableSeries.IRenderableSeries
import com.scichart.charting.visuals.renderableSeries.StyleBase
import com.scichart.drawing.common.PenStyle
import com.scichart.drawing.utility.ColorUtil
import com.scichart.examples.R
import com.scichart.examples.data.DataManager
import com.scichart.examples.fragments.base.ExampleSingleChartBaseFragment
import com.scichart.examples.utils.Constant
import com.scichart.examples.utils.interpolator.DefaultInterpolator
import com.scichart.examples.utils.scichartExtensions.*

class SeriesSelectionFragment : ExampleSingleChartBaseFragment() {

    override fun showDefaultModifiersInToolbar(): Boolean = false

    override fun initExample(surface: SciChartSurface) {
        surface.theme = R.style.SciChart_NavyBlue

        surface.suspendUpdates {
            xAxes { numericAxis { axisAlignment = Bottom; autoRange = Always } }
            yAxes {
                numericAxis { axisAlignment = Left; axisId = Left.name}
                numericAxis { axisAlignment = Right; axisId = Right.name}
            }
            renderableSeries {
                var initialColor = ColorUtil.Blue
                for (i in 0 until SERIES_COUNT) {
                    val alignment = if (i % 2 == 0) Left else Right
                    val gradient = (if (alignment == Right) i else -i).toDouble()
                    val start = if (alignment == Right) 0.0 else 14000.0
                    val straightLine = DataManager.getInstance().getStraightLine(gradient, start, SERIES_POINT_COUNT)

                    fastLineRenderableSeries {
                        yAxisId = alignment.name
                        strokeStyle = SolidPenStyle(initialColor)
                        xyDataSeries<Double, Double>("Series $i") {
                            append(straightLine.xValues, straightLine.yValues)
                        }

                        sweepAnimation {
                            interpolator = DefaultInterpolator.getInterpolator()
                            duration = Constant.ANIMATION_DURATION
                            startDelay = Constant.ANIMATION_START_DELAY
                        }
                    }

                    val red = ColorUtil.red(initialColor)
                    val green = ColorUtil.green(initialColor)
                    val blue = ColorUtil.blue(initialColor)

                    val newR = if (red == 255) 255 else red + 5
                    val newB = if (blue == 0) 0 else blue - 2

                    initialColor = ColorUtil.rgb(newR, green, newB)
                }
            }

            chartModifiers {
                seriesSelectionModifier {
                    selectedSeriesStyle = object : StyleBase<IRenderableSeries>(IRenderableSeries::class.java) {
                        private val STROKE = "Stroke"
                        private val POINT_MARKER = "PointMarker"

                        private val selectedStrokeStyle = SolidPenStyle(ColorUtil.White, 4f)
                        private val selectedPointMarker: IPointMarker = EllipsePointMarker().apply {
                            setSize(10)
                            fillStyle = SolidBrushStyle(0xFFFF00DC)
                            strokeStyle = SolidPenStyle(ColorUtil.White)
                        }

                        override fun applyStyleInternal(renderableSeriesToStyle: IRenderableSeries) {
                            putPropertyValue(renderableSeriesToStyle, STROKE, renderableSeriesToStyle.strokeStyle);
                            putPropertyValue(renderableSeriesToStyle, POINT_MARKER, renderableSeriesToStyle.pointMarker);

                            renderableSeriesToStyle.strokeStyle = selectedStrokeStyle
                            renderableSeriesToStyle.pointMarker = selectedPointMarker
                        }

                        override fun discardStyleInternal(renderableSeriesToStyle: IRenderableSeries) {
                            renderableSeriesToStyle.strokeStyle = getPropertyValue(renderableSeriesToStyle, STROKE, PenStyle::class.java)
                            renderableSeriesToStyle.pointMarker = getPropertyValue(renderableSeriesToStyle, POINT_MARKER, IPointMarker::class.java)
                        }
                    }
                }
            }
        }
    }

    companion object {
        private const val SERIES_POINT_COUNT = 50
        private const val SERIES_COUNT = 80
    }
}
Java: SeriesSelectionFragment.java
View source code
//******************************************************************************
// SCICHART® Copyright SciChart Ltd. 2011-2021. All rights reserved.
//
// Web: http://www.scichart.com
// Support: support@scichart.com
// Sales:   sales@scichart.com
//
// SeriesSelectionFragment.java is part of SCICHART®, High Performance Scientific Charts
// For full terms and conditions of the license, see http://www.scichart.com/scichart-eula/
//
// This source code is protected by international copyright law. Unauthorized
// reproduction, reverse-engineering, or distribution of all or any portion of
// this source code is strictly prohibited.
//
// This source code contains confidential and proprietary trade secrets of
// SciChart Ltd., and should at no time be copied, transferred, sold,
// distributed or made available without express written permission.
//******************************************************************************

package com.scichart.examples.fragments.examples2d.tooltipsAndHitTest;

import android.view.animation.AccelerateDecelerateInterpolator;
import android.view.animation.DecelerateInterpolator;

import androidx.annotation.NonNull;

import com.scichart.charting.model.dataSeries.IDataSeries;
import com.scichart.charting.model.dataSeries.XyDataSeries;
import com.scichart.charting.modifiers.SeriesSelectionModifier;
import com.scichart.charting.visuals.SciChartSurface;
import com.scichart.charting.visuals.axes.AutoRange;
import com.scichart.charting.visuals.axes.AxisAlignment;
import com.scichart.charting.visuals.axes.IAxis;
import com.scichart.charting.visuals.pointmarkers.EllipsePointMarker;
import com.scichart.charting.visuals.pointmarkers.IPointMarker;
import com.scichart.charting.visuals.renderableSeries.FastLineRenderableSeries;
import com.scichart.charting.visuals.renderableSeries.IRenderableSeries;
import com.scichart.charting.visuals.renderableSeries.StyleBase;
import com.scichart.core.framework.UpdateSuspender;
import com.scichart.drawing.common.PenStyle;
import com.scichart.drawing.utility.ColorUtil;
import com.scichart.examples.R;
import com.scichart.examples.data.DataManager;
import com.scichart.examples.data.DoubleSeries;
import com.scichart.examples.fragments.base.ExampleSingleChartBaseFragment;
import com.scichart.examples.utils.Constant;
import com.scichart.examples.utils.interpolator.DefaultInterpolator;

import java.util.Collections;

public class SeriesSelectionFragment extends ExampleSingleChartBaseFragment {
    private static final int SERIES_POINT_COUNT = 50;
    private static final int SERIES_COUNT = 80;

    @Override
    public boolean showDefaultModifiersInToolbar() {
        return false;
    }

    @Override
    protected void initExample(@NonNull SciChartSurface surface) {
        surface.setTheme(R.style.SciChart_NavyBlue);

        final IAxis xAxis = sciChartBuilder.newNumericAxis().withAxisAlignment(AxisAlignment.Bottom).withAutoRangeMode(AutoRange.Always).build();
        final IAxis leftAxis = sciChartBuilder.newNumericAxis().withAxisAlignment(AxisAlignment.Left).withAxisId(AxisAlignment.Left.name()).build();
        final IAxis rightAxis = sciChartBuilder.newNumericAxis().withAxisAlignment(AxisAlignment.Right).withAxisId(AxisAlignment.Right.name()).build();

        final SeriesSelectionModifier seriesSelectionModifier = new SeriesSelectionModifier();

        // set selected style
        seriesSelectionModifier.setSelectedSeriesStyle(new StyleBase<IRenderableSeries>(IRenderableSeries.class) {
            private final PenStyle selectedStrokeStyle = sciChartBuilder.newPen().withColor(ColorUtil.White).withThickness(4f).build();
            private final IPointMarker selectedPointMarker = sciChartBuilder.newPointMarker(new EllipsePointMarker()).withSize(10, 10).withFill(0xFFFF00DC).withStroke(ColorUtil.White, 1f).build();

            private static final String STROKE = "Stroke";
            private static final String POINT_MARKER = "PointMarker";

            @Override
            protected void applyStyleInternal(IRenderableSeries renderableSeriesToStyle) {
                putPropertyValue(renderableSeriesToStyle, STROKE, renderableSeriesToStyle.getStrokeStyle());
                putPropertyValue(renderableSeriesToStyle, POINT_MARKER, renderableSeriesToStyle.getPointMarker());

                renderableSeriesToStyle.setStrokeStyle(selectedStrokeStyle);
                renderableSeriesToStyle.setPointMarker(selectedPointMarker);
            }

            @Override
            protected void discardStyleInternal(IRenderableSeries renderableSeriesToStyle) {
                renderableSeriesToStyle.setStrokeStyle(getPropertyValue(renderableSeriesToStyle, STROKE, PenStyle.class));
                renderableSeriesToStyle.setPointMarker(getPropertyValue(renderableSeriesToStyle, POINT_MARKER, IPointMarker.class));
            }
        });

        UpdateSuspender.using(surface, () -> {
            Collections.addAll(surface.getXAxes(), xAxis);
            Collections.addAll(surface.getYAxes(), leftAxis, rightAxis);
            Collections.addAll(surface.getChartModifiers(), seriesSelectionModifier);

            int initialColor = ColorUtil.Blue;
            for (int i = 0; i < SERIES_COUNT; i++) {
                final AxisAlignment alignment = i % 2 == 0 ? AxisAlignment.Left : AxisAlignment.Right;

                final IDataSeries<?, ?> ds = generateDataSeries(alignment, i);
                final FastLineRenderableSeries rSeries = sciChartBuilder.newLineSeries()
                        .withYAxisId(alignment.name())
                        .withStrokeStyle(initialColor, 1f, true)
                        .withDataSeries(ds)
                        .build();

                surface.getRenderableSeries().add(rSeries);

                final int red = ColorUtil.red(initialColor);
                final int green = ColorUtil.green(initialColor);
                final int blue = ColorUtil.blue(initialColor);

                int newR = red == 255 ? 255 : red + 5;
                int newB = blue == 0 ? 0 : blue - 2;

                initialColor = ColorUtil.rgb(newR, green, newB);

                sciChartBuilder.newAnimator(rSeries).withSweepTransformation().withInterpolator(DefaultInterpolator.getInterpolator()).withDuration(Constant.ANIMATION_DURATION).withStartDelay(Constant.ANIMATION_START_DELAY).start();
            }
        });
    }

    private static IDataSeries<?, ?> generateDataSeries(AxisAlignment axisAlignment, int index) {
        final XyDataSeries<Double, Double> ds = new XyDataSeries<>(Double.class, Double.class);
        ds.setSeriesName(String.format("Series %d", index));

        final double gradient = axisAlignment == AxisAlignment.Right ? index : -index;
        final double start = axisAlignment == AxisAlignment.Right ? 0d : 14000d;

        final DoubleSeries straightLine = DataManager.getInstance().getStraightLine(gradient, start, SERIES_POINT_COUNT);
        ds.append(straightLine.xValues, straightLine.yValues);

        return ds;
    }
}
Back to Android Chart Examples