LPWrapper.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: Alexandra Zerck $
// --------------------------------------------------------------------------
 
#pragma once
 
#include <OpenMS/DATASTRUCTURES/StringUtils.h> // for String
 
#include <OpenMS/CONCEPT/Types.h>
#include <OpenMS/OpenMSConfig.h>
#include <OpenMS/config.h>
 
#include <cstdint>
#include <limits>
#include <memory>
 
// do NOT include the HiGHS headers here (they are only available when building OpenMS), forward declare instead
class Highs;
 
namespace OpenMS
{
 
  class OPENMS_DLLAPI LPWrapper
  {
public:
    struct SolverParam
    {
      double mip_gap = 0.0;                                   
      Int time_limit = (std::numeric_limits<Int>::max)();     
      bool enable_presolve = true;                            
    };
 
    enum Type
    {
      UNBOUNDED = 1,      
      LOWER_BOUND_ONLY,   
      UPPER_BOUND_ONLY,   
      DOUBLE_BOUNDED,     
      FIXED               
    };
 
    enum VariableType
    {
      CONTINUOUS = 1,     
      INTEGER,            
      BINARY              
    };
 
    enum Sense
    {
      MIN = 1,            
      MAX                 
    };
 
    enum WriteFormat
    {
      FORMAT_LP = 0,      
      FORMAT_MPS          
    };
 
    enum SOLVER
    {
      SOLVER_HIGHS        
    };
 
    enum SolverStatus
    {
      UNDEFINED = 1,      
      OPTIMAL = 5,        
      FEASIBLE = 2,       
      NO_FEASIBLE_SOL = 4 
    };
 
    LPWrapper();
    
    virtual ~LPWrapper();
 
    // problem creation/manipulation
    Int addRow(const std::vector<Int>& row_indices, const std::vector<double>& row_values, const std::string& name);
    
    Int addColumn();
    
    Int addColumn(const std::vector<Int>& column_indices, const std::vector<double>& column_values, const std::string& name);
 
    Int addRow(const std::vector<Int>& row_indices, const std::vector<double>& row_values,
               const std::string& name, double lower_bound, double upper_bound, Type type);
 
    Int addColumn(const std::vector<Int>& column_indices, const std::vector<double>& column_values, const std::string& name, double lower_bound, double upper_bound, Type type);
 
    void deleteRow(Int index);
    
    void setColumnName(Int index, const std::string& name);
    
    std::string getColumnName(Int index);
    
    std::string getRowName(Int index);
    
    Int getRowIndex(const std::string& name);
    
    Int getColumnIndex(const std::string& name);
    
    double getColumnUpperBound(Int index);
    
    double getColumnLowerBound(Int index);
    
    double getRowUpperBound(Int index);
    
    double getRowLowerBound(Int index);
    
    void setRowName(Int index, const std::string& name);
 
    void setColumnBounds(Int index, double lower_bound, double upper_bound, Type type);
 
    void setRowBounds(Int index, double lower_bound, double upper_bound, Type type);
 
    void setColumnType(Int index, VariableType type);
 
    VariableType getColumnType(Int index);
 
    void setObjective(Int index, double obj_value);
    
    double getObjective(Int index);
 
    void setObjectiveSense(Sense sense);
    Sense getObjectiveSense();
 
    Int getNumberOfColumns();
    
    Int getNumberOfRows();
 
    void setElement(Int row_index, Int column_index, double value);
    
    double getElement(Int row_index, Int column_index);
 
    // problem reading/writing
    void readProblem(const std::string& filename, const std::string& format);
 
    void writeProblem(const std::string& filename, const WriteFormat format) const;
 
    Int solve(SolverParam& solver_param, const Size verbose_level = 0);
 
    SolverStatus getStatus();
 
    // solution access
    double getObjectiveValue();
    
    double getColumnValue(Int index);
 
    Int getNumberOfNonZeroEntriesInRow(Int idx);
    
    void getMatrixRow(Int idx, std::vector<Int>& indexes);
 
    SOLVER getSolver() const;
 
protected:
    std::unique_ptr<Highs> highs_;     
    std::vector<double> solution_;     
    mutable std::vector<uint8_t> staged_integrality_;
    void flushIntegrality_() const;
  }; // class
 
} // namespace