view docs/scripts/html/code/InfoFingerprintsFiles.html @ 0:4816e4a8ae95 draft default tip

Uploaded
author deepakjadmin
date Wed, 20 Jan 2016 09:23:18 -0500
parents
children
line wrap: on
line source

<html>
<head>
<title>MayaChemTools:Code:InfoFingerprintsFiles.pl</title>
<meta http-equiv="content-type" content="text/html;charset=utf-8">
<link rel="stylesheet" type="text/css" href="../../../css/MayaChemToolsCode.css">
</head>
<body leftmargin="20" rightmargin="20" topmargin="10" bottommargin="10">
<br/>
<center>
<a href="http://www.mayachemtools.org" title="MayaChemTools Home"><img src="../../../images/MayaChemToolsLogo.gif" border="0" alt="MayaChemTools"></a>
</center>
<br/>
<pre>
   1 #!/usr/bin/perl -w
   2 <span class="c">#</span>
   3 <span class="c"># $RCSfile: InfoFingerprintsFiles.pl,v $</span>
   4 <span class="c"># $Date: 2015/02/28 20:46:20 $</span>
   5 <span class="c"># $Revision: 1.20 $</span>
   6 <span class="c">#</span>
   7 <span class="c"># Author: Manish Sud &lt;msud@san.rr.com&gt;</span>
   8 <span class="c">#</span>
   9 <span class="c"># Copyright (C) 2015 Manish Sud. All rights reserved.</span>
  10 <span class="c">#</span>
  11 <span class="c"># This file is part of MayaChemTools.</span>
  12 <span class="c">#</span>
  13 <span class="c"># MayaChemTools is free software; you can redistribute it and/or modify it under</span>
  14 <span class="c"># the terms of the GNU Lesser General Public License as published by the Free</span>
  15 <span class="c"># Software Foundation; either version 3 of the License, or (at your option) any</span>
  16 <span class="c"># later version.</span>
  17 <span class="c">#</span>
  18 <span class="c"># MayaChemTools is distributed in the hope that it will be useful, but without</span>
  19 <span class="c"># any warranty; without even the implied warranty of merchantability of fitness</span>
  20 <span class="c"># for a particular purpose.  See the GNU Lesser General Public License for more</span>
  21 <span class="c"># details.</span>
  22 <span class="c">#</span>
  23 <span class="c"># You should have received a copy of the GNU Lesser General Public License</span>
  24 <span class="c"># along with MayaChemTools; if not, see &lt;http://www.gnu.org/licenses/&gt; or</span>
  25 <span class="c"># write to the Free Software Foundation Inc., 59 Temple Place, Suite 330,</span>
  26 <span class="c"># Boston, MA, 02111-1307, USA.</span>
  27 <span class="c">#</span>
  28 
  29 <span class="k">use</span> <span class="w">strict</span><span class="sc">;</span>
  30 <span class="k">use</span> <span class="w">FindBin</span><span class="sc">;</span> <span class="k">use</span> <span class="w">lib</span> <span class="q">&quot;$FindBin::Bin/../lib&quot;</span><span class="sc">;</span>
  31 <span class="k">use</span> <span class="w">Getopt::Long</span><span class="sc">;</span>
  32 <span class="k">use</span> <span class="w">File::Basename</span><span class="sc">;</span>
  33 <span class="k">use</span> <span class="w">Text::ParseWords</span><span class="sc">;</span>
  34 <span class="k">use</span> <span class="w">Benchmark</span><span class="sc">;</span>
  35 <span class="k">use</span> <span class="w">FileUtil</span><span class="sc">;</span>
  36 <span class="k">use</span> <span class="w">TextUtil</span><span class="sc">;</span>
  37 <span class="k">use</span> <span class="w">Fingerprints::FingerprintsFileUtil</span><span class="sc">;</span>
  38 <span class="k">use</span> <span class="w">Fingerprints::FingerprintsStringUtil</span><span class="sc">;</span>
  39 
  40 <span class="k">my</span><span class="s">(</span><span class="i">$ScriptName</span><span class="cm">,</span> <span class="i">%Options</span><span class="cm">,</span> <span class="i">$StartTime</span><span class="cm">,</span> <span class="i">$EndTime</span><span class="cm">,</span> <span class="i">$TotalTime</span><span class="s">)</span><span class="sc">;</span>
  41 
  42 <span class="c"># Autoflush STDOUT</span>
  43 <span class="i">$|</span> = <span class="n">1</span><span class="sc">;</span>
  44 
  45 <span class="c"># Starting message...</span>
  46 <span class="i">$ScriptName</span> = <span class="i">basename</span><span class="s">(</span><span class="i">$0</span><span class="s">)</span><span class="sc">;</span>
  47 <span class="k">print</span> <span class="q">&quot;\n$ScriptName: Starting...\n\n&quot;</span><span class="sc">;</span>
  48 <span class="i">$StartTime</span> = <span class="w">new</span> <span class="w">Benchmark</span><span class="sc">;</span>
  49 
  50 <span class="c"># Get the options and setup script...</span>
  51 <span class="i">SetupScriptUsage</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
  52 <span class="k">if</span> <span class="s">(</span><span class="i">$Options</span>{<span class="w">help</span>} || <span class="i">@ARGV</span> &lt; <span class="n">1</span><span class="s">)</span> <span class="s">{</span>
  53   <span class="k">die</span> <span class="i">GetUsageFromPod</span><span class="s">(</span><span class="q">&quot;$FindBin::Bin/$ScriptName&quot;</span><span class="s">)</span><span class="sc">;</span>
  54 <span class="s">}</span>
  55 
  56 <span class="k">my</span><span class="s">(</span><span class="i">@FingerprintsFilesList</span><span class="s">)</span><span class="sc">;</span>
  57 <span class="i">@FingerprintsFilesList</span> = <span class="i">ExpandFileNames</span><span class="s">(</span>\<span class="i">@ARGV</span><span class="cm">,</span> <span class="q">&quot;sdf sd fpf fp csv tsv&quot;</span><span class="s">)</span><span class="sc">;</span>
  58 
  59 <span class="c"># Process options...</span>
  60 <span class="k">print</span> <span class="q">&quot;Processing options...\n&quot;</span><span class="sc">;</span>
  61 <span class="k">my</span><span class="s">(</span><span class="i">%OptionsInfo</span><span class="s">)</span><span class="sc">;</span>
  62 <span class="i">ProcessOptions</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
  63 
  64 <span class="c"># Setup information about input files...</span>
  65 <span class="k">print</span> <span class="q">&quot;Checking input fingerprints file(s)...\n&quot;</span><span class="sc">;</span>
  66 <span class="k">my</span><span class="s">(</span><span class="i">%FingerprintsFilesInfo</span><span class="s">)</span><span class="sc">;</span>
  67 <span class="i">RetrieveFingerprintsFilesInfo</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
  68 
  69 <span class="c"># Process input files..</span>
  70 <span class="k">my</span><span class="s">(</span><span class="i">$FileIndex</span><span class="s">)</span><span class="sc">;</span>
  71 <span class="k">if</span> <span class="s">(</span><span class="i">@FingerprintsFilesList</span> &gt; <span class="n">1</span><span class="s">)</span> <span class="s">{</span>
  72   <span class="k">print</span> <span class="q">&quot;\nProcessing fingerprints files...\n&quot;</span><span class="sc">;</span>
  73 <span class="s">}</span>
  74 <span class="k">for</span> <span class="i">$FileIndex</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#FingerprintsFilesList</span><span class="s">)</span> <span class="s">{</span>
  75   <span class="k">if</span> <span class="s">(</span><span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileOkay</span>}[<span class="i">$FileIndex</span>]<span class="s">)</span> <span class="s">{</span>
  76     <span class="k">print</span> <span class="q">&quot;\nProcessing file $FingerprintsFilesList[$FileIndex]...\n&quot;</span><span class="sc">;</span>
  77     <span class="i">ListFingerprintsFileInfo</span><span class="s">(</span><span class="i">$FileIndex</span><span class="s">)</span><span class="sc">;</span>
  78   <span class="s">}</span>
  79 <span class="s">}</span>
  80 <span class="i">ListTotalSizeOfFiles</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
  81 
  82 <span class="k">print</span> <span class="q">&quot;\n$ScriptName:Done...\n\n&quot;</span><span class="sc">;</span>
  83 
  84 <span class="i">$EndTime</span> = <span class="w">new</span> <span class="w">Benchmark</span><span class="sc">;</span>
  85 <span class="i">$TotalTime</span> = <span class="w">timediff</span> <span class="s">(</span><span class="i">$EndTime</span><span class="cm">,</span> <span class="i">$StartTime</span><span class="s">)</span><span class="sc">;</span>
  86 <span class="k">print</span> <span class="q">&quot;Total time: &quot;</span><span class="cm">,</span> <span class="i">timestr</span><span class="s">(</span><span class="i">$TotalTime</span><span class="s">)</span><span class="cm">,</span> <span class="q">&quot;\n&quot;</span><span class="sc">;</span>
  87 
  88 <span class="c">###############################################################################</span>
  89 
  90 <span class="c"># List approptiate information...</span>
  91 <span class="c">#</span>
