Class for doing restart. More...

#include <RestartableDataIO.h>

Inheritance diagram for RestartableDataIO:

Public Member Functions
	RestartableDataIO (MooseApp &app, RestartableDataMap &data)

	RestartableDataIO (MooseApp &app, std::vector< RestartableDataMap > &data)

PerfGraph &	perfGraph ()
	Get the PerfGraph.

const Parallel::Communicator &	comm () const

processor_id_type	n_processors () const

processor_id_type	processor_id () const

Static Public Member Functions
static const std::string &	getRestartableExt ()

static const std::string &	restartableDataFile ()

static const std::string &	restartableHeaderFile ()

static std::filesystem::path	restartableDataFolder (const std::filesystem::path &folder_base)

static std::filesystem::path	restartableDataFile (const std::filesystem::path &folder_base)

static std::filesystem::path	restartableHeaderFile (const std::filesystem::path &folder_base)

static InputParameters	validParams ()

Protected Types
typedef int	COMPARE_HASH_CODE_TYPE
	The type to used for comparing hash codes (sanity checking)

Protected Member Functions
RestartableDataMap &	currentData (const THREAD_ID tid)

std::size_t	dataSize () const

PerfID	registerTimedSection (const std::string &section_name, const unsigned int level) const
	Call to register a named section for timing.

PerfID	registerTimedSection (const std::string &section_name, const unsigned int level, const std::string &live_message, const bool print_dots=true) const
	Call to register a named section for timing.

std::string	timedSectionName (const std::string &section_name) const

Protected Attributes
const std::variant< RestartableDataMap , std::vector< RestartableDataMap > >	_data
	The data we wish to act on This is a variant so that we can act on threaded and non-threaded data.

MooseApp &	_pg_moose_app
	The MooseApp that owns the PerfGraph.

const std::string	_prefix
	A prefix to use for all sections.

const Parallel::Communicator &	_communicator

Static Protected Attributes
static const unsigned int	CURRENT_BACKUP_FILE_VERSION = 4
	The current version for the backup file.

Detailed Description

Class for doing restart.

It takes care of writing and reading the restart files.

Definition at line 27 of file RestartableDataIO.h.

Member Typedef Documentation

◆ COMPARE_HASH_CODE_TYPE

typedef int RestartableDataIO::COMPARE_HASH_CODE_TYPE

protected

The type to used for comparing hash codes (sanity checking)

Definition at line 84 of file RestartableDataIO.h.

Constructor & Destructor Documentation

◆ RestartableDataIO() [1/2]

RestartableDataIO::RestartableDataIO	(	MooseApp &	app,
		RestartableDataMap &	data
	)

Definition at line 18 of file RestartableDataIO.C.

  : PerfGraphInterface(app.perfGraph(), "RestartableDataIO"),
    libMesh::ParallelObject(app),
    _data(&data)
{
}

◆ RestartableDataIO() [2/2]

RestartableDataIO::RestartableDataIO	(	MooseApp &	app,
		std::vector< RestartableDataMap > &	data
	)

Definition at line 25 of file RestartableDataIO.C.

  : PerfGraphInterface(app.perfGraph(), "RestartableDataIO"),
    libMesh::ParallelObject(app),
    _data(&data)
{
}

Member Function Documentation

◆ currentData()

RestartableDataMap & RestartableDataIO::currentData ( const THREAD_ID tid )

protected

Returns: The restartable data for thread tid

This exists so that we can support threaded and non-threaded data in _data

Definition at line 33 of file RestartableDataIO.C.

{
  mooseAssert(dataSize() > tid, "Invalid thread");
 
  if (std::holds_alternative<RestartableDataMap *>(_data))
    return *std::get<RestartableDataMap *>(_data);
  return (*std::get<std::vector<RestartableDataMap> *>(_data))[tid];
}

Referenced by RestartableDataReader::restore(), RestartableDataReader::restoreData(), and RestartableDataWriter::write().

◆ dataSize()

std::size_t RestartableDataIO::dataSize ( ) const

protected

Returns: The size of _data

Definition at line 43 of file RestartableDataIO.C.

{
  return std::holds_alternative<RestartableDataMap *>(_data)
             ? 1
             : std::get<std::vector<RestartableDataMap> *>(_data)->size();
}

Referenced by currentData(), RestartableDataReader::readHeader(), RestartableDataReader::restore(), and RestartableDataWriter::write().

◆ getRestartableExt()

const std::string & RestartableDataIO::getRestartableExt ( )

static

Returns: The common extension for restartable data folders

Definition at line 51 of file RestartableDataIO.C.

{
  static const std::string ext = ".rd";
  return ext;
}

Referenced by restartableDataFolder().

◆ perfGraph()

PerfGraph & PerfGraphInterface::perfGraph ( )

inherited

Get the PerfGraph.

Definition at line 86 of file PerfGraphInterface.C.

{
  return _pg_moose_app.perfGraph();
}

Referenced by CommonOutputAction::act(), PerfGraphData::finalize(), PerfGraphReporter::finalize(), and PerfGraphOutput::output().

◆ registerTimedSection() [1/2]

PerfID PerfGraphInterface::registerTimedSection	(	const std::string &	section_name,
		const unsigned int	level
	)		const

protectedinherited

Call to register a named section for timing.

Parameters

section_name	The name of the code section to be timed
level	The importance of the timer - lower is more important (0 will always come out)

Returns: The ID of the section - use when starting timing

Definition at line 61 of file PerfGraphInterface.C.

{
  const auto timed_section_name = timedSectionName(section_name);
  if (!moose::internal::getPerfGraphRegistry().sectionExists(timed_section_name))
    return moose::internal::getPerfGraphRegistry().registerSection(timed_section_name, level);
  else
    return moose::internal::getPerfGraphRegistry().sectionID(timed_section_name);
}

