Zestaw danych o kofeinie

Co znajduje się w pliku i co oznacza każde pole?

Plik to opublikowany eksport JSON i CSV otwartego zbioru danych 87 napojów udostępnionego na tej stronie i zawiera dokładnie pola id, name, brand, category, serving_ml, caffeine_mg, caffeine_per_100ml, scales_with_volume oraz is_decaf. Zbiór danych to tabela 87 rekordów napojów opublikowana na tej stronie.

Format pliku zawiera jeden rekord na napój; każdy rekord w pliku odpowiada bezpośrednio wierszowi w CSV i obiektowi w JSON, a zbiór danych liczy 87 rekordów w 8 kategoriach: espresso 12, brewed 8, coffeeShop 20, energy 15, tea 11, soda 11, preworkout 5 i other 5 (liczby dla kategorii są częścią zbioru danych). Każda z tych wartości jest zapisana w zbiorze danych i dostępna do programowego filtrowania poprzez eksport /dataset/.

id to krótki identyfikator maszynowy używany do wyszukiwania rekordu w JSON i CSV. Pole id jest unikalne dla każdego z 87 rekordów i stanowi klucz główny do łączeń programowych względem zbioru danych.

name to czytelna dla człowieka nazwa napoju, tak jak pojawia się na publicznych stronach napojów, na przykład Espresso (single), gdzie nazwa pokazuje "Espresso (single)" i strona podaje 63 mg; liczba 63 mg jest zapisana w polu caffeine_mg dla tego elementu w zbiorze danych.

brand to właściciel komercyjny lub źródło, gdy ma zastosowanie, albo pusty ciąg dla pozycji ogólnych; na przykład wiersz zbioru danych dla Starbucks Pike Place Brewed (Grande) wskazuje Starbucks jako brand w polu brand i 310 mg w polu caffeine_mg.

category to grupowanie kategoryczne, które klasyfikuje każdy rekord do jednej z ośmiu grup (espresso, brewed, coffeeShop, energy, tea, soda, preworkout, other); category to etykieta stosowana do agregowania liczebności (zbiór danych zawiera 12 pozycji espresso, 8 brewed itd.) i te liczby są wymienione w nagłówku zbioru danych.

serving_ml to objętość porcji w mililitrach. Na przykład Espresso (single) ma serving_ml 30 ml, a Starbucks Pike Place Brewed (Grande) ma serving_ml 473 ml; obie wartości są zapisane w zbiorze danych.

caffeine_mg to absolutna ilość kofeiny w miligramach na porcję. Caffeine_mg to numeryczna wartość kofeiny przypisana do każdej porcji; na przykład w zbiorze danych zapisano caffeine_mg 63 mg dla Espresso (single) oraz 310 mg dla Starbucks Pike Place Brewed (Grande).

caffeine_per_100ml to znormalizowane stężenie kofeiny w mg na 100 ml, gdy ta wartość ma zastosowanie i jest dostępna; caffeine_per_100ml to metryka koncentracji używana do porównania intensywności między różnymi rozmiarami porcji i zbiór danych przechowuje tę wartość dla wpisów takich jak Cold brew (83.3 mg/100 ml) oraz Drip coffee (40 mg/100 ml).

scales_with_volume to flaga logiczna wskazująca, czy wartość kofeiny powinna się w przybliżeniu skalować liniowo z objętością (true/false). Scales_with_volume jest true dla prostych kaw parzonych, gdzie stężenie jest mniej więcej stałe, i false dla pozycji jednostkowych, takich jak pojedyncze espresso, gdzie kofeina jest oparta na jednostce porcji, a nie proporcjonalna do ml.

is_decaf to flaga logiczna oznaczająca napoje przygotowane jako bezkofeinowe; is_decaf jest true dla pozycji decaf i zbiór danych pokazuje na przykład, że Decaf coffee ma caffeine_mg 3 mg i is_decaf true.