<a name="ListFingerprintsFileInfo-"></a>  92 <span class="k">sub </span><span class="m">ListFingerprintsFileInfo</span> <span class="s">{</span>
  93   <span class="k">my</span><span class="s">(</span><span class="i">$FileIndex</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
  94   <span class="k">my</span><span class="s">(</span><span class="i">$FileName</span><span class="cm">,</span> <span class="i">$FingerprintsFileIO</span><span class="cm">,</span> <span class="i">$InvalidFingerprintsFileData</span><span class="cm">,</span> <span class="i">$InvalidFingerprintsData</span><span class="cm">,</span> <span class="i">$DataEntryCount</span><span class="cm">,</span> <span class="i">$ValidDataEntryCount</span><span class="cm">,</span> <span class="i">$InvalidDataEntryCount</span><span class="cm">,</span> <span class="i">$MissingDataEntryCount</span><span class="cm">,</span> <span class="i">$BitVectorDataEntryCount</span><span class="cm">,</span> <span class="i">$VectorDataEntryCount</span><span class="cm">,</span> <span class="i">$FingerprintsObject</span><span class="cm">,</span> <span class="i">$FingerprintsType</span><span class="cm">,</span> <span class="i">$TotalBitDensity</span><span class="cm">,</span> <span class="i">$FileType</span><span class="cm">,</span> <span class="i">$DataEntryLabel</span><span class="s">)</span><span class="sc">;</span>
  95 
  96   <span class="i">$FileType</span> = <span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileType</span>}[<span class="i">$FileIndex</span>]<span class="sc">;</span>
  97   <span class="i">$DataEntryLabel</span> = <span class="s">(</span><span class="i">$FileType</span> =~ <span class="q">/^SD$/i</span><span class="s">)</span> ? <span class="q">&#39;compounds&#39;</span> <span class="co">:</span> <span class="q">&#39;lines&#39;</span><span class="sc">;</span>
  98 
  99   <span class="s">(</span><span class="i">$DataEntryCount</span><span class="cm">,</span> <span class="i">$ValidDataEntryCount</span><span class="cm">,</span> <span class="i">$InvalidDataEntryCount</span><span class="cm">,</span> <span class="i">$MissingDataEntryCount</span><span class="cm">,</span> <span class="i">$BitVectorDataEntryCount</span><span class="cm">,</span> <span class="i">$VectorDataEntryCount</span><span class="cm">,</span> <span class="i">$TotalBitDensity</span><span class="s">)</span> = <span class="s">(</span><span class="n">0</span><span class="s">)</span> x <span class="n">7</span><span class="sc">;</span>
 100 
 101   <span class="i">$FingerprintsFileIO</span> = <span class="i">Fingerprints::FingerprintsFileUtil::NewFingerprintsFileIO</span><span class="s">(</span><span class="i">%</span>{<span class="i">$FingerprintsFilesInfo</span>{<span class="w">FingerprintsFileIOParameters</span>}[<span class="i">$FileIndex</span>]}<span class="s">)</span><span class="sc">;</span>
 102   <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;Open</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 103 
 104   <span class="i">$InvalidFingerprintsFileData</span> = <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;IsFingerprintsFileDataValid</span><span class="s">(</span><span class="s">)</span> ? <span class="n">0</span> <span class="co">:</span> <span class="n">1</span><span class="sc">;</span>
 105 
 106   <span class="j">FINGERPRINTS:</span> <span class="k">while</span> <span class="s">(</span><span class="i">$FingerprintsFileIO</span><span class="i">-&gt;Read</span><span class="s">(</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
 107     <span class="i">$DataEntryCount</span>++<span class="sc">;</span>
 108 
 109     <span class="c"># Missing data...</span>
 110     <span class="k">if</span> <span class="s">(</span><span class="i">$InvalidFingerprintsFileData</span><span class="s">)</span> <span class="s">{</span>
 111       <span class="i">$MissingDataEntryCount</span>++<span class="sc">;</span>
 112       <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ValidateData</span>} || <span class="i">$OptionsInfo</span>{<span class="w">CountEmptyFingerprints</span>}<span class="s">)</span> <span class="s">{</span>
 113         <span class="i">ListEmptyOrInvalidFingerprintsDataInfo</span><span class="s">(</span><span class="q">&#39;EmptyData&#39;</span><span class="cm">,</span> <span class="i">$FingerprintsFileIO</span><span class="cm">,</span> <span class="i">$FileType</span><span class="s">)</span><span class="sc">;</span>
 114       <span class="s">}</span>
 115       <span class="k">next</span> <span class="j">FINGERPRINTS</span><span class="sc">;</span>
 116     <span class="s">}</span>
 117     <span class="i">$InvalidFingerprintsData</span> = <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;IsFingerprintsDataValid</span><span class="s">(</span><span class="s">)</span> ? <span class="n">0</span> <span class="co">:</span> <span class="n">1</span><span class="sc">;</span>
 118 
 119     <span class="c"># Invalid data...</span>
 120     <span class="k">if</span> <span class="s">(</span><span class="i">$InvalidFingerprintsData</span><span class="s">)</span> <span class="s">{</span>
 121       <span class="i">$InvalidDataEntryCount</span>++<span class="sc">;</span>
 122       <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ValidateData</span>}<span class="s">)</span> <span class="s">{</span>
 123         <span class="i">ListEmptyOrInvalidFingerprintsDataInfo</span><span class="s">(</span><span class="q">&#39;InvalidData&#39;</span><span class="cm">,</span> <span class="i">$FingerprintsFileIO</span><span class="cm">,</span> <span class="i">$FileType</span><span class="s">)</span><span class="sc">;</span>
 124       <span class="s">}</span>
 125       <span class="k">next</span> <span class="j">FINGERPRINTS</span><span class="sc">;</span>
 126     <span class="s">}</span>
 127     <span class="i">$ValidDataEntryCount</span>++<span class="sc">;</span>
 128 
 129     <span class="i">$FingerprintsObject</span> = <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetFingerprints</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 130     <span class="i">$FingerprintsType</span> = <span class="i">$FingerprintsObject</span><span class="i">-&gt;GetVectorType</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 131 
 132     <span class="k">if</span> <span class="s">(</span><span class="i">$FingerprintsType</span> =~ <span class="q">/^FingerprintsBitVector$/i</span><span class="s">)</span> <span class="s">{</span>
 133       <span class="i">$BitVectorDataEntryCount</span>++<span class="sc">;</span>
 134       <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListAverageBitDensity</span>}<span class="s">)</span> <span class="s">{</span>
 135         <span class="i">$TotalBitDensity</span> += <span class="i">$FingerprintsObject</span><span class="i">-&gt;GetFingerprintsBitDensity</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 136       <span class="s">}</span>
 137     <span class="s">}</span>
 138     <span class="k">elsif</span> <span class="s">(</span><span class="i">$FingerprintsType</span> =~ <span class="q">/^FingerprintsVector$/i</span><span class="s">)</span> <span class="s">{</span>
 139       <span class="i">$VectorDataEntryCount</span>++<span class="sc">;</span>
 140     <span class="s">}</span>
 141 
 142     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsDataEntryInfo</span>}<span class="s">)</span> <span class="s">{</span>
 143       <span class="i">ListFingerprintsDataEntryInfo</span><span class="s">(</span><span class="i">$FingerprintsFileIO</span><span class="cm">,</span> <span class="i">$FileType</span><span class="s">)</span><span class="sc">;</span>
 144     <span class="s">}</span>
 145 
 146   <span class="s">}</span>
 147   <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;Close</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 148 
 149   <span class="k">print</span> <span class="q">&quot;\nFingerprints file type: $FileType\n&quot;</span><span class="sc">;</span>
 150   <span class="k">if</span> <span class="s">(</span><span class="i">$FileType</span> =~ <span class="q">/^SD$/i</span><span class="s">)</span> <span class="s">{</span>
 151     <span class="k">print</span> <span class="q">&quot;Number of compounds: $DataEntryCount\n&quot;</span><span class="sc">;</span>
 152   <span class="s">}</span>
 153   <span class="k">else</span> <span class="s">{</span>
 154     <span class="k">print</span> <span class="q">&quot;Number of data lines: $DataEntryCount\n&quot;</span><span class="sc">;</span>
 155   <span class="s">}</span>
 156 
 157   <span class="i">ListFileTypeHeaderInfo</span><span class="s">(</span><span class="i">$FingerprintsFileIO</span><span class="cm">,</span> <span class="i">$FileType</span><span class="s">)</span><span class="sc">;</span>
 158 
 159   <span class="k">print</span> <span class="q">&quot;\nNumber of $DataEntryLabel with valid fingerprints string data: $ValidDataEntryCount\n&quot;</span><span class="sc">;</span>
 160   <span class="k">print</span> <span class="q">&quot;Number of $DataEntryLabel with bit-vector fingerprints string data: $BitVectorDataEntryCount\n&quot;</span><span class="sc">;</span>
 161   <span class="k">print</span> <span class="q">&quot;Number of $DataEntryLabel with vector fingerprints string data: $VectorDataEntryCount\n&quot;</span><span class="sc">;</span>
 162 
 163   <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">CountEmptyFingerprints</span>}<span class="s">)</span> <span class="s">{</span>
 164     <span class="k">print</span> <span class="q">&quot;Number of $DataEntryLabel with missing fingerprints data: $MissingDataEntryCount\n&quot;</span><span class="sc">;</span>
 165     <span class="k">print</span> <span class="q">&quot;Number of $DataEntryLabel with invalid fingerprints data: $InvalidDataEntryCount\n&quot;</span><span class="sc">;</span>
 166   <span class="s">}</span>
 167 
 168   <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListAverageBitDensity</span>} &amp;&amp; <span class="i">$BitVectorDataEntryCount</span><span class="s">)</span> <span class="s">{</span>
 169     <span class="k">my</span><span class="s">(</span><span class="i">$AverageBitDensity</span><span class="s">)</span><span class="sc">;</span>
 170     <span class="i">$AverageBitDensity</span> = <span class="i">$TotalBitDensity</span>/<span class="i">$BitVectorDataEntryCount</span><span class="sc">;</span>
 171     <span class="i">$AverageBitDensity</span> = <span class="k">sprintf</span><span class="s">(</span><span class="q">&quot;%.2f&quot;</span><span class="cm">,</span> <span class="i">$AverageBitDensity</span><span class="s">)</span> + <span class="n">0</span><span class="sc">;</span>
 172     <span class="k">print</span> <span class="q">&quot;\nAverage bit density: $AverageBitDensity\n&quot;</span><span class="sc">;</span>
 173   <span class="s">}</span>
 174 
 175 
 176   <span class="c"># File size and modification information...</span>
 177   <span class="k">print</span> <span class="q">&quot;\nFile size: &quot;</span><span class="cm">,</span> <span class="i">FormatFileSize</span><span class="s">(</span><span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileSize</span>}[<span class="i">$FileIndex</span>]<span class="s">)</span><span class="cm">,</span> <span class="q">&quot; \n&quot;</span><span class="sc">;</span>
 178   <span class="k">print</span> <span class="q">&quot;Last modified: &quot;</span><span class="cm">,</span> <span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileLastModified</span>}[<span class="i">$FileIndex</span>]<span class="cm">,</span> <span class="q">&quot; \n&quot;</span><span class="sc">;</span>
 179 <span class="s">}</span>
 180 
 181 <span class="c"># List empty or invalid fingerprints file data information...</span>
 182 <span class="c">#</span>
