Vico

https://www.patrykandpatrick.com/vico/guide/stable
Admin
Vico is a powerful and extensible multiplatform chart library with native support for Jetpack...
Tokens:195,487
Snippets:1,213
Trust Score:5.4
Update:1 year ago
Show doc for...
Tokens:
Raw
### Basic Line Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/axis

Provides an example of creating a basic line chart with the Vico library. This snippet likely demonstrates how to render line series and configure axes.

```kotlin
import androidx.compose.runtime.Composable
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.LineSeries
import com.patrykandpatrick.vico.core.entry.ChartEntryModel

@Composable
fun BasicLineChart(model: ChartEntryModel) {
    CartesianChart(
        model = model,
        topAxis = null,
        bottomAxis = null,
        startAxis = null,
        endAxis = null,
        marker = null,
        legend = null,
        isScrollEnabled = false,
        runInitialAnimation = true,
        chartModelProducer = null,
        chartScrollSpec = null,
        chartZoomSpec = null,
        layoutDirection = null,
        modifier = null,
        graphicsLayer = null,
        overlay = null,
        diffAnimationSpec = null,
        persistentMarkers = null,
        chartState = null,
        onZoom = null,
        onScroll = null,
        onApiEvent = null,
        onDraw = null,
        onLayout = null,
        onAttachedToWindow = null,
        onDetachedFromWindow = null,
        onGloballyPositioned = null,
        onPointerInput = null,
        content = {
            LineSeries(
                model = model,
                spacing = "12dp",
                lineSpec = null,
                selection = null,
                selectionOffset = "0dp",
                selectionOffsetProvider = null,
                modifier = null,
                persistentMarker = null,
                onClick = null
            )
        }
    )
}
```

--------------------------------

### Basic Column Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/axis

Demonstrates the implementation of a basic column chart using the Vico library. This example likely showcases fundamental chart setup and data binding.

```kotlin
import androidx.compose.runtime.Composable
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.ColumnSeries
import com.patrykandpatrick.vico.core.entry.ChartEntryModel

@Composable
fun BasicColumnChart(model: ChartEntryModel) {
    CartesianChart(
        model = model,
        topAxis = null,
        bottomAxis = null,
        startAxis = null,
        endAxis = null,
        marker = null,
        legend = null,
        isScrollEnabled = false,
        runInitialAnimation = true,
        chartModelProducer = null,
        chartScrollSpec = null,
        chartZoomSpec = null,
        layoutDirection = null,
        modifier = null,
        graphicsLayer = null,
        overlay = null,
        diffAnimationSpec = null,
        persistentMarkers = null,
        chartState = null,
        onZoom = null,
        onScroll = null,
        onApiEvent = null,
        onDraw = null,
        onLayout = null,
        onAttachedToWindow = null,
        onDetachedFromWindow = null,
        onGloballyPositioned = null,
        onPointerInput = null,
        content = {
            ColumnSeries(
                model = model,
                spacing = "12dp",
                cornerRadius = "4dp",
                innerSpacing = "2dp",
                dataLabel = null,
                dataLabelFormatter = null,
                selection = null,
                selectionOffset = "0dp",
                selectionOffsetProvider = null,
                modifier = null,
                persistentMarker = null,
                onClick = null
            )
        }
    )
}
```

--------------------------------

### Basic Line Chart Example (Compose & Views)

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/cartesian-layer

Demonstrates a basic line chart. Includes implementations for both Jetpack Compose and Android Views.

```kotlin
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.LineCartesianLayer
import com.patrykandpatrick.vico.core.entry.ChartEntryModel

@Composable
fun BasicLineChart(model: ChartEntryModel) {
    CartesianChart(
        chart = lineChart(),
        model = model
    )
}
```

```java
import com.patrykandpatrick.vico.core.chart.CartesianChart;
import com.patrykandpatrick.vico.core.chart.layers.LineCartesianLayer;
import com.patrykandpatrick.vico.core.entry.ChartEntryModel;
import android.content.Context;
import android.util.AttributeSet;
import android.view.View;

public class BasicLineChartView extends View {
    private CartesianChart chart;

    public BasicLineChartView(Context context) {
        super(context);
        initChart();
    }

    public BasicLineChartView(Context context, AttributeSet attrs) {
        super(context, attrs);
        initChart();
    }

    private void initChart() {
        chart = new CartesianChart(
            LineCartesianLayer.create(),
            // other layers and configurations
        );
    }

    // ... methods to set model and draw chart
}
```

--------------------------------

### Basic Column Chart Example (Compose & Views)

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/cartesian-layer

Demonstrates a basic column chart. Includes implementations for both Jetpack Compose and Android Views.

```kotlin
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.ColumnCartesianLayer
import com.patrykandpatrick.vico.core.entry.ChartEntryModel

@Composable
fun BasicColumnChart(model: ChartEntryModel) {
    CartesianChart(
        chart = columnChart(),
        model = model
    )
}
```

