moose::internal Namespace Reference

Classes
class	ConvergenceIterationTypeRegistry
	Registry for Convergence iteration types. More...
class	ExecFlagRegistry
	Registry for statically defining execute flags with consistent numbering. More...
class	PerfGraphRegistry
	The place where all timed sections will be stored. More...
class	PerfGraphSectionInfo
	Used to hold metadata about the registered sections Note: this is a class instead of a struct because structs are not able to be created in place using emplace_back in C++11. More...
struct	SoltionInvalidityNameHash
	Helper class that hash the name associated with an invalid solution. More...
class	SolutionInvalidityInfo
	Helper class that stores the info associated with an invalid solution. More...
class	SolutionInvalidityName
	Helper class that stores the name associated with an invalid solution. More...
class	SolutionInvalidityRegistry
	The place where all sections with solution invalid warnings will be stored. More...

Functions
std::string	incompatVarMsg (MooseVariableFieldBase &var1, MooseVariableFieldBase &var2)
	Builds and returns a string of the form: More...
std::string	mooseMsgFmt (const std::string &msg, const std::string &title, const std::string &color)
	Format a message for output with a title. More...
std::string	mooseMsgFmt (const std::string &msg, const std::string &color)
	Format a message for output without a title. More...
void	mooseErrorRaw (std::string msg, const std::string &prefix="", const hit::Node *node=nullptr, const bool show_trace=true)
	Main callback for emitting a moose error. More...
std::string	formatMooseDocumentedError (const std::string &repo_name, const unsigned int issue_num, const std::string &msg)
	Formats a documented error. More...
template<typename T1 , typename T2 >
void	rawValueEqualityHelper (T1 &out, const T2 &in)
template<typename T1 , typename T2 >
void	rawValueEqualityHelper (std::vector< T1 > &out, const std::vector< T2 > &in)
template<typename T1 , typename T2 , std::size_t N>
void	rawValueEqualityHelper (std::array< T1, N > &out, const std::array< T2, N > &in)
PerfGraphRegistry &	getPerfGraphRegistry ()
	Get the global PerfGraphRegistry singleton. More...
SolutionInvalidityRegistry &	getSolutionInvalidityRegistry ()
	Get the global SolutionInvalidityRegistry singleton. More...
std::ostream &	operator<< (std::ostream &os, const SolutionInvalidityName &name)
bool	boundaryRestricted (const std::set< BoundaryID > &boundary_ids)
void	mooseStreamAll (std::ostringstream &ss)
	All of the following are not meant to be called directly - they are called by the normal macros (mooseError(), etc.) down below. More...
template<typename T , typename... Args>
void	mooseStreamAll (std::ostringstream &ss, T &&val, Args &&... args)
template<typename S , typename... Args>
void	mooseWarningStream (S &oss, Args &&... args)
template<typename S , typename... Args>
void	mooseUnusedStream (S &oss, Args &&... args)
template<typename S , typename... Args>
void	mooseInfoStreamRepeated (S &oss, Args &&... args)
template<typename S , typename... Args>
void	mooseInfoStream (S &oss, Args &&... args)
template<typename S , typename... Args>
void	mooseDeprecatedStream (S &oss, const bool expired, const bool print_title, const bool show_trace, Args &&... args)

Variables
libMesh::Threads::spin_mutex	moose_stream_lock

Function Documentation

boundaryRestricted()

bool moose::internal::boundaryRestricted

(

const std::set< BoundaryID > &

boundary_ids

)

Definition at line 46 of file MaterialPropertyInterface.C.

Referenced by MaterialPropertyInterface::getMaterialDataType().

{
  return !boundary_ids.empty() && BoundaryRestrictable::restricted(boundary_ids);
}

formatMooseDocumentedError()

std::string moose::internal::formatMooseDocumentedError	(	const std::string &	repo_name,
		const unsigned int	issue_num,
		const std::string &	msg
	)

Formats a documented error.

A documented error is an error that has an issue associated with it.

The repository name repo_name links a named repository to a URL and should be registered at the application level with registerRepository(). See Moose.C for an example of the "moose" repository registration.

Parameters

repo_name	The repository name where the issue resides
issue_num	The number of the issue
msg	The specific error message

Definition at line 142 of file MooseError.C.

Referenced by MooseBase::mooseDocumentedError(), and mooseDocumentedError().

{
  const auto & repo_url = Registry::getRepositoryURL(repo_name);
  std::stringstream oss;
  oss << msg << "\n\nThis error is documented at " << repo_url << "/issues/" << issue_num << ".";
  return oss.str();
}

getPerfGraphRegistry()

