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