tab_n: Tabela rozkladow brzegowych wielu zmiennych (etykietowanych)...

In tzoltak/daneIBE: Funkcje wspomagajace przetwarzanie danych sondazowych

Tabela rozkladow brzegowych wielu zmiennych (etykietowanych) o tym samym zbiorze mozliwych wartosci

Description

Funkcja generuje tabelę zestawiającą ze sobą rozkłady brzegowe liczebności i rozkład brzegowe częstości kilku zmiennych, które mogą przyjmować ten sam zbiór wartości (a przynajmniej tak zakładamy). Jako pierwszy argument przyjmuje obiekt data.frame lub tbl_svy (obiekt będący połączeniem ramki danych z informacjami o - zwykle złożonym - schemacie doboru próby, tworzonym przez funkcje pakietu srvyr). Radzi też sobie ze zmiennymi etykietowanymi (konwertując je na czynniki).

Metoda as_tibble pozwala przekształcić zwracane zestawienie w ramkę danych w postaci długiej, przydatną np. do rysowania wykresów przy pomocy ggplot2 (czyli działa analogicznie,jak metoda as.data.frame dla obiektów zwracanych przez funkcję table z pakietu base). Metoda as.data.frame również jest dostępna, ale domyślnie nie przekształca tabeli (usuwa jedynie klasę tab_n), gdyż inaczej przygotowanych tabel z rozkładami nie dawałoby się bezproblemowo używać w połączeniu z funkcją kable z pakietu kable (która to funkcja wywołuje metodę as.data.frame na przekazywanym jej obiekcie).

Usage

tab_n(
  x,
  ...,
  kierunek,
  liczby,
  procenty,
  etykietaSuma,
  etykietyZmiennych,
  etykietaBD
)

## S3 method for class 'data.frame'
tab_n(
  x,
  ...,
  kierunek = c("kolumny", "wiersze"),
  liczby = TRUE,
  procenty = TRUE,
  etykietaSuma = "SUMA",
  etykietyZmiennych = FALSE,
  etykietaBD = NA,
  w = NULL
)

## S3 method for class 'table'
tab_n(
  x,
  ...,
  kierunek = c("kolumny", "wiersze"),
  liczby = TRUE,
  procenty = TRUE,
  etykietaSuma = "SUMA",
  etykietyZmiennych = FALSE,
  etykietaBD = NA
)

## S3 method for class 'ftable'
tab_n(
  x,
  ...,
  kierunek = c("kolumny", "wiersze"),
  liczby = TRUE,
  procenty = TRUE,
  etykietaSuma = "SUMA",
  etykietyZmiennych = FALSE,
  etykietaBD = NA
)

## S3 method for class 'tbl_svy'
tab_n(
  x,
  ...,
  kierunek = c("kolumny", "wiersze"),
  liczby = TRUE,
  procenty = TRUE,
  etykietaSuma = "SUMA",
  etykietyZmiennych = FALSE,
  etykietaBD = NA
)

## S3 method for class 'survey.design2'
tab_n(
  x,
  ...,
  kierunek = c("kolumny", "wiersze"),
  liczby = TRUE,
  procenty = TRUE,
  etykietaSuma = "SUMA",
  etykietyZmiennych = FALSE,
  etykietaBD = NA
)

## S3 method for class 'svyrep.design'
tab_n(
  x,
  ...,
  kierunek = c("kolumny", "wiersze"),
  liczby = TRUE,
  procenty = TRUE,
  etykietaSuma = "SUMA",
  etykietyZmiennych = FALSE,
  etykietaBD = NA
)

## S3 method for class 'twophase2'
tab_n(
  x,
  ...,
  kierunek = c("kolumny", "wiersze"),
  liczby = TRUE,
  procenty = TRUE,
  etykietaSuma = "SUMA",
  etykietyZmiennych = FALSE,
  etykietaBD = NA
)

## S3 method for class 'tab_lbl_n'
print(x, dProcenty = 1, dLiczby = 0, decimal.mark = ",", scipen = 100, ...)

## S3 method for class 'tab_lbl_n'
as_tibble(
  x,
  ...,
  .rows = NULL,
  .name_repair = c("check_unique", "unique", "universal", "minimal"),
  rownames = NULL,
  usunSuma = FALSE,
  wartoscBD = NULL
)

## S3 method for class 'tab_lbl_n'
as.data.frame(
  x,
  row.names = NULL,
  optional = FALSE,
  ...,
  usunSuma = FALSE,
  wartoscBD = NULL,
  niePrzeksztalcaj = TRUE
)

Arguments

