org.biojava.nbio.structure.align.multiple

Class MultipleAlignmentEnsembleImpl

java.lang.Object

org.biojava.nbio.structure.align.multiple.AbstractScoresCache

org.biojava.nbio.structure.align.multiple.MultipleAlignmentEnsembleImpl

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, MultipleAlignmentEnsemble, ScoresCache

public class MultipleAlignmentEnsembleImpl
extends AbstractScoresCache
implements MultipleAlignmentEnsemble, java.io.Serializable, java.lang.Cloneable

A general implementation of a MultipleAlignmentEnsemble.

Author:

Aleix Lafita

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
MultipleAlignmentEnsembleImpl() Default Constructor.
MultipleAlignmentEnsembleImpl(AFPChain afpChain, Atom[] ca1, Atom[] ca2) Constructor from an AFPChain instance.
MultipleAlignmentEnsembleImpl(java.util.List<java.lang.String> structureNames) Constructor using structure identifiers.
MultipleAlignmentEnsembleImpl(MultipleAlignmentEnsembleImpl e) Copy constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	addMultipleAlignment(MultipleAlignment alignment) Add a new MultipleAlignment to the end of the ensemble and set its parent ensemble to this.
void	clear() Resets all scores
MultipleAlignmentEnsembleImpl	clone() Creates and returns an identical copy of this ensemble, including a deep clone of all constituent alignments.
java.lang.String	getAlgorithmName() Returns the name of the multiple structure alignment algorithm that created the MultipleAlignment objects.
int	getAlignmentNum() Return the number of alternative alignments stored in the Ensemble.
java.util.List<Atom[]>	getAtomArrays() Get an array of representative atoms for each structure (CA atoms for proteins).
java.lang.Long	getCalculationTime() public Returns the running time of the structure alignment calculation, in milliseconds.
java.util.List<Matrix>	getDistanceMatrix() Returns the List containing the interatomic distance Matrix of each structure.
java.lang.Long	getIoTime() Returns the io time for this object, in milliseconds.
java.util.List<MultipleAlignment>	getMultipleAlignments() Returns the List of MultipleAlignments in the MultipleAlignmentEnsemble object.
java.util.List<java.lang.String>	getStructureNames() Returns a List containing the names of the structures aligned (i.e.: PDB code, SCOP domain, etc.).
java.lang.String	getVersion() Returns the version of the algorithm used to generate the MultipleAlignment objects.
void	setAlgorithmName(java.lang.String algorithmName) Set the name of the multiple structure alignment algorithm that created the MultipleAlignment objects.
void	setAtomArrays(java.util.List<Atom[]> atomArrays) Sets the List of Atom arrays.
void	setCalculationTime(java.lang.Long millis) Set the time needed to calculate this alignment
void	setIoTime(java.lang.Long millis) Set the IO time to load this object
void	setMultipleAlignments(java.util.List<MultipleAlignment> multipleAlignments) Set the List of MultipleAlignments in the MultipleAlignmentEnsemble object.
void	setStructureNames(java.util.List<java.lang.String> structureNames) Set the List containing the names of the structures aligned (i.e.: PDB code, SCOP domain, etc.).
void	setVersion(java.lang.String version) Sets the version of the algorithm used to generate the MultipleAlignment objects.
int	size() Returns the number of aligned structures in the MultipleAlignments.
void	updateAtomArrays() Force the atom arrays to regenerate based on getStructureNames()
void	updateDistanceMatrix() Force recalculation of the distance matrices

Methods inherited from class org.biojava.nbio.structure.align.multiple.AbstractScoresCache

clone, getScore, getScores, putScore

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.biojava.nbio.structure.align.multiple.ScoresCache

getScore, getScores, putScore

Constructor Detail

MultipleAlignmentEnsembleImpl

public MultipleAlignmentEnsembleImpl()

Default Constructor. Empty ensemble, no structures assigned.

MultipleAlignmentEnsembleImpl

public MultipleAlignmentEnsembleImpl(java.util.List<java.lang.String> structureNames)

Constructor using structure identifiers.

Parameters:

structureNames - List of Structure names, that can be parsed by AtomCache.

MultipleAlignmentEnsembleImpl

public MultipleAlignmentEnsembleImpl(MultipleAlignmentEnsembleImpl e)

Copy constructor.

Parameters:

e - MultipleAlignmentEnsembleImpl to copy.

MultipleAlignmentEnsembleImpl

