カフェインデータセット

ファイルには何が含まれており各フィールドは何を意味しますか？

このファイルはこのページで公開されているオープンデータセット（87件のドリンク）のJSONおよびCSVエクスポートで、正確に id, name, brand, category, serving_ml, caffeine_mg, caffeine_per_100ml, scales_with_volume および is_decaf の各フィールドを含みます。データセットとはこのページで公開されている87レコードのドリンク表を指します。

ファイル形式はドリンクごとに1レコードを含み、ファイル内の各レコードはCSVの行およびJSONのオブジェクトに直接対応します。データセットは8つのカテゴリにまたがる合計87レコードを含みます：espresso 12、brewed 8、coffeeShop 20、energy 15、tea 11、soda 11、preworkout 5、other 5（カテゴリごとの件数はデータセットの一部です）。これらの数値はデータセット内に記録されており、/dataset/ エクスポート経由でプログラムからフィルタリング可能です。

id はJSONやCSVでレコードを検索する際に使う短い機械識別子です。idフィールドは87レコードそれぞれで一意であり、データセットに対するプログラム的な結合の主キーです。

name は公開ドリンクページに表示される人間が読めるドリンク名です。例えば Espresso (single) では名前が "Espresso (single)" と表示され、そのページで63 mgと報告されています；この63 mgはデータセット内の該当アイテムの caffeine_mg に記録されています。

brand は該当する場合の商業的所有者や出典で、該当しない一般的な項目は空文字列になります。例えば Starbucks Pike Place Brewed (Grande) のデータセット行では brand フィールドに Starbucks が入り、caffeine_mg フィールドには 310 mg が記録されています。

category は各レコードを八つのグループ（espresso, brewed, coffeeShop, energy, tea, soda, preworkout, other）いずれかに分類するカテゴリラベルです。category は件数集計に使われます（データセットには12件のespresso、8件のbrewedなどが含まれます）し、これらの件数はデータセットヘッダーに記載されています。

serving_ml は提供量をミリリットルで表した値です。例えば Espresso (single) の serving_ml は 30 ml、Starbucks Pike Place Brewed (Grande) の serving_ml は 473 ml で、これらの数値はデータセットに記録されています。

caffeine_mg は1サービングあたりのカフェイン量をミリグラムで示す絶対量です。caffeine_mg は各サービングに割り当てられた数値で、例えばデータセットには Espresso (single) の caffeine_mg として 63 mg、Starbucks Pike Place Brewed (Grande) の caffeine_mg として 310 mg が記録されています。

caffeine_per_100ml は適切かつ利用可能な場合に、100 ml あたりの正規化されたカフェイン濃度（mg/100 ml）を示します。caffeine_per_100ml は異なる提供量間で強度を比較するための濃度指標で、例えば Cold brew（83.3 mg/100 ml）や Drip coffee（40 mg/100 ml）などのエントリに対してこの値が保存されています。

scales_with_volume はカフェイン値が容積にほぼ線形に比例して変化すると予想されるかどうかを示すブールフラグです（true/false）。scales_with_volume は濃度がほぼ一定の単純な抽出コーヒーでは true になり、単位ベースの項目（単一のエスプレッソショットのようにカフェインがショット単位で決まる項目）では false になります。

is_decaf はデカフェで調製された飲料を示すブールフラグです；is_decaf が true の場合はデカフェ項目であり、例えばデータセットでは Decaf coffee が caffeine_mg 3 mg で is_decaf true と表示されています。

どのようにして値がデータセットに入るのか、また候補が不適格になる条件は？

値は文書化された出典が確認され、明確なサービングサイズが定義された後にのみ追加されます。エントリは供給者ラベル、公開されたメニューニュートリション、USDA FoodData Central のようなラボ分析、または利用可能な場合は査読済みの測定値に由来します。USDA FoodData Central は宣言値や測定値の参照ソースのひとつであり、そのソースが利用された場合はアイテムページで明示的に引用されます（USDA FoodData Central）。

