annotate docs/modules/txt/PathGraph.txt @ 3:90ea638ce878 draft default tip

Uploaded
author deepakjadmin
date Wed, 20 Jan 2016 09:11:59 -0500
parents 2abf0d43254d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
1 NAME
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
2 PathGraph
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
3
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
4 SYNOPSIS
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
5 use Graph::PathGraph;
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
6
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
7 use Graph::PathGraph qw(:all);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
8
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
9 DESCRIPTION
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
10 PathGraph class provides the following methods:
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
11
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
12 new, CollapseVertexAndCollectCyclicPaths,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
13 DeleteVerticesWithDegreeLessThan, GetCyclicPaths, GetPaths, IsPathGraph,
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
14 StringifyPathGraph
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
15
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
16 PathGraph class is derived from *Graph* class.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
17
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
18 METHODS
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
19 new
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
20 $NewPathGraph = new Graph::PathGraph($Graph);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
21
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
22 Using specified *Graph*, new method creates a new PathGraph object
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
23 and returns newly created PathGraph object.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
24
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
25 *Graph* is converted into a PathGraph by copying all its vertices
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
26 and edges without any associated properties data and associating a
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
27 *Path* object to each edge containing edge vertex IDs as intial
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
28 path.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
29
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
30 CollapseVertexAndCollectCyclicPaths
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
31 $PathGraph->CollapseVertexAndCollectCyclicPaths($VertexID);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
32
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
33 Collapses paths around a *VertexID* by updating paths around the
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
34 vertex [Ref 31] and associating any resulting cyclic paths to graph
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
35 as CyclicPaths property name. And returns *PathGraph*.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
36
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
37 DeleteVerticesWithDegreeLessThan
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
38 $Return = $PathGraph->DeleteVerticesWithDegreeLessThan($Degree);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
39
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
40 Deletes vertices with degree less than *Degree* from *PathGraph* and
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
41 returns *PathGraph*.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
42
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
43 GetCyclicPaths
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
44 @CyclicPaths = $PathGraph->GetCyclicPaths();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
45 $NumOfPaths = $PathGraph->GetCyclicPaths();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
46
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
47 Returns an array of cyclic *Paths* associated with edges in
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
48 *PathGraph*. In scalar context, number of cyclic paths is returned.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
49
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
50 GetPaths
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
51 @Paths = $PathGraph->GetPaths();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
52 $NumOfPaths = $PathGraph->GetPaths();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
53
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
54 Returns an array of *Paths* associated with edges in *PathGraph*. In
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
55 scalar context, number of paths is returned.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
56
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
57 IsPathGraph
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
58 $Status = Graph::PathGraph::IsPathGraph($Object);
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
59
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
60 Returns 1 or 0 based on whether *Object* is a PathGraph object.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
61
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
62 StringifyPathGraph
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
63 $String = $PathGraph->StringifyPathGraph();
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
64
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
65 Returns a string containing information about traversed paths in
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
66 *PathGraph* object.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
67
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
68 AUTHOR
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
69 Manish Sud <msud@san.rr.com>
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
70
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
71 SEE ALSO
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
72 Graph.pm, Path.pm
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
73
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
74 COPYRIGHT
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
75 Copyright (C) 2015 Manish Sud. All rights reserved.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
76
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
77 This file is part of MayaChemTools.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
78
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
79 MayaChemTools is free software; you can redistribute it and/or modify it
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
80 under the terms of the GNU Lesser General Public License as published by
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
81 the Free Software Foundation; either version 3 of the License, or (at
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
82 your option) any later version.
2abf0d43254d Uploaded
deepakjadmin
parents:
diff changeset
83