<a name="ListEmptyOrInvalidFingerprintsDataInfo-"></a> 183 <span class="k">sub </span><span class="m">ListEmptyOrInvalidFingerprintsDataInfo</span> <span class="s">{</span>
 184   <span class="k">my</span><span class="s">(</span><span class="i">$Mode</span><span class="cm">,</span> <span class="i">$FingerprintsFileIO</span><span class="cm">,</span> <span class="i">$FileType</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
 185   <span class="k">my</span><span class="s">(</span><span class="i">$ModeInfo</span><span class="s">)</span><span class="sc">;</span>
 186 
 187   <span class="i">$ModeInfo</span> = <span class="s">(</span><span class="i">$Mode</span> =~ <span class="q">/^EmptyData$/i</span><span class="s">)</span> ? <span class="q">&quot;no&quot;</span> <span class="co">:</span> <span class="q">&quot;invalid&quot;</span><span class="sc">;</span>
 188 
 189   <span class="k">if</span> <span class="s">(</span><span class="i">$FileType</span> =~ <span class="q">/^SD$/i</span><span class="s">)</span> <span class="s">{</span>
 190     <span class="k">my</span><span class="s">(</span><span class="i">$CmpdNum</span><span class="cm">,</span> <span class="i">$CmpdString</span><span class="s">)</span><span class="sc">;</span>
 191 
 192     <span class="i">$CmpdNum</span> = <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetCompoundNum</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 193     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">DetailLevel</span>} &gt;= <span class="n">3</span> <span class="s">)</span> <span class="s">{</span>
 194       <span class="i">$CmpdString</span> = <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetCompoundString</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 195       <span class="k">print</span> <span class="q">&quot;Compound number $CmpdNum contains $ModeInfo fingerprints data: $CmpdString \n&quot;</span><span class="sc">;</span>
 196     <span class="s">}</span>
 197     <span class="k">elsif</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">DetailLevel</span>} &gt;= <span class="n">1</span> <span class="s">)</span> <span class="s">{</span>
 198       <span class="k">print</span> <span class="q">&quot;Compound number $CmpdNum contains $ModeInfo fingerprints data...\n&quot;</span><span class="sc">;</span>
 199     <span class="s">}</span>
 200   <span class="s">}</span>
 201   <span class="k">else</span> <span class="s">{</span>
 202     <span class="k">my</span><span class="s">(</span><span class="i">$LineNum</span><span class="cm">,</span> <span class="i">$DataLine</span><span class="s">)</span><span class="sc">;</span>
 203 
 204     <span class="i">$LineNum</span> = <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetLineNum</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 205     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">DetailLevel</span>} &gt;= <span class="n">3</span> <span class="s">)</span> <span class="s">{</span>
 206       <span class="i">$DataLine</span> = <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetDataLine</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 207       <span class="k">print</span> <span class="q">&quot;Data line number $LineNum contains $ModeInfo fingerprints data: $DataLine \n&quot;</span><span class="sc">;</span>
 208     <span class="s">}</span>
 209     <span class="k">elsif</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">DetailLevel</span>} &gt;= <span class="n">1</span> <span class="s">)</span> <span class="s">{</span>
 210       <span class="k">print</span> <span class="q">&quot;Data line number $LineNum contains $ModeInfo fingerprints data...\n&quot;</span><span class="sc">;</span>
 211     <span class="s">}</span>
 212   <span class="s">}</span>
 213 <span class="s">}</span>
 214 
 215 <span class="c"># List detailed information about fingerprints data entry...</span>
 216 <span class="c">#</span>
