NEWS
autograph 1.0.3 (2026-05-01)
Plotting
- Fixed the error produced by a namespace reference in a call in
ergm_res by serializing it, moving to extdata, and loading it via load_ergm_res()
autograph 1.0.2
Plotting
- Fixed the error produced by a namespace reference in a call in
ergm_res
autograph 1.0.1
Package
Plotting
- Fixed the error in some flavours by removing environment references in included objects
- Closed #44 by adding example that uses
ggplot2::scale_colour_discrete() to tweak colour output
Tutorials
- Fixed the tutorial to use netrics functions
autograph 1.0.0 (2026-04-04)
Package
- Updated startup message to declare the set theme
Graphing
- Improved
node_shape to accept more categories
- Moved
node_is_isolate and node_adoption_time to internal helpers to reduce dependencies
- Fixed #47 by overriding shape to fillable (21)
- Fixed #10 and #52 by adding label distance parameter
- Fixed #17 and #40 by improving
grapht()
Plotting
- Closed #37 by adding EgoAlter sienaGOF plot
- Fixed #36 by using
.to_factor() in plot.ag_gof() to correct numeric ordering of statistics, and dropped cumulative correction in plot.sienaGOF()
- Fixed #38 by dropping linetype in favour of colours even for bw theme in
plot.influenceTable()
- Fixed option reference from
snet_theme to stocnet_theme in plot.selectionTable() and plot.influenceTable()
- Applied
ag_font() to migraph model plots for consistent typography
- Reorganised plot scripts by purpose: summaries, tests, and analysis
- Fixed #46 by not appending "X" to the names when creating the data frame and moving factor coercion later in the process
Tutorial
- Fixed #41 by updating tutorials to use fill aesthetics (
scale_fill_*()) instead of colour aesthetics (scale_colour_*())
autograph 0.6.0 (2026-03-01)
Package
Graphing
graphr() now auto-dispatches to graphs() when passed a list of graphs
graphs() no longer requires {patchwork} to be loaded separately
- Closed #12 by changing node aesthetics from
color to fill using fillable shape codes (21–25) for nodes to support fill-based colour scales
- Consolidated legend modifications into internal
graph_legends() helper
- Improved legend labelling:
- edge sign legend now labelled "Sign"
- edge weight/width now labelled "Weight"/"Width"
- node mode/shape legend now labelled "Mode"/"Shape"
- Closed #8 by adding "isolates" argument to
graphr():
"legend" (default) removes isolates from the graph but notes them in the legend
"caption" removes isolates from the graph but notes them in the caption
"keep" retains isolates in the graph as-is (closes #12)
Theming
- Removed
scale_*() functions as redundant with better theme support and match_color()
Layouts
- Replaced
{Rgraphviz} (Bioconductor) with igraph::layout_with_sugiyama for Sugiyama/hierarchy layouts, removing the Bioconductor dependency
- Improved Sugiyama layout with dummy node insertion and barycenter crossing minimisation for better edge routing
- Fixed #18 for lattice layout snapping by rotating the layout to optimise edge verticality and horizontality
autograph 0.5.1
Plotting
- Improved
plot.gof.ergm() (closes #31)
- Now works on directed and two-mode networks and dyadwise shared partners
- Now has more informative error message if statistic not available
- Now accepts more descriptive and gof-formula consistent statistic names
autograph 0.5.0 (2025-11-19)
Package
- Shortened startup messages
Plotting
- Added
plot.goldfish.changepoints()
- Added
plot.goldfish.outliers()
- Added
plot.mnet() to avoid igraph::plot.igraph() dispatching
Graphing
- Restructured scripts for improved maintenance and development in the future
- Fixed
ggplot2::geom_violin() call in graphr() to avoid warnings with ggplot2 v4.0.0
- Improved
graphr() internals to rely on a NULL "layout" parameter and .infer_layout()
- Improved
graphr() to use match_color() for diffusion palettes
- Fixed
graphs() handling of changing networks
autograph 0.4.2
Package
Plotting
- Fixed node overflow issue and restored marginal density plot in
plot.ag_conv() by dropping +.ggplot()
- Added automatic legend labelling where node_size or node_color or edge_color is given
Theming
- Added "hwu" theme for Heriot-Watt University
- Improved highlight and divergent theme setting to use switch
- Added some discussion about colour-blindedness to palettes documentation and viz tute
- Added some instruction on how to customise themes more specifically
autograph 0.4.1 (2025-09-11)
Package
- Improved startup message to ignore class
Theming
- Added "iast" theme for the Institute of Advanced Studies, Toulouse
Plotting
- Improved ergm convergence diagnostic plotting by working on the results object,
mostly avoiding startup conflict warning
- Dropped marginal density plot in
plot.ag_conv() to fix {ggplot2} v4.0.0-related node overflow issue
autograph 0.4.0 (2025-09-10)
Package
- Fixed DOI in CITATION
- Improved README introduction
- Improved README graphing illustration, including igraph comparison figure
- Improved README plotting illustration, added SAOM/ERGM GOF comparison figure
Theming
- Improved
stocnet_theme() documentation
- Improved
stocnet_theme() to register a font family for plots
- A vector of potential fonts is included for some themes
- The first font found on the system will be used, and user notified
- If no fonts are found, the default R font ("sans") will be used
- A message is printed to inform the user if the default is used,
and how to install missing fonts via
{extrafont}
- Added font options for "iheid", "oxf", "ethz", "uzh", and "rug" themes
- Added
ag_font() for retrieving the registered font family
- Improved
match_colors() documentation
- Exported
is_dark() and made it vectorised
- Added
match_colors() and is_dark() tests
- Dropped
theme_*() functions in favour of stocnet_theme()
- Dropped
theme_*() tests
- Added
stocnet_theme() tests
- Added "cmu" theme for Carnegie Mellon University
Graphing
- Improved
graphr() by using registered fonts where available
- Improved
graphr() by using ag_qualitative() for discrete colour scales
Plotting
- Improved
plot.selectionTable() and plot.influenceTable() documentation
by consolidating them together into one help file
- Improved
plot.ag_conv(), plot.ag_gof(), and plot_interp by using
registered fonts where available
- Improved
plot.sienaGOF() to use lower case auxiliary statistic description
Data
- Renamed
res_monan_traces to monan_conv
- Renamed
res_monan_gof to monan_gof
- Renamed
res_ergm_gof to ergm_gof
- Renamed
res_siena_gof to siena_gof
- Renamed
res_siena_influence to siena_influence
- Renamed
res_siena_selection to siena_selection
autograph 0.3.1
Package
- Fixed old citation style issue for CRAN
Plotting
- Added
plot.ag_conv() as a new plotting method for convergence diagnostics
- Plots MCMC traces as a line plot with loess smoothing highlighting the trend
- Plots overall density plot of the samples on the right margin
- Improved plotting of
{MoNAn} trace objects by using plot.ag_conv()
- Added
plot.mcmc.list() for plotting MCMC samples from ergm::ergm results objects,
using plot.ag_conv()
Data
- Added
ergm_res for testing and illustration of plot.mcmc.list(),
use ergm_res$sample to access the MCMC sample
autograph 0.3.0
Package
- Added package documentation
- Added citation
- Dropped dependencies
{tidyr}, {cli}, and {concaveman}
- Added more description to the function overview sections on the website
- Added CODECOV_TOKEN to Github secrets for test coverage reporting
Graphing
- Fixed
graphr() not using theme colours for node and edge aesthetics
Plotting
- Added new plot class and method for centralising GOF plotting
- Improved
plot.sienaGOF() and plot.gof.stats.monan() to use new plotting method
- Added
plot.gof.ergm() for plotting ERGM GOF objects
- Improved GOF plotting by adding boxplot within the violins
- Improved GOF plotting by adding crosses for outliers
- Improved GOF plotting by adding dashed line for 0.05 and 0.95 quantile bounds
- Improved GOF plotting by dropping statistics without variance
- Improved GOF plotting by using
cumulative = FALSE by default
- Fixed issue with pre-v1.3.20 RSiena::gof() objects, thanks @TomSnijders
- Added testing of GOF plotting
- Added testing of measures plotting
Theming
- Added
set_stocnet_theme() alias for stocnet_theme()
- Fixed issue with 'oxf' and 'unige' themes not being recognised
Data
- Added
res_ergm_gof for testing and illustration of plot.gof.ergm()
Tutorial
- Added visualisation tutorial from manynet
- Improved introduction
- Improved section on titles, labels, and legends
- Improved section explaining base and grid graphics
- Added section demonstrating difference between
igraph::plot(), ggraph::ggraph(), and graphr()
- Added table describing the main arguments of
graphr() and the visualisation dimensions to which they relate
- Added section showing how to use "node_shape" (poorly)
- Improved section showing how to use "node_colour" and "node_group"
- Added section showing how to use "node_size"
- Added section showing how to set a theme
- Added section showing how to use "edge_colour" and "edge_size"
- Improved section introducing
{patchwork}, graphs(), and grapht()
- Added plotting section to viz tutorial
autograph 0.2.0 (2025-08-22)
Package
- Added (currently) necessary dependencies
- Removed unnecessary manynet dependencies
Plotting
- Added
graphr(), graphs(), and grapht() from manynet for quick plotting of one or more graphs
- Improved
+.ggplot() to check whether second object inherits ggplot class (thanks @teunbrand for fixing #110)
- Fixed issue with edge_linetype in signed, directed networks with weights (closed #14)
- Updated README with examples of
graphr() and others
Themes
- Added themes for Oxford and UNIGE (closed #1)
- Improved
stocnet_theme() to add option to "stocnet_theme" (previously "snet_theme")
- Added
is_dark() to check whether a theme is dark or light
- Added
match_color() to return closest matching colors from a palette
Layouts
- Added layout_valence() for signed graphs (closed #6)
- Added configurational layouts from manynet
- Added aliases for various layout_tbl_graph_*() functions
autograph 0.1.2 (2025-07-02)
Package
- Fixed line break issues in DESCRIPTION
Themes
- Fixed default for
ag_sequential()
Layouts
- Fixed "layout_layered" to accept typical ggraph parameters
manynet
- Added return value statements
migraph
- Added return value statements
RSiena
- Added return value statements
MoNAn
- Added
plot.traces.monan()
- Added
plot.gof.stats.monan()
autograph 0.1.1
Package
autograph 0.1.0
Package
- Initial setup, with all the goodies
Theming
- Added
stocnet_theme() for setting a theme that can then be reused across
successive plots (closes #3)
- For example,
stocnet_theme("iheid") for IHEID colour theme
- Added
ag_*() palettes, for example:
ag_highlight() to select the highlight colours of a particular palette
- Added
match_color() for matching one or more hexcodes to a palette's
offerings
Plotting
- Added manynet plot methods
- Added
plot.diff_model()
- Added
plot.matrix()
- Added
plot.learn_model()
- Added
plot.network_measures()
- Added
plot.network_motif()
- Added
plot.tie_measure()
- Added
plot.node_measure()
- Added
plot.node_member()
- Added
plot.node_members()
- Added
plot.node_motif()
- Added migraph plot methods
- Added
plot.netlm()
- Added
plot.netlogit()
- Added
plot.network_test()
- Added
plot.diffs_model()
- Added RSiena plot methods
- Added
plot.sienaGOF()
- Added
plot.influenceTable()
- Added
plot.selectionTable()
Layouts
- Added
layout_tbl_graph_matching() for positioning nodes according to their
manynet::to_matching() partners
- Added first version of
layout_tbl_graph_layered() for layering nodes
according to a Sugiyama-type layout
Data
- Added some precooked results for testing and illustration