74568e45fd4a4ce2f3e1ee4a88e63142e488b3dc
[jalview.git] / src / jalview / datamodel / AnnotatedCollectionI.java
1 /*
2  * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3  * Copyright (C) $$Year-Rel$$ The Jalview Authors
4  * 
5  * This file is part of Jalview.
6  * 
7  * Jalview is free software: you can redistribute it and/or
8  * modify it under the terms of the GNU General Public License 
9  * as published by the Free Software Foundation, either version 3
10  * of the License, or (at your option) any later version.
11  *  
12  * Jalview is distributed in the hope that it will be useful, but 
13  * WITHOUT ANY WARRANTY; without even the implied warranty 
14  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
15  * PURPOSE.  See the GNU General Public License for more details.
16  * 
17  * You should have received a copy of the GNU General Public License
18  * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
19  * The Jalview Authors are detailed in the 'AUTHORS' file.
20  */
21 package jalview.datamodel;
22
23 public interface AnnotatedCollectionI extends SequenceCollectionI
24 {
25
26   /**
27    * TODO: decide if null is a valid response if there is no annotation on the
28    * object
29    * 
30    * @return null
31    */
32   AlignmentAnnotation[] getAlignmentAnnotation();
33
34   Iterable<AlignmentAnnotation> findAnnotation(String calcId);
35
36   Iterable<AlignmentAnnotation> findAnnotations(SequenceI seq,
37           String calcId, String label);
38
39   /**
40    * context for this annotated collection
41    * 
42    * @return null or the collection upon which this collection is defined (e.g.
43    *         alignment, parent group).
44    */
45   AnnotatedCollectionI getContext();
46 }