< Summary

Class:Itinero.Network.Search.Islands.IslandLabels
Assembly:Itinero
File(s):/home/runner/work/routing2/routing2/src/Itinero/Network/Search/Islands/IslandLabels.cs
Covered lines:137
Uncovered lines:41
Coverable lines:178
Total lines:327
Line coverage:76.9% (137 of 178)
Covered branches:63
Total branches:98
Branch coverage:64.2% (63 of 98)
Tag:236_17851749384

Metrics

MethodBranch coverage Cyclomatic complexity Line coverage
.ctor(...)100%1100%
get_Islands()100%2100%
AddNew(...)50%2100%
AddTo(...)50%873.33%
ConnectTo(...)100%6100%
Merge(...)0%60%
TryGet(...)100%10%
TryGetWithDetails(...)75%487.5%
SetAsFinal(...)50%280%
FindLoops(...)95%20100%
Merge(...)58.69%4670.68%
GetEnumerator()0%20%
System.Collections.IEnumerable.GetEnumerator()100%10%

File(s)

/home/runner/work/routing2/routing2/src/Itinero/Network/Search/Islands/IslandLabels.cs

#LineLine coverage
 1using System;
 2using System.Collections;
 3using System.Collections.Generic;
 4using System.Linq;
 5using Itinero.Routing.DataStructures;
 6
 7namespace Itinero.Network.Search.Islands;
 8
 9internal class IslandLabels : IEnumerable<(EdgeId edge, uint label)>
 10{
 11    /// <summary>
 12    /// The not an island label.
 13    /// </summary>
 14    public const uint NotAnIslandLabel = 0;
 15
 16    /// <summary>
 17    /// Keeps a label for each edge.
 18    /// - Starting each edge starts with it's own unique Id.
 19    /// - When edges are bidirectionally connected they get take on the lowest Id of their neighbour.
 20    /// </summary>
 1321    private readonly Dictionary<EdgeId, uint> _labels = new();
 1322    private readonly Dictionary<uint, (uint size, bool final)> _islands = new(); // holds the size per island.
 1323    private readonly IslandLabelGraph _labelGraph = new();
 24    private readonly int _maxIslandSize;
 25
 1326    internal IslandLabels(int maxIslandSize)
 1327    {
 1328        _maxIslandSize = maxIslandSize;
 1329        _islands.Add(0, (uint.MaxValue, true));
 1330        _labelGraph.AddVertex();
 1331    }
 32
 33    /// <summary>
 34    /// Gets all the islands.
 35    /// </summary>
 36    public IEnumerable<(uint label, uint size, bool final)> Islands
 37    {
 38        get
 339        {
 1540            foreach (var (label, (size, final)) in _islands)
 341            {
 342                yield return (label, size, final);
 343            }
 344        }
 45    }
 46
 47    /// <summary>
 48    /// Creates a new label.
 49    /// </summary>
 50    /// <returns></returns>
 51    public (uint label, uint size, bool final) AddNew(EdgeId edge, bool final = false)
 2952    {
 2953        if (_labels.ContainsKey(edge)) throw new ArgumentOutOfRangeException(nameof(edge));
 54
 2955        var label = _labelGraph.AddVertex();
 56
 2957        _labels[edge] = label;
 2958        _islands[label] = (1, final);
 59
 2960        return (label, 1, final);
 2961    }
 62
 63    /// <summary>
 64    /// Adds an edge to an already existing island.
 65    /// </summary>
 66    /// <param name="label"></param>
 67    /// <param name="edge"></param>
 68    /// <returns></returns>
 69    public (uint label, uint size, bool final) AddTo(uint label, EdgeId edge)
 370    {
 371        if (!_islands.TryGetValue(label, out var islandDetails)) throw new ArgumentOutOfRangeException(nameof(label));
 72
 373        if (islandDetails.size < uint.MaxValue) islandDetails.size += 1;
 374        _islands[label] = (islandDetails.size, final: islandDetails.final);
 375        _labels[edge] = label;
 76
 377        if (_islands[label].size >= _maxIslandSize &&
 378            label != NotAnIslandLabel)
 079        {
 80            // this island just grew over the maximum.
 081            this.Merge([label, NotAnIslandLabel]);
 082            var labelDetails = _islands[NotAnIslandLabel];
 083            return (NotAnIslandLabel, labelDetails.size, final: islandDetails.final);
 84        }
 85        else
 386        {
 387            var labelDetails = _islands[label];
 388            return (label, labelDetails.size, final: islandDetails.final);
 89        }
 390    }
 91
 92    /// <summary>
 93    /// Connects the islands representing the two labels, tail -> head.
 94    /// </summary>
 95    /// <param name="tail">The tail label.</param>
 96    /// <param name="head">The head label.</param>
 97    internal bool ConnectTo(uint tail, uint head)
 3898    {
 4499        if (tail == head) return false;
 100
 35101        if (_labelGraph.HasEdge(tail, head)) return false;
 102
 29103        var headHasEdge = _labelGraph.HasEdge(head);
 29104        _labelGraph.AddEdge(tail, head);
 105
 40106        if (headHasEdge) return this.FindLoops(head);
 18107        return false;
 38108    }
 109
 110    /// <summary>
 111    /// Merges the two given islands.
 112    /// </summary>
 113    /// <param name="tail"></param>
 114    /// <param name="head"></param>
 115    internal void Merge(uint tail, uint head)
 0116    {
 0117        if (tail == head) return;
 118
 0119        if (!_labelGraph.HasVertex(tail)) throw new ArgumentException("Label does not exist", nameof(tail));
 0120        if (!_labelGraph.HasVertex(head)) throw new ArgumentException("Label does not exist", nameof(head));
 121
 0122        this.Merge([tail, head]);
 123
 124        // var edgesAdded = false;
 125        // if (!_labelGraph.HasEdge(tail, head))
 126        // {
 127        //     edgesAdded = true;
 128        //     _labelGraph.AddEdge(tail, head);
 129        // }
 130        // if (!_labelGraph.HasEdge(head, tail))
 131        // {
 132        //     edgesAdded = true;
 133        //     _labelGraph.AddEdge(head, tail);
 134        // }
 135        // if (!edgesAdded) return;
 136        //
 137        // this.FindLoops(head);
 0138    }
 139
 140    /// <summary>
 141    /// Gets the label for the given edge, if any.
 142    /// </summary>
 143    /// <param name="edge"></param>
 144    /// <param name="label"></param>
 145    /// <returns></returns>
 146    public bool TryGet(EdgeId edge, out uint label)
 0147    {
 0148        return _labels.TryGetValue(edge, out label);
 0149    }
 150
 151    /// <summary>
 152    /// Gets the island label for the given edge and its size, if any.
 153    /// </summary>
 154    /// <param name="edge"></param>
 155    /// <param name="island"></param>
 156    /// <returns></returns>
 157    public bool TryGetWithDetails(EdgeId edge, out (uint label, uint size, bool final) island)
 109158    {
 109159        island = (0, 0, false);
 141160        if (!_labels.TryGetValue(edge, out var label)) return false;
 161
 77162        if (!_islands.TryGetValue(label, out var islandState))
 0163            throw new Exception("Island does not exist");
 164
 77165        island = (label, islandState.size, final: islandState.final);
 77166        return true;
 109167    }
 168
 169    /// <summary>
 170    /// Sets the given island as final, it cannot grow any further.
 171    /// </summary>
 172    /// <param name="label">The label of the island.</param>
 173    public void SetAsFinal(uint label)
 11174    {
 11175        if (!_islands.TryGetValue(label, out var islandState))
 0176            throw new Exception("Island does not exist");
 177
 11178        _islands[label] = (islandState.size, true);
 11179    }
 180
 181    private bool FindLoops(uint label)
 11182    {
 11183        var pathTree = new PathTree();
 11184        var settled = new HashSet<uint>();
 11185        var queue = new Queue<uint>();
 11186        var loop = new HashSet<uint>(); // keeps all with a path back to label, initially only label.
 187
 11188        var loopFound = false;
 11189        var enumerator = _labelGraph.GetEdgeEnumerator();
 21190        while (true)
 21191        {
 21192            if (!enumerator.MoveTo(label)) throw new Exception("Cannot search for loops on label that does not exist");
 193
 21194            loop.Add(label);
 21195            queue.Enqueue(pathTree.Add(label, uint.MaxValue));
 196
 54197            while (queue.Count > 0)
 33198            {
 33199                var pointer = queue.Dequeue();
 33200                pathTree.Get(pointer, out var current, out var previous);
 201
 33202                if (!settled.Add(current)) continue;
 33203                if (!enumerator.MoveTo(current)) continue;
 204
 79205                while (enumerator.MoveNext())
 46206                {
 46207                    var n = enumerator.Head;
 70208                    if (!enumerator.Forward) continue;
 209
 22210                    if (loop.Contains(n))
 10211                    {
 212                        // yay, a loop!
 10213                        loop.Add(current);
 22214                        while (previous != uint.MaxValue)
 12215                        {
 12216                            pathTree.Get(previous, out current, out previous);
 12217                            loop.Add(current);
 12218                        }
 10219                    }
 220
 32221                    if (settled.Contains(n)) continue;
 12222                    queue.Enqueue(pathTree.Add(n, pointer));
 12223                }
 33224            }
 225
 32226            if (loop.Count <= 1) return loopFound;
 227
 10228            label = this.Merge(loop);
 10229            loopFound = true;
 230
 10231            loop.Clear();
 10232            pathTree.Clear();
 10233            settled.Clear();
 10234            queue.Clear();
 10235        }
 11236    }
 237
 238    private uint Merge(HashSet<uint> labels)
 10239    {
 15240        while (true)
 15241        {
 242            // build a list of neighbours of the labels to be removed.
 15243            var edgeEnumerator = _labelGraph.GetEdgeEnumerator();
 15244            var bestLabel = uint.MaxValue;
 15245            var neighbours = new Dictionary<uint, (bool forward, bool backward)>();
 109246            foreach (var label in labels)
 32247            {
 57248                if (label < bestLabel) bestLabel = label;
 32249                if (!edgeEnumerator.MoveTo(label)) continue;
 250
 76251                while (edgeEnumerator.MoveNext())
 44252                {
 44253                    var n = edgeEnumerator.Head;
 88254                    if (labels.Contains(n)) continue;
 255
 0256                    (bool forward, bool backward) data = edgeEnumerator.Forward ? (true, false) : (false, true);
 257
 0258                    if (neighbours.TryGetValue(n, out var existingData))
 0259                    {
 0260                        data = (existingData.forward || data.forward, existingData.backward || data.backward);
 0261                    }
 262
 0263                    neighbours[n] = data;
 0264                }
 32265            }
 15266            if (bestLabel == uint.MaxValue) throw new Exception("Cannot merge empty loop");
 267
 268            // add all edges to the neighbours again.
 45269            foreach (var (neighbour, data) in neighbours)
 0270            {
 0271                if (data.forward)
 0272                {
 0273                    if (!_labelGraph.HasEdge(bestLabel, neighbour)) _labelGraph.AddEdge(bestLabel, neighbour);
 0274                }
 275
 0276                if (data.backward)
 0277                {
 0278                    if (!_labelGraph.HasEdge(neighbour, bestLabel)) _labelGraph.AddEdge(neighbour, bestLabel);
 0279                }
 0280            }
 281
 15282            var bestData = _islands[bestLabel];
 109283            foreach (var label in labels)
 32284            {
 47285                if (label == bestLabel) continue;
 17286                _labelGraph.RemoveVertex(label);
 287
 17288                var data = _islands[label];
 28289                if (bestData.size < uint.MaxValue) bestData.size += data.size;
 17290                _islands.Remove(label);
 17291            }
 292
 15293            _islands[bestLabel] = bestData;
 294
 133295            foreach (var k in _labels.Keys.ToArray())
 44296            {
 44297                var val = _labels[k];
 58298                if (val == bestLabel) continue;
 33299                if (!labels.Contains(val)) continue;
 300
 27301                _labels[k] = bestLabel;
 27302            }
 303
 21304            if (bestLabel == NotAnIslandLabel) return bestLabel;
 9305            if (_islands[bestLabel].size < _maxIslandSize)
 4306            {
 4307                return bestLabel;
 308            }
 309
 5310            labels = [bestLabel, NotAnIslandLabel];
 5311            continue;
 312        }
 10313    }
 314
 315    public IEnumerator<(EdgeId edge, uint label)> GetEnumerator()
 0316    {
 0317        foreach (var (key, value) in _labels)
 0318        {
 0319            yield return (key, value);
 0320        }
 0321    }
 322
 323    IEnumerator IEnumerable.GetEnumerator()
 0324    {
 0325        return this.GetEnumerator();
 0326    }
 327}
Generated by: ReportGenerator 4.8.2.0
09/19/2025 - 07:34:11
GitHub | www.palmmedia.de

Methods/Properties

.ctor(...)
get_Islands()
AddNew(...)
AddTo(...)
ConnectTo(...)
Merge(...)
TryGet(...)
TryGetWithDetails(...)
SetAsFinal(...)
FindLoops(...)
Merge(...)
GetEnumerator()
System.Collections.IEnumerable.GetEnumerator()