pobierz_wyniki_wyskalowane: Pobieranie surowych wynikow egzaminu

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

Pobieranie surowych wynikow egzaminu

Description

Funkcja pobiera wyskalowane wyniki egzaminu (ze wszystkich lat i wszystkich skal, powiązanych z danym egzaminem, które są w bazie) i zapisuje je na dysku w postaci plików RData.

• Funkcja sprawdzi, czy w aktywnym katalogu istnieje katalog dane wyskalowane. Jeśli tak, zapisze tam pliki, jeśli nie, najpierw go utworzy, a potem zapisze tam pliki.

• Dane dotyczące wyników z poszczególnych lat zapisane zostaną w oddzielnych plikach, o nazwach postaci nazwa egzaminu rok.RData.

• W każdym takim pliku znajduje się data frame klasy wynikiWyskalowane, o nazwie postaci prefiksWyskalowane (gdzie prefiks opisuje rodzaj egzaminu: s - sprawdzian, g - egz. gimn., m - matura). Przechowuje on wyskalowane wyniki w postaci długiej, analogicznie jak wynik wywołania funkcji pobierz_oszacowania_uczniow.

• Wśród atrybutów takiego obiektu znajduje się element skale, który zawiera trochę dodatkowych informacji o skalach.

• Jeśli dla danego egzaminu nie znaleziono żadnych wyników wyskalowanych, to obiekt ten będzie nie data framem, ale NULLem!

Dodatkowo, o ile parametr daneKontekstowe ma wartość TRUE, w tym samym katalogu zapisany zostanie plik nazwa egzaminu - kontekstowe.RData, zawierający ramkę danych o nazwie prefiksKontekstowe (gdzie prefiks opisuje rodzaj egzaminu: s - sprawdzian, g - egz. gimn., m - matura), będącą wynikiem wywołania funkcji pobierz_dane_kontekstowe.

Usage

pobierz_wyniki_wyskalowane(
  rodzajEgzaminu,
  lata = NULL,
  nadpisz = FALSE,
  daneKontekstowe = TRUE,
  src = NULL,
  katalogWyskalowane = NULL
)

Arguments

rodzajEgzaminu	ciąg znaków - rodzaj egzaminu
lata	NULL lub wektor liczb - lata, dla których mają zostać pobrane wyniki; jeśli NULL pobrane zostaną wyniki z wszystkich dostępnych lat
nadpisz	wartość logiczna - jeśli w miejscu, w którym mają być zapisane wyniki są już pliki z wynikami, to czy je nadpisać? jeśli FALSE, pobrane zostaną wyniki tylko z lat, dla których pliki jeszcze nie istnieją
daneKontekstowe	wartość logiczna - czy pobrać również plik z danymi kontekstowymi (tj. o uczniach i szkołach)?
src	NULL połączenie z bazą danych IBE zwracane przez funkcję polacz; pozwala posłużyć się niestandardowymi parametrami połączenia
katalogWyskalowane	opcjonalnie ciąg znaków - ścieżka do katalogu, w którym znajdują się pliki .RData z wynikami skalowania, zapisane przez funkcje skaluj_spr, skaluj_egz_gimn lub skaluj_matura. Jeśli podany, wyniki wyskalowane zostaną wczytane z tych plików, a nie z bazy.

Value

lista z nazwami zapisanych plików (niewidocznie)

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