Der Koffein-Datensatz

Was steht in der Datei und was bedeuten die einzelnen Felder?

Die Datei ist ein veröffentlichter JSON- und CSV-Export des offenen Datensatzes von 87 Getränken, der auf dieser Seite gehostet wird, und enthält exakt die Felder id, name, brand, category, serving_ml, caffeine_mg, caffeine_per_100ml, scales_with_volume und is_decaf. Dataset bezeichnet die 87-zeilige Tabelle der auf dieser Seite publizierten Getränke.

Das Dateiformat enthält einen Datensatz pro Getränk; jeder Eintrag in der Datei entspricht direkt einer Zeile im CSV und einem Objekt im JSON, und der Datensatz umfasst 87 Einträge in 8 Kategorien: espresso 12, brewed 8, coffeeShop 20, energy 15, tea 11, soda 11, preworkout 5 und other 5 (Kategoriezahlen sind Teil des Datensatzes). Jede dieser Zahlen ist im Datensatz verzeichnet und über den /dataset/ Export programmatisch filterbar.

id ist ein kurzer Maschinenbezeichner, der verwendet wird, um einen Datensatz im JSON und CSV nachzuschlagen. Das id-Feld ist für jeden der 87 Einträge eindeutig und bildet den Primärschlüssel für programmatische Verknüpfungen mit dem Datensatz.

name ist der für Menschen lesbare Getränkename, wie er auf den öffentlichen Getränkseiten erscheint, z. B. Espresso (single), wo der Name "Espresso (single)" angezeigt wird und die Seite 63 mg ausweist; die Zahl 63 mg ist im Datensatz für diesen Eintrag im Feld caffeine_mg verzeichnet.

brand ist der kommerzielle Eigentümer oder die Quelle, wenn zutreffend, oder ein leerer String für generische Artikel; zum Beispiel listet die Datensatzzeile für Starbucks Pike Place Brewed (Grande) Starbucks im brand-Feld und 310 mg im Feld caffeine_mg.

category ist die kategoriale Gruppierung, die jeden Eintrag einer der acht Gruppen zuordnet (espresso, brewed, coffeeShop, energy, tea, soda, preworkout, other); category ist ein Label zur Aggregation von Zählungen (der Datensatz enthält z. B. 12 Espresso-Einträge, 8 brewed-Einträge usw.) und diese Zählungen sind im Datensatzkopf aufgeführt.

serving_ml ist das Serviervolumen in Millilitern. Zum Beispiel hat Espresso (single) serving_ml 30 ml und Starbucks Pike Place Brewed (Grande) serving_ml 473 ml; beide Zahlen sind im Datensatz verzeichnet.

caffeine_mg ist die absolute Koffeinmenge in Milligramm pro Portion. Caffeine_mg ist der numerische Koffeinwert, der jeder Portion zugewiesen wird; zum Beispiel führt der Datensatz für Espresso (single) caffeine_mg 63 mg und für Starbucks Pike Place Brewed (Grande) 310 mg.

caffeine_per_100ml ist die normalisierte Koffeinkonzentration in mg pro 100 ml, sofern dieser Wert passend und verfügbar ist; caffeine_per_100ml ist die Konzentrationsmetrik, die verwendet wird, um die Intensität zwischen unterschiedlichen Portionsgrößen zu vergleichen, und der Datensatz speichert diesen Wert für Einträge wie Cold brew (83.3 mg/100 ml) und Drip coffee (40 mg/100 ml).

scales_with_volume ist ein boolesches Feld, das angibt, ob der Koffeinwert ungefähr linear mit dem Volumen skalieren sollte (true/false). Scales_with_volume ist true für einfache aufgebrühte Kaffees, bei denen die Konzentration grob konstant ist, und false für einheitenbasierte Artikel wie einen einzelnen Espresso-Shot, bei dem das Koffein schussbasiert statt proportional zu ml ist.

is_decaf ist ein boolesches Feld, das Getränke kennzeichnet, die entkoffeiniert zubereitet sind; is_decaf ist true für entkoffeinierte Artikel und der Datensatz zeigt zum Beispiel, dass Decaf coffee caffeine_mg 3 mg und is_decaf true hat.