<a name="ListFingerprintsDataEntryInfo-"></a> 217 <span class="k">sub </span><span class="m">ListFingerprintsDataEntryInfo</span> <span class="s">{</span>
 218   <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsFileIO</span><span class="cm">,</span> <span class="i">$FileType</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
 219   <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsObject</span><span class="cm">,</span> <span class="i">$FingerprintsString</span><span class="cm">,</span> <span class="i">$FingerprintsType</span><span class="cm">,</span> <span class="i">$FingerprintsDescription</span><span class="cm">,</span> <span class="i">$FingerprintsSize</span><span class="cm">,</span> <span class="i">$FingerprintsBitStringFormat</span><span class="cm">,</span> <span class="i">$FingerprintsBitOrder</span><span class="cm">,</span> <span class="i">$BitDensity</span><span class="cm">,</span> <span class="i">$NumOfOnBits</span><span class="cm">,</span> <span class="i">$FingerprintsVectorValuesType</span><span class="cm">,</span> <span class="i">$FingerprintsVectorValuesFormat</span><span class="cm">,</span> <span class="i">$NumOfNonZeroValues</span><span class="s">)</span><span class="sc">;</span>
 220 
 221   <span class="i">$FingerprintsObject</span> = <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetFingerprints</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 222   <span class="i">$FingerprintsString</span> = <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetFingerprintsString</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 223 
 224   <span class="i">$FingerprintsType</span> = <span class="i">$FingerprintsObject</span><span class="i">-&gt;GetVectorType</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 225 
 226   <span class="k">if</span> <span class="s">(</span><span class="i">$FingerprintsType</span> =~ <span class="q">/^FingerprintsBitVector$/i</span><span class="s">)</span> <span class="s">{</span>
 227     <span class="i">$BitDensity</span> = <span class="q">&#39;&#39;</span><span class="sc">;</span>
 228     <span class="i">$NumOfOnBits</span> = <span class="q">&#39;&#39;</span><span class="sc">;</span>
 229 
 230     <span class="s">(</span><span class="i">$FingerprintsType</span><span class="cm">,</span> <span class="i">$FingerprintsDescription</span><span class="cm">,</span> <span class="i">$FingerprintsSize</span><span class="cm">,</span> <span class="i">$FingerprintsBitStringFormat</span><span class="cm">,</span> <span class="i">$FingerprintsBitOrder</span><span class="s">)</span> = <span class="i">Fingerprints::FingerprintsStringUtil::GetFingerprintsStringValues</span><span class="s">(</span><span class="i">$FingerprintsString</span><span class="s">)</span><span class="sc">;</span>
 231 
 232     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListBitDensity</span>} || <span class="i">$OptionsInfo</span>{<span class="w">ListNumOfOnBits</span>}<span class="s">)</span> <span class="s">{</span>
 233       <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListBitDensity</span>}<span class="s">)</span> <span class="s">{</span>
 234         <span class="i">$BitDensity</span> = <span class="i">$FingerprintsObject</span><span class="i">-&gt;GetFingerprintsBitDensity</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 235       <span class="s">}</span>
 236       <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListNumOfOnBits</span>}<span class="s">)</span> <span class="s">{</span>
 237         <span class="i">$NumOfOnBits</span> = <span class="i">$FingerprintsObject</span><span class="i">-&gt;GetNumOfSetBits</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 238       <span class="s">}</span>
 239     <span class="s">}</span>
 240   <span class="s">}</span>
 241   <span class="k">elsif</span> <span class="s">(</span><span class="i">$FingerprintsType</span> =~ <span class="q">/^FingerprintsVector$/i</span><span class="s">)</span> <span class="s">{</span>
 242     <span class="i">$NumOfNonZeroValues</span> = <span class="q">&#39;&#39;</span><span class="sc">;</span>
 243 
 244     <span class="s">(</span><span class="i">$FingerprintsType</span><span class="cm">,</span> <span class="i">$FingerprintsDescription</span><span class="cm">,</span> <span class="i">$FingerprintsSize</span><span class="cm">,</span> <span class="i">$FingerprintsVectorValuesType</span><span class="cm">,</span> <span class="i">$FingerprintsVectorValuesFormat</span><span class="s">)</span> = <span class="i">Fingerprints::FingerprintsStringUtil::GetFingerprintsStringValues</span><span class="s">(</span><span class="i">$FingerprintsString</span><span class="s">)</span><span class="sc">;</span>
 245 
 246     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListNumOfNonZeroValues</span>}<span class="s">)</span> <span class="s">{</span>
 247       <span class="k">if</span> <span class="s">(</span><span class="i">$FingerprintsVectorValuesType</span> =~ <span class="q">/^AlphaNumericalValues$/i</span><span class="s">)</span> <span class="s">{</span>
 248         <span class="i">$NumOfNonZeroValues</span> = <span class="q">&#39;NA&#39;</span><span class="sc">;</span>
 249       <span class="s">}</span>
 250       <span class="k">else</span> <span class="s">{</span>
 251         <span class="i">$NumOfNonZeroValues</span> = <span class="i">$FingerprintsObject</span><span class="i">-&gt;GetNumOfNonZeroValues</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 252       <span class="s">}</span>
 253     <span class="s">}</span>
 254   <span class="s">}</span>
 255 
 256   <span class="k">if</span> <span class="s">(</span><span class="i">$FileType</span> =~ <span class="q">/^SD$/i</span><span class="s">)</span> <span class="s">{</span>
 257     <span class="k">print</span> <span class="q">&quot;Compound number: &quot;</span> . <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetCompoundNum</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 258   <span class="s">}</span>
 259   <span class="k">else</span> <span class="s">{</span>
 260     <span class="k">print</span> <span class="q">&quot;Data line number: &quot;</span> . <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetLineNum</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 261   <span class="s">}</span>
 262 
 263   <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsType</span>}<span class="s">)</span> <span class="s">{</span>
 264     <span class="k">print</span> <span class="q">&quot;; FPType: $FingerprintsType&quot;</span><span class="sc">;</span>
 265   <span class="s">}</span>
 266   <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsDescription</span>}<span class="s">)</span> <span class="s">{</span>
 267     <span class="k">print</span> <span class="q">&quot;; FPDescription: $FingerprintsDescription&quot;</span><span class="sc">;</span>
 268   <span class="s">}</span>
 269   <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsSize</span>}<span class="s">)</span> <span class="s">{</span>
 270     <span class="k">print</span> <span class="q">&quot;; FPSize: $FingerprintsSize&quot;</span><span class="sc">;</span>
 271   <span class="s">}</span>
 272 
 273   <span class="k">if</span> <span class="s">(</span><span class="i">$FingerprintsType</span> =~ <span class="q">/^FingerprintsBitVector$/i</span><span class="s">)</span> <span class="s">{</span>
 274     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsBitStringFormat</span>}<span class="s">)</span> <span class="s">{</span>
 275       <span class="k">print</span> <span class="q">&quot;; FPBitStringFormat: $FingerprintsBitStringFormat&quot;</span><span class="sc">;</span>
 276     <span class="s">}</span>
 277     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsBitOrder</span>}<span class="s">)</span> <span class="s">{</span>
 278       <span class="k">print</span> <span class="q">&quot;; FPBitOrder: $FingerprintsBitOrder&quot;</span><span class="sc">;</span>
 279     <span class="s">}</span>
 280     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListBitDensity</span>}<span class="s">)</span> <span class="s">{</span>
 281       <span class="k">print</span> <span class="q">&quot;; BitDensity: $BitDensity&quot;</span><span class="sc">;</span>
 282     <span class="s">}</span>
 283     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListNumOfOnBits</span>}<span class="s">)</span> <span class="s">{</span>
 284       <span class="k">print</span> <span class="q">&quot;; NumOfOnBits: $NumOfOnBits&quot;</span><span class="sc">;</span>
 285     <span class="s">}</span>
 286   <span class="s">}</span>
 287   <span class="k">elsif</span> <span class="s">(</span><span class="i">$FingerprintsType</span> =~ <span class="q">/^FingerprintsVector$/i</span><span class="s">)</span> <span class="s">{</span>
 288     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsVectorValuesType</span>}<span class="s">)</span> <span class="s">{</span>
 289       <span class="k">print</span> <span class="q">&quot;; FPVectorValuesType: $FingerprintsVectorValuesType&quot;</span><span class="sc">;</span>
 290     <span class="s">}</span>
 291     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsVectorValuesFormat</span>}<span class="s">)</span> <span class="s">{</span>
 292       <span class="k">print</span> <span class="q">&quot;; FPVectorValuesFormat: $FingerprintsVectorValuesFormat&quot;</span><span class="sc">;</span>
 293     <span class="s">}</span>
 294     <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListNumOfNonZeroValues</span>}<span class="s">)</span> <span class="s">{</span>
 295       <span class="k">print</span> <span class="q">&quot;; NumOfNonZeroValues: $NumOfNonZeroValues&quot;</span><span class="sc">;</span>
 296     <span class="s">}</span>
 297   <span class="s">}</span>
 298   <span class="k">print</span> <span class="q">&quot;\n&quot;</span><span class="sc">;</span>
 299 <span class="s">}</span>
 300 
 301 <span class="c"># List file type header information...</span>
 302 <span class="c">#</span>
