WOLFRAM

Wolfram 语言与系统参考资料中心

Annotate[obj,keyvalue]

设置对象 obj 的注释 keyvalue.

Annotate[{obj,itemspec},keyvalue]

为 itemspec 指定的 obj 中的项设置注释.

更多信息
Details and Options Details and Options
范例  
基本范例  
范围  
图和网络  
图注释  
顶点注释  
边注释  
区域  
BoundaryMeshRegion  
MeshRegion  
CSGRegion  
应用  
属性和关系  
可能存在的问题  
参见
相关指南
历史
按以下格式引用：

Annotate

Annotate[obj,keyvalue]

设置对象 obj 的注释 keyvalue.

Annotate[{obj,itemspec},keyvalue]

为 itemspec 指定的 obj 中的项设置注释.

更多信息

  • 通常用于存储对象或对象中各项的 key->value 对.
  • Annotate 返回带有新注释或修改注释的指定对象.
  • 带有可注释项的可能对象:
  • Audio时间点和时间间隔
    BoundaryMeshRegion网格单元
    CSGRegion几何区域
    Graph顶点和边
    MeshRegion网格单元
  • 每种对象类型的项规范 itemspec 在其参考页面中给出.

范例

打开所有单元 关闭所有单元

基本范例  (3)

指定一个顶点或边注解：

Wolfram Language code: g = CompleteGraph[4]

标记顶点：

Wolfram Language code: Annotate[{g, 1}, VertexLabels -> "one"]

设计边的样式：

Wolfram Language code: Annotate[{g, 12}, EdgeStyle -> Red]

突出显示网格中的边界单元：

Wolfram Language code: Annotate[{MengerMesh[2], {1, "Boundary"}}, MeshCellStyle -> Red]

突出显示 CSGRegion 中的一个区域：

Wolfram Language code: Annotate[{CSGRegion[{Ball[], Cuboid[]}], {2}}, "CSGRegionStyle" -> Red]

范围  (17)

图和网络  (11)

图注释  (7)

设置顶点的注释：

Wolfram Language code: CompleteGraph[4];
Wolfram Language code: Annotate[{[image], 1}, VertexSize -> Small]

和边的注释：

Wolfram Language code: Annotate[{[image], 12}, EdgeLabels -> "hello"]

为一个顶点设置多个注释：

Wolfram Language code: CompleteGraph[4, VertexSize -> Medium];
Wolfram Language code: Annotate[{[image], 1}, {VertexStyle -> Magenta, VertexLabels -> "hello"}]

为一条边设置多个注释：

Wolfram Language code: Annotate[{[image], 12}, {EdgeStyle -> Magenta, EdgeLabels -> "hello"}]

Annotate 适用于无向图：

Wolfram Language code: CycleGraph[3];
Wolfram Language code: Annotate[{[image], 12}, {EdgeStyle -> Brown}]

有向图：

Wolfram Language code: CycleGraph[3, DirectedEdges -> True, EdgeStyle -> Arrowheads[Small]];
Wolfram Language code: Annotate[{[image], 12}, {EdgeLabels -> "hello"}]

多图图形：

Wolfram Language code: Graph[{1, 2, 3}, {12, 23, 23, 23, 31}];
Wolfram Language code: Annotate[{[image], 12}, {EdgeStyle -> Brown}]

混合图：

Wolfram Language code: Graph[{1, 2, 3}, {12, 23, 31}, EdgeStyle -> Arrowheads[0.08]];
Wolfram Language code: Annotate[{[image], 12}, {EdgeStyle -> Brown}]

加权图：

Wolfram Language code: With[{g = CycleGraph[3], w = 0.3Range[3], pl = {Above, Right, Right} /. {Right -> {1 / 2, {-0.4, 1 / 2}}, Above -> {1 / 2, {1 / 2, 0}}}}, Graph[VertexList[g], EdgeList[g], EdgeWeight -> w, VertexShapeFunction -> "Name", EdgeLabels -> Thread[EdgeList[g] -> MapThread[Placed, {w, pl}]], VertexCoordinates -> GraphEmbedding[g]]];
Wolfram Language code: Annotate[{[image], 12}, {EdgeStyle -> Dashed}]

顶点注释  (2)

标准顶点注释包括 VertexStyle：

Wolfram Language code: g = CompleteGraph[4, VertexSize -> Medium]
Wolfram Language code: Annotate[{g, 4}, VertexStyle -> Red]

