카페인 데이터셋

파일에는 무엇이 들어 있으며 각 필드는 무슨 뜻인가요?

파일은 이 페이지에 게재된 87개 음료의 오픈 데이터셋을 JSON 및 CSV로 내보낸 공개 파일이며 정확히 id, name, brand, category, serving_ml, caffeine_mg, caffeine_per_100ml, scales_with_volume 및 is_decaf 필드를 포함합니다. 데이터셋은 이 페이지에 게시된 87개 레코드의 테이블입니다.

파일 형식은 음료당 하나의 레코드를 포함합니다; 파일의 각 레코드는 CSV의 행과 JSON의 객체에 직접 대응하며, 데이터셋은 8개 카테고리 전반에 걸쳐 87개의 레코드를 집계합니다: espresso 12, brewed 8, coffeeShop 20, energy 15, tea 11, soda 11, preworkout 5 및 other 5(카테고리별 개수는 데이터셋의 일부입니다). 이들 숫자 각각은 데이터셋에 기록되어 있으며 /dataset/ export를 통해 프로그램적으로 필터링할 수 있습니다.

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는 개수를 집계하는 데 사용되는 범주 레이블이며(데이터셋에는 espresso 항목 12개, brewed 항목 8개 등 포함) 그 개수는 데이터셋 헤더에 명시되어 있습니다.

serving_ml은 서빙 부피를 밀리리터 단위로 표기한 것입니다. 예를 들어 Espresso (single)의 serving_ml은 30 ml이고 Starbucks Pike Place Brewed (Grande)의 serving_ml은 473 ml이며, 두 숫자 모두 데이터셋에 기록됩니다.

caffeine_mg는 서빙당 절대 카페인 양을 밀리그램 단위로 나타낸 것입니다. caffeine_mg는 각 서빙에 할당된 수치형 카페인 값입니다; 예를 들어 데이터셋에는 Espresso (single)의 caffeine_mg가 63 mg로, Starbucks Pike Place Brewed (Grande)의 caffeine_mg가 310 mg로 기록되어 있습니다.

caffeine_per_100ml는 해당 값이 적절하고 사용 가능한 경우 100 ml당 mg로 정규화한 카페인 농도입니다; 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로 표시되며, 단위 기반 항목(예: 단일 에스프레소 샷)처럼 카페인이 ml에 비례하지 않고 샷 단위로 결정되는 경우에는 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가 기재되어 있다면 병 크기가 명시되어 데이터셋 행의 serving_ml과 일치하는 경우에만 기록되며, 각 포함 항목은 항목 페이지에 출처를 명시합니다.

서빙_ml과 일치하는 단위로 분석 결과를 보고하는 경우에는 USDA와 같이 색인된 독립 실험실 측정치도 수용합니다; USDA 또는 동료 검토 방법이 mg/100 ml 단위의 농도를 보고하면 해당 값을 기록된 serving_ml에 맞춰 caffeine_mg로 변환하고 원래 분석을 항목 페이지 및 데이터셋 메타데이터에 인용합니다 (USDA FoodData Central).

서빙 크기가 모호한 경우(예: 표준 서빙이 없는 메뉴 범위), 출처가 측정 가능한 방법이 없는 일화 수준의 자료인 경우, 또는 보고된 값이 여러 신뢰할 수 있는 출처와 모순되며 조정 가능한 근거가 없는 경우 후보 값은 실격 처리됩니다. 분산이 크고 대표 서빙이 없는 항목은 신뢰할 수 있는 단일 값이 확립될 때까지 제외됩니다.

우리는 serving_ml이나 caffeine_mg를 임의로 생성하지 않습니다; 내보낸 파일의 모든 수치는 작성된 데이터셋 행에 의해 뒷받침되며, 출처가 제조사 선언인 경우에는 해당 음료 페이지가 가능한 경우 기초 메뉴나 라벨에 링크합니다.

수정 및 이의 제기는 about 페이지에 설명된 수정 절차와 연락 양식을 통해 처리됩니다; 방법은 /about/에서 확인하고 데이터 수정 제출 방법은 /contacts/를 참조하세요.

왜 출처마다 발표된 카페인 수치가 다르나요?

같은 음료 이름이 서로 다른 서빙 크기, 서로 다른 추출 강도, 지역별 조성 차이, 또는 다른 측정 관행을 나타낼 수 있기 때문에 발표된 카페인 수치가 다릅니다; 이 네 가지 구체적 요인이 데이터셋에서 관찰되는 대부분의 차이를 설명합니다. 이러한 불일치의 출처는 항목별 페이지에 문서화되어 있으며 데이터셋은 사용된 수치와 그 출처를 목록화합니다.

서빙 크기 규약이 보고된 총량을 바꿉니다: 예를 들어 데이터셋은 Starbucks Pike Place Brewed (Grande)를 473 ml 서빙에서 310 mg로 기록하고 있지만 지역 메뉴는 다른 크기를 보고할 수 있습니다; 데이터셋의 310 mg 수치는 Starbucks가 발표한 473 ml Grande 서빙의 영양 정보에서 가져온 것이며 항목 페이지에 인용되어 있습니다.

추출 강도 차이는 빈번한 원인입니다: 데이터셋의 드립 커피는 240 ml당 96 mg인 반면 포어오버는 240 ml당 145 mg로 기재되어 있습니다; 두 값 모두 데이터셋에 포함되어 있으며 다른 추출 강도와 분쇄/추출 비율을 반영합니다. 데이터셋은 드립 커피 96 mg(240 ml)와 pour over 145 mg(240 ml)를 기록하며 해당 값들은 각각의 페이지에서 확인할 수 있습니다 (Drip coffee, Pour over).

