0
|
1 <html>
|
|
2 <head>
|
|
3 <title>MayaChemTools:Code:Fingerprints::FingerprintsVector.pm</title>
|
|
4 <meta http-equiv="content-type" content="text/html;charset=utf-8">
|
|
5 <link rel="stylesheet" type="text/css" href="../../../css/MayaChemToolsCode.css">
|
|
6 </head>
|
|
7 <body leftmargin="20" rightmargin="20" topmargin="10" bottommargin="10">
|
|
8 <br/>
|
|
9 <center>
|
|
10 <a href="http://www.mayachemtools.org" title="MayaChemTools Home"><img src="../../../images/MayaChemToolsLogo.gif" border="0" alt="MayaChemTools"></a>
|
|
11 </center>
|
|
12 <br/>
|
|
13 <pre>
|
|
14 <a name="package-Fingerprints::FingerprintsVector-"></a> 1 <span class="k">package </span><span class="i">Fingerprints::FingerprintsVector</span><span class="sc">;</span>
|
|
15 2 <span class="c">#</span>
|
|
16 3 <span class="c"># $RCSfile: FingerprintsVector.pm,v $</span>
|
|
17 4 <span class="c"># $Date: 2015/02/28 20:48:54 $</span>
|
|
18 5 <span class="c"># $Revision: 1.31 $</span>
|
|
19 6 <span class="c">#</span>
|
|
20 7 <span class="c"># Author: Manish Sud <msud@san.rr.com></span>
|
|
21 8 <span class="c">#</span>
|
|
22 9 <span class="c"># Copyright (C) 2015 Manish Sud. All rights reserved.</span>
|
|
23 10 <span class="c">#</span>
|
|
24 11 <span class="c"># This file is part of MayaChemTools.</span>
|
|
25 12 <span class="c">#</span>
|
|
26 13 <span class="c"># MayaChemTools is free software; you can redistribute it and/or modify it under</span>
|
|
27 14 <span class="c"># the terms of the GNU Lesser General Public License as published by the Free</span>
|
|
28 15 <span class="c"># Software Foundation; either version 3 of the License, or (at your option) any</span>
|
|
29 16 <span class="c"># later version.</span>
|
|
30 17 <span class="c">#</span>
|
|
31 18 <span class="c"># MayaChemTools is distributed in the hope that it will be useful, but without</span>
|
|
32 19 <span class="c"># any warranty; without even the implied warranty of merchantability of fitness</span>
|
|
33 20 <span class="c"># for a particular purpose. See the GNU Lesser General Public License for more</span>
|
|
34 21 <span class="c"># details.</span>
|
|
35 22 <span class="c">#</span>
|
|
36 23 <span class="c"># You should have received a copy of the GNU Lesser General Public License</span>
|
|
37 24 <span class="c"># along with MayaChemTools; if not, see <http://www.gnu.org/licenses/> or</span>
|
|
38 25 <span class="c"># write to the Free Software Foundation Inc., 59 Temple Place, Suite 330,</span>
|
|
39 26 <span class="c"># Boston, MA, 02111-1307, USA.</span>
|
|
40 27 <span class="c">#</span>
|
|
41 28
|
|
42 29 <span class="k">use</span> <span class="w">strict</span><span class="sc">;</span>
|
|
43 30 <span class="k">use</span> <span class="w">Carp</span><span class="sc">;</span>
|
|
44 31 <span class="k">use</span> <span class="w">Exporter</span><span class="sc">;</span>
|
|
45 32 <span class="k">use</span> <span class="w">Scalar::Util</span> <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
46 33 <span class="k">use</span> <span class="w">MathUtil</span> <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
47 34 <span class="k">use</span> <span class="w">TextUtil</span> <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
48 35 <span class="k">use</span> <span class="w">StatisticsUtil</span> <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
49 36 <span class="k">use</span> <span class="w">BitVector</span><span class="sc">;</span>
|
|
50 37 <span class="k">use</span> <span class="w">Vector</span><span class="sc">;</span>
|
|
51 38
|
|
52 39 <span class="k">use</span> <span class="w">vars</span> <span class="q">qw(@ISA @EXPORT @EXPORT_OK %EXPORT_TAGS)</span><span class="sc">;</span>
|
|
53 40
|
|
54 41 <span class="i">@ISA</span> = <span class="q">qw(Exporter)</span><span class="sc">;</span>
|
|
55 42
|
|
56 43 <span class="c"># Distance coefficients</span>
|
|
57 44 <span class="k">my</span><span class="s">(</span><span class="i">@DistanceCoefficients</span><span class="s">)</span> = <span class="q">qw(CityBlockDistanceCoefficient EuclideanDistanceCoefficient HammingDistanceCoefficient ManhattanDistanceCoefficient SoergelDistanceCoefficient)</span><span class="sc">;</span>
|
|
58 45
|
|
59 46 <span class="c"># Similarity coefficients...</span>
|
|
60 47 <span class="k">my</span><span class="s">(</span><span class="i">@SimilarityCoefficients</span><span class="s">)</span> = <span class="q">qw(CosineSimilarityCoefficient CzekanowskiSimilarityCoefficient DiceSimilarityCoefficient OchiaiSimilarityCoefficient JaccardSimilarityCoefficient SorensonSimilarityCoefficient TanimotoSimilarityCoefficient)</span><span class="sc">;</span>
|
|
61 48
|
|
62 49 <span class="c"># New from string...</span>
|
|
63 50 <span class="k">my</span><span class="s">(</span><span class="i">@NewFromString</span><span class="s">)</span> = <span class="q">qw(NewFromValuesString NewFromValuesAndIDsString NewFromIDsAndValuesString NewFromValuesAndIDsPairsString NewFromIDsAndValuesPairsString)</span><span class="sc">;</span>
|
|
64 51
|
|
65 52 <span class="i">@EXPORT</span> = <span class="q">qw(IsFingerprintsVector)</span><span class="sc">;</span>
|
|
66 53 <span class="i">@EXPORT_OK</span> = <span class="q">qw(GetSupportedDistanceCoefficients GetSupportedSimilarityCoefficients GetSupportedDistanceAndSimilarityCoefficients @DistanceCoefficients @SimilarityCoefficients)</span><span class="sc">;</span>
|
|
67 54
|
|
68 55 <span class="i">%EXPORT_TAGS</span> = <span class="s">(</span>
|
|
69 56 <span class="w">new</span> <span class="cm">=></span> <span class="s">[</span><span class="i">@NewFromString</span><span class="s">]</span><span class="cm">,</span>
|
|
70 57 <span class="w">distancecoefficients</span> <span class="cm">=></span> <span class="s">[</span><span class="i">@DistanceCoefficients</span><span class="s">]</span><span class="cm">,</span>
|
|
71 58 <span class="w">similaritycoefficients</span> <span class="cm">=></span> <span class="s">[</span><span class="i">@SimilarityCoefficients</span><span class="s">]</span><span class="cm">,</span>
|
|
72 59 <span class="w">all</span> <span class="cm">=></span> <span class="s">[</span><span class="i">@EXPORT</span><span class="cm">,</span> <span class="i">@EXPORT_OK</span><span class="s">]</span>
|
|
73 60 <span class="s">)</span><span class="sc">;</span>
|
|
74 61
|
|
75 62 <span class="c"># Setup class variables...</span>
|
|
76 63 <span class="k">my</span><span class="s">(</span><span class="i">$ClassName</span><span class="s">)</span><span class="sc">;</span>
|
|
77 64 <span class="i">_InitializeClass</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
78 65
|
|
79 66 <span class="c"># Overload Perl functions...</span>
|
|
80 67 <span class="k">use</span> <span class="w">overload</span> <span class="q">'""'</span> <span class="cm">=></span> <span class="q">'StringifyFingerprintsVector'</span><span class="sc">;</span>
|
|
81 68
|
|
82 69 <span class="c"># Class constructor...</span>
|
|
83 <a name="new-"></a> 70 <span class="k">sub </span><span class="m">new</span> <span class="s">{</span>
|
|
84 71 <span class="k">my</span><span class="s">(</span><span class="i">$Class</span><span class="cm">,</span> <span class="i">%NamesAndValues</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
85 72
|
|
86 73 <span class="c"># Initialize object...</span>
|
|
87 74 <span class="k">my</span> <span class="i">$This</span> = <span class="s">{</span><span class="s">}</span><span class="sc">;</span>
|
|
88 75 <span class="k">bless</span> <span class="i">$This</span><span class="cm">,</span> <span class="k">ref</span><span class="s">(</span><span class="i">$Class</span><span class="s">)</span> || <span class="i">$Class</span><span class="sc">;</span>
|
|
89 76
|
|
90 77 <span class="i">$This</span><span class="i">->_InitializeFingerprintsVector</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
91 78
|
|
92 79 <span class="i">$This</span><span class="i">->_InitializeFingerprintsVectorProperties</span><span class="s">(</span><span class="i">%NamesAndValues</span><span class="s">)</span><span class="sc">;</span>
|
|
93 80
|
|
94 81 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
95 82 <span class="s">}</span>
|
|
96 83
|
|
97 84 <span class="c"># Initialize object data...</span>
|
|
98 85 <span class="c">#</span>
|
|
99 <a name="_InitializeFingerprintsVector-"></a> 86 <span class="k">sub </span><span class="m">_InitializeFingerprintsVector</span> <span class="s">{</span>
|
|
100 87 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
101 88
|
|
102 89 <span class="c"># Type of fingerprint vector...</span>
|
|
103 90 <span class="i">$This</span>->{<span class="w">Type</span>} = <span class="q">''</span><span class="sc">;</span>
|
|
104 91
|
|
105 92 <span class="c"># Fingerprint vector values...</span>
|
|
106 93 <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}} = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
107 94
|
|
108 95 <span class="c"># Fingerprint vector value IDs...</span>
|
|
109 96 <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}} = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
110 97
|
|
111 98 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
112 99 <span class="s">}</span>
|
|
113 100
|
|
114 101 <span class="c"># Initialize class ...</span>
|
|
115 <a name="_InitializeClass-"></a> 102 <span class="k">sub </span><span class="m">_InitializeClass</span> <span class="s">{</span>
|
|
116 103 <span class="c">#Class name...</span>
|
|
117 104 <span class="i">$ClassName</span> = <span class="w">__PACKAGE__</span><span class="sc">;</span>
|
|
118 105 <span class="s">}</span>
|
|
119 106
|
|
120 107 <span class="c"># Initialize object properties....</span>
|
|
121 <a name="_InitializeFingerprintsVectorProperties-"></a> 108 <span class="k">sub </span><span class="m">_InitializeFingerprintsVectorProperties</span> <span class="s">{</span>
|
|
122 109 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">%NamesAndValues</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
123 110
|
|
124 111 <span class="k">my</span><span class="s">(</span><span class="i">$Name</span><span class="cm">,</span> <span class="i">$Value</span><span class="cm">,</span> <span class="i">$MethodName</span><span class="s">)</span><span class="sc">;</span>
|
|
125 112 <span class="k">while</span> <span class="s">(</span><span class="s">(</span><span class="i">$Name</span><span class="cm">,</span> <span class="i">$Value</span><span class="s">)</span> = <span class="k">each</span> <span class="i">%NamesAndValues</span><span class="s">)</span> <span class="s">{</span>
|
|
126 113 <span class="i">$MethodName</span> = <span class="q">"Set${Name}"</span><span class="sc">;</span>
|
|
127 114 <span class="i">$This</span><span class="i">->$MethodName</span><span class="s">(</span><span class="i">$Value</span><span class="s">)</span><span class="sc">;</span>
|
|
128 115 <span class="s">}</span>
|
|
129 116
|
|
130 117 <span class="k">if</span> <span class="s">(</span>!<span class="k">exists</span> <span class="i">$NamesAndValues</span>{<span class="w">Type</span>}<span class="s">)</span> <span class="s">{</span>
|
|
131 118 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->New: Object can't be instantiated without specifying type..."</span><span class="sc">;</span>
|
|
132 119 <span class="s">}</span>
|
|
133 120 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
134 121 <span class="s">}</span>
|
|
135 122
|
|
136 123 <span class="c"># Create a new fingerprints vector using space delimited values string. This functionality can be</span>
|
|
137 124 <span class="c"># either invoked as a class function or an object method.</span>
|
|
138 125 <span class="c">#</span>
|
|
139 <a name="NewFromValuesString-"></a> 126 <span class="k">sub </span><span class="m">NewFromValuesString ($$;$)</span> <span class="s">{</span>
|
|
140 127 <span class="k">my</span><span class="s">(</span><span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="cm">,</span> <span class="i">$ThirdParamater</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
141 128 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$ValuesString</span><span class="s">)</span><span class="sc">;</span>
|
|
142 129
|
|
143 130 <span class="k">if</span> <span class="s">(</span><span class="i">@_</span> == <span class="n">3</span><span class="s">)</span> <span class="s">{</span>
|
|
144 131 <span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$ValuesString</span><span class="s">)</span> = <span class="s">(</span><span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="cm">,</span> <span class="i">$ThirdParamater</span><span class="s">)</span><span class="sc">;</span>
|
|
145 132 <span class="s">}</span>
|
|
146 133 <span class="k">else</span> <span class="s">{</span>
|
|
147 134 <span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$ValuesString</span><span class="s">)</span> = <span class="s">(</span><span class="k">undef</span><span class="cm">,</span> <span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="s">)</span><span class="sc">;</span>
|
|
148 135 <span class="s">}</span>
|
|
149 136 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVector</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span><span class="sc">;</span>
|
|
150 137
|
|
151 138 <span class="i">@Values</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
152 139 <span class="k">if</span> <span class="s">(</span><span class="k">defined</span><span class="s">(</span><span class="i">$ValuesString</span><span class="s">)</span> && <span class="k">length</span><span class="s">(</span><span class="i">$ValuesString</span><span class="s">)</span> && <span class="i">$ValuesString</span> !~ <span class="q">/^None$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
153 140 <span class="i">@Values</span> = <span class="k">split</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">$ValuesString</span><span class="s">)</span><span class="sc">;</span>
|
|
154 141 <span class="s">}</span>
|
|
155 142
|
|
156 143 <span class="i">$FingerprintsVector</span> = <span class="i">new</span> <span class="i">Fingerprints::FingerprintsVector</span><span class="s">(</span><span class="q">'Type'</span> <span class="cm">=></span> <span class="i">$Type</span><span class="cm">,</span> <span class="q">'Values'</span> <span class="cm">=></span> \<span class="i">@Values</span><span class="s">)</span><span class="sc">;</span>
|
|
157 144
|
|
158 145 <span class="k">return</span> <span class="i">$FingerprintsVector</span><span class="sc">;</span>
|
|
159 146 <span class="s">}</span>
|
|
160 147
|
|
161 148 <span class="c"># Create a new fingerprints vector using values and IDs string containing semicolon</span>
|
|
162 149 <span class="c"># delimited value string and value IDs strings. The values within value and value IDs</span>
|
|
163 150 <span class="c"># string are delimited by spaces.</span>
|
|
164 151 <span class="c">#</span>
|
|
165 152 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
166 153 <span class="c">#</span>
|
|
167 <a name="NewFromValuesAndIDsString-"></a> 154 <span class="k">sub </span><span class="m">NewFromValuesAndIDsString ($$;$)</span> <span class="s">{</span>
|
|
168 155 <span class="k">my</span><span class="s">(</span><span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="cm">,</span> <span class="i">$ThirdParamater</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
169 156 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$ValuesAndIDsString</span><span class="s">)</span><span class="sc">;</span>
|
|
170 157
|
|
171 158 <span class="k">if</span> <span class="s">(</span><span class="i">@_</span> == <span class="n">3</span><span class="s">)</span> <span class="s">{</span>
|
|
172 159 <span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$ValuesAndIDsString</span><span class="s">)</span> = <span class="s">(</span><span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="cm">,</span> <span class="i">$ThirdParamater</span><span class="s">)</span><span class="sc">;</span>
|
|
173 160 <span class="s">}</span>
|
|
174 161 <span class="k">else</span> <span class="s">{</span>
|
|
175 162 <span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$ValuesAndIDsString</span><span class="s">)</span> = <span class="s">(</span><span class="k">undef</span><span class="cm">,</span> <span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="s">)</span><span class="sc">;</span>
|
|
176 163 <span class="s">}</span>
|
|
177 164 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVector</span><span class="cm">,</span> <span class="i">$ValuesString</span><span class="cm">,</span> <span class="i">$ValueIDsString</span><span class="cm">,</span> <span class="i">@Values</span><span class="cm">,</span> <span class="i">@ValueIDs</span><span class="s">)</span><span class="sc">;</span>
|
|
178 165
|
|
179 166 <span class="s">(</span><span class="i">$ValuesString</span><span class="cm">,</span> <span class="i">$ValueIDsString</span><span class="s">)</span> = <span class="k">split</span><span class="s">(</span><span class="q">';'</span><span class="cm">,</span> <span class="i">$ValuesAndIDsString</span><span class="s">)</span><span class="sc">;</span>
|
|
180 167
|
|
181 168 <span class="i">@Values</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
182 169 <span class="k">if</span> <span class="s">(</span><span class="k">defined</span><span class="s">(</span><span class="i">$ValuesString</span><span class="s">)</span> && <span class="k">length</span><span class="s">(</span><span class="i">$ValuesString</span><span class="s">)</span> && <span class="i">$ValuesString</span> !~ <span class="q">/^None$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
183 170 <span class="i">@Values</span> = <span class="k">split</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">$ValuesString</span><span class="s">)</span><span class="sc">;</span>
|
|
184 171 <span class="s">}</span>
|
|
185 172 <span class="i">@ValueIDs</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
186 173 <span class="k">if</span> <span class="s">(</span><span class="k">defined</span><span class="s">(</span><span class="i">$ValueIDsString</span><span class="s">)</span> && <span class="k">length</span><span class="s">(</span><span class="i">$ValueIDsString</span><span class="s">)</span> && <span class="i">$ValueIDsString</span> !~ <span class="q">/^None$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
187 174 <span class="i">@ValueIDs</span> = <span class="k">split</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">$ValueIDsString</span><span class="s">)</span><span class="sc">;</span>
|
|
188 175 <span class="s">}</span>
|
|
189 176
|
|
190 177 <span class="k">if</span> <span class="s">(</span><span class="i">@Values</span> != <span class="i">@ValueIDs</span> <span class="s">)</span> <span class="s">{</span>
|
|
191 178 <span class="w">carp</span> <span class="q">"Warning: ${ClassName}->NewFromValuesAndIDsString: Object can't be instantiated: Number specified values, "</span> . <span class="k">scalar</span> <span class="i">@Values</span> . <span class="q">", must be equal to number of specified value IDs, "</span> . <span class="k">scalar</span> <span class="i">@ValueIDs</span> . <span class="q">"..."</span><span class="sc">;</span>
|
|
192 179 <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span>
|
|
193 180 <span class="s">}</span>
|
|
194 181
|
|
195 182 <span class="i">$FingerprintsVector</span> = <span class="i">new</span> <span class="i">Fingerprints::FingerprintsVector</span><span class="s">(</span><span class="q">'Type'</span> <span class="cm">=></span> <span class="i">$Type</span><span class="cm">,</span> <span class="q">'Values'</span> <span class="cm">=></span> \<span class="i">@Values</span><span class="cm">,</span> <span class="q">'ValueIDs'</span> <span class="cm">=></span> \<span class="i">@ValueIDs</span><span class="s">)</span><span class="sc">;</span>
|
|
196 183
|
|
197 184 <span class="k">return</span> <span class="i">$FingerprintsVector</span><span class="sc">;</span>
|
|
198 185 <span class="s">}</span>
|
|
199 186
|
|
200 187 <span class="c"># Create a new fingerprints vector using IDs and values string containing semicolon</span>
|
|
201 188 <span class="c"># delimited value IDs string and values strings. The values within value and value IDs</span>
|
|
202 189 <span class="c"># string are delimited by spaces.</span>
|
|
203 190 <span class="c">#</span>
|
|
204 191 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
205 192 <span class="c">#</span>
|
|
206 <a name="NewFromIDsAndValuesString-"></a> 193 <span class="k">sub </span><span class="m">NewFromIDsAndValuesString ($$;$)</span> <span class="s">{</span>
|
|
207 194 <span class="k">my</span><span class="s">(</span><span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="cm">,</span> <span class="i">$ThirdParamater</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
208 195 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$IDsAndValuesString</span><span class="s">)</span><span class="sc">;</span>
|
|
209 196
|
|
210 197 <span class="k">if</span> <span class="s">(</span><span class="i">@_</span> == <span class="n">3</span><span class="s">)</span> <span class="s">{</span>
|
|
211 198 <span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$IDsAndValuesString</span><span class="s">)</span> = <span class="s">(</span><span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="cm">,</span> <span class="i">$ThirdParamater</span><span class="s">)</span><span class="sc">;</span>
|
|
212 199 <span class="s">}</span>
|
|
213 200 <span class="k">else</span> <span class="s">{</span>
|
|
214 201 <span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$IDsAndValuesString</span><span class="s">)</span> = <span class="s">(</span><span class="k">undef</span><span class="cm">,</span> <span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="s">)</span><span class="sc">;</span>
|
|
215 202 <span class="s">}</span>
|
|
216 203 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVector</span><span class="cm">,</span> <span class="i">$ValuesString</span><span class="cm">,</span> <span class="i">$ValueIDsString</span><span class="cm">,</span> <span class="i">@Values</span><span class="cm">,</span> <span class="i">@ValueIDs</span><span class="s">)</span><span class="sc">;</span>
|
|
217 204
|
|
218 205 <span class="s">(</span><span class="i">$ValueIDsString</span><span class="cm">,</span> <span class="i">$ValuesString</span><span class="s">)</span> = <span class="k">split</span><span class="s">(</span><span class="q">';'</span><span class="cm">,</span> <span class="i">$IDsAndValuesString</span><span class="s">)</span><span class="sc">;</span>
|
|
219 206
|
|
220 207 <span class="i">@Values</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
221 208 <span class="k">if</span> <span class="s">(</span><span class="k">defined</span><span class="s">(</span><span class="i">$ValuesString</span><span class="s">)</span> && <span class="k">length</span><span class="s">(</span><span class="i">$ValuesString</span><span class="s">)</span> && <span class="i">$ValuesString</span> !~ <span class="q">/^None$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
222 209 <span class="i">@Values</span> = <span class="k">split</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">$ValuesString</span><span class="s">)</span><span class="sc">;</span>
|
|
223 210 <span class="s">}</span>
|
|
224 211 <span class="i">@ValueIDs</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
225 212 <span class="k">if</span> <span class="s">(</span><span class="k">defined</span><span class="s">(</span><span class="i">$ValueIDsString</span><span class="s">)</span> && <span class="k">length</span><span class="s">(</span><span class="i">$ValueIDsString</span><span class="s">)</span> && <span class="i">$ValueIDsString</span> !~ <span class="q">/^None$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
226 213 <span class="i">@ValueIDs</span> = <span class="k">split</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">$ValueIDsString</span><span class="s">)</span><span class="sc">;</span>
|
|
227 214 <span class="s">}</span>
|
|
228 215
|
|
229 216 <span class="k">if</span> <span class="s">(</span><span class="i">@Values</span> != <span class="i">@ValueIDs</span> <span class="s">)</span> <span class="s">{</span>
|
|
230 217 <span class="w">carp</span> <span class="q">"Warning: ${ClassName}->NewFromIDsAndValuesString: Object can't be instantiated: Number specified values, "</span> . <span class="k">scalar</span> <span class="i">@Values</span> . <span class="q">", must be equal to number of specified value IDs, "</span> . <span class="k">scalar</span> <span class="i">@ValueIDs</span> . <span class="q">"..."</span><span class="sc">;</span>
|
|
231 218 <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span>
|
|
232 219 <span class="s">}</span>
|
|
233 220
|
|
234 221 <span class="i">$FingerprintsVector</span> = <span class="i">new</span> <span class="i">Fingerprints::FingerprintsVector</span><span class="s">(</span><span class="q">'Type'</span> <span class="cm">=></span> <span class="i">$Type</span><span class="cm">,</span> <span class="q">'Values'</span> <span class="cm">=></span> \<span class="i">@Values</span><span class="cm">,</span> <span class="q">'ValueIDs'</span> <span class="cm">=></span> \<span class="i">@ValueIDs</span><span class="s">)</span><span class="sc">;</span>
|
|
235 222
|
|
236 223 <span class="k">return</span> <span class="i">$FingerprintsVector</span><span class="sc">;</span>
|
|
237 224 <span class="s">}</span>
|
|
238 225
|
|
239 226 <span class="c"># Create a new fingerprints vector using values and IDs pairs string containing space</span>
|
|
240 227 <span class="c"># value and value IDs pairs.</span>
|
|
241 228 <span class="c">#</span>
|
|
242 229 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
243 230 <span class="c">#</span>
|
|
244 <a name="NewFromValuesAndIDsPairsString-"></a> 231 <span class="k">sub </span><span class="m">NewFromValuesAndIDsPairsString ($$;$)</span> <span class="s">{</span>
|
|
245 232 <span class="k">my</span><span class="s">(</span><span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="cm">,</span> <span class="i">$ThirdParamater</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
246 233 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$ValuesAndIDsPairsString</span><span class="s">)</span><span class="sc">;</span>
|
|
247 234
|
|
248 235 <span class="k">if</span> <span class="s">(</span><span class="i">@_</span> == <span class="n">3</span><span class="s">)</span> <span class="s">{</span>
|
|
249 236 <span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$ValuesAndIDsPairsString</span><span class="s">)</span> = <span class="s">(</span><span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="cm">,</span> <span class="i">$ThirdParamater</span><span class="s">)</span><span class="sc">;</span>
|
|
250 237 <span class="s">}</span>
|
|
251 238 <span class="k">else</span> <span class="s">{</span>
|
|
252 239 <span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$ValuesAndIDsPairsString</span><span class="s">)</span> = <span class="s">(</span><span class="k">undef</span><span class="cm">,</span> <span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="s">)</span><span class="sc">;</span>
|
|
253 240 <span class="s">}</span>
|
|
254 241 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVector</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">@Values</span><span class="cm">,</span> <span class="i">@ValueIDs</span><span class="cm">,</span> <span class="i">@ValuesAndIDsPairs</span><span class="s">)</span><span class="sc">;</span>
|
|
255 242
|
|
256 243 <span class="i">@ValuesAndIDsPairs</span> = <span class="k">split</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">$ValuesAndIDsPairsString</span><span class="s">)</span><span class="sc">;</span>
|
|
257 244 <span class="k">if</span> <span class="s">(</span><span class="i">@ValuesAndIDsPairs</span> % <span class="n">2</span><span class="s">)</span> <span class="s">{</span>
|
|
258 245 <span class="w">carp</span> <span class="q">"Warning: ${ClassName}->NewFromValuesAndIDsPairsString: No fingerprint vector created: Invalid values and IDs pairs data: Input list must contain even number of values and IDs pairs..."</span><span class="sc">;</span>
|
|
259 246 <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span>
|
|
260 247 <span class="s">}</span>
|
|
261 248
|
|
262 249 <span class="i">@Values</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="i">@ValueIDs</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
263 250 <span class="k">if</span> <span class="s">(</span>!<span class="s">(</span><span class="i">@ValuesAndIDsPairs</span> == <span class="n">2</span> && <span class="i">$ValuesAndIDsPairs</span>[<span class="n">0</span>] =~ <span class="q">/^None$/i</span> && <span class="i">$ValuesAndIDsPairs</span>[<span class="n">1</span>] =~ <span class="q">/^None$/i</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
264 251 <span class="k">for</span> <span class="s">(</span><span class="i">$Index</span> = <span class="n">0</span><span class="sc">;</span> <span class="i">$Index</span> < <span class="i">$#ValuesAndIDsPairs</span><span class="sc">;</span> <span class="i">$Index</span> += <span class="n">2</span><span class="s">)</span> <span class="s">{</span>
|
|
265 252 <span class="k">push</span> <span class="i">@Values</span><span class="cm">,</span> <span class="i">$ValuesAndIDsPairs</span>[<span class="i">$Index</span>]<span class="sc">;</span>
|
|
266 253 <span class="k">push</span> <span class="i">@ValueIDs</span><span class="cm">,</span> <span class="i">$ValuesAndIDsPairs</span>[<span class="i">$Index</span> + <span class="n">1</span>]<span class="sc">;</span>
|
|
267 254 <span class="s">}</span>
|
|
268 255 <span class="s">}</span>
|
|
269 256 <span class="i">$FingerprintsVector</span> = <span class="i">new</span> <span class="i">Fingerprints::FingerprintsVector</span><span class="s">(</span><span class="q">'Type'</span> <span class="cm">=></span> <span class="i">$Type</span><span class="cm">,</span> <span class="q">'Values'</span> <span class="cm">=></span> \<span class="i">@Values</span><span class="cm">,</span> <span class="q">'ValueIDs'</span> <span class="cm">=></span> \<span class="i">@ValueIDs</span><span class="s">)</span><span class="sc">;</span>
|
|
270 257
|
|
271 258 <span class="k">return</span> <span class="i">$FingerprintsVector</span><span class="sc">;</span>
|
|
272 259 <span class="s">}</span>
|
|
273 260
|
|
274 261 <span class="c"># Create a new fingerprints vector using IDs and values pairs string containing space</span>
|
|
275 262 <span class="c"># value IDs and valus pairs.</span>
|
|
276 263 <span class="c">#</span>
|
|
277 264 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
278 265 <span class="c">#</span>
|
|
279 <a name="NewFromIDsAndValuesPairsString-"></a> 266 <span class="k">sub </span><span class="m">NewFromIDsAndValuesPairsString ($$;$)</span> <span class="s">{</span>
|
|
280 267 <span class="k">my</span><span class="s">(</span><span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="cm">,</span> <span class="i">$ThirdParamater</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
281 268 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$IDsAndValuesPairsString</span><span class="s">)</span><span class="sc">;</span>
|
|
282 269
|
|
283 270 <span class="k">if</span> <span class="s">(</span><span class="i">@_</span> == <span class="n">3</span><span class="s">)</span> <span class="s">{</span>
|
|
284 271 <span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$IDsAndValuesPairsString</span><span class="s">)</span> = <span class="s">(</span><span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="cm">,</span> <span class="i">$ThirdParamater</span><span class="s">)</span><span class="sc">;</span>
|
|
285 272 <span class="s">}</span>
|
|
286 273 <span class="k">else</span> <span class="s">{</span>
|
|
287 274 <span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="cm">,</span> <span class="i">$IDsAndValuesPairsString</span><span class="s">)</span> = <span class="s">(</span><span class="k">undef</span><span class="cm">,</span> <span class="i">$FirstParameter</span><span class="cm">,</span> <span class="i">$SecondParameter</span><span class="s">)</span><span class="sc">;</span>
|
|
288 275 <span class="s">}</span>
|
|
289 276 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVector</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">@Values</span><span class="cm">,</span> <span class="i">@ValueIDs</span><span class="cm">,</span> <span class="i">@IDsAndValuesPairs</span><span class="s">)</span><span class="sc">;</span>
|
|
290 277
|
|
291 278 <span class="i">@IDsAndValuesPairs</span> = <span class="k">split</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">$IDsAndValuesPairsString</span><span class="s">)</span><span class="sc">;</span>
|
|
292 279 <span class="k">if</span> <span class="s">(</span><span class="i">@IDsAndValuesPairs</span> % <span class="n">2</span><span class="s">)</span> <span class="s">{</span>
|
|
293 280 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->NewFromIDsAndValuesPairsString: No fingerprint vector created: Invalid values and IDs pairs data: Input list must contain even number of values and IDs pairs..."</span><span class="sc">;</span>
|
|
294 281 <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span>
|
|
295 282 <span class="s">}</span>
|
|
296 283
|
|
297 284 <span class="i">@Values</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="i">@ValueIDs</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
298 285 <span class="k">if</span> <span class="s">(</span>!<span class="s">(</span><span class="i">@IDsAndValuesPairs</span> == <span class="n">2</span> && <span class="i">$IDsAndValuesPairs</span>[<span class="n">0</span>] =~ <span class="q">/^None$/i</span> && <span class="i">$IDsAndValuesPairs</span>[<span class="n">1</span>] =~ <span class="q">/^None$/i</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
299 286 <span class="k">for</span> <span class="s">(</span><span class="i">$Index</span> = <span class="n">0</span><span class="sc">;</span> <span class="i">$Index</span> < <span class="i">$#IDsAndValuesPairs</span><span class="sc">;</span> <span class="i">$Index</span> += <span class="n">2</span><span class="s">)</span> <span class="s">{</span>
|
|
300 287 <span class="k">push</span> <span class="i">@ValueIDs</span><span class="cm">,</span> <span class="i">$IDsAndValuesPairs</span>[<span class="i">$Index</span>]<span class="sc">;</span>
|
|
301 288 <span class="k">push</span> <span class="i">@Values</span><span class="cm">,</span> <span class="i">$IDsAndValuesPairs</span>[<span class="i">$Index</span> + <span class="n">1</span>]<span class="sc">;</span>
|
|
302 289 <span class="s">}</span>
|
|
303 290 <span class="s">}</span>
|
|
304 291 <span class="i">$FingerprintsVector</span> = <span class="i">new</span> <span class="i">Fingerprints::FingerprintsVector</span><span class="s">(</span><span class="q">'Type'</span> <span class="cm">=></span> <span class="i">$Type</span><span class="cm">,</span> <span class="q">'Values'</span> <span class="cm">=></span> \<span class="i">@Values</span><span class="cm">,</span> <span class="q">'ValueIDs'</span> <span class="cm">=></span> \<span class="i">@ValueIDs</span><span class="s">)</span><span class="sc">;</span>
|
|
305 292
|
|
306 293 <span class="k">return</span> <span class="i">$FingerprintsVector</span><span class="sc">;</span>
|
|
307 294 <span class="s">}</span>
|
|
308 295
|
|
309 296 <span class="c"># Set type of fingerprint vector. Supported types are: OrderedNumericalValues, NumericalValues, and</span>
|
|
310 297 <span class="c"># AlphaNumericalValues</span>
|
|
311 298 <span class="c">#</span>
|
|
312 299 <span class="c"># . For OrderedNumericalValues type, both vectors must be of the same size and contain similar</span>
|
|
313 300 <span class="c"># types of numerical values in the same order.</span>
|
|
314 301 <span class="c">#</span>
|
|
315 302 <span class="c"># . For NumericalValues type, vector value IDs for both vectors must be specified; however, their</span>
|
|
316 303 <span class="c"># size and order of IDs and numerical values may be different. For each vector, value IDs must</span>
|
|
317 304 <span class="c"># correspond to vector values.</span>
|
|
318 305 <span class="c">#</span>
|
|
319 306 <span class="c"># . For AlphaNumericalValues type, vectors may contain both numerical and alphanumerical values</span>
|
|
320 307 <span class="c"># and their sizes may be different.</span>
|
|
321 308 <span class="c">#</span>
|
|
322 <a name="SetType-"></a> 309 <span class="k">sub </span><span class="m">SetType</span> <span class="s">{</span>
|
|
323 310 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Type</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
324 311
|
|
325 312 <span class="k">if</span> <span class="s">(</span><span class="i">$Type</span> !~ <span class="q">/^(OrderedNumericalValues|NumericalValues|AlphaNumericalValues)$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
326 313 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->SetType: Specified value, $Type, for Type is not vaild. Supported types in current release of MayaChemTools: OrderedNumericalValues, NumericalValues or AlphaNumericalValues"</span><span class="sc">;</span>
|
|
327 314 <span class="s">}</span>
|
|
328 315
|
|
329 316 <span class="k">if</span> <span class="s">(</span><span class="i">$This</span>->{<span class="w">Type</span>}<span class="s">)</span> <span class="s">{</span>
|
|
330 317 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->SetType: Can't change intial fingerprints vector type: It's already set..."</span><span class="sc">;</span>
|
|
331 318 <span class="s">}</span>
|
|
332 319 <span class="i">$This</span>->{<span class="w">Type</span>} = <span class="i">$Type</span><span class="sc">;</span>
|
|
333 320
|
|
334 321 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
335 322 <span class="s">}</span>
|
|
336 323
|
|
337 324 <span class="c"># Get fingerpints vector type...</span>
|
|
338 325 <span class="c">#</span>
|
|
339 <a name="GetType-"></a> 326 <span class="k">sub </span><span class="m">GetType</span> <span class="s">{</span>
|
|
340 327 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
341 328
|
|
342 329 <span class="k">return</span> <span class="i">$This</span>->{<span class="w">Type</span>}<span class="sc">;</span>
|
|
343 330 <span class="s">}</span>
|
|
344 331
|
|
345 332 <span class="c"># Set ID...</span>
|
|
346 <a name="SetID-"></a> 333 <span class="k">sub </span><span class="m">SetID</span> <span class="s">{</span>
|
|
347 334 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Value</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
348 335
|
|
349 336 <span class="i">$This</span>->{<span class="w">ID</span>} = <span class="i">$Value</span><span class="sc">;</span>
|
|
350 337
|
|
351 338 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
352 339 <span class="s">}</span>
|
|
353 340
|
|
354 341 <span class="c"># Get ID...</span>
|
|
355 <a name="GetID-"></a> 342 <span class="k">sub </span><span class="m">GetID</span> <span class="s">{</span>
|
|
356 343 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
357 344
|
|
358 345 <span class="k">return</span> <span class="k">exists</span> <span class="i">$This</span>->{<span class="w">ID</span>} ? <span class="i">$This</span>->{<span class="w">ID</span>} <span class="co">:</span> <span class="q">'None'</span><span class="sc">;</span>
|
|
359 346 <span class="s">}</span>
|
|
360 347
|
|
361 348 <span class="c"># Set description...</span>
|
|
362 <a name="SetDescription-"></a> 349 <span class="k">sub </span><span class="m">SetDescription</span> <span class="s">{</span>
|
|
363 350 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Value</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
364 351
|
|
365 352 <span class="i">$This</span>->{<span class="w">Description</span>} = <span class="i">$Value</span><span class="sc">;</span>
|
|
366 353
|
|
367 354 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
368 355 <span class="s">}</span>
|
|
369 356
|
|
370 357 <span class="c"># Get description...</span>
|
|
371 <a name="GetDescription-"></a> 358 <span class="k">sub </span><span class="m">GetDescription</span> <span class="s">{</span>
|
|
372 359 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
373 360
|
|
374 361 <span class="k">return</span> <span class="k">exists</span> <span class="i">$This</span>->{<span class="w">Description</span>} ? <span class="i">$This</span>->{<span class="w">Description</span>} <span class="co">:</span> <span class="q">'No description available'</span><span class="sc">;</span>
|
|
375 362 <span class="s">}</span>
|
|
376 363
|
|
377 364 <span class="c"># Set vector type...</span>
|
|
378 <a name="SetVectorType-"></a> 365 <span class="k">sub </span><span class="m">SetVectorType</span> <span class="s">{</span>
|
|
379 366 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Value</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
380 367
|
|
381 368 <span class="i">$This</span>->{<span class="w">VectorType</span>} = <span class="i">$Value</span><span class="sc">;</span>
|
|
382 369
|
|
383 370 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
384 371 <span class="s">}</span>
|
|
385 372
|
|
386 373 <span class="c"># Get vector type...</span>
|
|
387 <a name="GetVectorType-"></a> 374 <span class="k">sub </span><span class="m">GetVectorType</span> <span class="s">{</span>
|
|
388 375 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
389 376
|
|
390 377 <span class="k">return</span> <span class="k">exists</span> <span class="i">$This</span>->{<span class="w">VectorType</span>} ? <span class="i">$This</span>->{<span class="w">VectorType</span>} <span class="co">:</span> <span class="q">'FingerprintsVector'</span><span class="sc">;</span>
|
|
391 378 <span class="s">}</span>
|
|
392 379
|
|
393 380 <span class="c"># Set values of a fingerprint vector using a vector, reference to an array or an array...</span>
|
|
394 381 <span class="c">#</span>
|
|
395 <a name="SetValues-"></a> 382 <span class="k">sub </span><span class="m">SetValues</span> <span class="s">{</span>
|
|
396 383 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
397 384
|
|
398 385 <span class="i">$This</span><span class="i">->_SetOrAddValuesOrValueIDs</span><span class="s">(</span><span class="q">"SetValues"</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span><span class="sc">;</span>
|
|
399 386
|
|
400 387 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
401 388 <span class="s">}</span>
|
|
402 389
|
|
403 390 <span class="c"># Set value IDs of a fingerprint vector using a vector, reference to an array or an array...</span>
|
|
404 391 <span class="c">#</span>
|
|
405 <a name="SetValueIDs-"></a> 392 <span class="k">sub </span><span class="m">SetValueIDs</span> <span class="s">{</span>
|
|
406 393 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
407 394
|
|
408 395 <span class="i">$This</span><span class="i">->_SetOrAddValuesOrValueIDs</span><span class="s">(</span><span class="q">"SetValueIDs"</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span><span class="sc">;</span>
|
|
409 396
|
|
410 397 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
411 398 <span class="s">}</span>
|
|
412 399
|
|
413 400 <span class="c"># Add values to a fingerprint vector using a vector, reference to an array or an array...</span>
|
|
414 401 <span class="c">#</span>
|
|
415 <a name="AddValues-"></a> 402 <span class="k">sub </span><span class="m">AddValues</span> <span class="s">{</span>
|
|
416 403 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
417 404
|
|
418 405 <span class="i">$This</span><span class="i">->_SetOrAddValuesOrValueIDs</span><span class="s">(</span><span class="q">"AddValues"</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span><span class="sc">;</span>
|
|
419 406
|
|
420 407 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
421 408 <span class="s">}</span>
|
|
422 409
|
|
423 410 <span class="c"># Add value IDs to a fingerprint vector using a vector, reference to an array or an array...</span>
|
|
424 411 <span class="c">#</span>
|
|
425 <a name="AddValueIDs-"></a> 412 <span class="k">sub </span><span class="m">AddValueIDs</span> <span class="s">{</span>
|
|
426 413 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
427 414
|
|
428 415 <span class="i">$This</span><span class="i">->_SetOrAddValuesOrValueIDs</span><span class="s">(</span><span class="q">"AddValueIDs"</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span><span class="sc">;</span>
|
|
429 416
|
|
430 417 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
431 418 <span class="s">}</span>
|
|
432 419
|
|
433 420 <span class="c"># Set or add values or value IDs using:</span>
|
|
434 421 <span class="c">#</span>
|
|
435 422 <span class="c"># o List of values or ValueIDs</span>
|
|
436 423 <span class="c"># o Reference to an list of values or ValuesIDs</span>
|
|
437 424 <span class="c"># o A vector containing values or ValueIDs</span>
|
|
438 425 <span class="c">#</span>
|
|
439 <a name="_SetOrAddValuesOrValueIDs-"></a> 426 <span class="k">sub </span><span class="m">_SetOrAddValuesOrValueIDs</span> <span class="s">{</span>
|
|
440 427 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Mode</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
441 428
|
|
442 429 <span class="k">if</span> <span class="s">(</span>!<span class="i">@Values</span><span class="s">)</span> <span class="s">{</span>
|
|
443 430 <span class="k">return</span><span class="sc">;</span>
|
|
444 431 <span class="s">}</span>
|
|
445 432
|
|
446 433 <span class="c"># Collect specified values or valueIDs...</span>
|
|
447 434 <span class="k">my</span><span class="s">(</span><span class="i">$FirstValue</span><span class="cm">,</span> <span class="i">$TypeOfFirstValue</span><span class="cm">,</span> <span class="i">$ValuesRef</span><span class="s">)</span><span class="sc">;</span>
|
|
448 435
|
|
449 436 <span class="i">$FirstValue</span> = <span class="i">$Values</span>[<span class="n">0</span>]<span class="sc">;</span>
|
|
450 437 <span class="i">$TypeOfFirstValue</span> = <span class="k">ref</span> <span class="i">$FirstValue</span><span class="sc">;</span>
|
|
451 438 <span class="k">if</span> <span class="s">(</span><span class="i">$TypeOfFirstValue</span> =~ <span class="q">/^(SCALAR|HASH|CODE|REF|GLOB)/</span><span class="s">)</span> <span class="s">{</span>
|
|
452 439 <span class="w">croak</span> <span class="q">"Error: ${ClassName}-> _SetOrAddValuesOrValueIDs: Trying to add values to vector object with a reference to unsupported value format..."</span><span class="sc">;</span>
|
|
453 440 <span class="s">}</span>
|
|
454 441
|
|
455 442 <span class="k">if</span> <span class="s">(</span><span class="i">Vector::IsVector</span><span class="s">(</span><span class="i">$FirstValue</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
456 443 <span class="c"># It's a vector...</span>
|
|
457 444 <span class="i">$ValuesRef</span> = <span class="i">$FirstValue</span><span class="i">->GetValues</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
458 445 <span class="s">}</span>
|
|
459 446 <span class="k">elsif</span> <span class="s">(</span><span class="i">$TypeOfFirstValue</span> =~ <span class="q">/^ARRAY/</span><span class="s">)</span> <span class="s">{</span>
|
|
460 447 <span class="c"># It's an array refernce...</span>
|
|
461 448 <span class="i">$ValuesRef</span> = <span class="i">$FirstValue</span><span class="sc">;</span>
|
|
462 449 <span class="s">}</span>
|
|
463 450 <span class="k">else</span> <span class="s">{</span>
|
|
464 451 <span class="c"># It's a list of values...</span>
|
|
465 452 <span class="i">$ValuesRef</span> = \<span class="i">@Values</span><span class="sc">;</span>
|
|
466 453 <span class="s">}</span>
|
|
467 454
|
|
468 455 <span class="c"># Set or add values or value IDs...</span>
|
|
469 456 <span class="j">MODE:</span> <span class="s">{</span>
|
|
470 457 <span class="k">if</span> <span class="s">(</span><span class="i">$Mode</span> =~ <span class="q">/^SetValues$/i</span><span class="s">)</span> <span class="s">{</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}} = <span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="k">push</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="cm">,</span> <span class="i">@</span>{<span class="i">$ValuesRef</span>}<span class="sc">;</span> <span class="k">last</span> <span class="j">MODE</span><span class="sc">;</span> <span class="s">}</span>
|
|
471 458 <span class="k">if</span> <span class="s">(</span><span class="i">$Mode</span> =~ <span class="q">/^SetValueIDs$/i</span><span class="s">)</span> <span class="s">{</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}} = <span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="k">push</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}}<span class="cm">,</span> <span class="i">@</span>{<span class="i">$ValuesRef</span>}<span class="sc">;</span> <span class="k">last</span> <span class="j">MODE</span><span class="sc">;</span> <span class="s">}</span>
|
|
472 459 <span class="k">if</span> <span class="s">(</span><span class="i">$Mode</span> =~ <span class="q">/^AddValues$/i</span><span class="s">)</span> <span class="s">{</span> <span class="k">push</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="cm">,</span> <span class="i">@</span>{<span class="i">$ValuesRef</span>}<span class="sc">;</span> <span class="k">last</span> <span class="j">MODE</span><span class="sc">;</span> <span class="s">}</span>
|
|
473 460 <span class="k">if</span> <span class="s">(</span><span class="i">$Mode</span> =~ <span class="q">/^AddValueIDs$/i</span><span class="s">)</span> <span class="s">{</span> <span class="k">push</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}}<span class="cm">,</span> <span class="i">@</span>{<span class="i">$ValuesRef</span>}<span class="sc">;</span> <span class="k">last</span> <span class="j">MODE</span><span class="sc">;</span> <span class="s">}</span>
|
|
474 461 <span class="w">croak</span> <span class="q">"Error: ${ClassName}-> _SetOrAddValuesOrValueIDs: Unknown mode $Mode..."</span><span class="sc">;</span>
|
|
475 462 <span class="s">}</span>
|
|
476 463 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
477 464 <span class="s">}</span>
|
|
478 465
|
|
479 466 <span class="c"># Set a specific value in fingerprint vector with indicies starting from 0..</span>
|
|
480 467 <span class="c">#</span>
|
|
481 <a name="SetValue-"></a> 468 <span class="k">sub </span><span class="m">SetValue</span> <span class="s">{</span>
|
|
482 469 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">$Value</span><span class="cm">,</span> <span class="i">$SkipCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
483 470
|
|
484 471 <span class="c"># Just set it...</span>
|
|
485 472 <span class="k">if</span> <span class="s">(</span><span class="i">$SkipCheck</span><span class="s">)</span> <span class="s">{</span>
|
|
486 473 <span class="k">return</span> <span class="i">$This</span><span class="i">->_SetValue</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$Value</span><span class="s">)</span><span class="sc">;</span>
|
|
487 474 <span class="s">}</span>
|
|
488 475
|
|
489 476 <span class="c"># Check and set...</span>
|
|
490 477 <span class="k">if</span> <span class="s">(</span><span class="i">$Index</span> < <span class="n">0</span><span class="s">)</span> <span class="s">{</span>
|
|
491 478 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->SetValue: Index value must be a positive number..."</span><span class="sc">;</span>
|
|
492 479 <span class="s">}</span>
|
|
493 480 <span class="k">if</span> <span class="s">(</span><span class="i">$Index</span> >= <span class="i">$This</span><span class="i">->GetNumOfValues</span><span class="s">(</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
494 481 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->SetValue: Index vaue must be less than number of values..."</span><span class="sc">;</span>
|
|
495 482 <span class="s">}</span>
|
|
496 483
|
|
497 484 <span class="k">return</span> <span class="i">$This</span><span class="i">->_SetValue</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$Value</span><span class="s">)</span><span class="sc">;</span>
|
|
498 485 <span class="s">}</span>
|
|
499 486
|
|
500 487 <span class="c"># Set a fingerprint vector value...</span>
|
|
501 488 <span class="c">#</span>
|
|
502 <a name="_SetValue-"></a> 489 <span class="k">sub </span><span class="m">_SetValue</span> <span class="s">{</span>
|
|
503 490 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">$Value</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
504 491
|
|
505 492 <span class="i">$This</span>->{<span class="w">Values</span>}[<span class="i">$Index</span>] = <span class="i">$Value</span><span class="sc">;</span>
|
|
506 493
|
|
507 494 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
508 495 <span class="s">}</span>
|
|
509 496
|
|
510 497 <span class="c"># Get a specific value from fingerprint vector with indicies starting from 0...</span>
|
|
511 498 <span class="c">#</span>
|
|
512 <a name="GetValue-"></a> 499 <span class="k">sub </span><span class="m">GetValue</span> <span class="s">{</span>
|
|
513 500 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Index</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
514 501
|
|
515 502 <span class="k">if</span> <span class="s">(</span><span class="i">$Index</span> < <span class="n">0</span><span class="s">)</span> <span class="s">{</span>
|
|
516 503 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->GetValue: Index value must be a positive number..."</span><span class="sc">;</span>
|
|
517 504 <span class="s">}</span>
|
|
518 505 <span class="k">if</span> <span class="s">(</span><span class="i">$Index</span> >= <span class="i">$This</span><span class="i">->GetNumOfValues</span><span class="s">(</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
519 506 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->GetValue: Index value must be less than number of values..."</span><span class="sc">;</span>
|
|
520 507 <span class="s">}</span>
|
|
521 508 <span class="k">return</span> <span class="i">$This</span><span class="i">->_GetValue</span><span class="s">(</span><span class="i">$Index</span><span class="s">)</span><span class="sc">;</span>
|
|
522 509 <span class="s">}</span>
|
|
523 510
|
|
524 511 <span class="c"># Get a fingerprint vector value...</span>
|
|
525 <a name="_GetValue-"></a> 512 <span class="k">sub </span><span class="m">_GetValue</span> <span class="s">{</span>
|
|
526 513 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Index</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
527 514
|
|
528 515 <span class="k">return</span> <span class="i">$This</span>->{<span class="w">Values</span>}[<span class="i">$Index</span>]<span class="sc">;</span>
|
|
529 516 <span class="s">}</span>
|
|
530 517
|
|
531 518 <span class="c"># Return vector values as an array or reference to an array...</span>
|
|
532 519 <span class="c">#</span>
|
|
533 <a name="GetValues-"></a> 520 <span class="k">sub </span><span class="m">GetValues</span> <span class="s">{</span>
|
|
534 521 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
535 522
|
|
536 523 <span class="k">return</span> <span class="k">wantarray</span> ? <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}} <span class="co">:</span> \<span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="sc">;</span>
|
|
537 524 <span class="s">}</span>
|
|
538 525
|
|
539 526 <span class="c"># Set a specific value ID in fingerprint vector with indicies starting from 0..</span>
|
|
540 527 <span class="c">#</span>
|
|
541 <a name="SetValueID-"></a> 528 <span class="k">sub </span><span class="m">SetValueID</span> <span class="s">{</span>
|
|
542 529 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">$Value</span><span class="cm">,</span> <span class="i">$SkipCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
543 530
|
|
544 531 <span class="c"># Just set it...</span>
|
|
545 532 <span class="k">if</span> <span class="s">(</span><span class="i">$SkipCheck</span><span class="s">)</span> <span class="s">{</span>
|
|
546 533 <span class="k">return</span> <span class="i">$This</span><span class="i">->_SetValueID</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$Value</span><span class="s">)</span><span class="sc">;</span>
|
|
547 534 <span class="s">}</span>
|
|
548 535
|
|
549 536 <span class="c"># Check and set...</span>
|
|
550 537 <span class="k">if</span> <span class="s">(</span><span class="i">$Index</span> < <span class="n">0</span><span class="s">)</span> <span class="s">{</span>
|
|
551 538 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->SetValueID: Index value must be a positive number..."</span><span class="sc">;</span>
|
|
552 539 <span class="s">}</span>
|
|
553 540 <span class="k">if</span> <span class="s">(</span><span class="i">$Index</span> >= <span class="i">$This</span><span class="i">->GetNumOfValueIDs</span><span class="s">(</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
554 541 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->SetValueID: Index vaue must be less than number of value IDs..."</span><span class="sc">;</span>
|
|
555 542 <span class="s">}</span>
|
|
556 543
|
|
557 544 <span class="k">return</span> <span class="i">$This</span><span class="i">->_SetValueID</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$Value</span><span class="s">)</span><span class="sc">;</span>
|
|
558 545 <span class="s">}</span>
|
|
559 546
|
|
560 547 <span class="c"># Set a fingerprint vector value ID...</span>
|
|
561 548 <span class="c">#</span>
|
|
562 <a name="_SetValueID-"></a> 549 <span class="k">sub </span><span class="m">_SetValueID</span> <span class="s">{</span>
|
|
563 550 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">$Value</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
564 551
|
|
565 552 <span class="i">$This</span>->{<span class="w">ValueIDs</span>}[<span class="i">$Index</span>] = <span class="i">$Value</span><span class="sc">;</span>
|
|
566 553
|
|
567 554 <span class="k">return</span> <span class="i">$This</span><span class="sc">;</span>
|
|
568 555 <span class="s">}</span>
|
|
569 556
|
|
570 557 <span class="c"># Get a specific value ID from fingerprint vector with indicies starting from 0...</span>
|
|
571 558 <span class="c">#</span>
|
|
572 <a name="GetValueID-"></a> 559 <span class="k">sub </span><span class="m">GetValueID</span> <span class="s">{</span>
|
|
573 560 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Index</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
574 561
|
|
575 562 <span class="k">if</span> <span class="s">(</span><span class="i">$Index</span> < <span class="n">0</span><span class="s">)</span> <span class="s">{</span>
|
|
576 563 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->GetValueID: Index value must be a positive number..."</span><span class="sc">;</span>
|
|
577 564 <span class="s">}</span>
|
|
578 565 <span class="k">if</span> <span class="s">(</span><span class="i">$Index</span> >= <span class="i">$This</span><span class="i">->GetNumOfValueIDs</span><span class="s">(</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
579 566 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->GetValueID: Index value must be less than number of value IDs..."</span><span class="sc">;</span>
|
|
580 567 <span class="s">}</span>
|
|
581 568 <span class="k">return</span> <span class="i">$This</span><span class="i">->_GetValueID</span><span class="s">(</span><span class="i">$Index</span><span class="s">)</span><span class="sc">;</span>
|
|
582 569 <span class="s">}</span>
|
|
583 570
|
|
584 571 <span class="c"># Get a fingerprint vector value ID...</span>
|
|
585 572 <span class="c">#</span>
|
|
586 <a name="_GetValueID-"></a> 573 <span class="k">sub </span><span class="m">_GetValueID</span> <span class="s">{</span>
|
|
587 574 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Index</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
588 575
|
|
589 576 <span class="k">return</span> <span class="i">$This</span>->{<span class="w">ValueIDs</span>}[<span class="i">$Index</span>]<span class="sc">;</span>
|
|
590 577 <span class="s">}</span>
|
|
591 578
|
|
592 579 <span class="c"># Return vector value IDs as an array or reference to an array...</span>
|
|
593 580 <span class="c">#</span>
|
|
594 <a name="GetValueIDs-"></a> 581 <span class="k">sub </span><span class="m">GetValueIDs</span> <span class="s">{</span>
|
|
595 582 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
596 583
|
|
597 584 <span class="k">return</span> <span class="k">wantarray</span> ? <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}} <span class="co">:</span> \<span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}}<span class="sc">;</span>
|
|
598 585 <span class="s">}</span>
|
|
599 586
|
|
600 587 <span class="c"># Get fingerprints vector string containing values and/or IDs string in a specifed format...</span>
|
|
601 588 <span class="c">#</span>
|
|
602 <a name="GetFingerprintsVectorString-"></a> 589 <span class="k">sub </span><span class="m">GetFingerprintsVectorString</span> <span class="s">{</span>
|
|
603 590 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="cm">,</span> <span class="i">$Format</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
604 591
|
|
605 592 <span class="j">FORMAT :</span> <span class="s">{</span>
|
|
606 593 <span class="k">if</span> <span class="s">(</span><span class="i">$Format</span> =~ <span class="q">/^(IDsAndValuesString|IDsAndValues)$/i</span><span class="s">)</span> <span class="s">{</span> <span class="k">return</span> <span class="i">$This</span><span class="i">->GetIDsAndValuesString</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span> <span class="s">}</span>
|
|
607 594 <span class="k">if</span> <span class="s">(</span><span class="i">$Format</span> =~ <span class="q">/^(IDsAndValuesPairsString|IDsAndValuesPairs)$/i</span><span class="s">)</span> <span class="s">{</span> <span class="k">return</span> <span class="i">$This</span><span class="i">->GetIDsAndValuesPairsString</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span> <span class="s">}</span>
|
|
608 595 <span class="k">if</span> <span class="s">(</span><span class="i">$Format</span> =~ <span class="q">/^(ValuesAndIDsString|ValuesAndIDs)$/i</span><span class="s">)</span> <span class="s">{</span> <span class="k">return</span> <span class="i">$This</span><span class="i">->GetValuesAndIDsString</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span> <span class="s">}</span>
|
|
609 596 <span class="k">if</span> <span class="s">(</span><span class="i">$Format</span> =~ <span class="q">/^(ValuesAndIDsPairsString|ValuesAndIDsPairs)$/i</span><span class="s">)</span> <span class="s">{</span> <span class="k">return</span> <span class="i">$This</span><span class="i">->GetValuesAndIDsPairsString</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span><span class="s">}</span>
|
|
610 597 <span class="k">if</span> <span class="s">(</span><span class="i">$Format</span> =~ <span class="q">/^(ValueIDsString|ValueIDs)$/i</span><span class="s">)</span> <span class="s">{</span> <span class="k">return</span> <span class="i">$This</span><span class="i">->GetValueIDsString</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span> <span class="s">}</span>
|
|
611 598 <span class="k">if</span> <span class="s">(</span><span class="i">$Format</span> =~ <span class="q">/^(ValuesString|Values)$/i</span><span class="s">)</span> <span class="s">{</span> <span class="k">return</span> <span class="i">$This</span><span class="i">->GetValuesString</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span> <span class="s">}</span>
|
|
612 599 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->GetFingerprintsVectorString: Specified vector string format, $Format, is not supported. Value values: IDsAndValuesString, IDsAndValues, IDsAndValuesPairsString, IDsAndValuesPairs, ValuesAndIDsString, ValuesAndIDs, ValuesAndIDsPairsString, ValuesAndIDsPairs, ValueIDsString, ValueIDs, ValuesString, Values..."</span><span class="sc">;</span>
|
|
613 600 <span class="s">}</span>
|
|
614 601 <span class="k">return</span> <span class="q">''</span><span class="sc">;</span>
|
|
615 602 <span class="s">}</span>
|
|
616 603 <span class="c"># Get vector value IDs and values string as space delimited ASCII string separated</span>
|
|
617 604 <span class="c"># by semicolon...</span>
|
|
618 605 <span class="c">#</span>
|
|
619 <a name="GetIDsAndValuesString-"></a> 606 <span class="k">sub </span><span class="m">GetIDsAndValuesString</span> <span class="s">{</span>
|
|
620 607 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
621 608
|
|
622 609 <span class="k">if</span> <span class="s">(</span><span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}} && <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
623 610 <span class="c"># Both IDs and values are available...</span>
|
|
624 611 <span class="k">return</span> <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}}<span class="s">)</span> . <span class="q">";"</span> . <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span><span class="sc">;</span>
|
|
625 612 <span class="s">}</span>
|
|
626 613 <span class="k">elsif</span> <span class="s">(</span><span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
627 614 <span class="c"># Only values are available...</span>
|
|
628 615 <span class="k">return</span> <span class="q">"None;"</span> . <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span><span class="sc">;</span>
|
|
629 616 <span class="s">}</span>
|
|
630 617 <span class="k">else</span> <span class="s">{</span>
|
|
631 618 <span class="c"># Values are not available...</span>
|
|
632 619 <span class="k">return</span> <span class="q">"None;None"</span><span class="sc">;</span>
|
|
633 620 <span class="s">}</span>
|
|
634 621 <span class="s">}</span>
|
|
635 622
|
|
636 623 <span class="c"># Get vector value IDs and value pairs string as space delimited ASCII string...</span>
|
|
637 624 <span class="c">#</span>
|
|
638 <a name="GetIDsAndValuesPairsString-"></a> 625 <span class="k">sub </span><span class="m">GetIDsAndValuesPairsString</span> <span class="s">{</span>
|
|
639 626 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
640 627 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$ValueIDsPresent</span><span class="cm">,</span> <span class="i">@IDsAndValuesPairs</span><span class="s">)</span><span class="sc">;</span>
|
|
641 628
|
|
642 629 <span class="k">if</span> <span class="s">(</span>!<span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
643 630 <span class="c"># Values are unavailable...</span>
|
|
644 631 <span class="k">return</span> <span class="q">"None None"</span><span class="sc">;</span>
|
|
645 632 <span class="s">}</span>
|
|
646 633
|
|
647 634 <span class="i">$ValueIDsPresent</span> = <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}} ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
648 635
|
|
649 636 <span class="i">@IDsAndValuesPairs</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
650 637 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
651 638 <span class="k">if</span> <span class="s">(</span><span class="i">$ValueIDsPresent</span><span class="s">)</span> <span class="s">{</span>
|
|
652 639 <span class="k">push</span> <span class="i">@IDsAndValuesPairs</span><span class="cm">,</span> <span class="s">(</span><span class="i">$This</span>->{<span class="w">ValueIDs</span>}->[<span class="i">$Index</span>]<span class="cm">,</span> <span class="i">$This</span>->{<span class="w">Values</span>}->[<span class="i">$Index</span>]<span class="s">)</span><span class="sc">;</span>
|
|
653 640 <span class="s">}</span>
|
|
654 641 <span class="k">else</span> <span class="s">{</span>
|
|
655 642 <span class="k">push</span> <span class="i">@IDsAndValuesPairs</span><span class="cm">,</span> <span class="s">(</span><span class="q">'None'</span><span class="cm">,</span> <span class="i">$This</span>->{<span class="w">Values</span>}->[<span class="i">$Index</span>]<span class="s">)</span><span class="sc">;</span>
|
|
656 643 <span class="s">}</span>
|
|
657 644 <span class="s">}</span>
|
|
658 645 <span class="k">return</span> <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@IDsAndValuesPairs</span><span class="s">)</span><span class="sc">;</span>
|
|
659 646 <span class="s">}</span>
|
|
660 647
|
|
661 648 <span class="c"># Get vector value and value IDs string as space delimited ASCII string separated</span>
|
|
662 649 <span class="c"># by semicolon...</span>
|
|
663 650 <span class="c">#</span>
|
|
664 <a name="GetValuesAndIDsString-"></a> 651 <span class="k">sub </span><span class="m">GetValuesAndIDsString</span> <span class="s">{</span>
|
|
665 652 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
666 653
|
|
667 654 <span class="k">if</span> <span class="s">(</span><span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}} && <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
668 655 <span class="c"># Both IDs and values are available...</span>
|
|
669 656 <span class="k">return</span> <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span> . <span class="q">";"</span> . <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}}<span class="s">)</span><span class="sc">;</span>
|
|
670 657 <span class="s">}</span>
|
|
671 658 <span class="k">elsif</span> <span class="s">(</span><span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
672 659 <span class="c"># Only values are available...</span>
|
|
673 660 <span class="k">return</span> <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span> . <span class="q">";None"</span><span class="sc">;</span>
|
|
674 661 <span class="s">}</span>
|
|
675 662 <span class="k">else</span> <span class="s">{</span>
|
|
676 663 <span class="c"># Values are not available...</span>
|
|
677 664 <span class="k">return</span> <span class="q">"None;None"</span><span class="sc">;</span>
|
|
678 665 <span class="s">}</span>
|
|
679 666 <span class="s">}</span>
|
|
680 667
|
|
681 668 <span class="c"># Get vector value and value ID pairs string as space delimited ASCII string...</span>
|
|
682 669 <span class="c">#</span>
|
|
683 <a name="GetValuesAndIDsPairsString-"></a> 670 <span class="k">sub </span><span class="m">GetValuesAndIDsPairsString</span> <span class="s">{</span>
|
|
684 671 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
685 672 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$ValueIDsPresent</span><span class="cm">,</span> <span class="i">@ValuesAndIDsPairs</span><span class="s">)</span><span class="sc">;</span>
|
|
686 673
|
|
687 674 <span class="k">if</span> <span class="s">(</span>!<span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
688 675 <span class="c"># Values are unavailable...</span>
|
|
689 676 <span class="k">return</span> <span class="q">"None None"</span><span class="sc">;</span>
|
|
690 677 <span class="s">}</span>
|
|
691 678
|
|
692 679 <span class="i">$ValueIDsPresent</span> = <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}} ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
693 680
|
|
694 681 <span class="i">@ValuesAndIDsPairs</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
695 682 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
696 683 <span class="k">if</span> <span class="s">(</span><span class="i">$ValueIDsPresent</span><span class="s">)</span> <span class="s">{</span>
|
|
697 684 <span class="k">push</span> <span class="i">@ValuesAndIDsPairs</span><span class="cm">,</span> <span class="s">(</span><span class="i">$This</span>->{<span class="w">Values</span>}->[<span class="i">$Index</span>]<span class="cm">,</span> <span class="i">$This</span>->{<span class="w">ValueIDs</span>}->[<span class="i">$Index</span>]<span class="s">)</span><span class="sc">;</span>
|
|
698 685 <span class="s">}</span>
|
|
699 686 <span class="k">else</span> <span class="s">{</span>
|
|
700 687 <span class="k">push</span> <span class="i">@ValuesAndIDsPairs</span><span class="cm">,</span> <span class="s">(</span><span class="i">$This</span>->{<span class="w">Values</span>}->[<span class="i">$Index</span>]<span class="cm">,</span> <span class="q">'None'</span><span class="s">)</span><span class="sc">;</span>
|
|
701 688 <span class="s">}</span>
|
|
702 689 <span class="s">}</span>
|
|
703 690 <span class="k">return</span> <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@ValuesAndIDsPairs</span><span class="s">)</span><span class="sc">;</span>
|
|
704 691 <span class="s">}</span>
|
|
705 692
|
|
706 693 <span class="c"># Get vector value IDs string as space delimited ASCII string...</span>
|
|
707 694 <span class="c">#</span>
|
|
708 <a name="GetValueIDsString-"></a> 695 <span class="k">sub </span><span class="m">GetValueIDsString</span> <span class="s">{</span>
|
|
709 696 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
710 697
|
|
711 698 <span class="k">return</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}} ? <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}}<span class="s">)</span> <span class="co">:</span> <span class="q">'None'</span><span class="sc">;</span>
|
|
712 699 <span class="s">}</span>
|
|
713 700
|
|
714 701 <span class="c"># Get vector value string as space delimited ASCII string...</span>
|
|
715 702 <span class="c">#</span>
|
|
716 <a name="GetValuesString-"></a> 703 <span class="k">sub </span><span class="m">GetValuesString</span> <span class="s">{</span>
|
|
717 704 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
718 705
|
|
719 706 <span class="k">return</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}} ? <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="s">)</span> <span class="co">:</span> <span class="q">'None'</span><span class="sc">;</span>
|
|
720 707 <span class="s">}</span>
|
|
721 708
|
|
722 709 <span class="c"># Get number of values...</span>
|
|
723 <a name="GetNumOfValues-"></a> 710 <span class="k">sub </span><span class="m">GetNumOfValues</span> <span class="s">{</span>
|
|
724 711 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
725 712
|
|
726 713 <span class="k">return</span> <span class="k">scalar</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}}<span class="sc">;</span>
|
|
727 714 <span class="s">}</span>
|
|
728 715
|
|
729 716 <span class="c"># Get number of non-zero values...</span>
|
|
730 <a name="GetNumOfNonZeroValues-"></a> 717 <span class="k">sub </span><span class="m">GetNumOfNonZeroValues</span> <span class="s">{</span>
|
|
731 718 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
732 719 <span class="k">my</span><span class="s">(</span><span class="i">$Count</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">$Size</span><span class="s">)</span><span class="sc">;</span>
|
|
733 720
|
|
734 721 <span class="i">$Count</span> = <span class="n">0</span><span class="sc">;</span>
|
|
735 722 <span class="i">$Size</span> = <span class="i">$This</span><span class="i">->GetNumOfValues</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
736 723
|
|
737 724 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="s">(</span><span class="i">$Size</span> -<span class="n">1</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
738 725 <span class="k">if</span> <span class="s">(</span><span class="i">$This</span>->{<span class="w">Values</span>}[<span class="i">$Index</span>] != <span class="n">0</span><span class="s">)</span> <span class="s">{</span>
|
|
739 726 <span class="i">$Count</span>++<span class="sc">;</span>
|
|
740 727 <span class="s">}</span>
|
|
741 728 <span class="s">}</span>
|
|
742 729 <span class="k">return</span> <span class="i">$Count</span><span class="sc">;</span>
|
|
743 730 <span class="s">}</span>
|
|
744 731
|
|
745 732 <span class="c"># Get number of value IDs...</span>
|
|
746 <a name="GetNumOfValueIDs-"></a> 733 <span class="k">sub </span><span class="m">GetNumOfValueIDs</span> <span class="s">{</span>
|
|
747 734 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
748 735
|
|
749 736 <span class="k">return</span> <span class="k">scalar</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}}<span class="sc">;</span>
|
|
750 737 <span class="s">}</span>
|
|
751 738
|
|
752 739 <span class="c"># FinegerprintsVectors class provides methods to calculate similarity between vectors</span>
|
|
753 740 <span class="c"># containing three different types of values:</span>
|
|
754 741 <span class="c">#</span>
|
|
755 742 <span class="c"># Type I: OrderedNumericalValues</span>
|
|
756 743 <span class="c">#</span>
|
|
757 744 <span class="c"># . Size of two vectors are same</span>
|
|
758 745 <span class="c"># . Vectors contain real values in a specific order. For example: MACCS keys count, Topological</span>
|
|
759 746 <span class="c"># pharnacophore atom pairs and so on.</span>
|
|
760 747 <span class="c"># . Option to calculate similarity value using continious values or binary values</span>
|
|
761 748 <span class="c">#</span>
|
|
762 749 <span class="c"># Type II: UnorderedNumericalValues</span>
|
|
763 750 <span class="c">#</span>
|
|
764 751 <span class="c"># . Size of two vectors might not be same</span>
|
|
765 752 <span class="c"># . Vectors contain unordered real value identified by value IDs. For example: Toplogical atom pairs,</span>
|
|
766 753 <span class="c"># Topological atom torsions and so on</span>
|
|
767 754 <span class="c"># . Option to calculate similarity value using continous values or binary values</span>
|
|
768 755 <span class="c">#</span>
|
|
769 756 <span class="c"># Type III: AlphaNumericalValues</span>
|
|
770 757 <span class="c">#</span>
|
|
771 758 <span class="c"># . Size of two vectors might not be same</span>
|
|
772 759 <span class="c"># . Vectors contain unordered alphanumerical values. For example: Extended connectivity fingerprints,</span>
|
|
773 760 <span class="c"># atom neighbothood fingerpritns.</span>
|
|
774 761 <span class="c"># . The vector values are treated as keys or bit indices and similarity value is calculated accordingly.</span>
|
|
775 762 <span class="c">#</span>
|
|
776 763 <span class="c"># Before performing similarity or distance calculations between vectors containing UnorderedNumericalValues</span>
|
|
777 764 <span class="c"># or AlphaNumericalValues, the vectors are tranformed into vectors containing unique OrderedNumericalValues</span>
|
|
778 765 <span class="c"># using value IDs for UnorderedNumericalValues and values itself for AlphaNumericalValues.</span>
|
|
779 766 <span class="c">#</span>
|
|
780 767 <span class="c"># Three forms similarity or distance calculation between two vectors: AlgebraicForm, BinaryForm or</span>
|
|
781 768 <span class="c"># SetTheoreticForm.</span>
|
|
782 769 <span class="c">#</span>
|
|
783 770 <span class="c"># The value of an extra paramter, CalculationMode, passed to each similarity or distance function</span>
|
|
784 771 <span class="c"># controls the calculation. Supported values for CalculationMode: AlgebraicForm, BinaryForm and</span>
|
|
785 772 <span class="c"># SetTheoreticForm. Default: AlgebraicForm.</span>
|
|
786 773 <span class="c">#</span>
|
|
787 774 <span class="c"># For BinaryForm CalculationMode, the ordered list of processed final vector values containing the value or</span>
|
|
788 775 <span class="c"># count of each unique value type is simply converted into a binary vector containing 1s and 0s</span>
|
|
789 776 <span class="c"># corresponding to presence or absence of values before calculating similarity or distance between</span>
|
|
790 777 <span class="c"># two vectors.</span>
|
|
791 778 <span class="c">#</span>
|
|
792 779 <span class="c"># For two fingerprint vectors A and B of same size containing OrderedNumericalValues, let:</span>
|
|
793 780 <span class="c">#</span>
|
|
794 781 <span class="c"># N = Number values in A or B</span>
|
|
795 782 <span class="c">#</span>
|
|
796 783 <span class="c"># Xa = Values of vector A</span>
|
|
797 784 <span class="c"># Xb = Values of vector B</span>
|
|
798 785 <span class="c">#</span>
|
|
799 786 <span class="c"># Xai = Value of ith element in A</span>
|
|
800 787 <span class="c"># Xbi = Value of ith element in B</span>
|
|
801 788 <span class="c">#</span>
|
|
802 789 <span class="c"># SUM = Sum of i over N values</span>
|
|
803 790 <span class="c">#</span>
|
|
804 791 <span class="c"># For SetTheoreticForm of calculation between two vectors, let:</span>
|
|
805 792 <span class="c">#</span>
|
|
806 793 <span class="c"># SetIntersectionXaXb = SUM ( MIN ( Xai, Xbi ) )</span>
|
|
807 794 <span class="c"># SetDifferenceXaXb = SUM ( Xai ) + SUM ( Xbi ) - SUM ( MIN ( Xai, Xbi ) )</span>
|
|
808 795 <span class="c">#</span>
|
|
809 796 <span class="c"># For BinaryForm of calculation between two vectors, let:</span>
|
|
810 797 <span class="c">#</span>
|
|
811 798 <span class="c"># Na = Number of bits set to "1" in A = SUM ( Xai )</span>
|
|
812 799 <span class="c"># Nb = Number of bits set to "1" in B = SUM ( Xbi )</span>
|
|
813 800 <span class="c"># Nc = Number of bits set to "1" in both A and B = SUM ( Xai * Xbi )</span>
|
|
814 801 <span class="c"># Nd = Number of bits set to "0" in both A and B = SUM ( 1 - Xai - Xbi + Xai * Xbi)</span>
|
|
815 802 <span class="c">#</span>
|
|
816 803 <span class="c"># N = Number of bits set to "1" or "0" in A or B = Size of A or B = Na + Nb - Nc + Nd</span>
|
|
817 804 <span class="c">#</span>
|
|
818 805 <span class="c"># Additionally, for BinaryForm various values also correspond to:</span>
|
|
819 806 <span class="c">#</span>
|
|
820 807 <span class="c"># Na = | Xa |</span>
|
|
821 808 <span class="c"># Nb = | Xb |</span>
|
|
822 809 <span class="c"># Nc = | SetIntersectionXaXb |</span>
|
|
823 810 <span class="c"># Nd = N - | SetDifferenceXaXb |</span>
|
|
824 811 <span class="c">#</span>
|
|
825 812 <span class="c"># | SetDifferenceXaXb | = N - Nd = Na + Nb - Nc + Nd - Nd = Na + Nb - Nc</span>
|
|
826 813 <span class="c"># = | Xa | + | Xb | - | SetIntersectionXaXb |</span>
|
|
827 814 <span class="c">#</span>
|
|
828 815 <span class="c"># Various distance coefficients and similarity coefficients [ Ref 40, Ref 62, Ref 64 ] for a pair vectors A and B</span>
|
|
829 816 <span class="c"># in AlgebraicForm and BinaryForm are defined as follows:</span>
|
|
830 817 <span class="c">#</span>
|
|
831 818 <span class="c"># . CityBlockDistanceCoefficient: ( same as HammingDistanceCoefficient and ManhattanDistanceCoefficient)</span>
|
|
832 819 <span class="c">#</span>
|
|
833 820 <span class="c"># . AlgebraicForm: SUM ( ABS ( Xai - Xbi ) )</span>
|
|
834 821 <span class="c">#</span>
|
|
835 822 <span class="c"># . BinaryForm: ( Na - Nc ) + ( Nb - Nc ) = Na + Nb - 2 * Nc</span>
|
|
836 823 <span class="c">#</span>
|
|
837 824 <span class="c"># . SetTheoreticForm: | SetDifferenceXaXb | - | SetIntersectionXaXb |</span>
|
|
838 825 <span class="c"># = SUM ( Xai ) + SUM ( Xbi ) - 2 * ( SUM ( MIN ( Xai, Xbi ) ) )</span>
|
|
839 826 <span class="c">#</span>
|
|
840 827 <span class="c"># . CosineSimilarityCoefficient: ( same as OchiaiSimilarityCoefficient)</span>
|
|
841 828 <span class="c">#</span>
|
|
842 829 <span class="c"># . AlgebraicForm: SUM ( Xai * Xbi ) / SQRT ( SUM ( Xai ** 2) * SUM ( Xbi ** 2) )</span>
|
|
843 830 <span class="c">#</span>
|
|
844 831 <span class="c"># . BinaryForm: Nc / SQRT ( Na * Nb)</span>
|
|
845 832 <span class="c">#</span>
|
|
846 833 <span class="c"># . SetTheoreticForm: | SetIntersectionXaXb | / SQRT ( |Xa| * |Xb| )</span>
|
|
847 834 <span class="c"># = SUM ( MIN ( Xai, Xbi ) ) / SQRT ( SUM ( Xai ) * SUM ( Xbi ) )</span>
|
|
848 835 <span class="c">#</span>
|
|
849 836 <span class="c"># . CzekanowskiSimilarityCoefficient: ( same as DiceSimilarityCoefficient and SorensonSimilarityCoefficient)</span>
|
|
850 837 <span class="c">#</span>
|
|
851 838 <span class="c"># . AlgebraicForm: ( 2 * ( SUM ( Xai * Xbi ) ) ) / ( SUM ( Xai ** 2) + SUM ( Xbi **2 ) )</span>
|
|
852 839 <span class="c">#</span>
|
|
853 840 <span class="c"># . BinaryForm: 2 * Nc / ( Na + Nb )</span>
|
|
854 841 <span class="c">#</span>
|
|
855 842 <span class="c"># . SetTheoreticForm: 2 * | SetIntersectionXaXb | / ( |Xa| + |Xb| )</span>
|
|
856 843 <span class="c"># = 2 * ( SUM ( MIN ( Xai, Xbi ) ) ) / ( SUM ( Xai ) + SUM ( Xbi ) )</span>
|
|
857 844 <span class="c">#</span>
|
|
858 845 <span class="c"># . DiceSimilarityCoefficient: ( same as CzekanowskiSimilarityCoefficient and SorensonSimilarityCoefficient)</span>
|
|
859 846 <span class="c">#</span>
|
|
860 847 <span class="c"># . AlgebraicForm: ( 2 * ( SUM ( Xai * Xbi ) ) ) / ( SUM ( Xai ** 2) + SUM ( Xbi **2 ) )</span>
|
|
861 848 <span class="c">#</span>
|
|
862 849 <span class="c"># . BinaryForm: 2 * Nc / ( Na + Nb )</span>
|
|
863 850 <span class="c">#</span>
|
|
864 851 <span class="c"># . SetTheoreticForm: 2 * | SetIntersectionXaXb | / ( |Xa| + |Xb| )</span>
|
|
865 852 <span class="c"># = 2 * ( SUM ( MIN ( Xai, Xbi ) ) ) / ( SUM ( Xai ) + SUM ( Xbi ) )</span>
|
|
866 853 <span class="c">#</span>
|
|
867 854 <span class="c"># . EuclideanDistanceCoefficient:</span>
|
|
868 855 <span class="c">#</span>
|
|
869 856 <span class="c"># . AlgebraicForm: SQRT ( SUM ( ( ( Xai - Xbi ) ** 2 ) ) )</span>
|
|
870 857 <span class="c">#</span>
|
|
871 858 <span class="c"># . BinaryForm: SQRT ( ( Na - Nc ) + ( Nb - Nc ) ) = SQRT ( Na + Nb - 2 * Nc )</span>
|
|
872 859 <span class="c">#</span>
|
|
873 860 <span class="c"># . SetTheoreticForm: SQRT ( | SetDifferenceXaXb | - | SetIntersectionXaXb | )</span>
|
|
874 861 <span class="c"># = SQRT ( SUM ( Xai ) + SUM ( Xbi ) - 2 * ( SUM ( MIN ( Xai, Xbi ) ) ) )</span>
|
|
875 862 <span class="c">#</span>
|
|
876 863 <span class="c"># . HammingDistanceCoefficient: ( same as CityBlockDistanceCoefficient and ManhattanDistanceCoefficient)</span>
|
|
877 864 <span class="c">#</span>
|
|
878 865 <span class="c"># . AlgebraicForm: SUM ( ABS ( Xai - Xbi ) )</span>
|
|
879 866 <span class="c">#</span>
|
|
880 867 <span class="c"># . BinaryForm: ( Na - Nc ) + ( Nb - Nc ) = Na + Nb - 2 * Nc</span>
|
|
881 868 <span class="c">#</span>
|
|
882 869 <span class="c"># . SetTheoreticForm: | SetDifferenceXaXb | - | SetIntersectionXaXb |</span>
|
|
883 870 <span class="c"># = SUM ( Xai ) + SUM ( Xbi ) - 2 * ( SUM ( MIN ( Xai, Xbi ) ) )</span>
|
|
884 871 <span class="c">#</span>
|
|
885 872 <span class="c"># . JaccardSimilarityCoefficient: ( same as TanimotoSimilarityCoefficient)</span>
|
|
886 873 <span class="c">#</span>
|
|
887 874 <span class="c"># . AlgebraicForm: SUM ( Xai * Xbi ) / ( SUM ( Xai ** 2 ) + SUM ( Xbi ** 2 ) - SUM ( Xai * Xbi ) )</span>
|
|
888 875 <span class="c">#</span>
|
|
889 876 <span class="c"># . BinaryForm: Nc / ( ( Na - Nc ) + ( Nb - Nc ) + Nc ) = Nc / ( Na + Nb - Nc )</span>
|
|
890 877 <span class="c">#</span>
|
|
891 878 <span class="c"># . SetTheoreticForm: | SetIntersectionXaXb | / | SetDifferenceXaXb |</span>
|
|
892 879 <span class="c"># = SUM ( MIN ( Xai, Xbi ) ) / ( SUM ( Xai ) + SUM ( Xbi ) - SUM ( MIN ( Xai, Xbi ) ) )</span>
|
|
893 880 <span class="c">#</span>
|
|
894 881 <span class="c"># . ManhattanDistanceCoefficient: ( same as CityBlockDistanceCoefficient and HammingDistanceCoefficient)</span>
|
|
895 882 <span class="c">#</span>
|
|
896 883 <span class="c"># . AlgebraicForm: SUM ( ABS ( Xai - Xbi ) )</span>
|
|
897 884 <span class="c">#</span>
|
|
898 885 <span class="c"># . BinaryForm: ( Na - Nc ) + ( Nb - Nc ) = Na + Nb - 2 * Nc</span>
|
|
899 886 <span class="c">#</span>
|
|
900 887 <span class="c"># . SetTheoreticForm: | SetDifferenceXaXb | - | SetIntersectionXaXb |</span>
|
|
901 888 <span class="c"># = SUM ( Xai ) + SUM ( Xbi ) - 2 * ( SUM ( MIN ( Xai, Xbi ) ) )</span>
|
|
902 889 <span class="c">#</span>
|
|
903 890 <span class="c"># . OchiaiSimilarityCoefficient: ( same as CosineSimilarityCoefficient)</span>
|
|
904 891 <span class="c">#</span>
|
|
905 892 <span class="c"># . AlgebraicForm: SUM ( Xai * Xbi ) / SQRT ( SUM ( Xai ** 2) * SUM ( Xbi ** 2) )</span>
|
|
906 893 <span class="c">#</span>
|
|
907 894 <span class="c"># . BinaryForm: Nc / SQRT ( Na * Nb)</span>
|
|
908 895 <span class="c">#</span>
|
|
909 896 <span class="c"># . SetTheoreticForm: | SetIntersectionXaXb | / SQRT ( |Xa| * |Xb| )</span>
|
|
910 897 <span class="c"># = SUM ( MIN ( Xai, Xbi ) ) / SQRT ( SUM ( Xai ) * SUM ( Xbi ) )</span>
|
|
911 898 <span class="c">#</span>
|
|
912 899 <span class="c"># . SorensonSimilarityCoefficient: ( same as CzekanowskiSimilarityCoefficient and DiceSimilarityCoefficient)</span>
|
|
913 900 <span class="c">#</span>
|
|
914 901 <span class="c"># . AlgebraicForm: ( 2 * ( SUM ( Xai * Xbi ) ) ) / ( SUM ( Xai ** 2) + SUM ( Xbi **2 ) )</span>
|
|
915 902 <span class="c">#</span>
|
|
916 903 <span class="c"># . BinaryForm: 2 * Nc / ( Na + Nb )</span>
|
|
917 904 <span class="c">#</span>
|
|
918 905 <span class="c"># . SetTheoreticForm: 2 * | SetIntersectionXaXb | / ( |Xa| + |Xb| )</span>
|
|
919 906 <span class="c"># = 2 * ( SUM ( MIN ( Xai, Xbi ) ) ) / ( SUM ( Xai ) + SUM ( Xbi ) )</span>
|
|
920 907 <span class="c">#</span>
|
|
921 908 <span class="c"># . SoergelDistanceCoefficient:</span>
|
|
922 909 <span class="c">#</span>
|
|
923 910 <span class="c"># . AlgebraicForm: SUM ( ABS ( Xai - Xbi ) ) / SUM ( MAX ( Xai, Xbi ) )</span>
|
|
924 911 <span class="c">#</span>
|
|
925 912 <span class="c"># . BinaryForm: 1 - Nc / ( Na + Nb - Nc ) = ( Na + Nb - 2 * Nc ) / ( Na + Nb - Nc )</span>
|
|
926 913 <span class="c">#</span>
|
|
927 914 <span class="c"># . SetTheoreticForm: ( | SetDifferenceXaXb | - | SetIntersectionXaXb | ) / | SetDifferenceXaXb |</span>
|
|
928 915 <span class="c"># = ( SUM ( Xai ) + SUM ( Xbi ) - 2 * ( SUM ( MIN ( Xai, Xbi ) ) ) ) / ( SUM ( Xai ) + SUM ( Xbi ) - SUM ( MIN ( Xai, Xbi ) ) )</span>
|
|
929 916 <span class="c">#</span>
|
|
930 917 <span class="c"># . TanimotoSimilarityCoefficient: ( same as JaccardSimilarityCoefficient)</span>
|
|
931 918 <span class="c">#</span>
|
|
932 919 <span class="c"># . AlgebraicForm: SUM ( Xai * Xbi ) / ( SUM ( Xai ** 2 ) + SUM ( Xbi ** 2 ) - SUM ( Xai * Xbi ) )</span>
|
|
933 920 <span class="c">#</span>
|
|
934 921 <span class="c"># . BinaryForm: Nc / ( ( Na - Nc ) + ( Nb - Nc ) + Nc ) = Nc / ( Na + Nb - Nc )</span>
|
|
935 922 <span class="c">#</span>
|
|
936 923 <span class="c"># . SetTheoreticForm: | SetIntersectionXaXb | / | SetDifferenceXaXb |</span>
|
|
937 924 <span class="c"># = SUM ( MIN ( Xai, Xbi ) ) / ( SUM ( Xai ) + SUM ( Xbi ) - SUM ( MIN ( Xai, Xbi ) ) )</span>
|
|
938 925 <span class="c">#</span>
|
|
939 926 <span class="c">#</span>
|
|
940 927
|
|
941 928 <span class="c"># Calculate Hamming distance coefficient between two fingerprint vectors.</span>
|
|
942 929 <span class="c">#</span>
|
|
943 930 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
944 931 <span class="c">#</span>
|
|
945 <a name="HammingDistanceCoefficient-"></a> 932 <span class="k">sub </span><span class="m">HammingDistanceCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
946 933 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
947 934
|
|
948 935 <span class="k">return</span> <span class="i">CityBlockDistanceCoefficient</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
949 936 <span class="s">}</span>
|
|
950 937
|
|
951 938 <span class="c"># Calculate Hamming distance coefficient between two fingerprint vectors.</span>
|
|
952 939 <span class="c">#</span>
|
|
953 940 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
954 941 <span class="c">#</span>
|
|
955 <a name="ManhattanDistanceCoefficient-"></a> 942 <span class="k">sub </span><span class="m">ManhattanDistanceCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
956 943 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
957 944
|
|
958 945 <span class="k">return</span> <span class="i">CityBlockDistanceCoefficient</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
959 946 <span class="s">}</span>
|
|
960 947
|
|
961 948 <span class="c"># Calculate CityBlock distance coefficient between two fingerprint vectors.</span>
|
|
962 949 <span class="c">#</span>
|
|
963 950 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
964 951 <span class="c">#</span>
|
|
965 <a name="CityBlockDistanceCoefficient-"></a> 952 <span class="k">sub </span><span class="m">CityBlockDistanceCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
966 953 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
967 954
|
|
968 955 <span class="i">$CalculationMode</span> = <span class="k">defined</span> <span class="i">$CalculationMode</span> ? <span class="i">$CalculationMode</span> <span class="co">:</span> <span class="q">'AlgebraicForm'</span><span class="sc">;</span>
|
|
969 956 <span class="i">$SkipValuesCheck</span> = <span class="k">defined</span> <span class="i">$SkipValuesCheck</span> ? <span class="i">$SkipValuesCheck</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
970 957
|
|
971 958 <span class="c"># Validate and process fingerprints vectors for similarity calculations...</span>
|
|
972 959 <span class="c">#</span>
|
|
973 960 <span class="i">_ValidateAndProcessFingerprintsVectorsForSimilarityCalculation</span><span class="s">(</span><span class="q">"CityBlockDistanceCoefficient: Calculation failed"</span><span class="cm">,</span> <span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
974 961
|
|
975 962 <span class="c"># Perform the calculation...</span>
|
|
976 963 <span class="k">if</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^AlgebraicForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
977 964 <span class="k">return</span> <span class="i">_CityBlockDistanceCoefficientUsingAlgebraicForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
978 965 <span class="s">}</span>
|
|
979 966 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^BinaryForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
980 967 <span class="k">return</span> <span class="i">_CityBlockDistanceCoefficientUsingBinaryForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
981 968 <span class="s">}</span>
|
|
982 969 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^SetTheoreticForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
983 970 <span class="k">return</span> <span class="i">_CityBlockDistanceCoefficientUsingSetTheoreticForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
984 971 <span class="s">}</span>
|
|
985 972 <span class="k">else</span> <span class="s">{</span>
|
|
986 973 <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span>
|
|
987 974 <span class="s">}</span>
|
|
988 975 <span class="s">}</span>
|
|
989 976
|
|
990 977 <span class="c"># Calculate CityBlock distance coefficient using algebraic form...</span>
|
|
991 978 <span class="c">#</span>
|
|
992 <a name="_CityBlockDistanceCoefficientUsingAlgebraicForm-"></a> 979 <span class="k">sub </span><span class="m">_CityBlockDistanceCoefficientUsingAlgebraicForm</span> <span class="s">{</span>
|
|
993 980 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
994 981 <span class="k">my</span><span class="s">(</span><span class="i">$SumAbsSubtractionXaiXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
995 982
|
|
996 983 <span class="i">$SumAbsSubtractionXaiXbi</span> = <span class="i">_GetSumOfAbsoluteValueOfSubtractionOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
997 984
|
|
998 985 <span class="k">return</span> <span class="i">$SumAbsSubtractionXaiXbi</span><span class="sc">;</span>
|
|
999 986 <span class="s">}</span>
|
|
1000 987
|
|
1001 988 <span class="c"># Calculate CityBlock distance coefficient using binary form...</span>
|
|
1002 989 <span class="c">#</span>
|
|
1003 <a name="_CityBlockDistanceCoefficientUsingBinaryForm-"></a> 990 <span class="k">sub </span><span class="m">_CityBlockDistanceCoefficientUsingBinaryForm</span> <span class="s">{</span>
|
|
1004 991 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1005 992 <span class="k">my</span><span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="s">)</span><span class="sc">;</span>
|
|
1006 993
|
|
1007 994 <span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="s">)</span> = <span class="i">_GetNumOfIndividualAndCommonSetBits</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1008 995
|
|
1009 996 <span class="k">return</span> <span class="s">(</span><span class="i">$Na</span> + <span class="i">$Nb</span> - <span class="n">2</span> * <span class="i">$Nc</span><span class="s">)</span><span class="sc">;</span>
|
|
1010 997 <span class="s">}</span>
|
|
1011 998
|
|
1012 999 <span class="c"># Calculate CityBlock distance coefficient using set theoretic form...</span>
|
|
1013 1000 <span class="c">#</span>
|
|
1014 <a name="_CityBlockDistanceCoefficientUsingSetTheoreticForm-"></a>1001 <span class="k">sub </span><span class="m">_CityBlockDistanceCoefficientUsingSetTheoreticForm</span> <span class="s">{</span>
|
|
1015 1002 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1016 1003 <span class="k">my</span><span class="s">(</span><span class="i">$SumMinXaiXbi</span><span class="cm">,</span> <span class="i">$SumXai</span><span class="cm">,</span> <span class="i">$SumXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
1017 1004
|
|
1018 1005 <span class="i">$SumXai</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="s">)</span><span class="sc">;</span>
|
|
1019 1006 <span class="i">$SumXbi</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1020 1007 <span class="i">$SumMinXaiXbi</span> = <span class="i">_GetSumOfMinimumOfFingerprintsOrderdedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1021 1008
|
|
1022 1009 <span class="k">return</span> <span class="s">(</span><span class="i">$SumXai</span> + <span class="i">$SumXbi</span> - <span class="n">2</span> * <span class="i">$SumMinXaiXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
1023 1010 <span class="s">}</span>
|
|
1024 1011
|
|
1025 1012 <span class="c"># Calculate Ochiai similarity cofficient between two fingerprint vectors.</span>
|
|
1026 1013 <span class="c">#</span>
|
|
1027 1014 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
1028 1015 <span class="c">#</span>
|
|
1029 <a name="OchiaiSimilarityCoefficient-"></a>1016 <span class="k">sub </span><span class="m">OchiaiSimilarityCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
1030 1017 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1031 1018
|
|
1032 1019 <span class="k">return</span> <span class="i">CosineSimilarityCoefficient</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1033 1020 <span class="s">}</span>
|
|
1034 1021
|
|
1035 1022 <span class="c"># Calculate Cosine similarity cofficient between two fingerprint vectors.</span>
|
|
1036 1023 <span class="c">#</span>
|
|
1037 1024 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
1038 1025 <span class="c">#</span>
|
|
1039 <a name="CosineSimilarityCoefficient-"></a>1026 <span class="k">sub </span><span class="m">CosineSimilarityCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
1040 1027 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1041 1028
|
|
1042 1029 <span class="i">$CalculationMode</span> = <span class="k">defined</span> <span class="i">$CalculationMode</span> ? <span class="i">$CalculationMode</span> <span class="co">:</span> <span class="q">'AlgebraicForm'</span><span class="sc">;</span>
|
|
1043 1030 <span class="i">$SkipValuesCheck</span> = <span class="k">defined</span> <span class="i">$SkipValuesCheck</span> ? <span class="i">$SkipValuesCheck</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1044 1031
|
|
1045 1032 <span class="c"># Validate and process fingerprints vectors for similarity calculations...</span>
|
|
1046 1033 <span class="c">#</span>
|
|
1047 1034 <span class="i">_ValidateAndProcessFingerprintsVectorsForSimilarityCalculation</span><span class="s">(</span><span class="q">"CosineSimilarityCoefficient: Calculation failed"</span><span class="cm">,</span> <span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1048 1035
|
|
1049 1036 <span class="c"># Perform the calculation...</span>
|
|
1050 1037 <span class="k">if</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^AlgebraicForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1051 1038 <span class="k">return</span> <span class="i">_CosineSimilarityCoefficientUsingAlgebraicForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1052 1039 <span class="s">}</span>
|
|
1053 1040 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^BinaryForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1054 1041 <span class="k">return</span> <span class="i">_CosineSimilarityCoefficientUsingBinaryForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1055 1042 <span class="s">}</span>
|
|
1056 1043 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^SetTheoreticForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1057 1044 <span class="k">return</span> <span class="i">_CosineSimilarityCoefficientUsingSetTheoreticForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1058 1045 <span class="s">}</span>
|
|
1059 1046 <span class="k">else</span> <span class="s">{</span>
|
|
1060 1047 <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span>
|
|
1061 1048 <span class="s">}</span>
|
|
1062 1049 <span class="s">}</span>
|
|
1063 1050
|
|
1064 1051 <span class="c"># Calculate Cosine similarity coefficient using algebraic form...</span>
|
|
1065 1052 <span class="c">#</span>
|
|
1066 <a name="_CosineSimilarityCoefficientUsingAlgebraicForm-"></a>1053 <span class="k">sub </span><span class="m">_CosineSimilarityCoefficientUsingAlgebraicForm</span> <span class="s">{</span>
|
|
1067 1054 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1068 1055 <span class="k">my</span><span class="s">(</span><span class="i">$SumProductXaiXbi</span><span class="cm">,</span> <span class="i">$SumXai2</span><span class="cm">,</span> <span class="i">$SumXbi2</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1069 1056
|
|
1070 1057 <span class="i">$SumXai2</span> = <span class="i">_GetSumOfSquaresOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="s">)</span><span class="sc">;</span>
|
|
1071 1058 <span class="i">$SumXbi2</span> = <span class="i">_GetSumOfSquaresOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1072 1059 <span class="i">$SumProductXaiXbi</span> = <span class="i">_GetSumOfProductOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1073 1060
|
|
1074 1061 <span class="i">$Numerator</span> = <span class="i">$SumProductXaiXbi</span><span class="sc">;</span>
|
|
1075 1062 <span class="i">$Denominator</span> = <span class="k">sqrt</span><span class="s">(</span><span class="i">$SumXai2</span> * <span class="i">$SumXbi2</span><span class="s">)</span><span class="sc">;</span>
|
|
1076 1063
|
|
1077 1064 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1078 1065 <span class="s">}</span>
|
|
1079 1066
|
|
1080 1067 <span class="c"># CalculateCosine similarity coefficient using binary form...</span>
|
|
1081 1068 <span class="c">#</span>
|
|
1082 <a name="_CosineSimilarityCoefficientUsingBinaryForm-"></a>1069 <span class="k">sub </span><span class="m">_CosineSimilarityCoefficientUsingBinaryForm</span> <span class="s">{</span>
|
|
1083 1070 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1084 1071 <span class="k">my</span><span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1085 1072
|
|
1086 1073 <span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="s">)</span> = <span class="i">_GetNumOfIndividualAndCommonSetBits</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1087 1074
|
|
1088 1075 <span class="i">$Numerator</span> = <span class="i">$Nc</span><span class="sc">;</span>
|
|
1089 1076 <span class="i">$Denominator</span> = <span class="k">sqrt</span><span class="s">(</span><span class="i">$Na</span> * <span class="i">$Nb</span><span class="s">)</span><span class="sc">;</span>
|
|
1090 1077
|
|
1091 1078 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1092 1079 <span class="s">}</span>
|
|
1093 1080
|
|
1094 1081 <span class="c"># Calculate Cosine similarity coefficient using set theoretic form...</span>
|
|
1095 1082 <span class="c">#</span>
|
|
1096 <a name="_CosineSimilarityCoefficientUsingSetTheoreticForm-"></a>1083 <span class="k">sub </span><span class="m">_CosineSimilarityCoefficientUsingSetTheoreticForm</span> <span class="s">{</span>
|
|
1097 1084 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1098 1085 <span class="k">my</span><span class="s">(</span><span class="i">$SumMinXaiXbi</span><span class="cm">,</span> <span class="i">$SumXai</span><span class="cm">,</span> <span class="i">$SumXbi</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1099 1086
|
|
1100 1087 <span class="i">$SumXai</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="s">)</span><span class="sc">;</span>
|
|
1101 1088 <span class="i">$SumXbi</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1102 1089 <span class="i">$SumMinXaiXbi</span> = <span class="i">_GetSumOfMinimumOfFingerprintsOrderdedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1103 1090
|
|
1104 1091 <span class="i">$Numerator</span> = <span class="i">$SumMinXaiXbi</span><span class="sc">;</span>
|
|
1105 1092 <span class="i">$Denominator</span> = <span class="k">sqrt</span><span class="s">(</span><span class="i">$SumXai</span> * <span class="i">$SumXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
1106 1093
|
|
1107 1094 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1108 1095 <span class="s">}</span>
|
|
1109 1096
|
|
1110 1097 <span class="c"># Calculate Czekanowski similarity cofficient between two fingerprint vectors.</span>
|
|
1111 1098 <span class="c">#</span>
|
|
1112 1099 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
1113 1100 <span class="c">#</span>
|
|
1114 <a name="CzekanowskiSimilarityCoefficient-"></a>1101 <span class="k">sub </span><span class="m">CzekanowskiSimilarityCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
1115 1102 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1116 1103
|
|
1117 1104 <span class="k">return</span> <span class="i">DiceSimilarityCoefficient</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1118 1105 <span class="s">}</span>
|
|
1119 1106
|
|
1120 1107 <span class="c"># Calculate Sorenson similarity cofficient between two fingerprint vectors.</span>
|
|
1121 1108 <span class="c">#</span>
|
|
1122 1109 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
1123 1110 <span class="c">#</span>
|
|
1124 <a name="SorensonSimilarityCoefficient-"></a>1111 <span class="k">sub </span><span class="m">SorensonSimilarityCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
1125 1112 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1126 1113
|
|
1127 1114 <span class="k">return</span> <span class="i">DiceSimilarityCoefficient</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1128 1115 <span class="s">}</span>
|
|
1129 1116
|
|
1130 1117 <span class="c"># Calculate Dice similarity cofficient between two fingerprint vectors.</span>
|
|
1131 1118 <span class="c">#</span>
|
|
1132 1119 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
1133 1120 <span class="c">#</span>
|
|
1134 <a name="DiceSimilarityCoefficient-"></a>1121 <span class="k">sub </span><span class="m">DiceSimilarityCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
1135 1122 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1136 1123
|
|
1137 1124 <span class="i">$CalculationMode</span> = <span class="k">defined</span> <span class="i">$CalculationMode</span> ? <span class="i">$CalculationMode</span> <span class="co">:</span> <span class="q">'AlgebraicForm'</span><span class="sc">;</span>
|
|
1138 1125 <span class="i">$SkipValuesCheck</span> = <span class="k">defined</span> <span class="i">$SkipValuesCheck</span> ? <span class="i">$SkipValuesCheck</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1139 1126
|
|
1140 1127 <span class="c"># Validate and process fingerprints vectors for similarity calculations...</span>
|
|
1141 1128 <span class="c">#</span>
|
|
1142 1129 <span class="i">_ValidateAndProcessFingerprintsVectorsForSimilarityCalculation</span><span class="s">(</span><span class="q">"DiceSimilarityCoefficient: Calculation failed"</span><span class="cm">,</span> <span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1143 1130
|
|
1144 1131 <span class="c"># Perform the calculation...</span>
|
|
1145 1132 <span class="k">if</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^AlgebraicForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1146 1133 <span class="k">return</span> <span class="i">_DiceSimilarityCoefficientUsingAlgebraicForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1147 1134 <span class="s">}</span>
|
|
1148 1135 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^BinaryForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1149 1136 <span class="k">return</span> <span class="i">_DiceSimilarityCoefficientUsingBinaryForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1150 1137 <span class="s">}</span>
|
|
1151 1138 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^SetTheoreticForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1152 1139 <span class="k">return</span> <span class="i">_DiceSimilarityCoefficientUsingSetTheoreticForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1153 1140 <span class="s">}</span>
|
|
1154 1141 <span class="k">else</span> <span class="s">{</span>
|
|
1155 1142 <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span>
|
|
1156 1143 <span class="s">}</span>
|
|
1157 1144 <span class="s">}</span>
|
|
1158 1145
|
|
1159 1146 <span class="c"># Calculate Dice similarity coefficient using algebraic form...</span>
|
|
1160 1147 <span class="c">#</span>
|
|
1161 <a name="_DiceSimilarityCoefficientUsingAlgebraicForm-"></a>1148 <span class="k">sub </span><span class="m">_DiceSimilarityCoefficientUsingAlgebraicForm</span> <span class="s">{</span>
|
|
1162 1149 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1163 1150 <span class="k">my</span><span class="s">(</span><span class="i">$SumProductXaiXbi</span><span class="cm">,</span> <span class="i">$SumXai2</span><span class="cm">,</span> <span class="i">$SumXbi2</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1164 1151
|
|
1165 1152 <span class="i">$SumXai2</span> = <span class="i">_GetSumOfSquaresOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="s">)</span><span class="sc">;</span>
|
|
1166 1153 <span class="i">$SumXbi2</span> = <span class="i">_GetSumOfSquaresOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1167 1154 <span class="i">$SumProductXaiXbi</span> = <span class="i">_GetSumOfProductOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1168 1155
|
|
1169 1156 <span class="i">$Numerator</span> = <span class="n">2</span> * <span class="i">$SumProductXaiXbi</span><span class="sc">;</span>
|
|
1170 1157 <span class="i">$Denominator</span> = <span class="i">$SumXai2</span> + <span class="i">$SumXbi2</span><span class="sc">;</span>
|
|
1171 1158
|
|
1172 1159 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1173 1160 <span class="s">}</span>
|
|
1174 1161
|
|
1175 1162 <span class="c"># Calculate Dice similarity coefficient using binary form...</span>
|
|
1176 1163 <span class="c">#</span>
|
|
1177 <a name="_DiceSimilarityCoefficientUsingBinaryForm-"></a>1164 <span class="k">sub </span><span class="m">_DiceSimilarityCoefficientUsingBinaryForm</span> <span class="s">{</span>
|
|
1178 1165 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1179 1166 <span class="k">my</span><span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1180 1167
|
|
1181 1168 <span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="s">)</span> = <span class="i">_GetNumOfIndividualAndCommonSetBits</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1182 1169
|
|
1183 1170 <span class="i">$Numerator</span> = <span class="n">2</span> * <span class="i">$Nc</span><span class="sc">;</span>
|
|
1184 1171 <span class="i">$Denominator</span> = <span class="i">$Na</span> + <span class="i">$Nb</span><span class="sc">;</span>
|
|
1185 1172
|
|
1186 1173 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1187 1174 <span class="s">}</span>
|
|
1188 1175
|
|
1189 1176 <span class="c"># Calculate Dice similarity coefficient using set theoretic form...</span>
|
|
1190 1177 <span class="c">#</span>
|
|
1191 <a name="_DiceSimilarityCoefficientUsingSetTheoreticForm-"></a>1178 <span class="k">sub </span><span class="m">_DiceSimilarityCoefficientUsingSetTheoreticForm</span> <span class="s">{</span>
|
|
1192 1179 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1193 1180 <span class="k">my</span><span class="s">(</span><span class="i">$SumMinXaiXbi</span><span class="cm">,</span> <span class="i">$SumXai</span><span class="cm">,</span> <span class="i">$SumXbi</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1194 1181
|
|
1195 1182 <span class="i">$SumXai</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="s">)</span><span class="sc">;</span>
|
|
1196 1183 <span class="i">$SumXbi</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1197 1184 <span class="i">$SumMinXaiXbi</span> = <span class="i">_GetSumOfMinimumOfFingerprintsOrderdedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1198 1185
|
|
1199 1186 <span class="i">$Numerator</span> = <span class="n">2</span> * <span class="i">$SumMinXaiXbi</span><span class="sc">;</span>
|
|
1200 1187 <span class="i">$Denominator</span> = <span class="i">$SumXai</span> + <span class="i">$SumXbi</span><span class="sc">;</span>
|
|
1201 1188
|
|
1202 1189 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1203 1190 <span class="s">}</span>
|
|
1204 1191
|
|
1205 1192
|
|
1206 1193 <span class="c"># Calculate Euclidean distance coefficient between two fingerprint vectors.</span>
|
|
1207 1194 <span class="c">#</span>
|
|
1208 1195 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
1209 1196 <span class="c">#</span>
|
|
1210 <a name="EuclideanDistanceCoefficient-"></a>1197 <span class="k">sub </span><span class="m">EuclideanDistanceCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
1211 1198 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1212 1199
|
|
1213 1200 <span class="i">$CalculationMode</span> = <span class="k">defined</span> <span class="i">$CalculationMode</span> ? <span class="i">$CalculationMode</span> <span class="co">:</span> <span class="q">'AlgebraicForm'</span><span class="sc">;</span>
|
|
1214 1201 <span class="i">$SkipValuesCheck</span> = <span class="k">defined</span> <span class="i">$SkipValuesCheck</span> ? <span class="i">$SkipValuesCheck</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1215 1202
|
|
1216 1203 <span class="c"># Validate and process fingerprints vectors for similarity calculations...</span>
|
|
1217 1204 <span class="c">#</span>
|
|
1218 1205 <span class="i">_ValidateAndProcessFingerprintsVectorsForSimilarityCalculation</span><span class="s">(</span><span class="q">"EuclideanDistanceCoefficient: Calculation failed"</span><span class="cm">,</span> <span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1219 1206
|
|
1220 1207 <span class="c"># Perform the calculation...</span>
|
|
1221 1208 <span class="k">if</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^AlgebraicForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1222 1209 <span class="k">return</span> <span class="i">_EuclideanDistanceCoefficientUsingAlgebraicForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1223 1210 <span class="s">}</span>
|
|
1224 1211 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^BinaryForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1225 1212 <span class="k">return</span> <span class="i">_EuclideanDistanceCoefficientUsingBinaryForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1226 1213 <span class="s">}</span>
|
|
1227 1214 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^SetTheoreticForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1228 1215 <span class="k">return</span> <span class="i">_EuclideanDistanceCoefficientUsingSetTheoreticForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1229 1216 <span class="s">}</span>
|
|
1230 1217 <span class="k">else</span> <span class="s">{</span>
|
|
1231 1218 <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span>
|
|
1232 1219 <span class="s">}</span>
|
|
1233 1220 <span class="s">}</span>
|
|
1234 1221
|
|
1235 1222 <span class="c"># Calculate Euclidean distance coefficient using algebraic form...</span>
|
|
1236 1223 <span class="c">#</span>
|
|
1237 <a name="_EuclideanDistanceCoefficientUsingAlgebraicForm-"></a>1224 <span class="k">sub </span><span class="m">_EuclideanDistanceCoefficientUsingAlgebraicForm</span> <span class="s">{</span>
|
|
1238 1225 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1239 1226 <span class="k">my</span><span class="s">(</span><span class="i">$SumSquaresSubtractionXaiXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
1240 1227
|
|
1241 1228 <span class="i">$SumSquaresSubtractionXaiXbi</span> = <span class="i">_GetSumOfSquaresOfSubtractionOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1242 1229
|
|
1243 1230 <span class="k">return</span> <span class="k">sqrt</span><span class="s">(</span><span class="i">$SumSquaresSubtractionXaiXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
1244 1231 <span class="s">}</span>
|
|
1245 1232
|
|
1246 1233 <span class="c"># Calculate Euclidean distance coefficient using binary form...</span>
|
|
1247 1234 <span class="c">#</span>
|
|
1248 <a name="_EuclideanDistanceCoefficientUsingBinaryForm-"></a>1235 <span class="k">sub </span><span class="m">_EuclideanDistanceCoefficientUsingBinaryForm</span> <span class="s">{</span>
|
|
1249 1236 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1250 1237 <span class="k">my</span><span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="s">)</span><span class="sc">;</span>
|
|
1251 1238
|
|
1252 1239 <span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="s">)</span> = <span class="i">_GetNumOfIndividualAndCommonSetBits</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1253 1240
|
|
1254 1241 <span class="k">return</span> <span class="s">(</span><span class="k">sqrt</span><span class="s">(</span><span class="i">$Na</span> + <span class="i">$Nb</span> - <span class="n">2</span> * <span class="i">$Nc</span><span class="s">)</span><span class="s">)</span><span class="sc">;</span>
|
|
1255 1242 <span class="s">}</span>
|
|
1256 1243
|
|
1257 1244 <span class="c"># Calculate Euclidean distance coefficient using set theoretic form...</span>
|
|
1258 1245 <span class="c">#</span>
|
|
1259 <a name="_EuclideanDistanceCoefficientUsingSetTheoreticForm-"></a>1246 <span class="k">sub </span><span class="m">_EuclideanDistanceCoefficientUsingSetTheoreticForm</span> <span class="s">{</span>
|
|
1260 1247 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1261 1248 <span class="k">my</span><span class="s">(</span><span class="i">$SumMinXaiXbi</span><span class="cm">,</span> <span class="i">$SumXai</span><span class="cm">,</span> <span class="i">$SumXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
1262 1249
|
|
1263 1250 <span class="i">$SumXai</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="s">)</span><span class="sc">;</span>
|
|
1264 1251 <span class="i">$SumXbi</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1265 1252 <span class="i">$SumMinXaiXbi</span> = <span class="i">_GetSumOfMinimumOfFingerprintsOrderdedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1266 1253
|
|
1267 1254 <span class="k">return</span> <span class="s">(</span><span class="k">sqrt</span><span class="s">(</span><span class="i">$SumXai</span> + <span class="i">$SumXbi</span> - <span class="n">2</span> * <span class="i">$SumMinXaiXbi</span><span class="s">)</span><span class="s">)</span><span class="sc">;</span>
|
|
1268 1255 <span class="s">}</span>
|
|
1269 1256
|
|
1270 1257 <span class="c"># Calculate Jaccard similarity cofficient between two fingerprint vectors.</span>
|
|
1271 1258 <span class="c">#</span>
|
|
1272 1259 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
1273 1260 <span class="c">#</span>
|
|
1274 <a name="JaccardSimilarityCoefficient-"></a>1261 <span class="k">sub </span><span class="m">JaccardSimilarityCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
1275 1262 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1276 1263
|
|
1277 1264 <span class="k">return</span> <span class="i">TanimotoSimilarityCoefficient</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1278 1265 <span class="s">}</span>
|
|
1279 1266
|
|
1280 1267 <span class="c"># Calculate Tanimoto similarity cofficient between two fingerprint vectors.</span>
|
|
1281 1268 <span class="c">#</span>
|
|
1282 1269 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
1283 1270 <span class="c">#</span>
|
|
1284 <a name="TanimotoSimilarityCoefficient-"></a>1271 <span class="k">sub </span><span class="m">TanimotoSimilarityCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
1285 1272 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1286 1273
|
|
1287 1274 <span class="i">$CalculationMode</span> = <span class="k">defined</span> <span class="i">$CalculationMode</span> ? <span class="i">$CalculationMode</span> <span class="co">:</span> <span class="q">'AlgebraicForm'</span><span class="sc">;</span>
|
|
1288 1275 <span class="i">$SkipValuesCheck</span> = <span class="k">defined</span> <span class="i">$SkipValuesCheck</span> ? <span class="i">$SkipValuesCheck</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1289 1276
|
|
1290 1277 <span class="c"># Validate and process fingerprints vectors for similarity calculations...</span>
|
|
1291 1278 <span class="c">#</span>
|
|
1292 1279 <span class="i">_ValidateAndProcessFingerprintsVectorsForSimilarityCalculation</span><span class="s">(</span><span class="q">"TanimotoSimilarityCoefficient: Calculation failed"</span><span class="cm">,</span> <span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1293 1280
|
|
1294 1281 <span class="c"># Perform the calculation...</span>
|
|
1295 1282 <span class="k">if</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^AlgebraicForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1296 1283 <span class="k">return</span> <span class="i">_TanimotoSimilarityCoefficientUsingAlgebraicForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1297 1284 <span class="s">}</span>
|
|
1298 1285 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^BinaryForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1299 1286 <span class="k">return</span> <span class="i">_TanimotoSimilarityCoefficientUsingBinaryForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1300 1287 <span class="s">}</span>
|
|
1301 1288 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^SetTheoreticForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1302 1289 <span class="k">return</span> <span class="i">_TanimotoSimilarityCoefficientUsingSetTheoreticForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1303 1290 <span class="s">}</span>
|
|
1304 1291 <span class="k">else</span> <span class="s">{</span>
|
|
1305 1292 <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span>
|
|
1306 1293 <span class="s">}</span>
|
|
1307 1294 <span class="s">}</span>
|
|
1308 1295
|
|
1309 1296 <span class="c"># Calculate Tanimoto similarity coefficient using algebraic form...</span>
|
|
1310 1297 <span class="c">#</span>
|
|
1311 <a name="_TanimotoSimilarityCoefficientUsingAlgebraicForm-"></a>1298 <span class="k">sub </span><span class="m">_TanimotoSimilarityCoefficientUsingAlgebraicForm</span> <span class="s">{</span>
|
|
1312 1299 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1313 1300 <span class="k">my</span><span class="s">(</span><span class="i">$SumProductXaiXbi</span><span class="cm">,</span> <span class="i">$SumXai2</span><span class="cm">,</span> <span class="i">$SumXbi2</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1314 1301
|
|
1315 1302 <span class="i">$SumXai2</span> = <span class="i">_GetSumOfSquaresOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="s">)</span><span class="sc">;</span>
|
|
1316 1303 <span class="i">$SumXbi2</span> = <span class="i">_GetSumOfSquaresOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1317 1304 <span class="i">$SumProductXaiXbi</span> = <span class="i">_GetSumOfProductOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1318 1305
|
|
1319 1306 <span class="i">$Numerator</span> = <span class="i">$SumProductXaiXbi</span><span class="sc">;</span>
|
|
1320 1307 <span class="i">$Denominator</span> = <span class="i">$SumXai2</span> + <span class="i">$SumXbi2</span> - <span class="i">$SumProductXaiXbi</span><span class="sc">;</span>
|
|
1321 1308
|
|
1322 1309 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1323 1310 <span class="s">}</span>
|
|
1324 1311
|
|
1325 1312 <span class="c"># Calculate Tanimoto similarity coefficient using binary form...</span>
|
|
1326 1313 <span class="c">#</span>
|
|
1327 <a name="_TanimotoSimilarityCoefficientUsingBinaryForm-"></a>1314 <span class="k">sub </span><span class="m">_TanimotoSimilarityCoefficientUsingBinaryForm</span> <span class="s">{</span>
|
|
1328 1315 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1329 1316 <span class="k">my</span><span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1330 1317
|
|
1331 1318 <span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="s">)</span> = <span class="i">_GetNumOfIndividualAndCommonSetBits</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1332 1319
|
|
1333 1320 <span class="i">$Numerator</span> = <span class="i">$Nc</span><span class="sc">;</span>
|
|
1334 1321 <span class="i">$Denominator</span> = <span class="i">$Na</span> + <span class="i">$Nb</span> - <span class="i">$Nc</span><span class="sc">;</span>
|
|
1335 1322
|
|
1336 1323 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1337 1324 <span class="s">}</span>
|
|
1338 1325
|
|
1339 1326 <span class="c"># Calculate Tanimoto similarity coefficient using set theoretic form...</span>
|
|
1340 1327 <span class="c">#</span>
|
|
1341 <a name="_TanimotoSimilarityCoefficientUsingSetTheoreticForm-"></a>1328 <span class="k">sub </span><span class="m">_TanimotoSimilarityCoefficientUsingSetTheoreticForm</span> <span class="s">{</span>
|
|
1342 1329 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1343 1330 <span class="k">my</span><span class="s">(</span><span class="i">$SumMinXaiXbi</span><span class="cm">,</span> <span class="i">$SumXai</span><span class="cm">,</span> <span class="i">$SumXbi</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1344 1331
|
|
1345 1332 <span class="i">$SumXai</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="s">)</span><span class="sc">;</span>
|
|
1346 1333 <span class="i">$SumXbi</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1347 1334 <span class="i">$SumMinXaiXbi</span> = <span class="i">_GetSumOfMinimumOfFingerprintsOrderdedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1348 1335
|
|
1349 1336 <span class="i">$Numerator</span> = <span class="i">$SumMinXaiXbi</span><span class="sc">;</span>
|
|
1350 1337 <span class="i">$Denominator</span> = <span class="i">$SumXai</span> + <span class="i">$SumXbi</span> - <span class="i">$SumMinXaiXbi</span><span class="sc">;</span>
|
|
1351 1338
|
|
1352 1339 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1353 1340 <span class="s">}</span>
|
|
1354 1341
|
|
1355 1342
|
|
1356 1343 <span class="c"># Calculate Soergel distance coefficient between two fingerprint vectors.</span>
|
|
1357 1344 <span class="c">#</span>
|
|
1358 1345 <span class="c"># This functionality can be either invoked as a class function or an object method.</span>
|
|
1359 1346 <span class="c">#</span>
|
|
1360 <a name="SoergelDistanceCoefficient-"></a>1347 <span class="k">sub </span><span class="m">SoergelDistanceCoefficient ($$;$$)</span> <span class="s">{</span>
|
|
1361 1348 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1362 1349
|
|
1363 1350 <span class="i">$CalculationMode</span> = <span class="k">defined</span> <span class="i">$CalculationMode</span> ? <span class="i">$CalculationMode</span> <span class="co">:</span> <span class="q">'AlgebraicForm'</span><span class="sc">;</span>
|
|
1364 1351 <span class="i">$SkipValuesCheck</span> = <span class="k">defined</span> <span class="i">$SkipValuesCheck</span> ? <span class="i">$SkipValuesCheck</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1365 1352
|
|
1366 1353 <span class="c"># Validate and process fingerprints vectors for similarity calculations...</span>
|
|
1367 1354 <span class="c">#</span>
|
|
1368 1355 <span class="i">_ValidateAndProcessFingerprintsVectorsForSimilarityCalculation</span><span class="s">(</span><span class="q">"SoergelDistanceCoefficient: Calculation failed"</span><span class="cm">,</span> <span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1369 1356
|
|
1370 1357 <span class="c"># Perform the calculation...</span>
|
|
1371 1358 <span class="k">if</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^AlgebraicForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1372 1359 <span class="k">return</span> <span class="i">_SoergelDistanceCoefficientUsingAlgebraicForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1373 1360 <span class="s">}</span>
|
|
1374 1361 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^BinaryForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1375 1362 <span class="k">return</span> <span class="i">_SoergelDistanceCoefficientUsingBinaryForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1376 1363 <span class="s">}</span>
|
|
1377 1364 <span class="k">elsif</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^SetTheoreticForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1378 1365 <span class="k">return</span> <span class="i">_SoergelDistanceCoefficientUsingSetTheoreticForm</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1379 1366 <span class="s">}</span>
|
|
1380 1367 <span class="k">else</span> <span class="s">{</span>
|
|
1381 1368 <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span>
|
|
1382 1369 <span class="s">}</span>
|
|
1383 1370 <span class="s">}</span>
|
|
1384 1371
|
|
1385 1372 <span class="c"># Calculate Soergel distance coefficientusing algebraic form...</span>
|
|
1386 1373 <span class="c">#</span>
|
|
1387 <a name="_SoergelDistanceCoefficientUsingAlgebraicForm-"></a>1374 <span class="k">sub </span><span class="m">_SoergelDistanceCoefficientUsingAlgebraicForm</span> <span class="s">{</span>
|
|
1388 1375 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1389 1376 <span class="k">my</span><span class="s">(</span><span class="i">$SumAbsSubtractionXaiXbi</span><span class="cm">,</span> <span class="i">$SumMaxXaiXbi</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1390 1377
|
|
1391 1378 <span class="i">$SumAbsSubtractionXaiXbi</span> = <span class="i">_GetSumOfAbsoluteValueOfSubtractionOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1392 1379 <span class="i">$SumMaxXaiXbi</span> = <span class="i">_GetSumOfMaximumOfFingerprintsOrderdedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1393 1380
|
|
1394 1381 <span class="i">$Numerator</span> = <span class="i">$SumAbsSubtractionXaiXbi</span><span class="sc">;</span>
|
|
1395 1382 <span class="i">$Denominator</span> = <span class="i">$SumMaxXaiXbi</span><span class="sc">;</span>
|
|
1396 1383
|
|
1397 1384 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1398 1385 <span class="s">}</span>
|
|
1399 1386
|
|
1400 1387 <span class="c"># Calculate Soergel distance coefficient using binary form...</span>
|
|
1401 1388 <span class="c">#</span>
|
|
1402 <a name="_SoergelDistanceCoefficientUsingBinaryForm-"></a>1389 <span class="k">sub </span><span class="m">_SoergelDistanceCoefficientUsingBinaryForm</span> <span class="s">{</span>
|
|
1403 1390 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1404 1391 <span class="k">my</span><span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1405 1392
|
|
1406 1393 <span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="s">)</span> = <span class="i">_GetNumOfIndividualAndCommonSetBits</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1407 1394
|
|
1408 1395 <span class="i">$Numerator</span> = <span class="i">$Na</span> + <span class="i">$Nb</span> - <span class="n">2</span> * <span class="i">$Nc</span><span class="sc">;</span>
|
|
1409 1396 <span class="i">$Denominator</span> = <span class="i">$Na</span> + <span class="i">$Nb</span> - <span class="i">$Nc</span><span class="sc">;</span>
|
|
1410 1397
|
|
1411 1398 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1412 1399 <span class="s">}</span>
|
|
1413 1400
|
|
1414 1401 <span class="c"># Calculate SoergelDistanceCoefficient using set theoretic form...</span>
|
|
1415 1402 <span class="c">#</span>
|
|
1416 <a name="_SoergelDistanceCoefficientUsingSetTheoreticForm-"></a>1403 <span class="k">sub </span><span class="m">_SoergelDistanceCoefficientUsingSetTheoreticForm</span> <span class="s">{</span>
|
|
1417 1404 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1418 1405 <span class="k">my</span><span class="s">(</span><span class="i">$SumMinXaiXbi</span><span class="cm">,</span> <span class="i">$SumXai</span><span class="cm">,</span> <span class="i">$SumXbi</span><span class="cm">,</span> <span class="i">$Numerator</span><span class="cm">,</span> <span class="i">$Denominator</span><span class="s">)</span><span class="sc">;</span>
|
|
1419 1406
|
|
1420 1407 <span class="i">$SumXai</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="s">)</span><span class="sc">;</span>
|
|
1421 1408 <span class="i">$SumXbi</span> = <span class="i">_GetSumOfFingerprintsOrderedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1422 1409 <span class="i">$SumMinXaiXbi</span> = <span class="i">_GetSumOfMinimumOfFingerprintsOrderdedValues</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1423 1410
|
|
1424 1411 <span class="i">$Numerator</span> = <span class="i">$SumXai</span> + <span class="i">$SumXbi</span> - <span class="n">2</span> * <span class="i">$SumMinXaiXbi</span><span class="sc">;</span>
|
|
1425 1412 <span class="i">$Denominator</span> = <span class="i">$SumXai</span> + <span class="i">$SumXbi</span> - <span class="i">$SumMinXaiXbi</span><span class="sc">;</span>
|
|
1426 1413
|
|
1427 1414 <span class="k">return</span> <span class="i">$Denominator</span> ? <span class="s">(</span><span class="i">$Numerator</span>/<span class="i">$Denominator</span><span class="s">)</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1428 1415 <span class="s">}</span>
|
|
1429 1416
|
|
1430 1417 <span class="c"># Validate and process fingerprints vectors for similarity calculations...</span>
|
|
1431 1418 <span class="c">#</span>
|
|
1432 <a name="_ValidateAndProcessFingerprintsVectorsForSimilarityCalculation-"></a>1419 <span class="k">sub </span><span class="m">_ValidateAndProcessFingerprintsVectorsForSimilarityCalculation</span> <span class="s">{</span>
|
|
1433 1420 <span class="k">my</span><span class="s">(</span><span class="i">$ErrorMsg</span><span class="cm">,</span> <span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="cm">,</span> <span class="i">$SkipValuesCheck</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1434 1421
|
|
1435 1422 <span class="i">$CalculationMode</span> = <span class="k">defined</span> <span class="i">$CalculationMode</span> ? <span class="i">$CalculationMode</span> <span class="co">:</span> <span class="q">'AlgebraicForm'</span><span class="sc">;</span>
|
|
1436 1423 <span class="i">$SkipValuesCheck</span> = <span class="k">defined</span> <span class="i">$SkipValuesCheck</span> ? <span class="i">$SkipValuesCheck</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1437 1424
|
|
1438 1425 <span class="k">if</span> <span class="s">(</span>!<span class="i">$SkipValuesCheck</span><span class="s">)</span> <span class="s">{</span>
|
|
1439 1426 <span class="i">_ValidateFingerprintsVectorsForSimilarityCalculation</span><span class="s">(</span><span class="i">$ErrorMsg</span><span class="cm">,</span> <span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="s">)</span><span class="sc">;</span>
|
|
1440 1427 <span class="s">}</span>
|
|
1441 1428 <span class="i">_ProcessFingerprintsVectorsForSimilarityCalculation</span><span class="s">(</span><span class="i">$ErrorMsg</span><span class="cm">,</span> <span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="s">)</span><span class="sc">;</span>
|
|
1442 1429 <span class="s">}</span>
|
|
1443 1430
|
|
1444 1431 <span class="c"># Make sure fingerprint vectors are good for performing similarity/distance calculation...</span>
|
|
1445 1432 <span class="c">#</span>
|
|
1446 <a name="_ValidateFingerprintsVectorsForSimilarityCalculation-"></a>1433 <span class="k">sub </span><span class="m">_ValidateFingerprintsVectorsForSimilarityCalculation</span> <span class="s">{</span>
|
|
1447 1434 <span class="k">my</span><span class="s">(</span><span class="i">$ErrorMsg</span><span class="cm">,</span> <span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1448 1435
|
|
1449 1436 <span class="c"># Make sure both are fingerprint vectors..</span>
|
|
1450 1437 <span class="k">if</span> <span class="s">(</span>!<span class="s">(</span><span class="i">IsFingerprintsVector</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="s">)</span> && <span class="i">IsFingerprintsVector</span><span class="s">(</span><span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
1451 1438 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Both objects must be fingerprint vectors..."</span><span class="sc">;</span>
|
|
1452 1439 <span class="s">}</span>
|
|
1453 1440
|
|
1454 1441 <span class="c"># Check types...</span>
|
|
1455 1442 <span class="k">if</span> <span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">Type</span>} <span class="k">ne</span> <span class="i">$FingerprintsVectorB</span>->{<span class="w">Type</span>}<span class="s">)</span> <span class="s">{</span>
|
|
1456 1443 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Type of first fingerprint vector, $FingerprintsVectorA->{Type}, must be same as type of second fingerprint vector, $FingerprintsVectorB->{Type}..."</span><span class="sc">;</span>
|
|
1457 1444 <span class="s">}</span>
|
|
1458 1445
|
|
1459 1446 <span class="c"># Check calculation mode...</span>
|
|
1460 1447 <span class="k">if</span> <span class="s">(</span><span class="i">$CalculationMode</span> !~ <span class="q">/^(AlgebraicForm|BinaryForm|SetTheoreticForm)$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1461 1448 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Specified similarity calculation mode, $CalculationMode, is not valid. Supported values: AlgebraicForm, BinaryForm, and SetTheoreticForm..."</span><span class="sc">;</span>
|
|
1462 1449 <span class="s">}</span>
|
|
1463 1450
|
|
1464 1451 <span class="c"># Check values and value IDs...</span>
|
|
1465 1452 <span class="k">my</span><span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$NIDa</span><span class="cm">,</span> <span class="i">$NIDb</span><span class="s">)</span><span class="sc">;</span>
|
|
1466 1453 <span class="i">$Na</span> = <span class="i">$FingerprintsVectorA</span><span class="i">->GetNumOfValues</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="i">$Nb</span> = <span class="i">$FingerprintsVectorB</span><span class="i">->GetNumOfValues</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1467 1454 <span class="i">$NIDa</span> = <span class="i">$FingerprintsVectorA</span><span class="i">->GetNumOfValueIDs</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="i">$NIDb</span> = <span class="i">$FingerprintsVectorB</span><span class="i">->GetNumOfValueIDs</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1468 1455
|
|
1469 1456 <span class="k">if</span> <span class="s">(</span><span class="i">$Na</span> == <span class="n">0</span><span class="s">)</span> <span class="s">{</span>
|
|
1470 1457 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Number of values in first fingerprint vector, $Na, must be > 0 for fingerprint vector type $FingerprintsVectorA->{Type} ..."</span><span class="sc">;</span>
|
|
1471 1458 <span class="s">}</span>
|
|
1472 1459 <span class="k">if</span> <span class="s">(</span><span class="i">$Nb</span> == <span class="n">0</span><span class="s">)</span> <span class="s">{</span>
|
|
1473 1460 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Number of values in second fingerprint vector, $Nb, must be > 0 for fingerprint vector type $FingerprintsVectorB->{Type} ..."</span><span class="sc">;</span>
|
|
1474 1461 <span class="s">}</span>
|
|
1475 1462
|
|
1476 1463 <span class="k">if</span> <span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">Type</span>} =~ <span class="q">/^OrderedNumericalValues$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1477 1464 <span class="k">if</span> <span class="s">(</span><span class="i">$Na</span> != <span class="i">$Nb</span><span class="s">)</span> <span class="s">{</span>
|
|
1478 1465 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Number of values in first fingerprint vector, $Na, must be equal to number of values, $Nb, in second fingerprint vector for fingerprint vector types $FingerprintsVectorA->{Type} ..."</span><span class="sc">;</span>
|
|
1479 1466 <span class="s">}</span>
|
|
1480 1467 <span class="s">}</span>
|
|
1481 1468 <span class="k">elsif</span> <span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">Type</span>} =~ <span class="q">/^NumericalValues$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1482 1469 <span class="k">if</span> <span class="s">(</span><span class="i">$NIDa</span> == <span class="n">0</span><span class="s">)</span> <span class="s">{</span>
|
|
1483 1470 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Number of value IDs in first fingerprint vector, $NIDa, must be > 0 for fingerprint vector type $FingerprintsVectorA->{Type} ..."</span><span class="sc">;</span>
|
|
1484 1471 <span class="s">}</span>
|
|
1485 1472 <span class="k">if</span> <span class="s">(</span><span class="i">$NIDb</span> == <span class="n">0</span><span class="s">)</span> <span class="s">{</span>
|
|
1486 1473 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Number of value IDs in first fingerprint vector, $NIDb, must be > 0 for fingerprint vector type $FingerprintsVectorB->{Type} ..."</span><span class="sc">;</span>
|
|
1487 1474 <span class="s">}</span>
|
|
1488 1475
|
|
1489 1476 <span class="k">if</span> <span class="s">(</span><span class="i">$NIDa</span> != <span class="i">$Na</span><span class="s">)</span> <span class="s">{</span>
|
|
1490 1477 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Number of value IDs in first fingerprint vector, $NIDa, must be equal to its number of values, $Na, for fingerprint vector type $FingerprintsVectorA->{Type} ..."</span><span class="sc">;</span>
|
|
1491 1478 <span class="s">}</span>
|
|
1492 1479 <span class="k">if</span> <span class="s">(</span><span class="i">$NIDb</span> != <span class="i">$Nb</span><span class="s">)</span> <span class="s">{</span>
|
|
1493 1480 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Number of value IDs in second fingerprint vector, $NIDb, must be equal to its number of values, $Nb, for fingerprint vector type $FingerprintsVectorA->{Type} ..."</span><span class="sc">;</span>
|
|
1494 1481 <span class="s">}</span>
|
|
1495 1482 <span class="s">}</span>
|
|
1496 1483 <span class="k">elsif</span> <span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">Type</span>} =~ <span class="q">/^AlphaNumericalValues$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1497 1484 <span class="k">if</span> <span class="s">(</span><span class="i">$NIDa</span> || <span class="i">$NIDb</span><span class="s">)</span> <span class="s">{</span>
|
|
1498 1485 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: ValueIDs cann't be specified for fingerprint vector types $FingerprintsVectorA->{Type} ..."</span><span class="sc">;</span>
|
|
1499 1486 <span class="s">}</span>
|
|
1500 1487 <span class="s">}</span>
|
|
1501 1488 <span class="k">else</span> <span class="s">{</span>
|
|
1502 1489 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Fingerprint vector types $FingerprintsVectorA->{Type} is not valid..."</span><span class="sc">;</span>
|
|
1503 1490 <span class="s">}</span>
|
|
1504 1491 <span class="s">}</span>
|
|
1505 1492
|
|
1506 1493 <span class="c"># Process fingerprints vectors for similarity calculation by generating vectors</span>
|
|
1507 1494 <span class="c"># containing ordered list of values...</span>
|
|
1508 1495 <span class="c">#</span>
|
|
1509 <a name="_ProcessFingerprintsVectorsForSimilarityCalculation-"></a>1496 <span class="k">sub </span><span class="m">_ProcessFingerprintsVectorsForSimilarityCalculation</span> <span class="s">{</span>
|
|
1510 1497 <span class="k">my</span><span class="s">(</span><span class="i">$ErrorMsg</span><span class="cm">,</span> <span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="cm">,</span> <span class="i">$CalculationMode</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1511 1498
|
|
1512 1499 <span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>} = <span class="k">undef</span><span class="sc">;</span> <span class="i">$FingerprintsVectorB</span>->{<span class="w">OrderedValuesRef</span>} = <span class="k">undef</span><span class="sc">;</span>
|
|
1513 1500 <span class="i">$FingerprintsVectorA</span>->{<span class="w">BitVector</span>} = <span class="k">undef</span><span class="sc">;</span> <span class="i">$FingerprintsVectorB</span>->{<span class="w">BitVector</span>} = <span class="k">undef</span><span class="sc">;</span>
|
|
1514 1501
|
|
1515 1502 <span class="k">if</span> <span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">Type</span>} =~ <span class="q">/^OrderedNumericalValues$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1516 1503 <span class="i">_ProcessOrderedNumericalValuesFingerprintsVectorsForSimilarityCalculation</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1517 1504 <span class="s">}</span>
|
|
1518 1505 <span class="k">elsif</span> <span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">Type</span>} =~ <span class="q">/^NumericalValues$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1519 1506 <span class="i">_ProcessNumericalValuesFingerprintsVectorsForSimilarityCalculation</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1520 1507 <span class="s">}</span>
|
|
1521 1508 <span class="k">elsif</span> <span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">Type</span>} =~ <span class="q">/^AlphaNumericalValues$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1522 1509 <span class="i">_ProcessAlphaNumericalValuesFingerprintsVectorsForSimilarityCalculation</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1523 1510 <span class="s">}</span>
|
|
1524 1511 <span class="k">else</span> <span class="s">{</span>
|
|
1525 1512 <span class="w">croak</span> <span class="q">"Error: ${ClassName}->${ErrorMsg}: Fingerprint vector types $FingerprintsVectorA->{Type} is not valid..."</span><span class="sc">;</span>
|
|
1526 1513 <span class="s">}</span>
|
|
1527 1514 <span class="k">if</span> <span class="s">(</span><span class="i">$CalculationMode</span> =~ <span class="q">/^BinaryForm$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1528 1515 <span class="i">_TransformFinalOrderedValuesIntoBitVectorsForSimilarityCalculation</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1529 1516 <span class="s">}</span>
|
|
1530 1517 <span class="s">}</span>
|
|
1531 1518
|
|
1532 1519 <span class="c"># Process fingerprints vectors with ordered numerical values for similarity calculations...</span>
|
|
1533 1520 <span class="c">#</span>
|
|
1534 <a name="_ProcessOrderedNumericalValuesFingerprintsVectorsForSimilarityCalculation-"></a>1521 <span class="k">sub </span><span class="m">_ProcessOrderedNumericalValuesFingerprintsVectorsForSimilarityCalculation</span> <span class="s">{</span>
|
|
1535 1522 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1536 1523
|
|
1537 1524 <span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>} = \<span class="i">@</span>{<span class="i">$FingerprintsVectorA</span>->{<span class="w">Values</span>}}<span class="sc">;</span>
|
|
1538 1525 <span class="i">$FingerprintsVectorB</span>->{<span class="w">OrderedValuesRef</span>} = \<span class="i">@</span>{<span class="i">$FingerprintsVectorB</span>->{<span class="w">Values</span>}}<span class="sc">;</span>
|
|
1539 1526 <span class="s">}</span>
|
|
1540 1527
|
|
1541 1528 <span class="c"># Process fingerprints vectors with numerical values for similarity calculations...</span>
|
|
1542 1529 <span class="c">#</span>
|
|
1543 <a name="_ProcessNumericalValuesFingerprintsVectorsForSimilarityCalculation-"></a>1530 <span class="k">sub </span><span class="m">_ProcessNumericalValuesFingerprintsVectorsForSimilarityCalculation</span> <span class="s">{</span>
|
|
1544 1531 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1545 1532
|
|
1546 1533 <span class="c"># Set up unique IDs and values map for each fingerprint vector...</span>
|
|
1547 1534 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$Value</span><span class="cm">,</span> <span class="i">$ValueID</span><span class="cm">,</span> <span class="i">%UniqueFingerprintsVectorAValueIDValues</span><span class="cm">,</span> <span class="i">%UniqueFingerprintsVectorBValueIDValues</span><span class="cm">,</span> <span class="i">%UniqueFingerprintsVectorsValueIDs</span><span class="s">)</span><span class="sc">;</span>
|
|
1548 1535
|
|
1549 1536 <span class="i">%UniqueFingerprintsVectorAValueIDValues</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1550 1537 <span class="i">%UniqueFingerprintsVectorBValueIDValues</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1551 1538 <span class="i">%UniqueFingerprintsVectorsValueIDs</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1552 1539
|
|
1553 1540 <span class="c"># Go over first vector...</span>
|
|
1554 1541 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#</span>{<span class="i">$FingerprintsVectorA</span>->{<span class="w">ValueIDs</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
1555 1542 <span class="i">$ValueID</span> = <span class="i">$FingerprintsVectorA</span>->{<span class="w">ValueIDs</span>}[<span class="i">$Index</span>]<span class="sc">;</span>
|
|
1556 1543 <span class="i">$Value</span> = <span class="i">$FingerprintsVectorA</span>->{<span class="w">Values</span>}[<span class="i">$Index</span>]<span class="sc">;</span>
|
|
1557 1544 <span class="k">if</span> <span class="s">(</span><span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorAValueIDValues</span>{<span class="i">$ValueID</span>}<span class="s">)</span> <span class="s">{</span>
|
|
1558 1545 <span class="i">$UniqueFingerprintsVectorAValueIDValues</span>{<span class="i">$ValueID</span>} += <span class="i">$Value</span><span class="sc">;</span>
|
|
1559 1546 <span class="s">}</span>
|
|
1560 1547 <span class="k">else</span> <span class="s">{</span>
|
|
1561 1548 <span class="i">$UniqueFingerprintsVectorAValueIDValues</span>{<span class="i">$ValueID</span>} = <span class="i">$Value</span><span class="sc">;</span>
|
|
1562 1549 <span class="s">}</span>
|
|
1563 1550 <span class="k">if</span> <span class="s">(</span>!<span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorsValueIDs</span>{<span class="i">$ValueID</span>}<span class="s">)</span> <span class="s">{</span>
|
|
1564 1551 <span class="i">$UniqueFingerprintsVectorsValueIDs</span>{<span class="i">$ValueID</span>} = <span class="n">1</span><span class="sc">;</span>
|
|
1565 1552 <span class="s">}</span>
|
|
1566 1553 <span class="s">}</span>
|
|
1567 1554
|
|
1568 1555 <span class="c"># Go over second vector...</span>
|
|
1569 1556 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#</span>{<span class="i">$FingerprintsVectorB</span>->{<span class="w">ValueIDs</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
1570 1557 <span class="i">$ValueID</span> = <span class="i">$FingerprintsVectorB</span>->{<span class="w">ValueIDs</span>}[<span class="i">$Index</span>]<span class="sc">;</span>
|
|
1571 1558 <span class="i">$Value</span> = <span class="i">$FingerprintsVectorB</span>->{<span class="w">Values</span>}[<span class="i">$Index</span>]<span class="sc">;</span>
|
|
1572 1559 <span class="k">if</span> <span class="s">(</span><span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorBValueIDValues</span>{<span class="i">$ValueID</span>}<span class="s">)</span> <span class="s">{</span>
|
|
1573 1560 <span class="i">$UniqueFingerprintsVectorBValueIDValues</span>{<span class="i">$ValueID</span>} += <span class="i">$Value</span><span class="sc">;</span>
|
|
1574 1561 <span class="s">}</span>
|
|
1575 1562 <span class="k">else</span> <span class="s">{</span>
|
|
1576 1563 <span class="i">$UniqueFingerprintsVectorBValueIDValues</span>{<span class="i">$ValueID</span>} = <span class="i">$Value</span><span class="sc">;</span>
|
|
1577 1564 <span class="s">}</span>
|
|
1578 1565 <span class="k">if</span> <span class="s">(</span>!<span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorsValueIDs</span>{<span class="i">$ValueID</span>}<span class="s">)</span> <span class="s">{</span>
|
|
1579 1566 <span class="i">$UniqueFingerprintsVectorsValueIDs</span>{<span class="i">$ValueID</span>} = <span class="n">1</span><span class="sc">;</span>
|
|
1580 1567 <span class="s">}</span>
|
|
1581 1568 <span class="s">}</span>
|
|
1582 1569
|
|
1583 1570 <span class="c"># Setup ordered values...</span>
|
|
1584 1571 <span class="k">my</span><span class="s">(</span><span class="i">@UniqueOrderedValueIDs</span><span class="cm">,</span> <span class="i">@OrderedValuesA</span><span class="cm">,</span> <span class="i">@OrderedValuesB</span><span class="s">)</span><span class="sc">;</span>
|
|
1585 1572
|
|
1586 1573 <span class="i">@UniqueOrderedValueIDs</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1587 1574 <span class="i">@UniqueOrderedValueIDs</span> = <span class="k">sort</span> <span class="k">keys</span> <span class="i">%UniqueFingerprintsVectorsValueIDs</span><span class="sc">;</span>
|
|
1588 1575
|
|
1589 1576 <span class="i">@OrderedValuesA</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1590 1577 <span class="i">@OrderedValuesA</span> = <span class="k">map</span> <span class="s">{</span> <span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorAValueIDValues</span>{<span class="i">$_</span>} ? <span class="i">$UniqueFingerprintsVectorAValueIDValues</span>{<span class="i">$_</span>} <span class="co">:</span> <span class="n">0</span> <span class="s">}</span> <span class="i">@UniqueOrderedValueIDs</span><span class="sc">;</span>
|
|
1591 1578
|
|
1592 1579 <span class="i">@OrderedValuesB</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1593 1580 <span class="i">@OrderedValuesB</span> = <span class="k">map</span> <span class="s">{</span> <span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorBValueIDValues</span>{<span class="i">$_</span>} ? <span class="i">$UniqueFingerprintsVectorBValueIDValues</span>{<span class="i">$_</span>} <span class="co">:</span> <span class="n">0</span> <span class="s">}</span> <span class="i">@UniqueOrderedValueIDs</span><span class="sc">;</span>
|
|
1594 1581
|
|
1595 1582 <span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>} = \<span class="i">@OrderedValuesA</span><span class="sc">;</span>
|
|
1596 1583 <span class="i">$FingerprintsVectorB</span>->{<span class="w">OrderedValuesRef</span>} = \<span class="i">@OrderedValuesB</span><span class="sc">;</span>
|
|
1597 1584 <span class="s">}</span>
|
|
1598 1585
|
|
1599 1586 <span class="c"># Process fingerprints vectors with allpha numerical values for similarity calculations...</span>
|
|
1600 1587 <span class="c">#</span>
|
|
1601 <a name="_ProcessAlphaNumericalValuesFingerprintsVectorsForSimilarityCalculation-"></a>1588 <span class="k">sub </span><span class="m">_ProcessAlphaNumericalValuesFingerprintsVectorsForSimilarityCalculation</span> <span class="s">{</span>
|
|
1602 1589 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1603 1590
|
|
1604 1591 <span class="c"># Set up unique IDs and values map for each vector...</span>
|
|
1605 1592 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$Value</span><span class="cm">,</span> <span class="i">$ValueID</span><span class="cm">,</span> <span class="i">%UniqueFingerprintsVectorAValuesCount</span><span class="cm">,</span> <span class="i">%UniqueFingerprintsVectorBValuesCount</span><span class="cm">,</span> <span class="i">%UniqueFingerprintsVectorsValues</span><span class="s">)</span><span class="sc">;</span>
|
|
1606 1593
|
|
1607 1594 <span class="i">%UniqueFingerprintsVectorAValuesCount</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1608 1595 <span class="i">%UniqueFingerprintsVectorBValuesCount</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1609 1596 <span class="i">%UniqueFingerprintsVectorsValues</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1610 1597
|
|
1611 1598 <span class="c"># Go over first vector...</span>
|
|
1612 1599 <span class="k">for</span> <span class="i">$Value</span> <span class="s">(</span><span class="i">@</span>{<span class="i">$FingerprintsVectorA</span>->{<span class="w">Values</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
1613 1600 <span class="k">if</span> <span class="s">(</span><span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorAValuesCount</span>{<span class="i">$Value</span>}<span class="s">)</span> <span class="s">{</span>
|
|
1614 1601 <span class="i">$UniqueFingerprintsVectorAValuesCount</span>{<span class="i">$Value</span>} += <span class="n">1</span><span class="sc">;</span>
|
|
1615 1602 <span class="s">}</span>
|
|
1616 1603 <span class="k">else</span> <span class="s">{</span>
|
|
1617 1604 <span class="i">$UniqueFingerprintsVectorAValuesCount</span>{<span class="i">$Value</span>} = <span class="n">1</span><span class="sc">;</span>
|
|
1618 1605 <span class="s">}</span>
|
|
1619 1606 <span class="k">if</span> <span class="s">(</span>!<span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorsValues</span>{<span class="i">$Value</span>}<span class="s">)</span> <span class="s">{</span>
|
|
1620 1607 <span class="i">$UniqueFingerprintsVectorsValues</span>{<span class="i">$Value</span>} = <span class="n">1</span><span class="sc">;</span>
|
|
1621 1608 <span class="s">}</span>
|
|
1622 1609 <span class="s">}</span>
|
|
1623 1610
|
|
1624 1611 <span class="c"># Go over second vector...</span>
|
|
1625 1612 <span class="k">for</span> <span class="i">$Value</span> <span class="s">(</span><span class="i">@</span>{<span class="i">$FingerprintsVectorB</span>->{<span class="w">Values</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
1626 1613 <span class="k">if</span> <span class="s">(</span><span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorBValuesCount</span>{<span class="i">$Value</span>}<span class="s">)</span> <span class="s">{</span>
|
|
1627 1614 <span class="i">$UniqueFingerprintsVectorBValuesCount</span>{<span class="i">$Value</span>} += <span class="n">1</span><span class="sc">;</span>
|
|
1628 1615 <span class="s">}</span>
|
|
1629 1616 <span class="k">else</span> <span class="s">{</span>
|
|
1630 1617 <span class="i">$UniqueFingerprintsVectorBValuesCount</span>{<span class="i">$Value</span>} = <span class="n">1</span><span class="sc">;</span>
|
|
1631 1618 <span class="s">}</span>
|
|
1632 1619 <span class="k">if</span> <span class="s">(</span>!<span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorsValues</span>{<span class="i">$Value</span>}<span class="s">)</span> <span class="s">{</span>
|
|
1633 1620 <span class="i">$UniqueFingerprintsVectorsValues</span>{<span class="i">$Value</span>} = <span class="n">1</span><span class="sc">;</span>
|
|
1634 1621 <span class="s">}</span>
|
|
1635 1622 <span class="s">}</span>
|
|
1636 1623
|
|
1637 1624 <span class="c"># Setup ordered values...</span>
|
|
1638 1625 <span class="k">my</span><span class="s">(</span><span class="i">@UniqueOrderedValueIDs</span><span class="cm">,</span> <span class="i">@OrderedValuesA</span><span class="cm">,</span> <span class="i">@OrderedValuesB</span><span class="s">)</span><span class="sc">;</span>
|
|
1639 1626
|
|
1640 1627 <span class="i">@UniqueOrderedValueIDs</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1641 1628 <span class="i">@UniqueOrderedValueIDs</span> = <span class="k">sort</span> <span class="k">keys</span> <span class="i">%UniqueFingerprintsVectorsValues</span><span class="sc">;</span>
|
|
1642 1629
|
|
1643 1630 <span class="i">@OrderedValuesA</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1644 1631 <span class="i">@OrderedValuesA</span> = <span class="k">map</span> <span class="s">{</span> <span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorAValuesCount</span>{<span class="i">$_</span>} ? <span class="i">$UniqueFingerprintsVectorAValuesCount</span>{<span class="i">$_</span>} <span class="co">:</span> <span class="n">0</span> <span class="s">}</span> <span class="i">@UniqueOrderedValueIDs</span><span class="sc">;</span>
|
|
1645 1632
|
|
1646 1633 <span class="i">@OrderedValuesB</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1647 1634 <span class="i">@OrderedValuesB</span> = <span class="k">map</span> <span class="s">{</span> <span class="k">exists</span> <span class="i">$UniqueFingerprintsVectorBValuesCount</span>{<span class="i">$_</span>} ? <span class="i">$UniqueFingerprintsVectorBValuesCount</span>{<span class="i">$_</span>} <span class="co">:</span> <span class="n">0</span> <span class="s">}</span> <span class="i">@UniqueOrderedValueIDs</span><span class="sc">;</span>
|
|
1648 1635
|
|
1649 1636 <span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>} = \<span class="i">@OrderedValuesA</span><span class="sc">;</span>
|
|
1650 1637 <span class="i">$FingerprintsVectorB</span>->{<span class="w">OrderedValuesRef</span>} = \<span class="i">@OrderedValuesB</span><span class="sc">;</span>
|
|
1651 1638
|
|
1652 1639 <span class="s">}</span>
|
|
1653 1640
|
|
1654 1641 <span class="c"># Transform final ordered values array into a BitVector for similarity calculation...</span>
|
|
1655 1642 <span class="c">#</span>
|
|
1656 <a name="_TransformFinalOrderedValuesIntoBitVectorsForSimilarityCalculation-"></a>1643 <span class="k">sub </span><span class="m">_TransformFinalOrderedValuesIntoBitVectorsForSimilarityCalculation</span> <span class="s">{</span>
|
|
1657 1644 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1658 1645 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$Size</span><span class="cm">,</span> <span class="i">$BitVectorA</span><span class="cm">,</span> <span class="i">$BitVectorB</span><span class="cm">,</span> <span class="i">$SkipCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1659 1646
|
|
1660 1647 <span class="c"># Create bit vectors...</span>
|
|
1661 1648 <span class="i">$Size</span> = <span class="k">scalar</span> <span class="i">@</span>{<span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}}<span class="sc">;</span>
|
|
1662 1649
|
|
1663 1650 <span class="i">$FingerprintsVectorA</span>->{<span class="w">BitVector</span>} = <span class="i">new</span> <span class="i">BitVector</span><span class="s">(</span><span class="i">$Size</span><span class="s">)</span><span class="sc">;</span>
|
|
1664 1651 <span class="i">$FingerprintsVectorB</span>->{<span class="w">BitVector</span>} = <span class="i">new</span> <span class="i">BitVector</span><span class="s">(</span><span class="i">$Size</span><span class="s">)</span><span class="sc">;</span>
|
|
1665 1652
|
|
1666 1653 <span class="c"># Set bits...</span>
|
|
1667 1654 <span class="i">$SkipCheck</span> = <span class="n">1</span><span class="sc">;</span>
|
|
1668 1655 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="s">(</span><span class="i">$Size</span> - <span class="n">1</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
1669 1656 <span class="k">if</span> <span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>]<span class="s">)</span> <span class="s">{</span>
|
|
1670 1657 <span class="i">$FingerprintsVectorA</span>->{<span class="w">BitVector</span>}<span class="i">->SetBit</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$SkipCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1671 1658 <span class="s">}</span>
|
|
1672 1659 <span class="k">if</span> <span class="s">(</span><span class="i">$FingerprintsVectorB</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>]<span class="s">)</span> <span class="s">{</span>
|
|
1673 1660 <span class="i">$FingerprintsVectorB</span>->{<span class="w">BitVector</span>}<span class="i">->SetBit</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$SkipCheck</span><span class="s">)</span><span class="sc">;</span>
|
|
1674 1661 <span class="s">}</span>
|
|
1675 1662 <span class="s">}</span>
|
|
1676 1663 <span class="s">}</span>
|
|
1677 1664
|
|
1678 1665 <span class="c"># Return sum of ordered vector values...</span>
|
|
1679 1666 <span class="c">#</span>
|
|
1680 <a name="_GetSumOfFingerprintsOrderedValues-"></a>1667 <span class="k">sub </span><span class="m">_GetSumOfFingerprintsOrderedValues</span> <span class="s">{</span>
|
|
1681 1668 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintVector</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1682 1669
|
|
1683 1670 <span class="k">return</span> <span class="i">StatisticsUtil::Sum</span><span class="s">(</span><span class="i">$FingerprintVector</span>->{<span class="w">OrderedValuesRef</span>}<span class="s">)</span><span class="sc">;</span>
|
|
1684 1671 <span class="s">}</span>
|
|
1685 1672
|
|
1686 1673 <span class="c"># Return sum of squared ordered vector values...</span>
|
|
1687 1674 <span class="c">#</span>
|
|
1688 <a name="_GetSumOfSquaresOfFingerprintsOrderedValues-"></a>1675 <span class="k">sub </span><span class="m">_GetSumOfSquaresOfFingerprintsOrderedValues</span> <span class="s">{</span>
|
|
1689 1676 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintVector</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1690 1677
|
|
1691 1678 <span class="k">return</span> <span class="i">StatisticsUtil::SumOfSquares</span><span class="s">(</span><span class="i">$FingerprintVector</span>->{<span class="w">OrderedValuesRef</span>}<span class="s">)</span><span class="sc">;</span>
|
|
1692 1679 <span class="s">}</span>
|
|
1693 1680
|
|
1694 1681 <span class="c"># Return sum of product of correponding ordered vector values...</span>
|
|
1695 1682 <span class="c">#</span>
|
|
1696 <a name="_GetSumOfProductOfFingerprintsOrderedValues-"></a>1683 <span class="k">sub </span><span class="m">_GetSumOfProductOfFingerprintsOrderedValues</span> <span class="s">{</span>
|
|
1697 1684 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1698 1685 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$SumProductXaiXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
1699 1686
|
|
1700 1687 <span class="i">$SumProductXaiXbi</span> = <span class="n">0</span><span class="sc">;</span>
|
|
1701 1688 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#</span>{<span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
1702 1689 <span class="i">$SumProductXaiXbi</span> += <span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>] * <span class="i">$FingerprintsVectorB</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>]<span class="sc">;</span>
|
|
1703 1690 <span class="s">}</span>
|
|
1704 1691 <span class="k">return</span> <span class="i">$SumProductXaiXbi</span><span class="sc">;</span>
|
|
1705 1692 <span class="s">}</span>
|
|
1706 1693
|
|
1707 1694 <span class="c"># Return sum of absolute value of subtraction of correponding ordered vector values...</span>
|
|
1708 1695 <span class="c">#</span>
|
|
1709 <a name="_GetSumOfAbsoluteValueOfSubtractionOfFingerprintsOrderedValues-"></a>1696 <span class="k">sub </span><span class="m">_GetSumOfAbsoluteValueOfSubtractionOfFingerprintsOrderedValues</span> <span class="s">{</span>
|
|
1710 1697 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1711 1698 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$SumAbsSubtractionXaiXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
1712 1699
|
|
1713 1700 <span class="i">$SumAbsSubtractionXaiXbi</span> = <span class="n">0</span><span class="sc">;</span>
|
|
1714 1701 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#</span>{<span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
1715 1702 <span class="i">$SumAbsSubtractionXaiXbi</span> += <span class="k">abs</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>] - <span class="i">$FingerprintsVectorB</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>]<span class="s">)</span><span class="sc">;</span>
|
|
1716 1703 <span class="s">}</span>
|
|
1717 1704 <span class="k">return</span> <span class="i">$SumAbsSubtractionXaiXbi</span><span class="sc">;</span>
|
|
1718 1705 <span class="s">}</span>
|
|
1719 1706
|
|
1720 1707 <span class="c"># Return sum of squares of subtraction of correponding ordered vector values...</span>
|
|
1721 1708 <span class="c">#</span>
|
|
1722 <a name="_GetSumOfSquaresOfSubtractionOfFingerprintsOrderedValues-"></a>1709 <span class="k">sub </span><span class="m">_GetSumOfSquaresOfSubtractionOfFingerprintsOrderedValues</span> <span class="s">{</span>
|
|
1723 1710 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1724 1711 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$SumSquaresSubtractionXaiXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
1725 1712
|
|
1726 1713 <span class="i">$SumSquaresSubtractionXaiXbi</span> = <span class="n">0</span><span class="sc">;</span>
|
|
1727 1714 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#</span>{<span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
1728 1715 <span class="i">$SumSquaresSubtractionXaiXbi</span> += <span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>] - <span class="i">$FingerprintsVectorB</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>]<span class="s">)</span>**<span class="n">2</span><span class="sc">;</span>
|
|
1729 1716 <span class="s">}</span>
|
|
1730 1717 <span class="k">return</span> <span class="i">$SumSquaresSubtractionXaiXbi</span><span class="sc">;</span>
|
|
1731 1718 <span class="s">}</span>
|
|
1732 1719
|
|
1733 1720 <span class="c"># Return sum of minimum of correponding ordered vector values...</span>
|
|
1734 1721 <span class="c">#</span>
|
|
1735 <a name="_GetSumOfMinimumOfFingerprintsOrderdedValues-"></a>1722 <span class="k">sub </span><span class="m">_GetSumOfMinimumOfFingerprintsOrderdedValues</span> <span class="s">{</span>
|
|
1736 1723 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1737 1724 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$SumMinXaiXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
1738 1725
|
|
1739 1726 <span class="i">$SumMinXaiXbi</span> = <span class="n">0</span><span class="sc">;</span>
|
|
1740 1727 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#</span>{<span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
1741 1728 <span class="i">$SumMinXaiXbi</span> += <span class="i">MathUtil::min</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>]<span class="cm">,</span> <span class="i">$FingerprintsVectorB</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>]<span class="s">)</span><span class="sc">;</span>
|
|
1742 1729 <span class="s">}</span>
|
|
1743 1730 <span class="k">return</span> <span class="i">$SumMinXaiXbi</span><span class="sc">;</span>
|
|
1744 1731 <span class="s">}</span>
|
|
1745 1732
|
|
1746 1733 <span class="c"># Return sum of maximum of correponding ordered vector values...</span>
|
|
1747 1734 <span class="c">#</span>
|
|
1748 <a name="_GetSumOfMaximumOfFingerprintsOrderdedValues-"></a>1735 <span class="k">sub </span><span class="m">_GetSumOfMaximumOfFingerprintsOrderdedValues</span> <span class="s">{</span>
|
|
1749 1736 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1750 1737 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">$SumMaxXaiXbi</span><span class="s">)</span><span class="sc">;</span>
|
|
1751 1738
|
|
1752 1739 <span class="i">$SumMaxXaiXbi</span> = <span class="n">0</span><span class="sc">;</span>
|
|
1753 1740 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#</span>{<span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}}<span class="s">)</span> <span class="s">{</span>
|
|
1754 1741 <span class="i">$SumMaxXaiXbi</span> += <span class="i">MathUtil::max</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>]<span class="cm">,</span> <span class="i">$FingerprintsVectorB</span>->{<span class="w">OrderedValuesRef</span>}[<span class="i">$Index</span>]<span class="s">)</span><span class="sc">;</span>
|
|
1755 1742 <span class="s">}</span>
|
|
1756 1743 <span class="k">return</span> <span class="i">$SumMaxXaiXbi</span><span class="sc">;</span>
|
|
1757 1744 <span class="s">}</span>
|
|
1758 1745
|
|
1759 1746 <span class="c"># Get number of Na, Nb and Nc bits in vector A and B for BinaryForm calculation...</span>
|
|
1760 1747 <span class="c">#</span>
|
|
1761 <a name="_GetNumOfIndividualAndCommonSetBits-"></a>1748 <span class="k">sub </span><span class="m">_GetNumOfIndividualAndCommonSetBits ($$)</span> <span class="s">{</span>
|
|
1762 1749 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsVectorB</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1763 1750 <span class="k">my</span><span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="cm">,</span> <span class="i">$Nd</span><span class="cm">,</span> <span class="i">$FingerprintsBitVectorA</span><span class="cm">,</span> <span class="i">$FingerprintsBitVectorB</span><span class="s">)</span><span class="sc">;</span>
|
|
1764 1751
|
|
1765 1752 <span class="i">$FingerprintsBitVectorA</span> = <span class="i">$FingerprintsVectorA</span>->{<span class="w">BitVector</span>}<span class="sc">;</span>
|
|
1766 1753 <span class="i">$FingerprintsBitVectorB</span> = <span class="i">$FingerprintsVectorB</span>->{<span class="w">BitVector</span>}<span class="sc">;</span>
|
|
1767 1754
|
|
1768 1755 <span class="c"># Number of bits set to "1" in A</span>
|
|
1769 1756 <span class="i">$Na</span> = <span class="i">$FingerprintsBitVectorA</span><span class="i">->GetNumOfSetBits</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1770 1757
|
|
1771 1758 <span class="c"># Number of bits set to "1" in B</span>
|
|
1772 1759 <span class="i">$Nb</span> = <span class="i">$FingerprintsBitVectorB</span><span class="i">->GetNumOfSetBits</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1773 1760
|
|
1774 1761 <span class="c"># Number of bits set to "1" in both A and B</span>
|
|
1775 1762 <span class="k">my</span><span class="s">(</span><span class="i">$NcBitVector</span><span class="s">)</span><span class="sc">;</span>
|
|
1776 1763 <span class="i">$NcBitVector</span> = <span class="i">$FingerprintsBitVectorA</span> & <span class="i">$FingerprintsBitVectorB</span><span class="sc">;</span>
|
|
1777 1764 <span class="i">$Nc</span> = <span class="i">$NcBitVector</span><span class="i">->GetNumOfSetBits</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1778 1765
|
|
1779 1766 <span class="k">return</span> <span class="s">(</span><span class="i">$Na</span><span class="cm">,</span> <span class="i">$Nb</span><span class="cm">,</span> <span class="i">$Nc</span><span class="s">)</span><span class="sc">;</span>
|
|
1780 1767 <span class="s">}</span>
|
|
1781 1768
|
|
1782 1769 <span class="c"># Return a list of supported distance coefficients...</span>
|
|
1783 1770 <span class="c">#</span>
|
|
1784 <a name="GetSupportedDistanceCoefficients-"></a>1771 <span class="k">sub </span><span class="m">GetSupportedDistanceCoefficients ()</span> <span class="s">{</span>
|
|
1785 1772
|
|
1786 1773 <span class="k">return</span> <span class="i">@DistanceCoefficients</span><span class="sc">;</span>
|
|
1787 1774 <span class="s">}</span>
|
|
1788 1775
|
|
1789 1776 <span class="c"># Return a list of supported similarity coefficients...</span>
|
|
1790 1777 <span class="c">#</span>
|
|
1791 <a name="GetSupportedSimilarityCoefficients-"></a>1778 <span class="k">sub </span><span class="m">GetSupportedSimilarityCoefficients ()</span> <span class="s">{</span>
|
|
1792 1779
|
|
1793 1780 <span class="k">return</span> <span class="i">@SimilarityCoefficients</span><span class="sc">;</span>
|
|
1794 1781 <span class="s">}</span>
|
|
1795 1782
|
|
1796 1783 <span class="c"># Return a list of supported distance and similarity coefficients...</span>
|
|
1797 1784 <span class="c">#</span>
|
|
1798 <a name="GetSupportedDistanceAndSimilarityCoefficients-"></a>1785 <span class="k">sub </span><span class="m">GetSupportedDistanceAndSimilarityCoefficients ()</span> <span class="s">{</span>
|
|
1799 1786 <span class="k">my</span><span class="s">(</span><span class="i">@DistanceAndSimilarityCoefficients</span><span class="s">)</span><span class="sc">;</span>
|
|
1800 1787
|
|
1801 1788 <span class="i">@DistanceAndSimilarityCoefficients</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1802 1789 <span class="k">push</span> <span class="i">@DistanceAndSimilarityCoefficients</span><span class="cm">,</span> <span class="i">@DistanceCoefficients</span><span class="sc">;</span>
|
|
1803 1790 <span class="k">push</span> <span class="i">@DistanceAndSimilarityCoefficients</span><span class="cm">,</span> <span class="i">@SimilarityCoefficients</span><span class="sc">;</span>
|
|
1804 1791
|
|
1805 1792 <span class="k">return</span> <span class="k">sort</span> <span class="i">@DistanceAndSimilarityCoefficients</span><span class="sc">;</span>
|
|
1806 1793 <span class="s">}</span>
|
|
1807 1794
|
|
1808 1795 <span class="c"># Is it a fingerprints vector object?</span>
|
|
1809 <a name="IsFingerprintsVector-"></a>1796 <span class="k">sub </span><span class="m">IsFingerprintsVector ($)</span> <span class="s">{</span>
|
|
1810 1797 <span class="k">my</span><span class="s">(</span><span class="i">$Object</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1811 1798
|
|
1812 1799 <span class="k">return</span> <span class="i">_IsFingerprintsVector</span><span class="s">(</span><span class="i">$Object</span><span class="s">)</span><span class="sc">;</span>
|
|
1813 1800 <span class="s">}</span>
|
|
1814 1801
|
|
1815 1802 <span class="c"># Is it a fingerprints vector object?</span>
|
|
1816 <a name="_IsFingerprintsVector-"></a>1803 <span class="k">sub </span><span class="m">_IsFingerprintsVector</span> <span class="s">{</span>
|
|
1817 1804 <span class="k">my</span><span class="s">(</span><span class="i">$Object</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1818 1805
|
|
1819 1806 <span class="k">return</span> <span class="s">(</span><span class="i">Scalar::Util::blessed</span><span class="s">(</span><span class="i">$Object</span><span class="s">)</span> && <span class="i">$Object</span><span class="i">->isa</span><span class="s">(</span><span class="i">$ClassName</span><span class="s">)</span><span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
|
|
1820 1807 <span class="s">}</span>
|
|
1821 1808
|
|
1822 1809 <span class="c"># Return a string containing vector values...</span>
|
|
1823 <a name="StringifyFingerprintsVector-"></a>1810 <span class="k">sub </span><span class="m">StringifyFingerprintsVector</span> <span class="s">{</span>
|
|
1824 1811 <span class="k">my</span><span class="s">(</span><span class="i">$This</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
|
|
1825 1812 <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsVectorString</span><span class="s">)</span><span class="sc">;</span>
|
|
1826 1813
|
|
1827 1814 <span class="c"># Set type, values and value IDs...</span>
|
|
1828 1815 <span class="k">my</span><span class="s">(</span><span class="i">$NumOfValues</span><span class="cm">,</span> <span class="i">$ValuesString</span><span class="cm">,</span> <span class="i">$NumOfValueIDs</span><span class="cm">,</span> <span class="i">$ValueIDsString</span><span class="cm">,</span> <span class="i">$MaxValuesToStringify</span><span class="s">)</span><span class="sc">;</span>
|
|
1829 1816
|
|
1830 1817 <span class="i">$NumOfValues</span> = <span class="i">$This</span><span class="i">->GetNumOfValues</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1831 1818 <span class="i">$MaxValuesToStringify</span> = <span class="n">500</span><span class="sc">;</span>
|
|
1832 1819
|
|
1833 1820 <span class="k">if</span> <span class="s">(</span><span class="i">$NumOfValues</span> < <span class="i">$MaxValuesToStringify</span><span class="s">)</span> <span class="s">{</span>
|
|
1834 1821 <span class="c"># Append all values...</span>
|
|
1835 1822 <span class="i">$ValuesString</span> = <span class="i">$NumOfValues</span> ? <span class="k">join</span> <span class="q">' '</span><span class="cm">,</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">Values</span>}} <span class="co">:</span> <span class="q">'None'</span><span class="sc">;</span>
|
|
1836 1823 <span class="s">}</span>
|
|
1837 1824 <span class="k">else</span> <span class="s">{</span>
|
|
1838 1825 <span class="c"># Truncate values...</span>
|
|
1839 1826 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span><span class="sc">;</span>
|
|
1840 1827 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="s">(</span><span class="i">$MaxValuesToStringify</span> - <span class="n">1</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
1841 1828 <span class="k">push</span> <span class="i">@Values</span><span class="cm">,</span> <span class="i">$This</span>->{<span class="w">Values</span>}[<span class="i">$Index</span>]<span class="sc">;</span>
|
|
1842 1829 <span class="s">}</span>
|
|
1843 1830 <span class="i">$ValuesString</span> = <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@Values</span><span class="s">)</span> . <span class="q">" ..."</span><span class="sc">;</span>
|
|
1844 1831 <span class="s">}</span>
|
|
1845 1832
|
|
1846 1833 <span class="i">$NumOfValueIDs</span> = <span class="i">$This</span><span class="i">->GetNumOfValueIDs</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1847 1834 <span class="k">if</span> <span class="s">(</span><span class="i">$NumOfValueIDs</span> < <span class="i">$MaxValuesToStringify</span><span class="s">)</span> <span class="s">{</span>
|
|
1848 1835 <span class="c"># Append all valueIDs...</span>
|
|
1849 1836 <span class="i">$ValueIDsString</span> = <span class="i">$NumOfValueIDs</span> ? <span class="k">join</span> <span class="q">' '</span><span class="cm">,</span> <span class="i">@</span>{<span class="i">$This</span>->{<span class="w">ValueIDs</span>}} <span class="co">:</span> <span class="q">'None'</span><span class="sc">;</span>
|
|
1850 1837 <span class="s">}</span>
|
|
1851 1838 <span class="k">else</span> <span class="s">{</span>
|
|
1852 1839 <span class="c"># Truncate value IDs...</span>
|
|
1853 1840 <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="cm">,</span> <span class="i">@ValueIDs</span><span class="s">)</span><span class="sc">;</span>
|
|
1854 1841 <span class="i">@ValueIDs</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1855 1842 <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="s">(</span><span class="i">$MaxValuesToStringify</span> - <span class="n">1</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
|
|
1856 1843 <span class="k">push</span> <span class="i">@ValueIDs</span><span class="cm">,</span> <span class="i">$This</span>->{<span class="w">ValueIDs</span>}[<span class="i">$Index</span>]<span class="sc">;</span>
|
|
1857 1844 <span class="s">}</span>
|
|
1858 1845 <span class="i">$ValueIDsString</span> = <span class="k">join</span><span class="s">(</span><span class="q">' '</span><span class="cm">,</span> <span class="i">@ValueIDs</span><span class="s">)</span> . <span class="q">" ..."</span><span class="sc">;</span>
|
|
1859 1846 <span class="s">}</span>
|
|
1860 1847
|
|
1861 1848 <span class="i">$FingerprintsVectorString</span> = <span class="q">"Type: $This->{Type}; NumOfValues: $NumOfValues"</span><span class="sc">;</span>
|
|
1862 1849 <span class="k">if</span> <span class="s">(</span><span class="i">$This</span>->{<span class="w">Type</span>} =~ <span class="q">/^(OrderedNumericalValues|NumericalValues)$/i</span><span class="s">)</span> <span class="s">{</span>
|
|
1863 1850 <span class="k">my</span><span class="s">(</span><span class="i">$NumOfNonZeroValues</span><span class="s">)</span><span class="sc">;</span>
|
|
1864 1851 <span class="i">$NumOfNonZeroValues</span> = <span class="i">$This</span><span class="i">->GetNumOfNonZeroValues</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
|
|
1865 1852 <span class="i">$FingerprintsVectorString</span> .= <span class="q">"; NumOfNonZeroValues: $NumOfNonZeroValues"</span><span class="sc">;</span>
|
|
1866 1853 <span class="s">}</span>
|
|
1867 1854
|
|
1868 1855 <span class="c"># Append all the values and value IDs...</span>
|
|
1869 1856 <span class="k">if</span> <span class="s">(</span><span class="i">$NumOfValues</span> < <span class="i">$MaxValuesToStringify</span><span class="s">)</span> <span class="s">{</span>
|
|
1870 1857 <span class="i">$FingerprintsVectorString</span> .= <span class="q">"; Values: <$ValuesString>; NumOfValueIDs: $NumOfValueIDs; ValueIDs: <$ValueIDsString>"</span><span class="sc">;</span>
|
|
1871 1858 <span class="s">}</span>
|
|
1872 1859 <span class="k">else</span> <span class="s">{</span>
|
|
1873 1860 <span class="i">$FingerprintsVectorString</span> .= <span class="q">"; Values (Truncated after $MaxValuesToStringify): <$ValuesString>; NumOfValueIDs: $NumOfValueIDs; ValueIDs (Truncated after $MaxValuesToStringify): <$ValueIDsString>"</span><span class="sc">;</span>
|
|
1874 1861 <span class="s">}</span>
|
|
1875 1862
|
|
1876 1863 <span class="k">return</span> <span class="i">$FingerprintsVectorString</span><span class="sc">;</span>
|
|
1877 1864 <span class="s">}</span>
|
|
1878 1865
|
|
1879 <a name="EOF-"></a></pre>
|
|
1880 <p> </p>
|
|
1881 <br />
|
|
1882 <center>
|
|
1883 <img src="../../../images/h2o2.png">
|
|
1884 </center>
|
|
1885 </body>
|
|
1886 </html>
|