Source-linked AI summary
Look Before You Lift: Visual and Quantitative Diagnostics for Topological Deep Learning
Mathilde Papillon, Guillermo Bernárdez, Álvaro Ballón Barreiro, Marco Montagna, Rémi Devaux, Antoine Jardin, Nina Miolane
TL;DR
Choosing a lifting can leave practitioners with limited insight into the higher-order connectivity it creates and whether that structure matters for the downstream task. TopoExplorer visualizes lifted neighborhoods and exposes graph metrics; experiments show that some pre-training metrics correlate with downstream model performance.
Problem
Different liftings can induce drastically different connectivity patterns, while practitioners often have limited structural inspection before training.
Source: §1 · p. 2Method
Results
Experiments using default TopoBench liftings show that some pre-training metrics correlate with downstream model performance.
Source: §1 · p. 2Takeaways & Limitations
Pre-training structural descriptors provide interpretable, domain- and model-dependent associations that can inform lifting and neighborhood choices.
Source: §5 · p. 9The metrics have no universal thresholds and are intended for comparative interpretation across configurations of a given dataset.
Source: §4.2 · p. 6
Abstract
from arXiv · showhide
Topological deep learning (TDL) methods rely on lifting raw data into higher-order discrete domains such as simplicial complexes, cell complexes, and hypergraphs. In practice, this lifting step is often treated as a black box: practitioners select a lifting and then tune architectures, with limited visibility into whether the induced higher-order connectivity is meaningful for the downstream task. To address this missing diagnostic layer, we propose a visualization technique called TopoExplorer that leverages the strictly augmented Hasse graph form of topological datasets for exploratory data analysis. For the first time, practitioners can easily visualize the incidence- and adjacency-based neighborhoods that define the lifted dataset, as well as read off key graph metrics that describe its structural and feature landscape. Via an extensive set of experiments across many datasets and liftings, we show that several of these metrics correlate with downstream model performance, suggesting they can help inform TDL preprocessing design. Our perspective reframes the TDL workflow from lift-train to lift-look-design-train, enabling more principled, interpretable, and efficient model development. TopoExplorer is hosted at https://topoexplorer.pagekite.me, and its source code is available at github.com/geometric-intelligence/topoexplorer.
1. Introduction
TopoExplorer uses strictly augmented Hasse graph decompositions to make lifted TDL datasets inspectable through visual and quantitative diagnostics. Experiments with default TopoBench liftings show that some pre-training metrics correlate with downstream model performance.
1. Introduction
- Here, TDL refers to methods that learn on discrete higher-order domains; methods using tools such as persistent homology are outside the paper’s scope.Source: §1 · p. 1
- Different liftings can induce drastically different connectivity on the same dataset, motivating inspection of lifted structure before training.Strictly augmented Hasse graph decompositions expose incidence- and adjacency-based neighborhoods across cell ranks.Source: §1 · p. 2
- TopoExplorer is a visual and quantitative diagnostic framework that extracts structural and feature-based graph metrics from lifted complexes.It reframes the workflow from lift-train to lift-look-design-train.Source: §1 · p. 2
- Experiments using TopoBench’s default liftings show that some pre-training metrics computed in TopoExplorer correlate with downstream model performance.The paper presents this as evidence for a structure-aware design pipeline.Source: §1 · p. 2
2. Background
The background formalizes discrete topological domains through combinatorial complexes, defines neighborhood-induced strictly augmented Hasse graphs, and frames lifting as structural translation between domains.
- A combinatorial complex is (V, C, rk), with C a subset of nonempty subsets of V; every singleton has rank 0, and rk is order-preserving under inclusion.Source: §2 · p. 2
- For a neighborhood function N, the strictly augmented Hasse graph contains cells with at least one N-neighbor and directed edges from each neighbor to its cell.Its node set is restricted to cells that have at least one neighbor according to N.Source: §2 · p. 3
- A lifting is a uniform structural map between discrete topological domains that identifies motifs and maps them to target cells, including clique lifting and skeletal projections.Clique lifting maps (k + 1)-cliques to k-cells; lifting can also translate between domains of the same dimension or map higher- to lower-order representations.Source: §2 · p. 3
- A neighborhood function maps each cell to neighboring cells; traditional forms are same-rank adjacency via another rank and directed cross-rank incidence.Figure 1 visualizes examples of adjacency and incidence neighborhoods.Source: §2 · p. 3, Figure 1 · p. 3
3. Related Work
Prior work has expanded topological deep learning architectures and lifting options, but has offered limited diagnostics for evaluating lifted structure. TopoExplorer extends graph-based structural analysis to arbitrary higher-order domains through strictly augmented Hasse graphs.
Higher-Order Representation Learning
- TDL progressed from simplicial and cell-complex networks to combinatorial-complex and modular Hasse-graph architectures, but typically assumes the input complex is fixed (Ebli et al., 2020; Bodnar et al., 2021; Papillon et al., 2025; Bernárdez et al., 2026).TopoTune separates incidence and adjacency neighborhoods for GNN backbones; HOPSE uses the decomposition for linear-cost higher-order positional encodings.Source: §3 · p. 4
The TDL Lifting Ecosystem
- TopoBench standardizes a catalog of more than 30 liftings, but lacks structural diagnostics; existing visualization tools inspect pairwise graphs, not cross-rank neighborhoods (Bernárdez et al., 2024; Telyatnikov et al., 2025).Only one systematic lifting study is reported, and it is specific to hypergraph neural networks.Source: §3 · p. 4
Graph Metrics and Model Performance
- TopoExplorer uses strictly augmented Hasse graphs to compute classical graph metrics and edge-specific Forman–Ricci curvature across higher-order domains.Prior graph-learning research shows that structural metrics can provide actionable signals, including curvature-based approaches addressing over-squashing (Topping et al., 2022; Fesser and Weber, 2024b, 2024a).Source: §3 · pp. 4–5
Topological Metrics and Model Performance
- Hypergraph and simplicial-complex homophily metrics have linked higher-order structure to model performance, but remain domain-specific; TopoExplorer supports broader graph diagnostics across the topological hierarchy (Telyatnikov et al., 2023).It represents arbitrary higher-order domains as strictly augmented Hasse graphs.Source: §3 · p. 5
4. TopoExplorer: Interact and Diagnose Any Lifted Topological Dataset
TopoExplorer turns lifted topological datasets into interactive, quantitative diagnostics of their Hasse-graph neighborhoods before model training. Its case study finds that simple structural descriptors associate with downstream performance, particularly for higher-order neighborhoods.
4. TopoExplorer: Interact and Diagnose Any Lifted Topological Dataset
- TopoExplorer decomposes a lifted complex into strictly augmented Hasse graphs, exposing how information flows through neighborhoods so practitioners can inspect lifting and hyperparameter choices before training.The framework is built on the TopoBench ecosystem and aims to reveal structural implications before computational resources are spent on model training.Source: §4 · p. 5
4.1. Interface Design
- The interface represents incidence relations as directed edges between ranks and adjacency relations as within-rank edges, revealing cross-rank support, orphan cells, potential message-passing sinks, and peer connectivity.Figure 2 illustrates neighborhood-specific relations in a cellular complex using color-coded Hasse-graph edges.Source: §4.1 · p. 5, Figure 2 · p. 6
4.2. Quantitative Signatures
- Connectivity metrics include sparsity and density, degree statistics, and component counts, which can inform channel pruning, flag bottlenecks, and indicate whether structural encodings capture global or localized context.The metrics have no universal thresholds; users should compare candidate liftings, neighborhoods, and hyperparameter configurations, with computed values recordable in an HTML export.Source: §4.2 · p. 6
4.3. Practitioner Workflow
- Practitioners select a dataset and lifting, choose and inspect or combine neighborhood Hasse graphs, then adjust display filters and render or export the visualization.For inductive datasets, users can navigate samples and the lifting is reapplied automatically; the open-source repository can be adapted for custom datasets, liftings, and metrics.Source: §4.3 · p. 7
4.4. TopoExplorer in Action: Structural Diagnostics for Neighborhood Selection
- Higher-order adjacency and incidence neighborhoods show the strongest performance associations; on simplicial datasets, larger spectral radius and clustering generally track stronger gains, while cellular trends are weaker and less consistent.These correlations are suggestive, not evidence that the descriptors reliably improve design choices; further controlled experiments are needed.Source: §4.4 · p. 8, Figure 3 · p. 8
- Selecting a neighborhood renders its Hasse graph alongside spectral radius, clustering coefficient, and other metrics, providing interpretable diagnostics to guide neighborhood selection before training.The case study computes metrics per sample and averages them at dataset level; clustering coefficients are defined only for adjacency neighborhoods because incidence Hasse graphs are bipartite.Source: §4.4 · pp. 8–9
5. Conclusion and Future Work
TopoExplorer makes structural properties of strictly augmented Hasse graphs visible and measurable before training, linking lifting diagnostics to neighborhood-operator selection. Its case study finds domain- and model-dependent associations between pre-training descriptors and downstream performance; future work will broaden the metrics and evaluate their predictive value across more liftings and architectures.
Conclusion
- TopoExplorer makes structural properties of strictly augmented Hasse graphs visible and measurable before training, exposing neighborhood metrics such as spectral radius and clustering coefficient.The framework connects the lifting step to neighborhood-operator selection, which conditions the performance of general TDL architectures.Source: §5 · p. 9
- The case study shows pre-training structural descriptors have domain- and model-dependent associations with downstream performance, providing interpretable signals for the lift-look-design-train workflow.Source: §5 · p. 9
Future Work
- Future work will broaden surfaced descriptors to include geometric and feature-based metrics across neighborhood types and examine their predictive value across more liftings and architectures.Source: §5 · p. 9
Appendix A. Definition of a Neighborhood
The appendix defines incidence neighborhoods of cells in a combinatorial complex and shows how incidences induce adjacency neighborhoods among cells of the same rank.
Appendix A. Definition of a Neighborhood
- For a t-cell σ, its incidence neighborhood at rank s consists of s-cells containing σ when t < s and s-cells contained in σ when t > s.The definition is given for a combinatorial complex T.Source: Appendix A · p. 14
- An s-cell τ is co-incident of σ if it contains σ and s > t, and incident of σ if it is contained by σ and s < t.Source: Appendix A · p. 14
- The adjacency neighborhood A_{s,t}(σ) contains rank-t cells whose incidence neighborhoods with respect to s intersect; two t-cells are adjacent if both lie in an s-cell.Source: Appendix A · p. 14
Appendix B. TopoExplorer metrics
TopoExplorer computes structural metrics on the configured graph or its associated neighborhood matrices, depending on the metric level. Its calculations account for displayed sampling, use an undirected view, and may approximate some advanced metrics on large graphs.
Appendix B. TopoExplorer metrics
- Complex- and node-level statistics use the displayed graph after loading, optional lifting, and user-controlled sampling, evaluated as an undirected view.This makes definitions consistent across plain adjacency, incidence/bipartite, and layered neighborhood displays.Source: Appendix B · p. 14
- Neighborhood-level statistics use the full neighborhood matrix for the selected view, before sampling is applied.Examples include rank-k adjacency and cross-rank incidence.Source: Appendix B · p. 14
- Advanced metrics are optional and may be approximated on large graphs, such as betweenness via k-node sampling above ∼800 nodes.Source: Appendix B · p. 14
- Forman-Ricci curvature and edge betweenness appear in edge tooltips and summary tables for extreme edges.Source: Appendix B · p. 14
Appendix C. Full-Page Screenshots of TopoExplorer
The appendix presents full-page TopoExplorer interface screenshots and specifies how the Metrics tab computes its quantities.
Appendix C. Full-Page Screenshots of TopoExplorer
- The Metrics tab reports complex- and node-level quantities on the displayed graph after sampling and lifting, treated as undirected.Neighborhood-level quantities are computed on the full neighborhood matrix for each selected view before sampling.Source: Table 1 · p. 15
- Figure 5 shows neighborhood selection and representation in TopoExplorer on the ZINC dataset.It is reproduced at full-page scale for legibility.Source: Appendix C · pp. 14, 16, Figure 5 · p. 16
- Figure 6 shows a MANTRA (Ballester et al., 2025) simplicial dataset sample in TopoExplorer, with the metrics panel enlarged.The screenshot is reproduced at full-page scale.Source: Appendix C · p. 14, Figure 6 · p. 17