Add example with vertical bars in BarSeriesExamples.cs (#2116)

mennowo · web-flow · commit 2dcffb42475f · 2025-01-23T18:43:06.000Z
* Add example with vertical bars in BarSeriesExamples.cs

In the past, there was ColumnSeries, which could have the categories be placed on the X axis. The BarSeries needs them on the Y axis. The new example show how to do this using axis keys.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,12 @@
 # Change Log
 All notable changes to this project will be documented in this file.
 
+## Unreleased
+
+### Added
+
+- Example to demonstrate how to create vertical BarSeries
+
 ## [2.2.0] - 2024-09-03
 
 ### Added
diff --git a/CONTRIBUTORS b/CONTRIBUTORS
@@ -96,6 +96,7 @@ Matthew Leibowitz <mattleibow@live.com>
 Memphisch <memphis@machzwo.de>
 Mendel Monteiro-Beckerman
 Menno Deij - van Rijswijk <m.deij@marin.nl>
+Menno van der Woude <mennowo@gmail.com>
 methdotnet
 Michael Fox <16841316+foxmja@users.noreply.github.com>
 Michael Hieke <mghie@gmx.net>
@@ -154,4 +155,4 @@ R. Usamentiaga
 Dmytro Shaurin
 Rustam Sayfutdinov
 Konstantin Stukov <havendv@gmail.com>
-jorgectf
+jorgectf
diff --git a/Source/Examples/ExampleLibrary/Series/BarSeriesExamples.cs b/Source/Examples/ExampleLibrary/Series/BarSeriesExamples.cs
@@ -82,6 +82,48 @@ public static PlotModel WithLabelsXAxisReversed()
             return WithLabels().ReverseXAxis();
         }
 
+        [Example("With vertical bars")]
+        public static PlotModel WithVerticalBars()
+        {
+            var model = new PlotModel
+            {
+                Title = "With labels",
+            };
+
+            var rnd = new Random(1);
+            var series = new List<BarSeries>
+            {
+                new BarSeries { Title = "Base", XAxisKey = "values", YAxisKey = "categories" },
+                new BarSeries { Title = "Inside", XAxisKey = "values", YAxisKey = "categories" },
+                new BarSeries { Title = "Middle", XAxisKey = "values", YAxisKey = "categories" },
+                new BarSeries { Title = "Outside", XAxisKey = "values", YAxisKey = "categories" }
+            };
+
+            for (int i = 0; i < 4; i++)
+            {
+                foreach (var s in series)
+                {
+                    s.Items.Add(new BarItem() { Value = rnd.Next(-100, 100) });
+                }
+            }
+
+            var categoryAxis = new CategoryAxis { Position = AxisPosition.Bottom, Key = "categories" };
+            categoryAxis.Labels.Add("Category A");
+            categoryAxis.Labels.Add("Category B");
+            categoryAxis.Labels.Add("Category C");
+            categoryAxis.Labels.Add("Category D");
+            var valueAxis = new LinearAxis { Position = AxisPosition.Left, MinimumPadding = 0.06, MaximumPadding = 0.06, ExtraGridlines = new[] { 0d }, Key = "values" };
+
+            foreach (var s in series)
+            {
+                model.Series.Add(s);
+            }
+
+            model.Axes.Add(categoryAxis);
+            model.Axes.Add(valueAxis);
+            return model;
+        }
+
         [Example("Stacked")]
         [DocumentationExample("Series/BarSeries")]
         public static PlotModel StackedSeries()