<a name="ListFileTypeHeaderInfo-"></a> 303 <span class="k">sub </span><span class="m">ListFileTypeHeaderInfo</span> <span class="s">{</span>
 304   <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsFileIO</span><span class="cm">,</span> <span class="i">$FileType</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span>
 305   <span class="k">my</span><span class="s">(</span><span class="i">$Key</span><span class="cm">,</span> <span class="i">$Value</span><span class="cm">,</span> <span class="i">@DataColLabels</span><span class="cm">,</span> <span class="i">%HeaderDataKeysAndValues</span><span class="s">)</span><span class="sc">;</span>
 306 
 307   <span class="k">if</span> <span class="s">(</span><span class="i">$FileType</span> =~ <span class="q">/^Text$/i</span><span class="s">)</span> <span class="s">{</span>
 308     <span class="i">@DataColLabels</span> = <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetDataColLabels</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 309     <span class="k">print</span> <span class="q">&quot;Number of columns: &quot;</span> . <span class="k">scalar</span> <span class="i">@DataColLabels</span> . <span class="q">&quot;\n&quot;</span><span class="sc">;</span>
 310     <span class="k">print</span> <span class="q">&quot;Column labels: &quot;</span><span class="cm">,</span> <span class="i">JoinWords</span><span class="s">(</span>\<span class="i">@DataColLabels</span><span class="cm">,</span> <span class="q">&quot;, &quot;</span><span class="cm">,</span> <span class="n">1</span><span class="s">)</span><span class="cm">,</span> <span class="q">&quot;\n&quot;</span><span class="sc">;</span>
 311   <span class="s">}</span>
 312   <span class="k">elsif</span> <span class="s">(</span><span class="i">$FileType</span> =~ <span class="q">/^FP$/i</span><span class="s">)</span> <span class="s">{</span>
 313     <span class="i">%HeaderDataKeysAndValues</span> = <span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetHeaderDataKeysAndValues</span><span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 314 
 315     <span class="k">print</span> <span class="q">&quot;\nFP file header data keys and values: \n#\n&quot;</span><span class="sc">;</span>
 316     <span class="k">for</span> <span class="i">$Key</span> <span class="s">(</span><span class="i">$FingerprintsFileIO</span><span class="i">-&gt;GetHeaderDataKeys</span><span class="s">(</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
 317       <span class="i">$Value</span> = <span class="i">$HeaderDataKeysAndValues</span>{<span class="i">$Key</span>}<span class="sc">;</span>
 318       <span class="k">print</span> <span class="q">&quot;# $Key = $Value\n&quot;</span><span class="sc">;</span>
 319     <span class="s">}</span>
 320     <span class="k">print</span> <span class="q">&quot;#\n&quot;</span><span class="sc">;</span>
 321   <span class="s">}</span>
 322 <span class="s">}</span>
 323 
 324 <span class="c"># Total size of all the fiels...</span>
<a name="ListTotalSizeOfFiles-"></a> 325 <span class="k">sub </span><span class="m">ListTotalSizeOfFiles</span> <span class="s">{</span>
 326   <span class="k">my</span><span class="s">(</span><span class="i">$FileOkayCount</span><span class="cm">,</span> <span class="i">$TotalSize</span><span class="cm">,</span> <span class="i">$Index</span><span class="s">)</span><span class="sc">;</span>
 327 
 328   <span class="i">$FileOkayCount</span> = <span class="n">0</span><span class="sc">;</span>
 329   <span class="i">$TotalSize</span> = <span class="n">0</span><span class="sc">;</span>
 330 
 331   <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#FingerprintsFilesList</span><span class="s">)</span> <span class="s">{</span>
 332     <span class="k">if</span> <span class="s">(</span><span class="i">$FingerprintsFilesList</span>[<span class="i">$Index</span>]<span class="s">)</span> <span class="s">{</span>
 333       <span class="i">$FileOkayCount</span>++<span class="sc">;</span>
 334       <span class="i">$TotalSize</span> += <span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileSize</span>}[<span class="i">$Index</span>]<span class="sc">;</span>
 335     <span class="s">}</span>
 336   <span class="s">}</span>
 337   <span class="k">if</span> <span class="s">(</span><span class="i">$FileOkayCount</span> &gt; <span class="n">1</span><span class="s">)</span> <span class="s">{</span>
 338     <span class="k">print</span> <span class="q">&quot;\nTotal size of $FileOkayCount files: &quot;</span><span class="cm">,</span> <span class="i">FormatFileSize</span><span class="s">(</span><span class="i">$TotalSize</span><span class="s">)</span><span class="cm">,</span> <span class="q">&quot;\n&quot;</span><span class="sc">;</span>
 339   <span class="s">}</span>
 340 <span class="s">}</span>
 341 
 342 <span class="c"># Retrieve information about fingerprints files...</span>
 343 <span class="c">#</span>
