filtruj_przystapienia: Zwraca pierwsze lub ostatnie przystąpienia do danego egzaminu...
In zozlak/ZPD: Tools for a Polish examination data and item bank database

filtruj_przystapienia

R Documentation

Zwraca pierwsze lub ostatnie przystąpienia do danego egzaminu w zadanych latach

Description

Najczęściej podczas analiz interesuje nas jedynie pierwsze podejście ucznia do danego egzaminu. Czasem ważne jest także podejście ostatnie (np. do egzaminu na końcu poprzedniego etapu edukacji).

Funkcja filtruj_przystapienia() zwraca dla zadanego egzaminu i zakresu lat tabelę z kolumnami "id_obserwacji" i "id_testu" umożliwiającą odfiltrowanie jedynie pierwszych/ostatnich przystąpień uczniów do tego egzaminu.

Następuje to poprzez przeanalizowanie wszystkich danych z grupy "uczniowieTesty" dostępnych w bazie dla danego egzaminu, jednak ostateczny wynik ograniczany jest do lat wskazanych w parametrach "rokOd" i "rokDo". Uwzględnienie wszystkich danych znajdujących się w bazie jest konieczne, aby poprawnie dokonać filtrowania (uniknąć "efektów brzegowych" w ostatnich latach, dla których chcemy pobrać informacje).

Jeśli podano tylko rodzaj egzaminu, odfiltrowanie nastąpi na poziomie rodzajów egzaminów (a więc aby uczeń został w danym roku zaliczony jako podchodzący do egzaminu wystarczy, że w bazie będą wyniki dla choćby jednej, dowolnej części tego egzaminu). Jeśli podano także część(części) egzaminu, wtedy odfiltrowanie nastąpi tylko w ramach danej części egzaminu (jeśli uczeń w danym roku uczeń brał udział jedynie w innych częściach egzaminu, ale nie we wskazanej, nie będzie mu to policzone jako podejście do egzaminu).

Bez względu na to, czy określono część egzaminu podczas odfiltrowywania pierwszych przystąpień brane są pod uwagę wartości kolumny "pop_podejście" - uczniowie z niepustymi jej wartościami są pomijani.

Istotne znaczenie ma argument "czyEwd". Służy on do wybrania, na podstawie których danych (EWD/CKE) ma zostać dokonana filtracja.

Jego wartość powinna być zgodna z wynikami egzaminacyjnymi i/lub oszacowaniami umiejętności uczniów, które chcemy odfiltrować za pomocą wyników działania funkcji filtruj_przystapienia().
Należy sobie zdawać sprawę, że dane CKE przed 2010 rokiem są niełączliwe między latami, a więc nie zostaną dla nich odfiltrowani żadni uczniowie (funkcja ostrzega w takich wypadkach).
Jego podanie jest obowiązkowe, gdyż odfiltrowywanie przystąpień do egzaminu z pominięciem wyboru źródła danych nie ma sensownej interpretacji praktycznej.

Patrz też - http://zpd.ibe.edu.pl/doku.php?id=czyewd

Zakres filtrowanych danych można ograniczyć przekazując w parametrze "obserwacje" id_obserwacji, do których ma zostać zawężona analiza. Parametr ten może być albo wektorem id_obserwacji albo ramką danych z kolumną "id_obserwacji".

Usage

filtruj_przystapienia(
  src,
  pierwsze,
  rodzajEgzaminu,
  czescEgzaminu = NULL,
  czyEwd,
  obserwacje = NULL
)

Arguments

`src`	uchwyt źródła danych dplyr-a
`pierwsze`	czy odfiltrować pierwsze podejście (jeśli FALSE, odfiltrowane zostanie ostatnie)
`rodzajEgzaminu`	rodzaj egzaminu - patrz http://zpd.ibe.edu.pl/doku.php?id=czesci_egzaminu
`czescEgzaminu`	wektor części egzaminu - patrz http://zpd.ibe.edu.pl/doku.php?id=czesci_egzaminu
`czyEwd`	czy korzystać z danych EWD czy CKE (patrz opis)
`obserwacje`	wektor id_obserwacji lub ramka danych z kolumną id_obserwacji