?HAMA

Navigation

Breadcrumbs

/ / proc / thread-self / root / opt / alt / ruby18 / lib64 / ruby / 1.8

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 7.99 KB

/proc/thread-self/root/opt/alt/ruby18/lib64/ruby/1.8/tsort.rb

Text Base64

#!/usr/bin/env ruby
#--
# tsort.rb - provides a module for topological sorting and strongly connected components.
#++
#

#
# TSort implements topological sorting using Tarjan's algorithm for
# strongly connected components.
#
# TSort is designed to be able to be used with any object which can be
# interpreted as a directed graph.
#
# TSort requires two methods to interpret an object as a graph,
# tsort_each_node and tsort_each_child.
#
# * tsort_each_node is used to iterate for all nodes over a graph.
# * tsort_each_child is used to iterate for child nodes of a given node.
#
# The equality of nodes are defined by eql? and hash since
# TSort uses Hash internally.
#
# == A Simple Example
#
# The following example demonstrates how to mix the TSort module into an
# existing class (in this case, Hash). Here, we're treating each key in
# the hash as a node in the graph, and so we simply alias the required
# #tsort_each_node method to Hash's #each_key method. For each key in the
# hash, the associated value is an array of the node's child nodes. This
# choice in turn leads to our implementation of the required #tsort_each_child
# method, which fetches the array of child nodes and then iterates over that
# array using the user-supplied block.
#
# require 'tsort'
# 
# class Hash
# include TSort
# alias tsort_each_node each_key
# def tsort_each_child(node, &block)
# fetch(node).each(&block)
# end
# end
# 
# {1=>[2, 3], 2=>[3], 3=>[], 4=>[]}.tsort
# #=> [3, 2, 1, 4]
# 
# {1=>[2], 2=>[3, 4], 3=>[2], 4=>[]}.strongly_connected_components
# #=> [[4], [2, 3], [1]]
#
# == A More Realistic Example
#
# A very simple `make' like tool can be implemented as follows:
#
# require 'tsort'
# 
# class Make
# def initialize
# @dep = {}
# @dep.default = []
# end
# 
# def rule(outputs, inputs=[], &block)
# triple = [outputs, inputs, block]
# outputs.each {|f| @dep[f] = [triple]}
# @dep[triple] = inputs
# end
# 
# def build(target)
# each_strongly_connected_component_from(target) {|ns|
# if ns.length != 1
# fs = ns.delete_if {|n| Array === n}
# raise TSort::Cyclic.new("cyclic dependencies: #{fs.join ', '}")
# end
# n = ns.first
# if Array === n
# outputs, inputs, block = n
# inputs_time = inputs.map {|f| File.mtime f}.max
# begin
# outputs_time = outputs.map {|f| File.mtime f}.min
# rescue Errno::ENOENT
# outputs_time = nil
# end
# if outputs_time == nil ||
# inputs_time != nil && outputs_time <= inputs_time
# sleep 1 if inputs_time != nil && inputs_time.to_i == Time.now.to_i
# block.call
# end
# end
# }
# end
# 
# def tsort_each_child(node, &block)
# @dep[node].each(&block)
# end
# include TSort
# end
# 
# def command(arg)
# print arg, "\n"
# system arg
# end
# 
# m = Make.new
# m.rule(%w[t1]) { command 'date > t1' }
# m.rule(%w[t2]) { command 'date > t2' }
# m.rule(%w[t3]) { command 'date > t3' }
# m.rule(%w[t4], %w[t1 t3]) { command 'cat t1 t3 > t4' }
# m.rule(%w[t5], %w[t4 t2]) { command 'cat t4 t2 > t5' }
# m.build('t5')
#
# == Bugs
#
# * 'tsort.rb' is wrong name because this library uses
# Tarjan's algorithm for strongly connected components.
# Although 'strongly_connected_components.rb' is correct but too long.
#
# == References
#
# R. E. Tarjan, "Depth First Search and Linear Graph Algorithms",
# SIAM Journal on Computing, Vol. 1, No. 2, pp. 146-160, June 1972.
#

