001/*
002 *                    BioJava development code
003 *
004 * This code may be freely distributed and modified under the
005 * terms of the GNU Lesser General Public Licence.  This should
006 * be distributed with the code.  If you do not have a copy,
007 * see:
008 *
009 *      http://www.gnu.org/copyleft/lesser.html
010 *
011 * Copyright for this code is held jointly by the individual
012 * authors.  These should be listed in @author doc comments.
013 *
014 * For more information on the BioJava project and its aims,
015 * or to join the biojava-l mailing list, visit the home page
016 * at:
017 *
018 *      http://www.biojava.org/
019 *
020 * Created on June 7, 2010
021 * Author: Mark Chapman
022 */
023
024package org.biojava.nbio.core.alignment.template;
025
026import org.biojava.nbio.core.alignment.template.AlignedSequence;
027import org.biojava.nbio.core.sequence.location.template.Location;
028import org.biojava.nbio.core.sequence.template.Compound;
029import org.biojava.nbio.core.sequence.template.Sequence;
030
031/**
032 * Defines a mutable (editable) data structure for an {@link AlignedSequence}.
033 *
034 * @author Mark Chapman
035 * @author Paolo Pavan
036 * @param <C> each element of the {@link AlignedSequence} is a {@link Compound} of type C
037 */
038public interface MutableAlignedSequence<S extends Sequence<C>, C extends Compound> extends AlignedSequence<S, C> {
039
040        /**
041         * Sets the position of the {@link AlignedSequence} to the given {@link Location} (start, gaps, end).
042         *
043         * @param location new location for this sequence
044         * @throws IllegalArgumentException if location is invalid
045         */
046        void setLocationInAlignment(Location location);
047
048        /**
049         * Slides a part of the {@link AlignedSequence}.
050         *
051         * @param location portion of sequence moved in alignment coordinates
052         * @param shift amount the alignment index changes for each contained element
053         * @throws IllegalArgumentException if location is invalid or the shift causes a collision with stationary elements
054         */
055        void shiftAtAlignmentLocation(Location location, int shift);
056
057        /**
058         * Slides a part of the {@link AlignedSequence}.
059         *
060         * @param location portion of sequence moved in sequence coordinates
061         * @param shift amount the alignment index changes for each contained element
062         * @throws IllegalArgumentException if location is invalid or the shift causes a collision with stationary elements
063         */
064        void shiftAtSequenceLocation(Location location, int shift);
065
066}