Skip to content

Hypergraph is more powerful. Transform unstructured text into structured knowledge with LLMs. Graphs, hypergraphs, and spatio-temporal extractions — with one command.

docs: list education templates

Frankie-Xu4698ca6e9c83
diff --git a/docs/en/python/guides/using-templates.md b/docs/en/python/guides/using-templates.md
index 4f0f3bc..40d9dc2 100644
--- a/docs/en/python/guides/using-templates.md
+++ b/docs/en/python/guides/using-templates.md
@@ -20,7 +20,7 @@ Templates are pre-configured extraction setups that combine:
## Built-in Templates
-Hyper-Extract includes 80+ templates across 6 domains:
+Hyper-Extract includes 80+ templates across 7 domains:
| Domain | Templates | Use Cases |
|--------|-----------|-----------|
@@ -30,6 +30,7 @@ Hyper-Extract includes 80+ templates across 6 domains:
| `medicine` | Anatomy, drugs, treatments | Medical text analysis |
| `tcm` | Herbs, formulas, syndromes | Traditional Chinese Medicine |
| `industry` | Equipment, safety, operations | Industrial documentation |
+| `education` | Course concepts, curriculum structure | Textbooks, lecture notes, syllabi |
---
diff --git a/docs/en/templates/choosing/by-output.md b/docs/en/templates/choosing/by-output.md
index 758b932..87131b9 100644
--- a/docs/en/templates/choosing/by-output.md
+++ b/docs/en/templates/choosing/by-output.md
@@ -145,6 +145,7 @@ for risk in result.data.items:
| `general/concept_graph` | Research concepts |
| `finance/ownership_graph` | Company ownership |
| `medicine/anatomy_graph` | Anatomy |
+| `education/course_concept_graph` | Course knowledge points |
**Example:**
```python
@@ -252,6 +253,7 @@ response = result.chat("What happened between 1880-1890?")
| Template | Domain |
|----------|--------|
| `general/base_hypergraph` | General purpose |
+| `education/curriculum_structure` | Course syllabi |
**Note:** Hypergraphs are advanced. Most use cases can be satisfied with AutoGraph.
diff --git a/docs/en/templates/choosing/by-task.md b/docs/en/templates/choosing/by-task.md
index b7eaa76..f562bed 100644
--- a/docs/en/templates/choosing/by-task.md
+++ b/docs/en/templates/choosing/by-task.md
@@ -265,6 +265,8 @@ he parse drug_info.md -t medicine/drug_interaction -l en -o ./drugs/
| Case timeline | `legal/case_fact_timeline` | temporal_graph |
| Hospital timeline | `medicine/hospital_timeline` | temporal_graph |
| Drug interactions | `medicine/drug_interaction` | graph |
+| Course knowledge points | `education/course_concept_graph` | graph |
+| Course syllabus structure | `education/curriculum_structure` | hypergraph |
---
diff --git a/docs/en/templates/index.md b/docs/en/templates/index.md
index be40fcd..97eceea 100644
--- a/docs/en/templates/index.md
+++ b/docs/en/templates/index.md
@@ -77,6 +77,15 @@ Choose a template based on what you want to extract.
- [Safety Controls](reference/industry.md)
- [Operation Flow](reference/industry.md)
+- :material-school:{ .lg .middle } **Course Materials & Syllabi**
+
+ ---
+
+ Extract knowledge-point dependencies and curriculum structure
+
+ - [Course Concept Graph](reference/education.md) — *Recommended*
+ - [Curriculum Structure](reference/education.md)
+
</div>
---
diff --git a/docs/en/templates/reference/education.md b/docs/en/templates/reference/education.md
new file mode 100644
index 0000000..7760b39
--- /dev/null
+++ b/docs/en/templates/reference/education.md
@@ -0,0 +1,105 @@
+# Education Templates
+
+Course materials, syllabi, and curriculum analysis.
+
+---
+
+## Overview
+
+Education templates extract pedagogical structure from teaching documents: knowledge-point graphs from textbooks and lecture notes, and course–module–assessment hypergraphs from syllabi.
+
+Use `education/course_concept_graph` when the source teaches concepts and their learning dependencies. Use `education/curriculum_structure` when the source organizes a course into modules, topics, assessments, and outcomes. For general ontology extraction from papers or encyclopedias, use `general/concept_graph` instead.
+
+---
+
+## Templates
+
+### course_concept_graph
+
+**Type**: graph
+
+**Purpose**: Extract knowledge points and pedagogical dependencies from course materials
+
+**Best for**:
+- Textbooks and lecture notes
+- Course readers
+- Tutorial chapters
+
+**Entities**:
+- Knowledge points (concepts, skills, procedures, principles, examples)
+
+**Relations**:
+- `prerequisite_of` — Explicit learning-order requirement
+- `part_of` — Explicit part-whole membership
+- `related_to` — Explicit association that is not prerequisite or part-whole
+- `example_of` — Worked example or illustration of a knowledge point
+
+=== "CLI"
+
+ ```bash
+ he parse lecture.md -t education/course_concept_graph -l en
+ ```
+
+=== "Python"
+
+ ```python
+ ka = Template.create("education/course_concept_graph", "en")
+ result = ka.parse(lecture_notes)
+
+ for edge in result.data.relations:
+ print(f"{edge.source} -[{edge.type}]-> {edge.target}")
+ ```
+
+---
+
+### curriculum_structure
+
+**Type**: hypergraph
+
+**Purpose**: Extract course–module–concept–assessment structure from syllabi
+
+**Best for**:
+- Course syllabi
+- Program / curriculum plans
+- Course outlines
+
+**Entities**:
+- Courses
+- Modules (weeks, units)
+- Concepts (topics the unit covers)
+- Assessments (quiz, homework, lab, exam)
+- Learning outcomes
+
+**Hyperedges**:
+- One teaching unit (`unit_name`) grouping `courses`, `concepts`, `assessments`, and `outcomes`
+
+=== "CLI"
+
+ ```bash
+ he parse syllabus.md -t education/curriculum_structure -l en
+ ```
+
+=== "Python"
+
+ ```python
+ ka = Template.create("education/curriculum_structure", "en")
+ result = ka.parse(syllabus_text)
+
+ for unit in result.data.relations:
+ print(f"{unit.unit_name}: {unit.concepts} / {unit.assessments}")
+ ```
+
+---
+
+## Tips
+
+1. **course_concept_graph for textbooks** — Learning dependencies stated in the prose
+2. **curriculum_structure for syllabi** — Course organization and assessment mapping
+3. Do not invent prerequisites from chapter order, or assessments the syllabus does not name
+
+---
+
+## See Also
+
+- [Template Overview](overview.md)
+- [General Templates](general.md) — `general/concept_graph` for non-course conceptual text
diff --git a/docs/en/templates/reference/overview.md b/docs/en/templates/reference/overview.md
index f2bc3f8..ea05395 100644
--- a/docs/en/templates/reference/overview.md
+++ b/docs/en/templates/reference/overview.md
@@ -7,7 +7,7 @@ Complete overview of all available templates.
## Statistics
- **Total Templates**: 80+
-- **Categories**: 6 domains
+- **Categories**: 7 domains
- **Auto-Types**: 8 types
- **Languages**: Chinese, English
@@ -84,6 +84,13 @@ Complete overview of all available templates.
| `industry/operation_flow` | graph | Operational workflows |
| `industry/safety_control` | graph | Safety control systems |
+### Education Templates
+
+| Template | Type | Description |
+|----------|------|-------------|
+| `education/course_concept_graph` | graph | Course knowledge-point dependencies |
+| `education/curriculum_structure` | hypergraph | Course–module–assessment structure |
+
---
## By Auto-Type
@@ -134,6 +141,7 @@ Complete overview of all available templates.
| `industry/equipment_topology` | industry | Equipment connections |
| `industry/operation_flow` | industry | Operational workflows |
| `industry/safety_control` | industry | Safety control systems |
+| `education/course_concept_graph` | education | Course knowledge points |
### Temporal Graph Templates
@@ -163,6 +171,7 @@ Complete overview of all available templates.
| Template | Domain | Description |
|----------|--------|-------------|
| `general/base_hypergraph` | general | Basic hypergraph |
+| `education/curriculum_structure` | education | Curriculum structure |
---
diff --git a/docs/zh/python/guides/using-templates.md b/docs/zh/python/guides/using-templates.md
index 8d3cc07..8d24e08 100644
--- a/docs/zh/python/guides/using-templates.md
+++ b/docs/zh/python/guides/using-templates.md
@@ -20,7 +20,7 @@
## 内置模板
-Hyper-Extract 包含 80+ 个跨 6 个领域的模板:
+Hyper-Extract 包含 80+ 个跨 7 个领域的模板:
| 领域 | 模板 | 用例 |
|--------|-----------|-----------|
@@ -30,6 +30,7 @@ Hyper-Extract 包含 80+ 个跨 6 个领域的模板:
| `medicine` | 解剖、药物、治疗 | 医学文本分析 |
| `tcm` | 草药、方剂、证候 | 中医 |
| `industry` | 设备、安全、操作 | 工业文档 |
+| `education` | 课程概念、课程结构 | 教材、讲义、教学大纲 |
---
diff --git a/docs/zh/templates/choosing/by-output.md b/docs/zh/templates/choosing/by-output.md
index 0a9e638..bfb9802 100644
--- a/docs/zh/templates/choosing/by-output.md
+++ b/docs/zh/templates/choosing/by-output.md
@@ -145,6 +145,7 @@ for risk in result.data.items:
| `general/concept_graph` | 研究概念 |
| `finance/ownership_graph` | 公司股权 |
| `medicine/anatomy_graph` | 解剖学 |
+| `education/course_concept_graph` | 课程知识点 |
**示例:**
```python
@@ -252,6 +253,7 @@ response = result.chat("1080年到1090年间发生了什么?")
| 模板 | 领域 |
|------|------|
| `general/base_hypergraph` | 通用 |
+| `education/curriculum_structure` | 教学大纲 |
**注意:** 超图是高级功能。大多数用例可以用 AutoGraph 满足。
diff --git a/docs/zh/templates/choosing/by-task.md b/docs/zh/templates/choosing/by-task.md
index 166a7ec..aca087c 100644
--- a/docs/zh/templates/choosing/by-task.md
+++ b/docs/zh/templates/choosing/by-task.md
@@ -266,6 +266,8 @@ he parse drug_info.md -t medicine/drug_interaction -l zh -o ./drugs/
| 案例时间线 | `legal/case_fact_timeline` | temporal_graph |
| 住院时间线 | `medicine/hospital_timeline` | temporal_graph |
| 药物相互作用 | `medicine/drug_interaction` | graph |
+| 课程知识点 | `education/course_concept_graph` | graph |
+| 教学大纲结构 | `education/curriculum_structure` | hypergraph |
---
diff --git a/docs/zh/templates/index.md b/docs/zh/templates/index.md
index c9936dd..e468485 100644
--- a/docs/zh/templates/index.md
+++ b/docs/zh/templates/index.md
@@ -77,6 +77,15 @@
- [安全控制](reference/industry.md)
- [操作流程](reference/industry.md)
+- :material-school:{ .lg .middle } **课程材料与教学大纲**
+
+ ---
+
+ 提取知识点依赖和课程结构
+
+ - [课程概念图](reference/education.md) — *推荐*
+ - [课程结构](reference/education.md)
+
</div>
---
diff --git a/docs/zh/templates/reference/education.md b/docs/zh/templates/reference/education.md
new file mode 100644
index 0000000..37ad2fc
--- /dev/null
+++ b/docs/zh/templates/reference/education.md
@@ -0,0 +1,105 @@
+# 教育模板
+
+课程材料、教学大纲和培养方案分析。
+
+---
+
+## 概述
+
+教育模板从教学文档中提取教学结构:从教材和讲义抽取知识点图,从教学大纲抽取课程—模块—考核超图。
+
+当原文在讲授概念及其学习依赖时,使用 `education/course_concept_graph`。当原文把一门课组织成模块、主题、考核和学习成果时,使用 `education/curriculum_structure`。从论文或百科全书抽取通用本体时,请改用 `general/concept_graph`。
+
+---
+
+## 模板
+
+### course_concept_graph
+
+**类型**:graph
+
+**用途**:从课程材料中提取知识点及其教学依赖关系
+
+**最适合**:
+- 教材和讲义
+- 课程读本
+- 教程章节
+
+**实体**:
+- 知识点(概念、技能、方法、原理、例题)
+
+**关系**:
+- `先修` — 文本明确写出的学习顺序要求
+- `组成` — 文本明确写出的部分-整体关系
+- `相关` — 排除先修和组成后仍明确陈述的关联
+- `示例` — 作为某知识点的例题或实例
+
+=== "CLI"
+
+ ```bash
+ he parse lecture.md -t education/course_concept_graph -l zh
+ ```
+
+=== "Python"
+
+ ```python
+ ka = Template.create("education/course_concept_graph", "zh")
+ result = ka.parse(lecture_notes)
+
+ for edge in result.data.relations:
+ print(f"{edge.source} -[{edge.type}]-> {edge.target}")
+ ```
+
+---
+
+### curriculum_structure
+
+**类型**:hypergraph
+
+**用途**:从教学大纲中提取课程—模块—知识点—考核结构
+
+**最适合**:
+- 教学大纲
+- 培养方案
+- 课程简介
+
+**实体**:
+- 课程
+- 模块(周次、单元)
+- 知识点(该单元覆盖的主题)
+- 考核(测验、作业、实验、考试)
+- 学习成果
+
+**超边**:
+- 一个教学单元(`unit_name`),按角色分组 `courses`、`concepts`、`assessments`、`outcomes`
+
+=== "CLI"
+
+ ```bash
+ he parse syllabus.md -t education/curriculum_structure -l zh
+ ```
+
+=== "Python"
+
+ ```python
+ ka = Template.create("education/curriculum_structure", "zh")
+ result = ka.parse(syllabus_text)
+
+ for unit in result.data.relations:
+ print(f"{unit.unit_name}: {unit.concepts} / {unit.assessments}")
+ ```
+
+---
+
+## 提示
+
+1. **course_concept_graph 用于教材** — 正文中明确写出的学习依赖
+2. **curriculum_structure 用于大纲** — 课程组织与考核对应
+3. 不要仅凭章节顺序臆造先修,也不要添加大纲未点名的考核
+
+---
+
+## 参见
+
+- [模板概览](overview.md)
+- [通用模板](general.md) — 非课程概念文本请用 `general/concept_graph`
diff --git a/docs/zh/templates/reference/overview.md b/docs/zh/templates/reference/overview.md
index b89e24d..0af33a9 100644
--- a/docs/zh/templates/reference/overview.md
+++ b/docs/zh/templates/reference/overview.md
@@ -7,7 +7,7 @@
## 统计
- **模板总数**:80+
-- **类别**:6 个领域
+- **类别**:7 个领域
- **自动类型**:8 种类型
- **语言**:中文、英文
@@ -84,6 +84,13 @@
| `industry/operation_flow` | graph | 操作工作流 |
| `industry/safety_control` | graph | 安全控制系统 |
+### 教育模板
+
+| 模板 | 类型 | 描述 |
+|------|------|------|
+| `education/course_concept_graph` | graph | 课程知识点依赖 |
+| `education/curriculum_structure` | hypergraph | 课程—模块—考核结构 |
+
---
## 按自动类型
@@ -134,6 +141,7 @@
| `industry/equipment_topology` | industry | 设备连接 |
| `industry/operation_flow` | industry | 操作工作流 |
| `industry/safety_control` | industry | 安全控制系统 |
+| `education/course_concept_graph` | education | 课程知识点 |
### Temporal Graph 模板
@@ -163,6 +171,7 @@
| 模板 | 领域 | 描述 |
|------|------|------|
| `general/base_hypergraph` | general | 基础超图 |
+| `education/curriculum_structure` | education | 课程结构 |
---
diff --git a/hyperextract/templates/README.md b/hyperextract/templates/README.md
index 5651507..f6fab4a 100644
--- a/hyperextract/templates/README.md
+++ b/hyperextract/templates/README.md
@@ -20,6 +20,7 @@ A curated library of YAML-based templates for structured knowledge extraction fr
- [TCM Domain](#tcm-domain)
- [Industry Domain](#industry-domain)
- [Legal Domain](#legal-domain)
+ - [Education Domain](#education-domain)
- [Base Templates Reference](#base-templates-reference)
- [Custom Templates](#custom-templates)
@@ -238,6 +239,8 @@ Match your document type to the right template:
| **Technical Documentation** | doc_structure | graph |
| **Skill Definition (Agent)** | workflow_graph | temporal_graph |
| **Conceptual Text** | concept_graph | graph |
+| **Course textbook / lecture notes** | course_concept_graph | graph |
+| **Syllabus / curriculum outline** | curriculum_structure | hypergraph |
---
@@ -341,6 +344,17 @@ Templates for legal documents and compliance.
---
+### Education Domain
+
+Templates for course materials, syllabi, and curriculum documents.
+
+| Template | Type | Purpose | Documents |
+|---------|------|---------|-----------|
+| [course_concept_graph](./presets/education/course_concept_graph.yaml) | graph | Extract knowledge points and pedagogical dependencies | Textbooks, lecture notes, course readers |
+| [curriculum_structure](./presets/education/curriculum_structure.yaml) | hypergraph | Extract course–module–concept–assessment structure | Syllabi, program plans, course outlines |
+
+---
+
## Base Templates Reference
Base templates provide foundation patterns for extraction. Use them directly or extend them for custom needs.
@@ -450,7 +464,8 @@ result = template.parse("Your document text here...")
| tcm | 5 | 0 | 5 |
| industry | 5 | 0 | 5 |
| legal | 5 | 0 | 5 |
-| **Total** | **38** | **8** | **30** |
+| education | 2 | 0 | 2 |
+| **Total** | **40** | **8** | **32** |
---
diff --git a/hyperextract/templates/README_ZH.md b/hyperextract/templates/README_ZH.md
index 5ee64df..5d12c41 100644
--- a/hyperextract/templates/README_ZH.md
+++ b/hyperextract/templates/README_ZH.md
@@ -20,6 +20,7 @@
- [中医领域](#中医领域)
- [工业领域](#工业领域)
- [法律领域](#法律领域)
+ - [教育领域](#教育领域)
- [基础模板参考](#基础模板参考)
- [自定义模板](#自定义模板)
@@ -238,6 +239,8 @@ Hyper-Extract 提供 8 种抽取类型,分为两大类:
| **技术文档** | doc_structure | graph |
| **Skill 定义 (Agent)** | workflow_graph | temporal_graph |
| **概念性文本** | concept_graph | graph |
+| **课程教材 / 讲义** | course_concept_graph | graph |
+| **教学大纲 / 培养方案** | curriculum_structure | hypergraph |
---
@@ -341,6 +344,17 @@ Hyper-Extract 提供 8 种抽取类型,分为两大类:
---
+### 教育领域
+
+面向课程材料、教学大纲和培养方案的模板。
+
+| 模板 | 类型 | 用途 | 适用文档 |
+|------|------|------|----------|
+| [course_concept_graph](./presets/education/course_concept_graph.yaml) | graph | 提取知识点及其教学依赖关系 | 教材、讲义、课程读本 |
+| [curriculum_structure](./presets/education/curriculum_structure.yaml) | hypergraph | 提取课程—模块—知识点—考核结构 | 教学大纲、培养方案、课程简介 |
+
+---
+
## 基础模板参考
基础模板提供抽取的Foundation模式。可直接使用或扩展以满足自定义需求。
@@ -450,7 +464,8 @@ result = template.parse("您的文档文本...")
| tcm | 5 | 0 | 5 |
| industry | 5 | 0 | 5 |
| legal | 5 | 0 | 5 |
-| **总计** | **38** | **8** | **30** |
+| education | 2 | 0 | 2 |
+| **总计** | **40** | **8** | **32** |
---
diff --git a/mkdocs.yml b/mkdocs.yml
index 74d4bcd..0639664 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -132,6 +132,7 @@ plugins:
- Medical: templates/reference/medicine.md
- TCM: templates/reference/tcm.md
- Industry: templates/reference/industry.md
+ - Education: templates/reference/education.md
- Tutorials:
- tutorials/index.md
- Research Assistant:
@@ -225,6 +226,7 @@ plugins:
- 医学: zh/templates/reference/medicine.md
- 中医: zh/templates/reference/tcm.md
- 工业: zh/templates/reference/industry.md
+ - 教育: zh/templates/reference/education.md
- 教程:
- zh/tutorials/index.md
- 研究助手: