NEWS

--------------------
Zmiany w ZPD 1.10.0 (2024-10-13)

- pobierz_wartosci_wskaznikow() zwraca także kolumny srednia_we i bs_srednia_we
- pobierz_wartosci_wskaznikow_lu() zwraca także kolumnę `kategoria_lu`
  i nie pomija rekordów z `czesc_egzaminu` będącą `NULL`
  rekordy z tabeli `liczba_zdajacych`, które nie mapują się na część egzaminu
  
--------------------
Zmiany w ZPD 1.9.0 (2024-09-23)

- pobierz_szkoly() zwraca także id_rspo

--------------------
Zmiany w ZPD 1.8.0 (2023-05-08)

- Dodanie funkcji pobierz_kowariancje_elementow_skalowan()
- Zmiana parametryzacji polacz() ułatwiająca wykorzystanie danych logowania
  z ~/.pgpass

--------------------
Zmiany w ZPD 1.7.5 (2021-05-08)

- polacz() przyjmuje dodatkowe parametry (...) które są przekazywane do 
  DBI::dbConnect()
- filtruj_przystapienia() materializuje listę testów, co znacznie zmniejsza
  obciążenie serwera
- Aktualizacja wywołań dplyr-a do akutalnej (1.0.0) składni (zastąpieinie
  wszystkich `verb_()` przez odpowiednie wywołania `verb()`)

--------------------
Zmiany w ZPD 1.7.4 (2019-09-16)

- Dostosowanie do dbplyr v1.4, który ewaluuje teraz w kontekście bazy danych
  wyrażenia postaci `zmienna$kolumna` i jeśli takie wyrażenie powinno być
  ewaluowane lokalnie i tylko jego wynik przekazany do bazy danych, trzeba
  to explicite wskazać.

--------------------
Zmiany w ZPD 1.7.3 (2018-01-29)