```java
import com.patrykandpatrick.vico.core.chart.CartesianChart;
import com.patrykandpatrick.vico.core.chart.layers.ColumnCartesianLayer;
import com.patrykandpatrick.vico.core.entry.ChartEntryModel;
import android.content.Context;
import android.util.AttributeSet;
import android.view.View;

public class BasicColumnChartView extends View {
    private CartesianChart chart;

    public BasicColumnChartView(Context context) {
        super(context);
        initChart();
    }

    public BasicColumnChartView(Context context, AttributeSet attrs) {
        super(context, attrs);
        initChart();
    }

    private void initChart() {
        chart = new CartesianChart(
            ColumnCartesianLayer.create(),
            // other layers and configurations
        );
    }

    // ... methods to set model and draw chart
}
```

--------------------------------

### Asking Questions and Sharing Ideas

Source: https://www.patrykandpatrick.com/vico/guide/stable/contributing

Instructions for asking questions or sharing ideas about Vico by starting a discussion on the Vico GitHub repository.

```text
To ask a question or share an idea, [start a discussion](https://github.com/patrykandpatrick/vico/discussions/new/choose).
```

--------------------------------

### Basic Combo Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/axis

Illustrates how to create a combo chart, which typically combines different chart types like columns and lines, using Vico. This example would show layering of series.

```kotlin
import androidx.compose.runtime.Composable
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.ColumnSeries
import com.patrykandpatrick.vico.compose.chart.layers.LineSeries
import com.patrykandpatrick.vico.core.entry.ChartEntryModel

@Composable
fun BasicComboChart(model: ChartEntryModel) {
    CartesianChart(
        model = model,
        topAxis = null,
        bottomAxis = null,
        startAxis = null,
        endAxis = null,
        marker = null,
        legend = null,
        isScrollEnabled = false,
        runInitialAnimation = true,
        chartModelProducer = null,
        chartScrollSpec = null,
        chartZoomSpec = null,
        layoutDirection = null,
        modifier = null,
        graphicsLayer = null,
        overlay = null,
        diffAnimationSpec = null,
        persistentMarkers = null,
        chartState = null,
        onZoom = null,
        onScroll = null,
        onApiEvent = null,
        onDraw = null,
        onLayout = null,
        onAttachedToWindow = null,
        onDetachedFromWindow = null,
        onGloballyPositioned = null,
        onPointerInput = null,
        content = {
            ColumnSeries(model = model)
            LineSeries(model = model)
        }
    )
}
```

--------------------------------

### Basic Column Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/cartesian-chart

Demonstrates the implementation of a basic column chart using the Vico library. This sample likely showcases setting up the chart, providing data, and basic customization options.

```Kotlin
package com.patrykandpatrick.vico.sample.multiplatform

import androidx.compose.runtime.Composable
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.ColumnSeries
import com.patrykandpatrick.vico.compose.chart.layout.fullWidth
import com.patrykandpatrick.vico.compose.chart.marker.marker
import com.patrykandpatrick.vico.compose.style.ChartStyle
import com.patrykandpatrick.vico.core.chart.decoration.ThresholdLine
import com.patrykandpatrick.vico.core.chart.values.AxisValues
import com.patrykandpatrick.vico.core.entry.ChartEntryModel
import com.patrykandpatrick.vico.core.entry.ChartEntryModelProducer

@Composable
fun BasicColumnChart()
{
    val data = ChartEntryModelProducer(listOf(1f, 2f, 4f, 2f, 5f, 3f, 6f))

    CartesianChart(
        chartModel = data,
        modifier = ChartStyle.fullWidth(),
        marker = marker(
            label = { entry -> entry.y.toString() },
            indicator = { entry -> entry.y.toString() }
        ),
        topAxisLabels = listOf("A", "B", "C", "D", "E", "F", "G")
    )
}

```

--------------------------------

### Basic Line Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/cartesian-chart

Illustrates how to create a basic line chart with the Vico library. This sample would typically cover data binding, axis configuration, and potentially styling for line charts.

```Kotlin
package com.patrykandpatrick.vico.sample.multiplatform

import androidx.compose.runtime.Composable
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.LineSeries
import com.patrykandpatrick.vico.compose.chart.layout.fullWidth
import com.patrykandpatrick.vico.compose.chart.marker.marker
import com.patrykandpatrick.vico.compose.style.ChartStyle
import com.patrykandpatrick.vico.core.entry.ChartEntryModelProducer

@Composable
fun BasicLineChart()
{
    val data = ChartEntryModelProducer(listOf(1f, 3f, 2f, 4f, 5f, 3f, 6f))

    CartesianChart(
        chartModel = data,
        modifier = ChartStyle.fullWidth(),
        marker = marker(
            label = { entry -> entry.y.toString() },
            indicator = { entry -> entry.y.toString() }
        ),
        topAxisLabels = listOf("A", "B", "C", "D", "E", "F", "G")
    )
}

```

