## On this page
# simulation\_framework::evaluator::GtBaseEvaluator Class Reference
Last update: 16.07.2025
This is the implementation of IEvaluator interface and provides users ability to evaluate KPIs that are added by themselves. This class controls all KPIs centrally and fill/reset the KpiMessage accordingly based on each KPI's calculation result. [More...](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#details)
`#include <gt_base_evaluator.h>`
Inheritance diagram for simulation_framework::evaluator::GtBaseEvaluator:
\[[legend](graph_legend.xhtml)\]
Collaboration diagram for simulation_framework::evaluator::GtBaseEvaluator:
\[[legend](graph_legend.xhtml)\]
## Public Member Functions
void [Init](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#a930cb234264aa995b30eab8c537a15ad) () void [Reset](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#acacfb885fab2f83b114e870fa9433f3d) () void [Evaluate](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#a09b8959aaaacce2b842abfd304b63674) () void [AddKpi](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#aad43fb627edc44c2c903bf61feed81c8) (std::unique\_ptr< [core::kpi::IKpi](classsimulation__framework_1_1core_1_1kpi_1_1IKpi.xhtml)< avx\_osi3::GroundTruth >> kpi) override core::kpi::KpiMessage [GetKpiMessage](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#a2e37677f4b8884d78f028589c6adac48) () const void [SetInput](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#ae1381e0cf898286fd4738c4dcfe5577c) (const avx\_osi3::GroundTruth &ground\_truth)  Public Member Functions inherited from [simulation\_framework::core::evaluator::IEvaluator< avx\_osi3::GroundTruth >](classsimulation__framework_1_1core_1_1evaluator_1_1IEvaluator.xhtml)virtual void **AddKpi** (std::unique\_ptr< [kpi::IKpi](classsimulation__framework_1_1core_1_1kpi_1_1IKpi.xhtml)< avx\_osi3::GroundTruth >> kpi)=0 virtual core::kpi::KpiMessage [GetKpiMessage](classsimulation__framework_1_1core_1_1evaluator_1_1IEvaluator.xhtml#a4ab336b9b848abd1324b4c779b8e4ed6) () const=0 ## Detailed Description
This is the implementation of IEvaluator interface and provides users ability to evaluate KPIs that are added by themselves. This class controls all KPIs centrally and fill/reset the KpiMessage accordingly based on each KPI's calculation result.
To join the simulation, the evaluator must be injected into an Activity and required KPIs need to be added using [AddKpi(std::unique\_ptr<core::kpi::IKpi<avx\_osi3::GroundTruth>> kpi)](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#aad43fb627edc44c2c903bf61feed81c8).
Example of creating one customized KpiEvaluatorActivity containing 2 KPIs and publish the KpiMessage into KpiLoggerTopic to have the KPI results in output json
class MyFirstKpi : public core::kpi::IKpi<avx_osi3::GroundTruth>
{
public:
MyFirstKpi(const std::string& kpi_name): kpi_name_(kpi_name) {}
void [Init](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#a930cb234264aa995b30eab8c537a15ad)() override {}
void [Reset](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#acacfb885fab2f83b114e870fa9433f3d)() override {}
kpi::KpiContent CalculateKpi(const avx_osi3::GroundTruth& ground_truth) override
{
kpi::KpiContent [kpi](namespacekpi.xhtml);
return [kpi](namespacekpi.xhtml);
}
kpi::Type GetKpiType() const override { return kpi::Type::kScalar; }
};
class MySecondKpi : public [core](namespacecore.xhtml):kpi::IKpi<avx_osi3::GroundTruth> {
class MyKpiEvaluatorActivity : public BaseActivity
{
public:
MyKpiEvaluatorActivity(const std::string& name,
const Topics& topics,
evaluator::std::unique_ptr<kpi::IKpiMessageConverter> kpi_message_converter,
std::unique_ptr<core::evaluator::IEvaluator<avx_osi3::GroundTruth>> evaluator)
: BaseActivity(name, topics),
kpi_message_converter_(std::move(kpi_message_converter)),
evaluator_(std::move(evaluator))
{
evaluator_->Init();
}
~MyKpiEvaluatorActivity() = default;
void AddPublisherAndSubscriber() override
{
AddSubscriber<core::Topic<rtidds::GenericBytesMessage>>(
"SensorViewTopic", [&](const rtidds::GenericBytesMessage& sv_bytes_msg) {
if (!osi_proto_sv_.ParseFromArray(sv_bytes_msg.bytes_array().data(), sv_bytes_msg.size()))
{
throw std::runtime_error(
"\[MyKpiEvaluatorActivity\]: Error parsing "
"osi proto msg from bytes array!");
}
});
AddPublisher<core::Topic<rtidds::KpiMessage>>("KpiLoggerTopic", [&]() {
const auto dds_kpi_message = kpi_message_converter_->ConvertToDds(kpi_message_);
return dds_kpi_message;
});
}
void ExecuteStep() override
{
evaluator_->SetInput(osi_proto_sv_.global_ground_truth());
evaluator_->Evaluate();
kpi_message_ = evaluator_->GetKpiMessage();
}
private:
evaluator::std::unique_ptr<kpi::IKpiMessageConverter> kpi_message_converter_;
std::unique_ptr<core::evaluator::IEvaluator<avx_osi3::GroundTruth>>evaluator_;
core::kpi::KpiMessage kpi_message_;
avx_osi3::SensorView osi_proto_sv_{};
};
auto my_first_kpi = std::make_unique<MyFirstKpi>("kpi\_1");
auto my_second_kpi = std::make_unique<MySecondKpi>("kpi\_2");
auto evaluator = std::make_unique<simulation_framework::evaluator::BaseEvaluator>();
evaluator->AddKpi(std::move(my_first_kpi));
evaluator->AddKpi(std::move(my_second_kpi));
auto kpi_message_converter = std::make_unique<core::kpi::KpiMessageConverter>();
auto my_kpi_evaluator_activity = std::make_unique<MyKpiEvaluatorActivity>(
"MyKpiEvaluatorActivity",
Topics{topic_registry::GetExistingTopicById("SensorViewTopic"),
topic_registry::GetExistingTopicById("KpiLoggerTopic")},
std::move(kpi_message_converter),
std::move(evaluator));
## Member Function Documentation
## [◆ ](#aad43fb627edc44c2c903bf61feed81c8)AddKpi()
void simulation\_framework::evaluator::GtBaseEvaluator::AddKpi ( std::unique\_ptr< [core::kpi::IKpi](classsimulation__framework_1_1core_1_1kpi_1_1IKpi.xhtml)< avx\_osi3::GroundTruth >> *kpi*) override
Add one KPI into this evaluator
Parameters kpiThe iKpi interface
## [◆ ](#a09b8959aaaacce2b842abfd304b63674)Evaluate()
void simulation\_framework::evaluator::GtBaseEvaluator::Evaluate ( ) virtual
Calculate all KPIs (call all kpi->CalculateKpi(gt);) which are added in this evaluator and fill the KpiMessage
Implements [simulation\_framework::core::evaluator::IEvaluator< avx\_osi3::GroundTruth >](classsimulation__framework_1_1core_1_1evaluator_1_1IEvaluator.xhtml#ab083ec7f04182794f04d9bb5a3c0b133).
## [◆ ](#a2e37677f4b8884d78f028589c6adac48)GetKpiMessage()
core::kpi::KpiMessage simulation\_framework::evaluator::GtBaseEvaluator::GetKpiMessage ( ) const
Get the filled KPI messages based on calculation of all KPIs
ReturnsA kpi::KpiMessage object, the vector of KpiContent represents of all added KPIs into this evaluator
## [◆ ](#a930cb234264aa995b30eab8c537a15ad)Init()
void simulation\_framework::evaluator::GtBaseEvaluator::Init ( ) virtual
Initial all KPIs (call all kpi->[Init()](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#a930cb234264aa995b30eab8c537a15ad);) which are added in this evaluator
Implements [simulation\_framework::core::evaluator::IEvaluator< avx\_osi3::GroundTruth >](classsimulation__framework_1_1core_1_1evaluator_1_1IEvaluator.xhtml#aa81af246c9cf88d00c9b07453fee6ae2).
## [◆ ](#acacfb885fab2f83b114e870fa9433f3d)Reset()
void simulation\_framework::evaluator::GtBaseEvaluator::Reset ( ) virtual
Clear KpiMessage and reset all KPIs (call all kpi->[Reset()](classsimulation__framework_1_1evaluator_1_1GtBaseEvaluator.xhtml#acacfb885fab2f83b114e870fa9433f3d);) which are added in this evaluator
Implements [simulation\_framework::core::evaluator::IEvaluator< avx\_osi3::GroundTruth >](classsimulation__framework_1_1core_1_1evaluator_1_1IEvaluator.xhtml#a072a25b43d319d2f7b9dc6c50076b432).
## [◆ ](#ae1381e0cf898286fd4738c4dcfe5577c)SetInput()
void simulation\_framework::evaluator::GtBaseEvaluator::SetInput ( const avx\_osi3::GroundTruth & *ground\_truth*) virtual
Set GroundTruth message for KPI calculations
Parameters ground\_truthThe osi groundtruth type in protobuf Implements [simulation\_framework::core::evaluator::IEvaluator< avx\_osi3::GroundTruth >](classsimulation__framework_1_1core_1_1evaluator_1_1IEvaluator.xhtml#aec46af76fd3c4388b18ef093baaebe28).
---
The documentation for this class was generated from the following file:- [gt\_base\_evaluator.h](gt__base__evaluator_8h_source.xhtml)