A szenzor saját alkalmazásában részletes görbét látsz, az edzés másik naplóba töltése után viszont eltűnik ez a mutató. A táv, a tempó és a pulzus megmarad, ezért az import látszólag sikerült. Könnyű arra következtetni, hogy a mérés nem került bele a fájlba, vagy a másik szolgáltatás törölte. Valójában több eltérő ponton szakadhat meg az adat útja.
A FIT-formátum egyedi, fejlesztő által hozzáadott mezőket is hordozhat. Ezek megőrzése, felismerése és grafikonként való megjelenítése azonban három külön képesség. Ebben a cikkben egy elképzelt futószenzor adatait követjük végig, hogy világos legyen, mit kell kérdezni az exportálótól és a fogadó naplótól. A cél nem programozói kézikönyv, hanem egy használható ellenőrzési módszer ahhoz, amikor egy érték a rendszerek között láthatatlanná válik.
A szabványos mezőlista mellett egyedi adat is elfér
A Garmin Developer Data Fields hivatalos útmutatója szerint a FIT 2.0 lehetővé teszi, hogy meglévő üzenetekhez önleíró egyedi mezők kerüljenek. A Connect IQ alkalmazások és adatmezők is használják ezt a lehetőséget. Így egy új mutató tárolásához nem feltétlenül kell megvárni, amíg az a közös, előre ismert mezőlistába bekerül. A bővíthetőség ugyanakkor nem azonos minden napló teljes körű támogatásával.
Saját kitalált példánkban egy szenzor az alapadatok mellett „talajrezgés-jelző” nevű, saját mértékegységű mutatót készít. Ez nem egy létező termék vagy hitelesített egészségügyi mérőszám. Azért választunk ilyen semleges példát, hogy a fájl útját vizsgáljuk, ne egy konkrét algoritmus értelmét. A mutató tárolható egyedi mezőként, miközben a fogadó alkalmazás csak a megszokott táv- és pulzusgörbéket rajzolja ki.
A felhasználó ebből csak annyit lát, hogy az egyik grafikon hiányzik. Nem látható közvetlenül, hogy az adat a fájlból is hiányzik-e, a beolvasásnál maradt figyelmen kívül, vagy egyszerűen nincs hozzá felület. A helyes hibakérdés ezért így kezdődik: a konkrét mező melyik lépésig jutott el? A grafikon hiánya önmagában még nem ad választ erre.
Név, egység és azonosító együtt írja le a mezőt
A hivatalos fejlesztői útmutató a forrás azonosítását Developer Data Id, a mező típusának, nevének és egységének leírását Field Description üzenettel mutatja be. A fejlesztői index és a mező definíciós száma együtt kapcsolja a jelentést az értékhez. Ez azért fontos, mert ugyanaz a rövid mezőszám különböző forrásoknál mást jelenthet. A puszta szám vagy a barátságos képernyőnév nem teljes azonosítás.
Saját példánkban az A alkalmazás 0-s mezője egy időt jelöl ezredmásodpercben, a B alkalmazás 0-s mezője egy dimenzió nélküli saját pontszámot. A két nullás mezőszám nem teszi azonossá az adatot. Ha egy exportáló csak „field_0” néven írja ki őket, az olvasó elveszíthet fontos támpontot. A forrás és az egység megőrzése akkor is szükséges, ha a számok nagyságrendje véletlenül hasonló.
A címke módosulása és a mutató megváltozása sem ugyanaz. Egy alkalmazás átnevezhet egy mezőt, vagy más nyelven jelenítheti meg, miközben az azonosított adat tartalma változatlan marad. Fordítva is történhet: ugyanaz a rövid név később más számítási verziót takarhat. A pontos összehasonlításhoz ezért a forrásalkalmazás és a verzió feljegyzése is értékes, különösen hosszabb edzésnaplónál.
A beolvasás sikeressége még nem jelent minden mező megjelenítését
A FIT-protokoll hivatalos leírása a megfelelően definiált, de a feldolgozó számára nem ismert adatok figyelmen kívül hagyását is tárgyalja. A fogadó a támogatott mezőket feldolgozhatja, a többit nem feltétlenül adja tovább a saját nézeteinek. Ez a kiterjeszthető formátum egyik működési helyzete. Nem kell minden új mutató miatt az egész futás importjának sikertelenné válnia.
Saját adatútunkban az eredeti fájl száz időponthoz tartalmazza az egyedi jelzőt. A fogadó hibamentesen kiolvassa a fájlt, az alapadatokat eltárolja, de a saját adatbázisa nem rendelkezik ehhez a mezőhöz helylyel. Másik lehetséges fogadó eltárolja a mezőt is, csak nincs hozzá grafikon. A felhasználói képernyő mindkét esetben azonosnak tűnhet, miközben a későbbi visszanyerés lehetősége eltér.
A kérdés ezért nem csak az, hogy „támogatja-e a FIT-et” az alkalmazás. Érdemes külön megkérdezni, beolvassa-e az egyedi mezőket, megőrzi-e őket az eredeti fájlban vagy saját adatbázisban, és visszaadja-e exportáláskor. A megjelenítés egy további lépés. Egy igen válasz a formátum általános támogatására nem bizonyítja automatikusan mind a négy képességet.
Kép nagyításaA régi dekóder nem mindig egyszerűen kihagyja az újdonságot
A Developer Data útmutató külön jelzi, hogy a FIT 2.0 egyedi mezőinek bevezetése protokollszintű változással járt. A korábbi, ezt nem ismerő SDK-k az ilyen fájlok beolvasásakor hibába is ütközhetnek. Ez külön eset a támogatott protokollon belül ismeretlen mező csendes figyelmen kívül hagyásához képest. A „régi program majd legfeljebb nem rajzolja ki” feltételezés ezért nem mindig helyes.
Saját ellenőrzési helyzetünkben az egyik program már a fájl megnyitását visszautasítja, a másik teljes futást rajzol, de egyetlen görbe hiányzik. Az elsőnél fájlformátum- vagy protokollkezelési kérdést, a másodiknál mezőmegőrzési és felületi támogatási kérdést kell tisztázni. Az azonosnak látszó „nem működik az export” panasz valójában más pontokra utalhat. A hiba pontos leírása ezért sok munkát takaríthat meg.
A kézi átalakítás előtt a konkrét feldolgozó naprakész dokumentációját és támogatott verzióját nézd meg. Egy újabb dekóder képes lehet olyan mezőt kiolvasni, amelyet a régi nem kezelt, de ebből még nem következik, hogy az adott napló felülete is megjeleníti. A szoftverfrissítés lehet fontos lépés, de a fájltámogatás és a termékfunkció továbbra is külön ellenőrizendő.
A CSV-export külön döntés arról, milyen oszlopok maradnak meg
A Garmin aktivitásdekódolási példája külön gyűjti a szokásos és a fejlesztői mezőket a CSV létrehozásához. Azt is leírja, hogy az elérhető mezők a felvétel közben változhatnak, ezért nem elég csak az első rekord mezőlistáját megnézni. Az egyedi adat exportálása tehát megvalósítható, de a konkrét exportáló kialakításától függ, mi kerül valóban az oszlopok közé.
Saját példánkban a futó az első három percet szenzor nélkül kezdi, majd létrejön a kapcsolat. Az első sorokban nincs egyedi mutató, a későbbiekben már van. Ha az exportáló az első sor alapján készíti el a teljes fejlécet, kihagyhatja a később felbukkanó mezőt. Ettől még az eredeti fájl későbbi része tartalmazhatja az adatot. A teljes felvétel mezővizsgálata más, mint az első sor gyors megnyitása.
Az üres mező nem azonos a nullával. Saját táblázatunkban a hiányzó szenzorértéket üresen hagyjuk, a valóban mért nullát pedig nullával jelöljük. Ha a kettőt összevonjuk, a későbbi átlag vagy grafikon tévesen úgy mutathatja, mintha a kapcsolat nélküli időben is folyamatos mérés történt volna. A hiány jelölése ugyanolyan fontos, mint a megőrzött szám egysége.
Más formátumra alakítva a tartalom egy része elveszhet
Egy fájlkonverzió nem feltétlenül teljes, veszteségmentes fordítás. A célformátumnak és az exportálónak is ismernie kellene, hová tegye a forrás egyedi adatát. Ha nincs megfelelő mező vagy bővítési megoldás, a konverter elhagyhatja. A térképi nyomvonal és az időbélyegek megmaradása ezért nem bizonyítja, hogy minden saját szenzormutató is átkerült.
A Strava hivatalos exporttájékoztatója külön ismerteti az eredeti formátum exportját és a GPX vagy TCX letöltést. Az eredeti export a feltöltött fájl típusát őrzi; ez nem minden esetben FIT, hanem attól függ, mi került be. Ha a későbbi újraelemzéshez az egyedi FIT-mező fontos, a valódi forrásfájl megtartása lényegesebb, mint egy általános nyomvonalexport megléte.
Saját munkafolyamatunkban megmarad az óráról származó FIT, készül egy olvasási célú CSV, és külön egy útvonalmegosztásra használt nyomvonal. Mindháromnak más a szerepe. A CSV oszlopai kényelmesen áttekinthetők, az útvonal egyszerűen továbbadható, az eredeti pedig a későbbi részletes feldolgozás alapja. Nem kell egyetlen fájltól mindhárom feladat teljes körű megoldását elvárni.
Az egyedi mező nem automatikusan hiteles vagy mindenhol azonos jelentésű
Attól, hogy egy szám szabályosan bekerül a FIT-be, még nem bizonyított a sporttudományi értelme vagy pontossága. A formátum a tárolást és értelmezhető átadást segíti, nem az algoritmus szakmai minősítését végzi. Egy önleíró mező lehet dokumentált becslés, egyszerű megjegyzés vagy saját fejlesztői mutató. A fájl érvényességét és a mérőszám használhatóságát külön kell megítélni.
Saját példában két gyártó egyaránt „stabilitásnak” nevez egy értéket. Az egyik időbeli ingadozásból, a másik más szenzorjelből készít saját skálát. A közös név alapján nem indokolt egymás mellé tenni őket egyetlen fejlődési grafikonon. Az algoritmusdefiníció, az egység és a számítási környezet nélkül a hasonlóság csak nyelvi. Az összevonás többet állíthatna, mint amit az adatok alátámasztanak.
Az egyedi mutató megőrzésének ezért nem az a célja, hogy minden számból edzésutasítás legyen. Az eredeti adat megőrizhető későbbi vizsgálathoz, miközben a mostani döntéshez más, jobban értett mező szolgál támpontként. A tárolás és a felhasználás külön döntés. Egy ismeretlen jelentésű görbe hiánya kellemetlen lehet, de a visszanyerése után is szükséges tisztázni, mire alkalmas.
Kép nagyításaÖt kérdés, amellyel szűkíthető az adatvesztés helye
Először azt ellenőrizd, hogy a szenzor és a rögzítő alkalmazás ténylegesen mentette-e a kívánt mezőt. A saját alkalmazásban megjelenő érték lehet utólag számolt adat is, amely nem része az óráról származó fájlnak. Másodszor nézd meg az eredeti fájl mezőit megfelelő dekóderrel. Az üres grafikonból ne következtesd vissza a fájltartalmat; a két ellenőrzés más kérdésre válaszol.
Harmadik kérdésként az exportáló megőrzési szabályát keresd, negyedikként a fogadó tárolását, ötödikként a megjelenítést és a visszaexportálást. Saját ellenőrző táblázatban minden állomás mellé „jelen van”, „nincs jelen” vagy „nem ellenőrzött” kerülhet. Az utolsó jelölés fontos: amit még nem vizsgáltunk, azt nem szabad biztos hiánynak nevezni. Így a támogatásnak is világosabban megadható, hol szakadt meg a lánc.
A támogatási kérésben a mező neve és egysége mellett szerepeljen a forrásalkalmazás, annak verziója, a fájltípus és egy rövid, pontos szakaszleírás. Ha a probléma csak egy bizonyos exportváltozatnál jelentkezik, ezt külön írd le. A teljes futóhelyadat nyilvános megosztása helyett szükség esetén a szolgáltató megfelelő privát csatornáját használd. A célzott példa informatívabb, mint sok, azonosítatlan fájl.
Mi maradjon meg egy később is használható saját archívumban?
Tartsd meg az eredeti fájlt, a használt eszköz és alkalmazás adatait, valamint az egyedi mező rövid dokumentációját vagy annak pontos forráslinkjét. Egy fájlnévbe tett emlékeztető helyett külön jegyzetben rögzíthető, melyik mutatót miért szeretnéd megőrizni. Az archívum értéke abban van, hogy később is megérthető. A sok azonos nevű, különböző módon átalakított másolat könnyen összezavarja a történetet.
Az eredeti megtartása lehetőséget adhat egy később fejlettebb feldolgozó használatára, ha a szükséges mező már most is benne van. Ami sosem került rögzítésre, azt az archívum nem hozza létre utólag. Ha csak egy szűkített export maradt meg, a hiányzó egyedi mező nem rekonstruálható biztosan a tempóból vagy más, hozzá csupán kapcsolódó adatból. A későbbi lehetőség alapja a valódi forrás megőrzése.
Az eltűnt szenzormutató ügyében tehát a fájl tartalma, a feldolgozó támogatása és a felület külön vizsgálandó. A FIT fejlesztői mezői rugalmas átadást tesznek lehetővé, de nem ígérik, hogy minden szolgáltatás minden egyedi görbét kezel. A dokumentált adatút és a változatlan eredeti segít megkülönböztetni a láthatatlanságot a tényleges adatvesztéstől. Így a javítás ahhoz a ponthoz kerülhet, ahol valóban szükség van rá.
Források
- Garmin FIT: Working With Developer Data Fields.
- Garmin FIT-protokoll: definíciók és ismeretlen mezők kezelése.
- Garmin aktivitásdekódolás: egyedi mezők CSV-exportja.
- Strava: eredeti fájl, GPX és TCX export.


