Uživatelsk� př�ručka grouperu


1. �vod
2. Instalace
2.1. Verze grouperu
2.1.1. Spustěn� instalace v MS Windows
2.1.2. Spustěn� instalace v prostřed� Linux, HP-UX, Solaris
2.2. Průběh instalace
2.3. Probl�my při spouštěn�
3. Použit� grouperu
3.1. Grouper v m�du př�kazov� ř�dky
3.2. Grafick� nadstavba grouperu: wgrouper
3.2.1. Spuštěn�
3.2.2. Použit�
4. Datov� rozhran�
4.1. Vstupn� datov� rozhran�
4.2. V�stupn� datov� rozhran�
5. Př�lohy
5.1. Definičn� manu�l

Kapitola 1. �vod

Grouper je program, kter� podle vstupn�ch informac� o hospitalizačn�m př�padu pacienta odvozuje jeho zařazen� do skupiny DRG. Algoritmus zařazen� je d�n Definičn�m manu�lem IR DRG verze 1.2 revize 012. Tento Definičn� manu�l je distribuov�n Ministerstvem zdravotnictv� ČR společně s grouperem.

Kapitola 2. Instalace

2.1. Verze grouperu

2.1. Verze grouperu

Tento grouper je poskytov�n ve sv� z�kladn� verzi označen� 012. V př�padě vyd�n� z�platy k t�to verzi bude, pro jej� snadnou identifikaci zv�šena i verze grouperu na 012 a vyšš�.

Grouper je poskytov�n ve formě instalačn�ho bal�čku setup.jar. Předpokl�d� se, že před instalac� samotn�ho grouperu je na poč�tači nainstalov�no prostřed� jazyka Java ve verzi 1.5 a vyšš�. Pokud toto prostřed� nainstalovan� nem�te, můžete jej bezplatně z�skat na Internetu na str�nk�ch uveden�ch v n�sleduj�c�m seznamu pro z�kladn� platformy:

Po instalaci prostřed� jazyka Java je možn� přistoupit k instalaci samotn�ho grouperu.

2.1.1. Spustěn� instalace v MS Windows

V prostřed� MS Windows stač� ke spuštěn� instal�toru poklep�n� na instalačn� bal�ček setup.jar.

2.1.2. Spustěn� instalace v prostřed� Linux, HP-UX, Solaris

V prostřed� těchto operačn�ch syst�mů je zapotřeb� instalaci spustit ručně. Pro jednoduchost předpokl�dejme, že syst�mov� proměnn� PATH obsahuje cestu k runtime prostřed� Java a že pracovn� adres�ř je na instalačn�m CD. Pot� stač� spustit př�kaz: java -jar setup.jar Instalace mus� b�t spuštěna v grafick�m prostřed� (X Windows).

2.2. Průběh instalace

Po spuštěn� instalačn�ho programu jste dot�z�ni na jazyk v němž si přejete instalaci prov�st. Potvrďte češtinu stiskem tlač�tka OK. V dalš�m dialogu jste vyzv�ni k souhlasu se zněn�m licenčn�ho ujedn�n�. Jako v�raz souhlasu s n�m klikněte na radio-button Souhlas�m s licenčn�mi podm�nkami. T�m zaktivujete tlač�tko Dalš�. Po jeho stisku se objev� dialog pro v�běr instalačn�ho adres�ře. Pokud ponech�te jeho defaultn� hodnotu grouper se nainstaluje do adres�ře Grouper IR DRG ve Vašem domovsk�m adres�ři. Po dalš�m přechodu pomoc� tlač�tka dalš� budete vyzv�ni k volbě komponent, kter� chcete instalovat. Jde jednak o samotn� grouper a o definičn� manu�l zpracovan� v podobě zpracovateln� samotn�m grouperem. Po nainstalov�n� těchto dvou komponent zvolte, zda chcete nechat vytvořit z�stupce. Posledn� volbou je možnost vytvořen� automatick�ho instalačn�ho skriptu. Tento skript obsahuje vešker� vaše odpovědi zadan� při současn� instalaci. Pokud tento skript pojmenujete např�klad inst a um�st�te jej ve stejn�m adres�ři jako instalačn� bal�k setup.jar, můžete instalaci spustit z př�kazov� ř�dky pomoc� java -jar setup.jar inst a grouper je automaticky nainstalov�n. V př�padě tohoto způsobu instalace nen� zapotřeb� grafick� uživatelsk� rozhran�.

2.3. Probl�my při spouštěn�

