pobierz_wyniki_surowe: Pobieranie surowych wynikow egzaminu

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

Pobieranie surowych wynikow egzaminu

Description

Funkcja pobiera surowe wyniki egzaminu i zapisuje je na dysku w postaci plików RData.

• Funkcja sprawdzi, czy w aktywnym katalogu istnieje katalog dane surowe. 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.

• Każdy plik w formacie RData będzie zawierał ramki danych z wynikami poszczególnych części egzaminu.

  • Nazwy ramek danych odpowiadają prefiksom tych części egzaminu w bazie, w tablicsl_czesci_egzaminow.

  • Ich wewnętrzna struktura jest taka sama, jak struktura wartości zwracanej przez funkcję pobierz_czesc_egzaminu() z pakietu ZPD.

  • Mają przypisane klasy (oprócz data.frame): czescEgzaminu i wynikiSurowe.

  • Mają przypisany atrybut dataPobrania, zawierający datę w formie ciągu znaków postaci rrrr-mm-dd.

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_surowe(
  rodzajEgzaminu = c("sprawdzian", "egzamin gimnazjalny", "matura",
    "egzamin ósmoklasisty"),
  lata = NULL,
  nadpisz = FALSE,
  daneKontekstowe = TRUE,
  src = 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ę połączeniem o wyższych niż domyślne prawach dostępu, co ma znaczenie dla zakresu pobieranych danych kontekstowych

Value

lista z nazwami zapisanych plików (niewidocznie)

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