advantage.hpp
advantage/advantage.hpp · 45 line(s) · c
// advantage.hpp - C++ wrapper over the C advantage module.
//
// Offers a small, STL-friendly API on top of the C core so C++ callers
// can work with std::vector instead of raw pointers.
#ifndef ADVANTAGE_HPP
#define ADVANTAGE_HPP
#include <vector>
#include "advantage.h"
namespace advantage {
// Single weighted advantage value (thin wrapper over advantage_value).
inline double value(double reward, double baseline, double weight = 1.0) {
return advantage_value(reward, baseline, weight);
}
// Mean advantage over two equally-sized series. If the vectors differ in
// length, the shorter length is used; an empty input yields 0.0.
inline double mean(const std::vector<double>& rewards,
const std::vector<double>& baselines,
double weight = 1.0) {
const std::size_t count =
rewards.size() < baselines.size() ? rewards.size() : baselines.size();
return advantage_mean(rewards.data(), baselines.data(), count, weight);
}
// Like mean(), but refuses mismatched series instead of silently truncating
// to the shorter one. Returns false (and leaves `out` untouched) when the
// lengths differ; an empty pair of series is valid and yields 0.0.
inline bool mean_checked(const std::vector<double>& rewards,
const std::vector<double>& baselines,
double weight,
double& out) {
if (rewards.size() != baselines.size()) return false;
out = advantage_mean(rewards.data(), baselines.data(), rewards.size(),
weight);
return true;
}
} // namespace advantage
#endif // ADVANTAGE_HPP