--------------------------------

### Vico API Reference Overview

Source: https://www.patrykandpatrick.com/vico/guide/stable/learning-resources

Provides links to the comprehensive API reference for Vico, detailing every public API element. Users can follow links within the guide to explore specific classes, functions, and properties.

```APIDOC
API Reference:
  URL: https://www.patrykandpatrick.com/vico/api/stable/index.html
  Description: Describes every public API element in Vico.
  Usage: Follow links within the Vico guide to access detailed information on classes, functions, and properties.
```

--------------------------------

### Basic Line Chart Setup

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/views/cartesian-charts/starter-examples

Configures a CartesianChartView for a line chart using XML styles and Kotlin code to produce the data series. It sets up the chart to display lines and shows both bottom and start axes.

```xml
<style name="ChartStyle">
    <item name="layers">line</item>
    <item name="showBottomAxis">true</item>
    <item name="showStartAxis">true</item>
</style>

<com.patrykandpatrick.vico.views.cartesian.CartesianChartView
    android:id="@+id/chart_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:chartStyle="@style/ChartStyle" />
```

```kotlin
val modelProducer = CartesianChartModelProducer()
chartView.modelProducer = modelProducer
lifecycleScope.launch {
    modelProducer.runTransaction {
        lineSeries { series(13, 8, 7, 12, 0, 1, 15, 14, 0, 11, 6, 12, 0, 11, 12, 11) }
    }
}
```

--------------------------------

### Daily Digital-Media Use Chart Example (Compose & Views)

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/cartesian-layer

Demonstrates a chart visualizing daily digital-media usage. Includes implementations for both Jetpack Compose and Android Views.

```kotlin
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.core.entry.ChartEntryModel

@Composable
fun DailyDigitalMediaUseChart(model: ChartEntryModel) {
    CartesianChart(
        chart = columnChart(), // or other chart types
        model = model
    )
}
```

```java
import com.patrykandpatrick.vico.core.chart.CartesianChart;
import com.patrykandpatrick.vico.core.entry.ChartEntryModel;
import android.content.Context;
import android.util.AttributeSet;
import android.view.View;

public class DailyDigitalMediaUseChartView extends View {
    // ... chart initialization and drawing logic for digital-media use
}
```

--------------------------------

### Basic Line Chart Implementation

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/cartesian-chart

Demonstrates the implementation of a basic line chart using Vico. Includes examples for both Jetpack Compose and Android Views.

```kotlin
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.LineCartesianLayer
import com.patrykandpatrick.vico.compose.chart.layout.fullWidth
import com.patrykandpatrick.vico.compose.chart.marker.marker
import com.patrykandpatrick.vico.compose.style.ChartStyle
import com.patrykandpatrick.vico.core.chart.decoration.ThresholdLine
import com.patrykandpatrick.vico.core.entry.ChartEntryModel
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp

@Composable
fun BasicLineChart(model: ChartEntryModel) {
    ChartStyle(lineChart = LineCartesianLayer.LineChart(thickness = 2.dp)) {
        CartesianChart(
            modifier = Modifier.padding(horizontal = 16.dp),
            model = model,
            marker = marker(label = { entry ->
                Text(
                    text = entry.y.toString(),
                    color = Color.White,
                    fontSize = 10.sp
                )
            }),
            runInitialAnimation = true,
            chartModelProducer = remember { ChartModelProducer.build() },
            layout = fullWidth(),
            decorations = remember {
                listOf(
                    ThresholdLine(Color.Gray)
                )
            }
        )
    }
}

```

```java
import com.patrykandpatrick.vico.core.chart.BaseChart
import com.patrykandpatrick.vico.core.chart.layer.LineCartesianLayer
import com.patrykandpatrick.vico.core.chart.layout.HorizontalLayout
import com.patrykandpatrick.vico.core.entry.ChartEntryModel
import com.patrykandpatrick.vico.views.chart.BaseChartView
import com.patrykandpatrick.vico.views.chart.Chart
import com.patrykandpatrick.vico.views.chart.components.DefaultAxis
import com.patrykandpatrick.vico.views.chart.components.DefaultCartesianLayer
import com.patrykandpatrick.vico.views.chart.components.DefaultLifecycleOwner
import com.patrykandpatrick.vico.views.chart.components.DefaultMarker
import com.patrykandpatrick.vico.views.chart.components.DefaultValueFormatter
import com.patrykandpatrick.vico.views.chart.components.LineSpec
import com.patrykandpatrick.vico.views.chart.components.ShapeComponent
import com.patrykandpatrick.vico.views.chart.components.textComponent
import android.content.Context
import android.graphics.Color
import android.graphics.RectF
import android.util.AttributeSet
import android.view.View

class BasicLineChartView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : BaseChartView<ChartEntryModel>(context, attrs, defStyleAttr) {

    private val lineChart = DefaultCartesianLayer.LineCartesianLayer.LineChart(
        lines = listOf(LineSpec(lineColor = Color.Blue, lineThickness = 2f))
    )

    private val marker = DefaultMarker.Marker(
        label = textComponent(textSize = 10f, color = Color.White),
        indicator = ShapeComponent(shape = RectF(0f, 0f, 10f, 10f), color = Color.Blue),
        spacing = 4f,
        indicatorSize = 8f,
        bubbleColor = Color.Black
    )

    private val chart = Chart(
        layers = listOf(lineChart),
        marker = marker,
        layout = HorizontalLayout.fullWidth()
    )

    init {
        this.chart = chart
        this.model = ChartEntryModel.Builder().build()
    }
}

```

