Skip to content

AGNA 2.2.1

Latest

Choose a tag to compare

@baeckett baeckett released this 14 Nov 18:23

AGNA 2.2.1 — Random Graph Generation, Scalability, and Symmetrization Update

AGNA (Applied Graph and Network Analysis) 2.2.1 brings interactive random network generation and tie randomization across 8 classical theoretical SNA graph models, improved scalability for adding large sets of actors, default Bavelas-Leavitt centrality, and critical fixes for sociomatrix symmetrization, betweenness centrality evaluation, and table export dialogs.


🚀 Key Highlights & New Capabilities in Version 2.2.1

1. Interactive Random Graph Generation & Edge Population

  • Desktop UI (Network ▸ Populate with Random Edge Values...):
    Interactive dialog allowing users to populate ties in-place or generate a new randomized network copy with custom edge values across 8 theoretical models:
    1. Erdős–Rényi $G(n, p)$ (Binary Random Ties): Independent link probability $p \in (0, 1]$.
    2. Erdős–Rényi $G(n, m)$ (Exact Edge Count): Distributes exactly $m$ uniform random ties.
    3. Continuous Uniform Weights: Random continuous edge weights in custom interval $[w_{\min}, w_{\max}]$ with density $p$.
    4. Watts–Strogatz Small-World: Ring lattice of neighborhood degree $k$ with rewiring probability $\beta$.
    5. Barabási–Albert Scale-Free: Preferential attachment growth adding $m$ edges per new node.
    6. Random Connected Graph: Guarantees 0 isolate nodes and a connected component before optional random tie densification.
    7. Degree-Preserving Permutation: Maslov–Sneppen edge rewiring preserving exact empirical degree sequence.
    8. Weight Shuffling Permutation: Preserves graph topology while uniformly permuting edge weights across existing links.
  • CLI & Headless Automation (agna randomize):
    • Standalone command: agna randomize <input> <output> --model <model:params> [--directed] [--json]
    • Pipeline operation: agna transform <input> <output> --op randomize:<model>[:<params>]

2. Centrality Battery Defaults & Bavelas-Leavitt

  • Enabled by Default: Bavelas-Leavitt Centrality is now checked by default across Centrality battery dialogs and the Standard Centralities preset.

3. Scalable Node Addition

  • Higher Limits Without Warning: Allows adding up to 250 nodes (or up to 500 total actors in network) immediately without warning prompts.
  • Large Network Safety Confirmation: Prompts with an informative confirmation when adding $&gt; 250$ up to 5,000 nodes.
  • Synchronized GUI Experience: Identical behavior and validation whether accessed from the main sociomatrix table or from the Network Viewer menu.

4. Menu & Diagnostic Cleanups

  • Removed Zero Diagonal Item: Eliminated the redundant Network ▸ Zero Diagonal menu item since sociomatrix diagonals are always strictly forced to zero in modern AGNA.

🐛 Bug Fixes & Refinements

  • Sociomatrix Symmetrization Fix: Fixed a state synchronization issue in GrNet.symmetrize() where operations like Symmetrize by Maximum failed to reflect symmetric tie values immediately in the active sociomatrix model and Network Viewer canvas.
  • Betweenness Centrality Connectivity Ungating: Brandes betweenness centrality now evaluates gracefully across connected and disconnected networks rather than aborting with a warning.
  • Export Table Dialog Redraw: Resolved layout and modal duplication issues where the table export dialog required pressing Close twice.

🍏 Note for macOS Users (Gatekeeper Security Notice)

When installing AGNA-2.2.1.dmg and opening AGNA.app for the first time, macOS Gatekeeper may show a warning:

"Apple could not verify “AGNA.app” is free of malware that may harm your Mac or compromise your privacy."

Why this happens: AGNA is a free, independent open-source project and is not signed with a paid ($99/year) Apple Developer ID certificate.

How to open:

  1. Drag AGNA.app from the DMG into your /Applications folder.
  2. In Finder, Right-Click (or Control-Click) AGNA.app and choose "Open".
  3. A security prompt will appear with an "Open" button. Click Open.
  4. Alternative Terminal command: Open Terminal and run:
    xattr -cr /Applications/AGNA.app
    macOS will permanently record your approval and launch normally on all future runs.

📦 Downloads & Artifacts

1. Desktop GUI Installer (macOS Apple Silicon & Intel)

  • AGNA-2.2.1.dmg: Drag-and-drop installer for macOS (bundles embedded Java runtime).

2. Cross-Platform Executable JARs (Java 17+)

  • AGNA-2.2.1-desktop.jar: Shaded desktop GUI application.
  • AGNA-2.2.1-cli.jar: Shaded headless CLI and MCP server executable.

3. Source & Archival


📖 Citation

@software{benta_2026_agna,
  author    = {Bența, Marius I.},
  title     = {{AGNA}: Applied Graph and Network Analysis Open Source},
  version   = {2.2.1},
  year      = {2026},
  publisher = {AGNA Open Source},
  doi       = {10.5281/zenodo.24226451},
  url       = {https://github.com/baeckett/AGNA}
}