<a name="RetrieveFingerprintsFilesInfo-"></a> 344 <span class="k">sub </span><span class="m">RetrieveFingerprintsFilesInfo</span> <span class="s">{</span>
 345   <span class="k">my</span><span class="s">(</span><span class="i">$FingerprintsFile</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">$FileDir</span><span class="cm">,</span> <span class="i">$FileExt</span><span class="cm">,</span> <span class="i">$FileName</span><span class="cm">,</span> <span class="i">$FileType</span><span class="cm">,</span> <span class="i">$InDelim</span><span class="cm">,</span> <span class="i">$ModifiedTimeString</span><span class="cm">,</span> <span class="i">$ModifiedDateString</span><span class="cm">,</span> <span class="i">%FingerprintsFileIOParameters</span><span class="s">)</span><span class="sc">;</span>
 346 
 347   <span class="i">%FingerprintsFilesInfo</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 348   <span class="i">@</span>{<span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileOkay</span>}} = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 349   <span class="i">@</span>{<span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileType</span>}} = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 350   <span class="i">@</span>{<span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileSize</span>}} = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 351   <span class="i">@</span>{<span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileLastModified</span>}} = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 352   <span class="i">@</span>{<span class="i">$FingerprintsFilesInfo</span>{<span class="w">InDelim</span>}} = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 353 
 354   <span class="i">@</span>{<span class="i">$FingerprintsFilesInfo</span>{<span class="w">FingerprintsFileIOParameters</span>}} = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 355 
 356   <span class="j">FILELIST:</span> <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#FingerprintsFilesList</span><span class="s">)</span> <span class="s">{</span>
 357     <span class="i">$FingerprintsFile</span> = <span class="i">$FingerprintsFilesList</span>[<span class="i">$Index</span>]<span class="sc">;</span>
 358 
 359     <span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileOkay</span>}[<span class="i">$Index</span>] = <span class="n">0</span><span class="sc">;</span>
 360     <span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileType</span>}[<span class="i">$Index</span>] = <span class="q">&#39;&#39;</span><span class="sc">;</span>
 361     <span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileSize</span>}[<span class="i">$Index</span>] = <span class="n">0</span><span class="sc">;</span>
 362     <span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileLastModified</span>}[<span class="i">$Index</span>] = <span class="q">&#39;&#39;</span><span class="sc">;</span>
 363     <span class="i">$FingerprintsFilesInfo</span>{<span class="w">InDelim</span>}[<span class="i">$Index</span>] = <span class="q">&quot;&quot;</span><span class="sc">;</span>
 364 
 365     <span class="i">%</span>{<span class="i">$FingerprintsFilesInfo</span>{<span class="w">FingerprintsFileIOParameters</span>}[<span class="i">$Index</span>]} = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 366 
 367     <span class="i">$FingerprintsFile</span> = <span class="i">$FingerprintsFilesList</span>[<span class="i">$Index</span>]<span class="sc">;</span>
 368     <span class="k">if</span> <span class="s">(</span>!<span class="s">(</span><span class="k">-e</span> <span class="i">$FingerprintsFile</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
 369       <span class="k">warn</span> <span class="q">&quot;Warning: Ignoring file $FingerprintsFile: It doesn&#39;t exist\n&quot;</span><span class="sc">;</span>
 370       <span class="k">next</span> <span class="j">FILELIST</span><span class="sc">;</span>
 371     <span class="s">}</span>
 372 
 373     <span class="i">$FileType</span> = <span class="i">Fingerprints::FingerprintsFileUtil::GetFingerprintsFileType</span><span class="s">(</span><span class="i">$FingerprintsFile</span><span class="s">)</span><span class="sc">;</span>
 374     <span class="k">if</span> <span class="s">(</span><span class="i">IsEmpty</span><span class="s">(</span><span class="i">$FileType</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
 375       <span class="k">warn</span> <span class="q">&quot;Warning: Ignoring file $FingerprintsFile: It&#39;s not a fingerprints file\n&quot;</span><span class="sc">;</span>
 376       <span class="k">next</span> <span class="j">FILELIST</span><span class="sc">;</span>
 377     <span class="s">}</span>
 378 
 379     <span class="i">$FileDir</span> = <span class="q">&quot;&quot;</span><span class="sc">;</span> <span class="i">$FileName</span> = <span class="q">&quot;&quot;</span><span class="sc">;</span> <span class="i">$FileExt</span> = <span class="q">&quot;&quot;</span><span class="sc">;</span>
 380     <span class="s">(</span><span class="i">$FileDir</span><span class="cm">,</span> <span class="i">$FileName</span><span class="cm">,</span> <span class="i">$FileExt</span><span class="s">)</span> = <span class="i">ParseFileName</span><span class="s">(</span><span class="i">$FingerprintsFile</span><span class="s">)</span><span class="sc">;</span>
 381 
 382     <span class="i">$InDelim</span> = <span class="s">(</span><span class="i">$FileExt</span> =~ <span class="q">/^tsv$/i</span><span class="s">)</span> ? <span class="q">&#39;Tab&#39;</span> <span class="co">:</span> <span class="i">$OptionsInfo</span>{<span class="w">InDelim</span>}<span class="sc">;</span>
 383 
 384     <span class="c"># Setup FingerprintsFileIO parameters...</span>
 385     <span class="i">%FingerprintsFileIOParameters</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 386     <span class="j">FILEIOPARAMETERS:</span> <span class="s">{</span>
 387       <span class="k">if</span> <span class="s">(</span><span class="i">$FileType</span> =~ <span class="q">/^SD$/i</span><span class="s">)</span> <span class="s">{</span>
 388         <span class="i">%FingerprintsFileIOParameters</span> = <span class="s">(</span><span class="q">&#39;Name&#39;</span> <span class="cm">=&gt;</span> <span class="i">$FingerprintsFile</span><span class="cm">,</span> <span class="q">&#39;Mode&#39;</span> <span class="cm">=&gt;</span> <span class="q">&#39;Read&#39;</span><span class="cm">,</span> <span class="q">&#39;ValidateData&#39;</span> <span class="cm">=&gt;</span> <span class="i">$OptionsInfo</span>{<span class="w">ValidateData</span>}<span class="cm">,</span> <span class="q">&#39;DetailLevel&#39;</span> <span class="cm">=&gt;</span> <span class="n">1</span><span class="cm">,</span> <span class="q">&#39;FingerprintsFieldLabel&#39;</span> <span class="cm">=&gt;</span> <span class="i">$OptionsInfo</span>{<span class="w">FingerprintsFieldLabel</span>}<span class="s">)</span><span class="sc">;</span>
 389         <span class="k">last</span> <span class="j">FILEIOPARAMETERS</span><span class="sc">;</span>
 390       <span class="s">}</span>
 391       <span class="k">if</span> <span class="s">(</span><span class="i">$FileType</span> =~ <span class="q">/^FP$/i</span><span class="s">)</span> <span class="s">{</span>
 392         <span class="i">%FingerprintsFileIOParameters</span> = <span class="s">(</span><span class="q">&#39;Name&#39;</span> <span class="cm">=&gt;</span> <span class="i">$FingerprintsFile</span><span class="cm">,</span> <span class="q">&#39;Mode&#39;</span> <span class="cm">=&gt;</span> <span class="q">&#39;Read&#39;</span><span class="cm">,</span> <span class="q">&#39;ValidateData&#39;</span> <span class="cm">=&gt;</span> <span class="i">$OptionsInfo</span>{<span class="w">ValidateData</span>}<span class="cm">,</span> <span class="q">&#39;DetailLevel&#39;</span> <span class="cm">=&gt;</span> <span class="n">1</span><span class="s">)</span><span class="sc">;</span>
 393         <span class="k">last</span> <span class="j">FILEIOPARAMETERS</span><span class="sc">;</span>
 394       <span class="s">}</span>
 395       <span class="k">if</span> <span class="s">(</span><span class="i">$FileType</span> =~ <span class="q">/^Text$/i</span><span class="s">)</span> <span class="s">{</span>
 396         <span class="i">%FingerprintsFileIOParameters</span> = <span class="s">(</span><span class="q">&#39;Name&#39;</span> <span class="cm">=&gt;</span> <span class="i">$FingerprintsFile</span><span class="cm">,</span> <span class="q">&#39;Mode&#39;</span> <span class="cm">=&gt;</span> <span class="q">&#39;Read&#39;</span><span class="cm">,</span> <span class="q">&#39;ValidateData&#39;</span> <span class="cm">=&gt;</span> <span class="i">$OptionsInfo</span>{<span class="w">ValidateData</span>}<span class="cm">,</span> <span class="q">&#39;DetailLevel&#39;</span> <span class="cm">=&gt;</span> <span class="n">1</span><span class="cm">,</span> <span class="q">&#39;FingerprintsCol&#39;</span> <span class="cm">=&gt;</span> <span class="i">$OptionsInfo</span>{<span class="w">FingerprintsCol</span>}<span class="cm">,</span> <span class="q">&#39;ColMode&#39;</span> <span class="cm">=&gt;</span> <span class="i">$OptionsInfo</span>{<span class="w">ColMode</span>}<span class="cm">,</span> <span class="q">&#39;InDelim&#39;</span> <span class="cm">=&gt;</span> <span class="i">$OptionsInfo</span>{<span class="w">InDelim</span>}<span class="s">)</span><span class="sc">;</span>
 397         <span class="k">last</span> <span class="j">FILEIOPARAMETERS</span><span class="sc">;</span>
 398       <span class="s">}</span>
 399       <span class="k">warn</span> <span class="q">&quot;Warning: File type for fingerprints file, $FingerprintsFile, is not valid. Supported file types: SD, FP or Text\n&quot;</span><span class="sc">;</span>
 400       <span class="k">next</span> <span class="j">FILELIST</span><span class="sc">;</span>
 401     <span class="s">}</span>
 402 
 403     <span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileOkay</span>}[<span class="i">$Index</span>] = <span class="n">1</span><span class="sc">;</span>
 404     <span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileType</span>}[<span class="i">$Index</span>] = <span class="i">$FileType</span><span class="sc">;</span>
 405 
 406     <span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileSize</span>}[<span class="i">$Index</span>] = <span class="i">FileSize</span><span class="s">(</span><span class="i">$FingerprintsFile</span><span class="s">)</span><span class="sc">;</span>
 407     <span class="s">(</span><span class="i">$ModifiedTimeString</span><span class="cm">,</span> <span class="i">$ModifiedDateString</span><span class="s">)</span> = <span class="i">FormattedFileModificationTimeAndDate</span><span class="s">(</span><span class="i">$FingerprintsFile</span><span class="s">)</span><span class="sc">;</span>
 408     <span class="i">$FingerprintsFilesInfo</span>{<span class="w">FileLastModified</span>}[<span class="i">$Index</span>] = <span class="q">&quot;$ModifiedTimeString; $ModifiedDateString&quot;</span><span class="sc">;</span>
 409 
 410     <span class="i">$FingerprintsFilesInfo</span>{<span class="w">InDelim</span>}[<span class="i">$Index</span>] = <span class="i">$InDelim</span><span class="sc">;</span>
 411 
 412     <span class="i">%</span>{<span class="i">$FingerprintsFilesInfo</span>{<span class="w">FingerprintsFileIOParameters</span>}[<span class="i">$Index</span>]} = <span class="i">%FingerprintsFileIOParameters</span><span class="sc">;</span>
 413   <span class="s">}</span>
 414 <span class="s">}</span>
 415 
 416 <span class="c"># Process option values...</span>