--------------------------------

### Line Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/compose/cartesian-charts/starter-examples

Illustrates the creation of a basic line chart. It sets up a CartesianChartModelProducer, adds line series data within a transaction, and displays the chart with appropriate axes.

```kotlin
val modelProducer = remember { CartesianChartModelProducer() }
LaunchedEffect(Unit) {
    modelProducer.runTransaction {
        lineSeries { series(13, 8, 7, 12, 0, 1, 15, 14, 0, 11, 6, 12, 0, 11, 12, 11) }
    }
}
CartesianChartHost(
    rememberCartesianChart(
        rememberLineCartesianLayer(),
        startAxis = VerticalAxis.rememberStart(),
        bottomAxis = HorizontalAxis.rememberBottom(),
    ),
    modelProducer,
)
```

--------------------------------

### Basic Combo Chart Example (Compose & Views)

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/cartesian-layer

Demonstrates a basic combo chart, combining different chart types. Includes implementations for both Jetpack Compose and Android Views.

```kotlin
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.ColumnCartesianLayer
import com.patrykandpatrick.vico.compose.chart.layers.LineCartesianLayer
import com.patrykandpatrick.vico.core.entry.ChartEntryModel

@Composable
fun BasicComboChart(model: ChartEntryModel) {
    CartesianChart(
        chart = comboChart(
            columnLayer = columnChart(),
            lineLayer = lineChart()
        ),
        model = model
    )
}
```

```java
import com.patrykandpatrick.vico.core.chart.CartesianChart;
import com.patrykandpatrick.vico.core.chart.layers.ColumnCartesianLayer;
import com.patrykandpatrick.vico.core.chart.layers.LineCartesianLayer;
import com.patrykandpatrick.vico.core.entry.ChartEntryModel;
import android.content.Context;
import android.util.AttributeSet;
import android.view.View;

public class BasicComboChartView extends View {
    private CartesianChart chart;

    public BasicComboChartView(Context context) {
        super(context);
        initChart();
    }

    public BasicComboChartView(Context context, AttributeSet attrs) {
        super(context, attrs);
        initChart();
    }

    private void initChart() {
        chart = new CartesianChart(
            ColumnCartesianLayer.create(),
            LineCartesianLayer.create(),
            // other layers and configurations
        );
    }

    // ... methods to set model and draw chart
}
```

--------------------------------

### Basic Column Chart Sample

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/column-cartesian-layer

Demonstrates the implementation of a basic column chart using Vico. Includes examples for both Jetpack Compose and Android Views.

```kotlin
https://github.com/patrykandpatrick/vico/blob/v2.1.3/sample/compose/src/main/kotlin/com/patrykandpatrick/vico/sample/compose/BasicColumnChart.kt
```

```java
https://github.com/patrykandpatrick/vico/blob/v2.1.3/sample/views/src/main/kotlin/com/patrykandpatrick/vico/sample/views/BasicColumnChart.kt
```

--------------------------------

### Gold Prices Chart Example (Compose & Views)

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/cartesian-layer

Demonstrates a chart displaying gold prices. Includes implementations for both Jetpack Compose and Android Views.

```kotlin
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.core.entry.ChartEntryModel

@Composable
fun GoldPricesChart(model: ChartEntryModel) {
    CartesianChart(
        chart = lineChart(), // or other chart types
        model = model
    )
}
```

```java
import com.patrykandpatrick.vico.core.chart.CartesianChart;
import com.patrykandpatrick.vico.core.entry.ChartEntryModel;
import android.content.Context;
import android.util.AttributeSet;
import android.view.View;

public class GoldPricesChartView extends View {
    // ... chart initialization and drawing logic for gold prices
}
```

--------------------------------

### Rock–Metal Ratios Chart Example (Compose & Views)

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/cartesian-layer

Demonstrates a chart showing rock-to-metal ratios. Includes implementations for both Jetpack Compose and Android Views.