public MultipleAlignmentEnsembleImpl(AFPChain afpChain,
                             Atom[] ca1,
                             Atom[] ca2)

Constructor from an AFPChain instance. Creates an equivalent pairwise alignment.

Parameters:

ensemble - parent MultipleAlignmentEnsemble.

Method Detail

clone

public MultipleAlignmentEnsembleImpl clone()

Description copied from interface: MultipleAlignmentEnsemble

Creates and returns an identical copy of this ensemble, including a deep clone of all constituent alignments.

Specified by:

clone in interface MultipleAlignmentEnsemble

Overrides:

clone in class java.lang.Object

Returns:

MultipleAlignmentEnsemble identical copy of this object.

getAlgorithmName

public java.lang.String getAlgorithmName()

Description copied from interface: MultipleAlignmentEnsemble

Returns the name of the multiple structure alignment algorithm that created the MultipleAlignment objects.

Specified by:

getAlgorithmName in interface MultipleAlignmentEnsemble

Returns:

String name of the algorithm.

See Also:

MultipleAlignmentEnsemble.setAlgorithmName(String)

setAlgorithmName

public void setAlgorithmName(java.lang.String algorithmName)

Description copied from interface: MultipleAlignmentEnsemble

Set the name of the multiple structure alignment algorithm that created the MultipleAlignment objects.

Specified by:

setAlgorithmName in interface MultipleAlignmentEnsemble

Parameters:

algorithmName - name of the algorithm.

See Also:

MultipleAlignmentEnsemble.getAlgorithmName()

getVersion

public java.lang.String getVersion()

Description copied from interface: MultipleAlignmentEnsemble

Returns the version of the algorithm used to generate the MultipleAlignment objects.

Specified by:

getVersion in interface MultipleAlignmentEnsemble

Returns:

String version of the algorithm.

See Also:

MultipleAlignmentEnsemble.setVersion(String)

setVersion

public void setVersion(java.lang.String version)

Description copied from interface: MultipleAlignmentEnsemble

Sets the version of the algorithm used to generate the MultipleAlignment objects.

Specified by:

setVersion in interface MultipleAlignmentEnsemble

Parameters:

version - the version of the algorithm.

See Also:

MultipleAlignmentEnsemble.getVersion()

getIoTime

public java.lang.Long getIoTime()

Description copied from interface: MultipleAlignmentEnsemble

Returns the io time for this object, in milliseconds.

Specified by:

getIoTime in interface MultipleAlignmentEnsemble

Returns:

long creation time, or null if unset

setIoTime

public void setIoTime(java.lang.Long millis)

Description copied from interface: MultipleAlignmentEnsemble

Set the IO time to load this object

Specified by:

setIoTime in interface MultipleAlignmentEnsemble

getCalculationTime

public java.lang.Long getCalculationTime()

Description copied from interface: MultipleAlignmentEnsemble

public Returns the running time of the structure alignment calculation, in milliseconds.

Specified by:

getCalculationTime in interface MultipleAlignmentEnsemble

Returns:

long running time of the calculation, or null if unset

See Also:

MultipleAlignmentEnsemble.getIoTime()L

setCalculationTime

public void setCalculationTime(java.lang.Long millis)

Description copied from interface: MultipleAlignmentEnsemble

Set the time needed to calculate this alignment

Specified by:

setCalculationTime in interface MultipleAlignmentEnsemble

getStructureNames

public java.util.List<java.lang.String> getStructureNames()

Description copied from interface: MultipleAlignmentEnsemble

Returns a List containing the names of the structures aligned (i.e.: PDB code, SCOP domain, etc.).

The names are structure identifiers of the structures. They are in the same order as in the alignment Blocks (same index number for same structure).

Specified by:

getStructureNames in interface MultipleAlignmentEnsemble

Returns:

List of String names of the structures

See Also:

MultipleAlignmentEnsemble.setStructureNames(List), MultipleAlignmentEnsemble.getAtomArrays()

setStructureNames

public void setStructureNames(java.util.List<java.lang.String> structureNames)

Description copied from interface: MultipleAlignmentEnsemble

Set the List containing the names of the structures aligned (i.e.: PDB code, SCOP domain, etc.).

The names are structure identifiers of the structures.

Specified by:

setStructureNames in interface MultipleAlignmentEnsemble

Parameters:

structureNames - names of the structures, structure identifiers

See Also:

MultipleAlignmentEnsemble.getStructureNames(), MultipleAlignmentEnsemble.setAtomArrays(List)

