Repository navigation
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:-
Erdős–Rényi
$G(n, p)$ (Binary Random Ties): Independent link probability$p \in (0, 1]$ . -
Erdős–Rényi
$G(n, m)$ (Exact Edge Count): Distributes exactly$m$ uniform random ties. -
Continuous Uniform Weights: Random continuous edge weights in custom interval
$[w_{\min}, w_{\max}]$ with density$p$ . -
Watts–Strogatz Small-World: Ring lattice of neighborhood degree
$k$ with rewiring probability$\beta$ . -
Barabási–Albert Scale-Free: Preferential attachment growth adding
$m$ edges per new node. - Random Connected Graph: Guarantees 0 isolate nodes and a connected component before optional random tie densification.
- Degree-Preserving Permutation: Maslov–Sneppen edge rewiring preserving exact empirical degree sequence.
- Weight Shuffling Permutation: Preserves graph topology while uniformly permuting edge weights across existing links.
-
Erdős–Rényi
-
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>]
- Standalone command:
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
$> 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 Diagonalmenu 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:
- Drag
AGNA.appfrom the DMG into your/Applicationsfolder. - In Finder, Right-Click (or Control-Click)
AGNA.appand choose "Open". - A security prompt will appear with an "Open" button. Click Open.
- Alternative Terminal command: Open Terminal and run:
macOS will permanently record your approval and launch normally on all future runs.
xattr -cr /Applications/AGNA.app
📦 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
AGNA-2.2.1-source.zip: Source archive for contributors and offline builds.- Permanent Zenodo Archival: https://zenodo.org/records/24226451 (DOI:
10.5281/zenodo.24226451)
📖 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}
}