```kotlin
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.core.entry.ChartEntryModel

@Composable
fun RockMetalRatiosChart(model: ChartEntryModel) {
    CartesianChart(
        chart = lineChart(), // or other chart types
        model = model
    )
}
```

```java
import com.patrykandpatrick.vico.core.chart.CartesianChart;
import com.patrykandpatrick.vico.core.entry.ChartEntryModel;
import android.content.Context;
import android.util.AttributeSet;
import android.view.View;

public class RockMetalRatiosChartView extends View {
    // ... chart initialization and drawing logic for rock-metal ratios
}
```

--------------------------------

### Basic Column Chart Implementation

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/cartesian-chart

Demonstrates the implementation of a basic column chart using Vico. Includes examples for both Jetpack Compose and Android Views.

```kotlin
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.ColumnCartesianLayer
import com.patrykandpatrick.vico.compose.chart.layout.fullWidth
import com.patrykandpatrick.vico.compose.chart.marker.marker
import com.patrykandpatrick.vico.compose.style.ChartStyle
import com.patrykandpatrick.vico.core.chart.decoration.ThresholdLine
import com.patrykandpatrick.vico.core.entry.ChartEntryModel
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp

@Composable
fun BasicColumnChart(model: ChartEntryModel) {
    ChartStyle(columnChart = ColumnCartesianLayer.ColumnChart(thickness = 8.dp)) {
        CartesianChart(
            modifier = Modifier.padding(horizontal = 16.dp),
            model = model,
            marker = marker(label = { entry ->
                Text(
                    text = entry.y.toString(),
                    color = Color.White,
                    fontSize = 10.sp
                )
            }),
            runInitialAnimation = true,
            chartModelProducer = remember { ChartModelProducer.build() },
            layout = fullWidth(),
            decorations = remember {
                listOf(
                    ThresholdLine(Color.Gray)
                )
            }
        )
    }
}

```

```java
import com.patrykandpatrick.vico.core.chart.BaseChart
import com.patrykandpatrick.vico.core.chart.layer.ColumnCartesianLayer
import com.patrykandpatrick.vico.core.chart.layout.HorizontalLayout
import com.patrykandpatrick.vico.core.chart.marker.Marker
import com.patrykandpatrick.vico.core.entry.ChartEntryModel
import com.patrykandpatrick.vico.views.chart.BaseChartView
import com.patrykandpatrick.vico.views.chart.Chart
import com.patrykandpatrick.vico.views.chart.components.DefaultAxis
import com.patrykandpatrick.vico.views.chart.components.DefaultCartesianLayer
import com.patrykandpatrick.vico.views.chart.components.DefaultLifecycleOwner
import com.patrykandpatrick.vico.views.chart.components.DefaultMarker
import com.patrykandpatrick.vico.views.chart.components.DefaultValueFormatter
import com.patrykandpatrick.vico.views.chart.components.LineSpec
import com.patrykandpatrick.vico.views.chart.components.ShapeComponent
import com.patrykandpatrick.vico.views.chart.components.textComponent
import android.content.Context
import android.graphics.Color
import android.graphics.RectF
import android.util.AttributeSet
import android.view.View

class BasicColumnChartView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : BaseChartView<ChartEntryModel>(context, attrs, defStyleAttr) {

    private val columnChart = DefaultCartesianLayer.ColumnCartesianLayer.ColumnChart(
        thickness = 8f,
        column = ShapeComponent(shape = RectF(0f, 0f, 10f, 10f), color = Color.Blue)
    )

    private val marker = DefaultMarker.Marker(
        label = textComponent(textSize = 10f, color = Color.White),
        indicator = ShapeComponent(shape = RectF(0f, 0f, 10f, 10f), color = Color.Blue),
        spacing = 4f,
        indicatorSize = 8f,
        bubbleColor = Color.Black
    )

    private val chart = Chart(
        layers = listOf(columnChart),
        marker = marker,
        layout = HorizontalLayout.fullWidth()
    )

    init {
        this.chart = chart
        this.model = ChartEntryModel.Builder().build()
    }
}

```

--------------------------------

### Basic Combo Chart Implementation

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/cartesian-chart

Demonstrates the implementation of a basic combo chart (combining column and line series) using Vico. Includes examples for both Jetpack Compose and Android Views.

