Koala Plot Core/io.github.koalaplot.core.xygraph

Package-level declarations

Types

AnchorPoint

sealed class AnchorPoint

AxisModel

interface AxisModel<T>

An interface for classes representing a plot axis.

AxisState

interface AxisState

Holds the offsets for major and minor ticks within an axis.

AxisStyle

data class AxisStyle(val color: Color = Color.Black, val majorTickSize: Dp = 0.dp, val minorTickSize: Dp = 0.dp, val tickPosition: TickPosition = TickPosition.None, val lineWidth: Dp = 1.dp, val labelRotation: Int = 0)

Styling configuration for an Axis.

CategoryAxisModel

class CategoryAxisModel<T>(categories: List<T>, val minimumMajorTickSpacing: Dp = 50.dp) : AxisModel<T>

An axis that uses arbitrary category objects instead of numbers as its values. It is a discrete axis.

DefaultPoint

data class DefaultPoint<X, Y>(val x: X, val y: Y) : Point<X, Y>

Default implementation of the Point interface.

LinearAxisModel

class LinearAxisModel(val range: ClosedFloatingPointRange<Float>, zoomRangeLimit: Float = (range.endInclusive - range.start) * ZoomRangeLimitDefault, minimumMajorTickIncrement: Float = (range.endInclusive - range.start) * MinimumMajorTickIncrementDefault, val minimumMajorTickSpacing: Dp = 50.dp, minorTickCount: Int = 4, allowZooming: Boolean = true, allowPanning: Boolean = true) : AxisModel<Float>

An AxisModel that uses Float values and is linear.

LogAxisModel

class LogAxisModel(range: ClosedRange<Int>, val minimumMajorTickSpacing: Dp = 50.dp) : AxisModel<Float>

A logarithmic axis.

Point

interface Point<X, Y>

Represents a point on a 2-d plot.

TickPosition

enum TickPosition : Enum<TickPosition>

Specifies the position of axis ticks.

TickValues

interface TickValues<T>

The major and minor tick values for an axis.

XYGraphScope

interface XYGraphScope<X, Y> : HoverableElementAreaScope

A scope for XY plots providing axis and state context.

Functions

autoScaleRange

@JvmName(name = "autoScaleFloatRange")

fun List<Float>.autoScaleRange(): ClosedFloatingPointRange<Float>

Calculates a ClosedFloatingPointRange that can be used with a LinearAxisModel based on the min/max values of the provided list of Floats.

@JvmName(name = "autoScaleIntRange")

fun List<Int>.autoScaleRange(): ClosedFloatingPointRange<Float>

autoScaleXRange

fun <Y> List<Point<Float, Y>>.autoScaleXRange(): ClosedFloatingPointRange<Float>

Calculates a ClosedFloatingPointRange that can be used with a LinearAxisModel based on the min/max X values of the provided list of Points.

autoScaleYRange

fun <X> List<Point<X, Float>>.autoScaleYRange(): ClosedFloatingPointRange<Float>

Calculates a ClosedFloatingPointRange that can be used with a LinearAxisModel based on the min/max Y values of the provided list of Points.

HorizontalLineAnnotation

@Composable

fun <X, Y> XYGraphScope<X, Y>.HorizontalLineAnnotation(location: Y, lineStyle: LineStyle)

Places a vertical line marker on the plot at the specified x-axis location styled using the provided lineStyle.

Point

fun <X, Y> Point(x: X, y: Y): Point<X, Y>

Creates a new DefaultPoint at the specified coordinates.

rememberAxisStyle

@Composable

fun rememberAxisStyle(color: Color = KoalaPlotTheme.axis.color, majorTickSize: Dp = KoalaPlotTheme.axis.majorTickSize, minorTickSize: Dp = KoalaPlotTheme.axis.minorTickSize, tickPosition: TickPosition = KoalaPlotTheme.axis.xyGraphTickPosition, lineWidth: Dp = KoalaPlotTheme.axis.lineThickness, labelRotation: Int = 0): AxisStyle

Creates and remembers an AxisStyle.

rememberLinearAxisModel

@Composable

fun rememberLinearAxisModel(range: ClosedFloatingPointRange<Float>, zoomRangeLimit: Float = (range.endInclusive - range.start) * ZoomRangeLimitDefault, minimumMajorTickIncrement: Float = (range.endInclusive - range.start) * MinimumMajorTickIncrementDefault, minimumMajorTickSpacing: Dp = 50.dp, minorTickCount: Int = 4, allowZooming: Boolean = true, allowPanning: Boolean = true): LinearAxisModel

Create and remember a LinearAxisModel.

VerticalLineAnnotation

@Composable

fun <X, Y> XYGraphScope<X, Y>.VerticalLineAnnotation(location: X, lineStyle: LineStyle)

Places a vertical line marker on the plot at the specified x-axis location styled using the provided lineStyle.

XYAnnotation

@Composable

fun <X, Y> XYGraphScope<X, Y>.XYAnnotation(location: Point<X, Y>, anchorPoint: AnchorPoint, modifier: Modifier = Modifier, content: @Composable () -> Unit)

Places a Composable as an annotation on an XYGraph with the Composable's anchorPoint placed at the provided location.

XYGraph

@Composable

fun <X, Y> XYGraph(xAxisModel: AxisModel<X>, yAxisModel: AxisModel<Y>, modifier: Modifier = Modifier, xAxisStyle: AxisStyle = rememberAxisStyle(), xAxisLabels: (X) -> String = { it.toString() }, xAxisTitle: String? = null, yAxisStyle: AxisStyle = rememberAxisStyle(), yAxisLabels: (Y) -> String = { it.toString() }, yAxisTitle: String? = null, horizontalMajorGridLineStyle: LineStyle? = KoalaPlotTheme.axis.majorGridlineStyle, horizontalMinorGridLineStyle: LineStyle? = KoalaPlotTheme.axis.minorGridlineStyle, verticalMajorGridLineStyle: LineStyle? = KoalaPlotTheme.axis.majorGridlineStyle, verticalMinorGridLineStyle: LineStyle? = KoalaPlotTheme.axis.minorGridlineStyle, panZoomEnabled: Boolean = true, content: @Composable XYGraphScope<X, Y>.() -> Unit)

An XYGraph overload that takes Strings for axis labels and titles instead of Composables for use cases where custom styling is not required.

@Composable

fun <X, Y> XYGraph(xAxisModel: AxisModel<X>, yAxisModel: AxisModel<Y>, modifier: Modifier = Modifier, xAxisStyle: AxisStyle = rememberAxisStyle(), xAxisLabels: @Composable (X) -> Unit, xAxisTitle: @Composable () -> Unit = {}, yAxisStyle: AxisStyle = rememberAxisStyle(), yAxisLabels: @Composable (Y) -> Unit, yAxisTitle: @Composable () -> Unit = {}, horizontalMajorGridLineStyle: LineStyle? = KoalaPlotTheme.axis.majorGridlineStyle, horizontalMinorGridLineStyle: LineStyle? = KoalaPlotTheme.axis.minorGridlineStyle, verticalMajorGridLineStyle: LineStyle? = KoalaPlotTheme.axis.majorGridlineStyle, verticalMinorGridLineStyle: LineStyle? = KoalaPlotTheme.axis.minorGridlineStyle, panZoomEnabled: Boolean = true, content: @Composable XYGraphScope<X, Y>.() -> Unit)

Provides a set of X-Y axes and grid for displaying X-Y plots.