Wie gelangt ein Wert in den Datensatz und was disqualifiziert einen Kandidaten?

Werte werden nur hinzugefügt, nachdem eine dokumentierte Quelle geprüft und eine klare Portionsgröße definiert wurde; Einträge stammen von Herstelleretiketten, veröffentlichten Menü-Nährwertangaben, Laboranalysen wie USDA FoodData Central oder peer-reviewed Messungen, sofern vorhanden. USDA FoodData Central ist eine der Referenzquellen für deklarierte oder gemessene Werte und diese Quelle wird auf den Artikelseiten genannt, wenn sie verwendet wurde (USDA FoodData Central).

Voraussetzung für die Aufnahme ist ein verifizierbares numerisches caffeine_mg und ein stabiles serving_ml oder ein klarer Grund, warum der Artikel einheitenbasiert ist (z. B. Espresso-Shots oder Koffeintabletten). Datensätze ohne verifizierbare Portion oder ohne numerischen Koffeinwert werden disqualifiziert und nicht in den öffentlichen Export aufgenommen.

Wir akzeptieren vom Hersteller deklarierte Werte (Nährwertangaben oder veröffentlichte Menüs), wenn diese Etiketten mit der Servierungsdefinition übereinstimmen; ein deklariertes Etikett, das 200 mg pro 300 ml Flasche angibt, wird nur dann verzeichnet, wenn die Flaschengröße explizit ist und mit dem serving_ml in der Datensatzzeile übereinstimmt, und jede solche Aufnahme nennt die Quelle auf der Getränkseite.

Wir akzeptieren unabhängige Laboranalysen wie Einträge, die von USDA indexiert wurden, wenn die Analyseeinheiten mit unserem serving_ml konsistent sind; wenn USDA oder ein peer-reviewed Verfahren eine Konzentration in mg/100 ml meldet, konvertieren wir diese in caffeine_mg für das aufgezeichnete serving_ml und zitieren die ursprüngliche Analyse auf der Getränkseite und in den Datensatzmetadaten (USDA FoodData Central).

Kandidaten werden disqualifiziert, wenn die Portionsgröße mehrdeutig ist (z. B. eine Menüspanne ohne Standardportion), wenn die Quelle anekdotisch ohne messbare Methode ist, oder wenn der gemeldete Wert mehreren vertrauenswürdigen Quellen widerspricht ohne Aufklärung. Artikel mit großer Varianz und keiner repräsentativen Portion werden ausgeschlossen, bis ein verlässlicher Einzelwert etabliert ist.

Wir erfinden weder Portionsgrößen noch caffeine_mg; jede Zahl in der exportierten Datei ist durch die erstellten Datensatzzeilen belegt, und wenn die Quelle vom Hersteller deklariert wurde, verlinkt die Getränkseite auf das zugrunde liegende Menü oder Etikett, wo verfügbar.

Korrekturen und Streitfälle werden über den auf der About-Seite beschriebenen Korrekturprozess und über das Kontaktformular abgewickelt; siehe /about/ für die Methode und /contacts/ für die Einreichung von Datenkorrekturen.

Warum weichen veröffentlichte Koffeinangaben zwischen Quellen ab?

Veröffentlichte Koffeinangaben weichen voneinander ab, weil derselbe Getränkename unterschiedliche Portionsgrößen, unterschiedliche Brühstärken, verschiedene regionale Rezepturen oder unterschiedliche Messkonventionen repräsentieren kann; diese vier konkreten Faktoren erklären den Großteil der Unterschiede, die im Datensatz beobachtet wurden. Diese Ursachen für Abweichungen sind auf den einzelnen Getränkseiten dokumentiert, wobei der Datensatz die verwendete Zahl und deren Herkunft angibt.

Konventionen zur Portionsgröße verändern die gemeldeten Gesamtsummen: zum Beispiel führt der Datensatz Starbucks Pike Place Brewed (Grande) mit 310 mg in einer 473 ml-Portion, während ein lokales Menü eine andere Größe melden kann; die 310 mg im Datensatz stammen aus den von Starbucks veröffentlichten Nährwertangaben für eine 473 ml Grande-Portion und werden auf der Getränkseite zitiert.