getAtomArrays

public java.util.List<Atom[]> getAtomArrays()

Description copied from interface: MultipleAlignmentEnsemble

Get an array of representative atoms for each structure (CA atoms for proteins).

Atoms should be unrotated. Thus, to obtain a superimposed set of structures, each atom array should be cloned and then rotated according to the transformation matrix.

If atoms have not previously been set using MultipleAlignmentEnsemble.setAtomArrays(List), attempts to load representative atoms based on MultipleAlignmentEnsemble.getStructureNames(). If it fails to load the Atoms it gives a NullPointerException before returning null.

Specified by:

getAtomArrays in interface MultipleAlignmentEnsemble

Returns:

List of Atom[].

See Also:

MultipleAlignmentEnsemble.setAtomArrays(List)

setAtomArrays

public void setAtomArrays(java.util.List<Atom[]> atomArrays)

Description copied from interface: MultipleAlignmentEnsemble

Sets the List of Atom arrays. Every structure has an Atom array associated. Note that this should be called in conjunction with MultipleAlignmentEnsemble.setStructureNames(List)

Setting the atom arrays to null will cause them to be automatically regenerated based on MultipleAlignmentEnsemble.getStructureNames() during the next call to MultipleAlignmentEnsemble.getAtomArrays()

Specified by:

setAtomArrays in interface MultipleAlignmentEnsemble

Parameters:

atomArrays - the List of representative (C-alpha) atom arrays

See Also:

MultipleAlignmentEnsemble.getAtomArrays(), MultipleAlignmentEnsemble.setStructureNames(List)

updateAtomArrays

public void updateAtomArrays()
                      throws java.io.IOException,
                             StructureException

Force the atom arrays to regenerate based on getStructureNames()

Throws:

java.io.IOException

StructureException

getAlignmentNum

public int getAlignmentNum()

Description copied from interface: MultipleAlignmentEnsemble

Return the number of alternative alignments stored in the Ensemble.

Specified by:

getAlignmentNum in interface MultipleAlignmentEnsemble

Returns:

int number of alternative alignments.

See Also:

MultipleAlignmentEnsemble.size()

getDistanceMatrix

public java.util.List<Matrix> getDistanceMatrix()

Description copied from interface: MultipleAlignmentEnsemble

Returns the List containing the interatomic distance Matrix of each structure.

Specified by:

getDistanceMatrix in interface MultipleAlignmentEnsemble

Returns:

List of Matrix interatomic distance matrices.

See Also:

#updateDistanceMatrix()

updateDistanceMatrix

public void updateDistanceMatrix()

Force recalculation of the distance matrices

getMultipleAlignments

public java.util.List<MultipleAlignment> getMultipleAlignments()

Description copied from interface: MultipleAlignmentEnsemble

Returns the List of MultipleAlignments in the MultipleAlignmentEnsemble object.

Specified by:

getMultipleAlignments in interface MultipleAlignmentEnsemble

Returns:

List of MultipleAlignment in the MultipleAlignmentEnsemble.

See Also:

#setMultipleAlignments(), #getOptimalMultipleAlignment()

setMultipleAlignments

public void setMultipleAlignments(java.util.List<MultipleAlignment> multipleAlignments)

Description copied from interface: MultipleAlignmentEnsemble

Set the List of MultipleAlignments in the MultipleAlignmentEnsemble object.

Specified by:

setMultipleAlignments in interface MultipleAlignmentEnsemble

See Also:

MultipleAlignmentEnsemble.getMultipleAlignments(), #getOptimalMultipleAlignment()

addMultipleAlignment

public void addMultipleAlignment(MultipleAlignment alignment)

Description copied from interface: MultipleAlignmentEnsemble

Add a new MultipleAlignment to the end of the ensemble and set its parent ensemble to this.

Specified by:

addMultipleAlignment in interface MultipleAlignmentEnsemble

size

public int size()

Description copied from interface: MultipleAlignmentEnsemble

Returns the number of aligned structures in the MultipleAlignments.

Specified by:

size in interface MultipleAlignmentEnsemble

Returns:

int number of aligned structures.

See Also:

MultipleAlignmentEnsemble.getStructureNames(), MultipleAlignmentEnsemble.getAtomArrays()

clear

public void clear()

Description copied from class: AbstractScoresCache

Resets all scores

Specified by:

clear in interface MultipleAlignmentEnsemble

Overrides:

clear in class AbstractScoresCache