OpenMS  2.4.0
File.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-2018.
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: Chris Bielow $
32 // $Authors: Andreas Bertsch, Chris Bielow, Marc Sturm $
33 // --------------------------------------------------------------------------
34 
35 #pragma once
36 
38 #include <OpenMS/config.h>
39 
40 
41 namespace OpenMS
42 {
43  class Param;
44  class TOPPBase;
45 
51  class OPENMS_DLLAPI File
52  {
53 public:
54 
55  friend class TOPPBase;
56 
61  static String getExecutablePath();
62 
64  static bool exists(const String& file);
65 
67  static bool empty(const String& file);
68 
83  static bool rename(const String& from, const String& to, bool overwrite_existing = true, bool verbose = true);
84 
90  static bool remove(const String& file);
91 
93  static bool removeDirRecursively(const String& dir_name);
94 
96  static bool removeDir(const QString& dir_name);
97 
99  static String absolutePath(const String& file);
100 
102  static String basename(const String& file);
103 
105  static String path(const String& file);
106 
114  static String removeExtension(const String& file);
115 
117  static bool readable(const String& file);
118 
120  static bool writable(const String& file);
121 
123  static bool isDirectory(const String& path);
124 
135  static String find(const String& filename, StringList directories = StringList());
136 
143  static bool fileList(const String& dir, const String& file_pattern, StringList& output, bool full_path = false);
144 
161  static String findDoc(const String& filename);
162 
169  static String getUniqueName(bool include_hostname = true);
170 
172  static String getOpenMSDataPath();
173 
175  static String getOpenMSHomePath();
176 
178  static String getTempDirectory();
179 
185  static String getUserDirectory();
186 
192  static Param getSystemParameters();
193 
197  static String findDatabase(const String& db_name);
198 
205  static String findExecutable(const String& toolName);
206 
223  static const String& getTemporaryFile(const String& alternative_file = "");
224 
225 private:
226 
228  static Param getSystemParameterDefaults_();
229 
231  static bool isOpenMSDataPath_(const String& path);
232 
233 
238  {
239  public:
240  TemporaryFiles_();
242  const String& newFile();
243 
244  ~TemporaryFiles_();
245  private:
246  TemporaryFiles_(const TemporaryFiles_&) = delete; // copy is forbidden
247  TemporaryFiles_& operator=(const TemporaryFiles_&) = delete;
249  };
250 
251 
254 
255  };
256 
257 }
258 
OpenMS::TOPPBase
Base class for TOPP applications.
Definition: TOPPBase.h:150
OpenMS::PeptideProteinResolution
Resolves shared peptides based on protein scores.
Definition: PeptideProteinResolution.h:86
OpenMS::File
Basic file handling operations.
Definition: File.h:51
OpenMS::File::TemporaryFiles_
Internal helper class, which holds temporary filenames and deletes these files at program exit.
Definition: File.h:237
OpenMS::ProteinIdentification::getIndistinguishableProteins
const std::vector< ProteinGroup > & getIndistinguishableProteins() const
Returns the indistinguishable proteins.
OpenMS::PeptideHit::getSequence
const AASequence & getSequence() const
returns the peptide sequence without trailing or following spaces
Int
OpenMS::ProteinIdentification::ProteinGroup::probability
double probability
Probability of this group.
Definition: ProteinIdentification.h:74
OpenMS::String
A more convenient string class.
Definition: String.h:57
LOG_ERROR
#define LOG_ERROR
Macro to be used if non-fatal error are reported (processing continues)
Definition: LogStream.h:446
OpenMS::Size
size_t Size
Size type e.g. used as variable which can hold result of size()
Definition: Types.h:127
IdXMLFile.h
OpenMS::ProteinIdentification::findHit
std::vector< ProteinHit >::iterator findHit(const String &accession)
Finds a protein hit by accession (returns past-the-end iterator if not found)
LOG_INFO
#define LOG_INFO
Macro if a information, e.g. a status should be reported.
Definition: LogStream.h:454
OpenMS::AASequence::toUnmodifiedString
String toUnmodifiedString() const
returns the peptide as string without any modifications
OpenMS::File::getUniqueName
static String getUniqueName(bool include_hostname=true)
Returns a string, consisting of date, time, hostname, process id, and a incrementing number....
OpenMS::ProteinIdentification
Representation of a protein identification run.
Definition: ProteinIdentification.h:61
OpenMS::File::temporary_files_
static TemporaryFiles_ temporary_files_
private list of temporary filenames, which are deleted upon program exit
Definition: File.h:253
OpenMS::DateTime::now
static DateTime now()
Returns the current date and time.
OpenMS::IdXMLFile::load
void load(const String &filename, std::vector< ProteinIdentification > &protein_ids, std::vector< PeptideIdentification > &peptide_ids)
Loads the identifications of an idXML file without identifier.
OpenMS::IDFilter::removeUnreferencedProteins
static void removeUnreferencedProteins(std::vector< ProteinIdentification > &proteins, const std::vector< PeptideIdentification > &peptides)
Removes protein hits from proteins that are not referenced by a peptide in peptides.
OpenMS::String::chop
String chop(Size n) const
Returns a substring where n characters were removed from the end of the string.
OpenMS::ProteinIdentification::getIdentifier
const String & getIdentifier() const
Returns the identifier.
OpenMS
Main OpenMS namespace.
Definition: FeatureDeconvolution.h:46
LOG_DEBUG
#define LOG_DEBUG
Macro for general debugging information.
Definition: LogStream.h:458
LOG_WARN
#define LOG_WARN
Macro if a warning, a piece of information which should be read by the user, should be logged.
Definition: LogStream.h:450
OpenMS::MetaInfoInterface::setMetaValue
void setMetaValue(const String &name, const DataValue &value)
Sets the DataValue corresponding to a name.
OpenMS::ProteinIdentification::setScoreType
void setScoreType(const String &type)
Sets the protein score type.
OpenMS::ProteinIdentification::getHits
const std::vector< ProteinHit > & getHits() const
Returns the protein hits.
QProcess
OpenMS::String::split
bool split(const char splitter, std::vector< String > &substrings, bool quote_protect=false) const
Splits a string into substrings using splitter as delimiter.
OpenMS::String::toQString
QString toQString() const
Conversion to Qt QString.
OpenMS::String::hasSuffix
bool hasSuffix(const String &string) const
true if String ends with string, false otherwise
OpenMS::PeptideHit::extractProteinAccessionsSet
std::set< String > extractProteinAccessionsSet() const
extracts the set of non-empty protein accessions from peptide evidences
seqan::find
bool find(TFinder &finder, const Pattern< TNeedle, FuzzyAC > &me, PatternAuxData< TNeedle > &dh)
Definition: AhoCorasickAmbiguous.h:884
OpenMS::PeptideProteinResolution::resolveGraph
void resolveGraph(ProteinIdentification &protein, std::vector< PeptideIdentification > &peptides)
OpenMS::AASequence::empty
bool empty() const
check if sequence is empty
OpenMS::StringList
std::vector< String > StringList
Vector of String.
Definition: ListUtils.h:73
OpenMS::ProteinIdentification::ProteinGroup::accessions
std::vector< String > accessions
Accessions of (indistinguishable) proteins that belong to the same group.
Definition: ProteinIdentification.h:77
OpenMS::ProteinIdentification::insertHit
void insertHit(const ProteinHit &input)
Appends a protein hit.
main
int main(int argc, const char **argv)
Definition: INIFileEditor.cpp:73
OpenMS::ProteinIdentification::setSearchEngine
void setSearchEngine(const String &search_engine)
Sets the search engine type.
OpenMS::Internal::ClassTest::verbose
int verbose
Verbosity level ( "-v" is 1 and "-V" is 2 )
OpenMS::File::TemporaryFiles_::filenames_
StringList filenames_
Definition: File.h:248
OpenMS::IdXMLFile::store
void store(String filename, const std::vector< ProteinIdentification > &protein_ids, const std::vector< PeptideIdentification > &peptide_ids, const String &document_id="")
Stores the data in an idXML file.
OpenMS::String::substr
String substr(size_t pos=0, size_t n=npos) const
Wrapper for the STL substr() method. Returns a String object with its contents initialized to a subst...
OpenMS::PeptideHit::getScore
double getScore() const
returns the PSM score
OpenMS::PeptideProteinResolution::buildGraph
void buildGraph(const ProteinIdentification &protein, const std::vector< PeptideIdentification > &peptides)
OpenMS::ProteinIdentification::setHigherScoreBetter
void setHigherScoreBetter(bool higher_is_better)
Sets the orientation of the score (is higher better?)
OpenMS::ProteinIdentification::setDateTime
void setDateTime(const DateTime &date)
Sets the date of the protein identification run.
OpenMS::Param
Management and storage of parameters / INI files.
Definition: Param.h:74
OpenMS::File::getTempDirectory
static String getTempDirectory()
The current OpenMS temporary data path (for temporary files)
OpenMS::String::remove
String & remove(char what)
Remove all occurrences of the character what.
OpenMS::ProteinIdentification::getScoreType
const String & getScoreType() const
Returns the protein score type.
IDFilter.h
OpenMS::Exception::MissingInformation
Not all required information provided.
Definition: Exception.h:195
OpenMS::ProteinIdentification::ProteinGroup
Bundles multiple (e.g. indistinguishable) proteins in a group.
Definition: ProteinIdentification.h:71
OpenMS::ProteinIdentification::setIdentifier
void setIdentifier(const String &id)
Sets the identifier.
OpenMS::File::removeDirRecursively
static bool removeDirRecursively(const String &dir_name)
Removes the subdirectories of the specified directory (absolute path). Returns true if successful.
File.h
PeptideProteinResolution.h
TOPPBase.h
OpenMS::IdXMLFile
Used to load and store idXML files.
Definition: IdXMLFile.h:63
OpenMS::String::toLower
String & toLower()
Converts the string to lowercase.
OpenMS::PeptideHit
Representation of a peptide hit.
Definition: PeptideHit.h:54
StringListUtils.h