barChart c:grouping=stacked: сегменты на кумулятивной сумме #47

Merged
pjandro merged 1 commits from stacked-bar-chart into main 2026-10-25 19:47:03 +03:00
7 changed files with 206 additions and 15 deletions
@@ -36,8 +36,12 @@ final class CartesianPainter {
List<String> cats = categoriesOf(spec, nCat); List<String> cats = categoriesOf(spec, nCat);
// §21.2.2.76 + §21.2.3.17: stacked — ряд на накопленной сумме предыдущих; // §21.2.2.76 + §21.2.3.17: stacked — ряд на накопленной сумме предыдущих;
// percentStacked — суммы категорий нормируются к 100. Только LINE (2-D). // percentStacked — суммы категорий нормируются к 100. LINE и 2-D bar (обе
boolean stacked = spec.type == ChartSpec.Type.LINE && ChartRenderer.isStacked(spec.grouping); // ориентации); 2-D AREA grouping не читает (не запрошено).
boolean stacked = (spec.type == ChartSpec.Type.LINE
|| spec.type == ChartSpec.Type.BAR
|| spec.type == ChartSpec.Type.BAR_HORIZONTAL)
&& ChartRenderer.isStacked(spec.grouping);
boolean percent = stacked && "percentStacked".equalsIgnoreCase(spec.grouping); boolean percent = stacked && "percentStacked".equalsIgnoreCase(spec.grouping);
double[][] cum = stacked ? ChartRenderer.stackedCumulative(spec, percent) : null; double[][] cum = stacked ? ChartRenderer.stackedCumulative(spec, percent) : null;
double[] range = stacked ? ChartRenderer.stackedRange(cum) : ChartRenderer.valueRange(spec); double[] range = stacked ? ChartRenderer.stackedRange(cum) : ChartRenderer.valueRange(spec);
@@ -117,7 +121,7 @@ final class CartesianPainter {
switch (spec.type) { switch (spec.type) {
case LINE -> drawLines(g, spec, plot, palette, lo, hi, nCat, horizontal, cum); case LINE -> drawLines(g, spec, plot, palette, lo, hi, nCat, horizontal, cum);
case AREA -> drawAreas(g, spec, plot, palette, lo, hi, nCat, horizontal); case AREA -> drawAreas(g, spec, plot, palette, lo, hi, nCat, horizontal);
case BAR, BAR_HORIZONTAL -> drawBars(g, spec, plot, palette, lo, hi, nCat, horizontal); case BAR, BAR_HORIZONTAL -> drawBars(g, spec, plot, palette, lo, hi, nCat, horizontal, cum);
default -> { default -> {
} }
} }
@@ -335,12 +339,45 @@ final class CartesianPainter {
private static void drawBars(Graphics2D g, ChartSpec spec, Rectangle2D plot, private static void drawBars(Graphics2D g, ChartSpec spec, Rectangle2D plot,
List<Color> palette, double lo, double hi, int nCat, List<Color> palette, double lo, double hi, int nCat,
boolean horizontal) { boolean horizontal, double[][] cum) {
int nSer = spec.series.size(); int nSer = spec.series.size();
double slot = (horizontal ? plot.getHeight() : plot.getWidth()) / nCat; double slot = (horizontal ? plot.getHeight() : plot.getWidth()) / nCat;
if (cum != null) {
// §21.2.2.76: stacked — один столбец на категорию, сегмент ряда si — от
// кумулятивной суммы предыдущих рядов (0 для si=0) до cum[si][i]; null —
// сегмента нет. Ширина — как у одиночного ряда (c:gapWidth), c:overlap
// к stacked не применяется. Семантика суммы — как у stacked-ветки
// Cartesian3dPainter (простая накапливающая сумма, смешанные знаки —
// по stackedRange). Регрессия — CartesianPainterTest#stackedBar_seriesStackCumulatively,
// фикстура samples/chart-types.docx.
double barW = slot / (1 + spec.gapWidth / 100.0);
for (int si = 0; si < nSer; si++) {
ChartSpec.Series s = spec.series.get(si);
for (int i = 0; i < s.values.size(); i++) {
Double v = s.values.get(i);
if (v == null) {
continue;
}
Color c = s.fillAt(i, palette);
g.setColor(c);
double center = catPos(i, nCat, plot, horizontal);
double start = center - barW / 2;
double prev = si == 0 ? 0 : cum[si - 1][i];
double p0 = valuePos(prev, lo, hi, plot, horizontal);
double p1 = valuePos(cum[si][i], lo, hi, plot, horizontal);
if (horizontal) {
g.fill(new Rectangle2D.Double(Math.min(p0, p1), start,
Math.abs(p1 - p0), barW));
} else {
g.fill(new Rectangle2D.Double(start, Math.min(p0, p1),
barW, Math.abs(p1 - p0)));
}
}
}
return;
}
// ECMA-376 CT_GapAmount/CT_Overlap: зазор между группами категорий и // ECMA-376 CT_GapAmount/CT_Overlap: зазор между группами категорий и
// перекрытие рядов внутри группы задаются в процентах ширины бара. // перекрытие рядов внутри группы задаются в процентах ширины бара.
// Слот = nSer баров + зазор => barW = slot/(nSer + gap/100)
// (Word default gapWidth=150, один ряд => bar = 0.4 слота). // (Word default gapWidth=150, один ряд => bar = 0.4 слота).
// Шаг между рядами внутри группы step = barW·(1 - overlap/100): // Шаг между рядами внутри группы step = barW·(1 - overlap/100):
// overlap>0 — перекрытие, <0 — раздвижка; раздвижка не выносит // overlap>0 — перекрытие, <0 — раздвижка; раздвижка не выносит
@@ -158,7 +158,8 @@ final class ChartSpec {
double perspective = 30; double perspective = 30;
boolean rightAngledAxes = true; boolean rightAngledAxes = true;
/** c:grouping (§21.2.2.76): standard|clustered|stacked|percentStacked; /** c:grouping (§21.2.2.76): standard|clustered|stacked|percentStacked;
* используют lineChart (2-D) и bar3D/area3D; 2-D area/bar не читают. */ * используют lineChart и barChart (2-D, обе ориентации), bar3D/area3D;
* 2-D area не читает. */
String grouping = "standard"; String grouping = "standard";
// Спека-параметры DrawingML, исполнение Word; дефолты — ECMA-376/Word. // Спека-параметры DrawingML, исполнение Word; дефолты — ECMA-376/Word.
// firstSliceAng (§21.2.2.68) определён только для CT_PieChart/CT_DoughnutChart; // firstSliceAng (§21.2.2.68) определён только для CT_PieChart/CT_DoughnutChart;
@@ -369,6 +370,9 @@ final class ChartSpec {
&& g.getBarDir().getVal() != null && g.getBarDir().getVal() != null
&& "bar".equalsIgnoreCase(g.getBarDir().getVal().value()); && "bar".equalsIgnoreCase(g.getBarDir().getVal().value());
spec.type = horizontal ? Type.BAR_HORIZONTAL : Type.BAR; spec.type = horizontal ? Type.BAR_HORIZONTAL : Type.BAR;
if (g.getGrouping() != null && g.getGrouping().getVal() != null) {
spec.grouping = g.getGrouping().getVal().value();
}
// getVal() у CTGapAmount/CTOverlap — примитив, проверяется только обёртка // getVal() у CTGapAmount/CTOverlap — примитив, проверяется только обёртка
if (g.getGapWidth() != null) { if (g.getGapWidth() != null) {
spec.gapWidth = g.getGapWidth().getVal(); spec.gapWidth = g.getGapWidth().getVal();
@@ -11,10 +11,10 @@ import java.util.zip.ZipEntry;
import java.util.zip.ZipOutputStream; import java.util.zip.ZipOutputStream;
/** /**
* Генератор фикстуры {@code samples/chart-types.docx}: 11 диаграмм: 9 типов, * Генератор фикстуры {@code samples/chart-types.docx}: 12 диаграмм: 9 типов,
* которых POI не пишет (scatter, bubble, radar, stock, ofPie, bar3D, * которых POI не пишет (scatter, bubble, radar, stock, ofPie, bar3D,
* area3D, line3D, surface2D), + ofPie pie-вариант + lineChart с * area3D, line3D, surface2D), + ofPie pie-вариант + lineChart и линейчатая
* c:grouping=stacked — chart-XML * (barDir=bar) с c:grouping=stacked — chart-XML
* литералами по ECMA-376 §21.2 * литералами по ECMA-376 §21.2
* (фикстура проходит docs/standards/validate-fixtures.py). Регрессия — * (фикстура проходит docs/standards/validate-fixtures.py). Регрессия —
* WordPdfConverterTest#chartTypes_allTypesRenderAsImages. * WordPdfConverterTest#chartTypes_allTypesRenderAsImages.
@@ -39,7 +39,7 @@ public final class ChartTypesDocxGenerator {
"Точечная", "Пузырьковая", "Лепестковая", "Биржевая", "Точечная", "Пузырьковая", "Лепестковая", "Биржевая",
"Кольцевая-доля", "Объёмная с столбцами", "Объёмная с областями", "Кольцевая-доля", "Объёмная с столбцами", "Объёмная с областями",
"Объёмная с линиями", "Поверхность", "График с накоплением", "Объёмная с линиями", "Поверхность", "График с накоплением",
"Вторичная круговая"); "Вторичная круговая", "Линейчатая с накоплением");
List<String> charts = new ArrayList<>(); List<String> charts = new ArrayList<>();
charts.add(scatter()); charts.add(scatter());
charts.add(bubble()); charts.add(bubble());
@@ -52,6 +52,7 @@ public final class ChartTypesDocxGenerator {
charts.add(surface()); charts.add(surface());
charts.add(stackedLine()); charts.add(stackedLine());
charts.add(ofPiePie()); charts.add(ofPiePie());
charts.add(stackedBar());
StringBuilder body = new StringBuilder(); StringBuilder body = new StringBuilder();
body.append("<w:p><w:r><w:t>Типы диаграмм</w:t></w:r></w:p>"); body.append("<w:p><w:r><w:t>Типы диаграмм</w:t></w:r></w:p>");
@@ -226,6 +227,14 @@ public final class ChartTypesDocxGenerator {
+ catAx(1, 2) + valAx(2, "l", 1); + catAx(1, 2) + valAx(2, "l", 1);
} }
private static String stackedBar() {
return "<c:barChart><c:barDir val=\"bar\"/><c:grouping val=\"stacked\"/><c:varyColors val=\"0\"/>"
+ ser("План", cat("Q1", "Q2", "Q3"), num("4", "7", "5"))
+ ser("Факт", cat("Q1", "Q2", "Q3"), num("6", "5", "9"))
+ "<c:axId val=\"1\"/><c:axId val=\"2\"/></c:barChart>"
+ catAx(1, 2) + valAx(2, "b", 1);
}
// ---- фрагменты ---- // ---- фрагменты ----
/** ser с cat (или null) и val. */ /** ser с cat (или null) и val. */
@@ -171,10 +171,11 @@ class WordPdfConverterTest {
/** /**
* Фикстура chart-types.docx (создана вручную, chart-XML литералами — POI * Фикстура chart-types.docx (создана вручную, chart-XML литералами — POI
* эти типы не пишет): все одиннадцать — точечная, пузырьковая, * эти типы не пишет): все двенадцать — точечная, пузырьковая,
* лепестковая, биржевая, кольцевая-доля, три объёмных декартовых, * лепестковая, биржевая, кольцевая-доля, три объёмных декартовых,
* поверхность, график с накоплением (c:grouping=stacked, §21.2.2.76) * поверхность, график с накоплением и линейчатая с накоплением
* и pie-вариант кольцевой-доли (c:ofPieType="pie") — * (c:grouping=stacked, §21.2.2.76) и pie-вариант кольцевой-доли
* (c:ofPieType="pie") —
* рендерятся в растр, а не удаляются с warn. * рендерятся в растр, а не удаляются с warn.
* Регрессия — WordPdfConverterTest#chartTypes_allTypesRenderAsImages. * Регрессия — WordPdfConverterTest#chartTypes_allTypesRenderAsImages.
*/ */
@@ -184,8 +185,8 @@ class WordPdfConverterTest {
String text = norm(pdfText(pdf)); String text = norm(pdfText(pdf));
assertTrue(text.contains("Типы диаграмм"), "пропал текст: " + text); assertTrue(text.contains("Типы диаграмм"), "пропал текст: " + text);
assertEquals(11, distinctImageCount(pdf), assertEquals(12, distinctImageCount(pdf),
"каждый из 11 графиков должен стать PNG-вставкой"); "каждый из 12 графиков должен стать PNG-вставкой");
} }
/** /**
@@ -520,6 +520,72 @@ class CartesianPainterTest {
"stacked: сумма 4→2 — линия снижается, spread=" + (sBlue[2] - sBlue[0])); "stacked: сумма 4→2 — линия снижается, spread=" + (sBlue[2] - sBlue[0]));
} }
/**
* barChart c:grouping=stacked (§21.2.2.76): сегмент ряда на кумулятивной
* сумме предыдущих. Данные {{2,2,2},{1,1,1}}: в standard верх красного
* ряда (2) ВЫШЕ верха синего (1); в stacked синий сегмент лежит на красном
* (сумма 3) — его верх ВЫШЕ. Инверсия верхних кромок — наблюдаемое отличие
* кумулятивной отрисовки.
* Регрессия — CartesianPainterTest#stackedBar_seriesStackCumulatively.
*/
@Test
void stackedBar_seriesStackCumulatively() {
double[][] data = {{2, 2, 2}, {1, 1, 1}};
BufferedImage plain = ChartRenderer.render(
barStackedSpec(ChartSpec.Type.BAR, "standard", data),
219.23, 149.08, new DrawMlColor(null));
int[] red = yStats(plain, Color.RED);
int[] blue = yStats(plain, Color.BLUE);
assertTrue(red[1] < NO_LINE, "красный столбец (ряд 1) не найден");
assertTrue(blue[1] < NO_LINE, "синий столбец (ряд 2) не найден");
assertTrue(red[0] < blue[0],
"standard: ряд 1 (2) должен быть выше ряда 2 (1): red=" + red[0]
+ ", blue=" + blue[0]);
BufferedImage stacked = ChartRenderer.render(
barStackedSpec(ChartSpec.Type.BAR, "stacked", data),
219.23, 149.08, new DrawMlColor(null));
int[] sRed = yStats(stacked, Color.RED);
int[] sBlue = yStats(stacked, Color.BLUE);
assertTrue(sRed[1] < NO_LINE, "красный сегмент в stacked не найден");
assertTrue(sBlue[1] < NO_LINE, "синий сегмент в stacked не найден");
assertTrue(sBlue[0] < sRed[0],
"stacked: синий сегмент накоплен до 3 — должен быть выше красного (2): red="
+ sRed[0] + ", blue=" + sBlue[0]);
}
/**
* barChart c:barDir=bar (горизонтальная ориентация) с c:grouping=stacked:
* то же накопление по оси X. В standard правый край красного (2) дальше
* правого края синего (1); в stacked синий сегмент (до 3) правее красного
* (до 2). Регрессия — CartesianPainterTest#stackedBarHorizontal_seriesStackCumulatively.
*/
@Test
void stackedBarHorizontal_seriesStackCumulatively() {
double[][] data = {{2, 2, 2}, {1, 1, 1}};
BufferedImage plain = ChartRenderer.render(
barStackedSpec(ChartSpec.Type.BAR_HORIZONTAL, "standard", data),
219.23, 149.08, new DrawMlColor(null));
int[] red = xStats(plain, Color.RED);
int[] blue = xStats(plain, Color.BLUE);
assertTrue(red[1] < NO_LINE, "красная полоса (ряд 1) не найдена");
assertTrue(blue[1] < NO_LINE, "синяя полоса (ряд 2) не найдена");
assertTrue(red[2] > blue[2],
"standard: ряд 1 (2) должен быть правее ряда 2 (1): red=" + red[2]
+ ", blue=" + blue[2]);
BufferedImage stacked = ChartRenderer.render(
barStackedSpec(ChartSpec.Type.BAR_HORIZONTAL, "stacked", data),
219.23, 149.08, new DrawMlColor(null));
int[] sRed = xStats(stacked, Color.RED);
int[] sBlue = xStats(stacked, Color.BLUE);
assertTrue(sRed[1] < NO_LINE, "красный сегмент в stacked не найден");
assertTrue(sBlue[1] < NO_LINE, "синий сегмент в stacked не найден");
assertTrue(sBlue[2] > sRed[2],
"stacked: синий сегмент накоплен до 3 — должен быть правее красного (2): red="
+ sRed[2] + ", blue=" + sBlue[2]);
}
/** LINE-спека с заданным grouping; ряды — явные RED/BLUE без маркеров. */ /** LINE-спека с заданным grouping; ряды — явные RED/BLUE без маркеров. */
private static ChartSpec lineSpec(String grouping, double[][] data) { private static ChartSpec lineSpec(String grouping, double[][] data) {
ChartSpec spec = new ChartSpec(); ChartSpec spec = new ChartSpec();
@@ -565,4 +631,50 @@ class CartesianPainterTest {
} }
return new int[]{ys.get(0), ys.get(ys.size() / 2), ys.get(ys.size() - 1)}; return new int[]{ys.get(0), ys.get(ys.size() / 2), ys.get(ys.size() - 1)};
} }
/** BAR/BAR_HORIZONTAL-спека с заданным grouping; ряды — явные RED/BLUE fill. */
private static ChartSpec barStackedSpec(ChartSpec.Type type, String grouping,
double[][] data) {
ChartSpec spec = new ChartSpec();
spec.type = type;
spec.grouping = grouping;
spec.legendPos = null;
DrawMlText.Style style = new DrawMlText.Style(9, false, false,
new Color(0x59, 0x59, 0x59), "carlito");
spec.catAxis = new ChartSpec.AxisSpec();
spec.catAxis.labelStyle = style;
spec.valAxis = new ChartSpec.AxisSpec();
spec.valAxis.labelStyle = style;
Color[] colors = {Color.RED, Color.BLUE};
for (int si = 0; si < data.length; si++) {
ChartSpec.Series s = new ChartSpec.Series();
s.fill = colors[si];
for (double v : data[si]) {
s.values.add(v);
}
spec.series.add(s);
}
return spec;
}
/** {minX, medianX, maxX} пикселей цвета target (с AA-краями); NO_LINE — нет. */
private static int[] xStats(BufferedImage img, Color target) {
List<Integer> xs = new ArrayList<>();
for (int x = 0; x < img.getWidth(); x++) {
for (int y = 0; y < img.getHeight(); y++) {
int rgb = img.getRGB(x, y);
int dr = Math.abs(((rgb >> 16) & 0xFF) - target.getRed());
int dg = Math.abs(((rgb >> 8) & 0xFF) - target.getGreen());
int db = Math.abs((rgb & 0xFF) - target.getBlue());
if (Math.max(Math.max(dr, dg), db) < COLOR_MATCH_MAX_DELTA) {
xs.add(x);
break;
}
}
}
if (xs.isEmpty()) {
return new int[]{NO_LINE, NO_LINE, -1};
}
return new int[]{xs.get(0), xs.get(xs.size() / 2), xs.get(xs.size() - 1)};
}
} }
@@ -1306,6 +1306,34 @@ class ChartSpecTest {
assertEquals("standard", standard.grouping, "нет c:grouping — дефолт модели standard"); assertEquals("standard", standard.grouping, "нет c:grouping — дефолт модели standard");
} }
/** c:barChart: c:grouping (§21.2.2.76) stacked/percentStacked/дефолт standard. */
@Test
void barGroupingParsed() {
CTBarChart stacked = new CTBarChart();
CTBarGrouping grouping = new CTBarGrouping();
grouping.setVal(STBarGrouping.STACKED);
stacked.setGrouping(grouping);
CTBarSer ser = new CTBarSer();
ser.setCat(catStr("А", "Б"));
ser.setVal(numSource(numCache(1, 2)));
stacked.getSer().add(ser);
ChartSpec spec = new ChartSpec();
ChartSpec.readGroup(stacked, spec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.BAR, spec.type);
assertEquals("stacked", spec.grouping);
grouping.setVal(STBarGrouping.PERCENT_STACKED);
ChartSpec percent = new ChartSpec();
ChartSpec.readGroup(stacked, percent, new DrawMlColor(null), List.of());
assertEquals("percentStacked", percent.grouping);
CTBarChart bare = new CTBarChart();
bare.getSer().add(new CTBarSer());
ChartSpec standard = new ChartSpec();
ChartSpec.readGroup(bare, standard, new DrawMlColor(null), List.of());
assertEquals("standard", standard.grouping, "нет c:grouping — дефолт модели standard");
}
/** c:stockChart: hiLowLines/dropLines/upDownBars с цветами up/down. */ /** c:stockChart: hiLowLines/dropLines/upDownBars с цветами up/down. */
@Test @Test
void stockFlagsParsed() { void stockFlagsParsed() {