source: branches/2839_HiveProjectManagement/HeuristicLab.Core/3.3/Collections/DirectedGraph/DirectedGraph.cs @ 16057

Last change on this file since 16057 was 16057, checked in by jkarder, 16 months ago

#2839:

File size: 6.9 KB
Line 
1#region License Information
2/* HeuristicLab
3 * Copyright (C) 2002-2018 Heuristic and Evolutionary Algorithms Laboratory (HEAL)
4 *
5 * This file is part of HeuristicLab.
6 *
7 * HeuristicLab is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation, either version 3 of the License, or
10 * (at your option) any later version.
11 *
12 * HeuristicLab is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with HeuristicLab. If not, see <http://www.gnu.org/licenses/>.
19 */
20#endregion
21
22using System;
23using System.Collections.Generic;
24using System.Drawing;
25using System.Linq;
26using HeuristicLab.Common;
27using HeuristicLab.Common.Resources;
28using HeuristicLab.Persistence.Default.CompositeSerializers.Storable;
29
30namespace HeuristicLab.Core {
31  [Item("DirectedGraph", "Generic class representing a directed graph with custom vertices and content")]
32  [StorableClass]
33  public class DirectedGraph : Item, IDirectedGraph {
34    public override Image ItemImage { get { return VSImageLibrary.Graph; } }
35
36    private HashSet<IVertex> vertices;
37    [Storable]
38    public IEnumerable<IVertex> Vertices {
39      get { return vertices; }
40      private set { vertices = new HashSet<IVertex>(value); }
41    }
42
43    private HashSet<IArc> arcs;
44    [Storable]
45    public IEnumerable<IArc> Arcs {
46      get { return arcs; }
47      private set { arcs = new HashSet<IArc>(value); }
48    }
49
50    public DirectedGraph() {
51      vertices = new HashSet<IVertex>();
52      arcs = new HashSet<IArc>();
53    }
54
55    protected DirectedGraph(DirectedGraph original, Cloner cloner)
56      : base(original, cloner) {
57      vertices = new HashSet<IVertex>(original.vertices.Select(cloner.Clone));
58      arcs = new HashSet<IArc>(original.arcs.Select(cloner.Clone));
59
60      // add the arcs to the newly cloned vertices
61      foreach (var arc in arcs) {
62        arc.Source.AddArc(arc);
63        arc.Target.AddArc(arc);
64      }
65    }
66
67    public override IDeepCloneable Clone(Cloner cloner) {
68      return new DirectedGraph(this, cloner);
69    }
70
71    [StorableConstructor]
72    protected DirectedGraph(bool serializing)
73      : base(serializing) {
74    }
75
76    [StorableHook(HookType.AfterDeserialization)]
77    private void AfterDeserialization() {
78      foreach (var vertex in vertices) {
79        vertex.ArcAdded += Vertex_ArcAdded;
80        vertex.ArcRemoved += Vertex_ArcRemoved;
81      }
82
83      foreach (var arc in arcs) {
84        var source = arc.Source;
85        var target = arc.Target;
86        source.AddArc(arc);
87        target.AddArc(arc);
88      }
89    }
90
91    public virtual void Clear() {
92      vertices.Clear();
93      arcs.Clear();
94    }
95
96    public virtual void AddVertex(IVertex vertex) {
97      if (!vertices.Contains(vertex) && vertex.Degree > 0)
98        throw new ArgumentException("New vertices cannot have any arcs.");
99
100      if (vertices.Add(vertex)) {
101        // register event handlers
102        vertex.ArcAdded += Vertex_ArcAdded;
103        vertex.ArcRemoved += Vertex_ArcRemoved;
104        OnVertexAdded(this, new EventArgs<IVertex>(vertex));
105      }
106    }
107
108    public virtual void AddVertices(IEnumerable<IVertex> vertexList) {
109      foreach (var v in vertexList) { AddVertex(v); }
110    }
111
112    public virtual void RemoveVertices(IEnumerable<IVertex> vertexList) {
113      foreach (var v in vertexList) { RemoveVertex(v); }
114    }
115
116    public virtual void RemoveVertex(IVertex vertex) {
117      vertices.Remove(vertex);
118      // remove connections to/from the removed vertex
119      var arcList = vertex.InArcs.Concat(vertex.OutArcs).ToList(); // avoid invalid operation exception: "collection was modified" below
120      foreach (var arc in arcList)
121        RemoveArc(arc);
122      // deregister event handlers
123      vertex.ArcAdded -= Vertex_ArcAdded;
124      vertex.ArcRemoved -= Vertex_ArcRemoved;
125      OnVertexRemoved(this, new EventArgs<IVertex>(vertex));
126    }
127
128    public virtual IArc AddArc(IVertex source, IVertex target) {
129      var arc = new Arc(source, target);
130      AddArc(arc);
131      return arc;
132    }
133
134    public virtual void AddArc(IArc arc) {
135      var source = arc.Source;
136      var target = arc.Target;
137
138      if (source == target)
139        throw new InvalidOperationException("Source and target cannot be the same.");
140
141      if (!vertices.Contains(source) || !vertices.Contains(target))
142        throw new InvalidOperationException("Cannot add arc connecting vertices that are not in the graph.");
143
144      source.AddArc(arc);
145      target.AddArc(arc);
146      arcs.Add(arc);
147    }
148
149    public virtual void AddArcs(IEnumerable<IArc> arcList) {
150      foreach (var a in arcList) { AddArc(a); }
151    }
152
153    public virtual void RemoveArc(IArc arc) {
154      arcs.Remove(arc);
155      var source = (Vertex)arc.Source;
156      var target = (Vertex)arc.Target;
157      source.RemoveArc(arc);
158      target.RemoveArc(arc);
159    }
160
161    public virtual void RemoveArcs(IEnumerable<IArc> arcList) {
162      foreach (var a in arcList) { RemoveArc(a); }
163    }
164
165    protected virtual void Vertex_ArcAdded(object sender, EventArgs<IArc> args) {
166      // the ArcAdded event is fired by a vertex when an arc from/to another vertex is added to its list of connections
167      // because the arc is added in both directions by both the source and the target, this event will get fired twice here
168      var arc = args.Value;
169      if (arcs.Add(arc)) OnArcAdded(this, new EventArgs<IArc>(arc));
170    }
171
172    protected virtual void Vertex_ArcRemoved(object sender, EventArgs<IArc> args) {
173      var arc = args.Value;
174      if (arcs.Remove(arc)) OnArcRemoved(this, new EventArgs<IArc>(arc));
175    }
176
177    // events
178    public event EventHandler<EventArgs<IVertex>> VertexAdded;
179    protected virtual void OnVertexAdded(object sender, EventArgs<IVertex> args) {
180      var added = VertexAdded;
181      if (added != null)
182        added(sender, args);
183    }
184
185    public event EventHandler<EventArgs<IVertex>> VertexRemoved;
186    protected virtual void OnVertexRemoved(object sender, EventArgs<IVertex> args) {
187      var removed = VertexRemoved;
188      if (removed != null)
189        removed(sender, args);
190    }
191
192    public event EventHandler<EventArgs<IArc>> ArcAdded;
193    protected virtual void OnArcAdded(object sender, EventArgs<IArc> args) {
194      var added = ArcAdded;
195      if (added != null)
196        added(sender, args);
197    }
198
199    public event EventHandler<EventArgs<IArc>> ArcRemoved;
200    protected virtual void OnArcRemoved(object sender, EventArgs<IArc> args) {
201      var removed = ArcRemoved;
202      if (removed != null)
203        removed(sender, args);
204    }
205  }
206}
Note: See TracBrowser for help on using the repository browser.