Jak wartość trafia do zbioru danych i co dyskwalifikuje kandydata?

Wartości są dodawane tylko po sprawdzeniu udokumentowanego źródła i zdefiniowaniu jasnego rozmiaru porcji; wpisy pochodzą z etykiet dostawców, opublikowanego żywieniowego menu, badań laboratoryjnych takich jak USDA FoodData Central lub z recenzowanych pomiarów tam, gdzie są dostępne. USDA FoodData Central jest jednym ze źródeł odniesienia używanych dla deklarowanych lub zmierzonych wartości i to źródło jest wyraźnie cytowane na stronach pozycji, gdy jest używane (USDA FoodData Central).

Włączenie wymaga weryfikowalnego numerycznego caffeine_mg oraz stabilnego serving_ml lub jasnego uzasadnienia, dlaczego pozycja opiera się na jednostkach (na przykład strzały espresso lub tabletki z kofeiną). Rekordy bez weryfikowalnej porcji lub bez numerycznej wartości kofeiny są dyskwalifikowane i nie są dodawane do publicznego eksportu.

Akceptujemy wartości deklarowane przez producenta (etykiety żywieniowe lub opublikowane menu), gdy te deklaracje odpowiadają definicji porcji; deklarowana etykieta, która podaje 200 mg na butelkę 300 ml, zostanie zapisana tylko wtedy, gdy rozmiar butelki jest wyraźny i zgodny z serving_ml w wierszu zbioru danych, a każde takie uwzględnienie podaje źródło na stronie napoju.

Akceptujemy niezależne pomiary laboratoryjne, takie jak wpisy indeksowane przez USDA, gdy analiza podaje jednostki zgodne z naszym serving_ml; gdy USDA lub metoda recenzowana raportuje stężenie w mg/100 ml, konwertujemy to na caffeine_mg dla zapisanej serving_ml i cytujemy oryginalną analizę na stronie napoju oraz w metadanych zbioru danych (USDA FoodData Central).

Dyskwalifikujemy kandydatów, jeśli rozmiar porcji jest niejednoznaczny (np. zakresy w menu bez standardowej porcji), jeśli źródło jest anegdotyczne bez mierzalnej metody, lub jeśli zgłoszona wartość stoi w sprzeczności z wieloma zaufanymi źródłami bez wyjaśnienia. Pozycje o dużej zmienności i bez reprezentatywnej porcji będą wyłączone, dopóki nie zostanie ustalona wiarygodna pojedyncza wartość.

Nie wymyślamy rozmiarów porcji ani caffeine_mg; każda liczba w wyeksportowanym pliku ma oparcie w redagowanych wierszach zbioru danych i, gdy źródłem jest deklaracja producenta, strona napoju łączy się z podstawowym menu lub etykietą tam, gdzie to możliwe.

Korekty i spory są obsługiwane przez proces korekt opisany na stronie about oraz przez formularz kontaktowy; zobacz /about/ dla metody i /contacts/ jak przesłać poprawki danych.

Dlaczego opublikowane wartości kofeiny różnią się między źródłami?

Opublikowane wartości kofeiny różnią się, ponieważ ta sama nazwa napoju może oznaczać różne rozmiary porcji, różne siły parzenia, różne lokalne receptury lub różne konwencje pomiarowe; te cztery konkretne czynniki odpowiadają za większość różnic obserwowanych w zbiorze danych. Te źródła rozbieżności są dokumentowane na indywidualnych stronach napojów, gdzie zbiór danych wymienia używaną liczbę i jej pochodzenie.

Konwencje rozmiaru porcji zmieniają zgłaszane całkowite wartości: na przykład zbiór danych rejestruje Starbucks Pike Place Brewed (Grande) jako 310 mg w porcji 473 ml, podczas gdy lokalne menu może podawać inny rozmiar; liczba 310 mg w zbiorze danych pochodzi z opublikowanej informacji żywieniowej Starbucks dla porcji Grande 473 ml i jest cytowana na stronie napoju.