包含には検証可能な数値の caffeine_mg と安定した serving_ml、またはその項目が単位ベースである明確な理由（例えばエスプレッソショットやカフェイン錠剤）が必要です。検証可能なサービングがない、あるいは数値のカフェイン値がないレコードは不適格となり公開エクスポートに追加されません。

メーカーが宣言した値（栄養表示や公開メニュー）も、表示されたラベルがサービング定義と一致する場合に受け入れます。例えばラベルが「300 ml ボトルあたり 200 mg」と記載している場合、そのボトルサイズが明示されサービング_ml と一致していれば記録され、各そのような包含はドリンクページ上で出典を明記します。

USDA によって索引付けされたような独立したラボ測定値も、測定単位が当社の serving_ml と一貫している場合は受け入れます。USDA や査読済み手法が mg/100 ml で濃度を報告している場合、記録された serving_ml に対応する caffeine_mg に変換し、元のアッセイをドリンクページとデータセットのメタデータで引用します（USDA FoodData Central）。

サービングサイズがあいまいな場合（例えば標準サービングが定まらないメニューの範囲）、出典が測定可能な手法に基づかない逸話的なものである場合、または報告値が複数の信頼できる出典と矛盾していて整理がつかない場合は候補値を不適格とします。大きなばらつきがあり代表的なサービングが確定できない項目は、信頼できる単一の値が確立されるまで除外されます。

我々はサービングサイズや caffeine_mg をでっち上げることはありません；エクスポートファイル内のすべての数値は作成されたデータセット行に裏付けられており、出典がメーカー宣言の場合は可能な限りドリンクページから元のメニューやラベルにリンクしています。

訂正や異議はaboutページで説明している訂正手続きおよびお問い合わせフォームを通じて処理します；手続きについては /about/ を、データ訂正の提出方法については /contacts/ を参照してください。

公開されているカフェイン値が出典によって異なるのはなぜですか？

公開されているカフェイン値が出典ごとに異なるのは、同じドリンク名が異なるサービングサイズ、異なる抽出強度、地域ごとの処方差、あるいは異なる測定慣行を表すことがあるためです；これら4つの具体的要因がデータセットで観察される差異の大部分を説明します。これらの相違の原因は個々のドリンクページで文書化されており、データセットは使用した数値とその出所を一覧表示します。

サービングサイズの慣習が報告総量を変動させます：例えばデータセットでは Starbucks Pike Place Brewed (Grande) を 473 ml サービングで 310 mg と記録していますが、地域のメニューでは異なるサイズを報告していることがあります；データセットの 310 mg は Starbucks の公開栄養情報に基づく473 ml Grande サービングから来ており、ドリンクページで引用されています。

抽出強度の違いは頻繁な原因です：当サイトのデータセットでは drip coffee が 240 ml あたり 96 mg、一方 pour over は 240 ml あたり 145 mg と表示されています。どちらの値もデータセットに含まれ、抽出強度や挽き目／抽出比の違いを反映しています。データセットは drip coffee を 96 mg（240 ml）、pour over を 145 mg（240 ml）として記録し、それぞれのページで具体的な値が確認できます（Drip coffee, Pour over）。

地域ごとの処方やレシピの差は宣言カフェイン量を変えることがあります：例えばボトル入りの Coca-Cola はパッケージが330 mlか355 mlかによって1缶あたり32–34 mgと表示されることがあり、データセットにはパッケージや表示の差を反映するために Coca-Cola (330 ml) 32 mg と Coca-Cola (355 ml) 34 mg の両方が含まれています。

表示値の丸めや宣言値と測定値の差により小さな不一致が生じます：メーカーは栄養表で丸めた数値を宣言することがあり、ラボはより精密な測定値を報告します。データセットは出所がラベルの宣言である場合はその宣言数値を保存し、測定値がある場合は測定濃度を明示します。

原料由来や添加された刺激物はコーヒー／茶以外でもカフェイン量を変えることがあります：エナジードリンクやプレワークアウト補助食品はしばしば無水カフェイン、ガラナなどを使用し、総mg数や濃度に影響します。我々のデータセットはブランドが宣言した最終的な caffeine_mg または公開出典（製品ラベルページ等）で測定された値を記録します。

