Skip to content

Skip hub nodes and include block nodes in sampling#60

Merged
VJalili merged 4 commits into
B1AAB:mainfrom
VJalili:new-sampling-algorithm
May 19, 2026
Merged

Skip hub nodes and include block nodes in sampling#60
VJalili merged 4 commits into
B1AAB:mainfrom
VJalili:new-sampling-algorithm

Conversation

@VJalili

@VJalili VJalili commented May 18, 2026

Copy link
Copy Markdown
Collaborator

This PR introduces two major improvements to the sampling algorithm:

  • Ability to skip hub nodes: Hub nodes (e.g., exchange or mixer nodes) are characterized by a highly significant in/out-degree. Because two nodes connected through a hub are not necessarily related, including a hub node and its subsequent connections can artificially inflate and mislead the sampled neighborhood. To address this, we added an option to define a traversal stopping criterion: the algorithm will no longer expand beyond a node if its in/out-degree exceeds a specified threshold.

  • Automatic block node inclusion: In domains like finance, Block nodes provide crucial macroeconomic context for a transaction. Pairing a transaction (Tx) node with its respective Block node yields richer features for downstream learning tasks. This PR adds a configuration option ensuring that every Tx node sampled into a neighborhood automatically brings its corresponding Block node with it.

Additionally, this PR renames the sampling algorithm from Forest Fire to Panorama. Our implementation has evolved far beyond the original Forest Fire concept, and updating the name prevents confusion moving forward.

@VJalili VJalili changed the title Add an option to skip hub nodes and ensure block node is added in the sampling algorithm. Skip hub nodes and include block nodes in sampling May 18, 2026
@VJalili
VJalili merged commit 7230922 into B1AAB:main May 19, 2026
4 checks passed
@VJalili
VJalili deleted the new-sampling-algorithm branch May 19, 2026 00:05
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.

1 participant