przypisz_punktacje: Punktowanie odpowiedzi udzielonych w zadaniach zamknietych

In tzoltak/KTT: Classical Test Theory tools

Description

Funkcja służy do przypisania punktacji uzyskanej za zadania zamknięte na podstawie podanego klucza odpowiedzi.

Usage

przypisz_punktacje(x, opisTestu, verbose = TRUE)

Arguments

x	macierz typu numeric lub ramka danych (data frame) zawierająca zmienne typu numeric
opisTestu	ramka danych zawierająca opis struktury testu
verbose	wartość logiczna - czy wydrukować wyniki analizy

Details

Reguły punktowania

Dla danego zadania zamkniętego (p. sekcja Opis struktury testu) odpowiedziom równym wartości podanej w opisie struktury testu odpowiedzi poprawnej przypisana zostanie wartość 1. Wszystkim pozostałym odpowiedziom, w tym brakom danych, przypisana zostanie wartość 0.

Opis struktury testu Opis struktury testu podawany jest funkcji w postaci ramki danych, która musi zawierać następujące kolumny

• zmienna: nazwy zmiennych w zbiorze danych;

• typ: typ zadania (zmiennej w zbiorze):

  • brak danych lub pusty ciąg znaków - zmienna, która nie opisuje odpowiedzi na zadanie testowe (np. identyfikator zdającego, zmienne opisujące jego cechy, które znajdują się w tym samym zbiorze co odpowiedzi na zadania itp.);

  • 'o' - zadanie otwarte, rozumiane tutaj jako takie zadanie, które nie musi zostać zapunktowane na podstawie klucza (w szczególności zadania zamknięte, które zostały zapunktowane już wcześniej, należy opisać właśnie w ten sposób);

  • 'z' - zadanie zamknięte, rozumiane tutaj jako takie zadanie, które dopiero musi zostać zapunktowane na podstawie klucza;

• odpowiedzi - zestaw możliwych odpowiedzi (tj. wartości, które może przyjąć zmienna zawierająca odpowiedzi na dane zadanie); może zostać opisany w następujący sposób:

  • brak danych lub pusty ciąg znaków - należy przypisać, jeśli dla danej zmiennej ma nie być sprawdzana poprawność wartości w zbiorze (np. nie ma to sensu, bo jest to zmienna ciągła, albo nie jesteśmy w stania - lub nie chce nam się wypisywać - zestawu wszystkich możliwych do przyjęcia wartości);

  • ciąg znaków zawierający poszczególne wartości, oddzielone od siebie przecinkami, np. '0,1', lub 'tak,nie';

  • ciąg znaków postaci 'liczba1-liczba2', co oznacza, że zmienna może przyjmować jako wartości wszystkie liczby całkowite z przedziału [liczba1; liczba2];

  • pojedyncza liczba (podana albo jako liczba, albo w formie ciągu znaków), co jest skróconą (równoważną) formą zapisu: '0-liczba';

  W przypadku zadań typu 'o' jako dopouszczalne wartości akceptowane są tylko liczby (z tym że mogą to być liczby niecałkowite).

• poprawna_odpowiedz - ciąg znaków (lub ew. liczba), który koduje poprawną odpowiedź na zadanie.

Dodatkowo opis struktury testu może (ale nie musi) zawierać kolumny:

• etykieta - ciąg znaków z etykietą (tytułem/krótkim opisem) zadania;

• uwagi - ciąg znaków zawierający ew. uwagi (lub np. opis treści zadania).

Value

Funkcja zwraca ramkę danych (data frame) z wynikami rozwiązania zadań (zadania 'o' w takiej formie, w jakiej były w wejściowych danych, zadania 'z' zapunktowane).

Zwracana ramka danych nie zawiera żadnych innych kolumn, niż te z punktacją za zadania, ale zawiera te same wiersze, ułożone w tej samej kolejności, co ramka danych z danymi wejściowymi przekazana do funkcji argumentem x. Dane z obu ramek można więc łatwo łączyć, używając funkcji cbind.

See Also

raport

Examples

summary(daneWzrost)
wynikiWzrost = przypisz_punktacje(daneWzrost, opisTestuWzrost)
summary(wynikiWzrost)

tzoltak/KTT documentation built on May 3, 2019, 2:06 p.m.