◆ registerTimedSection() [2/2]

PerfID PerfGraphInterface::registerTimedSection	(	const std::string &	section_name,
		const unsigned int	level,
		const std::string &	live_message,
		const bool	print_dots = `true`
	)		const

protectedinherited

Call to register a named section for timing.

Parameters

section_name	The name of the code section to be timed
level	The importance of the timer - lower is more important (0 will always come out)
live_message	The message to be printed to the screen during execution
print_dots	Whether or not progress dots should be printed for this section

Returns: The ID of the section - use when starting timing

Definition at line 72 of file PerfGraphInterface.C.

{
  const auto timed_section_name = timedSectionName(section_name);
  if (!moose::internal::getPerfGraphRegistry().sectionExists(timed_section_name))
    return moose::internal::getPerfGraphRegistry().registerSection(
        timedSectionName(section_name), level, live_message, print_dots);
  else
    return moose::internal::getPerfGraphRegistry().sectionID(timed_section_name);
}

◆ restartableDataFile() [1/2]

const std::string & RestartableDataIO::restartableDataFile ( )

static

Returns: The filename for the restartable data

Definition at line 58 of file RestartableDataIO.C.

{
  static const std::string file = "data";
  return file;
}

Referenced by RestartableDataReader::isAvailable(), restartableDataFile(), RestartableDataReader::setInput(), and RestartableDataWriter::write().

◆ restartableDataFile() [2/2]

std::filesystem::path RestartableDataIO::restartableDataFile ( const std::filesystem::path & folder_base )

static

Returns: The path to the restartable data file with base folder_base

Does not append .rd to the folder base

Definition at line 80 of file RestartableDataIO.C.

{
  return folder_base / restartableDataFile();
}

◆ restartableDataFolder()

std::filesystem::path RestartableDataIO::restartableDataFolder ( const std::filesystem::path & folder_base )

static

Returns: The path to the restartable data folder with base folder_base

This just appends .rd

Definition at line 72 of file RestartableDataIO.C.

{
  auto folder = folder_base;
  folder += getRestartableExt();
  return folder;
}

Referenced by MooseApp::metaDataFolderBase(), and MooseApp::restartFolderBase().

◆ restartableHeaderFile() [1/2]

const std::string & RestartableDataIO::restartableHeaderFile ( )

static

Returns: The filename for the restartable header

Definition at line 65 of file RestartableDataIO.C.

{
  static const std::string file = "header";
  return file;
}

Referenced by restartableHeaderFile(), RestartableDataReader::setInput(), and RestartableDataWriter::write().

◆ restartableHeaderFile() [2/2]

std::filesystem::path RestartableDataIO::restartableHeaderFile ( const std::filesystem::path & folder_base )

static

Returns: The path to the restartable header file with base folder_base

Does not append .rd to the folder base

Definition at line 86 of file RestartableDataIO.C.

{
  return folder_base / restartableHeaderFile();
}

◆ timedSectionName()

std::string PerfGraphInterface::timedSectionName ( const std::string & section_name ) const

protectedinherited

Returns: The name of the timed section with the name section_name.

Optionally adds a prefix if one is defined.

Definition at line 55 of file PerfGraphInterface.C.

{
  return _prefix.empty() ? "" : (_prefix + "::") + section_name;
}

Referenced by PerfGraphInterface::registerTimedSection(), and PerfGraphInterface::registerTimedSection().

◆ validParams()

InputParameters PerfGraphInterface::validParams ( )

staticinherited

Definition at line 16 of file PerfGraphInterface.C.

{
  InputParameters params = emptyInputParameters();
  return params;
}

Referenced by Convergence::validParams().

Member Data Documentation

◆ _data

const std::variant<RestartableDataMap *, std::vector<RestartableDataMap> *> RestartableDataIO::_data

protected

The data we wish to act on This is a variant so that we can act on threaded and non-threaded data.

Definition at line 79 of file RestartableDataIO.h.

Referenced by currentData(), and dataSize().

◆ _pg_moose_app

MooseApp& PerfGraphInterface::_pg_moose_app

protectedinherited

The MooseApp that owns the PerfGraph.

Definition at line 135 of file PerfGraphInterface.h.

Referenced by PerfGraphInterface::perfGraph().

◆ _prefix

const std::string PerfGraphInterface::_prefix

protectedinherited

A prefix to use for all sections.

Definition at line 138 of file PerfGraphInterface.h.

Referenced by PerfGraphInterface::timedSectionName().

◆ CURRENT_BACKUP_FILE_VERSION

const unsigned int RestartableDataIO::CURRENT_BACKUP_FILE_VERSION = 4

staticprotected

The current version for the backup file.

Definition at line 82 of file RestartableDataIO.h.

Referenced by RestartableDataReader::readHeader().

The documentation for this class was generated from the following files:

include/restart/RestartableDataIO.h
src/restart/RestartableDataIO.C

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Member Typedef Documentation

◆ COMPARE_HASH_CODE_TYPE

Constructor & Destructor Documentation

◆ RestartableDataIO() [1/2]

◆ RestartableDataIO() [2/2]

Member Function Documentation

◆ currentData()

◆ dataSize()

◆ getRestartableExt()

◆ perfGraph()

◆ registerTimedSection() [1/2]

◆ registerTimedSection() [2/2]

◆ restartableDataFile() [1/2]

◆ restartableDataFile() [2/2]

◆ restartableDataFolder()

◆ restartableHeaderFile() [1/2]

◆ restartableHeaderFile() [2/2]

◆ timedSectionName()

◆ validParams()

Member Data Documentation

◆ _data

◆ _pg_moose_app

◆ _prefix

◆ CURRENT_BACKUP_FILE_VERSION