update the annotation grammer to make species name optional
[mussa.git] / alg / sequence.cpp
1 //  This file is part of the Mussa source distribution.
2 //  http://mussa.caltech.edu/
3 //  Contact author: Tristan  De Buysscher, tristan@caltech.edu
4
5 // This program and all associated source code files are Copyright (C) 2005
6 // the California Institute of Technology, Pasadena, CA, 91125 USA.  It is
7 // under the GNU Public License; please see the included LICENSE.txt
8 // file for more information, or contact Tristan directly.
9
10
11 //  This file is part of the Mussa source distribution.
12 //  http://mussa.caltech.edu/
13 //  Contact author: Tristan  De Buysscher, tristan@caltech.edu
14
15 // This program and all associated source code files are Copyright (C) 2005
16 // the California Institute of Technology, Pasadena, CA, 91125 USA.  It is
17 // under the GNU Public License; please see the included LICENSE.txt
18 // file for more information, or contact Tristan directly.
19
20
21 //                        ----------------------------------------
22 //                           ---------- sequence.cc -----------
23 //                        ----------------------------------------
24 #include <boost/filesystem/fstream.hpp>
25 namespace fs = boost::filesystem;
26
27 #include <boost/spirit/core.hpp>
28 #include <boost/spirit/actor/push_back_actor.hpp>
29 #include <boost/spirit/iterator/file_iterator.hpp>
30 #include <boost/spirit/utility/chset.hpp>
31 namespace spirit = boost::spirit;
32
33 #include "alg/sequence.hpp"
34 #include "mussa_exceptions.hpp"
35
36 #include <string>
37 #include <iostream>
38 #include <sstream>
39
40 // some standard dna alphabets 
41 // \012 = nl
42 // \015 = cr
43 // this should make our sequence parsing end-of-line convention 
44 // independent
45 static const char* dna_alphabet = "AaCcGgTtNn\012\015";
46 static const char* rna_alphabet = "AaCcGgNnUu\012\015";
47 static const char* iupac_alphabet = "AaCcGgTtUuRrYyMmKkSsWwBbDdHhVvNn\012\015";
48
49 annot::annot() 
50  : start(0),
51    end(0),
52    type(""),
53    name("")
54 {
55 }
56
57 annot::annot(int start, int end, std::string type, std::string name)
58  : start(start),
59    end(end),
60    type(type),
61    name(name)
62 {
63 }
64
65 annot::~annot()
66 {
67 }
68
69 bool operator==(const annot& left, const annot& right)
70 {
71   return ((left.start == right.start) and
72           (left.end == right.end) and
73           (left.type == right.type) and
74           (left.name == right.name));
75 }
76
77 motif::motif(int start, std::string motif)
78  : annot(start, start+motif.size(), "motif", motif),
79    sequence(motif)
80 {
81 }
82
83 motif::~motif()
84 {
85 }
86
87 Sequence::Sequence()
88  :  std::string(),
89     header(""),
90     species("")
91 {
92 }
93
94 Sequence::~Sequence()
95 {
96 }
97
98 Sequence::Sequence(const char *seq)
99   : header(""),
100     species("")
101 {
102   set_filtered_sequence(seq);
103 }
104
105 Sequence::Sequence(const std::string& seq) 
106   : header(""),
107     species("")
108 {
109   set_filtered_sequence(seq);
110 }
111
112 Sequence::Sequence(const Sequence& o)
113   : std::string(o),
114     header(o.header),
115     species(o.species),
116     annots(o.annots),
117     motif_list(o.motif_list)
118 {
119 }
120
121 Sequence &Sequence::operator=(const Sequence& s)
122 {
123   if (this != &s) {
124     //sequence = s.sequence;
125     assign(s);
126     header = s.header;
127     species = s.species;
128     annots = s.annots;
129     motif_list = s.motif_list;
130   }
131   return *this;
132 }
133
134 static void multiplatform_getline(std::istream& in, std::string& line)
135 {
136   line.clear();
137   char c;
138   in.get(c);
139   while(in.good() and !(c == '\012' or c == '\015') ) {
140     line.push_back(c);
141     in.get(c);
142   }
143   // if we have cr-lf eat it
144   c = in.peek();
145   if (c=='\012' or c == '\015') {
146     in.get();
147   }
148 }
149
150 //! load a fasta file into a sequence
151 /*! 
152  * \param file_path the location of the fasta file in the filesystem
153  * \param seq_num which sequence in the file to load
154  * \param start_index starting position in the fasta sequence, 0 for beginning
155  * \param end_index ending position in the fasta sequence, 0 for end
156  * \return error message, empty string if no error. (gag!)
157  */
158 void Sequence::load_fasta(fs::path file_path, int seq_num,
159                           int start_index, int end_index)
160 {
161   fs::fstream data_file;
162   data_file.open(file_path, std::ios::in);
163
164   if (!data_file.good())
165   {    
166     throw mussa_load_error("Sequence File: "+file_path.string()+" not found"); 
167   } else {
168     try {
169       load_fasta(data_file, seq_num, start_index, end_index);
170     } catch(sequence_empty_error e) {
171       // there doesn't appear to be any sequence
172       // catch and rethrow to include the filename
173       std::stringstream msg;
174       msg << "The selected sequence in " 
175           << file_path.native_file_string()
176           << " appears to be empty"; 
177       throw sequence_empty_error(msg.str());
178     } catch(sequence_empty_file_error e) {
179       std::stringstream errormsg;
180       errormsg << file_path.native_file_string()
181                << " did not have any fasta sequences" << std::endl;
182       throw sequence_empty_file_error(errormsg.str());
183     }
184   }
185 }
186
187 void
188 Sequence::load_fasta(std::iostream& data_file, int seq_num, 
189                      int start_index, int end_index)
190 {
191   std::string file_data_line;
192   int header_counter = 0;
193   bool read_seq = true;
194   std::string rev_comp;
195   std::string sequence_raw;
196   std::string seq_tmp;             // holds sequence during basic filtering
197
198   if (seq_num == 0) {
199     throw mussa_load_error("fasta sequence number is 1 based (can't be 0)");
200   }
201
202   // search for the header of the fasta sequence we want
203   while ( (!data_file.eof()) && (header_counter < seq_num) )
204   {
205     multiplatform_getline(data_file, file_data_line);
206     if (file_data_line.substr(0,1) == ">")
207       header_counter++;
208   }
209
210   if (header_counter > 0) {
211     header = file_data_line.substr(1);
212
213     sequence_raw = "";
214
215     while ( !data_file.eof() && read_seq ) {
216       multiplatform_getline(data_file,file_data_line);
217       if (file_data_line.substr(0,1) == ">")
218         read_seq = false;
219       else sequence_raw += file_data_line;
220     }
221
222     // Lastly, if subselection of the sequence was specified we keep cut out
223     // and only keep that part
224     // end_index = 0 means no end was specified, so cut to the end 
225     if (end_index == 0)
226       end_index = sequence_raw.size();
227
228     // sequence filtering for upcasing agctn and convert non AGCTN to N
229     if (end_index-start_index <= 0) {
230       std::string msg("The selected sequence appears to be empty"); 
231       throw sequence_empty_error(msg);
232     }
233     set_filtered_sequence(sequence_raw, start_index, end_index-start_index);
234   } else {
235     std::string errormsg("There were no fasta sequences");
236     throw sequence_empty_file_error(errormsg);
237   }
238 }
239
240 void Sequence::set_filtered_sequence(const std::string &old_seq, 
241                                      std::string::size_type start, 
242                                      std::string::size_type count)
243 {
244   char conversionTable[257];
245
246   if ( count == 0)
247     count = old_seq.size() - start;
248   std::string::clear();
249   reserve(count);
250
251   // Make a conversion table
252
253   // everything we don't specify below will become 'N'
254   for(int table_i=0; table_i < 256; table_i++)
255   {
256     conversionTable[table_i] = 'N';
257   }
258   // add end of string character for printing out table for testing purposes
259   conversionTable[256] = '\0';
260
261   // we want these to map to themselves - ie not to change
262   conversionTable[(int)'A'] = 'A';
263   conversionTable[(int)'T'] = 'T';
264   conversionTable[(int)'G'] = 'G';
265   conversionTable[(int)'C'] = 'C';
266   // this is to upcase
267   conversionTable[(int)'a'] = 'A';
268   conversionTable[(int)'t'] = 'T';
269   conversionTable[(int)'g'] = 'G';
270   conversionTable[(int)'c'] = 'C';
271
272   // finally, the actual conversion loop
273   for(std::string::size_type seq_index = 0; seq_index < count; seq_index++)
274   {
275     append(1, conversionTable[ (int)old_seq[seq_index+start]]);
276   }
277 }
278
279   // this doesn't work properly under gcc 3.x ... it can't recognize toupper
280   //transform(sequence.begin(), sequence.end(), sequence.begin(), toupper);
281
282 void
283 Sequence::load_annot(fs::path file_path, int start_index, int end_index)
284 {
285   fs::fstream data_stream(file_path, std::ios::in);
286   if (!data_stream)
287   {
288     throw mussa_load_error("Sequence File: " + file_path.string() + " not found");
289   }
290
291   // so i should probably be passing the parse function some iterators
292   // but the annotations files are (currently) small, so i think i can 
293   // get away with loading the whole file into memory
294   std::string data;
295   char c;
296   while(data_stream.good()) {
297     data_stream.get(c);
298     data.push_back(c);
299   }
300   data_stream.close();
301         
302   parse_annot(data, start_index, end_index);
303 }
304
305 /* If this works, yikes, this is some brain hurting code.
306  *
307  * what's going on is that when pb_annot is instantiated it stores references
308  * to begin, end, name, type, declared in the parse function, then
309  * when operator() is called it grabs values from those references
310  * and uses that to instantiate an annot object and append that to our
311  * annotation list.
312  *
313  * This weirdness is because the spirit library requires that actions
314  * conform to a specific prototype operator()(IteratorT, IteratorT)
315  * which doesn't provide any useful opportunity for me to actually
316  * grab the results of our parsing.
317  *
318  * so I instantiate this structure in order to have a place to grab
319  * my data from.
320  */
321   
322 struct push_back_annot {
323   std::list<annot>& annot_list;
324   int& begin;
325   int& end;
326   std::string& name;
327   std::string& type;
328
329   push_back_annot(std::list<annot>& annot_list_, 
330                   int& begin_, 
331                   int& end_, 
332                   std::string& name_, 
333                   std::string& type_) 
334   : annot_list(annot_list_), 
335     begin(begin_),
336     end(end_),
337     name(name_),
338     type(type_)
339   {
340   }
341
342   void operator()(std::string::const_iterator, 
343                   std::string::const_iterator) const 
344   {
345     //std::cout << "adding annot: " << begin << "|" << end << "|" << name << "|" << type << std::endl;
346     annot_list.push_back(annot(begin, end, name, type));
347   };
348 };
349
350 struct push_back_seq {
351   std::list<Sequence>& seq_list;
352   std::string& name;
353   std::string& seq;
354
355   push_back_seq(std::list<Sequence>& seq_list_,
356                 std::string& name_, 
357                 std::string& seq_)
358   : seq_list(seq_list_), 
359     name(name_),
360     seq(seq_)
361   {
362   }
363
364   void operator()(std::string::const_iterator, 
365                   std::string::const_iterator) const 
366   {
367     // filter out newlines from our sequence
368     std::string new_seq;
369     for(std::string::const_iterator seq_i = seq.begin();
370         seq_i != seq.end();
371         ++seq_i)
372     {
373       if (*seq_i != '\015' && *seq_i != '\012') new_seq += *seq_i;
374     }
375     //std::cout << "adding seq: " << name << " " << new_seq << std::endl;
376     
377     Sequence s(new_seq);
378     s.set_header(name);
379     seq_list.push_back(s);
380   };
381 };
382
383 void
384 Sequence::parse_annot(std::string data, int start_index, int end_index)
385 {
386   int start=0;
387   int end=0;
388   std::string name;
389   std::string type;
390   std::string seq;
391   std::list<Sequence> query_seqs;
392
393   bool status = spirit::parse(data.begin(), data.end(),
394                 (
395                  //begin grammar
396                    !(
397                       (
398                         spirit::alpha_p >> 
399                         +(spirit::graph_p)
400                       )[spirit::assign_a(species)] >> 
401                       +(spirit::space_p)
402                     ) >>
403                     *(
404                       ( // parse an absolute location name
405                        (spirit::uint_p[spirit::assign_a(start)] >> 
406                         +spirit::space_p >>
407                         spirit::uint_p[spirit::assign_a(end)] >> 
408                         +spirit::space_p >>
409                         ( 
410                            spirit::alpha_p >> 
411                            *spirit::graph_p
412                         )[spirit::assign_a(name)] >> 
413                         // optional type
414                         !(
415                             +spirit::space_p >>
416                             (
417                               spirit::alpha_p >>
418                               *spirit::graph_p
419                             )[spirit::assign_a(type)]
420                         )
421                         // to understand how this group gets set
422                         // read the comment above struct push_back_annot
423                        )[push_back_annot(annots, start, end, type, name)]
424                      |
425                       (spirit::ch_p('>') >> 
426                          (*(spirit::print_p))[spirit::assign_a(name)] >>
427                          spirit::eol_p >> 
428                          (+(spirit::chset<>(iupac_alphabet)))[spirit::assign_a(seq)]
429                        )[push_back_seq(query_seqs, name, seq)]
430                       ) >>
431                       *spirit::space_p
432                      )
433                 //end grammar
434                 ) /*,
435                 spirit::space_p*/).full;
436                 
437   // go seearch for query sequences 
438   find_sequences(query_seqs.begin(), query_seqs.end());
439 }
440
441 const std::string& Sequence::get_species() const
442 {
443   return species;
444 }
445
446 void Sequence::add_annotation(const annot& a)
447 {
448   annots.push_back(a);
449 }
450
451 const std::list<annot>& Sequence::annotations() const
452 {
453   return annots;
454 }
455
456 Sequence
457 Sequence::subseq(int start, int count) const
458 {
459   // there might be an off by one error with start+count > size()
460   if ( count == npos || start+count > size()) {
461     count = size()-start;
462   }
463   Sequence new_seq(std::string::substr(start, count));
464   new_seq.set_header(get_header());
465   //new_seq.set_species(get_species());
466
467   new_seq.motif_list = motif_list;
468   // attempt to copy & reannotate position based annotations 
469   int end = start+count;
470
471   for(std::list<annot>::const_iterator annot_i = annots.begin();
472       annot_i != annots.end();
473       ++annot_i)
474   {
475     int annot_start = annot_i->start;
476     int annot_end = annot_i->end;
477
478     if (annot_start < end) {
479       if (annot_start >=start) {
480         annot_start -= start;
481       } else {
482         annot_start = 0;
483       }
484
485       if (annot_end < end) {
486         annot_end -= start;
487       } else {
488         annot_end = count;
489       }
490
491       annot new_annot(annot_start, annot_end, annot_i->type, annot_i->name);
492       new_seq.annots.push_back(new_annot);
493     }
494   }
495
496   return new_seq;
497 }
498
499 std::string
500 Sequence::rev_comp() const
501 {
502   std::string rev_comp;
503   char conversionTable[257];
504   int seq_i, table_i, len;
505
506   len = length();
507   rev_comp.reserve(len);
508   // make a conversion table
509   // init all parts of conversion table to '~' character
510   // '~' I doubt will ever appear in a sequence file (jeez, I hope)
511   // and may the fleas of 1000 camels infest the genitals of any biologist (and
512   // seven generations of their progeny) who decides to make it mean
513   // something special!!!
514   // PS - double the curse for any smartass non-biologist who tries it as well
515   for(table_i=0; table_i < 256; table_i++)
516   {
517     conversionTable[table_i] = '~';
518   }
519   // add end of string character for printing out table for testing purposes
520   conversionTable[256] = '\0';
521
522   // add in the characters for the bases we want to convert
523   conversionTable[(int)'A'] = 'T';
524   conversionTable[(int)'T'] = 'A';
525   conversionTable[(int)'G'] = 'C';
526   conversionTable[(int)'C'] = 'G';
527   conversionTable[(int)'N'] = 'N';
528
529   // finally, the actual conversion loop
530   for(seq_i = len - 1; seq_i >= 0; seq_i--)
531   {
532     table_i = (int) at(seq_i);
533     rev_comp += conversionTable[table_i];
534   }
535
536   return rev_comp;
537 }
538
539 void Sequence::set_header(std::string header_)
540 {
541   header = header_;
542 }
543
544 std::string
545 Sequence::get_header() const
546 {
547   return header;
548 }
549
550 /*
551 std::string 
552 Sequence::species()
553 {
554   return species;
555 }
556 */
557
558 void
559 Sequence::clear()
560 {
561   std::string::clear();
562   header = "";
563   species = "";
564   annots.clear();
565 }
566
567 void
568 Sequence::save(fs::fstream &save_file)
569                //std::string save_file_path)
570 {
571   //fstream save_file;
572   std::list<annot>::iterator annots_i;
573
574   // not sure why, or if i'm doing something wrong, but can't seem to pass
575   // file pointers down to this method from the mussa control class
576   // so each call to save a sequence appends to the file started by mussa_class
577   //save_file.open(save_file_path.c_str(), std::ios::app);
578
579   save_file << "<Sequence>" << std::endl;
580   save_file << *this << std::endl;
581   save_file << "</Sequence>" << std::endl;
582
583   save_file << "<Annotations>" << std::endl;
584   save_file << species << std::endl;
585   for (annots_i = annots.begin(); annots_i != annots.end(); ++annots_i)
586   {
587     save_file << annots_i->start << " " << annots_i->end << " " ;
588     save_file << annots_i->name << " " << annots_i->type << std::endl;
589   }
590   save_file << "</Annotations>" << std::endl;
591   //save_file.close();
592 }
593
594 void
595 Sequence::load_museq(fs::path load_file_path, int seq_num)
596 {
597   fs::fstream load_file;
598   std::string file_data_line;
599   int seq_counter;
600   annot an_annot;
601   std::string::size_type space_split_i;
602   std::string annot_value;
603
604   annots.clear();
605   load_file.open(load_file_path, std::ios::in);
606
607   seq_counter = 0;
608   // search for the seq_num-th sequence 
609   while ( (!load_file.eof()) && (seq_counter < seq_num) )
610   {
611     getline(load_file,file_data_line);
612     if (file_data_line == "<Sequence>")
613       seq_counter++;
614   }
615   getline(load_file, file_data_line);
616   assign(file_data_line);
617   getline(load_file, file_data_line);
618   getline(load_file, file_data_line);
619   if (file_data_line == "<Annotations>")
620   {
621     getline(load_file, file_data_line);
622     species = file_data_line;
623     while ( (!load_file.eof())  && (file_data_line != "</Annotations>") )
624     {
625       getline(load_file,file_data_line);
626       if ((file_data_line != "") && (file_data_line != "</Annotations>"))  
627       {
628         // need to get 4 values...almost same code 4 times...
629         // get annot start index
630         space_split_i = file_data_line.find(" ");
631         annot_value = file_data_line.substr(0,space_split_i);
632         an_annot.start = atoi (annot_value.c_str());
633         file_data_line = file_data_line.substr(space_split_i+1);
634         // get annot end index
635         space_split_i = file_data_line.find(" ");
636         annot_value = file_data_line.substr(0,space_split_i);
637         an_annot.end = atoi (annot_value.c_str());
638
639         if (space_split_i == std::string::npos)  // no entry for type or name
640         {
641           std::cout << "seq, annots - no type or name\n";
642           an_annot.type = "";
643           an_annot.name = "";
644         }
645         else   // else get annot type
646         {
647           file_data_line = file_data_line.substr(space_split_i+1);
648           space_split_i = file_data_line.find(" ");
649           annot_value = file_data_line.substr(0,space_split_i);
650           an_annot.type = annot_value;
651           if (space_split_i == std::string::npos)  // no entry for name
652           {
653             std::cout << "seq, annots - no name\n";
654             an_annot.name = "";
655           }
656           else          // get annot name
657           {
658             file_data_line = file_data_line.substr(space_split_i+1);
659             space_split_i = file_data_line.find(" ");
660             annot_value = file_data_line.substr(0,space_split_i);
661             an_annot.type = annot_value;
662           }
663         }
664         annots.push_back(an_annot);  // don't forget to actually add the annot
665       }
666       //std::cout << "seq, annots: " << an_annot.start << ", " << an_annot.end
667       //     << "-->" << an_annot.type << "::" << an_annot.name << std::endl;
668     }
669   }
670   load_file.close();
671 }
672
673
674 std::string
675 Sequence::rc_motif(std::string a_motif)
676 {
677   std::string rev_comp;
678   char conversionTable[257];
679   int seq_i, table_i, len;
680
681   len = a_motif.length();
682   rev_comp.reserve(len);
683
684   for(table_i=0; table_i < 256; table_i++)
685   {
686     conversionTable[table_i] = '~';
687   }
688   // add end of std::string character for printing out table for testing purposes
689   conversionTable[256] = '\0';
690
691   // add in the characters for the bases we want to convert (IUPAC)
692   conversionTable[(int)'A'] = 'T';
693   conversionTable[(int)'T'] = 'A';
694   conversionTable[(int)'G'] = 'C';
695   conversionTable[(int)'C'] = 'G';
696   conversionTable[(int)'N'] = 'N';
697   conversionTable[(int)'M'] = 'K';
698   conversionTable[(int)'R'] = 'Y';
699   conversionTable[(int)'W'] = 'W';
700   conversionTable[(int)'S'] = 'S';
701   conversionTable[(int)'Y'] = 'R';
702   conversionTable[(int)'K'] = 'M';
703   conversionTable[(int)'V'] = 'B';
704   conversionTable[(int)'H'] = 'D';
705   conversionTable[(int)'D'] = 'H';
706   conversionTable[(int)'B'] = 'V';
707
708   // finally, the actual conversion loop
709   for(seq_i = len - 1; seq_i >= 0; seq_i--)
710   {
711     //std::cout << "** i = " << seq_i << " bp = " << 
712     table_i = (int) a_motif[seq_i];
713     rev_comp += conversionTable[table_i];
714   }
715
716   //std::cout << "seq: " << a_motif << std::endl;
717   //std::cout << "rc:  " << rev_comp << std::endl;
718
719   return rev_comp;
720 }
721
722 std::string
723 Sequence::motif_normalize(std::string a_motif)
724 {
725   std::string valid_motif;
726   int seq_i, len;
727
728   len = a_motif.length();
729   valid_motif.reserve(len);
730
731   // this just upcases IUPAC symbols.  Eventually should return an error if non IUPAC is present.
732   // current nonIUPAC symbols are omitted, which is not reported atm
733   for(seq_i = 0; seq_i < len; seq_i++)
734   {
735     if ((a_motif[seq_i] == 'a') || (a_motif[seq_i] == 'A'))
736       valid_motif += 'A';
737     else if ((a_motif[seq_i] == 't') || (a_motif[seq_i] == 'T'))
738       valid_motif += 'T';
739     else if ((a_motif[seq_i] == 'g') || (a_motif[seq_i] == 'G'))
740       valid_motif += 'G';
741     else if ((a_motif[seq_i] == 'c') || (a_motif[seq_i] == 'C'))
742       valid_motif += 'C';
743     else if ((a_motif[seq_i] == 'n') || (a_motif[seq_i] == 'N'))
744       valid_motif += 'N';
745     else if ((a_motif[seq_i] == 'm') || (a_motif[seq_i] == 'M'))
746       valid_motif += 'M';
747     else if ((a_motif[seq_i] == 'r') || (a_motif[seq_i] == 'R'))
748       valid_motif += 'R';
749     else if ((a_motif[seq_i] == 'w') || (a_motif[seq_i] == 'W'))
750       valid_motif += 'W';
751     else if ((a_motif[seq_i] == 's') || (a_motif[seq_i] == 'S'))
752       valid_motif += 'S';
753     else if ((a_motif[seq_i] == 'y') || (a_motif[seq_i] == 'Y'))
754       valid_motif += 'Y';
755     else if ((a_motif[seq_i] == 'k') || (a_motif[seq_i] == 'K'))
756       valid_motif += 'G';
757     else if ((a_motif[seq_i] == 'v') || (a_motif[seq_i] == 'V'))
758       valid_motif += 'V';
759     else if ((a_motif[seq_i] == 'h') || (a_motif[seq_i] == 'H'))
760       valid_motif += 'H';
761     else if ((a_motif[seq_i] == 'd') || (a_motif[seq_i] == 'D'))
762       valid_motif += 'D';
763     else if ((a_motif[seq_i] == 'b') || (a_motif[seq_i] == 'B'))
764       valid_motif += 'B';
765     else {
766       std::string msg = "Letter ";
767       msg += a_motif[seq_i];
768       msg += " is not a valid IUPAC symbol";
769       throw motif_normalize_error(msg);
770     }
771   }
772   //std::cout << "valid_motif is: " << valid_motif << std::endl;
773   return valid_motif;
774 }
775
776 void Sequence::add_motif(std::string a_motif)
777 {
778   std::vector<int> motif_starts = find_motif(a_motif);
779
780   for(std::vector<int>::iterator motif_start_i = motif_starts.begin();
781       motif_start_i != motif_starts.end();
782       ++motif_start_i)
783   {
784     motif_list.push_back(motif(*motif_start_i, a_motif));
785   }
786 }
787
788 void Sequence::clear_motifs()
789 {
790   motif_list.clear();
791 }
792
793 const std::list<motif>& Sequence::motifs() const
794 {
795   return motif_list;
796 }
797
798 std::vector<int>
799 Sequence::find_motif(std::string a_motif)
800 {
801   std::vector<int> motif_match_starts;
802   std::string a_motif_rc;
803
804   motif_match_starts.clear();
805
806   //std::cout << "motif is: " << a_motif << std::endl;
807   a_motif = motif_normalize(a_motif);
808   //std::cout << "motif is: " << a_motif << std::endl;
809
810   if (a_motif != "")
811   {
812     //std::cout << "Sequence: none blank motif\n";
813     motif_scan(a_motif, &motif_match_starts);
814
815     a_motif_rc = rc_motif(a_motif);
816     // make sure not to do search again if it is a palindrome
817     if (a_motif_rc != a_motif)
818       motif_scan(a_motif_rc, &motif_match_starts);
819   }
820   return motif_match_starts;
821 }
822
823 void
824 Sequence::motif_scan(std::string a_motif, std::vector<int> * motif_match_starts)
825 {
826    const char * seq_c;
827   std::string::size_type seq_i;
828   int motif_i, motif_len;
829
830   // faster to loop thru the sequence as a old c std::string (ie char array)
831   seq_c = c_str();
832   //std::cout << "Sequence: motif, seq len = " << sequence.length() << std::endl; 
833   motif_len = a_motif.length();
834
835   //std::cout << "motif_length: " << motif_len << std::endl;
836   //std::cout << "RAAARRRRR\n";
837
838   motif_i = 0;
839
840   //std::cout << "motif: " << a_motif << std::endl;
841
842   //std::cout << "Sequence: motif, length= " << length << std::endl;
843   seq_i = 0;
844   while (seq_i < length())
845   {
846     //std::cout << seq_c[seq_i];
847     //std::cout << seq_c[seq_i] << "?" << a_motif[motif_i] << ":" << motif_i << " ";
848     // this is pretty much a straight translation of Nora's python code
849     // to match iupac letter codes
850     if (a_motif[motif_i] =='N')
851       motif_i++;
852     else if (a_motif[motif_i] == seq_c[seq_i])
853       motif_i++;
854     else if ((a_motif[motif_i] =='M') && 
855              ((seq_c[seq_i]=='A') || (seq_c[seq_i]=='C')))
856       motif_i++;
857     else if ((a_motif[motif_i] =='R') && 
858              ((seq_c[seq_i]=='A') || (seq_c[seq_i]=='G')))
859       motif_i++;
860     else if ((a_motif[motif_i] =='W') && 
861              ((seq_c[seq_i]=='A') || (seq_c[seq_i]=='T')))
862       motif_i++;
863     else if ((a_motif[motif_i] =='S') && 
864              ((seq_c[seq_i]=='C') || (seq_c[seq_i]=='G')))
865       motif_i++;
866     else if ((a_motif[motif_i] =='Y') && 
867              ((seq_c[seq_i]=='C') || (seq_c[seq_i]=='T')))
868       motif_i++;
869     else if ((a_motif[motif_i] =='K') && 
870              ((seq_c[seq_i]=='G') || (seq_c[seq_i]=='T')))
871       motif_i++;
872     else if ((a_motif[motif_i] =='V') && 
873              ((seq_c[seq_i]=='A') || (seq_c[seq_i]=='C') ||
874               (seq_c[seq_i]=='G')))
875       motif_i++;
876     else if ((a_motif[seq_i] =='H') && 
877              ((seq_c[seq_i]=='A') || (seq_c[seq_i]=='C') ||
878               (seq_c[seq_i]=='T')))
879       motif_i++;
880     else if ((a_motif[motif_i] =='D') &&
881              ((seq_c[seq_i]=='A') || (seq_c[seq_i]=='G') ||
882               (seq_c[seq_i]=='T')))
883       motif_i++;
884     else if ((a_motif[motif_i] =='B') &&
885              ((seq_c[seq_i]=='C') || (seq_c[seq_i]=='G') ||
886               (seq_c[seq_i]=='T')))
887       motif_i++;
888
889     else
890     {
891       seq_i -= motif_i;
892       motif_i = 0;
893     }
894
895     // end Nora stuff, now we see if a match is found this pass
896     if (motif_i == motif_len)
897     {
898       //std::cout << "!!";
899       annot new_motif;
900       motif_match_starts->push_back(seq_i - motif_len + 1);
901       motif_i = 0;
902     }
903
904     seq_i++;
905   }
906   //std::cout << std::endl;
907 }
908
909 void Sequence::add_string_annotation(std::string a_seq, 
910                                      std::string name)
911 {
912   std::vector<int> seq_starts = find_motif(a_seq);
913   
914   //std::cout << "searching for " << a_seq << " found " << seq_starts.size() << std::endl;
915
916   for(std::vector<int>::iterator seq_start_i = seq_starts.begin();
917       seq_start_i != seq_starts.end();
918       ++seq_start_i)
919   {
920     annots.push_back(annot(*seq_start_i, 
921                            *seq_start_i+a_seq.size(),
922                            "",
923                            name));
924   }
925 }
926
927 void Sequence::find_sequences(std::list<Sequence>::iterator start, 
928                               std::list<Sequence>::iterator end)
929 {
930   while (start != end) {
931     add_string_annotation(*start, start->get_header());
932     ++start;
933   }
934 }
935