Simulation Class Reference

Detailed Description

Definition at line 29 of file Simulation.h.

#include <Simulation.h>

Collaboration diagram for Simulation:

Public Member Functions
OGS_EXPORT_SYMBOL	Simulation (int argc, char *argv[])
OGS_EXPORT_SYMBOL void	initializeDataStructures (std::string const &project, std::vector< std::string > const &xml_patch_file_names, bool reference_path_is_set, std::string const &reference_path, bool nonfatal, std::string const &outdir, std::string const &mesh_dir, std::string const &script_dir, bool write_prj)
OGS_EXPORT_SYMBOL double	currentTime () const
OGS_EXPORT_SYMBOL double	endTime () const
OGS_EXPORT_SYMBOL bool	executeTimeStep ()
OGS_EXPORT_SYMBOL bool	executeSimulation ()
OGS_EXPORT_SYMBOL void	outputLastTimeStep () const
OGS_EXPORT_SYMBOL MeshLib::Mesh &	getMesh (std::string const &name)
OGS_EXPORT_SYMBOL std::optional< ApplicationsLib::TestDefinition >	getTestDefinition () const
OGS_EXPORT_SYMBOL	~Simulation ()

Static Public Member Functions
static OGS_EXPORT_SYMBOL int	runTestDefinitions (std::optional< ApplicationsLib::TestDefinition > &test_definition)

Private Attributes
ApplicationsLib::LinearSolverLibrarySetup	linear_solver_library_setup
vtkSmartPointer< vtkMPIController >	controller
std::unique_ptr< ProjectData >	project_data
std::optional< ApplicationsLib::TestDefinition >	test_definition
bool	isInsituConfigured = false

Constructor & Destructor Documentation

Simulation()

Simulation::Simulation	(	int	argc,
		char *	argv[] )

Definition at line 30 of file Simulation.cpp.

    : linear_solver_library_setup(argc, argv),
#if defined(USE_PETSC)
      controller(vtkSmartPointer<vtkMPIController>::New()),
#endif
      test_definition{std::nullopt}
{
#if defined(USE_PETSC)
    controller->Initialize(&argc, &argv, 1);
    vtkMPIController::SetGlobalController(controller);
#endif
}

References controller.

~Simulation()

Simulation::~Simulation

(

)

Definition at line 185 of file Simulation.cpp.

{
#ifdef OGS_USE_INSITU
    if (isInsituConfigured)
    {
        InSituLib::Finalize();
    }
#endif
#if defined(USE_PETSC)
    controller->Finalize(1);
#endif
}

References controller, InSituLib::Finalize(), and isInsituConfigured.

Member Function Documentation

currentTime()

double Simulation::currentTime

(

)

const

Definition at line 118 of file Simulation.cpp.

{
    auto const& time_loop = project_data->getTimeLoop();
    return time_loop.currentTime()();
}

References project_data.

endTime()

double Simulation::endTime

(

)

const

Definition at line 124 of file Simulation.cpp.

{
    auto const& time_loop = project_data->getTimeLoop();
    return time_loop.endTime()();
}

References project_data.

executeSimulation()

bool Simulation::executeSimulation

(

)

Definition at line 157 of file Simulation.cpp.

{
    INFO("Solve processes.");
    auto& time_loop = project_data->getTimeLoop();
    while (time_loop.currentTime() < time_loop.endTime())
    {
        time_loop.executeTimeStep();
        if (!time_loop.calculateNextTimeStep())
        {
            break;
        }
    }
 
    return time_loop.successful_time_step;
}

References INFO(), and project_data.

executeTimeStep()

bool Simulation::executeTimeStep

(

)

Definition at line 130 of file Simulation.cpp.

{
    auto& time_loop = project_data->getTimeLoop();
    if (time_loop.currentTime() < time_loop.endTime())
    {
        auto const result = time_loop.executeTimeStep();
        if (time_loop.calculateNextTimeStep())
        {
            time_loop.outputLastTimeStep();
        }
        return result;
    }
    return false;
}

References project_data.

getMesh()

MeshLib::Mesh & Simulation::getMesh

(

std::string const &

name

)

Definition at line 145 of file Simulation.cpp.

{
    return project_data->getMesh(name);
}

References project_data.

getTestDefinition()

std::optional< ApplicationsLib::TestDefinition > Simulation::getTestDefinition

(

)

const

Definition at line 179 of file Simulation.cpp.

{
    return test_definition;
}

References test_definition.

initializeDataStructures()

void Simulation::initializeDataStructures	(	std::string const &	project,
		std::vector< std::string > const &	xml_patch_file_names,
		bool	reference_path_is_set,
		std::string const &	reference_path,
		bool	nonfatal,
		std::string const &	outdir,
		std::string const &	mesh_dir,
		std::string const &	script_dir,
		bool	write_prj )

Input File Parameter

prj__test_definition

Input File Parameter

prj__insitu

Input File Parameter

prj__insitu__scripts

Definition at line 43 of file Simulation.cpp.

