Dense_seg.hpp

Go to the documentation of this file.

Go to the SVN repository for this file.

/* $Id: Dense_seg.hpp 76684 2017-02-27 16:18:20Z astashya $
 * ===========================================================================
 *
 *                            PUBLIC DOMAIN NOTICE
 *               National Center for Biotechnology Information
 *
 *  This software/database is a "United States Government Work" under the
 *  terms of the United States Copyright Act.  It was written as part of
 *  the author's official duties as a United States Government employee and
 *  thus cannot be copyrighted.  This software/database is freely available
 *  to the public for use. The National Library of Medicine and the U.S.
 *  Government have not placed any restriction on its use or reproduction.
 *
 *  Although all reasonable efforts have been taken to ensure the accuracy
 *  and reliability of the software and data, the NLM and the U.S.
 *  Government do not and cannot warrant the performance or results that
 *  may be obtained by using this software or data. The NLM and the U.S.
 *  Government disclaim all warranties, express or implied, including
 *  warranties of performance, merchantability or fitness for any particular
 *  purpose.
 *
 *  Please cite the author in any work or product based on this material.
 *
 * ===========================================================================
 *
 * Author:  .......
 *
 * File Description:
 *   .......
 *
 * Remark:
 *   This code was originally generated by application DATATOOL
 *   using specifications from the data definition file
 *   'seqalign.asn'.
 */
 
#ifndef OBJECTS_SEQALIGN_DENSE_SEG_HPP
#define OBJECTS_SEQALIGN_DENSE_SEG_HPP
 
 
// generated includes
#include <objects/seqalign/Dense_seg_.hpp>
 
#include <objects/seqalign/seqalign_exception.hpp>
#include <util/range.hpp>
 
#include <serial/objhook.hpp>
 
// generated classes
 
BEGIN_NCBI_SCOPE
 
BEGIN_objects_SCOPE // namespace ncbi::objects::
 
// forward declarations
class CSeq_loc;
class CSeq_interval;
 
 
class NCBI_SEQALIGN_EXPORT CDense_seg : public CDense_seg_Base
{
    typedef CDense_seg_Base Tparent;
public:
    // constructor
    CDense_seg(void);
    // destructor
    ~CDense_seg(void);
 
    /// overloaded Assign()
    void Assign(const CSerialObject& obj,
                ESerialRecursionMode how = eRecursive);
 
    typedef vector<int> TWidths;
 
    // optional
    // typedef vector<int> TWidths
    bool IsSetWidths(void) const;
    bool CanGetWidths(void) const;
    void ResetWidths(void);
    const TWidths& GetWidths(void) const;
    TWidths& SetWidths(void);
 
    // Validators
    TDim    CheckNumRows(void)                   const;
    TNumseg CheckNumSegs(void)                   const;
    void    Validate    (bool full_test = false) const;
 
    // GetSeqRange
    CRange<TSeqPos> GetSeqRange(TDim row) const;
    TSeqPos         GetSeqStart(TDim row) const;
    TSeqPos         GetSeqStop(TDim row) const;
 
    // Get Seq_id (the first one if segments have different strands).
    const CSeq_id& GetSeq_id(TDim row) const;
 
    // Get strand (the first one if segments have different strands).
    ENa_strand      GetSeqStrand(TDim row) const;
 
    /// Reverse the segments' orientation
    void Reverse(void);
 
    /// Swap two rows (changing *order*, not content)
    void SwapRows(TDim row1, TDim row2);
 
    /// Create a new dense-seg with added all unaligned pieces
    /// (implicit inserts), if any, between segments.
    CRef<CDense_seg> FillUnaligned() const;
 
    /// Extract a slice of the alignment that includes the specified range
    CRef<CDense_seg> ExtractSlice(TDim row, TSeqPos from, TSeqPos to) const;
 
    /// Extract specified rows of the alignment, in specified order.
    /// The result is compacted with Compact, but may contain
    /// segments in which all rows have gaps, which can be removed
    /// with RemovePureGapSegs.
    /// The rows in the new alignment are in the order given by the
    /// rows parameter.  Thus, this can also be used for
    /// permuting the order of rows.
    /// @sa RemovePureGapSegs
    CRef<CDense_seg> ExtractRows(const vector<TDim>& rows) const;
    
    /// Join adjacent mergeable segments to create a more compact
    /// alignment
    void Compact();
 
    /// Order adjacent gaps, so that the side with sequence is 
    /// in row-decending order
    void OrderAdjacentGaps();
 
