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::vector< std::string >	getMeshNames () const

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 187 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 159 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.

Referenced by main().

◆ 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();
        time_loop.calculateNextTimeStep();
        return result;
    }
    return false;
}

References project_data.

◆ getMesh()

MeshLib::Mesh & Simulation::getMesh ( std::string const & name )

Definition at line 142 of file Simulation.cpp.

{
    return project_data->getMesh(name);
}

References project_data.

◆ getMeshNames()

std::vector< std::string > Simulation::getMeshNames ( ) const

Definition at line 147 of file Simulation.cpp.

{
    return project_data->getMeshNames();
}

References project_data.

◆ getTestDefinition()

std::optional< ApplicationsLib::TestDefinition > Simulation::getTestDefinition ( ) const

Definition at line 181 of file Simulation.cpp.

{
    return test_definition;
}

References test_definition.

Referenced by main().

◆ 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.

Referenced by main().

◆ outputLastTimeStep()

void Simulation::outputLastTimeStep ( ) const

Definition at line 175 of file Simulation.cpp.

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

References project_data.

Referenced by main().

◆ runTestDefinitions()

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

static

Definition at line 200 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 OGSSimulation::executeSimulation(), and main().

Member Data Documentation

◆ controller

vtkSmartPointer<vtkMPIController> Simulation::controller

private

Definition at line 60 of file Simulation.h.

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

◆ isInsituConfigured

bool Simulation::isInsituConfigured = false

private

Definition at line 65 of file Simulation.h.

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

◆ linear_solver_library_setup

ApplicationsLib::LinearSolverLibrarySetup Simulation::linear_solver_library_setup

private

Definition at line 58 of file Simulation.h.

◆ project_data

std::unique_ptr<ProjectData> Simulation::project_data

private

Definition at line 62 of file Simulation.h.

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

◆ test_definition

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

private

Definition at line 63 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

Detailed Description

Public Member Functions

Static Public Member Functions

Private Attributes

Constructor & Destructor Documentation

◆ Simulation()

◆ ~Simulation()

Member Function Documentation

◆ currentTime()

◆ endTime()

◆ executeSimulation()

◆ executeTimeStep()

◆ getMesh()

◆ getMeshNames()

◆ getTestDefinition()

◆ initializeDataStructures()

◆ outputLastTimeStep()

◆ runTestDefinitions()

Member Data Documentation

◆ controller

◆ isInsituConfigured

◆ linear_solver_library_setup

◆ project_data

◆ test_definition