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

View source: R/tab_n.R

tab_nR Documentation

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.


tzoltak/daneIBE documentation built on Sept. 5, 2022, 7:32 a.m.