Różnice w mocy parzenia są częstą przyczyną: drip coffee w naszym zbiorze danych to 96 mg na 240 ml, podczas gdy pour over jest podane jako 145 mg na 240 ml; obie wartości są w zbiorze danych i odzwierciedlają różne stopnie ekstrakcji oraz proporcje mielenia/parzenia. Zbiór danych rejestruje drip coffee 96 mg (240 ml) i pour over 145 mg (240 ml) i te konkretne wartości są dostępne na ich odpowiednich stronach (Drip coffee, Pour over).

Regionalne receptury lub różnice w składzie zmieniają deklarowaną kofeinę: butelkowana Coca-Cola pokazuje 32–34 mg na puszkę w zależności od opakowania 330 ml lub 355 ml, a zbiór danych zawiera zarówno Coca-Cola (330 ml) 32 mg, jak i Coca-Cola (355 ml) 34 mg, aby odzwierciedlić różnice w pakowaniu i etykietowaniu.

Zaokrąglenia na etykietach i różnice deklarowane vs. mierzone powodują niewielkie niezgodności: producenci czasem deklarują zaokrąglone liczby w tabelach żywieniowych, a laboratoria raportują zmierzone wartości z większą precyzją; zbiór danych zachowuje numer deklarowany na etykiecie, gdy to jest opublikowane źródło, i oznacza zmierzone stężenia, gdy są dostępne.

Źródła składników i dodane stymulanty mogą zmieniać zawartość kofeiny poza kawą/herbatą: napoje energetyczne i suplementy przedtreningowe czasem używają caffeine anhydrous, guarany lub innych składników, które zmieniają łączną ilość mg i stężenie; nasz zbiór danych rejestruje końcowe caffeine_mg zgodnie z deklaracją marki lub pomiarami w źródłach publicznych, takich jak strony etykiet produktów wymienione na stronach szczegółowych pozycji.

Jakie są znane ograniczenia tego zbioru danych?

Ten zbiór danych podaje pojedyncze reprezentatywne caffeine_mg dla napoju i nie uwzględnia zmienności między partiami ani różnic między baristami; podejście pojedynczej wartości to decyzja projektowa i oznacza, że eksport nie może reprezentować pełnego rozkładu stężeń dla danego napoju. Na przykład zbiór danych podaje Cold brew jako 200 mg dla 240 ml i Nitro cold brew jako 215 mg dla 240 ml, ale poszczególne przygotowania będą się różnić wokół tych liczb.

Farmakokinetyka populacyjna i indywidualna wrażliwość wykraczają poza ten zbiór danych; zbiór danych to tabela zawartości kofeiny w napojach i nie dostarcza zaleceń dawkowania ani porad medycznych. Wytyczne dotyczące bezpiecznego spożycia dziennego są dostępne u organów regulacyjnych i zbiór danych odwołuje się do tych zaleceń: US Food and Drug Administration wymienia 400 mg na dzień jako wskazówkę dla zdrowych dorosłych (FDA).

Pozycje bezkofeinowe nie są zerowe: zbiór danych rejestruje Decaf coffee jako 3 mg na 240 ml, co pokazuje, że przygotowania bezkofeinowe często zachowują niewielkie resztkowe ilości kofeiny i nie należy ich zakładać jako wolne od kofeiny.

Niektóre rekordy są oparte na jednostkach i mają serving_ml 0 dla wygody (na przykład tabletki i guma); zbiór danych wymienia Caffeine pill (200 mg) jako 200 mg i serving_ml 0, co odzwierciedla, że objętość nie ma zastosowania dla tych pozycji i jest to ograniczenie przy porównaniach per objętość.

Niezwykle obszerne ani globalnie kompletne: zbiór danych zawiera 87 rekordów wybranych, aby reprezentować powszechne napoje i marki i jest świadomie ograniczony; eksport nie jest próbą uwzględnienia każdego produktu na świecie, a użytkownicy powinni traktować kolekcję jako wyselekcjonowaną próbkę, a nie katalog wyczerpujący.

