Masquer les cellules d'un tableau

tab_mask() permet de masquer les cellules d'un tableau :

  • les cellules non-nulles inférieures à un seuil, en nombre de lignes ou en somme de la variable var_stat

  • les cellules correspondant aux marges

tab_mask(
  tab,
  threshold_count = NULL,
  threshold_sum = NULL,
  mask_total = "",
  verbose = TRUE
)

Arguments

tab

tableau croisé issu de tab_build

threshold_count

nombre de lignes de la table initiale en-deça duquel la valeur est masquée (exclusif) - par défaut : NULL

threshold_sum

à renseigner pour stat = sum, valeur de la cellule en-deça de laquelle la valeur est masquée (exclusif) - par défaut : NULL

mask_total

masquage ou non des totaux - par défaut : aucun Ce paramètre peut prendre les valeurs suivantes :

  • "cols" : masquage des totaux en colonnes

  • "rows" : masquage des totaux en lignes

  • c("rows", "cols") : masquage de l'ensemble des totaux

verbose

affichage ou non du nombre de cellues masquées par la fonction - par défaut : TRUE

Value

tableau avec cellules blanchies

Examples

library(dplyr)

prenoms |>
  filter(annais == "2020" &
       prenom %in% c("Charlie", "Camille") &
                lib_reg %in% c("Occitanie", "Pays de la Loire")) |>
  tab_build(var_rows = lib_reg,
            var_cols = c(prenom, sexe),
            var_stat = nombre,
            lab_total = "Total",
            stat = "sum") |>
  tab_mask(threshold_count = 5,
           threshold_sum = 100,
           mask_total = c("rows", "cols"),
           verbose = TRUE)
#> 0 cellules ne sont pas masquées mais concernent zéro ligne.
#> 1 cellules sont masquées car concernent trop peu de lignes.
#> 3 cellules de plus sont masquées car valeur de la somme trop petite.
#> # A tibble: 2 × 5
#>   lib_reg          Camille_G Camille_F Charlie_G Charlie_F
#>   <chr>                <dbl>     <dbl>     <dbl>     <dbl>
#> 1 Occitanie               NA       113        NA       139
#> 2 Pays de la Loire        NA       127        NA       106