brandburner/doctorwho-s08-narrative-kg

--- license: cc-by-sa-4.0 task_categories: - graph-ml - text-generation tags: - narrative - knowledge-graph - screenplay - fabula - neo4j - graph-gravity size_categories: - 1K<n<10K --- # Doctor Who - Narrative Knowledge Graph A rich narrative knowledge graph extracted from *Doctor Who* screenplays using the [Fabula](https://fabula.productions) pipeline. Contains characters, locations, objects, organizations, events, themes, and conflict arcs with full participation semantics and Graph Gravity importance tiers. ## Dataset Overview | Metric | Value | |--------|-------| | Source database | `doctorwho.s08` | | Type | Season database | | Episodes | 25 | | Total nodes | 4,771 | | Total edges | 15,349 | | Schema version | 1.1.0 | | Exported | 2026-04-08 | ### Entity Breakdown | Type | Count | |------|-------| | Act | 64 | | Agent | 252 | | ConflictArc | 102 | | Episode | 25 | | Event | 883 | | Location | 238 | | Object | 858 | | Organization | 71 | | PlotBeat | 1,492 | | SceneBoundary | 678 | | Theme | 108 | ### Graph Gravity Tiers | Tier | Count | Description | |------|-------|-------------| | anchor | 35 | Main characters / key locations | | planet | 268 | Recurring entities | | asteroid | 1,116 | Minor / one-off entities | ### Relationship Types `AFFILIATED_WITH`, `BELONGS_TO_EPISODE`, `CALLBACK`, `CAUSAL`, `CHARACTER_CONTINUITY`, `CONTAINS_ACT`, `CONTAINS_BEAT`, `CONTAINS_SCENE`, `EMOTIONAL_ECHO`, `ESCALATION`, `EXEMPLIFIES_THEME`, `FORESHADOWING`, `INVOLVED_IN_ARC`, `INVOLVED_WITH`, `IN_EVENT`, `NARRATIVELY_FOLLOWS`, `OCCURS_IN`, `PARTICIPATED_AS`, `PART_OF`, `PART_OF_ACT` ... and 5 more ## Related Datasets This is a **single-season** dataset containing entities and events as extracted from Season 8 screenplays. - **Megagraph** (all seasons unified): [brandburner/doctorwho-mega-narrative-kg](https://huggingface.co/datasets/brandburner/doctorwho-mega-narrative-kg) > **Note:** The megagraph is *not* a simple union of season datasets. Cross-season entities are reconciled through a Global Entity Registry (GER), receiving new canonical UUIDs and distilled descriptions. Graph Gravity tiers are recalculated across all episodes. Use individual season datasets for single-season analysis; use the megagraph for cross-season analysis. ## Files | File | Description | |------|-------------| | `nodes.parquet` | All graph nodes with properties | | `edges.parquet` | All relationships with properties | | `positions.parquet` | 3D layout coordinates for visualization | | `meta.json` | Dataset metadata and entity counts | ## Schema ### Nodes (`nodes.parquet`) | Column | Type | Description | |--------|------|-------------| | `node_id` | string | Unique node identifier (UUID) | | `primary_label` | string | Node type (Agent, Location, Event, etc.) | | `name` | string | Display name | | `description` | string | Foundational description | | `tier` | string (nullable) | Graph Gravity tier: anchor / planet / asteroid | | `episode_count` | int (nullable) | Number of distinct episodes entity appears in | | `first_episode_seq` | int (nullable) | First appearance episode | | `last_episode_seq` | int (nullable) | Last appearance episode | | `properties_json` | string | Full node properties as JSON | ### Edges (`edges.parquet`) | Column | Type | Description | |--------|------|-------------| | `source_node_id` | string | Source node UUID | | `target_node_id` | string | Target node UUID | | `relationship_type` | string | Relationship type (e.g., PARTICIPATED_AS) | | `properties_json` | string | Edge properties as JSON | ### Positions (`positions.parquet`) | Column | Type | Description | |--------|------|-------------| | `node_id` | string | Node UUID | | `x`, `y`, `z` | float | 3D coordinates | | `size` | float | Node size (Graph Gravity weighted) | | `r`, `g`, `b` | int | RGB color by entity type | | `community` | int | Louvain community index | | `tier` | string (nullable) | Graph Gravity tier | ## Usage ```python from datasets import load_dataset import pandas as pd # Load from HuggingFace ds = load_dataset("brandburner/doctorwho-s08-narrative-kg") # Or load parquet directly nodes = pd.read_parquet("nodes.parquet") edges = pd.read_parquet("edges.parquet") # Filter to anchor characters anchors = nodes[(nodes['primary_label'] == 'Agent') & (nodes['tier'] == 'anchor')] # Build a NetworkX graph import networkx as nx G = nx.DiGraph() for _, n in nodes.iterrows(): G.add_node(n['node_id'], label=n['primary_label'], name=n['name']) for _, e in edges.iterrows(): G.add_edge(e['source_node_id'], e['target_node_id'], type=e['relationship_type']) ``` ## Citation ```bibtex @misc{fabula_doctorwho_s08, title = {Doctor Who Narrative Knowledge Graph}, author = {Fabula Pipeline}, year = {2026}, publisher = {HuggingFace}, howpublished = {\url{https://huggingface.co/datasets/brandburner/doctorwho-s08-narrative-kg}} } ``` ## License CC BY-SA 4.0许可证：CC BY-SA 4.0 任务类别： - 图机器学习（graph-ml） - 文本生成 标签： - 叙事 - 知识图谱 - 剧本 - Fabula - Neo4j - 图引力（graph-gravity） 规模类别： - 1K<n<10K # 《神秘博士（Doctor Who）》叙事知识图谱 本数据集为基于[Fabula](https://fabula.productions)处理流水线，从《神秘博士（Doctor Who）》剧集剧本中提取得到的高质量叙事知识图谱，涵盖角色、地点、物品、组织、事件、主题及冲突弧线，包含完整的参与语义与图引力（Graph Gravity）重要性层级。 ## 数据集概览 | 指标 | 数值 | |--------|-------| | 源数据库 | `doctorwho.s08` | | 数据集类型 | 季级数据库 | | 剧集数量 | 25 | | 总节点数 | 4,771 | | 总边数 | 15,349 | | Schema版本 | 1.1.0 | | 导出日期 | 2026-04-08 | ### 实体分类统计 | 实体类型 | 数量 | |------|-------| | 幕（Act） | 64 | | 智能体（Agent） | 252 | | 冲突弧线（ConflictArc） | 102 | | 剧集（Episode） | 25 | | 事件（Event） | 883 | | 地点（Location） | 238 | | 物品（Object） | 858 | | 组织（Organization） | 71 | | 情节节拍（PlotBeat） | 1,492 | | 场景边界（SceneBoundary） | 678 | | 主题（Theme） | 108 | ### 图引力层级 | 层级 | 数量 | 描述 | |------|-------|-------------| | anchor（核心层） | 35 | 主要角色与关键地点 | | planet（常现层） | 268 | 反复出现的实体 | | asteroid（单次层） | 1,116 | 次要或一次性实体 | ### 关系类型 已定义的关系类型包括`AFFILIATED_WITH`、`BELONGS_TO_EPISODE`、`CALLBACK`、`CAUSAL`、`CHARACTER_CONTINUITY`、`CONTAINS_ACT`、`CONTAINS_BEAT`、`CONTAINS_SCENE`、`EMOTIONAL_ECHO`、`ESCALATION`、`EXEMPLIFIES_THEME`、`FORESHADOWING`、`INVOLVED_IN_ARC`、`INVOLVED_WITH`、`IN_EVENT`、`NARRATIVELY_FOLLOWS`、`OCCURS_IN`、`PARTICIPATED_AS`、`PART_OF`、`PART_OF_ACT`等，另有5种未完全列出。 ## 相关数据集 本数据集为单季数据集，包含从《神秘博士》第八季剧本中提取的实体与事件。 - **全季图谱（Megagraph）**（整合所有季数据）：[brandburner/doctorwho-mega-narrative-kg](https://huggingface.co/datasets/brandburner/doctorwho-mega-narrative-kg) > **注意：** 全季图谱并非简单的季级数据集合并。跨季实体将通过全局实体注册表（GER, Global Entity Registry）进行统一，获得全新的规范UUID与精炼描述。图引力层级将基于全剧集数据重新计算。如需进行单季分析，请使用单季数据集；如需进行跨季分析，请使用全季图谱。 ## 文件说明 | 文件 | 描述 | |------|-------------| | `nodes.parquet` | 包含所有带属性的图谱节点 | | `edges.parquet` | 包含所有带属性的关系边 | | `positions.parquet` | 用于可视化的3D布局坐标数据 | | `meta.json` | 数据集元数据与实体统计信息 | ## 数据Schema ### 节点表（`nodes.parquet`） | 列名 | 数据类型 | 描述 | |--------|------|-------------| | `node_id` | 字符串 | 唯一节点标识符（UUID） | | `primary_label` | 字符串 | 节点类型（如智能体、地点、事件等） | | `name` | 字符串 | 显示名称 | | `description` | 字符串 | 基础描述信息 | | `tier` | 字符串（可空） | 图引力层级：anchor/planet/asteroid | | `episode_count` | 整数（可空） | 实体出现的不同剧集数量 | | `first_episode_seq` | 整数（可空） | 实体首次出现的剧集序号 | | `last_episode_seq` | 整数（可空） | 实体最后一次出现的剧集序号 | | `properties_json` | 字符串 | 以JSON格式存储的完整节点属性 | ### 边表（`edges.parquet`） | 列名 | 数据类型 | 描述 | |--------|------|-------------| | `source_node_id` | 字符串 | 源节点UUID | | `target_node_id` | 字符串 | 目标节点UUID | | `relationship_type` | 字符串 | 关系类型（如`PARTICIPATED_AS`） | | `properties_json` | 字符串 | 以JSON格式存储的边属性 | ### 布局坐标表（`positions.parquet`） | 列名 | 数据类型 | 描述 | |--------|------|-------------| | `node_id` | 字符串 | 节点UUID | | `x`, `y`, `z` | 浮点数 | 3D坐标 | | `size` | 浮点数 | 节点大小（基于图引力加权） | | `r`, `g`, `b` | 整数 | 按实体类型分配的RGB颜色值 | | `community` | 整数 | Louvain社区检测索引 | | `tier` | 字符串（可空） | 图引力层级 | ## 使用示例 python from datasets import load_dataset import pandas as pd # 从HuggingFace加载数据集 ds = load_dataset("brandburner/doctorwho-s08-narrative-kg") # 或直接加载Parquet格式文件 nodes = pd.read_parquet("nodes.parquet") edges = pd.read_parquet("edges.parquet") # 筛选核心层角色 anchors = nodes[(nodes['primary_label'] == 'Agent') & (nodes['tier'] == 'anchor')] # 构建NetworkX有向图 import networkx as nx G = nx.DiGraph() for _, n in nodes.iterrows(): G.add_node(n['node_id'], label=n['primary_label'], name=n['name']) for _, e in edges.iterrows(): G.add_edge(e['source_node_id'], e['target_node_id'], type=e['relationship_type']) ## 引用格式 bibtex @misc{fabula_doctorwho_s08, title = {《神秘博士》叙事知识图谱}, author = {Fabula处理流水线}, year = {2026}, publisher = {HuggingFace}, howpublished = {url{https://huggingface.co/datasets/brandburner/doctorwho-s08-narrative-kg}} } ## 许可证 CC BY-SA 4.0（知识共享署名-相同方式共享4.0协议）