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.