org.jgrapht.alg.color.LargestDegreeFirstColoring Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of jgrapht-core Show documentation
The newest version!
/*
 * (C) Copyright 2017-2017 Dimitrios Michail 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.alg.color;

import org.jgrapht.*;
import org.jgrapht.util.*;

import java.lang.reflect.*;
import java.util.*;

/**
 * The largest degree first greedy coloring algorithm.
 * 
 * 
 * This is the greedy coloring algorithm which orders the vertices by non-increasing degree. See the
 * following paper for details.
 * 

 * D. J. A. Welsh and M. B. Powell. An upper bound for the chromatic number of a graph and its
 * application to timetabling problems. The Computer Journal, 10(1):85--86, 1967.
 * 
 *
 * @param  the graph vertex type
 * @param  the graph edge type
 * 
 * @author Dimitrios Michail
 */
public class LargestDegreeFirstColoring
    extends GreedyColoring
{
    /**
     * Construct a new coloring algorithm.
     * 
     * @param graph the input graph
     */
    public LargestDegreeFirstColoring(Graph graph)
    {
        super(graph);
    }

    /**
     * {@inheritDoc}
     */
    @Override
    @SuppressWarnings("unchecked")
    protected Iterable getVertexOrdering()
    {
        // compute degrees and maximum degree
        int n = graph.vertexSet().size();
        int maxDegree = 0;
        Map degree = CollectionUtil.newHashMapWithExpectedSize(n);
        for (V v : graph.vertexSet()) {
            int d = graph.edgesOf(v).size();
            degree.put(v, d);
            if (d > maxDegree) {
                maxDegree = d;
            }
        }

        if (maxDegree > 3 * n) {
            /*
             * Order vertices by degree by using a comparison based sort.
             */
            List nodes = new ArrayList<>(graph.vertexSet());
            nodes.sort((u, v) -> -1 * Integer.compare(degree.get(u), degree.get(v)));
            return nodes;
        } else {
            /*
             * Use bucket sort
             */
            List nodes = new ArrayList<>(n);

            // create buckets
            final Set[] buckets = (Set[]) Array.newInstance(Set.class, maxDegree + 1);
            for (int i = 0; i <= maxDegree; i++) {
                buckets[i] = new HashSet<>();
            }

            // fill buckets
            for (V v : graph.vertexSet()) {
                buckets[degree.get(v)].add(v);
            }

            // collect result
            for (int i = maxDegree; i >= 0; i--) {
                nodes.addAll(buckets[i]);
            }

            return nodes;
        }

    }

}