matlab stats（statistics）工具箱

function h=boxplot(varargin) %BOXPLOT Displays box plots of multiple data samples. % BOXPLOT(X) produces a box plot of the data in X. If X is a matrix there % is one box per column, and if X is a vector there is just one box. On % each box, the central mark is the median, the edges of the box are the % 25th and 75th percentiles, the whiskers extend to the most extreme % datapoints the algorithm considers to be not outliers, and the outliers % are plotted individually. % % BOXPLOT(X,G) specifies one or more grouping variables G, producing a % separate box for each set of X values sharing the same G value or % values. Grouping variables must have one row per element of X, or one % row per column of X. Specify a single grouping variable in G by using a % vector, a character array, a cell array of strings, or a vector % categorical array; specify multiple grouping variables in G by using a % cell array of these variable types, such as {G1 G2 G3}, or by using a % matrix. If multiple grouping variables are used, they must all be the % same length. Groups that contain a NaN or an empty string ('') in a % grouping variable are omitted, and are not counted in the number of % groups considered by other parameters. % % By default, character and string grouping variables are sorted in the % order they initially appear in the data, categorical grouping variables % are sorted by the order of their levels, and numeric grouping variables % are sorted in numeric order. To control the order of the groups, % you can either use categorical variables in G and specify the order of % their levels, or use the 'positions' argument. % % BOXPLOT(AX, X, ...) produces a box plot in axes with handle AX. % % BOXPLOT(..., 'PARAM1', val1, 'PARAM2', val2, ...) specifies optional % parameter name/value pairs. % 'plotstyle' 'traditional' (default), or 'compact' to specify a % box style designed for plots with many groups. The % plotstyle changes the defaults for some other % parameters, as described below. % % 'boxstyle' 'outline' (default) to draw an unfilled box with % dashed lines for whiskers, or 'filled' to draw a % narrow filled box with solid lines for whiskers. % 'colorgroup' One or more grouping variables, of the same type as % permitted for G, specifying that the box color should % change when the specified variables change. Default % is [] for no box color change. % 'colors' Colors for boxes, specified as a single color (such % as 'r' or [1 0 0]) or multiple colors (such as 'rgbm' % or a three-column matrix of RGB values). The sequence % is replicated or truncated as required, so for example % 'rb' gives boxes that alternate in color. Default % when no 'colorgroup' is specified is to use the same % color scheme for all boxes. Default with % 'colorgroup' is a modified hsv colormap. % 'datalim' A two-element vector containing lower and upper limits, % used by 'extrememode' to determine which points are % extreme. Default is [-Inf Inf]. % 'extrememode' 'clip' (default) to move data outside the 'datalim' % limits to the limit, or 'compress' to distribute such % points evenly in a region just outside the limit, % retaining the relative order of the points. A % dotted line marks the limit if any points are outside % it, and two gray lines mark the compression region if % any points are compressed. Values at +/-Inf can be % clipped or compressed, but NaNs still do not appear % on the plot. Box notches are drawn to scale and may % extend beyond the bounds if the median is inside the % limit; they are not drawn if the median is outside % the limits. % 'factordirection' 'data' (default) to arrange the factors with the % first value next to the origin, 'list' to arrange the % factors left-to-right if on the x axis or top-to- % bottom if on the y axis, or 'auto' to use 'data' for % numeric grouping variables and 'list' for strings. % 'fullfactors' 'off' (default) to have one group for each unique row % of G, or 'on' to create a group for each possible % combination of group variable values, including % combinations that do not appear in the data. % 'factorseparator' Specifies which factors should have their values % separated by a grid line. The value may be 'auto' or % a vector of grouping variable numbers. For example, % [1 2] adds a separator line when the first or second % grouping variable changes value. 'auto' is [] for % one grouping variable and [1] for two or more % grouping variables. Default is []. % 'factorgap' Specifies an extra gap to leave between boxes when % the corresponding grouping factor changes value, % expressed as a percentage of the width of the plot. % For example, with [3 1], the gap is 3% of the width % of the plot between groups with different values of % the first grouping variable, and 1% between groups % with the same value of the first grouping variable % but different values for the second. 'auto' % specifies that BOXPLOT should choose a gap % automatically. Default is []. % 'grouporder' Order of groups for plotting, specified as a cell % array of strings. With multiple grouping variables, % separate values within each string with a comma. % Using categorical arrays as grouping variables is an % easier way to control the order of the boxes. % 'jitter' Maximum distance D to displace outliers along the % factor axis by a uniform random amount, in order to % make duplicate points visible. D = 1 makes the % jitter regions just touch between the closest % adjacent groups. The default is 0. % 'labels' Character array, cell array of strings, or numeric % vector of box labels. May have one label per group % or per X value. Multiple label variables may be % specified via a numeric matrix or a cell array % containing any of these types. % 'labelorientation' 'horizontal' (default) for horizontal labels, or % 'inline' to draw the labels vertically when % 'orientation' has its default 'vertical' value. % 'labelverbosity' 'all' (default) to display every label, 'minor' to % display a label for a factor only when that factor % has a different value from the previous group, or % 'majorminor' to display a label for a factor when % that factor or any factor major to it has a % different value from the previous group. % 'medianstyle' 'line' (default) to draw a line for the median, or % 'target' to draw a black dot inside a white circle. % 'notch' 'on' to draw comparison intervals usi