position_dodge

position_dodge(width=NULL, height=NULL, ...)

Adjust position by dodging overlaps to the side

This page describes position_dodge, see layer and qplot for how to create a complete plot from individual components.

What do you think of the documentation? Please let me know by filling out this short online survey.

Parameters

Parameters control the appearance of the position. In addition to the parameters listed below (if any), any aesthetic can be used as a parameter, in which case it will override any aesthetic mapping.

Returns

This function returns a position object.

Examples

> ggplot(mtcars, aes(x=factor(cyl), fill=factor(vs))) + geom_bar(position="dodge") 
  
> ggplot(diamonds, aes(x=price, fill=cut)) + geom_bar(position="dodge") 
stat_bin: binwidth defaulted to range/30. Use 'binwidth = x' to adjust this.

  
> # see ?geom_boxplot and ?geom_bar for more examples 
>  
> df <- data.frame(x=c("a","a","b","b"), y=1:4) 
> p <- qplot(x, y, data=df, position="dodge", geom="bar", stat="identity") 
> p 
  
> p + geom_linerange(aes(ymin= y - 1, ymax = y+1), position="dodge") 
  
>  
> # Dodging things with different widths is tricky 
> p + geom_errorbar(aes(ymin= y - 1, ymax = y+1), width=0.2, position="dodge") 
  
> # You can specify the width to use for dodging (instead of the actual 
> # width of the object) as follows 
> p + geom_errorbar(aes(ymin= y - 1, ymax = y+1, width=0.2), 
+ position=position_dodge(width=0.90)) 
  

What do you think of the documentation? Please let me know by filling out this short online survey.