VertexLabels：

Wolfram Language code: Annotate[{g, 1}, VertexLabels -> "one"]

VertexSize：

Wolfram Language code: Annotate[{g, 1}, VertexSize -> Tiny]

VertexShape:

Wolfram Language code: Annotate[{g, 1}, VertexShape -> [image]]

VertexShapeFunction：

Wolfram Language code: Annotate[{g, 2}, VertexShapeFunction -> "Square"]

非可视注释包括 VertexWeight：

Wolfram Language code: Annotate[{g, 1}, VertexWeight -> 100]
Wolfram Language code: AnnotationValue[{%, 1}, VertexWeight]

设置自定义注释：

Wolfram Language code: CompleteGraph[4];
Wolfram Language code: Annotate[{[image], 2}, "Material" -> "Wood"]
Wolfram Language code: AnnotationValue[{%, 2}, "Material"]

边注释  (2)

标准边注释包括 EdgeStyle：

Wolfram Language code: g = CompleteGraph[4]
Wolfram Language code: Annotate[{g, 12}, EdgeStyle -> Brown]

EdgeLabels：

Wolfram Language code: Annotate[{g, 12}, EdgeLabels -> 12]

EdgeShapeFunction：

Wolfram Language code: Annotate[{g, 34}, EdgeShapeFunction -> "HalfFilledDoubleArrow"]

不可见的注释，包括 EdgeWeight：

Wolfram Language code: Annotate[{g, 12}, EdgeWeight -> 42]
Wolfram Language code: AnnotationValue[{%, 12}, EdgeWeight]

设置自定义注释：

Wolfram Language code: CompleteGraph[4];
Wolfram Language code: Annotate[{[image], 24}, "Resistance" -> 50.]
Wolfram Language code: AnnotationValue[{%, 24}, "Resistance"]

区域  (6)

BoundaryMeshRegion  (2)

Annotate 一个点：

Wolfram Language code: bmr = BoundaryMesh[Cube[]];
Wolfram Language code: Annotate[{bmr, {0, 7}}, MeshCellStyle -> {PointSize[Large], Red}]

边：

Wolfram Language code: Annotate[{bmr, {1, 9}}, MeshCellStyle -> {Thick, Red}]

面：

Wolfram Language code: Annotate[{bmr, {2, 6}}, MeshCellStyle -> {Red}]

Annotate 所有特定维度的网格单元：

Wolfram Language code: bmr = BoundaryMesh[Cube[]];
Wolfram Language code: Table[Annotate[{bmr, {d}}, MeshCellStyle -> Red], {d, {0, 1, 2}}]

MeshRegion  (2)

Annotate 一个点：

Wolfram Language code: mr = MengerMesh[1];
Wolfram Language code: Annotate[{mr, {0, 7}}, MeshCellStyle -> {PointSize[Large], Red}]

边：

Wolfram Language code: Annotate[{mr, {1, 2}}, MeshCellStyle -> {Thick, Red}]

面：

Wolfram Language code: Annotate[{mr, {2, 1}}, MeshCellStyle -> {Red}]

Annotate 特定维度的所有网格单元：

Wolfram Language code: mr = MengerMesh[2];
Wolfram Language code: Table[Annotate[{mr, {d}}, MeshCellStyle -> Red], {d, {0, 1, 2}}]

CSGRegion  (2)

Annotate 一个 CSGRegion 区域：

Wolfram Language code: csg = CSGRegion["Union", {Ball[], Cuboid[]}]
Wolfram Language code: Annotate[csg, "CSGRegionStyle" -> Red]

Annotate CSGRegion 中的一个子区域：

Wolfram Language code: csg = CSGRegion["Union", {Ball[], Cuboid[]}]
Wolfram Language code: Annotate[{csg, {2}}, "CSGRegionStyle" -> Red]

应用  (3)

使用 Fold 重复应用 Annotate：

