GeoGet

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Statistiky - GgStat ======
===== Základní popis =====

Pro tvorbu statistiky v **GeoGetu** je vytvořen program **GgStat.exe** a jeho plugin [[user:skript:ggstat|GgStat]]. Program umožňuje bohatou konfiguraci a existuje řada dalších pluginů, které možnosti tohoto programu ještě rozšiřují. Při instalaci [[user:skript:ggstat|GgStatu]] se do podadresáře ''GgStatDoc'' instaluje docela podrobná nápověda i s příklady jak ovlivnit vzhled a obsah statistiky.

Samotná definice toho, co nám [[user:skript:ggstat|GgStat]] do statistiky vygeneruje, je uložena v tzv. šabloně. **Šablona** je textový soubor, který můžeme snadno editovat např. v Poznámkovém bloku. Instalace [[user:skript:ggstat|GgStatu]] vytvoří několik vzorových šablon do jeho kořenového adresáře:

^Soubor šablony ^Popis^
|Template.cz|Základní šablona v češtině|
|Template.en|Základní šablona v angličtině|
|Template.tabmenu.cz|Šablona statistiky rozdělené na záložky po sekcích v češtině|

<WRAP center round important 80%>
**Důrazná doporučení:**
  - Vyberte si vzor a uložte jako svojí vlastní šablonu **pod jiným jménem souboru**. Kačer s nickem Franta třeba jako ''Template.Franta.tabmenu.cz''. Jednak si ji jednoznačně poznáte, ale především se vám nepřepíše při aktualizaci skriptu.
  - Zkontolujte si, že statistiku vytváříte právě podle té vaší šablony. Až příliš často se stává, že někdo edituje jednu šablonu a generuje statistiku z druhé!
  - Při větších úpravách šablony si předchozí verzi souboru zazálohujte. Když se úplně ztratíte, budete se mít kam vrátit.
</WRAP>

Instalace pluginu obsahuje i script pro spouštění programu, ovšem ten opravdu jen spustí program pro výpočet statistik. Všechny činnosti, které spuštění mohou předcházet nebo následovat (např. uložení statistik na web do profilu uživatele) už je třeba udělat ručně.

==== Autostat ====
Protože program [[user:skript:ggstat|GgStat.exe]] je řízen parametry z příkazové řádky, byl vytvořen plugin [[user:skript:autostat|Autostat]], který uživateli usnadňuje nastavení parametrů pro spouštění programu. [[user:skript:autostat|Autostat]] je na světě již dlouho a od jeho vzniku se změnily některé možnosti a postupy. Protože se snaží za uživatele udělat i některé další činnosti (např. může stáhnout nálezy, nahrát statistiku na web do profilu, ...), někdy působí problémy:

  * některé činnosti, které jsou implicitně zapnuté, //deformuji// uložená data
  * některé činnosti nejde vypnout
  * [[user:skript:autostat|Autostat]] neumí spouštět některé novější pluginy pro doplnění statistik - je to třeba dělat samostatně ručně nebo pomocí pluginu [[user:skript:combine|Combine]]