PerfGraphRegistry & moose::internal::getPerfGraphRegistry

(

)

Get the global PerfGraphRegistry singleton.

So it can be constructed.

Definition at line 20 of file PerfGraphRegistry.C.

Referenced by dataLoad(), dataStore(), PerfGraphReporter::finalize(), PerfGuard::PerfGuard(), and PerfGraphInterface::registerTimedSection().

{
  // In C++11 this is even thread safe! (Lookup "Static Initializers")
  static PerfGraphRegistry perf_graph_registry_singleton;

  return perf_graph_registry_singleton;
}

getSolutionInvalidityRegistry()

SolutionInvalidityRegistry & moose::internal::getSolutionInvalidityRegistry

(

)

Get the global SolutionInvalidityRegistry singleton.

So it can be constructed.

Definition at line 18 of file SolutionInvalidityRegistry.C.

Referenced by dataLoad(), SolutionInvalidInterface::flagInvalidSolutionInternal(), SolutionInvalidInterface::registerInvalidSolutionInternal(), SolutionInvalidity::syncIteration(), and to_json().

{
  // In C++11 this is even thread safe! (Lookup "Static Initializers")
  static SolutionInvalidityRegistry solution_invalid_registry_singleton;

  return solution_invalid_registry_singleton;
}

incompatVarMsg()

std::string moose::internal::incompatVarMsg	(	MooseVariableFieldBase &	var1,
		MooseVariableFieldBase &	var2
	)

Builds and returns a string of the form:

[var1-elemtype],ORDER[var1-order] != [var2-elemtype],ORDER[var2-order]

This is a convenience function to be used when error messages (especially with paramError) need to report that variable types are incompatible (e.g. with residual save-in).

Definition at line 26 of file MooseError.C.

Referenced by ADDGKernel::ADDGKernel(), ADIntegratedBCTempl< T >::ADIntegratedBCTempl(), ADKernelTempl< T >::ADKernelTempl(), ArrayDGKernel::ArrayDGKernel(), ArrayIntegratedBC::ArrayIntegratedBC(), ArrayKernel::ArrayKernel(), DGKernel::DGKernel(), IntegratedBC::IntegratedBC(), Kernel::Kernel(), NodalBC::NodalBC(), NodalKernel::NodalKernel(), and MultiAppDofCopyTransfer::transfer().

{
  std::stringstream ss;
  ss << libMesh::Utility::enum_to_string<FEFamily>(var1.feType().family) << ",ORDER"
     << var1.feType().order
     << " != " << libMesh::Utility::enum_to_string<FEFamily>(var2.feType().family) << ",ORDER"
     << var2.feType().order;
  return ss.str();
}

mooseDeprecatedStream()

template<typename S , typename... Args>

void moose::internal::mooseDeprecatedStream	(	S &	oss,
		const bool	expired,
		const bool	print_title,
		const bool	show_trace,
		Args &&...	args
	)

Definition at line 252 of file MooseError.h.

Referenced by Moose::Builder::build(), MooseBase::mooseDeprecated(), mooseDeprecated(), MooseBase::mooseDeprecatedNoTrace(), mooseDeprecatedNoTrace(), mooseDeprecationExpired(), and mooseDeprecationExpiredNoTrace().

{
  if (Moose::_deprecated_is_error)
    mooseError("\n\nDeprecated code:\n", std::forward<Args>(args)...);

  std::ostringstream ss;
  mooseStreamAll(ss, args...);

  const auto color = expired ? COLOR_RED : COLOR_YELLOW;
  std::string msg = print_title ? mooseMsgFmt(ss.str(), "*** Deprecation Warning ***", color)
                                : mooseMsgFmt(ss.str(), color);
  oss << msg;
  ss.str("");
  if (show_trace)
  {
    if (libMesh::global_n_processors() == 1)
      libMesh::print_trace(ss);
    else
      libMesh::write_traceout();
    {
      libMesh::Threads::spin_mutex::scoped_lock lock(moose_stream_lock);
      oss << ss.str() << std::endl;
    };
  };
}

mooseErrorRaw()

void moose::internal::mooseErrorRaw	(	std::string	msg,
		const std::string &	prefix = "",
		const hit::Node *	node = nullptr,
		const bool	show_trace = true
	)

Main callback for emitting a moose error.

Parameters

msg	The error message
prefix	Optional prefix to add to every line of the error (for multiapp prefixes)
node	Optional HIT node to associate with the error, adding file path context
show_trace	Whether or not to show a stack trace, defaults to true

Definition at line 53 of file MooseError.C.

