Class | Bio::Blast::Default::Report |
In: |
lib/bio/appl/blast/format0.rb
|
Parent: | Object |
Bio::Blast::Default::Report parses NCBI BLAST default output and stores information in the data. It may store some Bio::Blast::Default::Report::Iteration objects.
DELIMITER | = | RS = "\nBLAST" | Delimiter of each entry. Bio::FlatFile uses it. | |
DELIMITER_OVERRUN | = | 5 | (Integer) excess read size included in DELIMITER. |
db_len | [R] | number of letters in database |
db_num | [R] | number of sequences in database |
eff_space | [R] | effective length of the database |
entry_overrun | [R] | piece of next entry. Bio::FlatFile uses it. |
expect | [R] | e-value threshold specified when BLAST was executed |
gap_extend | [R] | gap extend penalty |
gap_open | [R] | gap open penalty |
iterations | [R] | (PSI-BLAST) Returns iterations. It returns an array of Bio::Blast::Default::Report::Iteration class. Note that normal blastall result usually contains one iteration. |
matrix | [R] | name of the matrix |
num_hits | [R] | number of hits. Note that this may differ from hits.size. |
posted_date | [R] | posted date of the database |
sc_match | [R] | match score of the matrix |
sc_mismatch | [R] | mismatch score of the matrix |
Creates a new Report object from BLAST result text.
# File lib/bio/appl/blast/format0.rb, line 53 53: def initialize(str) 54: str = str.sub(/\A\s+/, '') 55: str.sub!(/\n(T?BLAST.*)/m, "\n") # remove trailing entries for sure 56: @entry_overrun = $1 57: @entry = str 58: data = str.split(/(?:^[ \t]*\n)+/) 59: 60: format0_split_headers(data) 61: @iterations = format0_split_search(data) 62: format0_split_stat_params(data) 63: end
Opens file by using Bio::FlatFile.open.
# File lib/bio/appl/blast/format0.rb, line 48 48: def self.open(filename, *mode) 49: Bio::FlatFile.open(self, filename, *mode) 50: end
(PSI-BLAST) Same as iterations.last.converged?. Returns true if the last iteration is converged, otherwise, returns false.
# File lib/bio/appl/blast/format0.rb, line 221 221: def converged? 222: @iterations.last.converged? 223: end
Returns the name (filename or title) of the database.
# File lib/bio/appl/blast/format0.rb, line 245 245: def db 246: unless defined?(@db) 247: if /Database *\: *(.*)/m =~ @f0database then 248: a = $1.split(/^/) 249: a.pop if a.size > 1 250: @db = a.collect { |x| x.sub(/\s+\z/, '') }.join(' ') 251: end 252: end #unless 253: @db 254: end
Iterates over each hit of the last iteration. Same as iterations.last.each_hit. Yields a Bio::Blast::Default::Report::Hit object. This is very useful in most cases, e.g. for blastall results.
# File lib/bio/appl/blast/format0.rb, line 196 196: def each_hit 197: @iterations.last.each do |x| 198: yield x 199: end 200: end
(PSI-BLAST) Iterates over each iteration. Same as iterations.each. Yields a Bio::Blast::Default::Report::Iteration object.
# File lib/bio/appl/blast/format0.rb, line 186 186: def each_iteration 187: @iterations.each do |x| 188: yield x 189: end 190: end
Same as iterations.last.gapped_entropy.
# File lib/bio/appl/blast/format0.rb, line 153 153: def gapped_entropy; @iterations.last.gapped_entropy; end
Same as iterations.last.gapped_kappa.
# File lib/bio/appl/blast/format0.rb, line 149 149: def gapped_kappa; @iterations.last.gapped_kappa; end
Same as iterations.last.gapped_lambda.
# File lib/bio/appl/blast/format0.rb, line 151 151: def gapped_lambda; @iterations.last.gapped_lambda; end
Same as iterations.last.hits. Returns the last iteration‘s hits. Returns an array of Bio::Blast::Default::Report::Hit object. This is very useful in most cases, e.g. for blastall results.
# File lib/bio/appl/blast/format0.rb, line 207 207: def hits 208: @iterations.last.hits 209: end
(PHI-BLAST) Same as iterations.first.pattern_positions. Note that it returns the FIRST iteration‘s value.
# File lib/bio/appl/blast/format0.rb, line 178 178: def pattern_positions 179: @iterations.first.pattern_positions 180: end
Returns definition of the query.
# File lib/bio/appl/blast/format0.rb, line 168 168: def query_def; format0_parse_query; @query_def; end
Returns length of the query.
# File lib/bio/appl/blast/format0.rb, line 165 165: def query_len; format0_parse_query; @query_len; end
Returns the bibliography reference of the BLAST software. Note that this method shows only the first reference. When you want to get additional references, you can use references method.
# File lib/bio/appl/blast/format0.rb, line 229 229: def reference 230: references[0] 231: end
Returns the bibliography references of the BLAST software. Returns an array of strings.
# File lib/bio/appl/blast/format0.rb, line 235 235: def references 236: unless defined?(@references) 237: @references = @f0references.collect do |x| 238: x.to_s.gsub(/\s+/, ' ').strip 239: end 240: end #unless 241: @references 242: end
Returns whole entry as a string.
# File lib/bio/appl/blast/format0.rb, line 74 74: def to_s; @entry; end