| 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> |