OpenMS  2.6.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-2020.
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 #include <cstdlib>
40 
41 
42 namespace OpenMS
43 {
44  class Param;
45  class TOPPBase;
46 
52  class OPENMS_DLLAPI File
53  {
54 public:
55 
56  friend class TOPPBase;
57 
63  class OPENMS_DLLAPI TempDir
64  {
65  public:
66 
69  TempDir(bool keep_dir = false);
70 
72  ~TempDir();
73 
75  TempDir(const TempDir&) = delete;
76  TempDir& operator=(const TempDir&) = delete;
77  TempDir(TempDir&&) = delete;
78  TempDir& operator=(TempDir&&) = delete;
79 
81  const String& getPath() const;
82 
83  private:
85  bool keep_dir_;
86  };
87 
92  static String getExecutablePath();
93 
95  static bool exists(const String& file);
96 
98  static bool empty(const String& file);
99 
114  static bool rename(const String& from, const String& to, bool overwrite_existing = true, bool verbose = true);
115 
132  enum class CopyOptions {OVERWRITE,SKIP,CANCEL};
133  static bool copyDirRecursively(const QString &from_dir, const QString &to_dir, File::CopyOptions option = CopyOptions::OVERWRITE);
134 
140  static bool remove(const String& file);
141 
143  static bool removeDirRecursively(const String& dir_name);
144 
146  static bool removeDir(const QString& dir_name);
147 
149  static String absolutePath(const String& file);
150 
152  static String basename(const String& file);
153 
155  static String path(const String& file);
156 
158  static bool readable(const String& file);
159 
161  static bool writable(const String& file);
162 
164  static bool isDirectory(const String& path);
165 
176  static String find(const String& filename, StringList directories = StringList());
177 
184  static bool fileList(const String& dir, const String& file_pattern, StringList& output, bool full_path = false);
185 
202  static String findDoc(const String& filename);
203 
210  static String getUniqueName(bool include_hostname = true);
211 
213  static String getOpenMSDataPath();
214 
216  static String getOpenMSHomePath();
217 
219  static String getTempDirectory();
220 
226  static String getUserDirectory();
227 
233  static Param getSystemParameters();
234 
238  static String findDatabase(const String& db_name);
239 
250  static StringList getPathLocations(const String& path = std::getenv("PATH"));
251 
265  static bool findExecutable(OpenMS::String& exe_filename);
266 
273  static String findSiblingTOPPExecutable(const String& toolName);
274 
291  static const String& getTemporaryFile(const String& alternative_file = "");
292 
313  static bool validateMatchingFileNames(const StringList& sl1, const StringList& sl2, bool basename = true, bool ignore_extension = true, bool strict = false);
314 private:
315 
317  static Param getSystemParameterDefaults_();
318 
320  static bool isOpenMSDataPath_(const String& path);
321 
322 #ifdef OPENMS_WINDOWSPLATFORM
323 
333  static StringList executableExtensions_(const String& ext = std::getenv("PATHEXT"));
334 #endif
335 
340  {
341  public:
342  TemporaryFiles_();
344  const String& newFile();
345 
346  ~TemporaryFiles_();
347  private:
348  TemporaryFiles_(const TemporaryFiles_&) = delete; // copy is forbidden
349  TemporaryFiles_& operator=(const TemporaryFiles_&) = delete;
351  };
352 
353 
356  };
357 }
358 
OpenMS::File::TempDir::keep_dir_
bool keep_dir_
Definition: File.h:85
OpenMS::TOPPBase
Base class for TOPP applications.
Definition: TOPPBase.h:144
OpenMS::PeptideProteinResolution
Resolves shared peptides based on protein scores.
Definition: PeptideProteinResolution.h:86
OpenMS::File
Basic file handling operations.
Definition: File.h:52
OpenMS::File::TemporaryFiles_
Internal helper class, which holds temporary filenames and deletes these files at program exit.
Definition: File.h:339
OpenMS::ProteinIdentification::getIndistinguishableProteins
const std::vector< ProteinGroup > & getIndistinguishableProteins() const
Returns the indistinguishable proteins.
OpenMS::IdXMLFile::store
void store(const 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::PeptideHit::getSequence
const AASequence & getSequence() const
returns the peptide sequence without trailing or following spaces
OpenMS::ProteinIdentification::setInferenceEngine
void setInferenceEngine(const String &search_engine)
Sets the inference engine type.
OpenMS::String
A more convenient string class.
Definition: String.h:59
OpenMS::ProteinIdentification::ProteinGroup::accessions
std::vector< String > accessions
Accessions of (indistinguishable) proteins that belong to the same group.
Definition: ProteinIdentification.h:134
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)
OpenMS::AASequence::toUnmodifiedString
String toUnmodifiedString() const
returns the peptide as string without any modifications or (e.g., "PEPTIDER")
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_LOG_WARN
#define OPENMS_LOG_WARN
Macro if a warning, a piece of information which should be read by the user, should be logged.
Definition: LogStream.h:460
OpenMS::ProteinIdentification
Representation of a protein identification run.
Definition: ProteinIdentification.h:70
OpenMS::File::temporary_files_
static TemporaryFiles_ temporary_files_
private list of temporary filenames, which are deleted upon program exit
Definition: File.h:355
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::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
OpenMS::IDFilter::removeUnreferencedProteins
static void removeUnreferencedProteins(ConsensusMap &cmap, bool include_unassigned)
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.
int
OpenMS::ProteinIdentification::getHits
const std::vector< ProteinHit > & getHits() const
Returns the protein hits.
QProcess
seqan::getPath
std::string getPath(const Pattern< TNeedle, FuzzyAC > &me, typename Pattern< TNeedle, FuzzyAC >::TVert current_state)
for debug only
Definition: AhoCorasickAmbiguous.h:636
OPENMS_LOG_DEBUG
#define OPENMS_LOG_DEBUG
Macro for general debugging information.
Definition: LogStream.h:470
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::File::CopyOptions
CopyOptions
Copy directory recursively.
Definition: File.h:132
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:70
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::PeptideProteinResolution::buildGraph
void buildGraph(ProteinIdentification &protein, const std::vector< PeptideIdentification > &peptides, bool skip_sort=false)
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:350
OPENMS_LOG_ERROR
#define OPENMS_LOG_ERROR
Macro to be used if non-fatal error are reported (processing continues)
Definition: LogStream.h:455
OpenMS::File::TempDir
Class representing a temporary directory.
Definition: File.h:63
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::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:73
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_LOG_INFO
#define OPENMS_LOG_INFO
Macro if a information, e.g. a status should be reported.
Definition: LogStream.h:465
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.
OpenMS::ProteinIdentification::ProteinGroup::probability
double probability
Probability of this group.
Definition: ProteinIdentification.h:131
File.h
PeptideProteinResolution.h
TOPPBase.h
OpenMS::File::TempDir::temp_dir_
String temp_dir_
Definition: File.h:84
OpenMS::IdXMLFile
Used to load and store idXML files.
Definition: IdXMLFile.h:63
OpenMS::String::toLower
String & toLower()
Converts the string to lowercase.
OpenMS::ProteinIdentification::ProteinGroup
Bundles multiple (e.g. indistinguishable) proteins in a group.
Definition: ProteinIdentification.h:117
OpenMS::PeptideHit
Representation of a peptide hit.
Definition: PeptideHit.h:55
StringListUtils.h