このデータセットの既知の制約は何ですか？

このデータセットはドリンクごとに単一の代表的な caffeine_mg を提供しており、バッチ内やバリスタごとのばらつきを捉えていません；単一値アプローチは設計上の選択であり、エクスポートはあるドリンクの濃度分布全体を表現することはできません。例えばデータセットでは Cold brew を 240 ml あたり 200 mg、Nitro cold brew を 240 ml あたり 215 mg としていますが、個々の調製はこれらの数値の周りで変動します。

集団薬物動態や個人差の感受性はデータセットの範囲外です；データセットは飲料のカフェイン量のコンテンツ表であり、個別の投与推奨や医療的助言は提供しません。安全な1日摂取量の指針は規制機関から入手可能であり、データセットはその指針を参照しています：US Food and Drug Administration は健康な成人の目安として1日あたり400 mgを挙げています（FDA）。

デカフェ項目はゼロではありません：データセットは Decaf coffee を 240 ml あたり 3 mg と記録しており、デカフェ調製でも微量のカフェインが残存することが多く、カフェインフリーと仮定すべきではないことを示しています。

一部のレコードは単位ベースで、利便性のために serving_ml を 0 にしているものがあります（例えば錠剤やガム）。データセットは Caffeine pill (200 mg) を 200 mg かつ serving_ml 0 としてリストしており、これは体積が該当しない項目であることを反映しており、容積あたりの比較における制約です。

網羅的でも世界的に包括的でもない：データセットは一般的なドリンクやブランドを代表するために選ばれた87レコードを含み、意図的に範囲を限定しています；エクスポートは世界中のすべての製品を網羅しようとするものではなく、収集は精選されたサンプルとして扱うべきです。

ラボ測定と宣言値の差は依然として起こり得ます：複数の信頼できる出典が矛盾する場合、我々はより具体的な出典を選びその選択をドリンクページで文書化します；任意のアイテムについて出所リンクは個別ページで確認でき、矛盾する測定値がある場合は /contacts/ からご連絡ください。

このデータセットをどのように引用または再利用すればよいですか？

データセットは CC BY 4.0 の下でライセンスされており、TrackCaffeine への帰属が必要です；CC BY 4.0 はデータセットに適用されるライセンスであり法的条件はここにリンクされています（CC BY 4.0）。推奨される引用形式は TrackCaffeine Dataset (2026) です。TrackCaffeine を帰属先として明記し、データセットのエクスポートページのURLを帰属に含めるのが正式な方法です。

データを再利用する際の短い引用例は次の通りです："TrackCaffeine. Open caffeine dataset. CC BY 4.0. https://trackcaffeine.com/dataset/" および出典とデータセットのバージョンを示すために /dataset/ へのリンクを含めてください。値を改変したり複数アイテムを集計した場合は変換を明記し、CC BY 4.0 に従って元の帰属である TrackCaffeine を残してください（CC BY 4.0）。

商業的再利用は帰属が提供される限り CC BY 4.0 の下で許可されます；上記のライセンスページは法的義務を説明しており、データセットページ自体が派生作品で使用したデータセットのバージョンを記録します。

ファイルを使って計算する方法の実例（消失率やコーヒー杯換算を含む）は？

残存カフェイン量は平均集団の半減期5.7 hours を使った一次消失モデルで計算できます；一次消失は消失率が現在の濃度に比例する薬物動態モデルです。ここで用いるモデルは remaining = dose × 0.5^(hours ÷ 5.7) で、半減期5.7 hours は我々の電卓で用いる集団平均値です。

例1：Starbucks Pike Place Brewed (Grande) の6時間後の残存カフェインを計算します。データセットでは Starbucks Pike Place Brewed (Grande) は 473 ml あたり 310 mg なので、remaining = 310 mg × 0.5^(6 ÷ 5.7) で、計算すると remaining = 310 mg × 0.5^(1.052631579) = 310 mg × 0.482 ≈ 149 mg になります；データセット値 310 mg はドリンクページに表示され、算術は上記の一次モデルで行われます。

