JAL-1264 wip

[jalview.git] / src / jalview / datamodel / AnnotatedCollectionI.java

diff --git a/src/jalview/datamodel/AnnotatedCollectionI.java b/src/jalview/datamodel/AnnotatedCollectionI.java
index 0b4c117..6bd4ab9 100644 (file)
--- a/src/jalview/datamodel/AnnotatedCollectionI.java
+++ b/src/jalview/datamodel/AnnotatedCollectionI.java
@@ -40,4 +40,21 @@ public interface AnnotatedCollectionI extends SequenceCollectionI
    *         alignment, parent group).
    */
   AnnotatedCollectionI getContext();
+
+  /**
+   * Return an iterable set of any annotations in the collection that match the
+   * provided criteria, i.e.
+   * <ul>
+   * <li>reference the same sequence datasequence</li>
+   * <li>have the same calcId (source of annotation)</li>
+   * <li>have the same label (type of annotation)</li>
+   * </ul>
+   * 
+   * @param datasequence
+   * @param calcId
+   * @param label
+   * @return
+   */
+  Iterable<AlignmentAnnotation> findAnnotation(SequenceI datasequence,
+          String calcId, String label);
 }