    /// Remove any segments in which every row has a gap
    /// (these can arise when ExtractRows is used)
    /// @sa ExtractRows
    void RemovePureGapSegs();
 
    /// Trim leading/training gaps if possible
    void TrimEndGaps();
 
    /// Offset row's coords
    void OffsetRow(TDim row, TSignedSeqPos offset);
 
    /// @deprecated (use sequence::RemapAlignToLoc())
    /// @sa RemapAlignToLoc
    NCBI_DEPRECATED void RemapToLoc(TDim row, const CSeq_loc& loc,
                                    bool ignore_strand = false);
 
    /// Initialize from pairwise alignment transcript
    /// (a string representation produced by CNWAligner)
    /// @sa CNWAligner
    void FromTranscript(TSeqPos query_start, ENa_strand query_strand,
                        TSeqPos subj_start, ENa_strand subj_strand,
                        const string& transcript );
 
    static void SetReserveHooks(CObjectIStream& in);
    static void SetGlobalReserveHooks(void);
 
    // reserve memory for "starts", "lens", and "strands" vectors
    class NCBI_SEQALIGN_EXPORT CReserveHook
        : public CPreReadClassMemberHook
    {
        virtual void PreReadClassMember(CObjectIStream& in,
                                        const CObjectInfoMI& member);
    };
 
    CRef<CSeq_interval> CreateRowSeq_interval(TDim row) const;
 
protected:
    TNumseg x_FindSegment(TDim row, TSignedSeqPos pos) const;
 
 
private:
    // Prohibit copy constructor and assignment operator
    CDense_seg(const CDense_seg& value);
    CDense_seg& operator=(const CDense_seg& value);
 
    // data
    Uint4 m_set_State1[1];
    TWidths m_Widths;
};
 
 
NCBISER_HAVE_GLOBAL_READ_MEMBER_HOOK(CDense_seg, "starts,lens,strands",
                                     new CDense_seg::CReserveHook)
 
 
/////////////////// CDense_seg inline methods
 
// constructor
inline
CDense_seg::CDense_seg(void)
{
    memset(m_set_State1, 0, sizeof(m_set_State1));
}
 
 
inline
bool CDense_seg::IsSetWidths(void) const
{
    return ((m_set_State1[0] & 0x3) != 0);
}
 
 
inline
bool CDense_seg::CanGetWidths(void) const
{
    return true;
}
 
 
inline
const vector<int>& CDense_seg::GetWidths(void) const
{
    return m_Widths;
}
 
 
inline
vector<int>& CDense_seg::SetWidths(void)
{
    m_set_State1[0] |= 0x1;
    return m_Widths;
}
 
 
inline
void CDense_seg::ResetWidths(void)
{
    m_Widths.clear();
    m_set_State1[0] &= ~0x3;
 
}
 
 
inline
CRange<TSeqPos> CDense_seg::GetSeqRange(TDim row) const
{
    return CRange<TSeqPos>(GetSeqStart(row), GetSeqStop(row));
}
 
 
/////////////////// end of CDense_seg inline methods
 
 
/////////////////////////////////////////////////////////////////////////////
// Read hooks to reserve memory of Dense-seg vector<> to estimated size.
/////////////////////////////////////////////////////////////////////////////
 
 
class NCBI_SEQALIGN_EXPORT CDenseSegReserveStartsHook
    : public CReadClassMemberHook
{
public:
    void ReadClassMember(CObjectIStream& in, const CObjectInfoMI& member);
 
    static void SetHook(CObjectIStream& in);
    static void SetGlobalHook(void);
 
private:
    static CObjectTypeInfoMI x_GetMember(void);
};
 
 
class NCBI_SEQALIGN_EXPORT CDenseSegReserveLensHook
    : public CReadClassMemberHook
{
public:
    void ReadClassMember(CObjectIStream& in, const CObjectInfoMI& member);
 
    static void SetHook(CObjectIStream& in);
    static void SetGlobalHook(void);
 
private:
    static CObjectTypeInfoMI x_GetMember(void);
};
 
 
class NCBI_SEQALIGN_EXPORT CDenseSegReserveStrandsHook
    : public CReadClassMemberHook
{
public:
    void ReadClassMember(CObjectIStream& in, const CObjectInfoMI& member);
 
    static void SetHook(CObjectIStream& in);
    static void SetGlobalHook(void);
 
private:
    static CObjectTypeInfoMI x_GetMember(void);
};
 
 
END_objects_SCOPE // namespace ncbi::objects::
 
END_NCBI_SCOPE
 
#endif // OBJECTS_SEQALIGN_DENSE_SEG_HPP