Ifpack2_Details_Factory_def.hpp

// @HEADER
// *****************************************************************************
//       Ifpack2: Templated Object-Oriented Algebraic Preconditioner Package
//
// Copyright 2009 NTESS and the Ifpack2 contributors.
// SPDX-License-Identifier: BSD-3-Clause
// *****************************************************************************
// @HEADER
 
#ifndef IFPACK2_DETAILS_FACTORY_DEF_HPP
#define IFPACK2_DETAILS_FACTORY_DEF_HPP
 
#include "Ifpack2_Factory.hpp"
#include "Ifpack2_Utilities.hpp"
#include "Ifpack2_Details_OneLevelFactory.hpp"
#include "Ifpack2_AdditiveSchwarz.hpp"
#if defined(HAVE_IFPACK2_EXPERIMENTAL) && defined(HAVE_IFPACK2_SUPPORTGRAPH)
#include "Ifpack2_SupportGraph.hpp"
#endif  // defined(HAVE_IFPACK2_EXPERIMENTAL) && defined(HAVE_IFPACK2_SUPPORTGRAPH)
 
namespace Ifpack2 {
namespace Details {
 
template <class SC, class LO, class GO, class NT>
Teuchos::RCP<typename Factory<SC, LO, GO, NT>::prec_type>
Factory<SC, LO, GO, NT>::
    create(const std::string& precType,
           const Teuchos::RCP<const row_matrix_type>& matrix,
           const int overlap) {
  using Teuchos::RCP;
  using Teuchos::rcp;
  RCP<prec_type> prec;
 
  // precTypeUpper is the upper-case version of precType.
  std::string precTypeUpper = canonicalize(precType);
 
  if (precTypeUpper == "SCHWARZ") {
    // Discussion related to Bug 5987: The line of code below will
    // give AdditiveSchwarz a default subdomain solver by default.
    // However, you can change it later via setParameters() or
    // setInnerPreconditioner().  In the former case, AdditiveSchwarz
    // will not create the subdomain solver until you call
    // initialize(), so there is no performance loss in waiting after
    // calling AdditiveSchwarz's constructor before specifying the
    // subdomain solver's type.
    //
    // FIXME (mfh 14 Jan 2014) Use of "CUSTOM" in AdditiveSchwarz may
    // destroy information needed for fixing Bug 5987.  In particular,
    // the input ParameterList needs to keep its subdomain solver
    // info.  setInnerPreconditioner must _not_ destroy that info _if_
    // the Factory creates the AdditiveSchwarz instance.
    prec = rcp(new AdditiveSchwarz<row_matrix_type>(matrix, overlap));
  } else if (precTypeUpper == "KRYLOV") {
    TEUCHOS_TEST_FOR_EXCEPTION(true, std::invalid_argument,
                               "The \"KRYLOV\" preconditioner option has "
                               "been deprecated and removed.  If you want a Krylov solver, use the "
                               "Belos package.");
  }
#if defined(HAVE_IFPACK2_EXPERIMENTAL) && defined(HAVE_IFPACK2_SUPPORTGRAPH)
  else if (precTypeUpper == "SUPPORTGRAPH") {
    prec = rcp(new SupportGraph<row_matrix_type>(matrix));
  }
#endif
  else {
    try {
      Details::OneLevelFactory<row_matrix_type> factory;
      prec = factory.create(precType, matrix);
    } catch (std::invalid_argument&) {
      TEUCHOS_TEST_FOR_EXCEPTION(
          true, std::invalid_argument,
          "Ifpack2::Factory::create: "
          "Invalid preconditioner type \""
              << precType << "\".");
    }
  }
  return prec;
}
 
template <class SC, class LO, class GO, class NT>
Teuchos::RCP<typename Factory<SC, LO, GO, NT>::prec_type>
Factory<SC, LO, GO, NT>::
    create(const std::string& precType,
           const Teuchos::RCP<const row_matrix_type>& matrix) {
  using Teuchos::RCP;
  using Teuchos::rcp;
  RCP<prec_type> prec;
 
  // precTypeUpper is the upper-case version of precType.
  std::string precTypeUpper(precType);
  if (precTypeUpper.size() > 0) {
    for (size_t k = 0; k < precTypeUpper.size(); ++k) {
      precTypeUpper[k] = ::toupper(precTypeUpper[k]);
    }
  }
 
  if (precTypeUpper == "SCHWARZ") {
    // Discussion related to Bug 5987: The line of code below will
    // give AdditiveSchwarz a default subdomain solver by default.
    // However, you can change it later via setParameters() or
    // setInnerPreconditioner().  In the former case, AdditiveSchwarz
    // will not create the subdomain solver until you call
    // initialize(), so there is no performance loss in waiting after
    // calling AdditiveSchwarz's constructor before specifying the
    // subdomain solver's type.
    //
    // FIXME (mfh 14 Jan 2014) Use of "CUSTOM" in AdditiveSchwarz may
    // destroy information needed for fixing Bug 5987.  In particular,
    // the input ParameterList needs to keep its subdomain solver
    // info.  setInnerPreconditioner must _not_ destroy that info _if_
    // the Factory creates the AdditiveSchwarz instance.
    //
    // "CUSTOM" isn't necessary.  If Inverse_ is not null, then
    // AdditiveSchwarz's initialize() should just use the inner
    // preconditioner as it is.  If Inverse_ is null, then we assume
    // you want the default inner preconditioner.  You shouldn't have
    // called setInnerPreconditioner() with a null argument if that's
    // not what you meant!
    prec = rcp(new AdditiveSchwarz<row_matrix_type>(matrix));
  } else if (precTypeUpper == "KRYLOV") {
    TEUCHOS_TEST_FOR_EXCEPTION(true, std::invalid_argument,
                               "The \"KRYLOV\" preconditioner option has "
                               "been deprecated and removed.  If you want a Krylov solver, use the "
                               "Belos package.");
  }
#if defined(HAVE_IFPACK2_EXPERIMENTAL) && defined(HAVE_IFPACK2_SUPPORTGRAPH)
  else if (precTypeUpper == "SUPPORTGRAPH") {
    prec = rcp(new SupportGraph<row_matrix_type>(matrix));
  }
#endif
  else {
    bool success = false;
    std::ostringstream err;
    try {
      Details::OneLevelFactory<row_matrix_type> factory;
      prec    = factory.create(precType, matrix);
      success = true;
    } catch (std::invalid_argument& e) {
      err << "Ifpack2::Factory::create: Invalid preconditioner type \""
          << precType << "\".  More information for Ifpack2 developers: "
          << e.what();
    }
    TEUCHOS_TEST_FOR_EXCEPTION(!success, std::invalid_argument, err.str());
  }
 
  TEUCHOS_TEST_FOR_EXCEPTION(
      prec.is_null(), std::logic_error,
      "Ifpack2::Factory::create: "
      "Return value is null right before return.  This should never happen.  "
      "Please report this bug to the Ifpack2 developers.");
  return prec;
}
 
template <class SC, class LO, class GO, class NT>
Teuchos::RCP<typename Factory<SC, LO, GO, NT>::prec_type>
Factory<SC, LO, GO, NT>::
    create(const std::string& precType,
           const Teuchos::RCP<const row_matrix_type>& matrix,
           const Teuchos::RCP<const coord_type>& coordinates) {
  using Teuchos::RCP;
  using Teuchos::rcp;
  RCP<prec_type> prec;
 
  // precTypeUpper is the upper-case version of precType.
  std::string precTypeUpper(precType);
  if (precTypeUpper.size() > 0) {
    for (size_t k = 0; k < precTypeUpper.size(); ++k) {
      precTypeUpper[k] = ::toupper(precTypeUpper[k]);
    }
  }
 
  if (precTypeUpper == "SCHWARZ") {
    // Discussion related to Bug 5987: The line of code below will
    // give AdditiveSchwarz a default subdomain solver by default.
    // However, you can change it later via setParameters() or
    // setInnerPreconditioner().  In the former case, AdditiveSchwarz
    // will not create the subdomain solver until you call
    // initialize(), so there is no performance loss in waiting after
    // calling AdditiveSchwarz's constructor before specifying the
    // subdomain solver's type.
    //
    // FIXME (mfh 14 Jan 2014) Use of "CUSTOM" in AdditiveSchwarz may
    // destroy information needed for fixing Bug 5987.  In particular,
    // the input ParameterList needs to keep its subdomain solver
    // info.  setInnerPreconditioner must _not_ destroy that info _if_
    // the Factory creates the AdditiveSchwarz instance.
    //
    // "CUSTOM" isn't necessary.  If Inverse_ is not null, then
    // AdditiveSchwarz's initialize() should just use the inner
    // preconditioner as it is.  If Inverse_ is null, then we assume
    // you want the default inner preconditioner.  You shouldn't have
    // called setInnerPreconditioner() with a null argument if that's
    // not what you meant!
    prec = rcp(new AdditiveSchwarz<row_matrix_type>(matrix, coordinates));
  } else {
    // Only stream-based RILUK with RCB partitioning as a subdomain solver
    // for an Additive Schwarz preconditioner supports using coordinates
    prec = Factory<SC, LO, GO, NT>::create(precType, matrix);
  }
 
  TEUCHOS_TEST_FOR_EXCEPTION(
      prec.is_null(), std::logic_error,
      "Ifpack2::Factory::create: "
      "Return value is null right before return.  This should never happen.  "
      "Please report this bug to the Ifpack2 developers.");
  return prec;
}
 
template <class SC, class LO, class GO, class NT>
std::vector<std::string>
Factory<SC, LO, GO, NT>::
    getSupportedNames() const {
  Details::OneLevelFactory<row_matrix_type> factory;
  std::vector<std::string> supportedNames = factory.getSupportedNames();
  supportedNames.push_back("SCHWARZ");
#if defined(HAVE_IFPACK2_EXPERIMENTAL) && defined(HAVE_IFPACK2_SUPPORTGRAPH)
  supportedNames.push_back("SUPPORTGRAPH");
#endif
  return supportedNames;
}
 
template <class SC, class LO, class GO, class NT>
bool Factory<SC, LO, GO, NT>::
    isSupported(const std::string& precType) {
  // precTypeUpper is the upper-case version of precType.
  std::string precTypeUpper = canonicalize(precType);
 
  std::vector<std::string> supportedNames = getSupportedNames();
  auto it                                 = std::find(std::begin(supportedNames), std::end(supportedNames), precTypeUpper);
  return it != std::end(supportedNames);
}
 
}  // namespace Details
}  // namespace Ifpack2
 
#define IFPACK2_DETAILS_FACTORY_INSTANT(S, LO, GO, N) \
  template class Ifpack2::Details::Factory<S, LO, GO, N>;
 
#endif  // IFPACK2_DETAILS_FACTORY_DEF_HPP