Oignon: Citation Graph Tool
H. Ballington · 2025
Read Oignon: Citation Graph Tool by H. Ballington (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2512-22159.txt.
Introduction
Harry Ballington introduces Oignon, a free and open-source tool for drawing citation graphs around a chosen publication. Citation graphs help researchers see how a paper connects to earlier and later work. Ballington notes that current tools often scale poorly, trace networks only shallowly, hide features behind paid tiers, or build graphs slowly.
Oignon explores the literature systematically and ranks papers through a dual-path system with recency weighting. That design lets one graph show both the foundational works a field rests on and the recent breakthroughs growing out of them. The tool is offered as a practical aid for gaining context awareness at the start of a research project.
Catalog record
| CREATOR | H. Ballington |
|---|---|
| YEAR | 2025 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 6 KB |
| VERSION | 1.0 |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2512-22159
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
Oignon: Citation Graph Tool
H. Ballington
Abstract
Citation graph visualisation is a useful tool for contextual awareness in academic research. Unfortunately, existing solutions can suffer from several drawbacks, such as a poor scaling, shallow network traversal, freemium gating, and slow build times. Oignon is a free, open-source tool for systematically exploring academic research. It uses a dual-path ranking system with recency weighting to create graphs capturing both foundational works and recent breakthroughs related to a specific publication.
Figure 1
:
Example subsection of a graph created with Oignon.
Keywords—
citation analysis, bibliometrics, graph visualisation
1
Background
There are
many
existing tools for creating citation graph visualisations, but almost all of them suffer from at least one of the following drawbacks (in order of nuisance):
1.
Barrier to entry:
Despite the free availability of accessible data like OpenAlex
[
3
]
and Semantic Scholar
[
2
]
, many citation graphing tools impose artificial barriers: mandatory account creation, freemium feature gating, or institutional authentication.
2.
Force-directed graphs:
Most modern tools display graphs as force-directed graphs, where nodes representing papers are positioned via an iterative physics simulation. Nodes repel while connections attract, which naturally leads to a layout that prioritises topological structure over semantic meaning: a paper’s position conveys little beyond its immediate neighbourhood. Such layouts also suffer from an
O(n^{2})
visual complexity - edge crossings and node occlusions grow quadratically with graph size, leading to a ’hairball effect’ scalability issue that makes the graph difficult to read in a systematic way.
3.
Poor forward-looking coverage:
Many tools focus on backward traversal, producing archival snapshots frozen at the publication date. Forward coverage tends to systematically favour older works that have had longer to accumulate citations. Temporal normalisation in this area is an important factor that needs to be accounted for. In addition, backward traversal is inherently easier to deal with because it benefits from a convergent structure - references tend to funnel toward shared foundational works, amplifying the co-citation signal. Conversely, forward traversal has a divergent structure, where citing papers branch into a variety of research avenues with weak co-citation signals; this often leads to slow graph construction that most tools either ignore or solve by truncating the forward scope.
4.
Depth & completeness:
The rigour of academic writing is correlated with an understanding of the work within a broader intellectual lineage. Identification and acknowledgement of foundational works and pioneering papers is an essential facet of scholarly depth. Existing tools largely fail to surmount this knowledge that has traditionally been tacit expertise, usually because the citation network traversal is shallow, which fails to uncover the deeper roots that the references have in common.
2
Oignon
Oignon (
”onion” in French
) is a tool for creating citation graphs of academic research. The source code is available under the MIT license
[
1
]
. Nodes in a graph are rendered on a 2D grid, with the vertical axis used to represent the year of publication. Graphs can be created either from a source paper, or by author. When building from a source paper, Oignon uses OpenAlex to search for relevant related root (previous) and branch (future) publications using a ranking system (inspired by
[
4
]
).
•
Root Ranking:
The root seed papers are defined as the direct references of the source. The rank of root papers is a simple sum of the following metrics:
–
Cocited count:
How many times the root candidate is cited alongside a seed paper (relevance)
–
Cociting count:
How many references this paper shares with the seeds (similarity)
–
Cited count:
How many seed papers cite the root candidate (importance)
•
Branch Ranking:
The branch seed papers are defined as the publications which directly reference the source. The rank of branch papers is a simple sum of the following metrics:
–
Citing count:
How many seed papers are cited by the branch candidate (relevance)
–
Cociting count:
How many references this paper shares with the source (similarity)
–
Cocited count:
How often this paper is cited alongside the source paper, weighted by recency (relevance + importance)
The recency weighting is a logarithmic weighting:
w(t)=1+\ln\left(1+\frac{h}{t}\right)
, where
t
is years since publication (clamped to 1) and
h=4
is half-life.
Direction
Metric
Definition
Interpretation
Root
(backward)
Cited count
Seeds citing this paper
Importance
Cocited count
Co-appearances with seeds in bibliographies
Relevance
Cociting count
Shared references with seeds
Similarity
Total rank
Sum of above
Overall Score
Branch
(forward)
Citing count
Seeds cited by this paper
Relevance
Cociting count
Shared references with source
Similarity
Cocited count
Co-citations with source
(recency-weighted)
Relevance + Importance
Total rank
Sum of above
Overall Score
Table 1:
Ranking metrics for root and branch paper selection.
A summary of the ranking metrics is shown in Table
1
. The final nodes selected for the graph are the source, all direct references of the source, the branch seeds (capped), and the top-ranked roots and branches. A subsection of a graph created with Oignon is shown in Figure
1
. Publications are shown as circles, sorted by year of publication. The size of the circle represents the number of global citations. The source node is the solid dark grey node, pale yellow is a selected node for inspection, and green circles are referenced or citing works depending on
y