<a name="ProcessOptions-"></a> 417 <span class="k">sub </span><span class="m">ProcessOptions</span> <span class="s">{</span>
 418   <span class="i">%OptionsInfo</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 419 
 420   <span class="i">$OptionsInfo</span>{<span class="w">ListAverageBitDensity</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">averagebitdensity</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 421   <span class="i">$OptionsInfo</span>{<span class="w">ListBitDensity</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">bitdensity</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 422 
 423   <span class="k">if</span> <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListAverageBitDensity</span>}<span class="s">)</span> <span class="s">{</span>
 424     <span class="c"># List bit density as well...</span>
 425     <span class="i">$OptionsInfo</span>{<span class="w">ListBitDensity</span>} = <span class="n">1</span><span class="sc">;</span>
 426   <span class="s">}</span>
 427 
 428   <span class="c"># By default, count number of rows containing fingerprints data...</span>
 429   <span class="i">$OptionsInfo</span>{<span class="w">CountFingerprints</span>} = <span class="n">1</span><span class="sc">;</span>
 430   <span class="i">$OptionsInfo</span>{<span class="w">CountEmptyFingerprints</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">empty</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 431 
 432   <span class="i">$OptionsInfo</span>{<span class="w">ColMode</span>} = <span class="i">$Options</span>{<span class="w">colmode</span>}<span class="sc">;</span>
 433   <span class="k">if</span> <span class="s">(</span><span class="i">IsNotEmpty</span><span class="s">(</span><span class="i">$Options</span>{<span class="w">fingerprintscol</span>}<span class="s">)</span><span class="s">)</span> <span class="s">{</span>
 434     <span class="k">if</span> <span class="s">(</span><span class="i">$Options</span>{<span class="w">colmode</span>} =~ <span class="q">/^ColNum$/i</span><span class="s">)</span> <span class="s">{</span>
 435       <span class="k">if</span> <span class="s">(</span>!<span class="i">IsPositiveInteger</span><span class="s">(</span><span class="i">$Options</span>{<span class="w">fingerprintscol</span>}<span class="s">)</span><span class="s">)</span> <span class="s">{</span>
 436         <span class="k">die</span> <span class="q">&quot;Error: Column value, $Options{fingerprintscol}, specified using \&quot;--FingerprintsCol\&quot; is not valid: Allowed integer values: &gt; 0.\n&quot;</span><span class="sc">;</span>
 437       <span class="s">}</span>
 438     <span class="s">}</span>
 439     <span class="i">$OptionsInfo</span>{<span class="w">FingerprintsCol</span>} = <span class="i">$Options</span>{<span class="w">fingerprintscol</span>}<span class="sc">;</span>
 440   <span class="s">}</span>
 441   <span class="k">else</span> <span class="s">{</span>
 442     <span class="i">$OptionsInfo</span>{<span class="w">FingerprintsCol</span>} = <span class="q">&#39;AutoDetect&#39;</span><span class="sc">;</span>
 443   <span class="s">}</span>
 444 
 445   <span class="k">if</span> <span class="s">(</span><span class="i">IsNotEmpty</span><span class="s">(</span><span class="i">$Options</span>{<span class="w">fingerprintsfield</span>}<span class="s">)</span><span class="s">)</span> <span class="s">{</span>
 446     <span class="i">$OptionsInfo</span>{<span class="w">FingerprintsFieldLabel</span>} = <span class="i">$Options</span>{<span class="w">fingerprintsfield</span>}<span class="sc">;</span>
 447   <span class="s">}</span>
 448   <span class="k">else</span> <span class="s">{</span>
 449     <span class="i">$OptionsInfo</span>{<span class="w">FingerprintsFieldLabel</span>} = <span class="q">&#39;AutoDetect&#39;</span><span class="sc">;</span>
 450   <span class="s">}</span>
 451 
 452   <span class="i">$OptionsInfo</span>{<span class="w">ValidateData</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">datacheck</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 453   <span class="i">$OptionsInfo</span>{<span class="w">DetailLevel</span>} = <span class="i">$Options</span>{<span class="w">detail</span>}<span class="sc">;</span>
 454 
 455   <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsType</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">fingerprintstype</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 456   <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsDescription</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">fingerprintsdescription</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 457   <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsSize</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">fingerprintssize</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 458 
 459   <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsBitStringFormat</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">fingerprintsbitstringformat</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 460   <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsBitOrder</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">fingerprintsbitorder</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 461 
 462   <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsVectorValuesType</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">fingerprintsvectorvaluestype</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 463   <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsVectorValuesFormat</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">fingerprintsvectorvaluesformat</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 464 
 465   <span class="i">$OptionsInfo</span>{<span class="w">InDelim</span>} = <span class="i">$Options</span>{<span class="w">indelim</span>}<span class="sc">;</span>
 466 
 467   <span class="i">$OptionsInfo</span>{<span class="w">ListNumOfOnBits</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">numofonbits</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 468   <span class="i">$OptionsInfo</span>{<span class="w">ListNumOfNonZeroValues</span>} = <span class="s">(</span><span class="i">$Options</span>{<span class="w">all</span>} || <span class="i">$Options</span>{<span class="w">numofnonzerovalues</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span><span class="n">0</span><span class="sc">;</span>
 469 
 470   <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsDataEntryInfo</span>} = <span class="s">(</span><span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsType</span>} || <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsDescription</span>} || <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsSize</span>} || <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsBitStringFormat</span>} || <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsBitOrder</span>} || <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsVectorValuesType</span>} || <span class="i">$OptionsInfo</span>{<span class="w">ListFingerprintsVectorValuesFormat</span>} || <span class="i">$OptionsInfo</span>{<span class="w">ListBitDensity</span>} || <span class="i">$OptionsInfo</span>{<span class="w">ListAverageBitDensity</span>} || <span class="i">$OptionsInfo</span>{<span class="w">ListNumOfOnBits</span>} ||  <span class="i">$OptionsInfo</span>{<span class="w">ListNumOfNonZeroValues</span>}<span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span>
 471 
 472 <span class="s">}</span>
 473 
 474 <span class="c"># Setup script usage  and retrieve command line arguments specified using various options...</span>
