print.cna: 'print' method for an object of class "cna"

In cna: Causal Modeling with Coincidence Analysis

print method for an object of class “cna”

Description

By default, the method print.cna first lists the implemented ordering (if any) as well as the pre-specified outcome(s) (if any). Second, it shows the measures con and cov used for model building. Third, the top 5 asf and, fourth, the top 5 csf are reported, along with an indication of how many solutions exist in total. To print all msc, asf, and csf, the value of nsolutions can be suitably increased, or the functions in cna-solutions can be used.

While msc and asf are stored in the output object of cna, csf are not. The latter are derived from the inventory of asf at execution time (by running the function csf) whenever a “cna” object is printed.

Usage

## S3 method for class 'cna'
print(x, what = x$what, digits = 3, nsolutions = 5, 
      printMeasures = TRUE, details = x$details, show.cases = NULL, 
      verbose = FALSE, ...)

Arguments

x	Object of class “cna”.
what	Character string specifying what to print; "t" for the configuration table, "m" for msc, "a" for asf, "c" for csf, and "all" for all. Defaults to "ac" if suff.only = FALSE, and to "m" otherwise (for suff.only see cna).
digits	Number of digits to print in evaluation measures (e.g. consistency and coverage) as well as in exhaustiveness, faithfulness, and coherence scores.
nsolutions	Maximum number of msc, asf, and csf to print. Alternatively, nsolutions = "all" will print all solutions.
printMeasures	Logical; if TRUE, the output indicates which measures for sufficiency and necessity evaluation were used.
details	Character vector specifying the evaluation measures and additional solution attributes to be printed. Possible elements are all the measures in showMeasures. Can also be TRUE/FALSE. If FALSE (default), no additional measures are returned; TRUE resolves to c("inus", "cyclic", "exhaustiveness", "faithfulness", "coherence"). See also detailMeasures.
show.cases	Logical; if TRUE, the attribute “cases” of the analyzed configTable is printed (see print.configTable).
verbose	Logical; passed to csf.
...	Arguments passed to other print-methods.

Details

The argument what regulates what items of the output of cna are printed. If the string assigned to what contains the character “t”, the configuration table is printed; if it contains an “m”, the msc are printed; if it contains an “a”, the asf are printed; if it contains a “c”, the csf are printed. what = "all" and what = "tmac" print all output items. If the argument suff.only is set to TRUE in the cna call that generated x, what defaults to "m".

The argument digits determines how many digits of the evaluation measures and solution attributes are printed, while nsolutions fixes the number of conditions and solutions to print.
nsolutions applies separately to minimally sufficient conditions, atomic solution formulas, and complex solution formulas. nsolutions = "all" recovers all minimally sufficient conditions, atomic and complex solution formulas. show.cases is applicable if the what argument is given the value “t”. In that case, show.cases = TRUE yields a configuration table featuring a “cases” column, which assigns cases to configurations.

The option “spaces” controls how the conditions are rendered. The current setting is queried by typing getOption("spaces"). The option specifies characters that will be printed with a space before and after them. The default is c("<->","->","+"). A more compact output is obtained with option(spaces = NULL).

See Also

cna, csf, cna-solutions, detailMeasures, showMeasures

Examples

# Analysis of crisp-set data.
cna.educate <- cna(d.educate)
cna.educate
# Print only complex solution formulas.
print(cna.educate, what = "c")
# Print only atomic solution formulas.
print(cna.educate, what = "a")
# Print only minimally sufficient conditions.
print(cna.educate, what = "m")
# Print only the configuration table.
print(cna.educate, what = "t")
# Print solutions with spaces before and after "*".
options(spaces = c("<->", "->", "*" ))
cna(d.educate, details = c("e", "f", "PAcon", "PACcov"))
# Restore the default of the option "spaces".
options(spaces = c("<->", "->", "+"))

# Analysis of multi-value data. 
cna.pban <- cna(d.pban, outcome = "PB=1", cov = .95, maxstep = c(6, 6, 10), 
								what = "all")
cna.pban
# Print only the atomic solution formulas.
print(cna.pban, what = "a", nsolutions = "all")
# Do not print the specification of the evaluation measures.
print(cna.pban, what = "a", nsolutions = "all", printMeasures = FALSE)
# Print further details.
print(cna.pban, nsolutions = "all", details = c("AACcon", "AAcov", "ex", "fa"))
# Print more digits.
print(cna.pban, nsolutions = "all", digits = 6)
# Print the configuration table with the "cases" column.
print(cna.pban, what = "t", show.cases = TRUE, printMeasures = FALSE)

cna documentation built on April 11, 2025, 6:10 p.m.