Wolfram Language code: g = CycleGraph[8, VertexSize -> Large]
Wolfram Language code: Fold[Annotate[{#1, #2}, VertexStyle -> ColorData[45, #2]]&, g, Range[1, 5]]

查看所有部分结果：

Wolfram Language code: FoldList[Annotate[{#1, #2}, VertexStyle -> ColorData[45, #2]]&, g, Range[1, 6]]

创建一个图：

Wolfram Language code: g = CompleteGraph[4]

暂时突出显示一个顶点：

Wolfram Language code: Annotate[{g, 1}, VertexSize -> Medium]

然后显示另一个：

Wolfram Language code: Annotate[{g, 2}, VertexSize -> Medium]

突出显示在宽度优先扫描中访问的边：

Wolfram Language code: g = CompleteKaryTree[4, 3, DirectedEdges -> True]
Wolfram Language code: ListAnimate[Reap[BreadthFirstScan[g, {"FrontierEdge" -> (Sow[Annotate[{g, #}, EdgeStyle -> Red]]& )}]][[2, 1]], DefaultDuration -> Length[EdgeList[g]] / 2, SaveDefinitions -> True]

属性和关系  (6)

使用 Annotation 作为包装，在 Graph 之类的函数中指定注释：

Wolfram Language code: Graph[{Annotation[1, {VertexSize -> Medium, VertexStyle -> Red}], 2, 3}, {12, 23, 31}]

使用 AnnotationValue 提取值：

Wolfram Language code: g = CompleteGraph[4, VertexStyle -> {1 -> Red}, VertexSize -> Small]
Wolfram Language code: AnnotationValue[{g, 1}, VertexStyle]

对于未定义的注释，返回值 $Failed：

Wolfram Language code: AnnotationValue[{g, 1}, "foo"]
Wolfram Language code: MemberQ[AnnotationKeys[{g, 1}], "foo"]

使用 AnnotationValue 在图中设置注释：

Wolfram Language code: g = CompleteGraph[4]
Wolfram Language code: AnnotationValue[{g, 1}, VertexSize] = Small;

原始图已更改：

Wolfram Language code: g

使用 AnnotationValue 取消图的注释：

Wolfram Language code: g = CompleteGraph[4, VertexSize -> {1 -> Small}]
Wolfram Language code: AnnotationValue[{g, 1}, VertexSize]=.;

原始图已更改：

Wolfram Language code: g

使用 AnnotationKeys 测试注释的存在：

Wolfram Language code: g = CompleteGraph[4, VertexLabels -> {1 -> one, 4 -> four}]
Wolfram Language code: MemberQ[AnnotationKeys[{g, 1}], VertexLabels]

生成顶点标签规则列表：

Wolfram Language code: Cases[VertexList[g], v_ /; MemberQ[AnnotationKeys[{g, v}], VertexLabels] :> v -> AnnotationValue[{g, v}, VertexLabels]]

使用 AnnotationDelete 删除注释而不更改原始图：

Wolfram Language code: g = CompleteGraph[4, VertexStyle -> {1 -> Red}, VertexSize -> Small]
Wolfram Language code: AnnotationDelete[{g, 1}, VertexStyle]

原始图不变：

Wolfram Language code: g

可能存在的问题  (1)

AnnotationValue 通常比 Annotate 的速度快：

Wolfram Language code: g = CycleGraph[1000];
Wolfram Language code: Timing@Do[AnnotationValue[{g, v}, VertexWeight] = RandomReal[], {v, VertexList[g]}]
Wolfram Language code: g = CycleGraph[1000];
Wolfram Language code: Timing@Do[g = Annotate[{g, v}, VertexWeight -> RandomReal[]], {v, VertexList[g]}]
Wolfram Research (2020)，Annotate，Wolfram 语言函数，https://reference.wolfram.com/language/ref/Annotate.html （更新于 2025 年）.

文本

Wolfram Research (2020)，Annotate，Wolfram 语言函数，https://reference.wolfram.com/language/ref/Annotate.html （更新于 2025 年）.

CMS

Wolfram 语言. 2020. "Annotate." Wolfram 语言与系统参考资料中心. Wolfram Research. 最新版本 2025. https://reference.wolfram.com/language/ref/Annotate.html.

APA

Wolfram 语言. (2020). Annotate. Wolfram 语言与系统参考资料中心. 追溯自 https://reference.wolfram.com/language/ref/Annotate.html 年

BibTeX

@misc{reference.wolfram_2026_annotate, author="Wolfram Research", title="{Annotate}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/Annotate.html}", note=[Accessed: 16-August-2026]}

BibLaTeX

@online{reference.wolfram_2026_annotate, organization={Wolfram Research}, title={Annotate}, year={2025}, url={https://reference.wolfram.com/language/ref/Annotate.html}, note=[Accessed: 16-August-2026]}