OpenMS
ControlledVocabulary.h
Go to the documentation of this file.
1 // --------------------------------------------------------------------------
2 // OpenMS -- Open-Source Mass Spectrometry
3 // --------------------------------------------------------------------------
4 // Copyright The OpenMS Team -- Eberhard Karls University Tuebingen,
5 // ETH Zurich, and Freie Universitaet Berlin 2002-2023.
6 //
7 // This software is released under a three-clause BSD license:
8 // * Redistributions of source code must retain the above copyright
9 // notice, this list of conditions and the following disclaimer.
10 // * Redistributions in binary form must reproduce the above copyright
11 // notice, this list of conditions and the following disclaimer in the
12 // documentation and/or other materials provided with the distribution.
13 // * Neither the name of any author or any participating institution
14 // may be used to endorse or promote products derived from this software
15 // without specific prior written permission.
16 // For a full list of authors, refer to the file AUTHORS.
17 // --------------------------------------------------------------------------
18 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19 // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 // ARE DISCLAIMED. IN NO EVENT SHALL ANY OF THE AUTHORS OR THE CONTRIBUTING
22 // INSTITUTIONS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23 // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
25 // OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26 // WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
27 // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
28 // ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 //
30 // --------------------------------------------------------------------------
31 // $Maintainer: Timo Sachsenberg $
32 // $Authors: Marc Sturm, Andreas Bertsch, Mathias Walzer $
33 // --------------------------------------------------------------------------
34 
35 #pragma once
36 
37 #include <OpenMS/DATASTRUCTURES/ListUtils.h> // StringList
40 
41 #include <set>
42 #include <map>
43 
44 namespace OpenMS
45 {
54  class OPENMS_DLLAPI ControlledVocabulary
55  {
56  friend OPENMS_DLLAPI std::ostream& operator<<(std::ostream& os, const ControlledVocabulary& cv);
57 
58 public:
60  struct OPENMS_DLLAPI CVTerm
61  {
63  enum XRefType
64  {
65  XSD_STRING = 0, // xsd:string A string
66  XSD_INTEGER, // xsd:integer Any integer
67  XSD_DECIMAL, // xsd:decimal Any real number
68  XSD_NEGATIVE_INTEGER, // xsd:negativeInteger Any negative integer
69  XSD_POSITIVE_INTEGER, // xsd:positiveInteger Any integer > 0
70  XSD_NON_NEGATIVE_INTEGER, // xsd:nonNegativeInteger Any integer >= 0
71  XSD_NON_POSITIVE_INTEGER, // xsd:nonPositiveInteger Any integer < 0
72  XSD_BOOLEAN, // xsd:boolean True or false
73  XSD_DATE, // xsd:date An XML-Schema date
74  XSD_ANYURI, // xsd:anyURI uniform resource identifier
75  NONE
76  };
77 
79  //static bool isSearchEngineSpecificScore();
81 
84  std::set<String> parents;
85  std::set<String> children;
86  bool obsolete;
92  std::set<String> units;
93 
95  CVTerm();
96 
97  CVTerm(const CVTerm& rhs);
98 
99  CVTerm& operator=(const CVTerm& rhs);
100 
102  String toXMLString(const String& ref, const String& value = String("")) const;
103 
105  String toXMLString(const String& ref, const DataValue& value) const;
106 
107  };
108 
111 
114 
116  const String& name() const;
117 
119  const String& label() const;
120 
122  const String& version() const;
123 
125  const String& url() const;
126 
133  void loadFromOBO(const String& name, const String& filename);
134 
136  bool exists(const String& id) const;
137 
139  bool hasTermWithName(const String& name) const;
140 
146  const CVTerm& getTerm(const String& id) const;
147 
153  const CVTerm& getTermByName(const String& name, const String& desc = "") const;
154 
155 
157  const std::map<String, CVTerm>& getTerms() const;
158 
166  void getAllChildTerms(std::set<String>& terms, const String& parent_id) const;
167 
177  template <class LAMBDA>
178  bool iterateAllChildren(const String& parent_id, LAMBDA lbd) const
179  {
180  for (const auto& child_id : getTerm(parent_id).children)
181  {
182  if (lbd(child_id) || iterateAllChildren(child_id, lbd))
183  return true;
184  }
185  return false;
186  }
187 
194 
200  bool isChildOf(const String& child_id, const String& parent_id) const;
201 
202 
218 
219 protected:
225  bool checkName_(const String& id, const String& name, bool ignore_case = true) const;
226 
228  std::map<String, CVTerm> terms_;
230  std::map<String, String> namesToIds_;
239  };
240 
242  OPENMS_DLLAPI std::ostream& operator<<(std::ostream& os, const ControlledVocabulary& cv);
243 
244 
245 } // namespace OpenMS
246 
Representation of a controlled vocabulary.
Definition: ControlledVocabulary.h:55
ControlledVocabulary()
Constructor.
bool checkName_(const String &id, const String &name, bool ignore_case=true) const
checks if a name corresponds to an id
static const ControlledVocabulary & getPSIMSCV()
Returns a CV for parsing/storing PSI-MS related data, e.g. mzML, or handle accessions/ids in datastru...
bool hasTermWithName(const String &name) const
Returns true if a term with the given name is in the CV. Returns false otherwise.
const CVTerm & getTerm(const String &id) const
Returns a term specified by ID.
bool iterateAllChildren(const String &parent_id, LAMBDA lbd) const
Iterates over all children of parent recursively.
Definition: ControlledVocabulary.h:178
const String & label() const
Returns the CV label (set in the load method)
void loadFromOBO(const String &name, const String &filename)
Loads the CV from an OBO file.
String name_
Name set in the load method.
Definition: ControlledVocabulary.h:232
std::map< String, String > namesToIds_
Map from name to id.
Definition: ControlledVocabulary.h:230
String version_
CV version.
Definition: ControlledVocabulary.h:236
const CVTerm & getTermByName(const String &name, const String &desc="") const
Returns a term specified by name.
bool isChildOf(const String &child_id, const String &parent_id) const
Returns if child is a child of parent.
const String & url() const
Returns the CV url (set in the load method)
virtual ~ControlledVocabulary()
Destructor.
std::map< String, CVTerm > terms_
Map from ID to CVTerm.
Definition: ControlledVocabulary.h:228
void getAllChildTerms(std::set< String > &terms, const String &parent_id) const
Writes all child terms recursively into terms.
String label_
CV label.
Definition: ControlledVocabulary.h:234
const ControlledVocabulary::CVTerm * checkAndGetTermByName(const OpenMS::String &name) const
Searches the existing terms for the given name.
const String & name() const
Returns the CV name (set in the load method)
const String & version() const
Returns the CV version (set in the load method)
const std::map< String, CVTerm > & getTerms() const
returns all the terms stored in the CV
bool exists(const String &id) const
Returns true if the term is in the CV. Returns false otherwise.
String url_
CV URL.
Definition: ControlledVocabulary.h:238
friend std::ostream & operator<<(std::ostream &os, const ControlledVocabulary &cv)
Print the contents to a stream.
Class to hold strings, numeric values, lists of strings and lists of numeric values.
Definition: DataValue.h:59
A more convenient string class.
Definition: String.h:60
std::vector< String > StringList
Vector of String.
Definition: ListUtils.h:70
Main OpenMS namespace.
Definition: FeatureDeconvolution.h:48
std::ostream & operator<<(std::ostream &os, const AccurateMassSearchResult &amsr)
Representation of a CV term.
Definition: ControlledVocabulary.h:61
std::set< String > parents
The parent IDs.
Definition: ControlledVocabulary.h:84
String toXMLString(const String &ref, const DataValue &value) const
get mzidentml formatted string. i.e. a cvparam xml element, ref should be the name of the ControlledV...
StringList unparsed
Unparsed lines from the definition file.
Definition: ControlledVocabulary.h:89
std::set< String > children
The child IDs.
Definition: ControlledVocabulary.h:85
StringList xref_binary
xref binary-data-type for the CV-term (list of all allowed data value types for the current binary da...
Definition: ControlledVocabulary.h:91
String id
Identifier.
Definition: ControlledVocabulary.h:83
String description
Term description.
Definition: ControlledVocabulary.h:87
bool obsolete
Flag that indicates of the term is obsolete.
Definition: ControlledVocabulary.h:86
static String getXRefTypeName(XRefType type)
String name
if it is a score type, lookup has_order
Definition: ControlledVocabulary.h:82
StringList synonyms
List of synonyms.
Definition: ControlledVocabulary.h:88
XRefType xref_type
xref value-type for the CV-term
Definition: ControlledVocabulary.h:90
std::set< String > units
unit accession ids, defined by relationship has units
Definition: ControlledVocabulary.h:92
String toXMLString(const String &ref, const String &value=String("")) const
get mzidentml formatted string. i.e. a cvparam xml element, ref should be the name of the ControlledV...
XRefType
define xsd types allowed in cv term to specify their value-type
Definition: ControlledVocabulary.h:64
@ XSD_BOOLEAN
Definition: ControlledVocabulary.h:72
@ XSD_DATE
Definition: ControlledVocabulary.h:73
@ XSD_NEGATIVE_INTEGER
Definition: ControlledVocabulary.h:68
@ XSD_POSITIVE_INTEGER
Definition: ControlledVocabulary.h:69
@ XSD_NON_POSITIVE_INTEGER
Definition: ControlledVocabulary.h:71
@ XSD_DECIMAL
Definition: ControlledVocabulary.h:67
@ XSD_NON_NEGATIVE_INTEGER
Definition: ControlledVocabulary.h:70
@ XSD_ANYURI
Definition: ControlledVocabulary.h:74
@ XSD_INTEGER
Definition: ControlledVocabulary.h:66
CVTerm & operator=(const CVTerm &rhs)
static bool isHigherBetterScore(ControlledVocabulary::CVTerm term)