linearSolverDevice.h

Go to the documentation of this file.

// ---------------------------------------------------------------------
//
// Copyright (c) 2017-2025  The Regents of the University of Michigan and DFT-FE
// authors.
//
// This file is part of the DFT-FE code.
//
// The DFT-FE code is free software; you can use it, redistribute
// it, and/or modify it under the terms of the GNU Lesser General
// Public License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
// The full text of the license can be found in the file LICENSE at
// the top level of the DFT-FE distribution.
//
// ---------------------------------------------------------------------
//
 
 
#if defined(DFTFE_WITH_DEVICE)
#  ifndef linearSolverDevice_H_
#    define linearSolverDevice_H_
 
#    include <linearSolverProblemDevice.h>
#    include <DeviceTypeConfig.h>
namespace dftfe
{
  /**
   * @brief Abstract linear solver base class.
   *
   * @author Sambit Das, Gourab Panigrahi
   */
  class linearSolverDevice
  {
  public:
    /// Constructor
    linearSolverDevice();
 
    /**
     * @brief Solve linear system, A*x=Rhs
     *
     * @param problem linearSolverProblemDevice object (functor) to compute Rhs and A*x, and preconditioning
     * @param relTolerance Tolerance (relative) required for convergence.
     * @param maxNumberIterations Maximum number of iterations.
     * @param debugLevel Debug output level:
     *                   0 - no debug output
     *                   1 - limited debug output
     *                   2 - all debug output.
     */
    virtual void
    solve(linearSolverProblemDevice &problem,
          const double               absTolerance,
          const dftfe::uInt          maxNumberIterations,
          const dftfe::Int           debugLevel     = 0,
          bool                       distributeFlag = true) = 0;
 
  private:
  };
 
} // namespace dftfe
#  endif // linearSolverDevice_H_
#endif