contrast.hpp

Go to the documentation of this file.

// toolboxes/image/include/nk/image/contrast/contrast.hpp
// Histogram-based contrast operations.
 
#pragma once
 
#include <memory_resource>
#include <nk/value/span.hpp>
#include <nk/value/value.hpp>
 
#include <string>
#include <tuple>
 
namespace nk::image {

 

std::tuple<Value, Value>
imhist(const Value &I, int n, std::pmr::memory_resource *mr = nullptr);

Value stretchlim(const Value &I, double low_tol, double high_tol,
                 std::pmr::memory_resource *mr = nullptr);

Value imadjust(const Value &I,
               double low_in, double high_in,
               double low_out, double high_out,
               double gamma,
               std::pmr::memory_resource *mr = nullptr);

Value adaptthresh(const Value &I, double sensitivity, int neighborhood,
                  const std::string &statistic,
                  std::pmr::memory_resource *mr = nullptr);

Value histeq(const Value &I, int n,
             std::pmr::memory_resource *mr = nullptr);

struct AdaptHistEqOptions {
    int          numTilesR    = 8;

    int          numTilesC    = 8;

    double       clipLimit    = 0.01;

    int          nBins        = 256;

    std::string  distribution = "uniform";

    double       alpha        = 0.4;

    std::string  range        = "full";
};

Value adapthisteq(const Value &                I,
                  const AdaptHistEqOptions &   opts = {},
                  std::pmr::memory_resource *  mr   = nullptr);
 
// ── Thresholding ──────────────────────────────────────────────────────

std::tuple<Value, Value>
graythresh(const Value &I, std::pmr::memory_resource *mr = nullptr);

std::tuple<Value, Value>
otsuthresh(const Value &counts,
           std::pmr::memory_resource *mr = nullptr);

std::tuple<Value, Value>
multithresh(const Value &I, int N,
            std::pmr::memory_resource *mr = nullptr);

Value imbinarize(const Value &I, double thresh,
                 std::pmr::memory_resource *mr = nullptr);

Value imbinarize(const Value &I, const Value &T,
                 std::pmr::memory_resource *mr = nullptr);

Value imquantize(const Value &I, const Value &levels,
                 std::pmr::memory_resource *mr = nullptr);

Value imhistmatch(const Value &I, const Value &ref, int nbins,
                  Value *hgramOut = nullptr,
                  std::pmr::memory_resource *mr = nullptr);

Value imflatfield(const Value &I, double sigma, const Value &mask,
                  std::pmr::memory_resource *mr = nullptr);

Value wcodemat(const Value &X, int nb, const std::string &opt, int absol,
               std::pmr::memory_resource *mr = nullptr);

Value entropy(const Value &I, int nbins,
              std::pmr::memory_resource *mr = nullptr);

Value grayslice(const Value &I, int N,
                std::pmr::memory_resource *mr = nullptr);

Value grayslice(const Value &I, Span<const double> levels,
                std::pmr::memory_resource *mr = nullptr);
 

} // namespace nk::image