topobench.transforms.liftings package

Subpackages

• topobench.transforms.liftings.graph2cell package
  • Submodules
  • topobench.transforms.liftings.graph2cell.base module
    • Graph2CellLifting
  • topobench.transforms.liftings.graph2cell.cycle_lifting module
    • CellCycleLifting
      • CellCycleLifting.lift_topology()
  • topobench.transforms.liftings.graph2cell.discrete_configuration_complex_lifting module
    • DiscreteConfigurationComplexLifting
      • DiscreteConfigurationComplexLifting.forward()
      • DiscreteConfigurationComplexLifting.lift_topology()
    • edge_cycle_to_vertex_cycle()
    • generate_configuration_class()
  • Module contents
    • CellCycleLifting
      • CellCycleLifting.lift_topology()
    • DiscreteConfigurationComplexLifting
      • DiscreteConfigurationComplexLifting.forward()
      • DiscreteConfigurationComplexLifting.lift_topology()
    • Graph2CellLifting
• topobench.transforms.liftings.graph2combinatorial package
  • Submodules
  • topobench.transforms.liftings.graph2combinatorial.base module
    • Graph2CombinatorialLifting
  • topobench.transforms.liftings.graph2combinatorial.graph_induced_cc module
    • GraphTriangleInducedCC
      • GraphTriangleInducedCC.lift_topology()
    • build_paths()
    • find_overlapping_paths()
  • Module contents
    • Graph2CombinatorialLifting
    • GraphTriangleInducedCC
      • GraphTriangleInducedCC.lift_topology()
• topobench.transforms.liftings.graph2hypergraph package
  • Submodules
  • topobench.transforms.liftings.graph2hypergraph.base module
    • Graph2HypergraphLifting
  • topobench.transforms.liftings.graph2hypergraph.expander_graph_lifting module
    • ExpanderGraphLifting
      • ExpanderGraphLifting.lift_topology()
    • maybe_regular_expander()
  • topobench.transforms.liftings.graph2hypergraph.forman_ricci_curvature_lifting module
    • HypergraphFormanRicciCurvatureLifting
      • HypergraphFormanRicciCurvatureLifting.lift_topology()
  • topobench.transforms.liftings.graph2hypergraph.kernel_lifting module
    • HypergraphKernelLifting
      • HypergraphKernelLifting.lift_topology()
    • get_combination()
    • get_feat_kernel()
    • get_graph_kernel()
    • graph_heat_kernel()
    • graph_matern_kernel()
  • topobench.transforms.liftings.graph2hypergraph.khop_lifting module
    • HypergraphKHopLifting
      • HypergraphKHopLifting.lift_topology()
  • topobench.transforms.liftings.graph2hypergraph.knn_lifting module
    • HypergraphKNNLifting
      • HypergraphKNNLifting.lift_topology()
  • topobench.transforms.liftings.graph2hypergraph.mapper_lifting module
    • MapperCover
      • MapperCover.fit_transform()
    • MapperLifting
      • MapperLifting.lift_topology()
  • topobench.transforms.liftings.graph2hypergraph.modularity_maximization_lifting module
    • ModularityMaximizationLifting
      • ModularityMaximizationLifting.detect_communities()
      • ModularityMaximizationLifting.kmeans()
      • ModularityMaximizationLifting.lift_topology()
      • ModularityMaximizationLifting.modularity_matrix()
  • Module contents
    • ExpanderGraphLifting
      • ExpanderGraphLifting.lift_topology()
    • Graph2HypergraphLifting
    • HypergraphFormanRicciCurvatureLifting
      • HypergraphFormanRicciCurvatureLifting.lift_topology()
    • HypergraphKHopLifting
      • HypergraphKHopLifting.lift_topology()
    • HypergraphKNNLifting
      • HypergraphKNNLifting.lift_topology()
    • HypergraphKernelLifting
      • HypergraphKernelLifting.lift_topology()
    • MapperLifting
      • MapperLifting.lift_topology()
    • ModularityMaximizationLifting
      • ModularityMaximizationLifting.detect_communities()
      • ModularityMaximizationLifting.kmeans()
      • ModularityMaximizationLifting.lift_topology()
      • ModularityMaximizationLifting.modularity_matrix()
