X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Fdatamodel%2FAlignmentI.java;h=12baabfed3b7dcc47cefb07d9027b7e5bebf47ed;hb=451619e33c0a90c8130c7d79ffa38161af1c6e0f;hp=e48ff365e90ce54b92919a10fbe00f1c2e033063;hpb=99c58ee0ae2a848f982552e53feaf6d5cb9925e5;p=jalview.git diff --git a/src/jalview/datamodel/AlignmentI.java b/src/jalview/datamodel/AlignmentI.java index e48ff36..12baabf 100755 --- a/src/jalview/datamodel/AlignmentI.java +++ b/src/jalview/datamodel/AlignmentI.java @@ -1,96 +1,239 @@ -/* -* Jalview - A Sequence Alignment Editor and Viewer -* Copyright (C) 2005 AM Waterhouse, J Procter, G Barton, M Clamp, S Searle -* -* This program is free software; you can redistribute it and/or -* modify it under the terms of the GNU General Public License -* as published by the Free Software Foundation; either version 2 -* of the License, or (at your option) any later version. -* -* This program is distributed in the hope that it will be useful, -* but WITHOUT ANY WARRANTY; without even the implied warranty of -* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -* GNU General Public License for more details. -* -* You should have received a copy of the GNU General Public License -* along with this program; if not, write to the Free Software -* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA -*/ - -package jalview.datamodel; - -import java.util.*; - -/** Data structure to hold and manipulate a multiple sequence alignment - */ -public interface AlignmentI { - - public int getHeight() ; - public int getWidth() ; - public int getMaxIdLength() ; - - public boolean isAligned(); - - public Vector getSequences(); - public SequenceI getSequenceAt(int i); - - public void addSequence(SequenceI seq) ; - public void setSequenceAt(int i,SequenceI seq); - - public void deleteSequence(SequenceI s) ; - public void deleteSequence(int i) ; - - public SequenceI[] getColumns(int start, int end) ; - public SequenceI[] getColumns(int seq1, int seq2, int start, int end) ; - - public void deleteColumns(int start, int end) ; - public void deleteColumns(int seq1, int seq2, int start, int end) ; - - public void insertColumns(SequenceI[] seqs, int pos) ; - - public SequenceI findName(String name) ; - public SequenceI findbyDisplayId(String name); - - public int findIndex(SequenceI s) ; - - // Modifying - public void trimLeft(int i) ; - public void trimRight(int i) ; - - public void removeGaps() ; - public Vector removeRedundancy(float threshold, Vector sel) ; - - - // Grouping methods - public SequenceGroup findGroup(int i) ; - public SequenceGroup findGroup(SequenceI s) ; - public SequenceGroup [] findAllGroups(SequenceI s); - public void addToGroup(SequenceGroup g, SequenceI s) ; - public void removeFromGroup(SequenceGroup g,SequenceI s) ; - public void addGroup(SequenceGroup sg) ; - public void deleteGroup(SequenceGroup g) ; - public Vector getGroups(); - public void deleteAllGroups(); - - public void addSuperGroup(SuperGroup sg); - public void removeSuperGroup(SuperGroup sg); - public SuperGroup getSuperGroup(SequenceGroup sg); - - // Sorting - public void sortGroups() ; - public void sortByPID(SequenceI s) ; - public void sortByID() ; - - //Annotations - public void addAnnotation(AlignmentAnnotation aa); - public void deleteAnnotation(AlignmentAnnotation aa); - public AlignmentAnnotation [] getAlignmentAnnotation(); - - public void setGapCharacter(char gc); - public char getGapCharacter(); - - public Vector getAAFrequency(); -} - - - +/* +* Jalview - A Sequence Alignment Editor and Viewer +* Copyright (C) 2006 AM Waterhouse, J Procter, G Barton, M Clamp, S Searle +* +* This program is free software; you can redistribute it and/or +* modify it under the terms of the GNU General Public License +* as published by the Free Software Foundation; either version 2 +* of the License, or (at your option) any later version. +* +* This program is distributed in the hope that it will be useful, +* but WITHOUT ANY WARRANTY; without even the implied warranty of +* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +* GNU General Public License for more details. +* +* You should have received a copy of the GNU General Public License +* along with this program; if not, write to the Free Software +* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA +*/ +package jalview.datamodel; + +import java.util.*; + + +/** Data structure to hold and manipulate a multiple sequence alignment + */ +public interface AlignmentI +{ + /** + * Calculates the number of sequences in an alignment + * + * @return Number of sequences in alignment + */ + public int getHeight(); + + /** + * Calculates the maximum width of the alignment, including gaps. + * + * @return Greatest sequence length within alignment. + */ + public int getWidth(); + + + /** + * Calculates if this set of sequences is all the same length + * + * @return true if all sequences in alignment are the same length + */ + public boolean isAligned(); + + /** + * Gets sequences as a Vector + * + * @return All sequences in alignment. + */ + public Vector getSequences(); + + /** + * Gets sequences as a SequenceI[] + * + * @return All sequences in alignment. + */ + public SequenceI [] getSequencesArray(); + + /** + * Find a specific sequence in this alignment. + * + * @param i Index of required sequence. + * + * @return SequenceI at given index. + */ + public SequenceI getSequenceAt(int i); + + /** + * Add a new sequence to this alignment. + * + * @param seq New sequence will be added at end of alignment. + */ + public void addSequence(SequenceI seq); + + /** + * Used to set a particular index of the alignment with the given sequence. + * + * @param i Index of sequence to be updated. + * @param seq New sequence to be inserted. + */ + public void setSequenceAt(int i, SequenceI seq); + + /** + * Deletes a sequence from the alignment + * + * @param s Sequence to be deleted. + */ + public void deleteSequence(SequenceI s); + + /** + * Deletes a sequence from the alignment. + * + * @param i Index of sequence to be deleted. + */ + public void deleteSequence(int i); + + + /** + * Finds sequence in alignment using sequence name as query. + * + * @param name Id of sequence to search for. + * + * @return Sequence matching query, if found. If not found returns null. + */ + public SequenceI findName(String name); + + public SequenceI [] findSequenceMatch(String name); + + /** + * Finds index of a given sequence in the alignment. + * + * @param s Sequence to look for. + * + * @return Index of sequence within the alignment. + */ + public int findIndex(SequenceI s); + + + /** + * Finds group that given sequence is part of. + * + * @param s Sequence in alignment. + * + * @return First group found for sequence. WARNING : + * Sequences may be members of several groups. This method is incomplete. + */ + public SequenceGroup findGroup(SequenceI s); + + /** + * Finds all groups that a given sequence is part of. + * + * @param s Sequence in alignment. + * + * @return All groups containing given sequence. + */ + public SequenceGroup[] findAllGroups(SequenceI s); + + /** + * Adds a new SequenceGroup to this alignment. + * + * @param sg New group to be added. + */ + public void addGroup(SequenceGroup sg); + + /** + * Deletes a specific SequenceGroup + * + * @param g Group will be deleted from alignment. + */ + public void deleteGroup(SequenceGroup g); + + /** + * Get all the groups associated with this alignment. + * + * @return All groups as a Vector. + */ + public Vector getGroups(); + + /** + * Deletes all groups from this alignment. + */ + public void deleteAllGroups(); + + + /** + * Adds a new AlignmentAnnotation to this alignment + */ + public void addAnnotation(AlignmentAnnotation aa); + + + public void setAnnotationIndex(AlignmentAnnotation aa, int index); + + /** + * Deletes a specific AlignmentAnnotation from the alignment. + * + * @param aa DOCUMENT ME! + */ + public void deleteAnnotation(AlignmentAnnotation aa); + + /** + * DOCUMENT ME! + * + * @return DOCUMENT ME! + */ + public AlignmentAnnotation[] getAlignmentAnnotation(); + + /** + * DOCUMENT ME! + * + * @param gc DOCUMENT ME! + */ + public void setGapCharacter(char gc); + + /** + * DOCUMENT ME! + * + * @return DOCUMENT ME! + */ + public char getGapCharacter(); + + + /** + * Returns true if alignment is nucleotide sequence + * + * @return DOCUMENT ME! + */ + public boolean isNucleotide(); + + /** + * Set true if the alignment is a nucleotide sequence + * + * @return + */ + public void setNucleotide(boolean b); + + + public Alignment getDataset(); + + public void setDataset(Alignment dataset); + /** + * pads sequences with gaps (to ensure the set looks like an alignment) + * @return boolean true if alignment was modified + */ + public boolean padGaps(); + + public void adjustSequenceAnnotations(); + + public HiddenSequences getHiddenSequences(); + /** + * Compact representation of alignment + * @return CigarArray + */ + public CigarArray getCompactAlignment(); +}