```kotlin
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.ColumnCartesianLayer
import com.patrykandpatrick.vico.compose.chart.layers.LineCartesianLayer
import com.patrykandpatrick.vico.compose.chart.layout.fullWidth
import com.patrykandpatrick.vico.compose.chart.marker.marker
import com.patrykandpatrick.vico.compose.style.ChartStyle
import com.patrykandpatrick.vico.core.chart.decoration.ThresholdLine
import com.patrykandpatrick.vico.core.entry.ChartEntryModel
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp

@Composable
fun BasicComboChart(model: ChartEntryModel) {
    ChartStyle(
        columnChart = ColumnCartesianLayer.ColumnChart(thickness = 8.dp),
        lineChart = LineCartesianLayer.LineChart(thickness = 2.dp)
    ) {
        CartesianChart(
            modifier = Modifier.padding(horizontal = 16.dp),
            model = model,
            marker = marker(label = { entry ->
                Text(
                    text = entry.y.toString(),
                    color = Color.White,
                    fontSize = 10.sp
                )
            }),
            runInitialAnimation = true,
            chartModelProducer = remember { ChartModelProducer.build() },
            layout = fullWidth(),
            decorations = remember {
                listOf(
                    ThresholdLine(Color.Gray)
                )
            }
        )
    }
}

```

```java
import com.patrykandpatrick.vico.core.chart.BaseChart
import com.patrykandpatrick.vico.core.chart.layer.ColumnCartesianLayer
import com.patrykandpatrick.vico.core.chart.layer.LineCartesianLayer
import com.patrykandpatrick.vico.core.chart.layout.HorizontalLayout
import com.patrykandpatrick.vico.core.entry.ChartEntryModel
import com.patrykandpatrick.vico.views.chart.BaseChartView
import com.patrykandpatrick.vico.views.chart.Chart
import com.patrykandpatrick.vico.views.chart.components.DefaultAxis
import com.patrykandpatrick.vico.views.chart.components.DefaultCartesianLayer
import com.patrykandpatrick.vico.views.chart.components.DefaultLifecycleOwner
import com.patrykandpatrick.vico.views.chart.components.DefaultMarker
import com.patrykandpatrick.vico.views.chart.components.DefaultValueFormatter
import com.patrykandpatrick.vico.views.chart.components.LineSpec
import com.patrykandpatrick.vico.views.chart.components.ShapeComponent
import com.patrykandpatrick.vico.views.chart.components.textComponent
import android.content.Context
import android.graphics.Color
import android.graphics.RectF
import android.util.AttributeSet
import android.view.View

class BasicComboChartView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : BaseChartView<ChartEntryModel>(context, attrs, defStyleAttr) {

    private val columnChart = DefaultCartesianLayer.ColumnCartesianLayer.ColumnChart(
        thickness = 8f,
        column = ShapeComponent(shape = RectF(0f, 0f, 10f, 10f), color = Color.Blue)
    )

    private val lineChart = DefaultCartesianLayer.LineCartesianLayer.LineChart(
        lines = listOf(LineSpec(lineColor = Color.Red, lineThickness = 2f))
    )

    private val marker = DefaultMarker.Marker(
        label = textComponent(textSize = 10f, color = Color.White),
        indicator = ShapeComponent(shape = RectF(0f, 0f, 10f, 10f), color = Color.Blue),
        spacing = 4f,
        indicatorSize = 8f,
        bubbleColor = Color.Black
    )

    private val chart = Chart(
        layers = listOf(columnChart, lineChart),
        marker = marker,
        layout = HorizontalLayout.fullWidth()
    )

    init {
        this.chart = chart
        this.model = ChartEntryModel.Builder().build()
    }
}

```

--------------------------------

### Basic Combo Chart Sample

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/column-cartesian-layer

Illustrates how to create a basic combo chart, which combines different chart types, using the Vico library. Examples are available for Compose and Android Views.

```kotlin
https://github.com/patrykandpatrick/vico/blob/v2.1.3/sample/compose/src/main/kotlin/com/patrykandpatrick/vico/sample/compose/BasicComboChart.kt
```

```java
https://github.com/patrykandpatrick/vico/blob/v2.1.3/sample/views/src/main/kotlin/com/patrykandpatrick/vico/sample/views/BasicComboChart.kt
```

--------------------------------

### Daily Digital-Media Use Chart Sample

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/column-cartesian-layer

Provides a sample implementation for visualizing daily digital-media usage data. This example is available for both Jetpack Compose and Android Views.

```kotlin
https://github.com/patrykandpatrick/vico/blob/v2.1.3/sample/compose/src/main/kotlin/com/patrykandpatrick/vico/sample/compose/DailyDigitalMediaUse.kt
```

```java
https://github.com/patrykandpatrick/vico/blob/v2.1.3/sample/views/src/main/kotlin/com/patrykandpatrick/vico/sample/views/DailyDigitalMediaUse.kt
```

--------------------------------

### Column Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/compose/cartesian-charts/starter-examples

Demonstrates how to create a basic column chart. It initializes a CartesianChartModelProducer, adds column series data using a transaction, and hosts the chart with vertical and horizontal axes.