- Dostosowanie do dbplyr v1.4, który (co w sumie rozsądne) wymusza teraz
  przekazanie połączenia bazy danych jako parametru funkcji `escape()`
  (https://github.com/zozlak/ZPD/issues/15)

--------------------
Zmiany w ZPD 1.7.2 (2018-01-29)

- Usunięcie ostrzeżeń generowanych przez RPostgres
  (https://github.com/zozlak/ZPD/issues/11)
- Usunięcie błędnego mapowania kolumn w pobierz_uczniow(daneOsobowe = T)
  (https://github.com/zozlak/ZPD/issues/10)

--------------------
Zmiany w ZPD 1.7.1 (2018-01-10)

- Korekta kodowania znaków odczytywanych z bazy (RPostgres obsługuje to nieco
  inaczej niż obsługiwał RPostgreSQL)

--------------------
Zmiany w ZPD 1.7.0 (2018-01-10)

- Zmiana backendu bazodanowego na RPostgres (który pojawił sie wreszcie w
  CRAN-ie). RPostgreSQL posiada wiele narowów i od kilku lat nie jest 
  aktualizowany.
- Parametr `doPrezentacji` funkcji `pobierz_wskazniki()` jest teraz stosowany
  zarówno do tablicy `wskazniki`, jak i `sl_wskazniki` (dotychczas filtr tablicy
  `sl_wskazniki` był na sztywno ustawiony na `TRUE`, co uniemożliwiało pobranie
  wskaźników oznaczonych w niej jako nie do prezentacji).
- Zmienna "wsk_do_prezentacji" w grupie danych "wskazniki" odpowiada teraz
  kolumnie "wskazniki.do_prezentacji", a kolumna "sl_wskazniki.do_prezentacji"
  reprezentowana jest przez zmienną "wsk_do_prezentacji_sl".

--------------------
Zmiany w ZPD 1.6.0 (2017-11-11)

- Wprowadzenie możliwości wyboru pakietu używanego jako backend do komunikacji
  z bazą danych:
  - RPostgreSQL (domyślny) - dotychczasowy używany pakiet.
    Posiada wiele narowów, np. segfaultuje jeśli baza danych wygeneruje 
    jakikolwiek komunikat (choćby o braku praw dostępu do tablicy czy "notice" 
    o tym, że usuwany obiekt nie istniał przy wykonywaniu zapytania "DROP VIEW 
    IF EXISTS moj_widok") oraz ma tendencje do wyciekania pamięci, nie jest już
    też rozwijany ani poprawiany.
    Jednocześnie cały czas jest jedynym zgodnym z DBI (a więc i z dplyr-em)
    pakietem do komunikacji z Postgresql-em, który jest dostępny w CRAN-ie.
  - RPostgres - nowa implementacja komunikacji z Postgresql-em zgodna z DBI.
    Obiecująca, niestety póki co dostępna tylko na github-ie.

--------------------
Zmiany w ZPD 1.5.8 (2017-11-10)

- Korekta w zapytaniu SQL funkcji pobierz_odpowiedzi() zapewniająca efektywne
  filtowanie po id_testu

--------------------
Zmiany w ZPD 1.5.7 (2017-11-09)

- Funkcja polacz() ustawia minimalny poziom raportowania komunikatów przez bazę
  danych na WARNINGS, co pozwala uniknąć wyświetlania użytkownikowi 
  konfudujących informacji w rodzaju "widok X nie istnieje" przy korzystaniu
  z funkcji pobierz_wyniki_*

--------------------
Zmiany w ZPD 1.5.6 (2017-08-07)

- Doprowadzenie do zgodności z aktualną wersją dplyr-a

--------------------
Zmiany w ZPD 1.5.5 (2017-02-01)

- Zmiana domyślnych parametrów połączenia z bazą danych
  (tak by domyślne ustawienia działały po zamieszaniu z rekonfiguracją 
  domen ewd)

--------------------
Zmiany w ZPD 1.5.4 (2016-11-16)

- Uzgodnienie z bardziej restrykcyjnymi testami R 3.3

--------------------
Zmiany w ZPD 1.5.3 (2016-11-09)

- Doprowadzenie do zgodności z aktualną wersją dplyr-a i testthat

--------------------
Zmiany w ZPD 1.5.2 (2016-09-16)

- Korekta błędu w funkcji normalizuj() generującego komunikat ostrzeżenia
  "Unknown column 'grupa'"

--------------------
Zmiany w ZPD 1.5.1 (2015-10-30)

- Zmiany w grupie danych "kryteriaOceny":
  - Rozszerzenie funkcji pobierz_kryteria_oceny() o możliwość pobranie 
    informacji o kryteriach składowych pseudokryteriów oceny (zmienna 
    "kryterium_skladowe").
    O tym, czy informacje zostaną pobrane, decyduje nowy parametr 
    "krytSkladowe"
- Dodanie prośby o cytowanie przy ładowaniu pakietu oraz loga KL+IBE+EFS do
  pliku README
- Korekta dokumentacji funkcji pobierz_skale()

--------------------
Zmiany w ZPD 1.5.0 (2015-09-20)

- Zmiany w grupie danych "wyniki":
  - zamiana kolejności parametrów funkcji odkoduj_dystraktory(), tak by "dane"
    były pierwszym parametrem (co umożliwia stosowanie operatora %>%)
  - korekta w funkcji odkoduj_dystraktory() - dotychczas wymagała, aby 
    wszystkie zmienne w zbiorze pochodziły z zadań zamkniętych, obecnie pomija
    zadania otwarte wyświetlając stosowny komunikat
  - zmiana nazwy funkcji normalizuj_ekwikwantylowo() na normalizuj() w związku
    z faktem, że może ona stosować także normy niebędące normami 
    ekwikwantylowymi
  - dodanie doatkowych sprawdzeń do funkcji normalizuj():
    - jeśli norma w bazie danych zawiera więcej niż jedną grupę, funkcja 
      upewnia się, że zbiór danych zawiera zmienna "grupa"
    - funkcja sprawdza, czy w zbiorze istnieje kolumna pasująca do wzorca 
      przekazanego w parametrze "kolWynik"
  - zmiana konstrukcji zapytania generowanego przez funkcję 
    pobierz_odpowiedzi() - w tej chwili zapytania odnoszące się do cech testów
    (id_testu, rok) powinny wykonywać się znacznie szybciej
- Zmiany w grupie danych "skale":
  - usunięcie parametru "PvEap" funkcji pobiersz_skale()
    obecnie informacje o posiadaniu oszacowań PV i/lub EAP dla skalowania są
    pobierane zawsze i nie wydłuża to czasu pobierania danych (co stało się
    możliwe dzieki zmianom w strukturze bazy danych)
  - dodanie parametrów "skalowania" oraz "grupy" do funkcji pobierz_skale()
    umożliwiających pominięcie informacji o skalowaniach i/lub grupach w ramach
    skalowań
- Zmiany w grupie danych "wskazniki":
  - dostosowanie funkcji pobierz_wskazniki() do zmian w strukturze bazy danych

--------------------
Zmiany w ZPD 1.4.2 (2015-09-06)

- Zmiany w grupie danych "parametry":
  - dodanie zmiennej "parametr_uwagi" odpowiadającą zmiennej "uwagi"
    w tablicy "skalowania_elementy" w bazie
- Korekty błędów:
  - od 2015-03-16 oblicz_wariancje_populacji() zwracała ramkę danych zamiast
    jednoelementowego wektora liczbowego - obecnie znów zwraca jednoelementowy
    wektor liczbowy

--------------------
Zmiany w ZPD 1.4.1 (2015-08-10)

- Zmiany w grupie danych "skale":
  - dodanie funkcji "pobierz_normy()"

--------------------
Zmiany w ZPD 1.4.0 (2015-08-06)

- Zmiany w grupie danych "skale":
  - dostosowanie do zmian w bazie danych umożliwiających określanie grup dla
    skalowań wielogrupowych oraz przenoszących definicję norm na poziom
    {id_skali, skalowanie, grupa} (dotąd tylko {id_skali})
    - dodanie zmiennej "grupa"
    - zmodyfikowanie funkcji normalizuj_ekwikwantylowo() poprzez:
      - dodanie parametrów "skalowanie" i "grupa"
      - rozszerzenie komunikatu błędu informującego o braku wskazanej normy
        w bazie o przykładowe polecenie listujące wszystkie dostępne w bazie 
        normy
  - zmiana nazwy zmiennej "normy_ekwikwantylowe" na "posiada_normy" w związku
    z faktem, że przechoywane obecnie w bazie normy mogą być nie tylko normami
    ekwikwantylowymi (np. normy pochodzące ze zrównywania nie są ekwikwantylowe)
  - zmiana wartości zmiennych "posiada_eap" i "posiada_pv" - przyjmują one teraz
    wartości TRUE lub FALSE (dotychczas TRUE lub NA)

--------------------
Zmiany w ZPD 1.3.1 (2015-06-21)

- Dodanie funkcji rozlacz()

--------------------
Zmiany w ZPD 1.3.0 (2015-06-03)

- Zmiany w grupie danych "kryteria_oceny":
  - rozszerzenie zakresu informacji pobieranego dla pseudokryteriów oceny
    o id_testu, w którym występują kryteria z danego pseudokryterium
  - zmiana sposobu wyliczania zmiennych numer_pytania i numer_kryterium
    dla pseudokryteriów oceny - obecnie są one obliczane w locie na podstawie
    danych pytan/kryteriów oceny wchodzących w skład danego pseudokryterium
    (wcześnie były wycinane z opisu pseudokryterium)
  - zmiana nazwy zmiennej "kolejnosc_kryt" na "kolejnosc_w_tescie"
  - dodanie zmiennych "id_skali" oraz "kolejnosc_w_skali" pozwalających 
    połączyć (pseudo)kryteria oceny ze skalami
  - dodanie do funkcji pobierz_kryteria_oceny() opcjonalnych parametrów
    "testy" i "skale" umożliwiających pominięcie pobierania danych o powiązaniu
    (pseudo)kryteriów oceny z testami i/lub skalami (co wpływa na liczbę
    zwracanych wyników - od 7 do 154 tys. oraz szybkość pobierania danych)
- Zmiany w grupie danych "parametry":
  - dodadnie zmiennej "grupa" opisującej grupę w modelu wielogrupowym
  - dodanie funkcji pomocniczej oblicz_informacje_kryterium()
- Zmiany w grupie danych "oszacowania":
  - dodadnie zmiennej "grupa" opisującej grupę w modelu wielogrupowym
- Zmiany techniczne:
  - wstawienie zapytań pobierających dane z bazy z funkcji pobierz_parametry()
    i pobierz_kryteria_oceny() do bazy (schemat widoki)
    
--------------------
Zmiany w ZPD 1.2.2 (2015-05-31)

- Zmiany w grupie danych "skale":
  - dodanie parametru "PvEap" do funkcji pobierz_skale(), który umożliwia
    pobranie skal bez sprawdzania, czy mają oszacowania PV/EAP
    dzięki czemu pobieranie skal zajmuje bez porównania mniej czasu

--------------------
Zmiany w ZPD 1.2.1 (2015-05-28)

- Zmiany w grupie danych "testy":
  - dodanie zmiennej "prefiks"

--------------------
Zmiany w ZPD 1.2.0 (2015-05-18)

- Dodanie funkcji zastosuj_skale() umożliwiającej zastosowanie skali na
  dowolnych danych

--------------------
Zmiany w ZPD 1.1.7 (2015-04-28)

- Zmiany w grupie danych "skale"
  - usunięcie zmiennej "nazwa_skali" - dostosowanie do zmiany w strukturze bazy
    danych

--------------------
Zmiany w ZPD 1.1.6 (2015-04-08)

- Zmiany w grupie danych "kryteriaOceny":
  - pobierane są również informacje o pseudokryteriach oceny
    (bez przydziału do testów, bo w ich wypadku nie ma to sensu, ale np.
    razem z maksymalną liczbą punktów)


--------------------
Zmiany w ZPD 1.1.5 (2015-03-23)

- Zmiany w funkcji normy_ekwikwantylowe():
  - zmiana nazwy parametru "sr" na "srednia", aby uniknąć konfliktu z partial
    matching-iem nazw parametrów parametru "src" funkcji 
    normalizuj_ekwikwantylowo()
  - dodanie parametrów "dyskretne", "nmin" i "nmax" umożliwiających tworzenie
    norm na skalach dyskretnych (w szczególności skali staninowej)
- Dodanie funkcji odkoduj_dystraktory(), która zamienia liczbowe kody
  dystraktorów z bazy na kody literowe, jak w arkuszach testowych

--------------------
Zmiany w ZPD 1.1.4 (2015-03-18)

- Zmiany w grupie danych "testy":
  - dla testów egzaminacyjnych kolumna "opis_testu" jest w tej chwili tożsama
    z arkuszem egzaminacyjnym
- Zmiany techniczne:
  - korekta w .Rbuilignore korygująca generowanie winietek
    (teraz generuje się winietka odsyłąjąca do wiki GitHub-a)

--------------------
Zmiany w ZPD 1.1.3 (2015-03-16)

- Zmiany techniczne:
  - usunięcie zależności od pakietu plyr (przepisanie wszystkich wywołań 
    plyr::ddply() na dplyr::do())
  - przeniesienie winietek do wiki GitHub-a

--------------------
Zmiany w ZPD 1.1.2 (2015-03-10)

- Zmiany w grupie danych "wartościWskaźników":
  - zastąpienie kolumny "polska" kolumną "poziom_agregacji" wskazującą na to,
    czy jest to wartość wskaźnika dla szkoły, gminy, powiatu, województwa czy
    Polski
  - dodanie do nazw kolumn "wojewodztwo", "powiat" i "gmina" sufiksu "_jst",
    aby nie myliły się z kolumnami w grupie danych "szkoły"
- Zmiany w grupie danych "szkoły":
  - dodanie do nazw kolumn "wojewodztwo", "powiat" i "gmina" sufiksu "_szkoly",
    aby nie myliły się z kolumnami w grupie danych "wartościWskaźników"

--------------------
Zmiany w ZPD 1.1.1 (2015-03-09)

- Zmiany w grupie danych "wartościWskaźników":
  - usunięcie kolumn lu_r i lu_ewd_r z danych zwracanych przez funkcję
    pobierz_wartosci_wskaznikow()
- Zmiany techniczne:
  - dodanie do funkcji e() empirycznego testu na poprawne odczytywanie przez R
    kodowania znaków w kodzie źródłowym (co powinno rozwiązać problem z 
    różnicami w działaniu zaobserwowany pomiędzy wirtualnymi Windows 8 
    i Windows 7)
  
--------------------
Zmiany w ZPD 1.1.0 (2015-02-23)

- Zmiany techniczne:
  - dodanie poprawnej obsługi polskich znaków pod Windows
    (przestawianie połączenia z bazą w kodowanie lokalne komputera, 
    rekodowanie komunikatów pakietu, rekodowanie zapytań)
  
--------------------
Zmiany w ZPD 1.0.2 (2015-02-18)

- Zmiany w grupie danych "skale":
  - dodanie zmiennych "posiada_pv" i "posiada_eap" do wyników zwracanych
    przez funkcję pobierz_skale()

--------------------
Zmiany w ZPD 1.0.1 (2015-02-17)

- Zmiany w grupie danych "wskaźniki":
  - korekta w funkcji pobierz_wskazniki() pozwalająca na obejście błędu 
    dplyr-a, który uniemożliwiał filtrowanie po kolumnach "opis_wsk" i
    "wsk_do_prezentacji"
  - dodanie obejścia błędu w pakiecie RPostgreSQL umożliwiającego poprawne
    wykonanie pod Windowsami funkcji pobierz_wartosci_wskaznikow()
    (problemy z kodowaniem polskich znaków)
- Techniczne:
  - obłożenie testami funkcji zsumuj_punkty()
  - obłożenie podstawowymi testami funkcji normalizuj_ekwikwantylowo()

--------------------
Zmiany w ZPD 1.0.0 (2015-02-16)

- Zmiany w grupie danych "uczniowie":
  - korekta błędu w funkcji pobierz_uczniow() uniemożliwiającego pobranie
    danych uczniów, którzy posiadali w bazie id inne niż id_cke, nieposiadając
    jednocześnie id_cke
- Zmiany w grupie danych "parametry":
  - dodanie pobierania parametrów grup (dotychczas tylko kryteriów oceny)
- Zmiany w grupie danych "wyniki":
  - uwolnienie od zależności od pakietu EWDdane poprzez przeniesienie kodu
    funkcji EWDdane::normy_ekwikwantylowe()
- Techniczne:
  - korekta błędu w wewnętrznej funkcji ramka_danych_pv() wprowadzonego 
    w wersji 0.9, który uniemożliwiał wyliczanie PWE funkcją agreguj_pwe()
  - korekta błędu w funkcji oblicz_wariancje_populacji() wprowadzonego
    w wersji 0.9, który uniemożliwiał wyliczanie PWE funkcją agreguj_pwe()
  - dodanie automatycznej weryfikacji pakietu za pomocą Travis-a
    (http://r-pkgs.had.co.nz/check.html#travis)
  - dopisanie prostego testu dla funkcji agreguj_pwe()
  - dodanie automatycznych raportów pokrycia za pomocą pakietu "covr"
    i coverall (https://github.com/jimhester/covr)
- Przeniesienie funkcji realizujących zapis do bazy do oddzielnego pakietu
- Przeniesienie funkcji niezwiązanych z pobieraniem danych z bazy do 
  oddzielnego pakietu (sprawdz_podwojne_ocenianie(), sprawdz_realizacje(),
  wczytaj_spss(), itp.)

--------------------
Zmiany w ZPD 0.9.5 (2015-02-15)

- Zmiany w grupie danych "wyniki":
  - korekta sprawdzania wartości wejściowych przez funkcję zsumuj_punkty()
    (dotychczas niepoprawnie nie dopuszczała, aby dane były tablicą dplyr-a)
- Zmiany w grupie danych "szkoly":
  - pobierz_szkoly() zwraca także zmienną "artystyczna"

--------------------
Zmiany w ZPD 0.9.4 (2015-02-11)

- Zmiany w grupie danych "testy":
  - dostosowanie funkcji pobierz_testy() do zmian w strukturze bazy danych
- Zmiany w grupie danych "skale":
  - dostosowanie funkcji pobierz_testy() do zmian w strukturze bazy danych
- Zmiany w grupie danych "wartosciWskaznikow":
  - dostosowanie funkcji pobierz_wartosci_wskaznikow() i 
    pobierz_wartosci_wskaznikow_lu() do zmian w strukturze bazy danych
- Zmiany w funkcjach do zapisu do bazy:
  - dodanie argumentów "rodzajEgzaminu" i "czescEgzaminu" do funkcji stworz_test(),
  - przepisanie funkcji stworz_test(), stworz_skale(), edytuj_skale()
- Zmiany techniczne:
  - przywrócenie twardej zależności od RODBCext, bo RODBC::odbcConnect() nie radzi
    sobie gdy nie zaimportowano całego namespace-a RODBC
  - korekta sposobu zwracania błędów SQL (czemu to się tak długo uchowało?!) 

--------------------
Zmiany w ZPD 0.9.3 (2015-02-04)

- Zmiany w grupie danych "skale"
  - Dostosowanie funkcji pobierz_skale() do zmian w bazie danych
- Zmiany w funkcji filtruj_przystapienia():
  - dodanie obejścia problemu niepoprawnego mapowania R-oweg operatora %in% na 
    SQL-owy IN w wypadku gdy wektor wartości jest długości 1
  - dostosowanie do zmian nazw kolumn w grupie danych "testy"
  
--------------------
Zmiany w ZPD 0.9.2 (2015-02-02)

- Zmiany w grupie danych "wyniki"
  - Korekty w funkcjach pobierz_wyniki_egzaminu(), pobierz_wyniki_testu(),
    pobierz_wyniki_zrownywania() uodparniające je na błąd w bibliotece
    RPostgreSQL
  - Korekta funkcji zsumuj_punkty(), która dotychczas nie sumowała danych
    w postaci długiej
  - Zmiana na TRUE domyślnych wartości parametrów "skroc" w funkcjach 
    pobierz_wyniki_egzaminu(), pobierz_wyniki_testu(), pobierz_odpowiedzi(),
    pobierz_wyniki_zrownywania()
  - Korekta stosowania skali w funkcji pobierz_odpowiedzi()

--------------------
Zmiany w ZPD 0.9.1 (2015-01-30)

- Zmiany w grupie danych "wskazniki":
  - zmiana nazwy zmiennej "do_prezentacji" na "wsk_do_prezentacji"
  - zmiana nazwy zmiennej "opis_wskaznika" na "opis_wsk"
  - dodanie zmiennej "rok_do"
- Zmiany w grupie danych "wartosciWskaznikow":
  - dodanie prefiksu "przedm_" do zmiennych "lu", "lu_ewd" i "lu_wszyscy" 
    zwracanych przez funkcję pobierz_wartosci_wskaznikow_lu(), aby
    nie złączały się (powodując błędy) z analogicznymi zmiennymi w danych
    zwracanych przez pobierz_wartosci_wskaznikow()
  - korekta funkcji pobierz_wartosci_wskaznikow(), aby poprawnie filtrowała
    jedynie informacje w podziale na przedmioty
- Zmiany w grupie danych "kryteriaOceny":
  - dodanie zmiennych "id_testu", "kolejnosc_kryt" oraz "popr_dystraktor"
    - dzięki temu możliwe jest łączenie z grupą danych "testy"
    - każde kryterium oceny jest teraz powielone tyle razy, w ilu testach
      występuje
- Zmiany w grupie danych "skale":
  - zmiana nazwy parametru "ktt" funkcji pobierz_skale() na "czyKtt"
  - dopracowanie pobierania rodzaju i części egzaminu związanego z daną skalą

--------------------
Zmiany w ZPD 0.9 (2015-01-29)

- Zmiana nazw niektórych zmiennych zwracanych przez funkcje pobierz_...()
  w celu uniknięcia niejednoznaczności w nazwach zmiennych pomiędzy grupami
  danych (a co za tym idzie problemów przy złączeniach)
- Dodanie funkcji:
  - filtruj_przystapienia()
  - pobierz_kryteria_oceny()
  - pobierz_parametry()
  - pobierz_schematy_odp()
  - pobierz_schematy_pkt()
  - pobierz_skale()
  - pobierz_standardy_egz()
  - pobierz_wartosci_wskaznikow()
  - pobierz_wartosci_wskaznikow_lu()
  - pobierz_wskazniki()
  - oszacuj_czas_wykonania() (wymaga jeszcze kalibracji)
- Techniczne:
  - zredukowanie "twardych" zależności pakietu do dplyr-a i przeniesienie 
    wszystkich innych zależności do "suggests" (bo dotychczasowa litania
    zależności powodowała już problemy z przykrywaniem nazw np. między
    pakietami dplyr i plyr)
  - przejście z funkcji pakietu stringr na stringi
  - dodanie funkcji .sprawdz_dokumentacje_zmiennych() do weryfikacji,
    czy zapisana w bazie dokumentacja zmiennych zwracanych przez funkcje
    pobierz_...() jest kompletna
    - wprowadzenie systemu anotacji funkcji przez atrybuty umożliwiającego
      powiązanie funkcji z grupą danych w bazie oraz określenie testowych
      wartości parametrów niezbędnych dla sczytania listy zwracanych przez
      funkcję zmiennych
  - dodanie porządnej weryfikacji argumentów do funkcji pobierz_...()

--------------------
Zmiany w ZPD 0.8 (2015-01-19)

- Dostosowanie funkcji pobierz_testy() do zmian w strukturze bazy danych
- Usunięcie funkcji (jako niezgodnych z nową filozofią pobierania danych):
  - pobierz_czesc_egzaminu(), 
  - pobierz_arkusz(), 
  - pobierz_test(),
  - znajdz_testy(),
  - znajdz_skale()
- Przepisanie funkcji pobierz_zrownywanie() na dplyr-a i zmiana jej nazwy na
  pobierz_wyniki_zrownywania()
- Dodanie do funkcji pobierz_wyniki_egzaminu() sprawdzania, czy dany egzamin 
  jest w bazie i eleganckiego komunikowania, jesli nie
- Dodanie funkcji:
  - pobierz_odpowiedzi(),
  - zsumuj_punkty(),
  - normalizuj_ekwikwantylowo()

--------------------
Zmiany w ZPD 0.7.3 (2015-01-12)

- Poprawki
  - Korekta w funkcji pobierz_wyniki_egzaminu() umożliwiająca pobranie wyników
    wielu egzaminów podczas jednej sesji R

--------------------
Zmiany w ZPD 0.7.2 (2015-01-05)

- Poprawki
  - Poprawne opisanie funkcji dodanych w wersji 0.7.1, tak by były widoczne
    po załadowaniu pakietu

--------------------
Zmiany w ZPD 0.7.1 (2014-12-10)

- Nowe funkcjonalności
  - Testowe wprowadzenie zestawu funkcji pobierających dane z bazy w postaci
    ramek danych dplyr-a:
    - get_pupils_estimates()
    - get_exam_results()
    - get_test_results()
    - get_pupils()
    - get_pupils_tests_data()
    - get_schools()
    - get_tests()

--------------------
Zmiany w ZPD 0.7.0 (2014-12-08)

- Nowe funkcjonalności
	- funkcja agreguj_pwe() oblicza błędy standardowe agregatów PWE na
    podstawie wariancji populacji (jak dotychczas) lub wariancji
    wewnątrz grup; pozwala to obliczać PWE dla dowolnie zdefiniowanych
    populacji

--------------------
Zmiany w ZPD 0.6.8 (2014-11-02)

- Poprawki:
	- funkcja sprawdz_skroty_skal() dokładniej waliduje teraz dane wejściowe

--------------------
Zmiany w ZPD 0.6.7 (2014-10-31)

- Poprawki:
	- Korekta błędnego return() w funkcji sprawdz_skroty_skal()
  - Wprowadzenie anotacji umożliwiających Roxygenowi dodanie potrzebnych
    klauzuli import() w pliku NAMESPACE

--------------------
Zmiany w ZPD 0.6.6 (2014-10-03)

- Poprawki:
	- Zmiana z sqlQuery() na .sqlQuery() wewnątrz funkcji wydziel_testy()

--------------------
Zmiany w ZPD 0.6.5 (2014-09-25)

- Poprawki:
	- Korekta w pobierz_czesc_egzaminu() - jawne nadanie typu 4 argumentowi
    wywoływanej funkcji wbudowanej bazy danych, co umożliwia poprawny
    wybór właściwej funkcji wbudowanej przez bazę na etapie przygotowywania
    zapytania.

--------------------
Zmiany w ZPD 0.6.4 (2014-09-13)

- Nowe funkcje:
	- zapisz_spss(), która używając pod spodem PSPP zapisuje ramkę danych 
    w formacie SAV

- Poprawki:
	- Obłożenie foreign::read.spss() w funkcji wczytaj_spss() suppressWarnings()
  	oraz suppressMessages()
	- Korekta nazwy zmiennej w funkcji ramka_danych_pv() z nieistniejącej 
    zmiennej na istniejącą

--------------------
Zmiany w ZPD 0.6.3 (2014-07-29)

- Dodanie zrozumiałego raportowania o nieistnieniu danych w bazie przez funkcje
  pobierz_czesc_egzaminu(), pobierz_arkusz(), pobierz_zrownywanie(),
  pobierz_test()
- Rozpoczęcie migracji na RODBCext i zapytania parametryzowane

--------------------
Zmiany w ZPD 0.6.2 (2014-06-27)

- Nowe funkcje:
  - agreguj_pwe() - oblicza agregaty PWE z PV
	- oblicz_wariancje_populacji() - oblicza wariancje populacji z PV

--------------------
Zmiany w ZPD 0.6.1 (2014-04-28)

- Nowe funkcje:
  - znajdz_testy() - wyszukuje w bazie testy
	- stworz_test() - tworzy w bazie nowy test

--------------------
Zmiany w ZPD 0.6 (2014-04-26)

-	Nowe funkcje:
	-	przygotuj_mature_popr() - sprawdza zgodność zmiennych z planem testu w
    bazie i zamienia nazwy kolumn na strawne dla skryptu 'import_test.php'
	- sprawdz_podwojne_ocenianie() - sprawdza zgodność zbioru podwójnego
	  oceniania z danymi wszystkich uczniów [weryfikacja zbiorów z badań
    zrównujących]
  - sprawdz_realizacje() - sprawdza poprawność zbioru podsumowującego
    realizację i jego zgodność ze zbiorem danych wszystkich uczniów 
    [weryfikacja zbiorów z badań zrównujących]

- Poprawki
	- sprawdz_zrownanie() teraz radzi sobie z ujednolicaniem kodów specjalnych
	- stworz_skale() dostosowane do zmiany w nazwach tablic w bazie
  
--------------------
Zmiany w ZPD 0.5.4 (2014-03-25)

-	Aktualizacja funkcji sprawdz_zrownanie():
	-	korekta w sposobie weryfikacji ilorazów punktów

--------------------
Zmiany w ZPD 0.5.2 (2014-01-09)

-	Aktualizacja funkcji sprawdz_zrownanie():
	-	dostosowanie do aktualnego sposobu przechowywania w bazie identyfikatorów
		uczniów (w tablicy "obserwacje_id")
	-	dodanie weryfikacji sum i ilorazów punktów

--------------------
Zmiany w ZPD 0.5.1 (2013-12-03)

- Korekta sposobu konstruowania identyfikatora 'zrwn' przez funkcję 
	wydziel_testy(), tak by był on zgodny z analogicznym identyfikatorem
	konstruowanym przez klasę PHP BazaObserwacji wykorzystywaną do importu danych

--------------------
Zmiany w ZPD 0.5

- Funkcja wydziel_testy() do podziału plików danych z badań zrównujących na 
	pliki testów
- Funkcja wczytaj_spss() do automatycznej wstępnej obróbki wczytywanych plików
  SPSS
- Funkcja sprawdz_zrownanie() do weryfikacji poprawności importu zrównywania
  do bazy danych

--------------------
Zmiany w ZPD 0.4

- Funkcje do obsługi skal:
	-	stworz_skale()
	-	znajdz_skale()
	-	edytuj_skale()
-	Wprowadzenie (jednolitej) obsługi wyjątków.

--------------------
Zmiany w ZPD 0.3.1

-	Funkcje pobierz_arkusz(), pobierz_czesc_egzaminu(), pobierz_test(), 
	pobierz_zrownywanie() dopuszczają parametr "idSkali" równy NULL

--------------------
Zmiany w ZPD 0.3

-	Dodanie do funkcji pobierz_arkusz(), pobierz_czesc_egzaminu(), 
	pobierz_test(), pobierz_zrownywanie() parametrow "idSkali" oraz "skroc"
	umozliwiajacych przeksztalcanie pobieranych wynikow (zlaczanie kryteriow
	oceny i/lub skracanie skal) stosownie do definicji skali.
-	Dodanie pełnej weryfikacji formalnej poprawności argumentów funkcji
	pobierz_arkusz(), pobierz_czesc_egzaminu(), pobierz_test() oraz 
	pobierz_zrownywanie(). 
  Uwaga, nie oznacza to kontroli poprawności semantycznej, np. cały czas 
  można podać rodzaj czy część egzaminu których nie ma w bazie i nie będzie 
  to traktowane jako błąd.