<a name="SetupScriptUsage-"></a> 475 <span class="k">sub </span><span class="m">SetupScriptUsage</span> <span class="s">{</span>
 476 
 477   <span class="c"># Retrieve all the options...</span>
 478   <span class="i">%Options</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span>
 479 
 480   <span class="i">$Options</span>{<span class="w">colmode</span>} = <span class="q">&#39;colnum&#39;</span><span class="sc">;</span>
 481   <span class="i">$Options</span>{<span class="w">detail</span>} = <span class="n">1</span><span class="sc">;</span>
 482   <span class="i">$Options</span>{<span class="w">indelim</span>} = <span class="q">&#39;comma&#39;</span><span class="sc">;</span>
 483 
 484   <span class="k">if</span> <span class="s">(</span>!<span class="i">GetOptions</span><span class="s">(</span>\<span class="i">%Options</span><span class="cm">,</span> <span class="q">&quot;all|a&quot;</span><span class="cm">,</span> <span class="q">&quot;averagebitdensity&quot;</span><span class="cm">,</span> <span class="q">&quot;bitdensity&quot;</span><span class="cm">,</span> <span class="q">&quot;count&quot;</span><span class="cm">,</span> <span class="q">&quot;colmode|c=s&quot;</span><span class="cm">,</span> <span class="q">&quot;detail|d=i&quot;</span><span class="cm">,</span> <span class="q">&quot;datacheck&quot;</span><span class="cm">,</span> <span class="q">&quot;empty|e&quot;</span><span class="cm">,</span> <span class="q">&quot;fingerprintsfield=s&quot;</span><span class="cm">,</span> <span class="q">&quot;fingerprintscol=s&quot;</span><span class="cm">,</span> <span class="q">&quot;fingerprintstype&quot;</span><span class="cm">,</span> <span class="q">&quot;fingerprintsdescription&quot;</span><span class="cm">,</span> <span class="q">&quot;fingerprintssize&quot;</span><span class="cm">,</span> <span class="q">&quot;fingerprintsbitstringformat&quot;</span><span class="cm">,</span> <span class="q">&quot;fingerprintsbitorder&quot;</span><span class="cm">,</span> <span class="q">&quot;fingerprintsvectorvaluestype&quot;</span><span class="cm">,</span> <span class="q">&quot;fingerprintsvectorvaluesformat&quot;</span><span class="cm">,</span> <span class="q">&quot;help|h&quot;</span><span class="cm">,</span> <span class="q">&quot;indelim=s&quot;</span><span class="cm">,</span> <span class="q">&quot;numofonbits&quot;</span><span class="cm">,</span> <span class="q">&quot;numofnonzerovalues&quot;</span><span class="cm">,</span> <span class="q">&quot;workingdir|w=s&quot;</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span>
 485     <span class="k">die</span> <span class="q">&quot;\nTo get a list of valid options and their values, use \&quot;$ScriptName -h\&quot; or\n\&quot;perl -S $ScriptName -h\&quot; command and try again...\n&quot;</span><span class="sc">;</span>
 486   <span class="s">}</span>
 487   <span class="k">if</span> <span class="s">(</span><span class="i">$Options</span>{<span class="w">workingdir</span>}<span class="s">)</span> <span class="s">{</span>
 488     <span class="k">if</span> <span class="s">(</span>! <span class="k">-d</span> <span class="i">$Options</span>{<span class="w">workingdir</span>}<span class="s">)</span> <span class="s">{</span>
 489       <span class="k">die</span> <span class="q">&quot;Error: The value specified, $Options{workingdir}, for option \&quot;-w --workingdir\&quot; is not a directory name.\n&quot;</span><span class="sc">;</span>
 490     <span class="s">}</span>
 491     <span class="k">chdir</span> <span class="i">$Options</span>{<span class="w">workingdir</span>} <span class="k">or</span> <span class="k">die</span> <span class="q">&quot;Error: Couldn&#39;t chdir $Options{workingdir}: $! \n&quot;</span><span class="sc">;</span>
 492   <span class="s">}</span>
 493   <span class="k">if</span> <span class="s">(</span><span class="i">$Options</span>{<span class="w">colmode</span>} !~ <span class="q">/^(ColNum|ColLabel)$/i</span><span class="s">)</span> <span class="s">{</span>
 494     <span class="k">die</span> <span class="q">&quot;Error: The value specified, $Options{colmode}, for option \&quot;-c, --ColMode\&quot; is not valid. Allowed values: ColNum, or ColLabel\n&quot;</span><span class="sc">;</span>
 495   <span class="s">}</span>
 496   <span class="k">if</span> <span class="s">(</span>!<span class="i">IsPositiveInteger</span><span class="s">(</span><span class="i">$Options</span>{<span class="w">detail</span>}<span class="s">)</span><span class="s">)</span> <span class="s">{</span>
 497     <span class="k">die</span> <span class="q">&quot;Error: The value specified, $Options{detail}, for option \&quot;-d, --detail\&quot; is not valid. Allowed values: &gt; 0 \n&quot;</span><span class="sc">;</span>
 498   <span class="s">}</span>
 499   <span class="k">if</span> <span class="s">(</span><span class="i">$Options</span>{<span class="w">indelim</span>} !~ <span class="q">/^(comma|semicolon)$/i</span><span class="s">)</span> <span class="s">{</span>
 500     <span class="k">die</span> <span class="q">&quot;Error: The value specified, $Options{indelim}, for option \&quot;--InDelim\&quot; is not valid. Allowed values: comma, or semicolon\n&quot;</span><span class="sc">;</span>
 501   <span class="s">}</span>
 502 <span class="s">}</span>
 503 
<a name="EOF-"></a></pre>
<p>&nbsp;</p>
<br />
<center>
<img src="../../../images/h2o2.png">
</center>
</body>
</html>