Unterschiede in der Brühstärke sind eine häufige Ursache: Filterkaffee in unserem Datensatz hat 96 mg pro 240 ml, während Pour Over mit 145 mg pro 240 ml gelistet ist; beide Werte sind im Datensatz und spiegeln unterschiedliche Extraktionsstärken und Mahl-/Brühverhältnisse wider. Der Datensatz verzeichnet Drip coffee 96 mg (240 ml) und Pour over 145 mg (240 ml) und diese spezifischen Werte sind auf den jeweiligen Seiten verfügbar (Drip coffee, Pour over).

Regionale Rezepturen oder Zutatenänderungen verändern deklarierte Koffeinwerte: ein Flaschen-Eintrag für Coca-Cola zeigt 32–34 mg pro Dose, abhängig von 330 ml- oder 355 ml-Verpackung, und der Datensatz enthält sowohl Coca-Cola (330 ml) 32 mg als auch Coca-Cola (355 ml) 34 mg, um Verpackungs- und Kennzeichnungsunterschiede widerzuspiegeln.

Rundungen auf dem Etikett und deklarierte vs. gemessene Werte erzeugen kleine Abweichungen: Hersteller geben manchmal gerundete Zahlen in Nährwerttabellen an, während Labore gemessene Werte mit größerer Genauigkeit melden; der Datensatz übernimmt die deklarierte Etikettenzahl, wenn dies die veröffentlichte Quelle ist, und kennzeichnet gemessene Konzentrationen, wo verfügbar.

Zutatenquellen und zugesetzte Stimulanzien können das Koffein über Kaffee/Tee hinaus verändern: Energydrinks und Pre-Workout-Supplements verwenden manchmal Koffeinanhydrat, Guarana oder andere Inhaltsstoffe, die die Gesamt-mg und die Konzentration verändern; unser Datensatz verzeichnet das finale caffeine_mg, wie es von der Marke deklariert oder in öffentlichen Quellen wie den Produktetiketten auf den Artikeldetailseiten gemessen wurde.

Was sind die bekannten Einschränkungen dieses Datensatzes?

Dieser Datensatz liefert einen einzelnen repräsentativen caffeine_mg-Wert pro Getränk und erfasst keine Chargen- oder Barista-bedingten Schwankungen; der Ein-Wert-Ansatz ist eine Designentscheidung und bedeutet, dass der Export nicht die vollständige Verteilungsbreite der Konzentrationen eines Getränks darstellen kann. Zum Beispiel listet der Datensatz Cold brew mit 200 mg für 240 ml und Nitro cold brew mit 215 mg für 240 ml, aber individuelle Zubereitungen weichen um diese Zahlen herum ab.

Populationspharmakokinetik und individuelle Empfindlichkeit liegen außerhalb des Datensatzes; der Datensatz ist eine Inhaltsübersicht der Koffeinmengen in Getränken und bietet keine persönlichen Dosierungsempfehlungen oder medizinische Beratung. Hinweise zur sicheren täglichen Aufnahme sind bei Regulierungsbehörden verfügbar und der Datensatz verweist auf diese Empfehlungen: die US Food and Drug Administration nennt 400 mg pro Tag als Richtwert für gesunde Erwachsene (FDA).

Entkoffeinierte Artikel sind nicht null: der Datensatz verzeichnet Decaf coffee mit 3 mg in 240 ml, was zeigt, dass entkoffeinierte Zubereitungen oft geringe Restmengen an Koffein enthalten und nicht automatisch koffeinfrei angenommen werden sollten.

Einige Einträge sind einheitenbasiert und haben serving_ml 0 der Einfachheit halber (z. B. Tabletten und Kaugummi); der Datensatz listet Caffeine pill (200 mg) als 200 mg und serving_ml 0, was widerspiegelt, dass das Volumen für diese Artikel nicht anwendbar ist und eine Einschränkung für volumenbasierte Vergleiche darstellt.

