molecule_identifier.hpp
上传用户:yhdzpy8989
上传日期:2007-06-13
资源大小:13604k
文件大小:5k
源码类别:

生物技术

开发平台:

C/C++

  1. /*
  2.  * ===========================================================================
  3.  * PRODUCTION $Log: molecule_identifier.hpp,v $
  4.  * PRODUCTION Revision 1000.0  2003/10/29 18:35:00  gouriano
  5.  * PRODUCTION PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.6
  6.  * PRODUCTION
  7.  * ===========================================================================
  8.  */
  9. /*  $Id: molecule_identifier.hpp,v 1000.0 2003/10/29 18:35:00 gouriano Exp $
  10. * ===========================================================================
  11. *
  12. *                            PUBLIC DOMAIN NOTICE
  13. *               National Center for Biotechnology Information
  14. *
  15. *  This software/database is a "United States Government Work" under the
  16. *  terms of the United States Copyright Act.  It was written as part of
  17. *  the author's official duties as a United States Government employee and
  18. *  thus cannot be copyrighted.  This software/database is freely available
  19. *  to the public for use. The National Library of Medicine and the U.S.
  20. *  Government have not placed any restriction on its use or reproduction.
  21. *
  22. *  Although all reasonable efforts have been taken to ensure the accuracy
  23. *  and reliability of the software and data, the NLM and the U.S.
  24. *  Government do not and cannot warrant the performance or results that
  25. *  may be obtained by using this software or data. The NLM and the U.S.
  26. *  Government disclaim all warranties, express or implied, including
  27. *  warranties of performance, merchantability or fitness for any particular
  28. *  purpose.
  29. *
  30. *  Please cite the author in any work or product based on this material.
  31. *
  32. * ===========================================================================
  33. *
  34. * Authors:  Paul Thiessen
  35. *
  36. * File Description:
  37. *      Class to hold, and factory to generate, general
  38. *      (instance-independent) identifier for any molecule
  39. *
  40. * ===========================================================================
  41. */
  42. #ifndef CN3D_MOLECULE_IDENTIFIER__HPP
  43. #define CN3D_MOLECULE_IDENTIFIER__HPP
  44. #include <corelib/ncbistl.hpp>
  45. #include <objects/seqloc/Seq_id.hpp>
  46. #include <list>
  47. #include <string>
  48. BEGIN_SCOPE(Cn3D)
  49. class Molecule;
  50. class Sequence;
  51. class MoleculeIdentifier
  52. {
  53. public:
  54.     static const int VALUE_NOT_SET;
  55.     // possible identifiers (not all will necessarily be set)
  56.     int mmdbID, moleculeID, pdbChain, gi;
  57.     std::string pdbID, accession;
  58.     // # residues (1 for non-biopolymers - hets, solvents)
  59.     int nResidues;
  60.     // get title string based on identifiers present
  61.     std::string ToString(void) const;
  62.     // create, or retrieve if known, an identifier for an entity
  63.     static const MoleculeIdentifier * GetIdentifier(const Molecule *molecule,
  64.         std::string pdbID, int pdbChain, int gi, std::string accession);
  65.     static const MoleculeIdentifier * GetIdentifier(const Sequence *sequence,
  66.         std::string pdbID, int pdbChain, int mmdbID, int gi, std::string accession);
  67.     // get identifier for MMDB ID + molecule (NULL if not found)
  68.     static const MoleculeIdentifier * FindIdentifier(int mmdbID, int moleculeID);
  69.     // test for Seq-id match
  70.     bool MatchesSeqId(const ncbi::objects::CSeq_id& sid) const;
  71.     // clear identifier store (e.g. when a new file is loaded)
  72.     static void ClearIdentifiers(void);
  73.     // does this molecule have structure?
  74.     bool HasStructure(void) const
  75.     {
  76.         return (
  77.             (mmdbID != VALUE_NOT_SET && moleculeID != VALUE_NOT_SET) ||
  78.             (pdbID.size() > 0 && pdbChain != VALUE_NOT_SET)
  79.         );
  80.     }
  81.     // comparison of identifiers (e.g. for sorting) - floats PDB's to top, then gi's in numerical order
  82.     static bool CompareIdentifiers(const MoleculeIdentifier *a, const MoleculeIdentifier *b);
  83. private:
  84.     // can't create one of these directly - must use GetIdentifier()
  85.     MoleculeIdentifier(void) : mmdbID(VALUE_NOT_SET), moleculeID(VALUE_NOT_SET),
  86.         pdbChain(VALUE_NOT_SET), gi(VALUE_NOT_SET), nResidues(0)
  87.         { }
  88. };
  89. END_SCOPE(Cn3D)
  90. #endif // CN3D_MOLECULE_IDENTIFIER__HPP
  91. /*
  92. * ---------------------------------------------------------------------------
  93. * $Log: molecule_identifier.hpp,v $
  94. * Revision 1000.0  2003/10/29 18:35:00  gouriano
  95. * PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.6
  96. *
  97. * Revision 1.6  2003/02/03 19:20:04  thiessen
  98. * format changes: move CVS Log to bottom of file, remove std:: from .cpp files, and use new diagnostic macros
  99. *
  100. * Revision 1.5  2002/02/22 14:24:01  thiessen
  101. * sort sequences in reject dialog ; general identifier comparison
  102. *
  103. * Revision 1.4  2001/11/27 16:26:08  thiessen
  104. * major update to data management system
  105. *
  106. * Revision 1.3  2001/07/04 19:38:55  thiessen
  107. * finish user annotation system
  108. *
  109. * Revision 1.2  2001/06/29 18:12:53  thiessen
  110. * initial (incomplete) user annotation system
  111. *
  112. * Revision 1.1  2001/06/21 02:01:16  thiessen
  113. * major update to molecule identification and highlighting ; add toggle highlight (via alt)
  114. *
  115. */