plot.permtstBurSt {BurStMisc}R Documentation

Plot Distribution from a Permutation Test


Shows the distribution of the scores of the random permutations relative to the score from the actual data.


## S3 method for class 'permtstBurSt'
plot(x, col = c("black", "red"), width = 10, 
	uniqlim = 10, main = "", xlab = "Scores", ...)



an object of class permtstBurSt, which is likely the result of:

permutation.test.discrete or


the colors to use in the plot – mainly for the bar-type plot when there are only a few scores in the permutation distribution. The first color is the one used for the insignificant part of the distribution, the second color is for the significant part of the distribution. The second color is used to identify the original score when a histogram is used.


the width of the bars.


the value that determines which type of plot to use. If the number of unique values in the scores from the permutations is bigger than uniqlim, then a histogram is drawn. Otherwise, bars are drawn.


character string giving the main title for the plot.


character string giving the label for the x-axis.


additional graphics parameters may be given.

Side effects

a plot is produced.


Two styles of plot are possible. A histogram is more appropriate when there are more than a few values in the permutation distribution. When there are only a few distinct values, then a bar-type plot is more informative. The uniqlim argument controls the definition of "a few".

These functions are related to "Permuting Super Bowl Theory" which can be found in the working papers section of The paper explains permutation tests via a discussion of the Super Bowl indicator of the stock market.

See Also



## Not run: 
pt1 <- permutation.test.discrete(winner, market, smat)
plot(pt1, col=c("blue", "gold"))

## End(Not run)

[Package BurStMisc version 1.1 Index]