plot_items: Plot Items

Description Usage Arguments Details Value See Also Examples

View source: R/plot_items.R

Description

Plots an item chart, showing the items of a test arranged by facets.

Usage

1
2
3
4
5
plot_items(coord, size = 1, filename = "myipv.pdf", filewidth = 12,
  fileheight = 10, colour = "black", colour2 = "black", fade = 85,
  font = "sans", tick_label = TRUE, size_tick_label = 1, size_title = 1,
  size_facet_labels = 1, width_axes = 1, size_arrow_heads = 1,
  width_items = 1, width_grid = 1, size_center_dot = 1)

Arguments

coord

list generated by coord_items or coord_nested.

size

integer; smartly scaled size of chart objects except item bars.

filename

character; name of the file to save. Supported formats are: "pdf" (best quality with lowest file size), "png", "jpeg". Use "none" to suppress file output; defaults to "myipv.pdf".

filewidth

integer; width of the .pdf document; defaults to 12; dpi is 3000.

fileheight

integer; height of the .pdf document; defaults to 10, dpi is 3000.

colour

character; name of the first accent colour.

colour2

character; name of the second accent colour.

fade

integer; brightness of minor grid lines, gray tones between 0 (black) and 100 (white) in steps of 1; defaults to 85.

font

character; text font; defaults to 'sans' (use extrafonts to install additional fonts).

tick_label

logical; if TRUE, draws a text label for the axis tick

size_tick_label

integer; font size of the axis tick label (relative to default).

size_title

integer; font size of the test label (relative to default).

size_facet_labels

integer; font size of the axis labels (relative to default).

width_axes

integer; width of the radial axis lines indicating center distances (relative to default).

size_arrow_heads

integer; length of the arrow heads at the end of the axes (relative to default).

width_items

integer; width of the item bars (relative to default).

width_grid

integer; width of the dotted grid lines (relative to default).

size_center_dot

integer; size of the center dot marking the origin (relative to default).

Details

Use this function in conjunction with coord_items or coord_nested for simple models.

Use item_chart to create the chart in a single step.

Rotate using coord_items, not this function.

When changing the size of objects, consider the size parameter first and make specific adjustments with the other size_ and width_ parameters after.

To better display overlapping item values, change the width of the item bars, or set the accent colours to different values, or change the ratio of item lengths.

Value

Object of the class "ggplot" and optionally the same object saved as a file.

See Also

coord_items item_chart

Examples

1
2
3
4
5
# # creating item charts is a two step process, using coord_items and this
# # function:
# coord <- coord_items(DSSEI)
# DSSEI_items <- plot_items(coord, filename = "DSSEI_items.pdf")
# DSSEI_items

NilsPetras/IPV documentation built on Dec. 7, 2018, 8:55 a.m.