OpenSWMM Engine  6.0.0-alpha.4
Data-oriented, plugin-extensible SWMM Engine (6.0.0-alpha.4)
Loading...
Searching...
No Matches
GeoPackageReportPlugin.hpp
Go to the documentation of this file.
1// SPDX-License-Identifier: Apache-2.0
2//
3// Copyright 2026 Caleb Buahin
4//
5// Licensed under the Apache License, Version 2.0 (the "License");
6// you may not use this file except in compliance with the License.
7// You may obtain a copy of the License at
8//
9// http://www.apache.org/licenses/LICENSE-2.0
10//
11// Unless required by applicable law or agreed to in writing, software
12// distributed under the License is distributed on an "AS IS" BASIS,
13// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14// See the License for the specific language governing permissions and
15// limitations under the License.
16
26
27#ifndef OPENSWMM_GEOPACKAGE_REPORT_PLUGIN_HPP
28#define OPENSWMM_GEOPACKAGE_REPORT_PLUGIN_HPP
29
30#include "GpkgUtils.hpp"
32#include <string>
33#include <unordered_map>
34
35namespace openswmm::gpkg {
36
38public:
40
41 PluginState state() const noexcept override { return state_; }
42
43 int initialize(const std::vector<std::string>& init_args,
44 const IPluginComponentInfo* info) override;
45
46 int validate(const SimulationContext& ctx) override;
47 int prepare(const SimulationContext& ctx) override;
48 int update(const SimulationSnapshot& snapshot) override;
49 int write_summary(const SimulationContext& ctx) override;
50 int finalize(const SimulationContext& ctx) override;
51
52 const char* last_error_message() const noexcept override {
53 return error_msg_.c_str();
54 }
55
56private:
58 std::string error_msg_;
59 std::string db_path_;
60 std::string simulation_id_;
61 DbPtr db_;
62
63 std::unordered_map<std::string, int> variable_ids_;
64 int lookup_variable(const std::string& name, const std::string& obj_type);
65};
66
67} // namespace openswmm::gpkg
68
69#endif // OPENSWMM_GEOPACKAGE_REPORT_PLUGIN_HPP
RAII wrappers and utilities for SQLite operations in GeoPackage I/O.
Interface for report-writing plugins.
Describes a plugin component: metadata, capabilities, and factory methods.
Definition IPluginComponentInfo.hpp:195
Interface for report-writing plugins.
Definition IReportPlugin.hpp:61
const char * last_error_message() const noexcept override
Get the last error message.
Definition GeoPackageReportPlugin.hpp:52
int write_summary(const SimulationContext &ctx) override
Write the final summary report. Called from main thread.
Definition GeoPackageReportPlugin.cpp:58
PluginState state() const noexcept override
Query the current plugin state.
Definition GeoPackageReportPlugin.hpp:41
int validate(const SimulationContext &ctx) override
Validate configuration against the loaded model.
Definition GeoPackageReportPlugin.cpp:29
int prepare(const SimulationContext &ctx) override
Open report file(s) and write any headers.
Definition GeoPackageReportPlugin.cpp:34
int update(const SimulationSnapshot &snapshot) override
Accumulate data from one output step. Called from IO thread.
Definition GeoPackageReportPlugin.cpp:54
int initialize(const std::vector< std::string > &init_args, const IPluginComponentInfo *info) override
Definition GeoPackageReportPlugin.cpp:17
int finalize(const SimulationContext &ctx) override
Flush and close report file(s).
Definition GeoPackageReportPlugin.cpp:137
PluginState
Plugin lifecycle states.
Definition PluginState.hpp:83
@ UNLOADED
Library not yet loaded (or was closed).
Definition PluginState.hpp:84
Definition ExternalContentReader.cpp:49
std::unique_ptr< sqlite3, DbDeleter > DbPtr
Definition GpkgUtils.hpp:58
Complete simulation state snapshot at one output time step.
Definition SimulationSnapshot.hpp:117
Central, reentrant simulation context.
Definition SimulationContext.hpp:353