社会关系图

关于社会关系图

社会关系图绘制群体内部的选择、排斥与联盟网络——谁喜欢谁、谁被孤立、哪里形成了小团体。Jacob Moreno 于 1934 年将这一方法作为团体治疗的临床工具引入；此后被班级教师（用于发现排斥和霸凌）、HR 团队（非正式影响力图谱）和组织研究者广泛采用。与以个人为中心描述外部环境的生态图（ecomap）不同，社会关系图对群体中的每位成员一视同仁。

Schematex 遵循 Moreno（1934）社会测量学惯例 中的节点角色和边类型，并扩展了现代社会网络分析对效价、方向和权重的符号表示。本页记录解析器目前所接受的内容。

1. 第一张图

最简实用的社会关系图：四个人、三种不同的关系类型。

四条规则覆盖 80% 的用法：

1. 以关键字 sociogram 开头，后跟可选的带引号标题。
2. 每个人是一个节点——用 id [label: "…"] 显式声明，或在边中首次出现时自动创建。
3. 用边运算符连接两个节点——<->（双向）、->（单向）、-x>（排斥）、-.-（中性）。见第 3 节。
4. 可选声明群组和 config 行以控制布局和着色。

注释必须以 # 开头单独成行。

2. 节点

节点行格式为 id [属性: 值, …]。在边中首次引用时也会隐式创建节点——但显式声明可以设置标签、群组和角色。

ID 规则。 必须匹配 [a-zA-Z][a-zA-Z0-9_-]*。ID 为内部使用；label: 属性设置显示名称。

节点属性：

3. 边

边行格式为 左侧ID 运算符 右侧ID，可选追加 [label: "…", weight: N]。若 ID 尚未声明，则自动注册为节点。

3.1 方向与效价

3.2 权重/强度

权重越高，线条越粗。可使用简写运算符，也可通过 [weight: N] 显式指定。

3.3 边标签

A -> B [label: "best friend"] — 标签显示在连接线上。

4. 群组

group 块将节点归入一个命名子群，用于着色和布局聚类。

群组语法：

• group id [label: "…", color: "#hex"] — 群组头行。
• 成员行紧随其后，每行至少缩进 4 个空格，每行一个节点。
• 非缩进行（或下一个 group）结束当前群组。
• 成员可带自己的属性：anna [label: "Anna K.", size: large]。

节点也可内联赋值群组：alice [group: girls]。

5. 配置

config: 行调整布局和视觉编码，每项单独一行。

布局说明：

• circular — 节点均匀分布在圆环上，适合小型群组（≤15 人）。
• force-directed — 弹簧模型，子群自动涌现，适合有明显子群的中型群组。
• concentric — 内圈为高入度节点，适合展示核心-外围结构。

圆形布局 — 均匀环形分布；每个节点可见性相同，适合小型紧密群组。

力导向布局 — 弹簧物理将相连节点拉近，将不相连节点推开，子群有机聚合。

同心圆布局 — 节点按入度排序；高中心性节点位于内圈，边缘节点位于外圈。

6. 社会测量角色

解析器将角色标注存储在节点上，渲染器据此应用视觉徽章——star 显示星形标记，isolate 显示虚线边框，等等。

7. 标签与注释

• 标题： sociogram "Study group" — 仅限第一行。
• 节点标签： alice [label: "Alice K."]。
• 群组标签： group boys [label: "Boys"]。
• 边标签： alice -> bob [label: "lab partners"]。
• 注释： 行首（前导空格后）的 #。

8. 保留字与转义

行首保留字： sociogram（文件头）、group、config:。

保留运算符符号——避免在 ID 中使用以下序列：->、<-、<->、--、===、==>、<==、<===>、-x>、<x-、-x-、<x->、-.>、<.->、-.-。

含空格的字符串在 label: 和 color: 值中必须用双引号括起。

9. 常见错误

10. 语法（EBNF）

document       = header (blank | comment | config | group-block | edge | node)*

header         = "sociogram" ( WS quoted-string )? NEWLINE
quoted-string  = '"' any-char-but-quote* '"'

config         = "config:" WS key WS "=" WS value NEWLINE
key            = "layout" | "sizing" | "coloring" | "highlight"

group-block    = "group" WS id ( "[" group-attrs "]" )? NEWLINE
                   ( INDENT≥4 member-line )*
member-line    = id ( "[" node-attrs "]" )? NEWLINE
group-attrs    = group-attr ("," group-attr)*
group-attr     = "label:" quoted-string | "color:" quoted-string

node           = id ( "[" node-attrs "]" )? NEWLINE
node-attrs     = node-attr ("," node-attr)*
node-attr      = "label:" quoted-string
               | "group:" id
               | "role:" role
               | "size:" ("small" | "medium" | "large")

edge           = id WS op WS id ( "[" edge-attrs "]" )? NEWLINE
edge-attrs     = edge-attr ("," edge-attr)*
edge-attr      = "label:" quoted-string | "weight:" number

op             = // 正
                 "<===>" | "===>" | "<==="
               | "<==>"|"==>"|"<=="
               | "===" | "<->" | "->" | "<-" | "--"
               // 负
               | "<x->" | "-x>" | "<x-" | "-x-"
               // 中性
               | "<.->" | "-\.>" | "-.-"

role           = "star" | "isolate" | "bridge" | "neglectee" | "rejected"
id             = [a-zA-Z] [a-zA-Z0-9_-]*
comment        = "#" any NEWLINE

权威来源：src/diagrams/sociogram/parser.ts。如与解析器有出入，以解析器为准——请提 issue。

11. 规范合规性

Schematex 社会关系图遵循 Moreno（1934）社会测量学对节点角色（star、isolate、neglectee）和有向选择语义的惯例。边运算符集根据现代社会网络分析实践（Hanneman & Riddle，2005）扩展了效价（正/负/中性）和权重等级。

目前已实现：

• ✅ 有向、双向与无向边
• ✅ 正、负、中性效价运算符
• ✅ 四种权重等级（1–4），含简写运算符和 [weight: N]
• ✅ 带颜色的群组
• ✅ 节点角色声明（star、isolate、bridge、neglectee、rejected）
• ✅ 三种布局：圆形、力导向、同心圆
• ✅ 三种节点大小模式：均匀、入度、介数中心性
• ⏳ 自动检测并高亮小团体——带阴影的凸包（见第 13 节）
• ⏳ 社会原子视图（以自我为中心的布局）

参考文献：

• Moreno, J.L. (1934). Who Shall Survive? Foundations of Sociometry, Group Psychotherapy and Sociodrama. Beacon House.
• Hanneman, R.A. & Riddle, M. (2005). Introduction to Social Network Methods. UC Riverside.

12. 相关示例

13. 路线图

规划中——尚不可解析。 请勿在生成的 DSL 中使用以下功能，解析器会拒绝或忽略。

• 自动检测并高亮小团体 — 在互选子群（≥3 人）周围绘制带阴影的凸包。
• 自动检测桥节点 — 无需显式声明，从介数中心性推断 role: bridge。
• 社会原子视图 — 以自我为中心的布局，指定节点位于中心。
• 互惠矩阵导出 — 在图表旁生成结构化表格输出。

如需优先实现以上功能，请在 GitHub issues 中跟踪反馈。