ocactivity-gen 1.0.7__py3-none-any.whl

ocactivity_gen-1.0.7.dist-info/METADATA

@@ -0,0 +1,246 @@
+Metadata-Version: 2.4
+Name: ocactivity-gen
+Version: 1.0.7
+Summary: Nástroj pro generování obrázků aktivity z GPX/FIT nebo dle vlastního zadání.
+Author-email: Jiří Vik <mimic2300@gmail.com>
+License-Expression: MIT
+Project-URL: Repository, https://gitlab.com/OphiteCorp/pyactivity-generator
+Keywords: mimic,ophitecorp,strava,activity,generator,gen,image
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Pillow>=10.4.0
+Requires-Dist: fitparse>=1.2.0
+Requires-Dist: numpy>=2.1.0
+Requires-Dist: rich>=13.9.0
+Dynamic: license-file
+
+# ocactivity-gen 🏃‍♂️🚴‍♀️🏔️
+
+**ocactivity-gen** (`pyactivity`) je Python nástroj a konzolová aplikace pro generování estetických grafických kartogramů a vizualizací sportovních aktivit (běh, chůze, turistika, cyklistika apod.).
+
+Dokáže zpracovat soubory **Garmin FIT** a **GPX**, extrahovat z nich metriky (vzdálenost, čas, tempo, rychlost, stoupání, klesání, tep, teplotu, kalorie, kroky) a vykreslit trasy na mapové podklady z OpenStreetMap/Mapy.com společně s výškovým profilem a statistikami.
+
+---
+
+## 🛠️ Hlavní funkce
+
+- **Podpora Garmin FIT & GPX:** Automatické vytěžování telemetrie, GPS trasy a časových dat.
+- **Inteligentní vyhlazování GPX:** Filtr GPS šumu pomocí 2D Kalmanova filtru.
+- **Rychlá analýza dat:** Adaptivní prahy pohybů a hysterézní filtr převýšení pro přesný výpočet stoupání a času v pohybu.
+- **Generování výškového profilu:** Graf nadmořské výšky.
+- **Flexibilní mapa:** Stahování a kešování mapových dlaždic (OSM / Mapy.com) s automatickým přizpůsobením zoomu.
+- **Dynamic Element Stacking:** Zobrazované statistiky se řadí dynamicky bez mezer i v případě, že některé metriky chybí.
+- **Podpora vlastních fotek:** Možnost překrýt mapu vlastní fotografií na pozadí.
+- **Vodoznak a EXIF metadata:** Vkládání loga/vodoznaku a zápis autorství do EXIF/PNG metadat.
+- **Export obrázku:** Možnost exportovat jak do JPG, tak PNG.
+- **Vlastní aktivita:** Možnost vytvoření úplně nové aktivity podle vstupních parametrů.
+
+---
+
+## 📦 Instalace
+
+Aplikaci lze nainstalovat přímo z PyPI pomocí `pip`:
+
+```bash
+pip install ocactivity-gen
+```
+
+---
+
+## 🚀 Použití z příkazové řádky (CLI)
+Po instalaci je ihned k dispozici příkaz `ocactivity-gen`.
+
+Příklady použití:
+1) Vygenerování obrázku z FIT souboru:
+```bash
+ocactivity-gen -file "aktivity/zavod.fit" -name "Horský Ultra Běh 🏔️"
+```
+
+2) Vygenerování z GPX souboru s vlastní fotkou na pozadí:
+```bash
+ocactivity-gen -file "vylet.gpx" -bg "moje_fotka.jpg" -name "Víkendová procházka" -out "vylet.png"
+```
+
+3) Ruční vytvoření aktivity bez datového souboru:
+```bash
+ocactivity-gen -type "Běh" -distance 10500 -pace "4:45" -avgspeed "12.6" -ascent 250 -time 2980 -name "Ranní desítka"
+```
+
+4) Přepsání načtených hodnot z FIT souboru a skrytí grafu a teploty:
+```bash
+ocactivity-gen -file "zavod.fit" -nograph -avgtemp -999 -name "Závod bez grafu a teploty"
+```
+
+5) Pokud je potřeba použít jiné mapové podklady, třeba mapy.com. Je dobré změnit i cache, aby se nepoužívali staré podklady.
+```bash
+ocactivity-gen -file "activity.fit" -mapcache "mapy" -mapurl "https://api.mapy.cz/v1/maptiles/basic/256/{z}/{x}/{y}?apikey={YOUR_API_KEY}" -name "Nedělní výlet"
+```
+
+6) Více příkladů v help:
+```bash
+ocactivity-gen -h
+```
+
+---
+
+## 🎛️ Přehled parametrů CLI
+`-file` = Cesta k FIT nebo GPX souboru.\
+`-bg` = Cesta k fotce na pozadí.\
+`-name` = Název nebo popis aktivity.\
+`-type` = Typ aktivity (např. "Běh", "Turistika").\
+`-distance` = Vzdálenost v metrech.\
+`-avgspeed` = Průměrná rychlost v km/h.\
+`-maxspeed` = Maximální rychlost v km/h.\
+`-pace` = Tempo v min/km (např. "4:30").\
+`-ascent` = Stoupání v metrech.\
+`-descent` = Klesání v metrech.\
+`-time` = Čas v pohybu v sekundách.\
+`-avghr` = Průměrná tepová frekvence (bpm).\
+`-maxhr` = Maximální tepová frekvence (bpm).\
+`-avgtemp` = Průměrná teplota (°C).\
+`-maxtemp` = Maximální teplota (°C).\
+`-kcal` = Spálené kalorie.\
+`-steps` = Počet kroků.\
+`-cdate` = Datum a čas spuštění aktivity ve formátu YYYY-MM-DD HH:MM:SS.\
+`-fdate` = Datum a čas zastavení aktivity ve formátu YYYY-MM-DD HH:MM:SS.\
+`-elapsedtime` = Celkový čas akvitity v sekundách včetně přestávek.\
+`-idletime` = Součet času odpočinku nebo čekání v sekundách.\
+`-nograph` = Vypne vykreslování grafu převýšení.\
+`-nogpx` = Vypne vykreslování trasy na mapě.\
+`-grayscale` = Použije na pozadí částečný černobilý efekt, aby se snížila intenzita barev.\
+`-kmstep` = Nastaví vzdálenost v kilometrech mezi značkami na trase.\
+`-lang` = Nastaví lokalizaci popisků (CZ, EN).\
+`-out` = Cílová cesta pro uložení výsledku (.jpg / .png).\
+`-mapurl` = URL adresa pro mapové podklady.\
+`-mapcache` = Název cache adresáře do kterého se budou ukládat mapové dlaždice.\
+
+---
+
+## 🐍 Použití v kódu
+Díky modularitě lze knihovnu importovat do vlastního Python skriptu:
+#### A) Podobný styl obrázku, který je generován nativně:
+- Vlastní definice metrik (parametry aktivity).
+```python
+from pyactivity import (
+    ActivityGenerator,
+    ActivityMetrics,
+    ActivityParser,
+    ElementStyle,
+    ElevationGraphConfig,
+    GeneratorConfig,
+    GPXConfig,
+    WatermarkConfig,
+    create_element,
+    default_viewport_callback,
+    format_activity_type,
+)
+
+# Vytvoření metrik
+metrics = ActivityMetrics(
+    name="Nedělní procházka",
+    activity_type="Chůze",
+    distance=12345,  # Metry (12.3 km)
+    moving_time=7173  # Sekundy (1h 59m 33s)
+)
+
+# Sestavení konfigurace a generátoru
+config = GeneratorConfig(
+    # Vlastní konfigurace GPX trasy
+    gpx=GPXConfig(),
+    # Vlastní konfigurace vodoznaku
+    watermark=WatermarkConfig(),
+    # Vykreslení prvků na obrázek
+    # Název klíče musí odpovídat atributu v metrice!
+    # Pokud je potřeba vlastní element, tak musí začínat prefixem: custom_
+    elements={
+        # Název aktivity
+        "name": ElementStyle(
+            is_absolute=True,
+            value_pos=(360, 1180),
+            value_font_size=40,
+            auto_shrink=True,  # Když bude text dlouhý, tak se začne změnšovat
+            value_color=(255, 255, 255, 255)
+        ),
+        # Typ aktivity
+        "activity_type": create_element("Aktivita"),
+        "custom_activity_type_marker": create_element(
+            "🎯",
+            is_absolute=True,
+            take_pos_y_from_prev_label=True
+        ),
+        # Vzdálenost
+        "distance": create_element("Vzdálenost"),
+        "custom_distance_marker": create_element(
+            "📍",
+            is_absolute=True,
+            take_pos_y_from_prev_label=True
+        ),
+        # Čas pohybu
+        "moving_time": create_element("Čas"),
+        "custom_moving_time_marker": create_element(
+            "🕒",
+            is_absolute=True,
+            take_pos_y_from_prev_label=True
+        )
+    }
+)
+
+# Uložení obrázku
+generator = ActivityGenerator(metrics=metrics, config=config)
+generator.save(output_path="vystup.jpg", quality=90)
+```
+#### B) Načtení vlastního FIT souboru:
+- Bude použit stejný kód jako v bodě (A), ale musí se udělat několik úprav.
+##### Přidání mapování typu aktivity:
+Protože FIT soubor má vlastní typy, tak se hodnoty musí přemapovat na vlastní název.
+```python
+ACTIVITY_MAPPING: dict[str | None, str] = {
+    "walk": "Chůze",
+    "walking": "Chůze",
+    "run": "Běh",
+    "running": "Běh"
+}
+```
+##### Načtení FIT souboru a metrik:
+Místo vytvoření vlastních metrik je načteme z FIT souboru.
+```python
+# Načtení FIT souboru a těžba dat
+fit_file = Path("activity.fit")
+fit_data = ActivityParser().parse_fit(fit_file)
+
+# Získání metrik s možností je přepsat
+metrics = fit_data.metrics
+metrics.name = "Název aktivity"  # FIT neobsahuje název
+```
+##### Úprava konfigurace - GeneratorConfig:
+Do `GeneratorConfig` přidáme následující konfiguraci.
+```python
+# Obecná konfigurace
+edge_vignette=False,  # Okraje obrázku nebudou mít gradient
+elevation_graph_enabled=True,  # Vygeneruje graf převýšení
+# Konfigurace GPX trasy
+gpx=GPXConfig(
+    gpx_enabled=True,  # Povolí vykreslení trasy
+    gpx_path=fit_file,  # Může být GPX i FIT
+    gpx_points=fit_data.gpx_points,  # Musí být vždy
+    gpx_points_with_elev=fit_data.gpx_points_with_elev,  # Pouze pro FIT, protože GPX nemá převýšení
+    viewport=default_viewport_callback,  # Pokud se generuje i graf převýšení, tak je dobré použít vlastní viewport
+    show_start_finish=True,  # Vykreslí začátek a konec trasy
+    show_km_markers=True  # Vykreslí kilometrové značky na trase
+),
+# Konfigurace grafu převýšení (pouze pro FIT)
+elevation=ElevationGraphConfig(
+    show_bubble_interval=True,  # Značky každých N-km
+    show_bubble_extreme=True  # Značka na nejvyšším a nejnižším místě
+),
+```
+##### Úprava activity_type v elements:
+Aby bylo možné použít vlastní mapování pro typ aktivity, tak musíme přidat mapper.
+```python
+"activity_type": create_element(
+    "Aktivita",
+    formatter=lambda _cfg, _met, val: format_activity_type(val, ACTIVITY_MAPPING),
+),
+```
+Celkové toho nastavení je mnoho. Tady je použit pouze nutný výčet a nějaké nice-to-have. Často je možné nastavit vše, od pozice, barvy, různých hodnot. Stačí projít konfigurační objekty.