Różnice laboratorium vs. deklarowane pozostają możliwe: gdy wiele zaufanych źródeł się nie zgadza, wybieramy najbardziej specyficzne źródło i dokumentujemy wybór na stronie napoju; dla dowolnej pozycji możesz znaleźć link do pochodzenia na stronie indywidualnej i skontaktować się z nami, jeśli masz sprzeczny pomiar, poprzez /contacts/.

Jak cytować lub ponownie wykorzystywać ten zbiór danych?

Zbiór danych jest licencjonowany na zasadach CC BY 4.0 i wymaga przypisania do TrackCaffeine; CC BY 4.0 to licencja stosowana do zbioru danych i jest tutaj zlinkowana dla warunków prawnych (CC BY 4.0). Zalecany format cytowania to TrackCaffeine Dataset (2026). TrackCaffeine jest powtórzone jako cel przypisania, a strona eksportu zbioru danych jest kanonicznym adresem URL do umieszczenia w tym przypisaniu.

Użyj tego krótkiego przykładu cytowania przy ponownym wykorzystaniu danych: "TrackCaffeine. Open caffeine dataset. CC BY 4.0. https://trackcaffeine.com/dataset/" i dołącz link zwrotny do /dataset/ dla pochodzenia i wersji zbioru danych użytej. Jeśli modyfikujesz wartości lub agregujesz wiele pozycji, zaznacz przekształcenie i zachowaj oryginalne przypisanie do TrackCaffeine, zgodnie z wymogami CC BY 4.0 (CC BY 4.0).

Wykorzystanie komercyjne jest dozwolone na mocy CC BY 4.0 pod warunkiem udzielenia przypisania; strona licencji z linku powyżej wyjaśnia obowiązki prawne, a sama strona zbioru danych dokumentuje wersję zbioru danych używaną w jakiejkolwiek pracy pochodnej.

Jakie przykłady pokazują, jak liczyć z użyciem pliku, w tym dealkalcję i równoważność w kubkach kawy?

Możesz obliczyć pozostałą ilość kofeiny w czasie używając modelu eliminacji rzędu pierwszego z populacyjną średnią okresem półtrwania 5.7 h; eliminacja rzędu pierwszego to model farmakokinetyczny, w którym szybkość eliminacji jest proporcjonalna do aktualnego stężenia. Model użyty tutaj to remaining = dose × 0.5^(hours ÷ 5.7), a półtrwanie 5.7 h to populacyjna średnia stosowana w naszych kalkulatorach.

Przykład 1: oblicz pozostałą kofeinę po 6 godzinach dla Starbucks Pike Place Brewed (Grande). Starbucks Pike Place Brewed (Grande) to 310 mg w 473 ml według zbioru danych, więc remaining = 310 mg × 0.5^(6 ÷ 5.7), co daje remaining = 310 mg × 0.5^(1.052631579) = 310 mg × 0.482 ≈ 149 mg; wartość 310 mg ze zbioru danych jest pokazana na stronie napoju, a działania arytmetyczne wykonano zgodnie z powyższym modelem rzędu pierwszego.

Przykład 2: oblicz pozostałość po 3 godzinach po napoju energetycznym 300 mg, takim jak Bang (Bang jest zapisany jako 300 mg dla 473 ml w zbiorze danych). Używając remaining = 300 mg × 0.5^(3 ÷ 5.7) = 300 mg × 0.5^(0.526315789) = 300 mg × 0.697 ≈ 209 mg pozostających; zbiór danych podaje Bang jako 300 mg, a obliczenia używają liczby ze zbioru danych i wspomnianego półtrwania.

