agreguj_wskazniki_ewd: Agregowanie wskaznikow EWD

In tzoltak/EWDdane: Functions for Educational Value-Added data import/export

Agregowanie wskaznikow EWD

Description

Funkcja agreguje wskaźniki EWD.

Usage

agreguj_wskazniki_ewd(
  dane,
  poziom = NULL,
  grupujPoLatach = TRUE,
  zmiennaGrupujaca = "teryt_szkoly",
  tylkoWyswietlane = NA,
  pu = FALSE,
  gammaDane = 0.95,
  gamma = 0.95
)

Arguments

dane	ramka danych zwracana przez funkcję pobierz_wartosci_wskaznikow_ewd.
poziom	ciąg znaków definiujący poziom agregacji: "gmina", "powiat" lub "województwo", albo NULL, jeśli podany został parametr zmiennaGrupujaca
grupujPoLatach	wartość logiczna (TRUE lub FALSE) wskazująca, czy przy wyróżnianiu grup oprócz TERYTu ma być uwzględniona również zmienna opisująca okres, dla którego obliczony został wskaźnik
zmiennaGrupujaca	ciąg znaków - nazwa zmiennej grupującej
tylkoWyswietlane	wartość logiczna (TRUE/FALSE/NA) opisująca, czy przy obliczaniu agregatów mają zostać uwzględnione tylko te szkoły, których elipsy są pokazywane na stronie - p. sekcja Details
pu	wartość logiczna (TRUE lub FALSE) wskazująca, czy funkcja ma zwrócić oszacowania granic przedziałów ufności dla obliczonych średnich?
gammaDane	poziom ufności dla jakiego zostały obliczone granice przedziałów ufności podane w kolumnach argumentu dane - liczba z przedziału (0;1) (ma zastosowanie tylko gdy pu=TRUE)
gamma	poziom ufności - liczba z przedziału (0;1) (ma zastosowanie tylko gdy pu=TRUE)

Details

Zachowanie funkcji w zależności od wartości parametru tylkoWyswietlane:

• Jeśli tylkoWyswietlane=TRUE przy obliczaniu agregatów uwzględniane zostaną tylko te szkoły, których elipsy są wyświetlane na stronie.

• Jeśli tylkoWyswietlane=FALSE przy obliczaniu agregatów uwzględniane zostaną wszystkie szkoły

• Domyślnie, tj. gdy tylkoWyswietlane=NA, przy obliczaniu agregatów uwzględniane zostaną wszystkie szkoły, (jak wtedy, gdy tylkoWyswietlane=TRUE) z tym, że jeśli w jakiejś grupie nie ma żadnej szkoły, której elipsa byłaby prezentowana, to wartość wskaźnika zostanie w niej zmieniona na brak danych.

Oznacza to, że dla poprawnego działania domyślnego wywołania funkcji agreguj_wskazniki_ewd potrzebne jest pobranie wcześniej danych o wartościach wskaźników wywołaniem funkcji pobierz_wartosci_wskaznikow_ewd z inną niż domyślna wartością parametru tylkoWyswietlane - p. przykład użycia.

Uwaga, jeśli chce się uzyskać przedziały ufności dla obliczanych agregatów, a funkcja pobierz_wartosci_wskaznikow_ewd była wywoływana z inną niż domyślna wartością parametru gamma, wartość tą należy przy wywołaniu agreguj_wskazniki_ewd podać jako argument gammaDane.

Value

data frame

Examples

## Not run: 
# agregacja wartości wskaźników dla techników z lat 2013-2014 do poziomu powiatu
agr = pobierz_wartosci_wskaznikow_ewd("T", 2013:2014, tylkoWyswietlane = FALSE) %>%
  agreguj_wskazniki_ewd("powiat")

# j.w. ale agregacja po miejscowości podanej jako siedziba poczty
# ze zwróceniem granic przedziałów ufności dla agregatów
agr = pobierz_wartosci_wskaznikow_ewd("T", 2013:2014, tylkoWyswietlane = FALSE) %>%
  agreguj_wskazniki_ewd(zmiennaGrupujaca = "poczta", pu = TRUE)

# przedziały ufności dla agregatów, jeśli pobierz_wartosci_wskaznikow_ewd()
# była wywołana z inną niż domyślna wartością parametru 'gamma'
# wywołując agreguj_wskazniki_ewd() trzeba użyć argumentu 'gammaDane'
gamma = 0.9
dane = pobierz_wartosci_wskaznikow_ewd("T", 2013:2014, tylkoWyswietlane = FALSE, gamma = gamma)
agr = agreguj_wskazniki_ewd(dane, zmiennaGrupujaca = "poczta", pu = TRUE, gammaDane = gamma)

## End(Not run)

tzoltak/EWDdane documentation built on Oct. 2, 2024, 11:48 a.m.