ocactivity_gen-1.0.7.dist-info/RECORD

@@ -0,0 +1,24 @@
+ocactivity_gen-1.0.7.dist-info/licenses/LICENSE,sha256=ewGU6UKUCqOv_fc1OHOlKMTyZw0G-id1xFGIGxvRuy8,1066
+pyactivity/__init__.py,sha256=OsmNmw51IkgsGbEGXmP44MU33ak618a2o7O9Ceydb_U,754
+pyactivity/activity_generator.py,sha256=k3rgijagkIsciz-R1CYZUZL5LCLdzggWmIXhU6b5HtM,120917
+pyactivity/cli.py,sha256=guDn4H2FElGBvNpIjAgfAZBORAlsxL0D7tGS-ybuUvI,114
+pyactivity/default_template.py,sha256=uxQN4xx02rKw2Hk1qVazmjNy1SEGoOh1qR673hcQlJk,37843
+pyactivity/fonts/DejaVuSans.ttf,sha256=faGVp0xVvvmI0NSPlQi9XYSUJcF3Dbpde_xs6e2EiVQ,757076
+pyactivity/fonts/NotoColorEmoji.ttf,sha256=f7OXOKsY8QYS1vRZXi6OR6Cv3zRzhGBELZnNDDRKTZA,25111640
+pyactivity/fonts/NotoSansSymbols-Regular.ttf,sha256=rt7sHNBRSTCu6vxKiKbe_4PNoea1gIbwubucfdAVdXg,185152
+pyactivity/fonts/Oxanium-Regular.ttf,sha256=fDASR0eg8tpvyvecRoOZ5CebnbnVBxgjyiSya2PtxyA,29468
+pyactivity/fonts/arial.ttf,sha256=ybdiIKW-QurUczYR5BfNZcX9iuqjPrVldqw3ijfRMKE,1036584
+pyactivity/fonts/seguiemj.ttf,sha256=fAJE3Y7rfGvezfw_nlmDNSf8GKZtApXORzOQaWkqK08,2072388
+pyactivity/fonts/seguisb.ttf,sha256=mFMoNGa9Q5k7mBMhUoH7nHCQy9jptUU_bQ0EBiLhF-I,971080
+pyactivity/fonts/seguisym.ttf,sha256=0vgyajVEVtk-eLBTfFh5PnByw2F699nuGH8Q1tWV9RA,2454728
+pyactivity/fonts/toxigenesis_bd.ttf,sha256=qW14Wm8KzUgBBGOg5KnLM5WgDCk3W5FeGaqLiQzI3Nw,150444
+pyactivity/modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyactivity/modules/elevation_graph.py,sha256=mIToZ7QRSEpvhL2MT6qvoE3wYPfbuLXNsU9Wyv9XDf4,27627
+pyactivity/modules/file_analyzer.py,sha256=TjDCgeiUnM4wcRBnL7UakUvqVISSesBuzJjpvDMGJGQ,25187
+pyactivity/static/background.jpg,sha256=xIH5Rghp_EPUboBh999wkMsZvmYZY6G1Av-_2mrcRR0,251632
+pyactivity/static/watermark.png,sha256=kp2rJ3hXpgwtMC1vmwwpyrNgecstArMvxRUdxuwFYvg,102529
+ocactivity_gen-1.0.7.dist-info/METADATA,sha256=h_1yAgElMuRtYhXHEeAQLV1-XoxdLv00Wl1FZ2tgqzU,9543
+ocactivity_gen-1.0.7.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+ocactivity_gen-1.0.7.dist-info/entry_points.txt,sha256=MxtyXCKc0OWDzaOhnV5NfbBsZfefKBRspCkwnWxnxt0,55
+ocactivity_gen-1.0.7.dist-info/top_level.txt,sha256=Vj9gpnlCdoYTYzbU-m50V9l1T5Xf-_vWCQYyZXMhQ7s,11
+ocactivity_gen-1.0.7.dist-info/RECORD,,