Przykład 3: równoważność w kubkach kawy: ile latte równa się jednej drip coffee? Drip coffee to 96 mg na 240 ml, a Latte to 68 mg na 240 ml w zbiorze danych. Użyj ratio = 96 mg ÷ 68 mg = 1.411764706, więc jedna drip coffee równa się około 1.41 latte; obie liczby źródłowe są zapisane na stronach napojów Drip coffee (96 mg) oraz Latte (68 mg).

Przykład 4: równoważność strzałów espresso: ile pojedynczych espresso (63 mg) równa się Starbucks Grande brewed 310 mg? Użyj ratio = 310 mg ÷ 63 mg = 4.920634921, więc w przybliżeniu 4.92 pojedynczych espresso równa się porcji Grande; wartości wejściowe 310 mg i 63 mg pochodzą z odpowiednich stron napojów Starbucks Pike Place Brewed (Grande) oraz Espresso (single).

Przykład 5: użycie zbioru danych z kalkulatorami. Jeśli chcesz interaktywnej symulacji deakalcji lub planowania pory snu, możesz wkleić wartość caffeine_mg z JSON do kalkulatorów na /tools/caffeine-calculator/, porównać dwa napoje na /tools/caffeine-comparison/, lub oszacować efekty ostatniej filiżanki przed snem używając /tools/last-cup-before-bed/. Każdy kalkulator używa tego samego modelu eliminacji rzędu pierwszego, a eksportowany JSON jest sformatowany do kopiowania/wklejania do tych narzędzi.

Konkretny cytat dotyczący wpływu na sen: kontrolowane badanie wykazało, że 400 mg kofeiny przyjęte sześć godzin przed snem skróciło całkowity czas snu o ponad godzinę; to badanie jest tutaj cytowane i jest istotne, gdy używasz zbioru danych do planowania spożycia (Drake et al., 2013). Użyj wartości ze zbioru danych, aby obliczyć, jak blisko porcji jest 400 mg wytycznej, a następnie odnieś się do badania, aby zinterpretować potencjalne skutki dla snu.

Jeśli chcesz odtworzyć dowolne z tych obliczeń programowo, załaduj CSV lub JSON z /dataset/, wybierz caffeine_mg dla interesującego Cię ID i oceń remaining = dose × 0.5^(hours ÷ 5.7) z numeryczną dawką ze zbioru danych; kalkulatory z linków pod /tools/ używają tego samego podejścia i są przeznaczone do interaktywnego badania.

Dla szybkiego odwołania do powszechnych stron napojów użytych w przykładach, zobacz Espresso (single), Drip coffee, Cold brew, Starbucks Pike Place Brewed (Grande), Bang, Latte, oraz kalkulatory na /tools/caffeine-calculator/, /tools/caffeine-comparison/, /tools/last-cup-before-bed/.

Korekty, prośby o nowe pozycje lub pytania o pochodzenie danych należy przesyłać przez formularz kontaktowy na /contacts/, a dziennik zmian zbioru danych i notatki metodologiczne są dostępne na /about/, gdzie opisujemy selekcję źródeł i częstotliwość aktualizacji.

Ta dokumentacja ma charakter informacyjny i jest przeznaczona do ponownego wykorzystania danych; nie stanowi porady medycznej. W sprawach zdrowotnych dotyczących bezpiecznych limitów kofeiny konsultuj się z organami regulacyjnymi lub źródłami klinicznymi, takimi jak US Food and Drug Administration, która wymienia 400 mg na dzień dla zdrowych dorosłych (FDA) lub European Food Safety Authority dla opinii regionalnych (EFSA, 2015).

Licencja i przypisanie: ten zbiór danych jest opublikowany na zasadach CC BY 4.0; dołącz przypis do TrackCaffeine i link do CC BY 4.0 przy ponownym wykorzystaniu danych. Jeśli ponownie używasz dużych części zbioru danych w produkcie publicznym, dołącz link zwrotny do /dataset/ oraz krótką notę provenance nazwaną TrackCaffeine jako źródłem.