```kotlin
val modelProducer = remember { CartesianChartModelProducer() }
LaunchedEffect(Unit) {
    modelProducer.runTransaction {
        columnSeries { series(5, 6, 5, 2, 11, 8, 5, 2, 15, 11, 8, 13, 12, 10, 2, 7) }
    }
}
CartesianChartHost(
    rememberCartesianChart(
        rememberColumnCartesianLayer(),
        startAxis = VerticalAxis.rememberStart(),
        bottomAxis = HorizontalAxis.rememberBottom(),
    ),
    modelProducer,
)
```

--------------------------------

### Basic Line Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/starter-examples

Illustrates the creation of a basic line chart. It sets up a `CartesianChartModelProducer` for data handling and uses `lineSeries` to input the data points. The chart is displayed via `CartesianChartHost`, configured with vertical and horizontal axes.

```kotlin
val modelProducer = remember { CartesianChartModelProducer() }
LaunchedEffect(Unit) {
    modelProducer.runTransaction {
        lineSeries { series(13, 8, 7, 12, 0, 1, 15, 14, 0, 11, 6, 12, 0, 11, 12, 11) }
    }
}
CartesianChartHost(
    rememberCartesianChart(
        rememberLineCartesianLayer(),
        startAxis = VerticalAxis.rememberStart(),
        bottomAxis = HorizontalAxis.rememberBottom(),
    ),
    modelProducer,
)
```

--------------------------------

### Electric-Car Sales Chart Example (Compose & Views)

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/core/cartesian-charts/cartesian-layer

Demonstrates a chart illustrating electric-car sales data. Includes implementations for both Jetpack Compose and Android Views.

```kotlin
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.core.entry.ChartEntryModel

@Composable
fun ElectricCarSalesChart(model: ChartEntryModel) {
    CartesianChart(
        chart = columnChart(), // or other chart types
        model = model
    )
}
```

```java
import com.patrykandpatrick.vico.core.chart.CartesianChart;
import com.patrykandpatrick.vico.core.entry.ChartEntryModel;
import android.content.Context;
import android.util.AttributeSet;
import android.view.View;

public class ElectricCarSalesChartView extends View {
    // ... chart initialization and drawing logic for electric car sales
}
```

--------------------------------

### Basic Combo Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/cartesian-chart

Shows how to combine different chart types, such as columns and lines, in a single chart using Vico. This sample would demonstrate layering different series and managing their visual representation.

```Kotlin
package com.patrykandpatrick.vico.sample.multiplatform

import androidx.compose.runtime.Composable
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.ColumnSeries
import com.patrykandpatrick.vico.compose.chart.layers.LineSeries
import com.patrykandpatrick.vico.compose.chart.layout.fullWidth
import com.patrykandpatrick.vico.compose.chart.marker.marker
import com.patrykandpatrick.vico.compose.style.ChartStyle
import com.patrykandpatrick.vico.core.entry.ChartEntryModelProducer

@Composable
fun BasicComboChart()
{
    val columnData = ChartEntryModelProducer(listOf(1f, 2f, 4f, 2f, 5f, 3f, 6f))
    val lineData = ChartEntryModelProducer(listOf(2f, 3f, 5f, 4f, 6f, 5f, 7f))

    CartesianChart(
        chartModel = columnData,
        modifier = ChartStyle.fullWidth(),
        marker = marker(
            label = { entry -> entry.y.toString() },
            indicator = { entry -> entry.y.toString() }
        ),
        topAxisLabels = listOf("A", "B", "C", "D", "E", "F", "G")
    )
    {
        ColumnSeries(model = columnData)
        LineSeries(model = lineData)
    }
}

```

--------------------------------

### Basic Column Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/starter-examples

Demonstrates how to create a basic column chart. It initializes a `CartesianChartModelProducer` to manage chart data and uses `columnSeries` to add data points. The chart is rendered using `CartesianChartHost` with vertical and horizontal axes.

```kotlin
val modelProducer = remember { CartesianChartModelProducer() }
LaunchedEffect(Unit) {
    modelProducer.runTransaction {
        columnSeries { series(5, 6, 5, 2, 11, 8, 5, 2, 15, 11, 8, 13, 12, 10, 2, 7) }
    }
}
CartesianChartHost(
    rememberCartesianChart(
        rememberColumnCartesianLayer(),
        startAxis = VerticalAxis.rememberStart(),
        bottomAxis = HorizontalAxis.rememberBottom(),
    ),
    modelProducer,
)
```

--------------------------------

### Vico Sample App Structure

Source: https://www.patrykandpatrick.com/vico/guide/stable/learning-resources

Details the structure of the Vico sample application, which includes modules for different UI frameworks like Jetpack Compose, Compose Multiplatform, and the Android view system. Links to the GitHub repository are provided for each module.