Vývoj autostatu byl autorem přerušen, resp. vytvořil úkrok stranou a jako pokračování tohoto pluginu [[user:skript:combine-davky#generovani_statistiky_-_autostat|vytvořil dávku]] pro [[user:skript:combine|Combine]].

==== Combine ====
Další možností je použití pluginu [[user:skript:combine|Combine]] a použít některou z připravených dávek - [[user:skript:combine-davky#generovani_statistiky_-_autostat|tuto (následovník Autostatu)]] nebo [[user:skript:combine-davky#generovani_statistiky_a_zkopirovani_na_ftp_server_nebo_do_profilu|tuto]]. Konfigurace dávky je trochu složitější, ale umožňuje přesně definovat, co se kdy má udělat, co kam nahrát či kopírovat a co spouštět. Je tak možné vlastnímu spuštění výpočtu statistiky předřadit vytváření částí, které vlastní program vytvořit neumí, a pro které je potřeba další samostatný plugin (odznáčky [[user:skript:badgegenii|BadgeGen]], [[user:skript:seriesii|Série]], přehled získaných trackovacích předmětů a podobně).

<WRAP center round tip 80%>
**Tip**

Pro vylepšení statistiky určitě nebude na škodu se podívat [[user:navody:statistiky-triky|na pár triků]].
</WRAP>


Kromě ukázkových šablon dodaných s aplikací **GgStat.exe** existuje i [[user:navody:statistiky:template|ukázková šablona s mnoha doplňujícími rozšířeními]].
===== Pluginy =====
Seznam pluginů, které je možné spolu s GgStatem použít pro generování statistiky:

{{topic>ggstat}}

===== Řešení problémů =====

==== Chybné zobrazení znaků s diakritikou ====
Občas si uživatelé stěžují na to, že ve vytvořené statistice jsou chybně zobrazené znaky s diakritikou. To může mít několik příčin a také způsobů řešení. Budeme-li předpokládat vytváření statistiky pomocí programu [[user:skript:ggstat|GgStat.exe]], pak jde o správné nastavení hodnoty v příkazech ''INCODING'' a ''OUTCODING''.

Vstupní kodování (''INCODING'') je kodování souboru nebo souborů se šablonou. Tam je ''cp1250'' v drtivé většině případů pro ČR spravné. Je to kodování, které používají správně nainstalované! české Windows. Teoreticky je možné šablonu vytvářet v jiném kódování, ale to by asi musel uživatel dělat vedomě.

S výstupním kódováním už je to složitější a správné nastavení je ovlivněno několika faktory:

  - kde je statistika uložena
    * na serveru gc.com
    * na vlastním serveru a v geocaching.com je jen odkaz na jinde uloženou statistiku
  - jakým způsobem je statistika do cílového umístění kopírována
    * pomocí FTP
    * pomocí CTRL+C a CTRL+V
    * pomocí Geojarry nebo podobnými metodami
  - je také důležité, zda v souladu s předchozími body obsahuje staistika plnou HTML hlavičku s informací o kódování nebo neobsahuje
  - no a nakonec také záleží na tom co, kde a v čem si člověk prohliží. Je možné koukat
    * do profilu
    * na soubor na lokalnim disku
    * na soubor na serveru

=== Statistika uložená na serveru geocaching.com ===
Stránky geocaching.com jsou zobrazovány v kódování ''utf-8''. Proto pokud statistiku vkládáte přímo do profilu na serveru, musí být ''OUTCODING'' nastaveno také na tuto hodnotu. Pokud stránku do profilu kopírujete pomocí ''CTRL+C'' a ''CTRL+V'', pak browser vloží ze scránky do editačního pole text ve správném kódování sám. Ovšem podstatné je kódování textu kopírovaného do schránky pomocí ''CTRL+C'', to by zřejmě mělo být v ''cp1250'' a ''OUTCODING'' je třeba tak nastavit, aby byl správně zobrazen text tam, odkud bude do schránky kopírován.

=== Statistika uložená na vlastním serveru ===
Tento způsob uložení znamená, že v profilu je uložen jen odkaz na skutečnou statistiku uloženou jinde. Odkaz je asi nejvhodnější udělat HTML příkazem ''<object>'' a v tom případě prakticky nezáleží na nastavení ''OUTCODING''. Tedy přesněji řečeno nezáleží v případě, kdy je statistika tvořena korektním HTML souborem s typem kódování uvedeným v jeho hlavičce. Toto kódování musí být v souladu s hodnotou ''OUTCODING''. Pokud statistika neobsahuje typ kódování, pak by ''OUTCODING'' mělo být nastaveno opět na hodnotu ''utf-8''.

=== Přímé zobrazení souboru s vytvořenou statistikou ===
Pokud vytvořený HTML soubor obsahuje hlavičku s typem kódování, pravděpodobně prohlížeč toto nastavení převezme a pak bude vše zobrazeno správně. Pokud soubor neobsahuje typ kódování, pak je třeba nastavit prohlížeč na stejný typ kódování jako bylo nastaveno kódování v příkazu ''OUTCODING'' při generování statistiky.
==== Rozdílné počty nálezů ====
Pokud nesouhlasí počet nálezů v GeoGetu (statistice) a na serveru geocaching.com, může být příčin několik. Nejčastěji jde o to, že na některé keši je více nálezových logů. Nalézt takovou keš je možné několika způsoby, k cíli mohou vést všechny metody, ale také žádná, záleží na typu závady:

  * menu Pluginy - Oprava databáze - Oprava vadných logů - opraví některé typy chyb v lozích
  * [[http://project-gc.com/Profile/FindBadLogs|server project-gc]] - vyhledá keše s duplicitními logy
  * použít SQL příkaz a jím vypsat problematické keše. Jeden takový SQL příkaz je již obsažen v instalaci GeoJarry, ale je možné použít [[user:databaze#seznam_kesi_na_kterych_ma_uzivatel_geogetu_vicenasobny_nalez|tento SQL]] do dávky pro [[user:skript:combine|Combine]] nebo pro plugin [[user:skript:smartfilter|SmartFilter]]
  * pokud preferujete ruční práci, je možné vyzkoušet následující postup
    - [[http://www.geocaching.com/my/logs.aspx?s=1&lt=2|na gc.com zobrazit]] seznam všech nalezených keší, všechny označit a přes CTRL+C vložit do schránky
    - pomocí CTRL+V vložit do excelovské tabulky, vyházet nepotřebné sloupce (nechat jen jméno keše) a seřadit je podle abecedy
    - v GeoGetu si vyexportovat do csv seznam všech nalezených keší, jejich jméno
    - vyexportovaný soubor načíst do další excelovské tabulky, seřadit podle jména keše a zkopírovat sloupec se jménem keše do volného sloupce v první tabulce
    - pro všechny buňky přidaného sloupce nastavit podmíněné formátování tak, aby bylo třeba červené pozadí v případě, že sloupce se neshodují
    - první buňka, která má červené pozadí, je potenciální adept na problém (v Excelu 2010, 2013 je přímo pro kontrolu duplicitních hodnot vhodný typ podmíněného formátování již vytvořen)

==== Změna parametrů keše po odlovení ====
Mnoha lidem vadí, že aktualizací informací o keších se mění i parametry keší, které již odlovili. Kromě polohy keše může dojít ke změně hvězdiček u terénu nebo obtížnosti, ale také třeba ke změně typu keše. Statistika pak nezobrazuje informace o nalezených keších v okamžiku jejich nálezu. Statistika je kouzlo přesných čísel získaných z nepřesných hodnot, což je v tomto případě zjevné. :-)

GeoGet sice zatím neumožňuje uzamknout parametry nalezených keší proti jejich aktualizaci, ale přecijen existuje cesta jak si hodnoty uchovat. Vlastně cest je jako vždy více.
  - **první cesta** vychází z toho, že si uvědomíme, co potřebujeme, a důsledně ze všech importovaných dat vyřazujeme informace o nalezených keších. Ovšem pozor, opravdu je to potřeba udělat **ve všech importech** a to bez ohledu na to, co je jejich zdrojem - zdaleka nemusí být zrojem importovaných dat jen gc.com a jeho GC.Live, PQ nebo jiné GPX
  - **druhá cesta** je trochu snadnější, ale zase má jiná nebezpečí. Spočívá v tom, že si vytvoříme novou databázi a do ní budeme nahrávat jen nalezené keše a právě z této databáze budeme generovat statistiky. Veškerá práce tedy standardně bude probíhat s pracovní databází a v okamžiku nálezu keše jen tuto jedinou nově nalezenou kešku nahrajeme také do druhé databáze s nalezenými kešemi. Toto je jediný způsob, kterým mohou být data v této //statistické// databázi aktualizována