Při spuštěn� grouperu může doj�t k tomu, že grouper zahl�s�, že nen� spuštěn ve spr�vn� verzi javy, tedy verzi 1.4 a vyšš�. K tomu může doj�t i v okamžiku, kdy takovouto verzi nainstalov�nu m�te, současně však m�te nainstalov�nu javu nižš� verze, jej�ž spuštěn� je upřednostněno nastaven�m syst�mu. V tomto př�padě se nask�taj� n�sleduj�c� varianty řešen�:

  • odinstalace star� verze

  • �prava nastaven� syst�mu - upřednostěn� spouštěn� nov� verze (editac� proměnn� prostřed� PATH)

  • �prava spouštěc�ch skriptů - doplněn� pln� cesty k programu java.exe

Pokud zvol�te posledn� variantu - doplněn� pln� cesty k programu java.exe spr�vn� verze, je zapotřeb� zeditovat spouštěc� soubory. Tyto soubory lež� př�mo v instalačn�m adres�ři grouperu. Pro jednotliv� operačn� syst�my �pravu proveďte n�sledovně:

  • OS Windows - lgrouper.bat a wgrouper.bat. U obou souborů na zač�tek druh�ho ř�dku doplňte cestu k programu java.exe. Tedy např�klad původn� ř�dek :

    java -Xms128m -Xmx512m ...

    zaměňte za :

    C:\java\jdk1.5._02\bin\java -Xms128m -Xmx512m ...

  • Ostatn� OS - zeditujete soubory lgrouper.sh a wgrouper.sh. U obou souborů doplňte na zač�tek prvn�ho ř�dku plnou cestu k programu java. Tedy např�klad původn�:

    java -Xms128m -Xmx512m ...

    zaměňte za:

    /usr/java/jdk1.5.0_05/bin/java -Xms128m -Xmx512m ...

Kapitola 3. Použit� grouperu

Grouper je možn� spustit ve dvou režimech - pomoc� př�kazov� ř�dky a v grafick�m m�du.

3.1. Grouper v m�du př�kazov� ř�dky

Grouper v m�du prikazov�ho ř�dku se spoušt� v prostřed� MS Windows pomoc� d�vkov�ho souboru lgrouper.bat, v operačn�ch syst�mech pak pomoc� skriptu lgrouper.sh. Syntaxe je n�sleduj�c�:

  • lgrouper [-t{0|1}][-i vstupni_soubor][-o vystupni_soubor]

  • lgrouper [-v]

-i vstupni_soubor Určen� vstupn�ho souboru. Pokud nen� zad�n, grouper bude zpracov�vat standardn� vstup (stdin).
-o vystupni_soubor Určen� v�stupn�ho souboru. Pokud nen� zad�n, grouper bude ps�t na standardn� v�stup (stdout).
-t {0|1} �roveň trasov�n� (v�pis průběhu algoritmu). Možn� �rovně:
  • 0 - netrasuj
  • 1 - trasuj
Trasovac� v�pis jde na chybov� v�stup (stderr).
-v V�pis verze grouperu

3.2. Grafick� nadstavba grouperu: wgrouper

Pro pohodlnějš� zkoušen� byl grouper doplněn grafickou nadstavbou "wgrouper".

3.2.1. Spuštěn�

3.2.1.1. MS Windows

V programov� skupině grouperu je připraven z�stupce pro wgrouper. Pokud jste instalovali pomoc� přednastaven�ch voleb, spust�te jej pomoc� volby Grouper IR DRG. Otevře se okno s grafick�m rozhran�m grouperu.

3.2.1.2. Linux a UNIX

Pokud m�te k dispozici X Window System, spusťte z př�kazov� ř�dky:wgrouper.sh

3.2.2. Použit�

3.2.2.1. Menu

Horn� menu obsahuje tyto položky:

  • Soubor
    • Interaktivn� formul�ř
    • Zpracov�n� souboru
    • Přerušen� zpracov�n�
    • Zpracovat
    • Konec
  • N�pověda
    • N�pověda
    • O aplikaci Grouper

3.2.2.2. Karta "Interaktivn� formul�ř"

Karta (z�ložka) "Interaktivn� formul�ř" slouž� k interaktivn�mu zkoušen� grouperu.Vstupn� data vypln�te v č�sti formul�ře označen� "Vstupn� �daje". Po stisknut� tlač�tka "Zpracuj" program sestav� vstupn� větu, zpracuje ji ř�dkov�m grouperem a v�stup z něj vr�t� do formul�ře - do č�sti "V�sledek", ale i do č�sti "Vstupn�ch �dajů" (v�stupn� věta grouperu obsahuje totiž i celou vstupn� větu). Nad formul�řem je pruh tlač�tek pojmenovan� "N�stroje". Tlač�tka odpov�daj� svou funkcionalitou jednotliv�m položk�m v menu.

