*/
package jalview.datamodel;
+import java.util.List;
import java.util.Vector;
import fr.orsay.lri.varna.models.rna.RNA;
* create a new sequence object from start to end of this sequence
*
* @param start
- * int
+ * int index for start position
* @param end
- * int
+ * int index for end position
+ *
* @return SequenceI
+ * @note implementations may use getSequence to get the sequence data
*/
public SequenceI getSubSequence(int start, int end);
* Returns the sequence position for an alignment position
*
* @param i
- * column index in alignment (from 1)
+ * column index in alignment (from 0..<length)
*
* @return residue number for residue (left of and) nearest ith column
*/
public AlignmentAnnotation[] getAnnotation(String label);
/**
+ * Return a list of any annotations which match the given calcId (source) and
+ * label (type). Null values do not match.
+ *
+ * @param calcId
+ * @param label
+ * @return
+ */
+ public List<AlignmentAnnotation> getAlignmentAnnotations(String calcId,
+ String label);
+
+ /**
* create a new dataset sequence (if necessary) for this sequence and sets
* this sequence to refer to it. This call will move any features or
- * references on the sequence onto the dataset.
+ * references on the sequence onto the dataset. It will also make a duplicate
+ * of existing annotation rows for the dataset sequence, rather than relocate
+ * them in order to preserve external references (since 2.8.2).
*
* @return dataset sequence for this sequence
*/
/**
* Transfer any database references or annotation from entry under a sequence
- * mapping.
+ * mapping. <br/>
+ * <strong>Note: DOES NOT transfer sequence associated alignment
+ * annotation </strong><br/>
*
* @param entry
* @param mp