normy_ekwikwantylowe: Normalizacja ekwikwantylowa.

In zozlak/ZPD: Tools for a Polish examination data and item bank database

Normalizacja ekwikwantylowa.

Description

Funkcja wylicza normalizację ekwikwantylową zadanej zmiennej.

Usage

normy_ekwikwantylowe(
  x,
  max = NULL,
  prog = 1e-06,
  srednia = 100,
  os = 15,
  uzupLuki = TRUE,
  ekstrapolacja = FALSE,
  zaokraglij = FALSE,
  nmin = NA_real_,
  nmax = NA_real_
)

Arguments

x	wektor nieujemnych liczb całkowitych, na podstawie którego ma zostać wyliczona normalizacja
max	liczba, opcjonalnie maksymalna wartość skali, na jakiej wyrażony jest x
prog	liczba, opcjonalnie, wszystkim wartościom, których skumulowana częstość występowania jest mniejsza niż prog lub większa niż 1-prog zostaną przypisane wartości znormalizowane odpowiadające skumulowanej częstości odpowiednio prog i 1-prog
srednia	liczba - średnia znormalizowanej skali
os	liczba - odchylenie standardowe znormalizowanej skali
uzupLuki	wartość logiczna - czy jeśli pomiędzy wartościami występującymi w wektorze x (oraz 0 i ew. wartością parametru max, jeśli został podany) istnieją liczby całkowite, które nie wystąpiły w x, to wartości znormalizowane mają być wyliczone również dla nich?
ekstrapolacja	wartość logiczna - czy w przypadku, gdy wartości znormalizowane mają być przypisane wartościom niższym, niż najmniejsza występująca w wektorze x oraz większym, niż największa występujacaw wektorze x, to mają być one wyliczone poprzez ekstrapolację liniową?
zaokraglij	czy wartości wystandaryzowane mają zostać zaokrąglone do liczb całkowitych?
nmin	minimalna wartość wystandaryzowana
nmax	maksymalna wartość wystandaryzowana

Details

Normalizacja wyliczana jest poprzez przekształcenie postaci: u(X=i) = srednia + os * F( [N(X<i) + N(X=i)/2 ] / n ), gdzie n to liczba obserwacji (liczba elementów wektora x nie będących brakami danych), a F to funkcja odrotna do dystrybuanty rozkładu normalnego stanaryzowanego.

Jeśli parametr uzupLuki ma wartość FALSE, to wartości, które nie wystąpiły w wektorze x nie zostaną uwzględnione w wynikach. Jeśli ma wartość TRUE, to wartości znormalizowane zostaną im przypisane na podstawie interpolacji/ekstrapolacji liniowej w oparciu o dwie najbliższe wartości (większą i mniejszą), które wystąpiły w wektorze x. Wartościom mniejszym niż najmniejsze i większym niż największe wartości, które wystąpiły w wektorze x przypisane zostaną wartości znormalizowane odpowiadające najmniejszej/największej wartości, która wystąpiła w danych (jeśli parametr ekstrapolacja przyjmuje wartość FALSE). Jeśli parametr ekstrapolacja przyjmuje wartość TRUE, wartościom tym zostaną przypisane wartości znormalizowane na podstawie ekstrapolacji liniowej w oparciu o dwie najmniejsz/największe wartości, które wystąpiły w wektorze x.

Za pomocą parametrów zaokraglij, nmin oraz nmax możliwe jest uzyskanie norm dla skal dyskretnych, w szczególności dla wartości zaokraglij = TRUE, nmin = 1, nmax = 9 norm dla skali staninowej.

Value

Wektor liczbowy wartości znormalizowanych, z przypisanymi nazwami opisującymi wartości wejściowej zmiennej.

zozlak/ZPD documentation built on Nov. 7, 2023, 3:54 p.m.