ocactivity_gen-1.0.7.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ocactivity_gen-1.0.7.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ocactivity-gen = pyactivity.cli:main

ocactivity_gen-1.0.7.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jiří Vik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ocactivity_gen-1.0.7.dist-info/top_level.txt

@@ -0,0 +1 @@
+pyactivity

pyactivity/__init__.py

@@ -0,0 +1,34 @@
+from .activity_generator import (
+    ActivityGenerator,
+    ActivityMetrics,
+    ActivityParser,
+    ElementStyle,
+    GeneratorConfig,
+    GPXConfig,
+    WatermarkConfig,
+    can_display,
+    clean_map_cache,
+    create_element,
+    default_viewport_callback,
+    format_activity_type,
+)
+from .default_template import main as cli_main
+from .modules.elevation_graph import ElevationGraphConfig
+
+__version__ = "1.0.7"
+__all__ = [
+    "ActivityGenerator",
+    "ActivityMetrics",
+    "ActivityParser",
+    "ElementStyle",
+    "ElevationGraphConfig",
+    "GPXConfig",
+    "GeneratorConfig",
+    "WatermarkConfig",
+    "can_display",
+    "clean_map_cache",
+    "cli_main",
+    "create_element",
+    "default_viewport_callback",
+    "format_activity_type",
+]