• topobench.transforms.liftings.graph2simplicial package
  • Submodules
  • topobench.transforms.liftings.graph2simplicial.base module
    • Graph2SimplicialLifting
  • topobench.transforms.liftings.graph2simplicial.clique_lifting module
    • SimplicialCliqueLifting
      • SimplicialCliqueLifting.lift_topology()
  • topobench.transforms.liftings.graph2simplicial.dnd_lifting module
    • SimplicialDnDLifting
      • SimplicialDnDLifting.lift_topology()
  • topobench.transforms.liftings.graph2simplicial.eccentricity_lifting module
    • SimplicialEccentricityLifting
      • SimplicialEccentricityLifting.lift_topology()
  • topobench.transforms.liftings.graph2simplicial.graph_induced_lifting module
    • SimplicialGraphInducedLifting
      • SimplicialGraphInducedLifting.lift_topology()
  • topobench.transforms.liftings.graph2simplicial.khop_lifting module
    • SimplicialKHopLifting
      • SimplicialKHopLifting.lift_topology()
  • topobench.transforms.liftings.graph2simplicial.latentclique_lifting module
    • LatentCliqueLifting
      • LatentCliqueLifting.lift_topology()
  • topobench.transforms.liftings.graph2simplicial.line_lifting module
    • SimplicialLineLifting
      • SimplicialLineLifting.lift_topology()
  • topobench.transforms.liftings.graph2simplicial.neighborhood_complex_lifting module
    • NeighborhoodComplexLifting
      • NeighborhoodComplexLifting.lift_topology()
  • topobench.transforms.liftings.graph2simplicial.vietoris_rips_lifting module
    • SimplicialVietorisRipsLifting
      • SimplicialVietorisRipsLifting.lift_topology()
    • nodes_search()
  • Module contents
    • Graph2SimplicialLifting
    • LatentCliqueLifting
      • LatentCliqueLifting.lift_topology()
    • NeighborhoodComplexLifting
      • NeighborhoodComplexLifting.lift_topology()
    • SimplicialCliqueLifting
      • SimplicialCliqueLifting.lift_topology()
    • SimplicialDnDLifting
      • SimplicialDnDLifting.lift_topology()
    • SimplicialEccentricityLifting
      • SimplicialEccentricityLifting.lift_topology()
    • SimplicialGraphInducedLifting
      • SimplicialGraphInducedLifting.lift_topology()
    • SimplicialKHopLifting
      • SimplicialKHopLifting.lift_topology()
    • SimplicialLineLifting
      • SimplicialLineLifting.lift_topology()
    • SimplicialVietorisRipsLifting
      • SimplicialVietorisRipsLifting.lift_topology()
• topobench.transforms.liftings.hypergraph2combinatorial package
  • Submodules
  • topobench.transforms.liftings.hypergraph2combinatorial.base module
    • Hypergraph2CombinatorialLifting
  • topobench.transforms.liftings.hypergraph2combinatorial.universal_strict_lifting module
    • UniversalStrictLifting
      • UniversalStrictLifting.lift_topology()
  • Module contents
    • Hypergraph2CombinatorialLifting
    • UniversalStrictLifting
      • UniversalStrictLifting.lift_topology()
• topobench.transforms.liftings.pointcloud2hypergraph package
  • Submodules
  • topobench.transforms.liftings.pointcloud2hypergraph.base module
    • PointCloud2HypergraphLifting
  • topobench.transforms.liftings.pointcloud2hypergraph.mogmst_lifting module
    • MoGMSTLifting
      • MoGMSTLifting.find_mog()
      • MoGMSTLifting.lift_topology()
  • topobench.transforms.liftings.pointcloud2hypergraph.pointnet_lifting module
    • PointNetLifting
      • PointNetLifting.lift_topology()
  • topobench.transforms.liftings.pointcloud2hypergraph.voronoi_lifting module
    • VoronoiLifting
      • VoronoiLifting.lift_topology()
  • Module contents
    • MoGMSTLifting
      • MoGMSTLifting.find_mog()
      • MoGMSTLifting.lift_topology()
    • PointCloud2HypergraphLifting
    • PointNetLifting
      • PointNetLifting.lift_topology()
    • VoronoiLifting
      • VoronoiLifting.lift_topology()
• topobench.transforms.liftings.pointcloud2simplicial package
  • Submodules
  • topobench.transforms.liftings.pointcloud2simplicial.alpha_complex_lifting module
    • AlphaComplexLifting
      • AlphaComplexLifting.lift_topology()
  • topobench.transforms.liftings.pointcloud2simplicial.base module
    • PointCloud2SimplicialLifting
  • topobench.transforms.liftings.pointcloud2simplicial.random_flag_complex module
    • RandomFlagComplexLifting
      • RandomFlagComplexLifting.lift_topology()
  • Module contents
    • AlphaComplexLifting
      • AlphaComplexLifting.lift_topology()
    • PointCloud2SimplicialLifting
    • RandomFlagComplexLifting
      • RandomFlagComplexLifting.lift_topology()
