Differences

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

--- user:skript:svetlotma [2010/10/31 17:38] – mikrom
+++ user:skript:svetlotma [2023/08/16 20:25] (current) – [Seznam změn] gord
@@ Line 1: / Line 1: @@
 ====== SvetloTma ======
-Skript slouží k nastavení TAGu u nalezených keší v databázi GeoGetu na hodnotu Svetlo nebo Tma podle data, času a zeměpisné polohy nálezu.
+Skript slouží k nastavení TAGu u nalezených keší v databázi GeoGetu na hodnotu ''Svetlo'' nebo ''Tma'' podle data, času a zeměpisné polohy nálezu.
 ===== Autor =====
@@ Line 6: / Line 6: @@
 ===== Automatická instalace =====
-/* Povinná sekce */
 ~~GEOGET_INSTALL~~
 ===== Diskuze =====
-/* V případě potřeby je možno tuto sekci vymazat a neuvádět ji. */
   * Zatím neexistuje k tomuto pluginu samostatné diskusní vlákno. Nějaké střípky jsou třeba [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=13234&pid=198775#post_198775|Geocaching.cz]].
   * [[http://www.geocaching.cz/forum/viewthread.php?forum_id=20&thread_id=15006&sort=&rowstart=0|vlákno pro samostatný]] vizualizační skript (používá již nastavený TAG)
 ===== Popis =====
-Plugin se skládá ze dvou částí. Skript pro GeoGet nastavuje TAGy na hodnoty, které mu vypočítá přiložený program.
+Plugin podle polohy keše vypočte čas občanského soumraku v lokálním čase a nastaví TAG keší na hodnoty ''Svetlo'' nebo ''Tma'' podle výsledku výpočtu.
-Skript vezme seznam zbrazených keší a programu předá jejich souřadnice, datum a čas nálezu. Program vypočte čas zapadu a východu slunce, porovná s časem nálezu a podle toho určí, zda keš byla nalezena za světla nebo již ve tmě.
+Plugin pracuje ve dvou režimech v závislosti na tom, zda byl spuštěn přímo nebo z jiného skriptu.
-Výsledek v přehledné tabulce zobrazí skript a uživatel má možnost si hodnoty prohlédnout a nechat zapsat do TAGu.
-Výsledky lze použít třeba pro výpočet počtu nálezů ve statistice v profilu uživatele.
+**Přímé spuštění**
-==== Ukázky ====
+Při standardním nastavení plugin zpracuje všechny keše, kterou jsou zobrazeny v seznamu keší GeoGetu, vypočte čas občanského soumraku a porovná jej s časem nálezu. Výsledek zobrazí. Uživatel má možnost vypočtené hodnoty uložit do tagu pomocí tlačítka formuláře.
+**Spuštění z jiného skriptu**
+Při standardním nastavení plugin zpracuje všechny nalezené keše, které nemají nastaven tag ''SvetloTma'', vypočte pro ně čas občanského soumraku, porovná jej s časem nálezu a výsledek uloží do tagu.
+**Poznámky:**
+  * pokud některé zpracovávané keše nemají čas nálezu nebo čas má hodnotu 00:00, výpočet se pro ně neprovádí
+===== Vizualizační skript =====
+Součástí instalace je od verze 2.2.6 také vizualizační skript. Pokud do konfigurace sloupců doplníte sloupec s tagem ''SvetloTma'' a na [[user:navody:tagy?&#pouziti_tagu|něj aplikujete]]  instalovaný vizualizační skript, můžete vidět např. toto:
+{{ :user:skript:svetlotma:vizualizace.png |}}
+===== Nastavení =====
+Standardním postupem nastavení pluginu je možné změnit
+  * způsob vybírání keší ke zpracovaní
+    * automatický režim je řízen podle spuštění pluginu
+    * bez ohledu na způsob spuštění zpracovat seznam zobrazených keší
+    * bez ohledu na způsob spuštění zpracovat všechny nalezené keše, které nemají nastaven tag
+  * zobrazení výsledku/ukládání do tagu
+    * podle způsobu spuštění bude výsledek zobrazen nebo rovnou uložen do tagu
+    * bez ohledu na způsob spuštění vždy zobrazit výsledek
+    * bez ohledu na způsob spuštění vždy výsledek rovnou uložit do tagu
+===== Ukázky =====
   * zobrazení výsledku výpočtu v přehledné tabulce s možností zápisu do TAGu
-{{:user:skript:svetlotma:svetlotmavypocet.gif|}}
+{{:user:skript:svetlotma:svetlotma.png|}}
+<hidden onHidden=":!: **Zobrazit ukázku použití v GgStatu**" onVisible="Skrýt ukázku použití v GgStatu">
   * ukázka kódu do template souboru pro doplnění statistiky (pro výpočet hodnot z TAGu je zde použit plugin [[user:skript:ggsexpr|GgsExpr]])
+  * ukázka je pro [[user:skript:ggstat|GgStat]], jehož vývoj a podpora je již ukončena - je nahrazen [[user:skript:stator|Statorem]]
 <code bash SvetloTma_template.cfg>
@@ Line 57: / Line 82: @@
   * výsledek předchozího kódu
 {{:user:skript:svetlotma:svetlotmastatistika.jpg|}}
+Alternativně lze podíl lovů za světla a tmy zobrazit i koláčovým grafem - viz [[:user:navody:statistiky-triky?&#kolacovy_graf_svetlo_tma|triky a vychytávky do statistik]].
+</hidden>
+Ve [[user:skript:stator|Statoru]] používají tagy vytvořené pluginem SvetloTma moduly ''FindsByTime'' a ''FindsInIcons''.
 ===== Poznámky, známé problémy =====
-  * tabulka se zobrazeným výsledkem zobrazuje správně jen omezený počet keší (cca 25), při větším počtu se informace přepisují. Důvodem je chyba v komponentě v knihovně, kterou používá GeoGet. Protože se jedná o cizí knihovnu, nelze si změnu funkčnosti nijak vynutit. Tento problém se ale týká jen zobrazení a do TAGu budou zapsány vždy správné hodnoty
+  * tabulka se zobrazeným výsledkem zobrazuje kromě vypočtených parametrů i položku ''TZ'', která indikuje způsob přepočtu na lokální čas
-  * výpočet předpokládá čas nálezu v místním čase podle zeměpisných souřadnic, nebere v úvahu skutečný průběh hranic časových pásem, ale jen definici časového pásma podle jeho hlavního poledníku. Vzhledem k tomu, že se jedná maximalně o jednu hodinu a procento keší v tomto období a území zřejmě nebude statistiky významné, nestojí to za tu práci. Navíc je možné hodnotu TAGu upravit ručně
+    * hodnota ''Tag'' znamená, že byl použit tag ''timezone'' nastavený u keše, tedy skutečná časová zóna v místě keše
-  * za tmu se pokládá poloha Slunce 6 stupňů pod obzorem, tedy tzv. občanský soumrak. To sice v otevřeném terénu ještě tma není, ale protože keš bývají ukryty, je to, myslím dostačující
+    * hodnota ''PC'' znamená, že byl použit náhradní postup, časová zóna byla vzata z operačního systému a tiše se předpokládá, že obě časové zóny jsou shodné. Protože to samozřejmě nemusí být pravda, je dobré používat plugin [[user:skript:divider|divider]], který časovou zónu pro keš nastavuje
+  * výpočet předpokládá čas nálezu v místním čase
+  * občanský soumrak nastává v okamžiku, kdy je Slunce 6 stupňů pod obzorem (podle laické definice není člověk se zdravým zrakem schopen číst denní tisk). To sice v otevřeném terénu ještě tma není, ale protože keše bývají ukryty, je to snad dostačující
+  * <del>plugin neumí za polárního dne nebo noci určit, zda jde o nález ve tmě nebo za světla a hlásí, že keška není nalezená</del> opraveno v <sup>2.2.7</sup>
 ===== Stažení =====
-/* Povinná sekce */
+<WRAP round download>
-<box round 95% #DEE7EC>
+Stáhnout aktuální verzi: ~~DOWNLOAD svetlotma-*.gip highest~~
-:!: Stáhnout aktuální verzi: ~~DOWNLOAD svetlotma-*.gip highest~~
+</WRAP>
-</box>
 ==== Seznam dostupných verzí ====
-/* Povinná sekce */
 {{filelist>svetlotma:*.[zg]ip&style=table&tableheader=1&tableshowdate=1&sort=mtime}}
 ===== Seznam změn =====
-/* Povinná sekce */
+** 2.2.7 (16.8.2023) **
-=== 1.1.3 (2010/10/04) ===
+  * oprava výpočtu při souřadnicích za polárním kruhem
-   * Úvodní verze
+** 2.2.6 (28.8.2017) **
+  * nový: doplněn vizualizační skript, který byl dřív samostatně (vytvořil Zličíňáci)
+** 2.2.5 (3.2.2016) **
+  * změna: listbox s rolovátkem vpravo místo dole (vypnut Extened style)
+  * změna: přesnější definice casu 00:00 pro vynechání keší z otagování (cas>0.000001 bere ohled na nepřesnosti při uloženi reálných čísel)
+  * změna: zobrazení postupu při zpracování mnoha keší
+  * změna: pokud je zpracována keš bez nálezu, je ve výsledku zobrazena jinou barvou
-/* Pokud je seznam změn již moc dlouhý */
 <hidden onHidden=":!: **Zobrazit změny ve starších verzích**" onVisible="Skrýt změny ve starších verzích">
-=== Předchozí verze ===
+** 2.1.4 (12.2.2014, počet stažení 879) **
-   * Seznam změn v předchozích verzích není dostupný.
+   * zcela přepracováno do nativního ggp, nepoužívá se exe
+** 1.1.3 (2010/10/04, počet stažení 988) **
+   * Úvodní verze
 </hidden>
-{{tag>skript statistiky ggp}}
+{{tag>author_Gord skript statistiky ggp}}