rgl 0.5.8 → 0.5.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/ChangeLog +5 -0
- data/README.md +21 -30
- data/lib/rgl/base.rb +1 -1
- data/lib/rgl/bellman_ford.rb +0 -2
- data/lib/rgl/dijkstra.rb +2 -2
- metadata +7 -7
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 46f0ba3170d9e82f84439dcb11ef208feb2d5d593334a09df409552e1b5bfc9d
|
4
|
+
data.tar.gz: d4eb269e797b26c41e64dc92d27f5dd54a6ed42192ba66ca2a32274cdc4cdc6c
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: da77a826c9b614ab96717a5c982ca89e9c1d14e947277a10e2cd0c267871f16f2b50356b80afe8d8f8f0a954e5968fba167f9758c3b65b9370f64e4fed1bbc23
|
7
|
+
data.tar.gz: f950c03d0b707ac672fa0adb3a80ff7fd6ad8ddfd92e50abdffda4f36dd0e7d67ec73ca5eb815783d40f222336e2a8298cd79285b5d95f4447affc7333467e1a
|
data/ChangeLog
CHANGED
data/README.md
CHANGED
@@ -3,20 +3,19 @@
|
|
3
3
|
RGL is a framework for graph data structures and algorithms.
|
4
4
|
|
5
5
|
The design of the library is much influenced by the Boost Graph Library (BGL)
|
6
|
-
which is written in C++. Refer to
|
6
|
+
which is written in C++. Refer to https://www.boost.org/libs/graph/doc for
|
7
7
|
further links and documentation on graph data structures and algorithms and
|
8
8
|
the design rationales of BGL.
|
9
9
|
|
10
10
|
A comprehensive summary of graph terminology can be found in the graph section
|
11
11
|
of the *Dictionary of Algorithms and Data Structures* at
|
12
|
-
|
12
|
+
https://www.nist.gov/dads/HTML/graph.html or
|
13
13
|
[Wikipedia](https://en.wikipedia.org/wiki/Graph_%28discrete_mathematics%29).
|
14
14
|
|
15
15
|
## Documentation
|
16
16
|
|
17
|
-
* RGL's [API Reference](
|
18
|
-
|
19
|
-
|
17
|
+
* RGL's [API Reference](https://www.rubydoc.info/github/monora/rgl) at
|
18
|
+
https://rubydoc.info
|
20
19
|
|
21
20
|
## Design principles
|
22
21
|
|
@@ -31,7 +30,6 @@ Ruby. The main design goals directly taken from the BGL design are:
|
|
31
30
|
* A standardized generic interface for traversing graphs
|
32
31
|
{RGL::GraphIterator}
|
33
32
|
|
34
|
-
|
35
33
|
RGL provides some general purpose graph classes that conform to this
|
36
34
|
interface, but they are not meant to be the **only** graph classes. As in BGL
|
37
35
|
I believe that the main contribution of the RGL is the formulation of this
|
@@ -48,11 +46,10 @@ achieve genericity:
|
|
48
46
|
* Element Type Parameterization
|
49
47
|
* Vertex and Edge Property Multi-Parameterization
|
50
48
|
|
51
|
-
|
52
49
|
The first is easily achieved in RGL using mixins, which of course is not as
|
53
50
|
efficient than C++ templates (but much more readable :-). The second one is
|
54
51
|
even more easily implemented using standard iterators with blocks or using the
|
55
|
-
[stream](
|
52
|
+
[stream](https://www.rubydoc.info/github/monora/stream) module. The third one
|
56
53
|
is no issue since Ruby is dynamically typed: Each object can be a graph
|
57
54
|
vertex. There is no need for a vertex (or even edge type). In the current
|
58
55
|
version of RGL properties of vertices are simply attached using hashes. At
|
@@ -65,7 +62,6 @@ RGL current contains a core set of algorithm patterns:
|
|
65
62
|
* Breadth First Search {RGL::BFSIterator}
|
66
63
|
* Depth First Search {RGL::DFSIterator}
|
67
64
|
|
68
|
-
|
69
65
|
The algorithm patterns by themselves do not compute any meaningful quantities
|
70
66
|
over graphs, they are merely building blocks for constructing graph
|
71
67
|
algorithms. The graph algorithms in RGL currently include:
|
@@ -77,7 +73,6 @@ algorithms. The graph algorithms in RGL currently include:
|
|
77
73
|
* Dijkstras Shortest Path Algorithm {RGL::DijkstraAlgorithm}
|
78
74
|
* Bellman Ford Algorithm {RGL::BellmanFordAlgorithm}
|
79
75
|
|
80
|
-
|
81
76
|
### Data Structures
|
82
77
|
|
83
78
|
RGL currently provides two graph classes that implement a generalized
|
@@ -86,7 +81,6 @@ adjacency list and an edge list adaptor.
|
|
86
81
|
* {RGL::AdjacencyGraph}
|
87
82
|
* {RGL::ImplicitGraph}
|
88
83
|
|
89
|
-
|
90
84
|
The AdjacencyGraph class is the general purpose _swiss army knife_ of graph
|
91
85
|
classes. It is highly parameterized so that it can be optimized for different
|
92
86
|
situations: the graph is directed or undirected, allow or disallow parallel
|
@@ -95,20 +89,20 @@ removal at the cost of extra space overhead, etc.
|
|
95
89
|
|
96
90
|
### Differences to BGL
|
97
91
|
|
98
|
-
The concepts of IncidenceGraph, AdjacencyGraph and VertexListGraph
|
99
|
-
|
100
|
-
|
101
|
-
the base module Graph. The complexity guarantees
|
102
|
-
|
92
|
+
The concepts of IncidenceGraph, AdjacencyGraph and VertexListGraph
|
93
|
+
(see [IncidenceGraph](https://www.boost.org/libs/graph/doc/IncidenceGraph.html)) are
|
94
|
+
bundled in RGL's base graph module. Most methods of IncidenceGraph
|
95
|
+
should be standard in the base module Graph. The complexity guarantees
|
96
|
+
can not necessarily provided (see [BGL's Graph Concepts](https://www.boost.org/libs/graph/doc/graph_concepts.html)).
|
103
97
|
|
104
98
|
## Installation
|
105
99
|
|
106
100
|
% gem install rgl
|
107
101
|
|
108
|
-
or download the latest sources from the git
|
109
|
-
|
102
|
+
or download the latest sources from the [git
|
103
|
+
repository](https://github.com/monora/rgl).
|
110
104
|
|
111
|
-
If you are going to use the drawing functionalities install [Graphviz](
|
105
|
+
If you are going to use the drawing functionalities install [Graphviz](https://www.graphviz.org/).
|
112
106
|
|
113
107
|
## Running tests
|
114
108
|
|
@@ -229,8 +223,6 @@ This graph shows all loaded RGL modules:
|
|
229
223
|
Look for more in
|
230
224
|
[examples](https://github.com/monora/rgl/tree/master/examples) directory.
|
231
225
|
|
232
|
-
I collect some links to stuff around RGL at http://del.icio.us/monora/rgl.
|
233
|
-
|
234
226
|
## Credits
|
235
227
|
|
236
228
|
Many thanks to Robert Feldt which also worked on a graph library
|
@@ -239,29 +231,28 @@ graph resources.
|
|
239
231
|
|
240
232
|
Robert kindly allowed to integrate his work on graphr, which I did not yet
|
241
233
|
succeed. Especially his work to output graphs for
|
242
|
-
[GraphViz](
|
234
|
+
[GraphViz](https://www.graphviz.org) is much more elaborated than the minimal
|
243
235
|
support in dot.rb.
|
244
236
|
|
245
237
|
Jeremy Siek one of the authors of the nice book [The Boost Graph
|
246
|
-
Library](
|
238
|
+
Library](https://www.boost.org/libs/graph/doc) kindly allowed to use the BGL
|
247
239
|
documentation as a *cheap* reference for RGL. He and Robert also gave feedback
|
248
240
|
and many ideas for RGL.
|
249
241
|
|
250
|
-
Dave Thomas for [RDoc](
|
242
|
+
Dave Thomas for [RDoc](https://rdoc.sourceforge.net) which generated what you
|
251
243
|
read and matz for Ruby. Dave included in the latest version of RDoc (alpha9)
|
252
244
|
the module dot/dot.rb which I use instead of Roberts module to visualize
|
253
245
|
graphs (see rgl/dot.rb).
|
254
246
|
|
255
|
-
Jeremy Bopp, John Carter, Sascha Doerdelmann, Shawn Garbett, Andreas
|
256
|
-
and Kirill Lashuk for contributing additions, test
|
257
|
-
|
258
|
-
Kirill Lashuk who started to take over further development in November 2012.
|
247
|
+
Jeremy Bopp, John Carter, Sascha Doerdelmann, Shawn Garbett, Andreas
|
248
|
+
Schörk, Dan Čermák and Kirill Lashuk for contributing additions, test
|
249
|
+
cases and bugfixes.
|
259
250
|
|
260
|
-
See also
|
251
|
+
See also: https://github.com/monora/rgl/contributors
|
261
252
|
|
262
253
|
## Copying
|
263
254
|
|
264
|
-
RGL is Copyright (c) 2002,2004,2005,2008,2013,2015,2019,2020 by Horst
|
255
|
+
RGL is Copyright (c) 2002,2004,2005,2008,2013,2015,2019,2020,2022 by Horst
|
265
256
|
Duchene. It is free software, and may be redistributed under the [Ruby
|
266
257
|
license](https://en.wikipedia.org/wiki/Ruby_License) and terms specified in
|
267
258
|
the LICENSE file.
|
data/lib/rgl/base.rb
CHANGED
data/lib/rgl/bellman_ford.rb
CHANGED
data/lib/rgl/dijkstra.rb
CHANGED
@@ -2,7 +2,7 @@ require 'rgl/dijkstra_visitor'
|
|
2
2
|
require 'rgl/edge_properties_map'
|
3
3
|
require 'rgl/path_builder'
|
4
4
|
|
5
|
-
require '
|
5
|
+
require 'pairing_heap'
|
6
6
|
|
7
7
|
module RGL
|
8
8
|
|
@@ -54,7 +54,7 @@ module RGL
|
|
54
54
|
def init(source)
|
55
55
|
@visitor.set_source(source)
|
56
56
|
|
57
|
-
@queue = MinPriorityQueue.new
|
57
|
+
@queue = PairingHeap::MinPriorityQueue.new
|
58
58
|
@queue.push(source, 0)
|
59
59
|
end
|
60
60
|
|
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: rgl
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.5.
|
4
|
+
version: 0.5.9
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Horst Duchene
|
@@ -9,7 +9,7 @@ authors:
|
|
9
9
|
autorequire: rgl/base
|
10
10
|
bindir: bin
|
11
11
|
cert_chain: []
|
12
|
-
date: 2022-
|
12
|
+
date: 2022-08-29 00:00:00.000000000 Z
|
13
13
|
dependencies:
|
14
14
|
- !ruby/object:Gem::Dependency
|
15
15
|
name: stream
|
@@ -26,19 +26,19 @@ dependencies:
|
|
26
26
|
- !ruby/object:Gem::Version
|
27
27
|
version: 0.5.3
|
28
28
|
- !ruby/object:Gem::Dependency
|
29
|
-
name:
|
29
|
+
name: pairing_heap
|
30
30
|
requirement: !ruby/object:Gem::Requirement
|
31
31
|
requirements:
|
32
|
-
- - "
|
32
|
+
- - ">="
|
33
33
|
- !ruby/object:Gem::Version
|
34
|
-
version: 0.
|
34
|
+
version: 0.3.0
|
35
35
|
type: :runtime
|
36
36
|
prerelease: false
|
37
37
|
version_requirements: !ruby/object:Gem::Requirement
|
38
38
|
requirements:
|
39
|
-
- - "
|
39
|
+
- - ">="
|
40
40
|
- !ruby/object:Gem::Version
|
41
|
-
version: 0.
|
41
|
+
version: 0.3.0
|
42
42
|
- !ruby/object:Gem::Dependency
|
43
43
|
name: rexml
|
44
44
|
requirement: !ruby/object:Gem::Requirement
|