ingredient-evidence-register
收藏资源简介:
Vallydia 成分证据注册表是一个开放、证据分级的参考数据集,专注于化妆品和研究成分。它包含85种化合物,涵盖肽、小分子、蛋白质和混合物等类别。该数据集的核心特点是提供按具体结果划分的A-F证据等级(共456个分级结果行),而非对化合物进行单一整体评价。数据集还包含125个经过DOI验证的引用来源,为证据提供可信度支撑;246个机器可读的化妆品声称映射,区分了允许和禁止的声称;132个按地区(国际、欧盟、美国、英国)划分的法律状态行,以及19个世界反兴奋剂机构(WADA)禁用状态标识。数据集提供了化学标识符(如CAS、PubChem CID、InChIKey、SMILES),每个都带有明确的置信度和来源说明,对于无法明确匹配的21种化合物,相关字段被有意留空。此外,还包含了从高置信度SMILES生成的分子结构图像(42个2D结构)和大分子数据卡(22个)。数据集旨在解决化妆品和研究化合物市场中声称超越证据的问题,通过公开证据评估促进透明度。它适用于证据等级分类、基于证据的问答、监管声称检查以及检索增强生成等任务。数据集以多种结构化格式提供,包括规范的JSONL/JSON文件、扁平CSV表、用于分析的长表(如grades.csv, legal_status.csv)、Parquet镜像文件以及用于检索的语料库(corpus.jsonl)。数据集明确声明不包含剂量、管理或商业数据,并非医疗建议,其证据等级是Vallydia自身的评估,未经外部同行评审。使用时需注意可能存在的覆盖偏差、文献偏差以及监管数据的时效性。数据集采用CC-BY-4.0许可,要求在使用时进行署名。
The Vallydia Ingredient Evidence Registry is an open, evidence-graded reference dataset focused on cosmetic and research ingredients. It contains 85 compounds, covering categories such as peptides, small molecules, proteins, and mixtures. The core feature of the dataset is the provision of A-F evidence grades (totaling 456 graded result rows) divided by specific outcomes, rather than a single overall evaluation of compounds. The dataset also includes 125 DOI-verified citation sources to support evidence credibility; 246 machine-readable cosmetic claim mappings, distinguishing between allowed and prohibited claims; 132 legal status rows categorized by region (International, EU, US, UK), and 19 World Anti-Doping Agency (WADA) prohibited status identifiers. The dataset provides chemical identifiers (e.g., CAS, PubChem CID, InChIKey, SMILES), each with clear confidence and source annotations, with fields intentionally left blank for 21 compounds that cannot be definitively matched. Additionally, it contains molecular structure images generated from high-confidence SMILES (42 2D structures) and macromolecule data cards (22). The dataset aims to address the issue of claims exceeding evidence in the cosmetic and research compound markets by promoting transparency through open evidence assessment. It is suitable for tasks such as evidence grade classification, evidence-based question answering, regulatory claim checking, and retrieval-augmented generation. The dataset is provided in multiple structured formats, including canonical JSONL/JSON files, flat CSV tables, long tables for analysis (e.g., grades.csv, legal_status.csv), Parquet mirror files, and a corpus for retrieval (corpus.jsonl). The dataset explicitly states that it does not include dosage, administration, or commercial data, is not medical advice, and its evidence grades are Vallydias own assessments without external peer review. Users should be aware of potential coverage bias, literature bias, and the timeliness of regulatory data. The dataset uses the CC-BY-4.0 license, requiring attribution upon use.
Vallydia Ingredient-Evidence Register 数据集详情
基本信息
- 许可证: CC-BY-4.0
- 语言: 英语
- 数据集名称: Vallydia Ingredient-Evidence Register
- 数据集大小: n<1K 条记录
- 标签: cosmetics, skincare, ingredients, evidence, peptides, dermatology, tabular
- 支持任务: 文本分类、问答
数据集内容
该数据集是一个基于证据评级的开放参考数据集,涵盖 85 种化妆品和研究用成分(肽类、小分子、蛋白质和混合物),由 Vallydia 发布。
核心内容
- 证据等级评估: 针对每种成分的每个结局给出 A-F 等级,共 456 条已分级结局记录
- DOI 验证引文: 125 条引用已解析至 DOI 并验证标题,涵盖 51 种成分
- 化妆品声明映射: 21 种化妆品成分,共 246 条允许/禁止声明记录
- 法律状态: 按区域(INT/EU/US/UK)共 132 条记录,含 WADA 禁用状态(19 种)
- 化学标识符: 64 种成分有高置信度标识符(CAS、PubChem CID、InChIKey、SMILES),21 种诚实标注为空白
- 分子结构图像: 42 张 2D 结构图像 + 22 张大分子数据卡片
证据等级说明
| 等级 | 含义 |
|---|---|
| A | 强有力且一致的人类证据 |
| B | 良好的人类证据,但效果较小或依赖配方 |
| C | 混合或有限的人类证据 |
| D | 弱证据——仅有机理或极小规模研究 |
| F | 未经测试/未证实,或经测试但失败 |
null |
非功效声明行(如安全性、皮肤渗透),不强制转换为字母 |
数据集结构
数据集提供多种格式的表格:
主要配置与数据文件
| 配置名 | 数据文件 |
|---|---|
| compounds | data/parquet/compounds.parquet |
| grades | data/parquet/grades.parquet |
| legal_status | data/parquet/legal_status.parquet |
| citations | data/parquet/citations.parquet |
| cosmetic_claims | data/parquet/cosmetic_claims.parquet |
| identifiers | data/parquet/identifiers.parquet |
文件格式
- 规范无损格式:
data/compounds.jsonl(完整嵌套结构)、data/compounds.json - 平面表格:
data/compounds.csv - 长/整洁表格:
data/grades.csv、data/legal_status.csv、data/citations.csv、data/citations_enriched.csv、data/cosmetic_claims.csv、data/identifiers.csv - Parquet 镜像:
data/parquet/*.parquet - 检索语料库:
data/corpus.jsonl - 图像:
images/structures/和images/grade-cards/目录下的 SVG/PNG 文件
命名规范
- 等级基于非专有名(化妆品用 INCI 名称、药品用 INN 名称)进行评定
- 商品名仅记录在
trade_names字段中,不参与等级评定
使用注意事项
- 非医疗建议: 不提供剂量、给药或复溶信息
- 等级是评估而非测量: 反映对文献基础的判断,合理专家可能有不同意见
- 覆盖偏差: 涵盖 Vallydia 用户实际关注的化妆品活性成分和研究用肽类
- 文献偏差: 等级继承发表文献的偏差(小样本、行业资助、发表偏倚)
- 监管数据会过时: 法律状态反映
last_updated字段日期
工具与访问层
- API: 提供只读 OpenAPI 3.1 服务(FastAPI 参考实现 + Dockerfile)
- Python 包:
vallydia-registerpip 包 - npm 包:
@vallydia-data/ingredient-registernpm 包 - 验证套件:
build/validate_dataset.py
引用方式
- DOI:
10.5281/zenodo.21364453 - 引用时应使用概念 DOI,始终指向最新版本




