Base.plotFeatureGroupStatistics

Base.plotFeatureGroupStatistics(statistic, feature, groupFeature, subgroupFeature=None, horizontal=False, outPath=None, show=True, figureID=None, title=True, xAxisLabel=True, yAxisLabel=True, **kwargs)

Plot an aggregate statistic for each group of a feature.

A bar chart where each bar in the plot represents the output of the statistic function applied to each group (or subgroup, when applicable).

Parameters:

  • statistic (function) – Functions must take a feature view as an argument and return a single numeric value. Common statistic functions can be found in nimble.calculate.

  • feature (identifier) – The feature name or index that will be grouped.

  • groupFeature (identifier) – The feature name or index that defines the groups in feature

  • subgroupFeature (identifier, None) – An optional subgrouping feature. When not None, the bar for each group defined by groupFeature will be subdivided based on this feature with a unique colored bar for each subgroup. This may be the same as feature if its values define the subgroups.

  • horizontal (bool) – False, the default, draws plot bars vertically. True will draw bars horizontally.

  • outPath (str, None) – A string of the path to save the current figure.

  • show (bool) – If True, display the plot. If False, the figure will not display until a plotting function with show=True is called. This allows for future plots to placed on the figure with the same figureID before being shown.

  • figureID (hashable, None) – A new figure will be generated for None or a new id, otherwise the figure with that id will be activated to draw the plot on the existing figure.

  • title (str, bool) – The title of the plot. If True, a title will automatically be generated.

  • xAxisLabel (str, bool) – A label for the x axis. If True, a label will automatically be generated.

  • yAxisLabel (str, bool) – A label for the y axis. If True, a label will automatically be generated.

  • kwargs – Any keyword arguments accepted by matplotlib.pyplot’s bar function.

See also

nimble.calculate.statistic, matplotlib.pyplot.bar

Keywords: bar chart, centers, compare, chart, figure, image, graphics, side by side, bar chart, t-test, uncertainty, groups, stats, visualization