```APIDOC
Sample App Modules:
  - sample:compose: https://github.com/patrykandpatrick/vico/tree/v2.1.3/sample/compose/src/main/kotlin/com/patrykandpatrick/vico/sample/compose (Jetpack Compose)
  - sample:multiplatform: https://github.com/patrykandpatrick/vico/tree/v2.1.3/sample/multiplatform/src/commonMain/kotlin/com/patrykandpatrick/vico/sample/multiplatform (Compose Multiplatform)
  - sample:views: https://github.com/patrykandpatrick/vico/tree/v2.1.3/sample/views/src/main/kotlin/com/patrykandpatrick/vico/sample/views (Android view system)
  - APK Download: https://github.com/patrykandpatrick/vico/releases/download/v2.1.3/android-sample-debug.apk
```

--------------------------------

### Basic Column Chart Setup

Source: https://www.patrykandpatrick.com/vico/guide/stable/android/views/cartesian-charts/starter-examples

Configures a CartesianChartView for a column chart using XML styles and Kotlin code to produce the data series. It sets up the chart to display columns and shows both bottom and start axes.

```xml
<style name="ChartStyle">
    <item name="layers">column</item>
    <item name="showBottomAxis">true</item>
    <item name="showStartAxis">true</item>
</style>

<com.patrykandpatrick.vico.views.cartesian.CartesianChartView
    android:id="@+id/chart_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:chartStyle="@style/ChartStyle" />
```

```kotlin
val modelProducer = CartesianChartModelProducer()
chartView.modelProducer = modelProducer
lifecycleScope.launch {
    modelProducer.runTransaction {
        columnSeries { series(5, 6, 5, 2, 11, 8, 5, 2, 15, 11, 8, 13, 12, 10, 2, 7) }
    }
}
```

--------------------------------

### Electric-Car Sales (Norway) Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/axis

Visualizes electric car sales data for Norway. This example might use a time-series chart to show sales trends over a period.

```kotlin
import androidx.compose.runtime.Composable
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.LineSeries
import com.patrykandpatrick.vico.core.entry.ChartEntryModel
import com.patrykandpatrick.vico.core.entry.FloatEntry

@Composable
fun ElectricCarSalesChart(salesData: Map<String, Float>) {
    val entries = salesData.entries.sortedBy { it.key }.mapIndexed {
            index, entry -> FloatEntry(index.toFloat(), entry.value)
    }
    val model = ChartEntryModel.fromList(entries)
    CartesianChart(
        model = model,
        content = {
            LineSeries(model = model)
        }
    )
}
```

--------------------------------

### Cloning and Checking Out Vico Repository

Source: https://www.patrykandpatrick.com/vico/guide/stable/learning-resources

Provides the Git commands to clone the Vico repository and checkout a specific version (v2.1.3), which is necessary for working with the sample application locally.

```bash
git clone https://github.com/patrykandpatrick/vico
cd vico
git checkout v2.1.3
```

--------------------------------

### AI Test Scores Chart Example

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/axis

A sample chart displaying AI test scores. This example likely uses a specific data structure and visualization to represent performance metrics.

```kotlin
import androidx.compose.runtime.Composable
import com.patrykandpatrick.vico.compose.chart.CartesianChart
import com.patrykandpatrick.vico.compose.chart.layers.ColumnSeries
import com.patrykandpatrick.vico.core.entry.ChartEntryModel
import com.patrykandpatrick.vico.core.entry.FloatEntry

@Composable
fun AITestScoresChart(scores: List<Float>) {
    val model = ChartEntryModel.fromList(scores.mapIndexed { index, score -> FloatEntry(index.toFloat(), score) })
    CartesianChart(
        model = model,
        content = {
            ColumnSeries(model = model)
        }
    )
}
```

--------------------------------

### Vico Sample Charts

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/cartesian-layer

Provides links to various sample chart implementations in the Vico multiplatform project. These samples demonstrate different chart types and data visualizations.

```kotlin
// Basic Column Chart
// Basic Line Chart
// Basic Combo Chart
// AI Test Scores
// Daily Digital-Media Use (USA)
// Temperature Anomalies (June)
// Electric-Car Sales (Norway)
// Rock–Metal Ratios
// Gold Prices (12/30/2024)
```

--------------------------------

### Axis Positioning in Cartesian Charts

Source: https://www.patrykandpatrick.com/vico/guide/stable/multiplatform/cartesian-charts/cartesian-layer

Explains how Cartesian Charts can utilize separate Y-ranges for start and end Y-axes. Each CartesianLayer can be assigned an Axis.Position.Vertical subclass (Start or End) to achieve independently scaled groups of layers.

```APIDOC
Axis.Position.Vertical:
  - Start: Assigns a layer to the start Y-axis.
  - End: Assigns a layer to the end Y-axis.

CartesianChart:
  - Can have two separate Y-ranges.
  - The final Y-range for each Axis.Position.Vertical subclass is the narrowest range that includes the Y-ranges of all linked CartesianLayers.

CartesianLayer:
  - Can be assigned an Axis.Position.Vertical subclass.
  - Multiple layers can be linked to the same Y-axis position.
```
Tokens:
Raw