group_norm_module.hpp

Go to the documentation of this file.

 
#pragma once
 
#include <optional>
#include <initializer_list>
#include <vector>
 
#include "pulsatrix/module.hpp"
 
namespace pulsatrix {
 
class GroupNormModule : public Module {
public:
    GroupNormModule(int64_t num_groups, int64_t num_channels, DeviceBackend* backend,
                     DeviceType device, float eps = 1e-6f);
 
    GroupNormModule(int64_t num_groups, int64_t num_channels, DeviceBackend* backend);
 
    [[nodiscard]] Tensor backward(const Tensor& grad_output) override;
 
    [[nodiscard]] OpType op_type() const override { return OpType::Normalization; }
 
    void set_gamma(std::initializer_list<float> values);
    void set_beta(std::initializer_list<float> values);
    void set_gamma(const std::vector<float>& values);
    void set_beta(const std::vector<float>& values);
 
    [[nodiscard]] const Tensor& gamma() const { return gamma_; }
    [[nodiscard]] const Tensor& beta() const { return beta_; }
    [[nodiscard]] const Tensor& gamma_grad() const { return gamma_grad_; }
    [[nodiscard]] const Tensor& beta_grad() const { return beta_grad_; }
 
    [[nodiscard]] Tensor propagate_relevance(const Tensor& relevance_out, const LRPRuleConfig& config) override;
 
    [[nodiscard]] std::vector<NamedParamRef> named_parameters() override {
        return {{"weight", {&gamma_, &gamma_grad_}}, {"bias", {&beta_, &beta_grad_}}};
    }
 
 
    [[nodiscard]] std::optional<DeviceType> compute_device() const override { return gamma_.device(); }
 
protected:
    [[nodiscard]] Tensor forward_impl(const Tensor& input) override;
 
private:
    int64_t num_groups_;
    int64_t num_channels_;
    int64_t group_size_;
    float eps_;
    DeviceBackend* backend_;
    Tensor gamma_;       // shape (num_channels,)
    Tensor beta_;        // shape (num_channels,)
    Tensor gamma_grad_;
    Tensor beta_grad_;
    Tensor last_input_;      // (N, num_channels, H, W)
    Tensor last_xhat_;       // (N, num_channels, H, W)
    Tensor last_group_std_;  // (N, num_groups), on the module's device
    int64_t last_h_ = 0;
    int64_t last_w_ = 0;
    bool has_forwarded_ = false;
};
 
}  // namespace pulsatrix