X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Fdatamodel%2FAlignmentI.java;h=06026ef7f692233568d44db95f7ff3d2ab075f89;hb=e1476d3c4ebb1c8f6b3ec7d46bb824b23987960e;hp=a193997a288937ad7976a1eee9137ffc7d79a00a;hpb=797df64fa2a0a30773d0f48f5494d4155e5a8be3;p=jalview.git diff --git a/src/jalview/datamodel/AlignmentI.java b/src/jalview/datamodel/AlignmentI.java index a193997..06026ef 100755 --- a/src/jalview/datamodel/AlignmentI.java +++ b/src/jalview/datamodel/AlignmentI.java @@ -1,13 +1,13 @@ /* - * Jalview - A Sequence Alignment Editor and Viewer (Version 2.7) - * Copyright (C) 2011 J Procter, AM Waterhouse, J Engelhardt, LM Lui, G Barton, M Clamp, S Searle + * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8) + * Copyright (C) 2012 J Procter, AM Waterhouse, LM Lui, J Engelhardt, G Barton, M Clamp, S Searle * * This file is part of Jalview. * * Jalview 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 3 of the License, or (at your option) any later version. - * + * * Jalview 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 @@ -22,7 +22,7 @@ import java.util.*; /** * Data structure to hold and manipulate a multiple sequence alignment */ -public interface AlignmentI +public interface AlignmentI extends AnnotatedCollectionI { /** * Calculates the number of sequences in an alignment @@ -36,6 +36,7 @@ public interface AlignmentI * * @return Greatest sequence length within alignment. */ + @Override public int getWidth(); /** @@ -56,11 +57,12 @@ public interface AlignmentI public boolean isAligned(boolean includeHidden); /** - * Gets sequences as a Vector + * Gets sequences as a Synchronized collection * * @return All sequences in alignment. */ - public Vector getSequences(); + @Override + public List getSequences(); /** * Gets sequences as a SequenceI[] @@ -175,9 +177,9 @@ public interface AlignmentI /** * Get all the groups associated with this alignment. * - * @return All groups as a Vector. + * @return All groups as a list. */ - public Vector getGroups(); + public List getGroups(); /** * Deletes all groups from this alignment. @@ -236,6 +238,7 @@ public interface AlignmentI * * @return array of AlignmentAnnotation objects */ + @Override public AlignmentAnnotation[] getAlignmentAnnotation(); /** @@ -431,4 +434,39 @@ public interface AlignmentI * @param i */ public void addAnnotation(AlignmentAnnotation consensus, int i); + + /** + * search for or create a specific annotation row on the alignment + * + * @param name + * name for annotation (must match) + * @param calcId + * calcId for the annotation (null or must match) + * @param autoCalc + * - value of autocalc flag for the annotation + * @param seqRef + * - null or specific sequence reference + * @param groupRef + * - null or specific group reference + * @param method + * - CalcId for the annotation (must match) + * + * @return existing annotation matching the given attributes + */ + public AlignmentAnnotation findOrCreateAnnotation(String name, + String calcId, boolean autoCalc, SequenceI seqRef, + SequenceGroup groupRef); + + /** + * move the given group up or down in the alignment by the given number of + * rows. Implementor assumes given group is already present on alignment - no + * recalculations are triggered. + * + * @param sg + * @param map + * @param up + * @param i + */ + public void moveSelectedSequencesByOne(SequenceGroup sg, + Map map, boolean up); }