module TSort
 class Cyclic < StandardError
 end

#
 # Returns a topologically sorted array of nodes.
 # The array is sorted from children to parents, i.e.
 # the first element has no child and the last node has no parent.
 #
 # If there is a cycle, TSort::Cyclic is raised.
 #
 def tsort
 result = []
 tsort_each {|element| result << element}
 result
 end

#
 # The iterator version of the #tsort method.
 # <tt>obj.tsort_each</tt> is similar to <tt>obj.tsort.each</tt>, but
 # modification of _obj_ during the iteration may lead to unexpected results.
 #
 # #tsort_each returns +nil+.
 # If there is a cycle, TSort::Cyclic is raised.
 #
 def tsort_each # :yields: node
 each_strongly_connected_component {|component|
 if component.size == 1
 yield component.first
 else
 raise Cyclic.new("topological sort failed: #{component.inspect}")
 end
 }
 end

#
 # Returns strongly connected components as an array of arrays of nodes.
 # The array is sorted from children to parents.
 # Each elements of the array represents a strongly connected component.
 #
 def strongly_connected_components
 result = []
 each_strongly_connected_component {|component| result << component}
 result
 end

#
 # The iterator version of the #strongly_connected_components method.
 # <tt>obj.each_strongly_connected_component</tt> is similar to
 # <tt>obj.strongly_connected_components.each</tt>, but
 # modification of _obj_ during the iteration may lead to unexpected results.
 #
 #
 # #each_strongly_connected_component returns +nil+.
 #
 def each_strongly_connected_component # :yields: nodes
 id_map = {}
 stack = []
 tsort_each_node {|node|
 unless id_map.include? node
 each_strongly_connected_component_from(node, id_map, stack) {|c|
 yield c
 }
 end
 }
 nil
 end

#
 # Iterates over strongly connected component in the subgraph reachable from 
 # _node_.
 #
 # Return value is unspecified.
 #
 # #each_strongly_connected_component_from doesn't call #tsort_each_node.
 #
 def each_strongly_connected_component_from(node, id_map={}, stack=[]) # :yields: nodes
 minimum_id = node_id = id_map[node] = id_map.size
 stack_length = stack.length
 stack << node

tsort_each_child(node) {|child|
 if id_map.include? child
 child_id = id_map[child]
 minimum_id = child_id if child_id && child_id < minimum_id
 else
 sub_minimum_id =
 each_strongly_connected_component_from(child, id_map, stack) {|c|
 yield c
 }
 minimum_id = sub_minimum_id if sub_minimum_id < minimum_id
 end
 }

if node_id == minimum_id
      component = stack.slice!(stack_length .. -1)
      component.each {|n| id_map[n] = nil}
      yield component
    end

minimum_id
  end

#
  # Should be implemented by a extended class.
  #
  # #tsort_each_node is used to iterate for all nodes over a graph.
  #
  def tsort_each_node # :yields: node
    raise NotImplementedError.new
  end

#
  # Should be implemented by a extended class.
  #
  # #tsort_each_child is used to iterate for child nodes of _node_.
  #
  def tsort_each_child(node) # :yields: child
    raise NotImplementedError.new
  end
end

if __FILE__ == $0
  require 'test/unit'

class TSortHash < Hash # :nodoc:
 include TSort
 alias tsort_each_node each_key
 def tsort_each_child(node, &block)
 fetch(node).each(&block)
 end
 end

class TSortArray < Array # :nodoc:
 include TSort
 alias tsort_each_node each_index
 def tsort_each_child(node, &block)
 fetch(node).each(&block)
 end
 end

class TSortTest < Test::Unit::TestCase # :nodoc:
 def test_dag
 h = TSortHash[{1=>[2, 3], 2=>[3], 3=>[]}]
 assert_equal([3, 2, 1], h.tsort)
 assert_equal([[3], [2], [1]], h.strongly_connected_components)
 end

def test_cycle
      h = TSortHash[{1=>[2], 2=>[3, 4], 3=>[2], 4=>[]}]
      assert_equal([[4], [2, 3], [1]],
        h.strongly_connected_components.map {|nodes| nodes.sort})
      assert_raise(TSort::Cyclic) { h.tsort }
    end