Nicht erschöpfend oder global umfassend: der Datensatz enthält 87 Einträge, die ausgewählt wurden, um gängige Getränke und Marken zu repräsentieren, und ist bewusst begrenzt; der Export ist kein Versuch, jedes Produkt weltweit abzubilden, und Benutzer sollten die Sammlung als kuratiertes Beispiel statt als vollständigen Katalog betrachten.

Lab- vs. deklarierte Unterschiede bleiben möglich: wenn mehrere vertrauenswürdige Quellen widersprüchliche Angaben machen, wählen wir die spezifischste Quelle und dokumentieren die Entscheidung auf der Getränkseite; für jeden Eintrag finden Sie den Herkunftslink auf der jeweiligen Seite und können uns bei widersprüchlichen Messungen unter /contacts/ kontaktieren.

Wie soll ich diesen Datensatz zitieren oder wiederverwenden?

Der Datensatz ist unter CC BY 4.0 lizenziert und erfordert eine Namensnennung von TrackCaffeine; CC BY 4.0 ist die auf den Datensatz angewandte Lizenz und hier für die rechtlichen Bedingungen verlinkt (CC BY 4.0). Das empfohlene Zitierformat ist TrackCaffeine Dataset (2026). TrackCaffeine ist als Namensnennung klar anzugeben und die Datensatz-Exportseite ist die kanonische URL, die in dieser Nennung aufgenommen werden sollte.

Verwenden Sie dieses kurze Zitierbeispiel bei Wiederverwendung der Daten: "TrackCaffeine. Open caffeine dataset. CC BY 4.0. https://trackcaffeine.com/dataset/" und fügen Sie einen Link zurück zu /dataset/ hinzu, um Herkunft und die verwendete Datensatzversion anzugeben. Wenn Sie Werte modifizieren oder mehrere Einträge aggregieren, geben Sie die Transformation an und behalten Sie die ursprüngliche Nennung von TrackCaffeine wie von CC BY 4.0 gefordert bei (CC BY 4.0).

Kommerzielle Wiederverwendung ist unter CC BY 4.0 erlaubt, sofern eine Namensnennung erfolgt; die oben verlinkte Lizenzseite erklärt die rechtlichen Pflichten und die Datensatzseite dokumentiert die verwendete Datensatzversion in abgeleiteten Werken.

Welche praktischen Beispiele zeigen, wie man mit der Datei rechnet, einschließlich Abbau und Tassen-Kaffee-Äquivalenz?

Sie können verbleibendes Koffein über die Zeit mit einem Eliminationsmodell erster Ordnung berechnen, das eine populationsdurchschnittliche Halbwertszeit von 5.7 Stunden verwendet; die Eliminationsrate bei erster Ordnung ist proportional zur aktuellen Konzentration. Das hier verwendete Modell lautet remaining = dose × 0.5^(hours ÷ 5.7) und die Halbwertszeit 5.7 Stunden ist der Populationsdurchschnitt, der in unseren Rechnern verwendet wird.

Beispiel 1: Berechnen Sie das verbleibende Koffein nach 6 Stunden für Starbucks Pike Place Brewed (Grande). Starbucks Pike Place Brewed (Grande) enthält laut Datensatz 310 mg in 473 ml, also remaining = 310 mg × 0.5^(6 ÷ 5.7), was ausgewertet wird zu remaining = 310 mg × 0.5^(1.052631579) = 310 mg × 0.482 ≈ 149 mg; der Datensatzwert 310 mg ist auf der Getränkseite zu sehen und die Rechnung erfolgt mit dem oben genannten Modell erster Ordnung.

Beispiel 2: Berechnen Sie das verbleibende Koffein nach 3 Stunden nach einem 300 mg Energy-Drink wie Bang (Bang ist im Datensatz mit 300 mg für 473 ml verzeichnet). Mit remaining = 300 mg × 0.5^(3 ÷ 5.7) = 300 mg × 0.5^(0.526315789) = 300 mg × 0.697 ≈ 209 mg verbleibend; der Datensatz listet Bang mit 300 mg und die Rechnung nutzt die Datensatzzahl mit dem obigen Halbwertszeitmodell.

