plotcategory¶
plotcategory plots a category plot with grouped bars.
-
rvData = plotcategory(svCategoryLabel, rmData)
-
rvData = plotcategory(svCategoryLabel, rmData, oParameter)
Return Value
rvData is a vector with dataset handles.
Parameters
-
svCategoryLabel
svCategoryLabel is a string vector with category labels.
-
rmData
rmData is a real matrix. Each column creates a dataset. The number of rows should match the number of elements of svCategoryLabel.
-
oParameter
oParameter is an object with optional parameters.
Element Name Description Default Value hLayer Layer handle. 0: a new layer will be created 0 rvStacked = [0,1,1,0] A real vector with 0 (grouped) or 1 (stacked). The number of elements should match the number of datasets. 0: grouped gapwidth gap between categories in the range 0 to 5 (0 to 500 percent or bar width). 1.0 overlap bar overlap in the range -1 to 1 (-100 to 100 percent or bar width). -0.2 bAutoscale; autoscale axes 1 bReplot replot page 1 b100percent; scale stacked bars to 100 percent. 0 xTitle x axis title “” (do not modify title) yTitle y axis title “” (do not modify title) color_scale color scale, see ColorScale_GetNames Example: color_scale = 'Blues'
Purpels bLabel Show or hide bar labels 1 (show label) nLabelPosition Label position: 1: inside bottom, 2: inside center, 3: inside top, 4: outside top 3 (inside top)
Example
The following example will create a diagram with a random data. 6 datasets with 4 values.
svCategoryLabel = "";
rmData = rand(4,6);
o = [. rvStacked = [1,1,1,0,1,1], xTitle = "Period", yTitle = "Value in %"];
plotcategory(svCategoryLabel, rmData, o)
See also
DocCreate, PageCreate, PageGetParentDocument, LayerCreate, XYCreate, NC_plotcategory, GetParent, ColorScale_GetNames
id-2043309