Add aesthetics for the horizontal geomBoxplot()

Author: MKoroteev-HORIS

future_changes.md

@@ -52,6 +52,9 @@ GeoTools [v 33.2](https://github.com/geotools/geotools/releases/tag/33.2)
 > New way of handling continuous data on discrete scales could potentially break existing plots.
 > If you want to restore a broken plot to its original form, you can use the [`asDiscrete()`](https://lets-plot.org/kotlin/as-discrete.html) function to annotate continuous data as discrete.
 
+- [**BREAKING**] `geomBoxplot()`: when y-oriented, it now uses aesthetics `xlower`/`xmiddle`/`xupper` instead of  `lower`/`middle`/`upper` [[#1319](https://github.com/JetBrains/lets-plot/issues/1319)].
+- [**BREAKING**] `waterfallPlot()`: special "flow_type" value for `label=elementText(color=...)` replaced with "inherit". See `label` in the [documentation](https://lets-plot.org/kotlin/api-reference/-lets--plot--kotlin/org.jetbrains.letsPlot.bistro.waterfall/waterfall-plot.html).
+- [**DEPRECATED**] The `positionDodgeV()` function and the `"dodgev"` value for the `position` parameter are deprecated and will be removed in future releases.
 - Plot layout: reduced margins and spacing for title, caption, axes, and legend.
 - Updated RGB values for `lightgray` and `green`. To restore the previous colors, use `gray75` and `lime`, respectively.
 

plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/Geom.kt

@@ -614,6 +614,11 @@ object Geom {
         override val upper: Number? = null,
         override val ymin: Number? = null,
         override val ymax: Number? = null,
+        override val xlower: Number? = null,
+        override val xmiddle: Number? = null,
+        override val xupper: Number? = null,
+        override val xmin: Number? = null,
+        override val xmax: Number? = null,
         override val fatten: Number? = null,
         override val whiskerWidth: Number? = null,
         override val alpha: Number? = null,

plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/geom/geom_boxplot.kt

@@ -127,6 +127,11 @@ fun geomBoxplot(
     upper: Number? = null,
     ymin: Number? = null,
     ymax: Number? = null,
+    xlower: Number? = null,
+    xmiddle: Number? = null,
+    xupper: Number? = null,
+    xmin: Number? = null,
+    xmax: Number? = null,
     alpha: Number? = null,
     color: Any? = null,
     fill: Any? = null,
@@ -165,7 +170,9 @@ fun geomBoxplot(
         manualKey,
         tooltips,
         orientation,
-        x, y, lower, middle, upper, ymin, ymax, alpha, color, fill, size, linetype, shape, angle, width, weight, fatten,
+        x, y, lower, middle, upper, ymin, ymax, alpha,
+        xlower, xmiddle, xupper, xmin, xmax,
+        color, fill, size, linetype, shape, angle, width, weight, fatten,
         whiskerWidth, varWidth, coef,
         widthUnit,
         colorBy, fillBy,
@@ -231,6 +238,11 @@ private class geomBoxplotInternal(
     override val upper: Number? = null,
     override val ymin: Number? = null,
     override val ymax: Number? = null,
+    override val xlower: Number? = null,
+    override val xmiddle: Number? = null,
+    override val xupper: Number? = null,
+    override val xmin: Number? = null,
+    override val xmax: Number? = null,
     override val alpha: Number? = null,
     override val color: Any? = null,
     override val fill: Any? = null,

plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/layer/geom/BoxplotAesthetics.kt

@@ -16,6 +16,11 @@ interface BoxplotAesthetics : OptionsCapsule {
     val upper: Any?
     val ymin: Any?
     val ymax: Any?
+    val xlower: Any?
+    val xmiddle: Any?
+    val xupper: Any?
+    val xmin: Any?
+    val xmax: Any?
     val alpha: Any?
     val color: Any?
     val fill: Any?
@@ -34,6 +39,11 @@ interface BoxplotAesthetics : OptionsCapsule {
             "upper" to upper,
             "ymin" to ymin,
             "ymax" to ymax,
+            "xlower" to xlower,
+            "xmiddle" to xmiddle,
+            "xupper" to xupper,
+            "xmin" to xmin,
+            "xmax" to xmax,
             "alpha" to alpha,
             "color" to color,
             "fill" to fill,

plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/intern/layer/geom/BoxplotMapping.kt

@@ -16,6 +16,11 @@ class BoxplotMapping(
     override var upper: Any? = null,
     override var ymin: Any? = null,
     override var ymax: Any? = null,
+    override var xlower: Any? = null,
+    override var xmiddle: Any? = null,
+    override var xupper: Any? = null,
+    override var xmin: Any? = null,
+    override var xmax: Any? = null,
     override var alpha: Any? = null,
     override var color: Any? = null,
     override var fill: Any? = null,

plot-api/src/commonMain/kotlin/org/jetbrains/letsPlot/stat/stat_boxplot.kt

@@ -107,6 +107,11 @@ fun statBoxplot(
     upper: Number? = null,
     ymin: Number? = null,
     ymax: Number? = null,
+    xlower: Number? = null,
+    xmiddle: Number? = null,
+    xupper: Number? = null,
+    xmin: Number? = null,
+    xmax: Number? = null,
     alpha: Number? = null,
     color: Any? = null,
     fill: Any? = null,
@@ -143,7 +148,9 @@ fun statBoxplot(
         inheritAes,
         sampling,
         x, y,
-        lower, middle, upper, ymin, ymax, alpha, color, fill, size, linetype, shape, angle, width, weight, fatten,
+        lower, middle, upper, ymin, ymax,
+        xlower, xmiddle, xupper, xmin, xmax,
+        alpha, color, fill, size, linetype, shape, angle, width, weight, fatten,
         whiskerWidth, varWidth, coef,
         colorBy, fillBy,
         mapping
@@ -204,6 +211,11 @@ private class statBoxplotInternal(
     override val upper: Number? = null,
     override val ymin: Number? = null,
     override val ymax: Number? = null,
+    override val xlower: Number? = null,
+    override val xmiddle: Number? = null,
+    override val xupper: Number? = null,
+    override val xmin: Number? = null,
+    override val xmax: Number? = null,
     override val alpha: Number? = null,
     override val color: Any? = null,
     override val fill: Any? = null,