Beispiel 3: Tassen-Kaffee-Äquivalenz: Wie viele Lattes entsprechen einem Drip Coffee? Drip coffee hat 96 mg pro 240 ml und Latte hat 68 mg pro 240 ml im Datensatz. Verwenden Sie ratio = 96 mg ÷ 68 mg = 1.411764706, also entspricht ein Drip Coffee etwa 1,41 Lattes; beide Ausgangswerte sind auf den Getränkseiten für Drip coffee (96 mg) und Latte verzeichnet.

Beispiel 4: Espresso-Shot-Äquivalenz: Wie viele einzelne Espressi (63 mg) entsprechen einem Starbucks Grande Brewed mit 310 mg? Verwenden Sie ratio = 310 mg ÷ 63 mg = 4.920634921, also entsprechen ungefähr 4,92 einzelne Espressi der Grande-Brewed-Portion; die numerischen Eingaben 310 mg und 63 mg stammen von den jeweiligen Getränkseiten Starbucks Pike Place Brewed (Grande) und Espresso (single).

Beispiel 5: Verwendung des Datensatzes mit den Rechnern. Wenn Sie interaktiven Abbau oder Schlafenszeitplanung wünschen, können Sie einen caffeine_mg-Wert aus dem JSON in die Rechner unter /tools/caffeine-calculator/ einfügen, zwei Getränke unter /tools/caffeine-comparison/ vergleichen oder die Wirkung der letzten Tasse vor dem Schlafen mit /tools/last-cup-before-bed/ abschätzen. Jeder Rechner verwendet dasselbe Eliminationsmodell erster Ordnung und das exportierte JSON ist zum Kopieren/Einfügen in diese Tools formatiert.

Konkretes Zitat zur Schlafauswirkung: Eine kontrollierte Studie berichtet, dass 400 mg Koffein, vier bis sechs Stunden vor dem Schlafengehen eingenommen, die Gesamtschlafzeit um über eine Stunde reduzierten; diese Studie ist hier zitiert und relevant, wenn Sie den Datensatz zur Planung der Aufnahme verwenden (Drake et al., 2013). Verwenden Sie die Datensatzwerte, um zu berechnen, wie nahe eine Portion an den 400 mg-Richtwert kommt, und nutzen Sie dann die Studie zur Interpretation möglicher Schlaffolgen.

Wenn Sie eine dieser Berechnungen programmgesteuert replizieren möchten, laden Sie das CSV oder JSON von /dataset/, wählen Sie caffeine_mg für die gewünschte ID aus und werten remaining = dose × 0.5^(hours ÷ 5.7) mit der numerischen Dosis aus dem Datensatz aus; die unter /tools/ verlinkten Rechner verwenden denselben Ansatz und sind für interaktive Erkundung gedacht.

Zur schnellen Referenz der in Beispielen genutzten Getränkseiten siehe Espresso (single), Drip coffee, Cold brew, Starbucks Pike Place Brewed (Grande), Bang, Latte und die Rechner unter /tools/caffeine-calculator/, /tools/caffeine-comparison/, /tools/last-cup-before-bed/.

Korrekturen, Anfragen für neue Einträge oder Fragen zur Herkunft sollten über das Kontaktformular unter /contacts/ gesendet werden; das Changelog des Datensatzes und methodische Hinweise sind auf /about/ verfügbar, wo wir Quelleauswahl und Aktualisierungshäufigkeit beschreiben.

Diese Dokumentation dient der Information und der Wiederverwendung von Daten; sie ist keine medizinische Beratung. Für gesundheitliche Hinweise zu sicheren Koffeingrenzen konsultieren Sie regulatorische oder klinische Quellen wie die US Food and Drug Administration, die 400 mg pro Tag für gesunde Erwachsene nennt (FDA) oder die European Food Safety Authority für regionale Stellungnahmen (EFSA, 2015).

Lizenz und Namensnennung: Dieser Datensatz wird unter CC BY 4.0 veröffentlicht; fügen Sie bei Wiederverwendung eine Nennung von TrackCaffeine und einen Link zu CC BY 4.0 hinzu. Wenn Sie große Teile des Datensatzes in einem öffentlichen Produkt wiederverwenden, fügen Sie einen Link zurück zu /dataset/ und eine kurze Herkunftsnotiz mit Nennung von TrackCaffeine als Quelle bei.