/*!
* @fn consensusAlignment
*
* @headerfile <seqan/consensus.h>
*
* @brief Compute consensus alignment.
*
* @signature void consensusAlignment(alignmentGraph, beginEndPos[, options])
*
* @param[out] alignmentGraph Alignment graph to build.
* @param[in] options Optional settings for the consenus alignment, type:
* <tt>ConsensusOptions</tt>.
* @param[in] beginEndPos Interval start and end position for the read's
* alignment; <tt>String<Pair<TPos, TPos>
* ></tt>.
*
* @section Example
*
* @code{.cpp}
* #include <seqan/sequence.h>
* #include <seqan/graph_align.h>
* #include <seqan/consensus.h>
*
* int main()
* {
* using namespace seqan;
*
* typedef StringSet<Dna5String> TStringSet;
* typedef Graph<Alignment<TStringSet, void, WithoutEdgeId> > TAlignGraph;
*
* TStringSet readSet;
* String<Pair<TSize> > begEndPos;
*
* appendValue(readSet, "CCCAGTGA");
* appendValue(begEndPos, Pair<TSize>(0, 5));
* appendValue(readSet, "AGGGACTGT");
* appendValue(begEndPos, Pair<TSize>(3, 9));
*
* TAlignGraph alignmentGraph(readSet);
* consensusAlignment(alignmentGraph, begEndPos);
*
* return 0;
* }
* @endcode
*/