3.2.2.3. Karta "Zpracov�n� souboru"

Karta (z�ložka) Zpracov�n� souboru odpov�d� použit� ř�dkov�ho grouperu ve formě: lgrouper -i vstupni_soubor -o vystupni_soubor

Kapitola 4. Datov� rozhran�

4.1. Vstupn� datov� rozhran�

Vstupn� soubor je textov� soubor. Jednotliv� ř�dky (tzv. vstupn� věty) reprezentuj� hospitalizačn� př�pady. Form�t vstupn� věty je n�sleduj�c�:

Tabulka 4.1. Form�t vstupn� věty

pořad�položkapozice (ve znac�ch)d�lka (ve znac�ch)typ dat
1Identifikace př�padu001-01313Character
2Pacient014-03017Character
3Jm�no031-06131Character
4Datum přijet�062-07110Date
5Datum propuštěn�072-08110Date
6D�lka hospitalizace082-0854Numeric
7Datum narozen�086-09510Date
8Věk pacienta v letech096-0983Numeric
9Věk pacienta ve dnech099-1013Numeric
10Pohlav� pacienta1021Character
11Stav při propuštěn�103-1042Character
12Porodn� v�ha105-1084Numeric
13Př�znak narozen� zde1091Numeric
14Rezerva110-1134Numeric
15Př�jmov� diagn�za114-1185Character
16Z�kladn� diagn�za119-1235Character
17Vedlejš� diagn�zy124-19370 = (14*5)Character
18V�kony194-26875 = (15*5)Character


Detaily položek

Datumy
form�t: dd/mm/rrrr
Datum přijet�
Zač�tek hospitalizačn�ho př�padu. Datum př�jmu je důležit� pro v�počet věku pacienta. Datum př�jmu je nepovinn� v př�padě, že je vyplněn věk pacienta a d�lka hospitalizace.
Datum propuštěn�
Konec hospitalizačn�ho př�padu. Nepovinn�, pokud je vyplněna d�lka hospitalizace.
D�lka hospitalizace
D�lka hospitalizačn�ho př�padu. Povinn�, pokud nen� vyplněna a nen� vyplněn ani datum přijet� a propuštěn� je nahrazena hodnotou 9999 dnů.
Datum narozen�
Datum narozen� pacienta. Datum narozen� je nepovinn� v př�padě, že je vyplněn věk pacienta.
Věk v letech
Nepovinn� v př�padě vyplněn� data př�jmu a narozen�. Povolen� rozsah: 000-999.
Věk ve dnech
Nepovinn� v př�padě vyplněn� data př�jmu a narozen�. Povolen� rozsah: 000-999
Pohlav�

Tabulka 4.2.

1,M,mmuž
2,F,f,Z,zžena
3,I,inedefinovateln�
0,U,uneurčen�

Stav při propuštěn�, ukončen� př�padu
Porodn� v�ha
Uv�d� se v gramech. Povinn� u novorozenců, u kter�ch plat� věk < 28 dnů. Povolen� rozsah: 0100-9000.
Diagn�zy
K�dy dle č�seln�ku MKN-10 (pouze alfanumerick� znaky)
Př�jmov� diagn�za
Nepovinn�
Z�kladn� diagn�za
Povinn�
Vedlejš� diagn�zy
Nepovinn�
V�kony
Dle sazebn�ku v�konů a seznamu rozhoduj�c�ch v�konů pro grouper

4.2. V�stupn� datov� rozhran�

V�stupn� soubor je textov� soubor. Jednotliv� ř�dky (tzv. v�stupn� věty) obsahuj� kopii vstupn� věty n�sledovanou vlastn�m vyhodnocen�m. Form�t v�stupn� věty je n�sleduj�c�:

Tabulka 4.3. Form�t v�stupn� věty

pořad�položkapozice (ve znac�ch)d�lka (ve znac�ch)typ dat
1-18Kopie vstupn� věty001-268268 
19Identifikace grouperu269-2713Character
20DRG272-2765Character
21Chybov� stav277-2782Character
22Chybov� př�znaky diagn�z279-29214Character
23Chybov� př�znaky v�konů293-30715Character


Kapitola 5. Př�lohy

5.1. Definičn� manu�l

Společně s grouperem je distribuov�na elektronick� verze Definičn�ho manu�lu IR-DRG 1.2 revize 011. Vstup do elektronick� verze je přes soubor elman.html um�stněn� v podadres�ři doc instalačn�ho adres�ře grouperu.