plot_tab plots a 2 x 2 contingency table (aka. confusion table) of 4 classification cases (hi, mi, fa, cr) and corresponding row and column sums.

plot_tab(prev = num$prev, sens = num$sens, mirt = NA,
spec = num$spec, fart = NA, N = num$N, by = "cddc",
p_split = "v", area = "no", scale = "p", round = TRUE,
f_lbl = "num", f_lbl_sep = NA, f_lbl_sum = f_lbl,
f_lbl_hd = "abb", f_lwd = 0, gaps = c(NA, NA), brd_w = 0.1,
p_lbl = NA, arr_c = -3, col_p = c(grey(0.15, 0.99), "yellow",

Nothing (NULL).

## Details

plot_tab computes its frequencies freq from a sufficient and valid set of 3 essential probabilities (prev, and sens or its complement mirt, and spec or its complement fart) or existing frequency information freq and a population size of N individuals.

plot_tab is derived from plot_area, but does not scale the dimensions of table cells.

plot_area for plotting mosaic plot (scaling area dimensions); pal contains current color settings; txt contains current text settings.

Other visualization functions: plot.riskyr, plot_area, plot_bar, plot_curve, plot_fnet, plot_icons, plot_mosaic, plot_plane, plot_prism, plot_tree

## Examples

## Basics:
# (1) Plotting global freq and prob values:
plot_tab()plot_tab(area = "sq", f_lwd = 3, col_pal = pal_rgb)plot_tab(f_lbl = "namnum", f_lbl_sep = " = ", brd_w = .10, f_lwd = .5)
# (2) Computing local freq and prob values:
plot_tab(prev = .5, sens = 4/5, spec = 3/5, N = 10, f_lwd = 1)
## Plot versions:
# by x p_split [yields (3 x 2) x 2] = 12 versions]:
plot_tab(by = "cddc", p_split = "v", p_lbl = "def")  # v01 (see v07)plot_tab(by = "cdac", p_split = "v", p_lbl = "def")  # v02 (see v11)plot_tab(by = "cddc", p_split = "h", p_lbl = "def")  # v03 (see v05)plot_tab(by = "cdac", p_split = "h", p_lbl = "def")  # v04 (see v09)
plot_tab(by = "dccd", p_split = "v", p_lbl = "def")  # v05 (is v03 rotated)plot_tab(by = "dcac", p_split = "v", p_lbl = "def")  # v06 (see v12)plot_tab(by = "dccd", p_split = "h", p_lbl = "def")  # v07 (is v01 rotated)plot_tab(by = "dcac", p_split = "h", p_lbl = "def")  # v08 (see v10)
plot_tab(by = "accd", p_split = "v", p_lbl = "def")  # v09 (is v04 rotated)plot_tab(by = "acdc", p_split = "v", p_lbl = "def")  # v10 (is v08 rotated)plot_tab(by = "accd", p_split = "h", p_lbl = "def")  # v11 (is v02 rotated)plot_tab(by = "acdc", p_split = "h", p_lbl = "def")  # v12 (is v06 rotated)
plot_tab(f_lbl = "abb", p_lbl = NA)  # abbreviated labels, no probability linksplot_tab(f_lbl = "num", f_lbl_sum = "abb", p_lbl = "num", f_lbl_hd = "abb")plot_tab(f_lbl = "abb", f_lbl_sum = "abb", p_lbl = "nam", f_lbl_hd = "nam")plot_tab(f_lbl = "namnum", f_lbl_sep = ":\n",
f_lbl_sum = "namnum", f_lbl_hd = "nam", p_lbl = "namnum")
## Misc. options:
plot_tab(area = "sq")        # area: squareplot_tab(title_lbl = "")     # no titlesplot_tab(mar_notes = FALSE)  # no margin notes
plot_tab(by = "cddc", gaps = c(.08, .00), area = "sq")    # gapsplot_tab(by = "cddc", gaps = c(.02, .08), p_split = "h")  # gaps
# Showing prob as lines:
plot_tab(prev = 1/4, sens = 6/7, spec = 3/5, N = 100,
by = "cddc", p_split = "v", col_pal = pal_rgb,
p_lbl = "def", brd_dis = .25, arr_c = -3)plot_tab(prev = 1/3, sens = 6/7, spec = 3/4, N = 100, scale = "f",
by = "cddc", p_split = "h", col_pal = pal_mod,
p_lbl = "namnum", brd_dis = .15, arr_c = +3)
## Custom text labels and colors:
plot_tab(prev = .5, sens = 4/5, spec = 3/5, N = 10,
by = "cddc", p_split = "v", area = "sq",
lbl_txt = txt_org,  # custom text
f_lbl = "namnum", f_lbl_sep = ":\n", f_lbl_sum = "num", f_lbl_hd  = "nam",
col_pal = pal_mod, f_lwd = 3)  # custom colorsplot_tab(prev = .5, sens = 3/5, spec = 4/5, N = 10,
by = "cddc", p_split = "h", area = "sq",
lbl_txt = txt_org,  # custom text
f_lbl = "namnum", f_lbl_sep = ":\n", f_lbl_sum = "num", f_lbl_hd  = "nam",
col_pal = pal_kn, f_lwd = 1)  # custom colors
## Note some differences to plot_area (i.e., area/mosaic plot):
#
# In plot_tab:
#
# (1) p_split does not matter (except for selecting different prob links):
plot_tab(by = "cddc", p_split = "v")  # v01 (see v07)plot_tab(by = "cddc", p_split = "h")  # v03 (see v05)
#
# (2) scale does not matter for dimensions (which are constant),
#     BUT matters for values shown in prob links and on margins:
plot_tab(N = 5, prev = .3, sens = .9, spec = .5,
by = "cddc", scale = "p", p_lbl = "def", round = TRUE)  # (a) exact prob valuesplot_tab(N = 5, prev = .3, sens = .9, spec = .5,
by = "cddc", scale = "f", p_lbl = "def", round = TRUE)  # (b) prob from rounded freq!plot_tab(N = 5, prev = .3, sens = .9, spec = .5,
by = "cddc", scale = "f", p_lbl = "def", round = FALSE) # (c) same values as (a)