1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/print.R
\name{print.igraph}
\alias{print.igraph}
\alias{print_all}
\alias{summary.igraph}
\alias{str.igraph}
\title{Print graphs to the terminal}
\usage{
\method{print}{igraph}(
x,
full = igraph_opt("print.full"),
graph.attributes = igraph_opt("print.graph.attributes"),
vertex.attributes = igraph_opt("print.vertex.attributes"),
edge.attributes = igraph_opt("print.edge.attributes"),
names = TRUE,
max.lines = igraph_opt("auto.print.lines"),
id = igraph_opt("print.id"),
...
)
\method{summary}{igraph}(object, ...)
}
\arguments{
\item{x}{The graph to print.}
\item{full}{Logical scalar, whether to print the graph structure itself as
well.}
\item{graph.attributes}{Logical constant, whether to print graph attributes.}
\item{vertex.attributes}{Logical constant, whether to print vertex
attributes.}
\item{edge.attributes}{Logical constant, whether to print edge attributes.}
\item{names}{Logical constant, whether to print symbolic vertex names (i.e.
the \code{name} vertex attribute) or vertex ids.}
\item{max.lines}{The maximum number of lines to use. The rest of the
output will be truncated.}
\item{id}{Whether to print the graph ID.}
\item{\dots}{Additional agruments.}
\item{object}{The graph of which the summary will be printed.}
}
\value{
All these functions return the graph invisibly.
}
\description{
These functions attempt to print a graph to the terminal in a human readable
form.
}
\details{
\code{summary.igraph} prints the number of vertices, edges and whether the
graph is directed.
\code{print_all()} prints the same information, and also lists the edges, and
optionally graph, vertex and/or edge attributes.
\code{print.igraph()} behaves either as \code{summary.igraph} or
\code{print_all()} depending on the \code{full} argument. See also the
\sQuote{print.full} igraph option and \code{\link[=igraph_opt]{igraph_opt()}}.
The graph summary printed by \code{summary.igraph} (and \code{print.igraph()}
and \code{print_all()}) consists of one or more lines. The first line contains
the basic properties of the graph, and the rest contains its attributes.
Here is an example, a small star graph with weighted directed edges and named
vertices: \preformatted{ IGRAPH badcafe DNW- 10 9 -- In-star
+ attr: name (g/c), mode (g/c), center (g/n), name (v/c),
weight (e/n) }
The first line always
starts with \code{IGRAPH}, showing you that the object is an igraph graph.
Then a seven character code is printed, this the first seven characters
of the unique id of the graph. See \code{\link[=graph_id]{graph_id()}} for more.
Then a four letter long code string is printed. The first letter
distinguishes between directed (\sQuote{\code{D}}) and undirected
(\sQuote{\code{U}}) graphs. The second letter is \sQuote{\code{N}} for named
graphs, i.e. graphs with the \code{name} vertex attribute set. The third
letter is \sQuote{\code{W}} for weighted graphs, i.e. graphs with the
\code{weight} edge attribute set. The fourth letter is \sQuote{\code{B}} for
bipartite graphs, i.e. for graphs with the \code{type} vertex attribute set.
This is followed by the number of vertices and edges, then two dashes.
Finally, after two dashes, the name of the graph is printed, if it has one,
i.e. if the \code{name} graph attribute is set.
From the second line, the attributes of the graph are listed, separated by a
comma. After the attribute names, the kind of the attribute -- graph
(\sQuote{\code{g}}), vertex (\sQuote{\code{v}}) or edge (\sQuote{\code{e}})
-- is denoted, and the type of the attribute as well, character
(\sQuote{\code{c}}), numeric (\sQuote{\code{n}}), logical
(\sQuote{\code{l}}), or other (\sQuote{\code{x}}).
As of igraph 0.4 \code{print_all()} and \code{print.igraph()} use the
\code{max.print} option, see \code{\link[base:options]{base::options()}} for details.
As of igraph 1.1.1, the \code{str.igraph} function is defunct, use
\code{print_all()}.
}
\examples{
g <- make_ring(10)
g
summary(g)
}
\author{
Gabor Csardi \email{csardi.gabor@gmail.com}
}
\concept{print}
\keyword{graphs}
|