def test_array
      a = TSortArray[[1], [0], [0], [2]]
      assert_equal([[0, 1], [2], [3]],
        a.strongly_connected_components.map {|nodes| nodes.sort})

a = TSortArray[[], [0]]
      assert_equal([[0], [1]],
        a.strongly_connected_components.map {|nodes| nodes.sort})
    end
  end

end

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 27 × Files: 83

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
bigdecimal DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
cgi DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
date DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
digest DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
dl DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
drb DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
io DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
irb DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
net DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
openssl DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
optparse DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
racc DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
rdoc DIR	-	drwxr-xr-x	2024-03-03 22:48:17	Edit Download recursive recursive
rexml DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
rinda DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
rss DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
runit DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
shell DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
soap DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
test DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
uri DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
webrick DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
wsdl DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
x86_64-linux DIR	-	drwxr-xr-x	2024-03-03 22:50:34	Edit Download recursive recursive
xmlrpc DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
xsd DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
yaml DIR	-	drwxr-xr-x	2024-03-03 22:48:14	Edit Download recursive recursive
abbrev.rb	2.50 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
base64.rb	3.37 KB	lrw-r--r--	2007-07-16 15:47:16	Edit Download recursive recursive
benchmark.rb	17.73 KB	lrw-r--r--	2008-02-10 15:24:56	Edit Download recursive recursive
cgi-lib.rb	6.89 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
cgi.rb	73.74 KB	lrw-r--r--	2009-12-14 02:40:07	Edit Download recursive recursive
complex.rb	12.84 KB	lrw-r--r--	2009-08-03 05:59:38	Edit Download recursive recursive
csv.rb	24.46 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
date.rb	53.02 KB	lrw-r--r--	2010-06-08 04:45:42	Edit Download recursive recursive
date2.rb	128 B	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
debug.rb	20.61 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
delegate.rb	8.81 KB	lrw-r--r--	2009-07-16 00:35:14	Edit Download recursive recursive
digest.rb	1.12 KB	lrw-r--r--	2007-07-28 00:40:58	Edit Download recursive recursive
drb.rb	19 B	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
e2mmap.rb	4.04 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
English.rb	5.60 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
Env.rb	274 B	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
erb.rb	21.38 KB	lrw-r--r--	2009-02-23 17:44:50	Edit Download recursive recursive
eregex.rb	487 B	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
expect.rb	633 B	lrw-r--r--	2008-02-18 01:17:44	Edit Download recursive recursive
fileutils.rb	42.23 KB	lrw-r--r--	2011-05-20 22:29:13	Edit Download recursive recursive
finalize.rb	5.38 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
find.rb	1.84 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
forwardable.rb	6.16 KB	lrw-r--r--	2008-06-06 08:05:24	Edit Download recursive recursive
ftools.rb	6.17 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
generator.rb	8.10 KB	lrw-r--r--	2008-04-10 10:52:50	Edit Download recursive recursive
getoptlong.rb	14.88 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
getopts.rb	2.25 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
gserver.rb	6.43 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
importenv.rb	590 B	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
ipaddr.rb	21.96 KB	lrw-r--r--	2008-07-12 15:08:29	Edit Download recursive recursive
irb.rb	7.43 KB	lrw-r--r--	2009-08-09 08:44:15	Edit Download recursive recursive
jcode.rb	4.30 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
kconv.rb	8.12 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
logger.rb	17.59 KB	lrw-r--r--	2011-05-30 02:08:57	Edit Download recursive recursive
mailread.rb	1.28 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
mathn.rb	5.42 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
matrix.rb	27.21 KB	lrw-r--r--	2009-01-24 15:02:50	Edit Download recursive recursive
md5.rb	411 B	lrw-r--r--	2007-03-06 10:09:51	Edit Download recursive recursive
mkmf.rb	50.65 KB	lrw-r--r--	2010-12-04 06:34:10	Edit Download recursive recursive
monitor.rb	7.93 KB	lrw-r--r--	2009-11-25 07:45:29	Edit Download recursive recursive
mutex_m.rb	2.07 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
observer.rb	5.15 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
open-uri.rb	20.49 KB	lrw-r--r--	2007-10-08 11:16:54	Edit Download recursive recursive
open3.rb	2.10 KB	lrw-r--r--	2009-12-14 04:28:06	Edit Download recursive recursive
openssl.rb	575 B	lrw-r--r--	2010-11-22 07:21:45	Edit Download recursive recursive
optparse.rb	47.12 KB	lrw-r--r--	2009-02-20 11:43:35	Edit Download recursive recursive
ostruct.rb	3.35 KB	lrw-r--r--	2009-05-26 12:06:21	Edit Download recursive recursive
parsearg.rb	1.55 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
parsedate.rb	1.33 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
pathname.rb	29.39 KB	lrw-r--r--	2010-11-23 08:21:08	Edit Download recursive recursive
ping.rb	1.48 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
pp.rb	15.97 KB	lrw-r--r--	2007-06-07 10:06:41	Edit Download recursive recursive
prettyprint.rb	18.33 KB	lrw-r--r--	2007-02-16 19:53:09	Edit Download recursive recursive
profile.rb	90 B	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
profiler.rb	1.59 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
pstore.rb	11.15 KB	lrw-r--r--	2008-06-06 08:05:24	Edit Download recursive recursive
rational.rb	12.05 KB	lrw-r--r--	2010-06-08 05:02:31	Edit Download recursive recursive
readbytes.rb	835 B	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
resolv-replace.rb	1.55 KB	lrw-r--r--	2008-08-08 01:58:40	Edit Download recursive recursive
resolv.rb	56.83 KB	lrw-r--r--	2010-12-23 03:22:57	Edit Download recursive recursive
rss.rb	504 B	lrw-r--r--	2007-10-21 12:19:43	Edit Download recursive recursive
rubyunit.rb	180 B	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
scanf.rb	20.63 KB	lrw-r--r--	2009-01-20 03:23:46	Edit Download recursive recursive
securerandom.rb	4.27 KB	lrw-r--r--	2011-12-10 12:17:33	Edit Download recursive recursive
set.rb	27.08 KB	lrw-r--r--	2008-06-09 09:20:43	Edit Download recursive recursive
sha1.rb	418 B	lrw-r--r--	2007-03-06 10:09:51	Edit Download recursive recursive
shell.rb	4.66 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
shellwords.rb	3.99 KB	lrw-r--r--	2008-03-21 12:16:15	Edit Download recursive recursive
singleton.rb	8.08 KB	lrw-r--r--	2008-07-03 11:14:50	Edit Download recursive recursive
sync.rb	6.09 KB	lrw-r--r--	2009-02-19 16:41:12	Edit Download recursive recursive
tempfile.rb	4.86 KB	lrw-r--r--	2008-04-21 09:43:44	Edit Download recursive recursive
thread.rb	104 B	lrw-r--r--	2007-02-13 19:39:32	Edit Download recursive recursive
thwait.rb	4.32 KB	lrw-r--r--	2010-06-08 07:08:15	Edit Download recursive recursive
time.rb	31.58 KB	lrw-r--r--	2008-06-06 08:05:24	Edit Download recursive recursive
timeout.rb	3.00 KB	lrw-r--r--	2010-06-08 06:24:25	Edit Download recursive recursive
tmpdir.rb	3.69 KB	lrw-r--r--	2009-01-26 02:12:10	Edit Download recursive recursive
tracer.rb	2.73 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
tsort.rb	7.99 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
un.rb	4.54 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
uri.rb	710 B	lrw-r--r--	2008-04-15 09:41:47	Edit Download recursive recursive
weakref.rb	2.68 KB	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
webrick.rb	811 B	lrw-r--r--	2007-02-12 23:01:19	Edit Download recursive recursive
yaml.rb	12.36 KB	lrw-r--r--	2008-04-19 11:45:39	Edit Download recursive recursive