/
NEWS.md
executable file
·183 lines (92 loc) · 10.9 KB
/
NEWS.md
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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
# DiagrammeR 1.0.6
* Removed the `set_df_as_node_attr()`, `set_df_as_edge_attr()`, and `get_attr_dfs()` functions.
# DiagrammeR 1.0.5
* Removes the ability to save a DiagrammeR graph object as a Gephi file (.gexf) since the **rgexf** package is no longer maintained
# DiagrammeR 1.0.0
* Added the helper functions `node_aes()`, `node_data()`, `edge_aes()`, and `edge_data()` to facilitate the binding of node and edge aesthetic and data attribute values; several functions now have namesake arguments that accept these functions' output.
* Information about the graph is now displayed in the console when the graph object is called
* Error messages are now more helpful and try to provide pointers for the more common errors
# DiagrammeR 0.9.2
* Added functions to generate 2D and 3D grid graphs (`add_grid_2d()` and `add_grid_3d()`)
* Added `_ws` (with selection) variants of the `mutate_[node/edge]_attrs()` functions for mutating node or edge attributes for only those nodes/edges in an active selection
* Incorporated an `edges` argument into the `select_edges()` function in order to filter the selection of edges to a set of edge ID values
* Reduced the dependency on R to version >= 3.2.0
# DiagrammeR 0.9.2
* Added functions to generate 2D and 3D grid graphs (`add_grid_2d()` and `add_grid_3d()`)
* Added `_ws` (with selection) variants of the `mutate_[node/edge]_attrs()` functions for mutating node or edge attributes for only those nodes/edges in an active selection
* Incorporated an `edges` argument into the `select_edges()` function in order to filter the selection of edges to a set of edge ID values
* Reduced the dependency on R to version >= 3.2.0
# DiagrammeR 0.9.1
* Simplified many functions internally
* Added a default print method for graph objects
* Allowed use of bare node or edge attribute names in many functions
* Implemented graph actions as a means to run one or more functions at every graph transformation step; for example, this can be used to automatically update a node attribute such as `betweenness` whenever modifications to the graph are made (e.g., adding nodes, removing edges, etc.)
* Data frames can be set as node or edge attributes with the `set_df_as_node_attr()` and `set_df_as_edge_attr()` functions; the `get_attr_dfs()` function allows for retrieval of stored data frame data
* Added two new graph-generating functions (`add_gnp_graph()`, `add_pa_graph()`, and `create_complement_graph()`)
* Added functions to clone existing nodes and edges (`add_n_node_clones()` and `add_edge_clone()`)
* Added several `count_*` functions (`count_asymmetric_node_pairs()`, `count_automorphisms()`, etc.)
* Added new functions to obtain graph properties (`get_adhesion()`, `get_girth()`, `get_reciprocity()`, etc.)
* Added several `is_*` functions for graph and edge properties (e.g., `is_edge_loop()`, `is_graph_dag()`, etc.)
* The `mutate_node_attrs()` and `mutate_edge_attrs()` functions now have simpler and more powerful interfaces for mutating node and edge attributes
* Graphs can be easily saved to disk (and read from disk) using the `save_graph()` and `open_graph()` functions
# DiagrammeR 0.9.0
* Modified basic structure of node and edge data frames such that ID values are automatically set as integer values
* Just as nodes do, edges now have edge ID values (they can be obtained using `get_edge_ids()` and they can be used directly in the `select_edges_by_edge_id()` function)
* When created, a graph object automatically generates a graph ID and graph name (which can be modified using `set_graph_name()`)
* So long as node `label` values are unique, they may now be used to compose edges using the `add_edge()` function with `use_labels = TRUE`
* Quickly and flexibly add color to nodes and edges using the `colorize_node_attrs()` and `colorize_edge_attrs()` functions
* Added functions to selectively modify existing node and edge attributes: `copy_[node/edge]_attrs()`, `drop_[node/edge]_attrs()`, `mutate_[node/edge]_attrs()`, `recode_[node/edge]_attrs()`, `rename_[node/edge]_attrs()`, and `rescale_[node/edge]_attrs()`.
* New node and edge attributes can now be easily added to a graph via a data frame using the `join_node_attrs()` and `join_edge_attrs()` functions
* Several graph generators are available for quickly adding graph primitives to a graph object (`add_balanced_tree()`, `add_cycle()`, `add_full_graph()`, `add_path()`, `add_prism()`, and `add_star()`)
* All traversal functions can now migrate numeric node or edge attribute values to the traversed edges (e.g., `trav_out_edge()`, `trav_in_node()`) by providing an attribute name to `copy_attrs_from`; for those traversal functions where nodes or edges may receive multiple values, one can specify an aggregation type in their `agg` argument (e.g,. `trav_in_node()`, `trav_both_edge()`)
* Multiple conditions can be specified for all traversal types and for the `select_nodes()` and `select_edges()` functions, plus, they are much easier to write
* Added the `mk_cond()` helper function for creating conditions for any of the traversal functions (`trav_...()`), and, the `select_nodes()` and `select_edges()` functions; this helper allows for easier composition of selection/traversal conditions using variables and/or function calls
* With a selection of edges one can now use `select_rev_edges_ws()` to transform that selection to that of the selected edges' reverse edges (where available); the option is there to add the reverse edges to the edge selection or to simply replace the current selection
* Caching attributes for later use has been made simpler with a collection of `cache_...()` functions (or, set the cache explicitly using `set_cache()`); get the graph's cache using the `get_cache()` function
* Added functions to allow for layout control of nodes (`set_node_position()`, `layout_nodes_w_string()`, `nudge_node_positions()`)
* Added functions to convert **DiagrammeR** graphs to **igraph** graphs and vice versa (`to_igraph()`, `from_igraph()`)
* Now you can create a graph from an adjacency matrix (`from_adj_matrix()`)
* Added functions to get community membership with a variety of algorithms: `get_cmty_edge_btwns()`, `get_cmty_fast_greedy()`, `get_cmty_l_eigenvec()`, `get_cmty_louvain()`, and `get_cmty_walktrap()`.
* Added functions to determine similarity coefficient scores for graph nodes: `get_dice_similarity()` and `get_dice_similarity()`.
* Constraint scores for nodes can now be determined using the `get_constraint()` function
* Functions for getting information on nodes neighbors have been added: `get_nbrs()`, `get_non_nbrs()`, `get_similar_nbrs()`.
* Groups of nodes that are weakly or strongly connected components can be determined using the `get_w_connected_cmpts()` and `get_s_connected_cmpts()` functions
* Get articulation points (i.e., nodes that, when removed, disconnect the graph) with the `get_articulation_points()` function
* Obtain centrality measures for graph nodes using the `get_closeness()` and `get_betweenness()` functions
* Get the minimum-spanning tree subgraph from a graph with weighted edges using the `get_min_spanning_tree()` function
* The edge direction may be reversed for an entire graph (`rev_edge_dir()`) or for part of a graph using an edge selection (`rev_edge_dir_ws()`)
* Depth-first search and breadth-first search algorithms are available in the `do_dfs()` and `do_bfs()` functions
* Degree data for plots can now be easily obtained using the `get_degree_distribution()` and `get_degree_histogram()` functions
* Global graph attributes are now more easily modifiable using a set of functions for this purpose: `add_global_graph_attrs()`, `clear_global_graph_attrs()`, `delete_global_graph_attrs()`, `get_global_graph_attrs()`, `set_global_graph_attrs()`
* Added option to display different text labels on nodes via the `display` node attribute; this is easily set with the `set_node_attr_to_display()` function
* Rewrote many graph functions (e.g. traversals) so that they are faster for very large graphs
* A log of all graph functions that directly modify the graph is now part of the graph object (`graph$graph_log`)
* Added functionality to automatically generate graph backups at every graph modification; this is in the form of RDS files deposited in a subdirectory (name is based on the graph ID) of the working directory; the option (`write_backups`, set to `FALSE` by default) is available in all functions that initialize a graph object (`create_graph()`, `create_random_graph()`, `from_igraph()`, `from_adj_matrix()`)
# DiagrammeR 0.8
* Revised many graph functions so they work better together
* Added many **testthat** tests to maintain the quality of the graph functions
* Added functions `create_random_graph()`, `import_graph()`, `combine_graphs()`, `country_graph()` and `select_graph_from_series()`
* Added support for **visNetwork** graphs as a rendering option with `render_graph()`
# DiagrammeR 0.7
* Renamed functions `graphviz_graph()` and `graphviz_render()` to `create_graph()` and `render_graph()`, respectively
* Removed function `graphviz_export()` (exporting now handled with `render_graph()`)
* Added several new functions to inspect, analyze, and modify graphs: `display_graph_object()`, `node_info()`, `edge_info()`, `node_present()`, `edge_present()`, `get_nodes()`, `get_edges()`, `get_predecessors()`, `get_successors()`, `node_count()`, `edge_count()`, `is_graph_empty()`, `is_graph_directed()`, `add_node()`, `add_edges()`, `delete_node()`, `delete_edge()`, `node_type()`, `edge_relationship()`, `create_series()`, `add_to_series()`, `remove_from_series()`, `graph_count()`, `subset_series()`, `trigger_script()`, `render_graph_from_series()`, and `series_info()`
# DiagrammeR 0.6
* Added several functions to work with graphs: `create_nodes()`, `create_edges()`, `combine_nodes()`, `combine_edges()`, `scale_nodes()`, `scale_edges()`, `get_nodes()`, `node_info()`, `graphviz_graph()`, `graphviz_render()`, and `graphviz_export()`
* Removed the `graphviz_nodes_edges_df()` and `graphviz_single_df()` functions
# DiagrammeR 0.5
* Added support for subgraphs and Gantt charts in **mermaid** diagrams
* Added function `graphviz_nodes_edges_df()` for generating **Graphviz** **DOT** code that defines nodes and edges (and their attributes) from data in two data frames: one for nodes, the other for the edge operations
* Added function `graphviz_single_df()` for generating **Graphviz** **DOT** code from a single data frame
* Incorporated the new substitution operators `@_{...}` or `@^{...}` in `grViz` statements for subscripting and superscripting, respectively
# DiagrammeR 0.4
* Added support for substitution in **Graphviz** graph specifications
* Added support for **Graphviz** diagrams in the **Shiny** app
# DiagrammeR 0.3
* Added support for the **Graphviz** **neato**, **twopi**, and **circo** engines
# DiagrammeR 0.2
* Added the **viz.js** library to enable **Graphviz** support
# DiagrammeR 0.1
* Initial release
* Incorporated into the **htmlwidgets** framework
* Added basic **shiny** app