{
    INFO("Reading project file {}.",
         std::filesystem::relative(project).string());
    DBUG("Project file: {}.", std::filesystem::absolute(project).string());
 
    std::stringstream prj_stream;
    BaseLib::prepareProjectFile(prj_stream, project, xml_patch_file_names,
                                write_prj, outdir);
    auto project_config = BaseLib::makeConfigTree(
        project, !nonfatal, "OpenGeoSysProject", prj_stream);
 
    if (!reference_path_is_set)
    {  // Ignore the test_definition section.
        project_config.ignoreConfigParameter("test_definition");
    }
    else
    {
        test_definition = ApplicationsLib::TestDefinition(
            project_config.getConfigSubtree("test_definition"), reference_path,
            outdir);
        if (test_definition->numberOfTests() == 0)
        {
            OGS_FATAL(
                "No tests were constructed from the test definitions, "
                "but reference solutions path was given.");
        }
 
        INFO("Cleanup possible output files before running ogs.");
        BaseLib::removeFiles(test_definition->getOutputFiles());
    }
#ifdef OGS_USE_INSITU
    if (auto t = project_config.getConfigSubtreeOptional("insitu"))
    {
        InSituLib::Initialize(
            t->getConfigSubtree("scripts"),
            BaseLib::extractPath(project));
        isInsituConfigured = true;
    }
#else
    project_config.ignoreConfigParameter("insitu");
#endif
 
    project_data = std::make_unique<ProjectData>(project_config,
                                                 BaseLib::getProjectDirectory(),
                                                 outdir, mesh_dir, script_dir);
 
    INFO("Initialize processes.");
    for (auto& p : project_data->getProcesses())
    {
        p->initialize(project_data->getMedia());
    }
 
    // Check intermediately that config parsing went fine.
    checkAndInvalidate(project_config);
    BaseLib::ConfigTree::assertNoSwallowedErrors();
 
    auto& time_loop = project_data->getTimeLoop();
    auto time_value = time_loop.currentTime()();
    INFO("Time step #0 started. Time: {}. Step size: 0.", time_value);
 
    BaseLib::RunTime init_timer;
    init_timer.start();
    time_loop.initialize();
    INFO("Time step #0 took {:g} s.", init_timer.elapsed());
}

References BaseLib::ConfigTree::assertNoSwallowedErrors(), DBUG(), BaseLib::RunTime::elapsed(), BaseLib::extractPath(), BaseLib::getProjectDirectory(), INFO(), InSituLib::Initialize(), isInsituConfigured, BaseLib::makeConfigTree(), OGS_FATAL, BaseLib::prepareProjectFile(), project_data, BaseLib::removeFiles(), BaseLib::RunTime::start(), and test_definition.

outputLastTimeStep()

void Simulation::outputLastTimeStep

(

)

const

Definition at line 173 of file Simulation.cpp.

{
    auto const& time_loop = project_data->getTimeLoop();
    time_loop.outputLastTimeStep();
}

References project_data.

runTestDefinitions()

int Simulation::runTestDefinitions ( std::optional< ApplicationsLib::TestDefinition > & test_definition )

static

Definition at line 198 of file Simulation.cpp.

{
    if (!test_definition)
    {
        auto const end_time = std::chrono::system_clock::now();
        auto const time_str = BaseLib::formatDate(end_time);
        DBUG("No test definition was found. No tests will be executed.");
        INFO("OGS completed on {:s}.", time_str);
        return EXIT_SUCCESS;
    }
 
    INFO("");
    INFO("##########################################");
    INFO("# Running tests                          #");
    INFO("##########################################");
    INFO("");
    auto status = test_definition->runTests();
    auto const end_time = std::chrono::system_clock::now();
    auto const time_str = BaseLib::formatDate(end_time);
    if (status)
    {
        INFO("OGS completed on {:s}.", time_str);
    }
    else
    {
        ERR("OGS terminated on {:s}. One of the tests failed.", time_str);
        return EXIT_FAILURE;
    }
    return EXIT_SUCCESS;
}

References DBUG(), ERR(), BaseLib::formatDate(), INFO(), and test_definition.

Referenced by executeSimulation(), and main().

Member Data Documentation

controller

vtkSmartPointer<vtkMPIController> Simulation::controller

private

Definition at line 59 of file Simulation.h.

Referenced by Simulation(), and ~Simulation().

isInsituConfigured

bool Simulation::isInsituConfigured = false

private

Definition at line 64 of file Simulation.h.

Referenced by ~Simulation(), and initializeDataStructures().

linear_solver_library_setup

ApplicationsLib::LinearSolverLibrarySetup Simulation::linear_solver_library_setup

private

Definition at line 57 of file Simulation.h.

project_data

std::unique_ptr<ProjectData> Simulation::project_data

private

Definition at line 61 of file Simulation.h.

Referenced by currentTime(), endTime(), executeSimulation(), executeTimeStep(), getMesh(), initializeDataStructures(), and outputLastTimeStep().

test_definition

std::optional<ApplicationsLib::TestDefinition> Simulation::test_definition

private

Definition at line 62 of file Simulation.h.

Referenced by getTestDefinition(), initializeDataStructures(), and runTestDefinitions().

---

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

• Applications/ApplicationsLib/Simulation.h
• Applications/ApplicationsLib/Simulation.cpp