annotate mayachemtools/bin/InfoSequenceFiles.pl @ 9:ab29fa5c8c1f draft default tip

Uploaded
author deepakjadmin
date Thu, 15 Dec 2016 14:18:03 -0500
parents 73ae111cf86f
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
1 #!/usr/bin/perl -w
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
2 #
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
3 # $RCSfile: InfoSequenceFiles.pl,v $
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
4 # $Date: 2015/02/28 20:46:20 $
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
5 # $Revision: 1.29 $
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
6 #
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
7 # Author: Manish Sud <msud@san.rr.com>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
8 #
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
9 # Copyright (C) 2015 Manish Sud. All rights reserved.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
10 #
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
11 # This file is part of MayaChemTools.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
12 #
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
13 # MayaChemTools is free software; you can redistribute it and/or modify it under
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
14 # the terms of the GNU Lesser General Public License as published by the Free
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
15 # Software Foundation; either version 3 of the License, or (at your option) any
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
16 # later version.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
17 #
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
18 # MayaChemTools is distributed in the hope that it will be useful, but without
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
19 # any warranty; without even the implied warranty of merchantability of fitness
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
20 # for a particular purpose. See the GNU Lesser General Public License for more
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
21 # details.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
22 #
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
23 # You should have received a copy of the GNU Lesser General Public License
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
24 # along with MayaChemTools; if not, see <http://www.gnu.org/licenses/> or
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
25 # write to the Free Software Foundation Inc., 59 Temple Place, Suite 330,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
26 # Boston, MA, 02111-1307, USA.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
27 #
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
28
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
29 use strict;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
30 use FindBin; use lib "$FindBin::Bin/../lib";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
31 use Getopt::Long;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
32 use File::Basename;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
33 use Text::ParseWords;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
34 use Benchmark;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
35 use FileUtil;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
36 use TextUtil;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
37 use SequenceFileUtil;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
38 use StatisticsUtil;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
39
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
40 my($ScriptName, %Options, $StartTime, $EndTime, $TotalTime);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
41
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
42 # Autoflush STDOUT
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
43 $| = 1;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
44
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
45 # Starting message...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
46 $ScriptName = basename($0);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
47 print "\n$ScriptName: Starting...\n\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
48 $StartTime = new Benchmark;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
49
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
50 # Get the options and setup script...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
51 SetupScriptUsage();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
52 if ($Options{help} || @ARGV < 1) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
53 die GetUsageFromPod("$FindBin::Bin/$ScriptName");
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
54 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
55
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
56 my(@SequenceFilesList);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
57 @SequenceFilesList = ExpandFileNames(\@ARGV, "aln msf fasta fta pir");
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
58
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
59 print "Processing options...\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
60 my(%OptionsInfo);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
61 ProcessOptions();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
62
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
63 print "Checking input sequence file(s)...\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
64 my(%SequenceFilesInfo);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
65 RetrieveSequenceFilesInfo();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
66
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
67 my($FileIndex);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
68 if (@SequenceFilesList > 1) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
69 print "\nProcessing sequence files...\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
70 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
71 for $FileIndex (0 .. $#SequenceFilesList) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
72 if ($SequenceFilesInfo{FileOkay}[$FileIndex]) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
73 print "\nProcessing file $SequenceFilesList[$FileIndex]...\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
74 ListSequenceFileInfo($FileIndex);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
75 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
76 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
77 ListTotalSizeOfFiles();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
78
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
79 print "\n$ScriptName:Done...\n\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
80
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
81 $EndTime = new Benchmark;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
82 $TotalTime = timediff ($EndTime, $StartTime);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
83 print "Total time: ", timestr($TotalTime), "\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
84
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
85 ###############################################################################
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
86
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
87 # List appropriate information...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
88 sub ListSequenceFileInfo {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
89 my($Index) = @_;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
90 my($SequenceFile, $SequenceDataRef);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
91
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
92 $SequenceFile = $SequenceFilesList[$Index];
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
93
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
94 $SequenceDataRef = ReadSequenceFile($SequenceFile);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
95
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
96 my($SequencesCount) = $SequenceDataRef->{Count};
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
97 print "\nNumber of sequences: $SequencesCount\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
98
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
99 if ($OptionsInfo{ListShortestSequence} && ($SequencesCount > 1)) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
100 my($ShortestSeqID, $ShortestSeq, $ShortestSeqLen, $Description) = GetShortestSequence($SequenceDataRef, $OptionsInfo{IgnoreGaps});
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
101 print "\nShortest sequence information:\nID: $ShortestSeqID; Length:$ShortestSeqLen\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
102 if ($OptionsInfo{DetailLevel} >= 2) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
103 print "Description: $Description\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
104 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
105 if ($OptionsInfo{DetailLevel} >= 3) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
106 print "Sequence: $ShortestSeq\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
107 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
108 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
109 if ($OptionsInfo{ListLongestSequence} && ($SequencesCount > 1)) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
110 my($LongestSeqID, $LongestSeq, $LongestSeqLen, $Description) = GetLongestSequence($SequenceDataRef, $OptionsInfo{IgnoreGaps});
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
111 print "\nLongest sequence information:\nID: $LongestSeqID; Length: $LongestSeqLen\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
112 if ($OptionsInfo{DetailLevel} >= 2) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
113 print "Description: $Description\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
114 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
115 if ($OptionsInfo{DetailLevel} >= 3) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
116 print "Sequence: $LongestSeq\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
117 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
118 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
119 if ($OptionsInfo{FrequencyAnalysis} && ($SequencesCount > 1)) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
120 PerformLengthFrequencyAnalysis($SequenceDataRef);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
121 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
122 if ($OptionsInfo{ListSequenceLengths}) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
123 ListSequenceLengths($SequenceDataRef);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
124 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
125
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
126 # File size and modification information...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
127 print "\nFile size: ", FormatFileSize($SequenceFilesInfo{FileSize}[$Index]), " \n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
128 print "Last modified: ", $SequenceFilesInfo{FileLastModified}[$Index], " \n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
129 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
130
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
131 # List information about sequence lengths...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
132 sub ListSequenceLengths {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
133 my($SequenceDataRef) = @_;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
134 my($ID, $SeqLen, $Sequence, $Description);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
135
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
136 print "\nSequence lengths information:\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
137 for $ID (@{$SequenceDataRef->{IDs}}) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
138 $Sequence = $SequenceDataRef->{Sequence}{$ID};
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
139 $Description = $SequenceDataRef->{Description}{$ID};
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
140 $SeqLen = GetSequenceLength($Sequence, $OptionsInfo{IgnoreGaps});
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
141 if ($OptionsInfo{IgnoreGaps}) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
142 $Sequence = RemoveSequenceGaps($Sequence);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
143 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
144 print "ID: $ID; Length:$SeqLen\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
145 if ($OptionsInfo{DetailLevel} >= 2) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
146 print "Description: $Description\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
147 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
148 if ($OptionsInfo{DetailLevel} >= 3) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
149 print "Sequence: $Sequence\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
150 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
151 if ($OptionsInfo{DetailLevel} >= 2) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
152 print "\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
153 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
154 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
155 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
156
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
157 # Total size of all the fiels...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
158 sub ListTotalSizeOfFiles {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
159 my($FileOkayCount, $TotalSize, $Index);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
160
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
161 $FileOkayCount = 0;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
162 $TotalSize = 0;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
163
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
164 for $Index (0 .. $#SequenceFilesList) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
165 if ($SequenceFilesInfo{FileOkay}[$Index]) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
166 $FileOkayCount++;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
167 $TotalSize += $SequenceFilesInfo{FileSize}[$Index];
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
168 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
169 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
170 if ($FileOkayCount > 1) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
171 print "\nTotal size of $FileOkayCount files: ", FormatFileSize($TotalSize), "\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
172 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
173 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
174
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
175
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
176 # Perform frequency analysis of sequence lengths
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
177 sub PerformLengthFrequencyAnalysis {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
178 my($SequenceDataRef, $SequenceLengthsRef) = @_;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
179 my ($ID, $SeqLen, $Sequence, $SequenceLenBin, $LenBin, $SequenceLenCount, @SequenceLengths, %SequenceLenFrequency);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
180
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
181 @SequenceLengths = ();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
182 %SequenceLenFrequency = ();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
183 for $ID (@{$SequenceDataRef->{IDs}}) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
184 $Sequence = $SequenceDataRef->{Sequence}{$ID};
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
185 $SeqLen = GetSequenceLength($Sequence, $OptionsInfo{IgnoreGaps});
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
186 push @SequenceLengths, $SeqLen;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
187 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
188 if (@{$OptionsInfo{BinRange}}) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
189 %SequenceLenFrequency = Frequency(\@SequenceLengths, \@{$OptionsInfo{BinRange}});
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
190 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
191 else {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
192 %SequenceLenFrequency = Frequency(\@SequenceLengths, $OptionsInfo{NumOfBins});
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
193 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
194 print "\nDistribution of sequence lengths (LengthBin => Count):\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
195 for $SequenceLenBin (sort { $a <=> $b} keys %SequenceLenFrequency) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
196 $SequenceLenCount = $SequenceLenFrequency{$SequenceLenBin};
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
197 $LenBin = sprintf("%.1f", $SequenceLenBin) + 0;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
198 print "$LenBin => $SequenceLenCount; ";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
199 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
200 print "\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
201 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
202
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
203 # Retrieve information about sequence files...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
204 sub RetrieveSequenceFilesInfo {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
205 my($Index, $SequenceFile, $FileSupported, $FileFormat, $ModifiedTimeString, $ModifiedDateString);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
206
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
207 %SequenceFilesInfo = ();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
208 @{$SequenceFilesInfo{FileOkay}} = ();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
209 @{$SequenceFilesInfo{FileFormat}} = ();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
210 @{$SequenceFilesInfo{FileSize}} = ();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
211 @{$SequenceFilesInfo{FileLastModified}} = ();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
212
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
213 FILELIST: for $Index (0 .. $#SequenceFilesList) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
214 $SequenceFile = $SequenceFilesList[$Index];
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
215
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
216 if (! open SEQUENCEFILE, "$SequenceFile") {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
217 warn "Warning: Ignoring file $SequenceFile: Couldn't open it: $! \n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
218 next FILELIST;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
219 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
220 close SEQUENCEFILE;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
221
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
222 $SequenceFilesInfo{FileOkay}[$Index] = 0;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
223 $SequenceFilesInfo{FileFormat}[$Index] = 'NotSupported';
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
224 $SequenceFilesInfo{FileSize}[$Index] = 0;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
225 $SequenceFilesInfo{FileLastModified}[$Index] = '';
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
226
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
227 ($FileSupported, $FileFormat) = IsSupportedSequenceFile($SequenceFile);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
228 if (!$FileSupported) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
229 warn "Warning: Ignoring file $SequenceFile: Sequence file format is not supported.\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
230 next FILELIST;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
231 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
232
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
233 $SequenceFilesInfo{FileOkay}[$Index] = 1;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
234 $SequenceFilesInfo{FileFormat}[$Index] = $FileFormat;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
235 $SequenceFilesInfo{FileSize}[$Index] = FileSize($SequenceFile);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
236
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
237 ($ModifiedTimeString, $ModifiedDateString) = FormattedFileModificationTimeAndDate($SequenceFile);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
238 $SequenceFilesInfo{FileLastModified}[$Index] = "$ModifiedTimeString; $ModifiedDateString";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
239 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
240 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
241
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
242 # Process option values...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
243 sub ProcessOptions {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
244
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
245 $OptionsInfo{All} = defined $Options{all} ? $Options{all} : undef;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
246
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
247 $OptionsInfo{Count} = defined $Options{count} ? $Options{count} : undef;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
248 $OptionsInfo{DetailLevel} = $Options{detail};
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
249 $OptionsInfo{Frequency} = defined $Options{frequency} ? $Options{frequency} : undef;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
250 $OptionsInfo{FrequencyBins} = defined $Options{frequencybins} ? $Options{frequencybins} : undef;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
251 $OptionsInfo{IgnoreGaps} = defined $Options{ignoregaps} ? $Options{ignoregaps} : undef;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
252 $OptionsInfo{Longest} = defined $Options{longest} ? $Options{longest} : undef;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
253 $OptionsInfo{Shortest} = defined $Options{shortest} ? $Options{shortest} : undef;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
254 $OptionsInfo{SequenceLengths} = defined $Options{sequencelengths} ? $Options{sequencelengths} : undef;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
255
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
256 $OptionsInfo{FrequencyAnalysis} = ($Options{all} || $Options{frequency}) ? 1 : 0;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
257 $OptionsInfo{ListLongestSequence} = ($Options{all} || $Options{longest}) ? 1 : 0;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
258 $OptionsInfo{ListShortestSequence} = ($Options{all} || $Options{shortest}) ? 1 : 0;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
259 $OptionsInfo{ListSequenceLengths} = ($Options{all} || $Options{sequencelengths}) ? 1 : 0;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
260 $OptionsInfo{IgnoreGaps} = ($Options{ignoregaps} =~ /Yes/i) ? 1 : 0;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
261
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
262 # Setup frequency bin values...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
263 $OptionsInfo{NumOfBins} = 4;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
264 @{$OptionsInfo{BinRange}} = ();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
265
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
266 if ($Options{frequencybins} =~ /\,/) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
267 my($BinValue, @SpecifiedBinRange);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
268 @SpecifiedBinRange = split /\,/, $Options{frequencybins};
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
269 if (@SpecifiedBinRange < 2) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
270 die "Error: The value specified, $Options{frequencybins}, for option \"--frequencybins\" is not valid: Must contain at least two values. \n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
271 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
272 for $BinValue (@SpecifiedBinRange) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
273 if (!IsNumerical($BinValue)) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
274 die "Error: The value specified, $Options{frequencybins}, for option \"--frequencybins\" is not valid: Contains non numeric values. \n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
275 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
276 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
277 my($Index1, $Index2);
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
278 for $Index1 (0 .. $#SpecifiedBinRange) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
279 for $Index2 (($Index1 + 1) .. $#SpecifiedBinRange) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
280 if ($SpecifiedBinRange[$Index1] >= $SpecifiedBinRange[$Index2]) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
281 die "Error: The value specified, $Options{frequencybins}, for option \"--frequencybins\" is not valid: Must contain values in ascending order. \n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
282 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
283 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
284 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
285 push @{$OptionsInfo{BinRange}}, @SpecifiedBinRange;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
286 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
287 else {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
288 $OptionsInfo{NumOfBins} = $Options{frequencybins};
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
289 if (!IsPositiveInteger($OptionsInfo{NumOfBins})) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
290 die "Error: The value specified, $Options{frequencybins}, for option \"--frequencybins\" is not valid. Allowed values: positive integer or \"number,number,[number]...\". \n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
291 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
292 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
293 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
294
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
295 # Setup script usage and retrieve command line arguments specified using various options...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
296 sub SetupScriptUsage {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
297
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
298 # Retrieve all the options...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
299 %Options = ();
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
300 $Options{detail} = 1;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
301 $Options{ignoregaps} = 'no';
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
302 $Options{frequencybins} = 10;
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
303
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
304 if (!GetOptions(\%Options, "all|a", "count|c", "detail|d=i", "frequency|f", "frequencybins=s", "help|h", "ignoregaps|i=s", "longest|l", "shortest|s", "sequencelengths", "workingdir|w=s")) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
305 die "\nTo get a list of valid options and their values, use \"$ScriptName -h\" or\n\"perl -S $ScriptName -h\" command and try again...\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
306 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
307 if ($Options{workingdir}) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
308 if (! -d $Options{workingdir}) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
309 die "Error: The value specified, $Options{workingdir}, for option \"-w --workingdir\" is not a directory name.\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
310 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
311 chdir $Options{workingdir} or die "Error: Couldn't chdir $Options{workingdir}: $! \n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
312 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
313 if (!IsPositiveInteger($Options{detail})) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
314 die "Error: The value specified, $Options{detail}, for option \"-d --detail\" is not valid. Allowed values: > 0\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
315 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
316 if ($Options{ignoregaps} !~ /^(yes|no)$/i) {
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
317 die "Error: The value specified, $Options{ignoregaps}, for option \"-i --IgnoreGaps\" is not valid. Allowed values: yes or no\n";
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
318 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
319 }
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
320
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
321 __END__
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
322
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
323 =head1 NAME
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
324
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
325 InfoSequenceFiles.pl - List information about sequence and alignment files
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
326
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
327 =head1 SYNOPSIS
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
328
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
329 InfoSequenceFiles.pl SequenceFile(s) AlignmentFile(s)...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
330
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
331 InfoSequenceFiles.pl [B<-a, --all>] [B<-c, --count>] [B<-d, --detail> infolevel]
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
332 [B<-f, --frequency>] [B<--FrequencyBins> number | "number, number, [number,...]"]
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
333 [B<-h, --help>] [B<-i, --IgnoreGaps> yes | no] [B<-l, --longest>] [B<-s, --shortest>]
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
334 [B<--SequenceLengths>] [B<-w, --workingdir> dirname] SequenceFile(s)...
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
335
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
336 =head1 DESCRIPTION
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
337
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
338 List information about contents of I<SequenceFile(s) and AlignmentFile(s)>: number of sequences,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
339 shortest and longest sequences, distribution of sequence lengths and so on. The file names are
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
340 separated by spaces. All the sequence files in a current directory can be specified by I<*.aln>,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
341 I<*.msf>, I<*.fasta>, I<*.fta>, I<*.pir> or any other supported formats; additionally, I<DirName>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
342 corresponds to all the sequence files in the current directory with any of the supported file
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
343 extension: I<.aln, .msf, .fasta, .fta, and .pir>.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
344
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
345 Supported sequence formats are: I<ALN/CLustalW>, I<GCG/MSF>, I<PILEUP/MSF>, I<Pearson/FASTA>,
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
346 and I<NBRF/PIR>. Instead of using file extensions, file formats are detected by parsing the contents
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
347 of I<SequenceFile(s) and AlignmentFile(s)>.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
348
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
349 =head1 OPTIONS
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
350
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
351 =over 4
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
352
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
353 =item B<-a, --all>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
354
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
355 List all the available information.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
356
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
357 =item B<-c, --count>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
358
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
359 List number of of sequences. This is B<default behavior>.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
360
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
361 =item B<-d, --detail> I<InfoLevel>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
362
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
363 Level of information to print about sequences during various options. Default: I<1>.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
364 Possible values: I<1, 2 or 3>.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
365
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
366 =item B<-f, --frequency>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
367
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
368 List distribution of sequence lengths using the specified number of bins or bin range specified
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
369 using B<FrequencyBins> option.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
370
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
371 This option is ignored for input files containing only single sequence.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
372
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
373 =item B<--FrequencyBins> I<number | "number,number,[number,...]">
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
374
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
375 This value is used with B<-f, --frequency> option to list distribution of sequence lengths using
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
376 the specified number of bins or bin range. Default value: I<10>.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
377
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
378 The bin range list is used to group sequence lengths into different groups; It must contain
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
379 values in ascending order. Examples:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
380
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
381 100,200,300,400,500,600
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
382 200,400,600,800,1000
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
383
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
384 The frequency value calculated for a specific bin corresponds to all the sequence lengths
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
385 which are greater than the previous bin value and less than or equal to the current bin value.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
386
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
387 =item B<-h, --help>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
388
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
389 Print this help message.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
390
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
391 =item B<-i, --IgnoreGaps> I<yes | no>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
392
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
393 Ignore gaps during calculation of sequence lengths. Possible values: I<yes or
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
394 no>. Default value: I<no>.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
395
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
396 =item B<-l, --longest>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
397
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
398 List information about longest sequence: ID, sequence and sequence length. This option
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
399 is ignored for input files containing only single sequence.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
400
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
401 =item B<-s, --shortest>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
402
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
403 List information about shortest sequence: ID, sequence and sequence length. This option
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
404 is ignored for input files containing only single sequence.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
405
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
406 =item B<--SequenceLengths>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
407
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
408 List information about sequence lengths.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
409
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
410 =item B<-w, --WorkingDir> I<dirname>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
411
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
412 Location of working directory. Default: current directory.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
413
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
414 =back
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
415
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
416 =head1 EXAMPLES
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
417
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
418 To count number of sequences in sequence files, type:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
419
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
420 % InfoSequenceFiles.pl Sample1.fasta
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
421 % InfoSequenceFiles.pl Sample1.msf Sample1.aln Sample1.pir
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
422 % InfoSequenceFiles.pl *.fasta *.fta *.msf *.pir *.aln
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
423
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
424 To list all available information with maximum level of available detail for a sequence
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
425 alignment file Sample1.msf, type:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
426
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
427 % InfoSequenceFiles.pl -a -d 3 Sample1.msf
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
428
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
429 To list sequence length information after ignoring sequence gaps in Sample1.aln file, type:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
430
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
431 % InfoSequenceFiles.pl --SequenceLengths --IgnoreGaps Yes
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
432 Sample1.aln
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
433
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
434 To list shortest and longest sequence length information after ignoring sequence
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
435 gaps in Sample1.aln file, type:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
436
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
437 % InfoSequenceFiles.pl --longest --shortest --IgnoreGaps Yes
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
438 Sample1.aln
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
439
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
440 To list distribution of sequence lengths after ignoring sequence gaps in Sample1.aln file and
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
441 report the frequency distribution into 10 bins, type:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
442
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
443 % InfoSequenceFiles.pl --frequency --FrequencyBins 10
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
444 --IgnoreGaps Yes Sample1.aln
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
445
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
446 To list distribution of sequence lengths after ignoring sequence gaps in Sample1.aln file and
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
447 report the frequency distribution into specified bin range, type:
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
448
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
449 % InfoSequenceFiles.pl --frequency --FrequencyBins
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
450 "150,200,250,300,350" --IgnoreGaps Yes Sample1.aln
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
451
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
452 =head1 AUTHOR
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
453
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
454 Manish Sud <msud@san.rr.com>
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
455
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
456 =head1 SEE ALSO
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
457
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
458 AnalyzeSequenceFilesData.pl, ExtractFromSequenceFiles.pl, InfoAminoAcids.pl, InfoNucleicAcids.pl
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
459
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
460 =head1 COPYRIGHT
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
461
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
462 Copyright (C) 2015 Manish Sud. All rights reserved.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
463
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
464 This file is part of MayaChemTools.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
465
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
466 MayaChemTools is free software; you can redistribute it and/or modify it under
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
467 the terms of the GNU Lesser General Public License as published by the Free
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
468 Software Foundation; either version 3 of the License, or (at your option)
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
469 any later version.
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
470
73ae111cf86f Uploaded
deepakjadmin
parents:
diff changeset
471 =cut