例2：300 mg のエナジードリンク（例：Bang、データセットでは Bang は 473 ml あたり 300 mg と記録）を飲んでから3時間後の残存量を計算します。remaining = 300 mg × 0.5^(3 ÷ 5.7) = 300 mg × 0.5^(0.526315789) = 300 mg × 0.697 ≈ 209 mg が残存します；データセットは Bang を 300 mg としており、算術は上記の半減期モデルを使用しています。

例3：コーヒー杯換算：ラテ何杯がドリップコーヒー1杯に相当するか？データセットでは Drip coffee が 240 ml あたり 96 mg、Latte が 240 ml あたり 68 mg です。比率 = 96 mg ÷ 68 mg = 1.411764706、したがってドリップコーヒー1杯は約1.41杯のラテに相当します；両方の元データは個別のドリンクページに記録されています（Drip coffee（96 mg）および Latte（68 mg））。

例4：エスプレッソショット換算：単一エスプレッソ（63 mg）何杯が Starbucks の Grande brewed 310 mg に相当するか？比率 = 310 mg ÷ 63 mg = 4.920634921、つまりおおよそ 4.92 杯の単一エスプレッソが Grande brewed サービングに相当します；数値入力の 310 mg と 63 mg はそれぞれのドリンクページに由来します（Starbucks Pike Place Brewed (Grande) と Espresso (single)）。

例5：データセットを電卓と併用する場合。インタラクティブな消失計算や就寝前の計画をしたい場合は、JSON から caffeine_mg の値をコピーして /tools/caffeine-calculator/ の電卓に貼り付けたり、2つのドリンクを比較するには /tools/caffeine-comparison/ を、就寝前の最後の一杯の影響を推定するには /tools/last-cup-before-bed/ を使用できます。各電卓は同じ一次消失モデルを使い、エクスポートされたJSONはこれらのツールにコピー／ペーストしやすい形式です。

睡眠影響の具体的根拠：コントロールされた研究は就寝6時間前に400 mgのカフェインを摂取すると総睡眠時間が1時間以上短くなることを報告しています；この研究はここで引用されており、データセットを使って摂取計画を立てる際の参考になります（Drake et al., 2013）。データセットの値を使ってサービングが400 mgの指針にどれだけ近いかを計算し、その研究を用いて潜在的な睡眠への影響を解釈してください。

これらの計算をプログラム的に再現する場合は、CSV または JSON を /dataset/ から読み込み、目的の ID に対する caffeine_mg を選択して remaining = dose × 0.5^(hours ÷ 5.7) を評価してください；/tools/ にリンクされた電卓は同じアプローチを使っており、インタラクティブな探索を目的としています。

例で使われた一般的なドリンクページへのクイック参照は次の通りです：Espresso (single), Drip coffee, Cold brew, Starbucks Pike Place Brewed (Grande), Bang, Latte、および電卓群 /tools/caffeine-calculator/, /tools/caffeine-comparison/, /tools/last-cup-before-bed/。

訂正、新規項目のリクエスト、出所に関する質問は /contacts/ のお問い合わせフォームから送信してください。データセットの変更履歴および方法ノートはソース選定や更新頻度の説明を含む /about/ にあります。

このドキュメントは情報提供を目的としたデータ再利用のためのものであり、医療助言ではありません。安全なカフェイン上限に関するヘルスガイダンスについては規制機関や臨床情報を参照してください。例えば US Food and Drug Administration は健康な成人の1日あたりの目安を400 mgとしています（FDA）、地域の見解については European Food Safety Authority を参照してください（EFSA, 2015）。

ライセンスと帰属：このデータセットは CC BY 4.0 の下で公開されています；データを再利用する際は TrackCaffeine への帰属と CC BY 4.0 へのリンクを含めてください。データセットの大部分を公開製品で再利用する場合は /dataset/ へのリンクと TrackCaffeine を出典として明記した短い出所メモを含めてください。