Added CUG and QAP tests, diversity functions, and multilevel censuses

[jhollway]

Description

Package

• Closed Add new getting started vignette #75 by updating the README

Manipulation

• Added some functions for grabbing key information from objects
  • node_names() for quickly accessing node labels
  • node_attribute() for quickly accessing a certain nodal attribute
  • edge_weights() for quickly accessing edge weights
  • graph_nodes() for quickly accessing a count of nodes in the graph, note that for two-mode networks this will be a vector of length 2
  • graph_edges() for quickly accessing a count of edges in the graph
  • graph_dimensions() is currently a copy of graph_nodes()
• Added some functions for adding key information to objects
  • add_node_attributes() for adding particular nodal attributes
  • add_edge_attributes() for adding edges from another graph
  • copy_edge_attributes() for copying all nodal attributes from another graph
• Improved twomode and weighted handling of several functions

Measures

• Added diversity functions
  • graph_blau_index() for summarising diversity of an attribute in a network or group
  • graph_ei_index() for summarising diversity of an attribute over a network's ties

Modelling

• Closed Add node_quad_census #119 by adding node_quad_census(), especially useful for two-mode blockmodelling
• Closed Add multilevel mixed census #95 and Add node_multilevel_triad_census #120 by adding graph_mixed_census()
• Closed Conditional Uniform Graph tests for multimodal graphs #97 by adding test functions
  • test_random() carries out a conditional uniform graph (CUG) test
  • test_permutation() carries out a quadratic assignment procedure (QAP) test

Visualization

• Closed Reexport aes #135 by reexporting aes() from {ggplot2}
• Added node_shape option to autographr()

Checklist:

• PR form
  • This pull request has an informative title
  • Description above itemizes changes under subtitles, e.g. "## Data""
  • Any closed, fixed, or related issues are referenced and explained in the description above, e.g. "Fixed #0 by adding A"
  • Package builds on my OS without issues
• PR checks all pass for latest commit
  • CodeFactor check: Package improves or maintains good style
  • Package builds on Mac
  • Package builds on Windows
  • Package builds on Linux
  • CodeCov check: Package improves or maintains good test coverage
• Documentation
  • Any new or modified functions or data have roxygen style documentation in their .R scripts
  • Any longer functions are commented inline so that it is easier to debug in the future
  • PR description above and the NEWS.md file are aligned
  • DESCRIPTION file version is bumped by the appropriate increment (major, minor, patch)

[codecov-commenter]

Codecov Report

Merging #138 (d1ea7ab) into main (d054130) will increase coverage by 10.14%.
The diff coverage is 11.11%.

❗ Current head d1ea7ab differs from pull request most recent head f13ec05. Consider uploading reports for the commit f13ec05 to get more accurate results

@@             Coverage Diff             @@
##             main     #138       +/-   ##
===========================================
+ Coverage   48.70%   58.84%   +10.14%     
===========================================
  Files          25       30        +5     
  Lines        1501     1645      +144     
===========================================
+ Hits          731      968      +237     
+ Misses        770      677       -93     

Impacted Files	Coverage Δ
R/add.R	0.00% <0.00%> (ø)
R/autographr.R	0.00% <0.00%> (ø)
R/census.R	52.67% <0.00%> (+52.67%)	⬆️
R/diversity.R	0.00% <0.00%> (ø)
R/generate.R	76.47% <ø> (ø)
R/grab.R	0.00% <0.00%> (ø)
R/is.R	66.66% <0.00%> (-10.26%)	⬇️
R/migraph-defunct.R	0.00% <0.00%> (ø)
R/netlm.R	97.05% <ø> (+22.05%)	⬆️
R/tests.R	0.00% <0.00%> (ø)
... and 10 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update d054130...f13ec05. Read the comment docs.