commonMain.jetbrains.datalore.plot.config.ScaleConfig.kt Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of lets-plot-common Show documentation
Show all versions of lets-plot-common Show documentation
Lets-Plot JVM package without rendering part
/*
* Copyright (c) 2019. JetBrains s.r.o.
* Use of this source code is governed by the MIT license that can be found in the LICENSE file.
*/
package jetbrains.datalore.plot.config
import jetbrains.datalore.base.stringFormat.StringFormat
import jetbrains.datalore.base.stringFormat.StringFormat.FormatType.DATETIME_FORMAT
import jetbrains.datalore.base.values.Color
import jetbrains.datalore.plot.base.Aes
import jetbrains.datalore.plot.base.scale.Mappers.nullable
import jetbrains.datalore.plot.base.scale.transform.DateTimeBreaksGen
import jetbrains.datalore.plot.base.scale.transform.Transforms
import jetbrains.datalore.plot.builder.scale.*
import jetbrains.datalore.plot.builder.scale.mapper.ShapeMapper
import jetbrains.datalore.plot.builder.scale.provider.*
import jetbrains.datalore.plot.config.Option.Scale.AES
import jetbrains.datalore.plot.config.Option.Scale.BREAKS
import jetbrains.datalore.plot.config.Option.Scale.CHROMA
import jetbrains.datalore.plot.config.Option.Scale.DIRECTION
import jetbrains.datalore.plot.config.Option.Scale.END
import jetbrains.datalore.plot.config.Option.Scale.EXPAND
import jetbrains.datalore.plot.config.Option.Scale.FORMAT
import jetbrains.datalore.plot.config.Option.Scale.GUIDE
import jetbrains.datalore.plot.config.Option.Scale.HIGH
import jetbrains.datalore.plot.config.Option.Scale.HUE_RANGE
import jetbrains.datalore.plot.config.Option.Scale.LABELS
import jetbrains.datalore.plot.config.Option.Scale.LIMITS
import jetbrains.datalore.plot.config.Option.Scale.LOW
import jetbrains.datalore.plot.config.Option.Scale.LUMINANCE
import jetbrains.datalore.plot.config.Option.Scale.MAX_SIZE
import jetbrains.datalore.plot.config.Option.Scale.MID
import jetbrains.datalore.plot.config.Option.Scale.MIDPOINT
import jetbrains.datalore.plot.config.Option.Scale.NAME
import jetbrains.datalore.plot.config.Option.Scale.NA_VALUE
import jetbrains.datalore.plot.config.Option.Scale.OUTPUT_VALUES
import jetbrains.datalore.plot.config.Option.Scale.PALETTE
import jetbrains.datalore.plot.config.Option.Scale.PALETTE_TYPE
import jetbrains.datalore.plot.config.Option.Scale.RANGE
import jetbrains.datalore.plot.config.Option.Scale.SCALE_MAPPER_KIND
import jetbrains.datalore.plot.config.Option.Scale.SHAPE_SOLID
import jetbrains.datalore.plot.config.Option.Scale.START
import jetbrains.datalore.plot.config.Option.Scale.START_HUE
import jetbrains.datalore.plot.config.Option.TransformName
import jetbrains.datalore.plot.config.aes.AesOptionConversion
import jetbrains.datalore.plot.config.aes.TypedContinuousIdentityMappers
/**
* @param - target aesthetic type of the configured scale
*/
class ScaleConfig(options: Map) : OptionsAccessor(options) {
@Suppress("UNCHECKED_CAST")
val aes: Aes = aesOrFail(options) as Aes
fun createScaleProvider(): ScaleProvider {
return createScaleProviderBuilder().build()
}
private fun createScaleProviderBuilder(): ScaleProviderBuilder {
var mapperProvider: MapperProvider<*>? = null
val naValue: T = when {
has(NA_VALUE) -> getValue(aes, NA_VALUE)!!
else -> DefaultNaValue[aes]
}
// all 'manual' scales
if (has(OUTPUT_VALUES)) {
val outputValues = getList(OUTPUT_VALUES)
val mapperOutputValues = AesOptionConversion.applyToList(aes, outputValues)
mapperProvider = DefaultMapperProviderUtil.createWithDiscreteOutput(mapperOutputValues, naValue)
}
if (aes == Aes.SHAPE) {
val solid = get(SHAPE_SOLID)
// False - show only hollow shapes, otherwise - all (default)
if (solid is Boolean && solid == false) {
mapperProvider = DefaultMapperProviderUtil.createWithDiscreteOutput(
ShapeMapper.hollowShapes(), ShapeMapper.NA_VALUE
)
}
} else if (aes == Aes.ALPHA && has(RANGE)) {
mapperProvider =
AlphaMapperProvider(getRange(RANGE), (naValue as Double))
} else if (aes == Aes.SIZE && has(RANGE)) {
mapperProvider =
SizeMapperProvider(getRange(RANGE), (naValue as Double))
}
// used in scale_x_discrete, scale_y_discrete
val discreteDomain = getBoolean(Option.Scale.DISCRETE_DOMAIN)
val reverse = getBoolean(Option.Scale.DISCRETE_DOMAIN_REVERSE)
val scaleMapperKind =
getString(SCALE_MAPPER_KIND) ?: if (!has(OUTPUT_VALUES) && discreteDomain && aes in setOf>(
Aes.FILL,
Aes.COLOR
)
)
// Default palette type for discrete colors
COLOR_BREWER
else
null
when (scaleMapperKind) {
null -> {
}
IDENTITY ->
mapperProvider = createIdentityMapperProvider(aes, naValue)
COLOR_GRADIENT ->
mapperProvider = ColorGradientMapperProvider(
getColor(LOW),
getColor(HIGH),
(naValue as Color)
)
COLOR_GRADIENT2 ->
mapperProvider = ColorGradient2MapperProvider(
getColor(LOW),
getColor(MID),
getColor(HIGH),
getDouble(MIDPOINT), naValue as Color
)
COLOR_HUE ->
mapperProvider = ColorHueMapperProvider(
getDoubleList(HUE_RANGE),
getDouble(CHROMA),
getDouble(LUMINANCE),
getDouble(START_HUE),
getDouble(DIRECTION), naValue as Color
)
COLOR_GREY ->
mapperProvider = GreyscaleLightnessMapperProvider(
getDouble(START),
getDouble(END),
naValue as Color
)
COLOR_BREWER ->
mapperProvider = ColorBrewerMapperProvider(
getString(PALETTE_TYPE),
get(PALETTE),
getDouble(DIRECTION),
naValue as Color
)
SIZE_AREA ->
mapperProvider = SizeAreaMapperProvider(
getDouble(MAX_SIZE),
naValue as Double
)
else ->
throw IllegalArgumentException("Aes '" + aes.name + "' - unexpected scale mapper kind: '" + scaleMapperKind + "'")
}
val b = ScaleProviderBuilder(aes)
if (mapperProvider != null) {
@Suppress("UNCHECKED_CAST")
b.mapperProvider(mapperProvider as MapperProvider)
}
b.discreteDomain(discreteDomain)
b.discreteDomainReverse(reverse)
if (getBoolean(Option.Scale.DATE_TIME)) {
val dateTimeFormatter = getString(FORMAT)?.let { pattern ->
val stringFormat = StringFormat.forOneArg(pattern, type = DATETIME_FORMAT)
return@let { value: Any -> stringFormat.format(value) }
}
b.breaksGenerator(DateTimeBreaksGen(dateTimeFormatter))
} else if (!discreteDomain && has(Option.Scale.CONTINUOUS_TRANSFORM)) {
val transformName = getStringSafe(Option.Scale.CONTINUOUS_TRANSFORM)
val transform = when (transformName.lowercase()) {
TransformName.IDENTITY -> Transforms.IDENTITY
TransformName.LOG10 -> Transforms.LOG10
TransformName.REVERSE -> Transforms.REVERSE
TransformName.SQRT -> Transforms.SQRT
else -> throw IllegalArgumentException(
"Unknown transform name: '$transformName'. Supported: ${
listOf(
TransformName.IDENTITY,
TransformName.LOG10,
TransformName.REVERSE,
TransformName.SQRT
).joinToString(transform = { "'$it'" })
}."
)
}
b.continuousTransform(transform)
}
return applyCommons(b)
}
private fun applyCommons(b: ScaleProviderBuilder): ScaleProviderBuilder {
if (has(NAME)) {
b.name(getString(NAME)!!)
}
if (has(BREAKS)) {
b.breaks(getList(BREAKS).mapNotNull { it })
}
if (has(LABELS)) {
b.labels(getStringList(LABELS))
} else {
// Skip format is labels are defined
b.labelFormat(getString(FORMAT))
}
if (has(EXPAND)) {
val list = getList(EXPAND)
if (list.isNotEmpty()) {
val multiplicativeExpand = list[0] as Number
b.multiplicativeExpand(multiplicativeExpand.toDouble())
if (list.size > 1) {
val additiveExpand = list[1] as Number
b.additiveExpand(additiveExpand.toDouble())
}
}
}
if (has(LIMITS)) {
b.limits(this.getList(LIMITS))
}
return b
}
fun hasGuideOptions(): Boolean {
return has(GUIDE)
}
fun getGuideOptions(): GuideConfig {
return GuideConfig.create(get(GUIDE)!!)
}
companion object {
const val IDENTITY = "identity"
private const val COLOR_GRADIENT = "color_gradient"
const val COLOR_GRADIENT2 = "color_gradient2"
private const val COLOR_HUE = "color_hue"
private const val COLOR_GREY = "color_grey"
const val COLOR_BREWER = "color_brewer"
private const val SIZE_AREA = "size_area"
fun aesOrFail(options: Map): Aes<*> {
val accessor = OptionsAccessor(options)
require(accessor.has(AES)) { "Required parameter '$AES' is missing" }
return Option.Mapping.toAes(accessor.getStringSafe(AES))
}
fun createIdentityMapperProvider(aes: Aes, naValue: T): MapperProvider {
// There is an option value converter for every AES (which can be used as discrete identity mapper)
val cvt = AesOptionConversion.getConverter(aes)
val discreteMapperProvider =
IdentityDiscreteMapperProvider(cvt, naValue)
// For some AES there is also a continuous identity mapper
if (TypedContinuousIdentityMappers.contain(aes)) {
val continuousMapper = TypedContinuousIdentityMappers[aes]
return IdentityMapperProvider(
discreteMapperProvider,
nullable(continuousMapper, naValue)
)
}
return discreteMapperProvider
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy