Skip to content

Clarify package architecture: marks in netrics, is_*() in manynet, dependency guidance for autograph#2

Closed
Copilot wants to merge 7 commits intomainfrom
copilot/update-netrics-documentation
Closed

Clarify package architecture: marks in netrics, is_*() in manynet, dependency guidance for autograph#2
Copilot wants to merge 7 commits intomainfrom
copilot/update-netrics-documentation

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Feb 28, 2026

Addresses the question of where mark functions should live and how downstream packages like {autograph} should structure their dependencies.

Decision: node_is_*() and tie_is_*() stay in {netrics} — they are analytic functions (finding cutpoints, bridges requires graph algorithms). Network-level is_*() tests (is_directed(), is_twomode()) stay in {manynet} — they describe data type, not analytic results. {autograph} should depend on both since it needs network classes and analytic results to visualize.

Changes

  • README.Rmd/README.md: Rewrite About and Relationship sections to define the stocnet dependency graph (manynetnetricsautograph/migraph) and the data-property vs analytic-result separation principle
  • README.Rmd/README.md: Separate Measures (*_by_*()) from Motifs (*_x_*()) into distinct sections — these were conflated under a single "Motifs" heading
  • README.Rmd/README.md: Fix stale function names in Measuring section (node_degree()node_by_degree(), etc.)
  • DESCRIPTION: Enumerate the four function families with naming patterns in package description
  • _pkgdown.yml: Add naming conventions to section descriptions (Markingnode_is_*(), Measures*_by_*(), etc.)

Architecture

{manynet}    → classes, coercion, modification, is_*()
{netrics}    → measures _by_(), memberships _in_(), motifs _x_(), marks node_is_/tie_is_()
{autograph}  → visualization — depends on both manynet + netrics
{migraph}    → modelling — depends on both manynet + netrics

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI and others added 3 commits February 28, 2026 06:42
…reate _pkgdown.yml, update DESCRIPTION

Co-authored-by: jhollway <5595229+jhollway@users.noreply.github.com>
…efs, remove tutorials section, update installation)

Co-authored-by: jhollway <5595229+jhollway@users.noreply.github.com>
…tch package conventions

Co-authored-by: jhollway <5595229+jhollway@users.noreply.github.com>
Copilot AI changed the title [WIP] Update documentation and tests for netrics package Fix package identity: replace stale manynet/migraph references, add pkgdown config Feb 28, 2026
Copilot AI and others added 3 commits March 2, 2026 06:29
…tograph depends on both

Co-authored-by: jhollway <5595229+jhollway@users.noreply.github.com>
…ming conventions

Co-authored-by: jhollway <5595229+jhollway@users.noreply.github.com>
Co-authored-by: jhollway <5595229+jhollway@users.noreply.github.com>
Copilot AI changed the title Fix package identity: replace stale manynet/migraph references, add pkgdown config Clarify package architecture: marks in netrics, is_*() in manynet, dependency guidance for autograph Mar 2, 2026
@jhollway jhollway closed this Mar 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants