ocactivity-gen 0.0.0__py3-none-any.whl

ocactivity_gen-0.0.0.dist-info/METADATA

@@ -0,0 +1,272 @@
+Metadata-Version: 2.4
+Name: ocactivity-gen
+Version: 0.0.0
+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,garmin,fit,gpx,sport,activity,generator,gen,image
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+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** 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 nebo jiné společně s výškovým profilem a statistikami.
+
+Testováno na Garmin FIT souborech z hodinek, ale mělo by to fungovat i od jiných. Jen pozor na to, že ne každý FIT soubor obsahuje všechny informace. Takže výsledek se může lišit.
+
+V případě vlastní implementace jde hodně věcí přizpůsobit na míru, ale ve výchozím nastavení jsou obrázky vždy 1440x1440 a mají levý zatmavený panel kam se vkládají statistiky.
+
+---
+
+## 💪 Ukázky výstupu
+<p align="center">
+  <img src="output/simple.jpg" alt="Výstup" width="45%">
+  <img src="output/full.jpg" alt="Výstup" width="45%">
+</p>
+
+---
+
+## 🛠️ 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 se zvýrazněním nejnižšího a nejvyššího bodu.
+- **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 nahradit mapu vlastním obrázkem 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 do JPG nebo PNG.
+- **Vlastní aktivita:** Možnost vytvoření úplně nové aktivity podle vstupních parametrů (bez trasy, ta vyžaduje min. GPX na vstupu).
+
+---
+
+## 📦 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 pro OSM (výchozí).
+```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
+Zde jsou nejčastější parametry. Pro více parametrů je potřeba se podívat do `-h` help.
+
+| Parametr | Popis |
+| :--- | :--- |
+| -file | Cesta k FIT nebo GPX souboru. |
+| -bg | Cesta k obrázku, která bude na pozadí místo mapy. |
+| -name | Název nebo popis aktivity. |
+| -type | Typ aktivity (např. "Chůze", "Běh", "Turistika", ...). |
+| -distance | Vzdálenost v metrech. |
+| -avgspeed | Průměrná rychlost v km/h (např. 7.5). |
+| -maxspeed | Maximální rychlost v km/h. |
+| -pace | Tempo v min/km (např. "4:30"). Musí být text, jinak se to bere jako m/s. |
+| -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 aktivity 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ý (asi 25%) černobílý 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í obrázku. Může být jen adresář nebo i celá cesta včetně názvu. |
+| -mapurl | URL adresa pro mapové podklady. Výchozí je na OSM. |
+| -mapcache | Název cache adresáře, do kterého se budou ukládat mapové dlaždice. Pokud se změní URL, tak změnit i toto nebo prvně smazat cache. |
+| -ccache | Smaže mapové podklady z cache. |
+
+---
+
+## 🐍 Použití v kódu (pro vývojáře)
+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 (ZDE není potřeba)
+    gpx=GPXConfig(),
+    # Konfigurace grafu převýšení (pouze pro FIT a ZDE též není potřeba)
+    elevation=ElevationGraphConfig(),
+    # 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"),
+        # Ikonka pro typ
+        "custom_activity_type_marker": create_element(
+            "🎯",
+            is_absolute=True,
+            take_pos_y_from_prev_label=True
+        ),
+        # Vzdálenost
+        "distance": create_element("Vzdálenost"),
+        # Ikonka pro vzdálenost
+        "custom_distance_marker": create_element(
+            "📍",
+            is_absolute=True,
+            take_pos_y_from_prev_label=True
+        ),
+        # Čas pohybu
+        "moving_time": create_element("Čas"),
+        # Ikonka pro čas pohybu
+        "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.
+- Celý objekt s metrikami se vytvoří z FIT souboru, takže není ho potřeba vytvářet ručně.
+##### 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. Pro ukázku obsahuje více věcí, které lze taky nastavit.
+```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 vyplněno
+    gpx_points_with_elev=fit_data.gpx_points_with_elev,  # Tohle pouze pro FIT, protože GPX nemá převýšení
+    # Pokud se generuje i graf převýšení, tak je dobré použít vlastní viewport, aby trasa nezasahovala do grafu
+    viewport=default_viewport_callback,
+    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-0.0.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+ocactivity_gen-0.0.0.dist-info/licenses/LICENSE,sha256=ewGU6UKUCqOv_fc1OHOlKMTyZw0G-id1xFGIGxvRuy8,1066
+pyactivity/__init__.py,sha256=LjsbyWC6JkMWGSlOrjdyPYbI11Q8ZE7ytv-mvD0W9dU,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-0.0.0.dist-info/METADATA,sha256=7DSriub32X9tk8qlHkwNWqrBZfBwoUuOJLdlh9VQx8Y,11278
+ocactivity_gen-0.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+ocactivity_gen-0.0.0.dist-info/entry_points.txt,sha256=MxtyXCKc0OWDzaOhnV5NfbBsZfefKBRspCkwnWxnxt0,55
+ocactivity_gen-0.0.0.dist-info/top_level.txt,sha256=Vj9gpnlCdoYTYzbU-m50V9l1T5Xf-_vWCQYyZXMhQ7s,11
+ocactivity_gen-0.0.0.dist-info/RECORD,,

ocactivity_gen-0.0.0.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-0.0.0.dist-info/entry_points.txt

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

ocactivity_gen-0.0.0.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-0.0.0.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.8"
+__all__ = [
+    "ActivityGenerator",
+    "ActivityMetrics",
+    "ActivityParser",
+    "ElementStyle",
+    "ElevationGraphConfig",
+    "GPXConfig",
+    "GeneratorConfig",
+    "WatermarkConfig",
+    "can_display",
+    "clean_map_cache",
+    "cli_main",
+    "create_element",
+    "default_viewport_callback",
+    "format_activity_type",
+]