Skip to contents

as.data.frame() returns a result's table as an ordinary data frame, for filtering, joining, or writing to a file. A result that holds several tables returns the one named by component; a single test returns one row. Fitted workflows have their own method, as.data.frame.contentvalid_workflow().

Usage

# S3 method for class 'contentvalid_cvi'
as.data.frame(x, row.names = NULL, optional = FALSE, component = NULL, ...)

# S3 method for class 'contentvalid_gtheory'
as.data.frame(x, row.names = NULL, optional = FALSE, component = NULL, ...)

# S3 method for class 'contentvalid_structure'
as.data.frame(x, row.names = NULL, optional = FALSE, component = NULL, ...)

# S3 method for class 'contentvalid_rounds'
as.data.frame(x, row.names = NULL, optional = FALSE, component = NULL, ...)

# S3 method for class 'contentvalid_handoff'
as.data.frame(x, row.names = NULL, optional = FALSE, component = NULL, ...)

# S3 method for class 'contentvalid_sort_power'
as.data.frame(x, row.names = NULL, optional = FALSE, ...)

# S3 method for class 'contentvalid_expert_power'
as.data.frame(x, row.names = NULL, optional = FALSE, ...)

# S3 method for class 'contentvalid_agreement'
as.data.frame(x, row.names = NULL, optional = FALSE, ...)

# S3 method for class 'contentvalid_binom'
as.data.frame(x, row.names = NULL, optional = FALSE, ...)

# S3 method for class 'contentvalid_signal'
as.data.frame(x, row.names = NULL, optional = FALSE, ...)

# S3 method for class 'contentvalid_reproducibility'
as.data.frame(x, row.names = NULL, optional = FALSE, ...)

Arguments

x

A contentvalidR result.

row.names, optional

Accepted for compatibility with base::as.data.frame() and ignored.

component

The table to return, where a result holds more than one (NULL, the default, gives the first listed):

  • cvi(): "item_level" (default) or "scale_level".

  • gtheory_content(): "variance_components" (default), "coefficients", "dstudy", or "judges_needed".

  • content_structure(): "items" (default; each item's cluster, blueprint cell and coordinates), "fit", or "cross_tab".

  • compare_rounds(): "transitions" (default), "summary", or "settings_changes".

  • content_handoff(): "item_evidence" (default), "item_statistics", or "panel_statistics".

...

Not used.

Value

A data frame. csv_binom_test(), signal_detection(), reproducibility_phi() and panel_agreement() give one row: an interval becomes two columns, and a two-by-two table becomes its four counts. For panel_agreement() the interval's error rate is ci_alpha, since alpha would read as Krippendorff's; for csv_binom_test() the one-sided interval is marked by ci_sides and ci_level.

Examples

R <- matrix(c(4, 3, 4, 4, 3, 4, 2, 3, 4, 4, 3, 2), 6,
            dimnames = list(NULL, c("I1", "I2")))
as.data.frame(cvi(R >= 3))
#>   item A N     I_CVI I_CVI_low I_CVI_high       Pc kappa_mod
#> 1   I1 6 6 1.0000000 0.6096657  1.0000000 0.015625 1.0000000
#> 2   I2 4 6 0.6666667 0.2999933  0.9032286 0.234375 0.5646259
as.data.frame(cvi(R >= 3), component = "scale_level")
#>   S_CVI_Ave S_CVI_UA n_items
#> 1 0.8333333      0.5       2
as.data.frame(csv_binom_test(16, 20))
#>       p.value estimate    ci_low ci_high critical_n_target passes_chance
#> 1 0.005908966      0.8 0.5989719       1                15          TRUE
#>      decision                               interpretation n_target  N  p0
#> 1 significant Target assignments meet the exact criterion.       16 20 0.5
#>   alpha  ci_sides ci_level
#> 1  0.05 one-sided     0.95