transforms/vision/cutout.hpp

Go to the documentation of this file.

// Copyright (c) 2014-2023, Lawrence Livermore National Security, LLC.
// Produced at the Lawrence Livermore National Laboratory.
// Written by the LBANN Research Team (B. Van Essen, et al.) listed in
// the CONTRIBUTORS file. <lbann-dev@llnl.gov>
//
// LLNL-CODE-697807.
// All rights reserved.
//
// This file is part of LBANN: Livermore Big Artificial Neural Network
// Toolkit. For details, see http://software.llnl.gov/LBANN or
// https://github.com/LLNL/LBANN.
//
// Licensed under the Apache License, Version 2.0 (the "Licensee"); you
// may not use this file except in compliance with the License.  You may
// obtain a copy of the License at:
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
// implied. See the License for the specific language governing
// permissions and limitations under the license.

#ifndef LBANN_TRANSFORMS_CUTOUT_HPP_INCLUDED
#define LBANN_TRANSFORMS_CUTOUT_HPP_INCLUDED

#include "lbann/transforms/transform.hpp"

#include <google/protobuf/message.h>

namespace lbann {
namespace transform {

class cutout : public transform
{
public:
  cutout(size_t num_holes, size_t length)
    : transform(), m_num_holes(num_holes), m_length(length)
  {
    if (num_holes == 0) {
      LBANN_ERROR("num_holes must be positive, got 0");
    }
    if (length == 0) {
      LBANN_ERROR("length must be positive, got 0");
    }
  }

  transform* copy() const override { return new cutout(*this); }

  std::string get_type() const override { return "cutout"; }

  void apply(utils::type_erased_matrix& data,
             std::vector<size_t>& dims) override;

private:
  size_t m_num_holes;
  size_t m_length;
};

std::unique_ptr<transform>
build_cutout_transform_from_pbuf(google::protobuf::Message const&);

} // namespace transform
} // namespace lbann

#endif // LBANN_TRANSFORMS_CUTOUT_HPP_INCLUDED