Differences

This shows you the differences between two versions of the page.

@@ Line 1: / Line 1: @@
+====== GgsExpr ======
+[[user:skript:ggsexpr|GgsExpr]] je plugin do [[user:skript:ggstat|GgStat.exe]] a umožňuje získávat z databáze různé hodnoty z tagů a zpracovávat výsledky SQL dotazů do databáze a vytvářet z nich výstup do statistik. Plugin je náhradou za starší //GgsExprTag//, ale protože výrazně posouvá jeho využití mimo TAGy, vynechal jsem tuto indikaci z jeho jména.
+===== Autor =====
+|**[[http://www.geocaching.com/profile/?u=gordici|Gord]]**, **[[mailto:gord@atlas.cz|Gord]]**| ~~PAYPAL business="gord@atlas.cz" message="Prispevek na skript: GgsExpr"~~|
+Pokud se Vám doplněk líbí, kliknutím na tlačítko **Donate** můžete přispět na jeho vývoj.
+//Nekamarádíte se s PayPalem? Napište mi [[mailto:gord@atlas.cz|email]] a domluvíme se na jiném způsobu, třeba převodu na účet.//
+===== Automatická instalace =====
+~~GEOGET_INSTALL~~
+===== Diskuze =====
+/* Diskuze o tomto skriptu se nachází na stránkách [[http://www.geocaching.cz/forum/************|Geocaching.cz]]. */
+Stejně jako u ostatních pluginů pro [[user:skript:ggstat|GgStat]] neexistuje ani pro tento samostatné vlákno a vše je zatím ve [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=13234&sort=&rowstart=0|společném tématu]].
+===== Šablony, příklady =====
+Šablonou budeme nazývat část Template souboru, která obsahuje volání pluginu a příkazy pro něj. Zkopírováním takové šablony do svého template pak může jíný uživatel dosáhnout snadno stejného výsledku.
+<box round 100% #DEE7EC>
+:!: Šablona většinou obsahuje pouze výkonné příkazy. Pokud není uvedeno jinak, celý obsah šablony proto musí být umístěn v souboru Template až za příkazem START (nebo je za tímto příkazem příkaz pro vložení šablony ze samostatného souboru).
+</box>
+<box round 100% #DEE7EC>
+:!: Popis příkazů použitelných v šabloně a způsob jejího vytvoření je v HTML souboru, který je součástí instalace.
+</box>
+Využijme tady tento prostor pro výměnu **šablon**. Prosím každého, kdo vytvoří něco, co by se mohlo líbít a hodit ostatním, aby sem příslušnou **šablonu** doplnili nebo mi ji poslal, abych ji mohl doplnit já.
+Od [[user:skript:ggstat|GgStatu]] verze 1.1.28 je začlenění šablony do Template souboru velmi jednoduché. Stačí šablonu zkopírovat někam na disk (nejlépe do datového adresář Geogetu, podadresář ''script\GgStat'') a do Template souboru doplnit řádek
+<code>
+INCLUDE_TEMPLATE .\script\GgStat\jmeno_souboru_se_sablonou
+</code>
+==== Doplnění řádku do tabulky zajímavých čísel ====
+Autor: **[[http://www.geocaching.com/profile/?u=gordici|Gord]]**, **[[mailto:gord@atlas.cz|Gord]]**
+{{:user:skript:ggsexpr:template_somenumbers.zip|Šablona}} sečte hodnoty v jednom TAGu u všech keší, vytvoří z nich řádek pro tabulku zajímavých čísel a tabulku pak vloží do statistiky.
+==== Tabulka vybraných keší ====
+Autor: **[[http://www.geocaching.com/profile/?u=gordici|Gord]]**, **[[mailto:gord@atlas.cz|Gord]]**
+Ukázková {{:user:skript:ggsexpr:template_tablecache.zip|šablona}} vytvoří pomocí SQL dotazu ve statistice tabulku 10 nalezených keší, jejichž ID končí znakem '1'. Ne, že by tato funkce měla nějaké rozumné využití, ale demonstruje tvorbu tabulek pomocí pluginu. Jistě nebude problém si šablonu upravit tak, aby výsledkem byla tabulka, jakou si uživatel bude přát.
+==== Tabulka atributů nalezených keší ====
+Autor: **[[http://www.geocaching.com/profile/?u=gordici|Gord]]**, **[[mailto:gord@atlas.cz|Gord]]**
+Další {{:user:skript:ggsexpr:template_attrlist.zip|šablona}} vytvoří pomocí SQL dotazu ve statistice tabulku atributů na nalezených keších.
+<box round 95% #DEE7EC>
+:!: Pozor, pokud nebude ve statistice zobrazena ikona, pravděpodobně se jedná o chybně nastavený atribut. Najeďte myší nad nezobrazenou ikonu, zobrazí se pořadí ikony a jméno atributu. Pak vyhledejte keše s takto nastaveným atributem a opravte jej nebo smažte. Vyhledaní je nejlépe pomocí filtru, záložka Tagy, Tag **attribute** s příslušnou hodnotou.
+</box>
+<box round 95% #DEE7EC>
+:!: Aby Vaše PQ obsahovalo informace o atributech je nezbytně nutné nastavit formát GPX na verzi **1.0.1**. To provedete na stránce http://www.geocaching.com/account/ManagePreferences.aspx úplně dole.
+</box>
+{{:user:skript:ggsexpr:ggsexpr_attrlist.jpg|Přehled atributů na nalezených keších}}
+==== Ikony všech nalezených keší ====
+Autor: **[[http://www.geocaching.com/profile/?u=gordici|Gord]]**, **[[mailto:gord@atlas.cz|Gord]]**
+{{:user:skript:ggsexpr:template_iconlist.zip|Šablona Template_IconList}} demonstruje náhradu pluginu [[user:skript:ggsiconlist|GgsIconList]] použitím tohoto pluginu a zpracováním SQL dotazu. Oproti [[user:skript:ggsiconlist|GgsIconList]] je zde ale možné výstup modifikovat (každý  podle své potřeby), na příklad podbarvit keše, který mají nastaven nějaký TAG nebo třeba mají terén 5, doplnit k ikoně rámeček u keší s obtížností 5 a podobně.
+{{:user:skript:ggsexpr:template_iconlistcolor.zip|Šablona Template_IconListColor}} vznikla úpravou předchozí. Šablona podbarvzuje barevně xFT (z Tagu FTF), keše s terénem 5 a roky nálezu. Kolem keší s obtížností 5 dělá rámeček. Pokud je otagováno skriptem [[user:skript:svetlotma|SvetloTma]], tak navíc zvýrazní nálezy za tmy tmavší barvou.
+Dále je upraven seznam ikon tak, aby klikání na ikony bylo funkční i když je statistika nahraná přímo na profilu v geocaching.com. Šablonu upravil **[[http://www.geocaching.cz/profile.php?lookup=42795|pehan]]**.
+{{:user:skript:ggsexpr:ggsexpr_iconlist.jpg|ukázka z šablony Template_IconList}} {{:user:skript:ggsexpr:template_iconlistcolor.jpg|ukázka z šablony Template_IconListColor}}
+==== Graf nálezů na vlastní keši ====
+Autor: **[[http://www.geocaching.com/profile/?u=kiReGPS|kiReGPS]]**, Diskuze: [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=21613|geocaching.cz]]
+{{:user:skript:ggsexpr:template_myowncachegraph.zip|Šablona}} vytváří do statistiky graf četnosti nálezů na vybrané vlastní keši po měsících od jejího založení. Ukazuje použití [[http://code.google.com/intl/cs-CZ/apis/chart/image/|Google Image Chart API]] pro vytvoření vlastního grafu z dat získaných pomocí SQL dotazů z databáze **GeoGetu**. Google Chart API je využíváno [[user:skript:ggstat|GgStatem]] pro sloupcové a koláčové grafy. Šablona demonstruje celou řadu technik - přípravu hodnot datových řad do dočasné tabulky, nastavení měřítek a popisů os a sestavení výsledného grafu. Najdeme tu i přebírání definic barevného schématu a šířky statistiky z [[user:skript:ggstat|GgStatu]] do šablony **GgsExpr**. Kromě grafu vypisuje šablona i některé statistické informace o nálezech - celkové, maximální měsíční a maximální roční počty. Parametrem šablony je kód keše, nastavený v proměnné ''%MyCacheID%''. Použití tedy bude pomocí následujících příkazů v Template souboru:
+<code bash>
+SETVAR MyCacheID GCxxxxx
+INCLUDE_TEMPLATE .\script\GgStat\Template_MyOwnCacheGraph.cfg
+</code>
+Šablona automaticky nastavuje měřítko i krok popisů na svislé ose. Pokud by krok nevyhovoval, lze ho nastavit ručně parametrem AxFoundStep. Příkazy jsou pak následující:
+<code bash>
+SETVAR AxFoundStep 10
+SETVAR MyCacheID GCxxxxx
+INCLUDE_TEMPLATE .\script\GgStat\Template_MyOwnCacheGraph.cfg
+</code>
+Přímo v textu šablony lze ještě nastavit některé další parametry (výška grafu, barva DNF, krok popisu měsíců, průhlednost sloupců), většina nastavení je však přebíraná z [[user:skript:ggstat|GgStatu]].
+Ukázka vytvořeného grafu:
+{{:user:skript:ggsexpr:myowncachegraph.png|Graf nálezů na vlastní keši během jejího života}}
+==== Čísla a graf FTF nálezů ====
+Autor: **[[http://www.geocaching.com/profile/?u=kiReGPS|kiReGPS]]**, Diskuze: [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=21654|geocaching.cz]]
+{{:user:skript:ggsexpr:template_myftfgraph.zip|Šablona grafu}} vloží graf FTF lovů po letech s vyčíslením FTF indexu. Barevné definice se přebírají z hlavní šablony [[user:skript:ggstat|GgStatu]]. Další parametry jsou uvnitř šablony (rozměry grafu, počet zobrazených let, šířky sloupců a kroky na svislých osách). Graf do statistiky zařadíme klasicky:
+<code bash>
+INCLUDE_TEMPLATE .\script\GgStat\Template_MyFTFGraph.cfg
+</code>
+Krok značek a popisů na svislých osách lze zvnějšku šablony určit obsahem proměnných ''AxFoundStep'', ''AxIndexStep:''
+<code bash>
+SETVAR AxFoundStep 100
+SETVAR AxIndexStep 1
+INCLUDE_TEMPLATE .\script\GgStat\Template_MyFTFGraph.cfg
+</code>
+Ukázka vytvořeného grafu:
+{{:user:skript:ggsexpr:myftfgraph.png|Graf FTF nálezů a indexů}}
+{{:user:skript:ggsexpr:template_myftfnumbers.zip|Šablona výpočtu}} a {{:user:skript:ggsexpr:template_myftfnumberstable.zip|Šablona tabulky čísel}} počítají a zobrazují čísla o FTF, STF a TTF lovech. Rozdělení na dvě části je z důvodu, že čísla lze používat i v textu. Já volám výpočet na začátku a tabulku vkládám až do sekce FTF.
+Do hlavní šablony statistiky zařadíme obě části pomocí:
+<code bash>
+INCLUDE_TEMPLATE .\script\GgStat\Template_MyFTFNumbers.cfg
+INCLUDE_TEMPLATE .\script\GgStat\Template_MyFTFNumbersTable.cfg
+</code>
+Šablona výpočtu nastavuje následující proměnné, které lze použít kamkoliv do textu:
+  * **%MyFTFCount%** - celkový počet FTF nálezů
+  * **%MySTFCount%** - celkový počet STF nálezů
+  * **%MyTTFCount%** - celkový počet TTF nálezů
+  * **%FTFIndex%** - celkový FTF index
+  * **%FTFInterval%** - průměrný interval mezi FTF nálezy v kalendářních dnech
+  * **%FTFIntervalCachingDays%** - průměrný interval mezi FTF nálezy v kešovacích dnech
+  * **%NextFTFMilestone%** - příští stovkový FTF milník
+  * **%NextFTFMilestoneDate%** - očekávané datum příštího stovkového FTF milníku
+  * **%NextFTFMilestoneWeekDay%** - den v týdnu očekávaného data FTF milníku
+  * **%BestFTFNum1%** - nejvyšší počet FTF za den
+  * **%BestFTFDay1%** - datum, kdy byl dosažen
+  * **%BestFTFNum2%** - druhý nejvyšší počet FTF za den
+  * **%BestFTFDay2%** - datum, kdy byl dosažen
+  * **%BestFTFNum3%** - třetí nejvyšší počet FTF za den
+  * **%BestFTFDay3%** - datum, kdy byl dosažen
+  * **%BestFTFMonthNum%** - nejvyšší počet FTF za měsíc
+  * **%BestFTFMonth%** - měsíc, kdy byl dosažen
+  * **%BestFTFYearNum%** - nejvyšší počet FTF za rok
+  * **%BestFTFYear%** - rok, kdy byl dosažen
+==== Příští milníky ====
+Autor: **[[http://www.geocaching.com/profile/?u=kiReGPS|kiReGPS]]**
+{{:user:skript:ggsexpr:template_nextmilestones.zip|Šablona Template_NextMilestones}} vypočítá příští stovkový a tisicovkový milník a odhadne jejich termín včetně dne v týdnu. Zároveň se počítají i odhady odlovů do konce aktuálního roku. Šablona nastavuje dále uvedené proměnné, které pak použijeme kamkoliv do textu profilu:
+  * **%NextMilestone%** - číslo příštího stovkového milníku
+  * **%NextBigMilestone%** - číslo příštího tisícovkového milníku
+  * **%NextMilestonDays%** - počet kalendářních dní do stovkového milníku
+  * **%NextBigMilestonDays%** - počet kalendářních dní do tisícovkového milníku
+  * **%NextMilestonCachingDays%** - počet kešovacích dní do stovkového milníku
+  * **%NextBigMilestonCachingDays%** - počet kešovacích dní do tisícovkového milníku
+  * **%DaysToEndOfYear%** - počet dní do konce roku
+  * **%CachesToEndOfYear%** - odhad počtu odlovů do konce roku
+  * **%TotalCachesOnEndOfYear%** - odhad celkového počtu odlovených keší na konci roku
+  * **%CurrDate%** - aktuální datum ve formátu d.m.rrrr
+  * **%CurrDateTime%** - aktuální datum a čas
+  * **%CurrDateWeekDay%** - aktuální den v týdnu
+  * **%NextMilestoneDate%** - datum příštího stovkového milníku
+  * **%NextMilestoneWeekDay%** - den v týdnu příštího stovkového milníku
+  * **%NextBigMilestoneDate%** - datum příštího tisícovkového milníku
+  * **%NextBigMilestoneWeekDay%** - den v týdnu příštího tisícovkového milníku
+Šablona sama **nic nezobrazuje**. Jen počítá a nastavuje proměnné. Kromě textů je možné hodnoty odhadů příštích milníků přidat i do tabulky SomeNumbers. Třeba takto:
+<code>
+LANG_NUMBERS_NextMilestoneLabel Příští milník:
+LANG_NUMBERS_NextMilestoneText Příští kulaté pořadové číslo keše je <b>%NextMilestone%</b>. Dosáhneme ho někdy kolem %NextMilestoneWeekDay% <b>%NextMilestoneDate%</b>, tedy za <b>%NextMilestonDays%</b> kalendářních dní (<b>%NextMilestonCachingDays%</b> kešovacích dní).
+DEFINENUMBERS NumbersMyNextMilestone NextMilestoneLabel NextMilestoneText
+APPEND_NUMBERS NumbersMyNextMilestone
+SomeNumbers Zajímavá čísla
+</code>
+<box round 100% #DEE7EC>
+:!: Upozorňuji, že dny v týdnu u milníků jsou v šabloně vyskloňované, jak jsem v textu potřeboval. Ale to si jistě poštelujete sami...
+</box>
+==== Bodování mdCachingPoints ====
+Autor: **[[http://www.geocaching.com/profile/?u=kiReGPS|kiReGPS]]**, Diskuze: [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=23655&pid=369144#post_369144|geocaching.cz]]
+{{:user:skript:ggsexpr:template_mdcachingpoints.zip|Šablona Template_mdCachingPoints}} vypočítá vážené body za ulovené keše podle [[http://www.macdefender.org/products/GCStatistic/mdCachingPoints.html|www.macdefender.org]]. Pro každou nalezenou kešku se násobí obtížnost krát terén krát koeficient podle typu keše a vše se hezky sečte. Šablona nastavuje proměnnou, kterou pak použijeme kamkoliv do textu profilu nebo do SomeNumbers:
+  * **%mdCachingPoints%** - počet bodů
+==== Zobrazení seznamu D/T kombinací s první nalezenou keší dané kombinace ====
+Autor: **[[http://www.geocaching.com/profile/?u=-PaD-|-PaD-]]**
+{{:user:skript:ggsexpr:template_dtc_combinations.zip|Šablona Template_DTC_Combinations}} zobrazuje seznam podobný seznamu generovanému službou [[http://www.mygeocachingprofile.com/|My Geocaching Profile]].
+{{ :user:skript:ggsexpr:ggsexpr_tabdt.png |Ukázka části tabulky}}
+==== Mapy městských částí Ostravy a Brna ====
+Autor: **[[http://www.geocaching.com/profile/?u=kiReGPS|kiReGPS]]** Diskuze: [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=14225&pid=397573#post_397573|geocaching.cz]]
+<box round 100% #DEE7EC>
+Než mi MaFa na fóru vysvětlil, že [[GgStat]] už je dávno připraven na nově vznikající mapy regionů a městských částí, stačil jsem prozkoumat jednu slepou uličku vývoje. Berte prosím tuto šablonu jen jako ukázku, jak lze pracovat s generátorem map. A taky jako ukázku, že je lepší pořádně číst dokumentaci.
+</box>
+<box round 100% #DEE7EC>
+:!: Pro správnou funkci šablon je třeba aktualizovat GgsExpr na verzi **1.3.12**
+</box>
+Šablony pro {{user:skript:ggsexpr:template_mymapofostravaandbrno.zip|mapu Ostravy a Brna}} generují mapy městských částí pomocí generátoru na [[http://www.geocaching.cz/ggstat/manual.html|geocaching.cz]]. Šablony umístíme klasicky do adresáře [[GgStat]]u a do hlavní šablony statistik doplníme něco jako:
+<code bash>
+HEADER Mapa městských obvodů Ostravy
+INCLUDE_TEMPLATE .\script\GgStat\Template_MyMapOfOstrava.cfg
+</code>
+<code bash>
+HEADER Mapa městských částí Brna
+INCLUDE_TEMPLATE .\script\GgStat\Template_MyMapOfBrno.cfg
+</code>
+Uvnitř template můžete parametry ovlivnit velikost mapy a popisky s počty a/nebo procenty.
+{{user:skript:ggsexpr:generator_mapy-ostrava.png?nolink |}}
+==== Nejlepší dny ====
+Autor: **[[http://www.geocaching.com/profile/?u=kiReGPS|kiReGPS]]** Diskuze: [[http://www.geocaching.cz/forum/viewthread.php?forum_id=7&thread_id=26892&pid=435356#post_435356|geocaching.cz]]
+U příležitosti GPS Maze narychlo (a trochu jako labutí píseň) zveřejňuji {{user:skript:ggsexpr:template_mybestdays.zip|šablonu pro generování tabulky nejlepších dní}}. Vypisuje do tabulky dny s nejvyšším počtem nálezů, s nejvyšším počtem odlovených typů keší a s největším počtem FTF. Jsou uvedeny i ikony ulovených keší s odkazy. Vložte na požadované místo pomocí:
+<code bash>
+HEADER Nejlepší dny
+INCLUDE_TEMPLATE .\script\GgStat\Template_MyBestDays.cfg
+</code>
+==== Přehled dalších šablon ====
+{{topic>ggsexpr_template}}
+===== Instalace =====
+Instalace vlastního pluginu je automatická, šablony je třeba stáhnout samostatně v ***.zip** souboru, rozbalit nejlépe do adresáře s GgStat a doplnit potřebné příkazy pro vyvolání šablony (viz příklad výše).
+===== Stažení =====
+<box round 95% #DEE7EC>
+:!: Stáhnout aktuální verzi: ~~DOWNLOAD ggsexpr-*.gip highest~~
+</box>
+==== Zvýraznění syntaxe ====
+  * Pro program [[http://pspad.cz|PSPad]] je dostupné zvýraznění syntaxe pro GgStat a GgsExpr. Více [[user:skripty:pspad|zde]].
+==== Seznam dostupných verzí ====
+{{filelist>ggsexpr:*.[gz]ip&style=table&tableheader=1&tableshowdate=1&sort=name}}
+===== Seznam změn =====
+===  1.3.12 (1.2.2013)===
+  * oprava chybného zpracování SQL příkazů, pokud obsahují češtinu
+===  1.3.11 (15.3.2012) (pocet stazeni 1309)===
+  * oprava chybného zpracování příkazů, pokud bylo v jedné šaploně více bloků SQLSTART
+  * doplnění modulu pro výpočty s datem/časem
+===  1.3.10 (31.1.2012) (počet stažení 392)===
+  * do dokumentace doplněn popis sdílení proměnných s Template GgStatu a jejich použití v šabloně GgsExpr
+===  1.3.9 (6.6.2011) (počet stažení 1379)===
+  * další krok k úplnému zpracování českých znaků - tentokrát nicky
+  * drobné úpravy ladicích výpisů (příkaz DEBUG)
+===  1.3.8 (27.5.2011) (počet stažení 731) ===
+  * cesta a jméno databáze je z GgStatu předavána v INCODING
+  * doplněna promenná GSS_DB obsahuje vždy aktuální datábazi tak, jak byla zadaná příkazem DB
+  * zpracování rozšířeného příkazu 'DB [kodovani] databaze'
+  * automatické zjišťování kódové stránky systému, konzole z registru, aby byla existence souboru databáze kontrolovaná ve správném kódování
+===  1.3.7 (19.4.2011) (počet stažení 610) ===
+  * změna kontroly existence databázového souboru s českými znaky
+<hidden onHidden=":!: **Zobrazit změny ve starších verzích**" onVisible="Skrýt změny ve starších verzích">
+=== 1.3.6 (počet stažení 561) ===
+  * doplněn příkaz SETVARDEFAULT pro nastavení proměnné, pokud dosud není definovaná
+=== 1.2.5 9 (počet stažení 779) ===
+  * doplněn příkaz DB pro změnu pracovní databáze, šablony tak mohou pracovat s více databázemi
+=== 1.2.4 ===
+  * první verze podporující automatickou instalaci
+  * v příkazu SQL_SQL lze používat lokální proměnné
+=== 1.2.3 (2010/08/31) ===
+  * pro nahrazovani promennych se pracuje i s viceradkovymi stringy
+=== 1.2.2 (2010/08/11) ===
+  * novy prikaz SQL_CMD_CONTINUE umoznuje rozdelit dlouhy prikaz na vice radku
+  * novy parametr ERRORMISSINGVARIABLE umoznuje pouzit promennou GgStatu ve vystupu z pluginu
+=== 1.2.1 (2010/07/31) ===
+  * prejmenovani na GgsExpr, protoze uz nepracuje jen s TAGy
+  * zpracovani SQL prikazu
+  * prikaz EVAL umoznuje i zpracovani podmineneho prikazu ve zjednodusene perlovske forme: return((x>y)? x:y)
+  * prikaz OUTVALUETYPE NUM/ASCII (implicitni NUM)
+=== 1.1.3 (2010/06/22) ===
+  * oprava zpracovani vnitrnich promennych s hodnotou 0
+  * oprava zpracovani operatoru LIKE
+  * oprava zpracovani kategorie tagu a hodnoty, pokud obsahuji mezeru
+</hidden>
+{{tag>skript ggstat ggstat_plugin statistiky ggsexpr_template}}