Referenced by MooseBase::callMooseError(), mooseDocumentedError(), and mooseError().

{
  if (Moose::_throw_on_error)
    throw MooseRuntimeError(msg, node);

  // Atomic that will be set as soon as any thread hits this method
  static std::atomic_flag aborting = ATOMIC_FLAG_INIT;

  // Per-thread bool that will avoid us getting stuck in pause() if one
  // thread hits this method twice.
  thread_local static bool this_thread_aborting = false;

  // This branch will be hit after another thread has already set the atomic.
  // MPI_Abort, despite its name, does not behave like std::abort but instead
  // calls exit handlers and destroys statics. So we don't want to touch
  // anything static at this point. We'll just wait until the winning thread
  // has incurred program exit
  if (aborting.test_and_set(std::memory_order_acq_rel) && !this_thread_aborting)
  {
    // Waiting for the other thread(s), not burning CPU
    for (;;)
      pause();
  }
  // We're the first thread to hit this method (we set the atomic), so we're
  // responsible for dumping the error and trace(s) while the remaining
  // threads wait for us to exit (via libmesh_abort())
  else
  {
    // No, really, terminate. libmesh_abort() may throw an
    // exception, and if we catch that exception (or a bad_alloc, or
    // anything thrown) and mooseError because we didn't understand
    // it, we just want to continue up the stack.
    if (this_thread_aborting)
      libmesh_abort();

    this_thread_aborting = true;

    // Output the message if there is one, but flush it without the trace
    // as trace retrieval can be slow in some circumstances and we want to
    // get the error message out ASAP
    if (!msg.empty())
    {
      // If we have a node available, add in the hit context (file location)
      if (node)
        msg = Moose::hitMessagePrefix(*node) + msg;

      msg = mooseMsgFmt(msg, "*** ERROR ***", COLOR_RED) + "\n";
      if (!prefix.empty()) // multiapp prefix
        MooseUtils::indentMessage(prefix, msg);

      {
        Threads::spin_mutex::scoped_lock lock(moose_stream_lock);
        Moose::err << msg << std::flush;
      }
    }

    // Print the trace if enabled and on a single rank
    if (show_trace && libMesh::global_n_processors() == 1)
    {
      std::ostringstream oss;
      print_trace(oss);
      auto trace = oss.str();
      if (!prefix.empty()) // multiapp prefix
        MooseUtils::indentMessage(prefix, trace);

      {
        Threads::spin_mutex::scoped_lock lock(moose_stream_lock);
        Moose::err << trace << std::flush;
      }
    }

    // In parallel with libMesh configured with --enable-tracefiles, this will
    // dump a trace for each rank to file
    if (libMesh::global_n_processors() > 1)
      libMesh::write_traceout();

    libmesh_abort();
  }
}

mooseInfoStream()

template<typename S , typename... Args>

void moose::internal::mooseInfoStream	(	S &	oss,
		Args &&...	args
	)

Definition at line 245 of file MooseError.h.

Referenced by MooseBase::mooseInfo(), and mooseInfo().

{
  mooseDoOnce(mooseInfoStreamRepeated(oss, args...););
}

mooseInfoStreamRepeated()

template<typename S , typename... Args>

void moose::internal::mooseInfoStreamRepeated	(	S &	oss,
		Args &&...	args
	)

Definition at line 232 of file MooseError.h.

Referenced by mooseInfoRepeated(), and mooseInfoStream().

{
  std::ostringstream ss;
  mooseStreamAll(ss, args...);
  std::string msg = mooseMsgFmt(ss.str(), "*** Info ***", COLOR_CYAN);
  {
    libMesh::Threads::spin_mutex::scoped_lock lock(moose_stream_lock);
    oss << msg << std::flush;
  }
}

mooseMsgFmt() [1/2]

std::string moose::internal::mooseMsgFmt	(	const std::string &	msg,
		const std::string &	title,
		const std::string &	color
	)

Format a message for output with a title.

Parameters

msg	The message to print
title	The title that will go on a line before the message
color	The color to print the message in

Returns

The formatted message

Definition at line 37 of file MooseError.C.

Referenced by mooseDeprecatedStream(), mooseErrorRaw(), mooseInfoStreamRepeated(), mooseUnusedStream(), and mooseWarningStream().

{
  std::ostringstream oss;
  oss << "\n" << color << "\n" << title << "\n" << msg << COLOR_DEFAULT << "\n";
  return oss.str();
}

mooseMsgFmt() [2/2]

std::string moose::internal::mooseMsgFmt	(	const std::string &	msg,
		const std::string &	color
	)

Format a message for output without a title.

