org.jgrapht.webgraph.AbstractImmutableBigGraphAdapter Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jgrapht-unimi-dsi Show documentation
There is a newer version: 1.5.2
/*
 * (C) Copyright 2020-2020, by Sebastiano Vigna and Contributors.
 *
 * JGraphT : a free Java graph-theory library
 *
 * See the CONTRIBUTORS.md file distributed with this work for additional
 * information regarding copyright ownership.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License 2.0 which is available at
 * http://www.eclipse.org/legal/epl-2.0, or the
 * GNU Lesser General Public License v2.1 or later
 * which is available at
 * http://www.gnu.org/licenses/old-licenses/lgpl-2.1-standalone.html.
 *
 * SPDX-License-Identifier: EPL-2.0 OR LGPL-2.1-or-later
 */

package org.jgrapht.webgraph;

import java.util.Collections;
import java.util.Set;
import java.util.function.Supplier;

import org.jgrapht.graph.AbstractGraph;

import it.unimi.dsi.big.webgraph.ImmutableGraph;
import it.unimi.dsi.big.webgraph.LazyLongIterator;
import it.unimi.dsi.big.webgraph.LazyLongSkippableIterator;
import it.unimi.dsi.fastutil.longs.LongLongPair;
import it.unimi.dsi.fastutil.longs.LongSets;

/**
 * An abstract base class for adapters using WebGraph
 * (big)'s {@link ImmutableGraph}. Nodes are instances of {@link Long} corresponding to the
 * index of a node in WebGraph.
 *
 * @param  the type of an edge.
 * @author Sebastiano Vigna
 */

public abstract class AbstractImmutableBigGraphAdapter
    extends
    AbstractGraph
{

    /** The underlying graph. */
    protected final ImmutableGraph immutableGraph;
    /** The number of nodes of {@link #immutableGraph}. */
    protected final long n;
    /**
     * The number of edges, cached, or -1 if it still unknown. This will have to be computed by
     * enumeration for undirected graphs, as we do not know how many loops are present, and for
     * graphs which do not support {@link ImmutableGraph#numArcs()}.
     */
    protected long m = -1;

    protected AbstractImmutableBigGraphAdapter(final ImmutableGraph immutableGraph)
    {
        this.immutableGraph = immutableGraph;
        this.n = immutableGraph.numNodes();
    }

    @Override
    public Set getAllEdges(final Long sourceVertex, final Long targetVertex)
    {
        if (sourceVertex == null || targetVertex == null)
            return null;
        final long x = sourceVertex;
        final long y = targetVertex;
        if (x < 0 || x >= n || y < 0 || y >= n)
            return null;
        return containsEdgeFast(x, y) ? Collections.singleton(makeEdge(x, y))
            : Collections.emptySet();
    }

    protected abstract E makeEdge(long x, long y);

    @Override
    public E getEdge(final Long sourceVertex, final Long targetVertex)
    {
        if (sourceVertex == null || targetVertex == null)
            return null;
        final long x = sourceVertex;
        final long y = targetVertex;
        return containsEdgeFast(x, y) ? makeEdge(x, y) : null;
    }

    @Override
    public Supplier getVertexSupplier()
    {
        return null;
    }

    @Override
    public Supplier getEdgeSupplier()
    {
        return null;
    }

    @Override
    public E addEdge(final Long sourceVertex, final Long targetVertex)
    {
        throw new UnsupportedOperationException();
    }

    @Override
    public boolean addEdge(final Long sourceVertex, final Long targetVertex, final E e)
    {
        throw new UnsupportedOperationException();
    }

    @Override
    public Long addVertex()
    {
        throw new UnsupportedOperationException();
    }

    @Override
    public boolean addVertex(final Long v)
    {
        throw new UnsupportedOperationException();
    }

    @Override
    public boolean containsEdge(final Long sourceVertex, final Long targetVertex)
    {
        if (sourceVertex == null || targetVertex == null)
            return false;
        return containsEdgeFast(sourceVertex, targetVertex);
    }

    protected boolean containsEdgeFast(final long x, final long y)
    {
        if (x < 0 || x >= n || y < 0 || y >= n)
            return false;
        final LazyLongIterator successors = immutableGraph.successors(x);
        if (successors instanceof LazyLongSkippableIterator) {
            // Fast skipping available
            return y == ((LazyLongSkippableIterator) successors).skipTo(y);
        } else
            for (long target; (target = successors.nextLong()) != -1;)
                if (target == y)
                    return true;
        return false;
    }

    @Override
    public boolean containsVertex(final Long v)
    {
        if (v == null)
            return false;
        final long x = v;
        return x >= 0 && x < n;
    }

    @Override
    public E removeEdge(final Long sourceVertex, final Long targetVertex)
    {
        throw new UnsupportedOperationException();
    }

    @Override
    public boolean removeEdge(final E e)
    {
        throw new UnsupportedOperationException();
    }

    @Override
    public boolean removeVertex(final Long v)
    {
        throw new UnsupportedOperationException();
    }

    @Override
    public Set vertexSet()
    {
        return LongSets.fromTo(0, n);
    }

    @Override
    public Long getEdgeSource(final E e)
    {
        return e.leftLong();
    }

    @Override
    public Long getEdgeTarget(final E e)
    {
        return e.rightLong();
    }

    @Override
    public double getEdgeWeight(final E e)
    {
        return DEFAULT_EDGE_WEIGHT;
    }

    @Override
    public void setEdgeWeight(final E e, final double weight)
    {
        if (weight != 1)
            throw new UnsupportedOperationException();
    }
}