USI.h

Go to the documentation of this file.

// Copyright (c) 2002-present, OpenMS Inc. -- EKU Tuebingen, ETH Zurich, and FU Berlin
// SPDX-License-Identifier: BSD-3-Clause
//
// --------------------------------------------------------------------------
// $Maintainer: Timo Sachsenberg $
// $Authors: Timo Sachsenberg $
// --------------------------------------------------------------------------
 
#pragma once
 
#include <OpenMS/DATASTRUCTURES/StringUtils.h>
#include <OpenMS/config.h>
 
#include <optional>
 
namespace OpenMS
{
  class OPENMS_DLLAPI USI
  {
  public:
    enum class IndexType
    {
      SCAN,    
      INDEX,   
      NATIVEID 
    };
 
 
 
    USI();
 
    USI(const std::string& collection,
        const std::string& ms_run,
        IndexType index_type,
        const std::string& index,
        const std::string& interpretation = "");
 
    explicit USI(const std::string& usi_string);
 
    USI(const USI&) = default;
 
    USI(USI&&) noexcept = default;
 
    ~USI() = default;
 
 
 
    USI& operator=(const USI&) = default;
 
    USI& operator=(USI&&) noexcept = default;
 
 
 
    bool operator==(const USI& rhs) const;
 
    bool operator!=(const USI& rhs) const;
 
    bool operator<(const USI& rhs) const;
 
 
 
    bool isValid() const;
 
    static bool isValidUSI(const std::string& usi_string);
 
    static std::optional<USI> tryParse(const std::string& usi_string);
 
 
 
    const std::string& getCollection() const;
 
    void setCollection(const std::string& collection);
 
    const std::string& getMSRun() const;
 
    void setMSRun(const std::string& ms_run);
 
    IndexType getIndexType() const;
 
    void setIndexType(IndexType index_type);
 
    const std::string& getIndex() const;
 
    void setIndex(const std::string& index);
 
    const std::string& getInterpretation() const;
 
    void setInterpretation(const std::string& interpretation);
 
    bool hasInterpretation() const;
 
 
 
    std::string toString() const;
 
    bool fromString(const std::string& usi_string);
 
 
 
    static USI createFromScanNumber(const std::string& dataset_id,
                                    const std::string& filename,
                                    int scan_number,
                                    const std::string& interpretation = "");
 
    static USI createFromNativeID(const std::string& dataset_id,
                                  const std::string& filename,
                                  const std::string& native_id);
 
    static std::optional<int> extractScanNumberFromNativeID(const std::string& native_id);
 
    static std::string indexTypeToString(IndexType index_type);
 
    static IndexType indexTypeFromString(const std::string& type_string);
 
    static std::string extractBasename(const std::string& filepath);
 
 
 
    static const std::string& getCVAccession();
 
    static const std::string& getCVName();
 
  protected:
    std::string collection_;      
    std::string ms_run_;          
    IndexType index_type_;   
    std::string index_;           
    std::string interpretation_;  
 
    static const std::string USI_PREFIX;
 
    static const std::string CV_ACCESSION;
 
    static const std::string CV_NAME;
  };
 
  OPENMS_DLLAPI std::ostream& operator<<(std::ostream& os, const USI& usi);
 
} // namespace OpenMS