molecule_identifier.hpp
上传用户:yhdzpy8989
上传日期:2007-06-13
资源大小:13604k
文件大小:5k
- /*
- * ===========================================================================
- * PRODUCTION $Log: molecule_identifier.hpp,v $
- * PRODUCTION Revision 1000.0 2003/10/29 18:35:00 gouriano
- * PRODUCTION PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.6
- * PRODUCTION
- * ===========================================================================
- */
- /* $Id: molecule_identifier.hpp,v 1000.0 2003/10/29 18:35:00 gouriano Exp $
- * ===========================================================================
- *
- * 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.
- *
- * ===========================================================================
- *
- * Authors: Paul Thiessen
- *
- * File Description:
- * Class to hold, and factory to generate, general
- * (instance-independent) identifier for any molecule
- *
- * ===========================================================================
- */
- #ifndef CN3D_MOLECULE_IDENTIFIER__HPP
- #define CN3D_MOLECULE_IDENTIFIER__HPP
- #include <corelib/ncbistl.hpp>
- #include <objects/seqloc/Seq_id.hpp>
- #include <list>
- #include <string>
- BEGIN_SCOPE(Cn3D)
- class Molecule;
- class Sequence;
- class MoleculeIdentifier
- {
- public:
- static const int VALUE_NOT_SET;
- // possible identifiers (not all will necessarily be set)
- int mmdbID, moleculeID, pdbChain, gi;
- std::string pdbID, accession;
- // # residues (1 for non-biopolymers - hets, solvents)
- int nResidues;
- // get title string based on identifiers present
- std::string ToString(void) const;
- // create, or retrieve if known, an identifier for an entity
- static const MoleculeIdentifier * GetIdentifier(const Molecule *molecule,
- std::string pdbID, int pdbChain, int gi, std::string accession);
- static const MoleculeIdentifier * GetIdentifier(const Sequence *sequence,
- std::string pdbID, int pdbChain, int mmdbID, int gi, std::string accession);
- // get identifier for MMDB ID + molecule (NULL if not found)
- static const MoleculeIdentifier * FindIdentifier(int mmdbID, int moleculeID);
- // test for Seq-id match
- bool MatchesSeqId(const ncbi::objects::CSeq_id& sid) const;
- // clear identifier store (e.g. when a new file is loaded)
- static void ClearIdentifiers(void);
- // does this molecule have structure?
- bool HasStructure(void) const
- {
- return (
- (mmdbID != VALUE_NOT_SET && moleculeID != VALUE_NOT_SET) ||
- (pdbID.size() > 0 && pdbChain != VALUE_NOT_SET)
- );
- }
- // comparison of identifiers (e.g. for sorting) - floats PDB's to top, then gi's in numerical order
- static bool CompareIdentifiers(const MoleculeIdentifier *a, const MoleculeIdentifier *b);
- private:
- // can't create one of these directly - must use GetIdentifier()
- MoleculeIdentifier(void) : mmdbID(VALUE_NOT_SET), moleculeID(VALUE_NOT_SET),
- pdbChain(VALUE_NOT_SET), gi(VALUE_NOT_SET), nResidues(0)
- { }
- };
- END_SCOPE(Cn3D)
- #endif // CN3D_MOLECULE_IDENTIFIER__HPP
- /*
- * ---------------------------------------------------------------------------
- * $Log: molecule_identifier.hpp,v $
- * Revision 1000.0 2003/10/29 18:35:00 gouriano
- * PRODUCTION: IMPORTED [ORIGINAL] Dev-tree R1.6
- *
- * Revision 1.6 2003/02/03 19:20:04 thiessen
- * format changes: move CVS Log to bottom of file, remove std:: from .cpp files, and use new diagnostic macros
- *
- * Revision 1.5 2002/02/22 14:24:01 thiessen
- * sort sequences in reject dialog ; general identifier comparison
- *
- * Revision 1.4 2001/11/27 16:26:08 thiessen
- * major update to data management system
- *
- * Revision 1.3 2001/07/04 19:38:55 thiessen
- * finish user annotation system
- *
- * Revision 1.2 2001/06/29 18:12:53 thiessen
- * initial (incomplete) user annotation system
- *
- * Revision 1.1 2001/06/21 02:01:16 thiessen
- * major update to molecule identification and highlighting ; add toggle highlight (via alt)
- *
- */