coord_nested: Coord Nested

In IPV: Item Pool Visualization

Coord Nested

Description

Generates the coordinates for a nested chart and all other charts.

Usage

coord_nested(
  data,
  cd_method = "aggregate",
  test_order = NULL,
  facet_order = NULL,
  subradius = 0,
  tick = 0,
  rotate_tick_label = 0,
  rotate_radians = 0,
  rotate_degrees = 0,
  subrotate_radians = 0,
  subrotate_degrees = 0,
  dist_construct_label = 10,
  rotate_construct_label_radians = 0,
  rotate_construct_label_degrees = 0,
  dist_test_labels = 2/3,
  rotate_test_labels_radians = 0,
  rotate_test_labels_degrees = 0,
  prepare_item_charts = FALSE,
  correlations = TRUE,
  cor_spacing = 0,
  relative_scaling = 0,
  xarrows = TRUE
)

Arguments

data	Object of class IPV as created by the function 'ipv_est'
cd_method	character; method to summarize center distances, either "mean" or "aggregate", see details; defaults to "aggregate".
test_order	character; vector of test names in desired order (counter-clockwise); defaults to NULL, in which case the order is based on the correlation matrix columns in 'data'.
facet_order	character; vector of all facet names of all tests in desired order (counter-clockwise); defaults to NULL, in which case the order is based on the correlation matrix columns in 'data'.
subradius	integer; same unit as center distances; radius of the facet circles; defaults to 0, in which case an appropriate value is estimated.
tick	numeric; axis tick position; defaults to 0, in which case an appropriate value is estimated.
rotate_tick_label	numeric; number of positions to move the tick label (counter-clockwise); defaults to 0.
rotate_radians	integer; radian angle to rotate the chart counter-clockwise by; use fractions of pi (e.g. pi/2 = 90 degrees).
rotate_degrees	integer; angle in degrees to rotate the chart counter-clockwise by.
subrotate_radians	integer; radian angle or vector of radian angles to rotate the nested facet charts counter-clockwise by; use fractions of pi (e.g. pi/2 = 90 degrees).
subrotate_degrees	integer; angle in degrees or vector of angles in degrees to rotate the nested facet charts counter-clockwise by.
dist_construct_label	integer; position of the construct label relative to the surrounding circle; defaults to 10, in which case an appropriate value is estimated; a value of .5 would position the label halfway between the center and the surrounding circle.
rotate_construct_label_radians	integer; radian angle to rotate the construct label counter-clockwise by; use fractions of pi (e.g. pi/2 = 90 degrees).
rotate_construct_label_degrees	integer; angle in degrees to rotate the construct label counter-clockwise by.
dist_test_labels	integer; position of the test labels relative to the surrounding circle; defaults to 2/3, in which case the test labels are displayed 2/3 of the way from the centers to the surrounding circles.
rotate_test_labels_radians	integer; radian angle or vector of radian angles to rotate the test labels counter-clockwise by; use fractions of pi (e.g. pi/2 = 90 degrees).
rotate_test_labels_degrees	integer; angle or vector of angle in degrees to rotate the test labels counter-clockwise by.
prepare_item_charts	logical; if TRUE, generates the item chart coordinates for all factors by calling coord_items.
correlations	logical; if TRUE, generates the coordinates for the latent correlations between tests. Sets up a ring to draw them in. If FALSE, the ring and the correlations are omitted, simplifying the chart significantly.
cor_spacing	integer; if correlations = TRUE: width of the ring, the latent correlations between tests are drawn in; defaults to 0, in which case an appropriate value is estimated.
relative_scaling	integer; relative size of the global chart scale compared to the nested facet chart scales; defaults to 0, in which case an appropriate value is estimated.
xarrows	logical; should arrows between tests be displayed?; defaults to TRUE.

Details

Use nested_chart to create nested charts.

Value

List containing coordinates of chart objects.

See Also

plot_nested nested_chart

IPV documentation built on Sept. 30, 2022, 5:08 p.m.