# DiGraph Qualified name: `manim.mobject.graph.DiGraph` ### *class* DiGraph(vertices, edges, labels=False, label_fill_color=ManimColor('#000000'), layout='spring', layout_scale=2, layout_config=None, vertex_type=, vertex_config=None, vertex_mobjects=None, edge_type=, partitions=None, root_vertex=None, edge_config=None) Bases: [`GenericGraph`](manim.mobject.graph.GenericGraph.md#manim.mobject.graph.GenericGraph) A directed graph. #### NOTE In contrast to undirected graphs, the order in which vertices in a given edge are specified is relevant here. #### SEE ALSO [`GenericGraph`](manim.mobject.graph.GenericGraph.md#manim.mobject.graph.GenericGraph) * **Parameters:** * **vertices** (*Sequence* *[**Hashable* *]*) – A list of vertices. Must be hashable elements. * **edges** (*Sequence* *[**tuple* *[**Hashable* *,* *Hashable* *]* *]*) – A list of edges, specified as tuples `(u, v)` where both `u` and `v` are vertices. The edge is directed from `u` to `v`. * **labels** (*bool* *|* *dict*) – Controls whether or not vertices are labeled. If `False` (the default), the vertices are not labeled; if `True` they are labeled using their names (as specified in `vertices`) via [`MathTex`](manim.mobject.text.tex_mobject.MathTex.md#manim.mobject.text.tex_mobject.MathTex). Alternatively, custom labels can be specified by passing a dictionary whose keys are the vertices, and whose values are the corresponding vertex labels (rendered via, e.g., [`Text`](manim.mobject.text.text_mobject.Text.md#manim.mobject.text.text_mobject.Text) or [`Tex`](manim.mobject.text.tex_mobject.Tex.md#manim.mobject.text.tex_mobject.Tex)). * **label_fill_color** (*str*) – Sets the fill color of the default labels generated when `labels` is set to `True`. Has no effect for other values of `labels`. * **layout** (*LayoutName* *|* *dict* *[**Hashable* *,* [*Point3DLike*](manim.typing.md#manim.typing.Point3DLike) *]* *|* [*LayoutFunction*](manim.mobject.graph.LayoutFunction.md#manim.mobject.graph.LayoutFunction)) – Either one of `"spring"` (the default), `"circular"`, `"kamada_kawai"`, `"planar"`, `"random"`, `"shell"`, `"spectral"`, `"spiral"`, `"tree"`, and `"partite"` for automatic vertex positioning using `networkx` (see [their documentation](https://networkx.org/documentation/stable/reference/drawing.html#module-networkx.drawing.layout) for more details), or a dictionary specifying a coordinate (value) for each vertex (key) for manual positioning. * **layout_config** (*dict* *|* *None*) – Only for automatically generated layouts. A dictionary whose entries are passed as keyword arguments to the automatic layout algorithm specified via `layout` of `networkx`. The `tree` layout also accepts a special parameter `vertex_spacing` passed as a keyword argument inside the `layout_config` dictionary. Passing a tuple `(space_x, space_y)` as this argument overrides the value of `layout_scale` and ensures that vertices are arranged in a way such that the centers of siblings in the same layer are at least `space_x` units apart horizontally, and neighboring layers are spaced `space_y` units vertically. * **layout_scale** (*float* *|* *tuple* *[**float* *,* *float* *,* *float* *]*) – The scale of automatically generated layouts: the vertices will be arranged such that the coordinates are located within the interval `[-scale, scale]`. Some layouts accept a tuple `(scale_x, scale_y)` causing the first coordinate to be in the interval `[-scale_x, scale_x]`, and the second in `[-scale_y, scale_y]`. Default: 2. * **vertex_type** (*type* *[*[*Mobject*](manim.mobject.mobject.Mobject.md#manim.mobject.mobject.Mobject) *]*) – The mobject class used for displaying vertices in the scene. * **vertex_config** (*dict* *|* *None*) – Either a dictionary containing keyword arguments to be passed to the class specified via `vertex_type`, or a dictionary whose keys are the vertices, and whose values are dictionaries containing keyword arguments for the mobject related to the corresponding vertex. * **vertex_mobjects** (*dict* *|* *None*) – A dictionary whose keys are the vertices, and whose values are mobjects to be used as vertices. Passing vertices here overrides all other configuration options for a vertex. * **edge_type** (*type* *[*[*Mobject*](manim.mobject.mobject.Mobject.md#manim.mobject.mobject.Mobject) *]*) – The mobject class used for displaying edges in the scene. * **edge_config** (*dict* *|* *None*) – Either a dictionary containing keyword arguments to be passed to the class specified via `edge_type`, or a dictionary whose keys are the edges, and whose values are dictionaries containing keyword arguments for the mobject related to the corresponding edge. You can further customize the tip by adding a `tip_config` dictionary for global styling, or by adding the dict to a specific `edge_config`. * **partitions** (*Sequence* *[**Sequence* *[**Hashable* *]* *]* *|* *None*) * **root_vertex** (*Hashable* *|* *None*) ### Examples You can customize the edges and arrow tips globally or locally. Since this implementation respects the labels boundary you can also use it for an undirected moving graph with labels. ### Methods | [`update_edges`](#manim.mobject.graph.DiGraph.update_edges) | Updates the edges to stick at their corresponding vertices. | |---------------------------------------------------------------|---------------------------------------------------------------| ### Attributes | `animate` | Used to animate the application of any method of `self`. | |-----------------------|------------------------------------------------------------------------| | `animation_overrides` | | | `color` | | | `depth` | The depth of the mobject. | | `fill_color` | If there are multiple colors (for gradient) this returns the first one | | `height` | The height of the mobject. | | `n_points_per_curve` | | | `sheen_factor` | | | `stroke_color` | | | `width` | The width of the mobject. | #### *static* \_empty_networkx_graph() Return an empty networkx graph for the given graph type. * **Return type:** *DiGraph* #### \_original_\_init_\_(vertices, edges, labels=False, label_fill_color=ManimColor('#000000'), layout='spring', layout_scale=2, layout_config=None, vertex_type=, vertex_config=None, vertex_mobjects=None, edge_type=, partitions=None, root_vertex=None, edge_config=None) Initialize self. See help(type(self)) for accurate signature. * **Parameters:** * **vertices** (*Sequence* *[**Hashable* *]*) * **edges** (*Sequence* *[**tuple* *[**Hashable* *,* *Hashable* *]* *]*) * **labels** (*bool* *|* *dict*) * **label_fill_color** (*str*) * **layout** (*Literal* *[* *'circular'* *,* *'kamada_kawai'* *,* *'partite'* *,* *'planar'* *,* *'random'* *,* *'shell'* *,* *'spectral'* *,* *'spiral'* *,* *'spring'* *,* *'tree'* *]* *|* *dict* *[* *~collections.abc.Hashable* *,* *~manim.typing.Point3DLike* *]* *|* *~manim.mobject.graph.LayoutFunction*) * **layout_scale** (*float* *|* *tuple* *[**float* *,* *float* *,* *float* *]*) * **layout_config** (*dict* *|* *None*) * **vertex_type** (*type* *[*[*Mobject*](manim.mobject.mobject.Mobject.md#manim.mobject.mobject.Mobject) *]*) * **vertex_config** (*dict* *|* *None*) * **vertex_mobjects** (*dict* *|* *None*) * **edge_type** (*type* *[*[*Mobject*](manim.mobject.mobject.Mobject.md#manim.mobject.mobject.Mobject) *]*) * **partitions** (*Sequence* *[**Sequence* *[**Hashable* *]* *]* *|* *None*) * **root_vertex** (*Hashable* *|* *None*) * **edge_config** (*dict* *|* *None*) * **Return type:** None #### \_populate_edge_dict(edges, edge_type) Helper method for populating the edges of the graph. * **Parameters:** * **edges** (*list* *[**tuple* *[**Hashable* *,* *Hashable* *]* *]*) * **edge_type** (*type* *[*[*Mobject*](manim.mobject.mobject.Mobject.md#manim.mobject.mobject.Mobject) *]*) #### update_edges(graph) Updates the edges to stick at their corresponding vertices. Arrow tips need to be repositioned since otherwise they can be deformed.