• topobench.transforms.liftings.simplicial2combinatorial package
  • Submodules
  • topobench.transforms.liftings.simplicial2combinatorial.base module
    • Simplicial2CombinatorialLifting
  • topobench.transforms.liftings.simplicial2combinatorial.coface_cc_lifting module
    • CofaceCCLifting
      • CofaceCCLifting.forward()
      • CofaceCCLifting.get_lower_cells()
      • CofaceCCLifting.lift_topology()
  • Module contents
    • CofaceCCLifting
      • CofaceCCLifting.forward()
      • CofaceCCLifting.get_lower_cells()
      • CofaceCCLifting.lift_topology()
    • Simplicial2CombinatorialLifting

Submodules

topobench.transforms.liftings.base module

Abstract class for topological liftings.

class topobench.transforms.liftings.base.AbstractLifting(feature_lifting=None, **kwargs)

Bases: BaseTransform

Abstract class for topological liftings.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.

forward(data: Data) → Data

Apply the full lifting (topology + features) to the input data.

Parameters:

datatorch_geometric.data.Data

The input data to be lifted.

Returns:

torch_geometric.data.Data

The lifted data.

abstract lift_topology(data: Data) → dict

Lift the topology of a graph to higher-order topological domains.

Parameters:

datatorch_geometric.data.Data

The input data to be lifted.

Returns:

dict

The lifted topology.

topobench.transforms.liftings.liftings module

This module implements the abstract classes for lifting graphs.

class topobench.transforms.liftings.liftings.CellComplexLifting(feature_lifting='ProjectionSum', **kwargs)

Bases: AbstractLifting

Abstract class for lifting cell complexes to other domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.

class topobench.transforms.liftings.liftings.CombinatorialLifting(feature_lifting='ProjectionSum', **kwargs)

Bases: AbstractLifting

Abstract class for lifting combinatorial complexes to other domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.

class topobench.transforms.liftings.liftings.GraphLifting(feature_lifting='ProjectionSum', preserve_edge_attr=False, **kwargs)

Bases: AbstractLifting

Abstract class for lifting graph topologies to other domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

preserve_edge_attrbool, optional

Whether to preserve edge attributes. Default is False.

**kwargsoptional

Additional arguments for the class.

class topobench.transforms.liftings.liftings.HypergraphLifting(feature_lifting='ProjectionSum', **kwargs)

Bases: AbstractLifting

Abstract class for lifting hypergraphs to other domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.

class topobench.transforms.liftings.liftings.PointCloudLifting(feature_lifting='ProjectionSum', **kwargs)

Bases: AbstractLifting

Abstract class for lifting point clouds to other topological domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.

class topobench.transforms.liftings.liftings.SimplicialLifting(feature_lifting='ProjectionSum', **kwargs)

Bases: AbstractLifting

Abstract class for lifting simplicial complexes to other domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.

Module contents

This module implements the liftings for the topological transforms.

class topobench.transforms.liftings.AbstractLifting(feature_lifting=None, **kwargs)

Bases: BaseTransform

Abstract class for topological liftings.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.

forward(data: Data) → Data

Apply the full lifting (topology + features) to the input data.

Parameters:

datatorch_geometric.data.Data

The input data to be lifted.

Returns:

torch_geometric.data.Data

The lifted data.

abstract lift_topology(data: Data) → dict

Lift the topology of a graph to higher-order topological domains.

Parameters:

datatorch_geometric.data.Data

The input data to be lifted.

Returns:

dict

The lifted topology.

class topobench.transforms.liftings.CellComplexLifting(feature_lifting='ProjectionSum', **kwargs)

Bases: AbstractLifting

Abstract class for lifting cell complexes to other domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.

class topobench.transforms.liftings.CombinatorialLifting(feature_lifting='ProjectionSum', **kwargs)

Bases: AbstractLifting

Abstract class for lifting combinatorial complexes to other domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.

class topobench.transforms.liftings.GraphLifting(feature_lifting='ProjectionSum', preserve_edge_attr=False, **kwargs)

Bases: AbstractLifting

Abstract class for lifting graph topologies to other domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

preserve_edge_attrbool, optional

Whether to preserve edge attributes. Default is False.

**kwargsoptional

Additional arguments for the class.

class topobench.transforms.liftings.HypergraphLifting(feature_lifting='ProjectionSum', **kwargs)

Bases: AbstractLifting

Abstract class for lifting hypergraphs to other domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.

class topobench.transforms.liftings.PointCloudLifting(feature_lifting='ProjectionSum', **kwargs)

Bases: AbstractLifting

Abstract class for lifting point clouds to other topological domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.

class topobench.transforms.liftings.SimplicialLifting(feature_lifting='ProjectionSum', **kwargs)

Bases: AbstractLifting

Abstract class for lifting simplicial complexes to other domains.

Parameters:

feature_liftingstr, optional

The feature lifting method to be used. Default is ‘ProjectionSum’.

**kwargsoptional

Additional arguments for the class.