x	ramka danych lub obiekt klasy tbl_svy
...	zmienne, których rozkłady mają zostać zwrócone (można używać selektorów pakietu dplyr, np. starts_with)
kierunek	w którą stronę mają układać się w zwracanym zestawieniu rozkłady brzegowe?
liczby	wartość logiczna - czy zwracana tabela ma zawierać rozkłady liczebności?
procenty	wartość logiczna - czy zwracana tabela ma zawierać rozkłady częstości?
etykietaSuma	ciąg znaków - etykieta dla wiersza lub kolumy z sumą
etykietyZmiennych	wartość logiczna - czy do opisania zmiennych w zwracanym zestawieniu mają zostać wykorzystane ich etykiety (o ile są dostępne)? jeśli FALSE, użyte zostaną nazwy zmiennych
etykietaBD	ciąg znaków - etykieta, którą w przygotowanym zestawieniu mają być opisane braki danych (NA); domyślna wartość oznacza, że zostaną one opisane jako "NA"; podanie NULL będzie skutkować usunięciem kolumn i wierszy opisujących braki danych ze zwracanego zestawienia
w	opcjonalnie kolumna obiektu x, której wartości zawierają wagi obserwacji, które powinny zostać uwzględnione przy obliczaniu rozkładu
dProcenty	liczba miejsc dziesiętnych, do jakiej zostaną zaokrąglone wartości kolumn z rozkładami częstości
dLiczby	liczba miejsc dziesiętnych, do jakiej zostaną zaokrąglone wartości kolumn z rozkładami liczebności (to mogą być liczby niecałkowite, jeśli przy tworzeniu rozkładu stosowano ważenie)
decimal.mark	znak miejsca dziesiętnego - przekazywany do format
scipen	liczba całkowita decydująca o skłonności R do zapisywania liczb w notacji naukowej (czym większa, tym rzadziej R sosuje notację naukową - p. options)
.rows	wyłącznie dla zgodności ze wzorcem (generic) metody as_tibble
.name_repair	przekazywana jako argument names_repair do pivot_longer
rownames	wyłącznie dla zgodności ze wzorcem (generic) metody as_tibble
usunSuma	wartość logiczna - czy usunąć ze zwróconej ramki danych wiersze opisujące sumy rozkładów?
wartoscBD	wektor jednoelementowy: wartość, przy pomocy których mają być reprezentowane ew. braki danych w zróconej ramce danych
row.names	wyłącznie dla zgodności ze wzorcem (generic) metody as.data.frame
optional	wyłącznie dla zgodności ze wzorcem (generic) metody as.data.frame
niePrzeksztalcaj	wartość logiczna - czy funkcja ma tylko usunąć z obiektu klasę tab_lbl_n i zwrócić go jako zwykłą ramkę danych, bez dokonywania przekształcenia z postaci szerokiej do długiej)? (domyślnie funkcja dokonuje przekształcenia)

Value

tab_n data.frame (klasy tab_lbl_n) z rozkładami:

• w zależności od wartości argumentu, kierunek w pierwszej kolumnie będą znajować się albo wartości zmiennych (kierunek="kolumny") albo nazwy zmiennych (kierunek="wiersze") - kolumna zawsze jest czynnikiem (którego kolejność poziomów odpowiada kolejności, w jakiej wybrane zostały zmienne w wywołaniu tab_n),

• nazwy kolejnych kolumn zaczynające się od "n_" opisują rozkłady liczebności,

• nazwy kolejnych kolumn zaczynające się od "pct_" opisują rozkłady częstości,

• nazwy tych kolumn powstały przez połącznie przedrostka "n_" lub "pct_" z nazwami zmiennych kierunek="kolumny" lub z wartościami zmiennych kierunek="wiersze" oraz ew. etykietą podaną argumentem etkietaSuma.

metoda as_tibble W zależności od wartości parametru niePrzeksztalcaj:

• tibble z rozkładami przekształconymi do postaci długiej,

• obiekt klasy data.frame (i tylko tej jednej) z rozkładami w postacie szerokiej.

Examples

tab_n(przykladWO, P1_1, P1_2, P1_3)
tab_n(przykladWO, starts_with("P1_"))
tab_n(przykladWO, P1_1, P1_2, P1_3, kierunek = "w")
tab_n(przykladWO, P1_1, P1_2, P1_3, kierunek = "w",  etykietyZmiennych = TRUE)
tab_n(przykladWO, P1_1, P1_2, P1_3, procenty = FALSE)
tab_n(przykladWO, P1_1, P1_2, P1_3, etykietaSuma = "Suma")
tab_n(przykladWO, P1_1, P1_2, P1_3, etykietaBD = "brak danych")

tab_n(przykladWO, P1_1, P1_2, P1_3, w = waga)
as.data.frame(tab_n(przykladWO, P1_1, P1_2, P1_3))
# aby uzyskać obiekt nadający się do wykorzystania
# jako źródło danych do wykresu tworzonego przy pomocy pakietu ggplot2:
dplyr::as_tibble(tab_n(przykladWO, P1_1, P1_2, P1_3), usunSuma = TRUE)

tzoltak/daneIBE documentation built on June 2, 2025, 12:51 p.m.