src/jalview/datamodel/AlignmentI.java

   1 /*
   2  * Jalview - A Sequence Alignment Editor and Viewer
   3  * Copyright (C) 2007 AM Waterhouse, J Procter, G Barton, M Clamp, S Searle
   4  *
   5  * This program is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU General Public License
   7  * as published by the Free Software Foundation; either version 2
   8  * of the License, or (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
  18  */
  19 package jalview.datamodel;
  20
  21 import java.util.*;
  22
  23 /** Data structure to hold and manipulate a multiple sequence alignment
  24  */
  25 public interface AlignmentI
  26 {
  27   /**
  28    *  Calculates the number of sequences in an alignment
  29    *
  30    * @return Number of sequences in alignment
  31    */
  32   public int getHeight();
  33
  34   /**
  35    * Calculates the maximum width of the alignment, including gaps.
  36    *
  37    * @return Greatest sequence length within alignment.
  38    */
  39   public int getWidth();
  40
  41   /**
  42    * Calculates if this set of sequences is all the same length
  43    *
  44    * @return true if all sequences in alignment are the same length
  45    */
  46   public boolean isAligned();
  47
  48   /**
  49    * Gets sequences as a Vector
  50    *
  51    * @return All sequences in alignment.
  52    */
  53   public Vector getSequences();
  54
  55   /**
  56    * Gets sequences as a SequenceI[]
  57    *
  58    * @return All sequences in alignment.
  59    */
  60   public SequenceI[] getSequencesArray();
  61
  62   /**
  63    * Find a specific sequence in this alignment.
  64    *
  65    * @param i Index of required sequence.
  66    *
  67    * @return SequenceI at given index.
  68    */
  69   public SequenceI getSequenceAt(int i);
  70
  71   /**
  72    * Add a new sequence to this alignment.
  73    *
  74    * @param seq New sequence will be added at end of alignment.
  75    */
  76   public void addSequence(SequenceI seq);
  77
  78   /**
  79    * Used to set a particular index of the alignment with the given sequence.
  80    *
  81    * @param i Index of sequence to be updated.
  82    * @param seq New sequence to be inserted.
  83    */
  84   public void setSequenceAt(int i, SequenceI seq);
  85
  86   /**
  87    * Deletes a sequence from the alignment
  88    *
  89    * @param s Sequence to be deleted.
  90    */
  91   public void deleteSequence(SequenceI s);
  92
  93   /**
  94    * Deletes a sequence from the alignment.
  95    *
  96    * @param i Index of sequence to be deleted.
  97    */
  98   public void deleteSequence(int i);
  99
 100   /**
 101    * Finds sequence in alignment using sequence name as query.
 102    *
 103    * @param name Id of sequence to search for.
 104    *
 105    * @return Sequence matching query, if found. If not found returns null.
 106    */
 107   public SequenceI findName(String name);
 108
 109   public SequenceI[] findSequenceMatch(String name);
 110
 111   /**
 112    * Finds index of a given sequence in the alignment.
 113    *
 114    * @param s Sequence to look for.
 115    *
 116    * @return Index of sequence within the alignment.
 117    */
 118   public int findIndex(SequenceI s);
 119
 120   /**
 121    * Finds group that given sequence is part of.
 122    *
 123    * @param s Sequence in alignment.
 124    *
 125    * @return First group found for sequence. WARNING :
 126    * Sequences may be members of several groups. This method is incomplete.
 127    */
 128   public SequenceGroup findGroup(SequenceI s);
 129
 130   /**
 131    * Finds all groups that a given sequence is part of.
 132    *
 133    * @param s Sequence in alignment.
 134    *
 135    * @return All groups containing given sequence.
 136    */
 137   public SequenceGroup[] findAllGroups(SequenceI s);
 138
 139   /**
 140    * Adds a new SequenceGroup to this alignment.
 141    *
 142    * @param sg New group to be added.
 143    */
 144   public void addGroup(SequenceGroup sg);
 145
 146   /**
 147    * Deletes a specific SequenceGroup
 148    *
 149    * @param g Group will be deleted from alignment.
 150    */
 151   public void deleteGroup(SequenceGroup g);
 152
 153   /**
 154    * Get all the groups associated with this alignment.
 155    *
 156    * @return All groups as a Vector.
 157    */
 158   public Vector getGroups();
 159
 160
 161   /**
 162    * Deletes all groups from this alignment.
 163    */
 164   public void deleteAllGroups();
 165
 166   /**
 167    * Adds a new AlignmentAnnotation to this alignment
 168    */
 169   public void addAnnotation(AlignmentAnnotation aa);
 170   /**
 171    * moves annotation to a specified index in alignment annotation display stack
 172    * @param aa the annotation object to be moved
 173    * @param index the destination position
 174    */
 175   public void setAnnotationIndex(AlignmentAnnotation aa, int index);
 176
 177   /**
 178    * Deletes a specific AlignmentAnnotation from the alignment.
 179    *
 180    * @param aa the annotation to delete
 181    */
 182   public void deleteAnnotation(AlignmentAnnotation aa);
 183
 184   /**
 185    * Get the annotation associated with this alignment
 186    *
 187    * @return array of AlignmentAnnotation objects
 188    */
 189   public AlignmentAnnotation[] getAlignmentAnnotation();
 190
 191   /**
 192    * Change the gap character used in this alignment to 'gc'
 193    *
 194    * @param gc the new gap character.
 195    */
 196   public void setGapCharacter(char gc);
 197
 198   /**
 199    * Get the gap character used in this alignment
 200    *
 201    * @return gap character
 202    */
 203   public char getGapCharacter();
 204
 205   /**
 206    * Test for all nucleotide alignment
 207    *
 208    * @return true if alignment is nucleotide sequence
 209    */
 210   public boolean isNucleotide();
 211
 212   /**
 213    * Set alignment to be a nucleotide sequence
 214    *
 215    */
 216   public void setNucleotide(boolean b);
 217
 218   /**
 219    * Get the associated dataset for the alignment.
 220    * @return Alignment containing dataset sequences or null of this is a dataset.
 221    */
 222   public Alignment getDataset();
 223
 224   /**
 225    * Set the associated dataset for the alignment, or create one.
 226    * @param dataset The dataset alignment or null to construct one.
 227    */
 228   public void setDataset(Alignment dataset);
 229
 230   /**
 231    * pads sequences with gaps (to ensure the set looks like an alignment)
 232    * @return boolean true if alignment was modified
 233    */
 234   public boolean padGaps();
 235
 236   public HiddenSequences getHiddenSequences();
 237
 238   /**
 239    * Compact representation of alignment
 240    * @return CigarArray
 241    */
 242   public CigarArray getCompactAlignment();
 243 }