Parameters

msg	The message to print
color	The color to print the message in

Returns

The formatted message

Definition at line 45 of file MooseError.C.

{
  std::ostringstream oss;
  oss << "\n" << color << "\n" << msg << COLOR_DEFAULT << "\n";
  return oss.str();
}

mooseStreamAll() [1/2]

void moose::internal::mooseStreamAll

(

std::ostringstream &

ss

)

All of the following are not meant to be called directly - they are called by the normal macros (mooseError(), etc.) down below.

Definition at line 137 of file MooseError.C.

Referenced by mooseDeprecatedStream(), mooseDocumentedError(), mooseError(), InputParameters::mooseError(), mooseInfoStreamRepeated(), mooseStreamAll(), mooseUnusedStream(), mooseWarningStream(), InputParameters::paramError(), and InputParameters::paramMessage().

{
}

mooseStreamAll() [2/2]

template<typename T , typename... Args>

void moose::internal::mooseStreamAll	(	std::ostringstream &	ss,
		T &&	val,
		Args &&...	args
	)

Definition at line 189 of file MooseError.h.

{
  ss << val;
  mooseStreamAll(ss, std::forward<Args>(args)...);
}

mooseUnusedStream()

template<typename S , typename... Args>

void moose::internal::mooseUnusedStream	(	S &	oss,
		Args &&...	args
	)

Definition at line 216 of file MooseError.h.

Referenced by mooseUnused().

{
  std::ostringstream ss;
  mooseStreamAll(ss, args...);
  std::string msg = mooseMsgFmt(ss.str(), "*** Warning ***", COLOR_YELLOW);
  if (Moose::_throw_on_warning)
    throw std::runtime_error(msg);

  {
    libMesh::Threads::spin_mutex::scoped_lock lock(moose_stream_lock);
    oss << msg << std::flush;
  }
}

mooseWarningStream()

template<typename S , typename... Args>

void moose::internal::mooseWarningStream	(	S &	oss,
		Args &&...	args
	)

Definition at line 197 of file MooseError.h.

Referenced by MooseBase::mooseWarning(), mooseWarning(), and MooseBase::mooseWarningNonPrefixed().

{
  if (Moose::_warnings_are_errors)
    mooseError(std::forward<Args>(args)...);

  std::ostringstream ss;
  mooseStreamAll(ss, args...);
  std::string msg = mooseMsgFmt(ss.str(), "*** Warning ***", COLOR_YELLOW);
  if (Moose::_throw_on_warning)
    throw std::runtime_error(msg);

  {
    libMesh::Threads::spin_mutex::scoped_lock lock(moose_stream_lock);
    oss << msg << std::flush;
  }
}

operator<<()

std::ostream & moose::internal::operator<<	(	std::ostream &	os,
		const SolutionInvalidityName &	name
	)

Definition at line 46 of file SolutionInvalidityRegistry.C.

{
  os << name.object_type << ": " << name.message;
  return os;
}

rawValueEqualityHelper() [1/3]

template<typename T1 , typename T2 >

void moose::internal::rawValueEqualityHelper	(	T1 &	out,
		const T2 &	in
	)

Definition at line 216 of file MaterialProperty.h.

Referenced by MaterialPropertyBase< T, false >::qpCopy(), rawValueEqualityHelper(), and MaterialPropertyBase< T, false >::swap().

{
  out = MetaPhysicL::raw_value(in);
}

rawValueEqualityHelper() [2/3]

template<typename T1 , typename T2 >

void moose::internal::rawValueEqualityHelper	(	std::vector< T1 > &	out,
		const std::vector< T2 > &	in
	)

Definition at line 223 of file MaterialProperty.h.

{
  out.resize(in.size());
  for (MooseIndex(in) i = 0; i < in.size(); ++i)
    rawValueEqualityHelper(out[i], in[i]);
}

rawValueEqualityHelper() [3/3]

template<typename T1 , typename T2 , std::size_t N>

void moose::internal::rawValueEqualityHelper	(	std::array< T1, N > &	out,
		const std::array< T2, N > &	in
	)

Definition at line 232 of file MaterialProperty.h.

{
  for (MooseIndex(in) i = 0; i < in.size(); ++i)
    rawValueEqualityHelper(out[i], in[i]);
}

Variable Documentation

moose_stream_lock

libMesh::Threads::spin_mutex moose::internal::moose_stream_lock

inline

Definition at line 140 of file MooseError.h.

Referenced by mooseDeprecatedStream(), mooseErrorRaw(), mooseInfoStreamRepeated(), mooseUnusedStream(), and mooseWarningStream().