지역별 조성이나 레시피 차이는 선언된 카페인을 변경합니다: 병입된 Coca-Cola 항목은 포장량이 330 ml인지 355 ml인지에 따라 캔당 32–34 mg를 보일 수 있으며, 데이터셋에는 포장 및 표기 차이를 반영하기 위해 Coca-Cola (330 ml) 32 mg와 Coca-Cola (355 ml) 34 mg가 모두 포함되어 있습니다.

라벨 반올림과 선언값 대 측정값의 차이는 작은 불일치를 만듭니다: 제조사는 영양표에 반올림된 숫자를 기재하는 경우가 있고 실험실은 더 정밀한 측정값을 보고합니다; 데이터셋은 출처가 선언 라벨일 경우 그 선언값을 보존하고, 측정값이 있는 경우에는 측정 농도를 표기합니다.

성분 출처와 첨가 자극제는 커피/차 이외의 음료에서도 카페인을 변경할 수 있습니다: 에너지 음료와 프리워크아웃 보충제는 때때로 caffeine anhydrous, guarana 또는 기타 성분을 사용하여 총 mg와 농도를 변경합니다; 우리 데이터셋은 최종 caffeine_mg를 브랜드가 선언한 값이나 항목 상세 페이지에 목록화된 제품 라벨과 같은 공개 소스에서 측정된 값으로 기록합니다.

이 데이터셋의 알려진 한계는 무엇인가요?

이 데이터셋은 음료당 단일 대표 caffeine_mg만 제공하며 배치 내 변동이나 바리스타별 편차를 포착하지 않습니다; 단일 값 접근법은 설계상의 선택으로, 내보내기는 음료의 농도 분포 전체를 표현할 수 없습니다. 예를 들어 데이터셋은 Cold brew를 240 ml당 200 mg로, Nitro cold brew를 240 ml당 215 mg로 기재하지만 개별 제조물은 그 수치 주변에서 변동할 것입니다.

개인별 약동학과 민감도는 데이터셋의 범위를 벗어납니다; 데이터셋은 음료 카페인 양의 콘텐츠 표이며 개인 투여 권장이나 의학적 지침을 제공하지 않습니다. 안전한 일일 섭취 지침은 규제 기관에서 제공하며 데이터셋은 해당 지침을 참조합니다: 미국 식품의약국은 건강한 성인의 지침으로 하루 400 mg을 언급합니다 (FDA).

디카페인 항목은 0이 아닙니다: 데이터셋은 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를 사용하는 1차 제거 모델로 시간 경과에 따른 남은 카페인을 계산할 수 있습니다; 1차 제거는 제거 속도가 현재 농도에 비례하는 약동학 모델입니다. 여기서 사용한 모델은 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는 음료 페이지에 표시되어 있고 산술 계산은 위에 기록된 1차 모델로 수행됩니다.

예제 2: 473 ml에 300 mg으로 기록된 Bang과 같은 에너지 음료의 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: 커피 잔 수 동등성: 드립 커피 몇 잔이 라떼 한 잔과 동등한가? 데이터셋에서 드립 커피는 240 ml당 96 mg이고 Latte는 240 ml당 68 mg입니다. ratio = 96 mg ÷ 68 mg = 1.411764706 이므로 드립 커피 한 잔은 대략 1.41 라떼에 해당합니다; 두 출처 숫자는 Drip coffee(96 mg)와 Latte(68 mg) 항목 페이지에 기록되어 있습니다.

예제 4: 에스프레소 샷 동등성: 단일 에스프레소(63 mg) 몇 잔이 Starbucks Grande brewed 310 mg과 같은가? ratio = 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/의 계산기에 붙여넣고, 두 음료를 비교하려면 /tools/caffeine-comparison/, 취침 전 마지막 컵의 영향을 추정하려면 /tools/last-cup-before-bed/을 사용하세요. 각 계산기는 동일한 1차 제거 모델을 사용하며 내보낸 JSON은 해당 도구에 복사/붙여넣기하기 적합한 형식입니다.

수면 영향의 구체적 인용: 통제된 연구는 취침 6시간 전에 400 mg의 카페인을 섭취하면 총 수면 시간이 한 시간 이상 줄어들었다고 보고합니다; 해당 연구는 여기에서 인용되며 데이터셋을 사용해 섭취를 계획할 때 관련이 있습니다 (Drake et al., 2013). 데이터셋 값을 사용해 서빙이 400 mg 지침에 얼마나 근접한지 계산한 다음 연구를 사용해 잠재적 수면 영향을 해석하세요.

이 계산들을 프로그램으로 재현하려면 /dataset/에서 CSV 또는 JSON을 로드하고 원하는 ID의 caffeine_mg를 선택한 뒤 remaining = dose × 0.5^(hours ÷ 5.7) 공식을 데이터셋의 수치형 dose로 평가하세요; /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/에서 확인하세요.

이 문서는 정보 제공을 위한 것이며 데이터 재사용을 목적으로 합니다; 의학적 조언이 아닙니다. 안전한 카페인 한도에 관한 건강 지침은 규제 기관이나 임상 출처를 참조하세요. 예를 들어 미국 식품의약국은 건강한 성인의 하루 섭취 권장량을 400 mg으로 명시합니다 (FDA) 또는 지역별 의견은 유럽 식품안전청에서 확인할 수 있습니다 (EFSA, 2015).

라이선스 및 저작자 표시: 이 데이터셋은 CC BY 4.0 하에 게시됩니다; 데이터를 재사용할 때는 TrackCaffeine에 대한 저작자 표시와 CC BY 4.0에 대한 링크를 포함하세요. 데이터셋의 큰 부분을 공개 제품에 재사용하는 경우 /dataset/로의 링크와 TrackCaffeine을 출처로 명시하는 짧은 출처 정보를 포함하세요.