lsst::gauss2d::Image< T, C > Class Template Reference

A 2D image with scalar numeric values, using CRTP. More...

#include <image.h>

Inheritance diagram for lsst::gauss2d::Image< T, C >:

Public Member Functions
	Image (size_t n_rows, size_t n_cols, const T *value_init=_value_default_ptr(), std::shared_ptr< const CoordinateSystem > coordsys=nullptr)=delete
	Image (std::shared_ptr< const CoordinateSystem > coordsys=nullptr)
	~Image ()=default
T &	_get_value (size_t row, size_t col)
T &	_get_value_impl (size_t row, size_t col)
T &	_get_value_unchecked (size_t row, size_t col)
T &	_get_value_unchecked_impl (size_t row, size_t col)=delete
void	_check_row_col (size_t row, size_t col) const
void	_check_row_col_impl (size_t row, size_t col) const
const CoordinateSystem &	get_coordsys () const
std::shared_ptr< const CoordinateSystem >	get_coordsys_ptr_const () const
size_t	get_n_cols () const
size_t	get_n_cols_impl () const =delete
size_t	get_n_rows () const
size_t	get_n_rows_impl ()=delete
void	add_value (size_t row, size_t col, T value)
void	add_value_impl (size_t row, size_t col, T value)
void	add_value_unchecked (size_t row, size_t col, T value)
void	add_value_unchecked_impl (size_t row, size_t col, T value)
void	fill (T value)
void	fill_impl (T value)
T	get_value (size_t row, size_t col) const
T	get_value_impl (size_t row, size_t col) const
T	get_value_unchecked (size_t row, size_t col) const
T	get_value_unchecked_impl (size_t row, size_t col) const =delete
void	set_value (size_t row, size_t col, T value)
void	set_value_impl (size_t row, size_t col, T value)
void	set_value_unchecked (size_t row, size_t col, T value)
void	set_value_unchecked_impl (size_t row, size_t col, T value)
std::array< size_t, 2 >	shape () const
size_t	size () const
std::string	repr (bool name_keywords, std::string_view namespace_separator) const override
	Return a full, callable string representation of this.
std::string	str () const override
	Return a brief, human-readable string representation of this.
Image< T, C > &	operator+= (T value)
Image< T, C > &	operator*= (T value)
bool	operator== (const Image &other) const
const bool	operator!= (const Image &other) const

Static Public Member Functions
static const T *	_value_default_ptr ()
static std::string_view	null_str (const std::string_view &namespace_separator)

Static Public Attributes
static constexpr T	_value_default = 0
static constexpr std::string_view	CC_NAMESPACE_SEPARATOR = "::"
	The C++ namespace separator.
static constexpr std::string_view	NULL_STR_GENERAL = "None"
static constexpr std::string_view	PY_NAMESPACE_SEPARATOR = "."

Detailed Description

template<typename T, class C>
class lsst::gauss2d::Image< T, C >

A 2D image with scalar numeric values, using CRTP.

Basic implementations of most functions are provided. Derived classes should override any and all if the default implementations are not efficient enough.

Template Parameters

t	The numeric type.
C	The specialized class.

Definition at line 107 of file image.h.

Constructor & Destructor Documentation

Image() [1/2]

template<typename T , class C >

lsst::gauss2d::Image< T, C >::Image ( size_t n_rows, size_t n_cols, const T * value_init = _value_default_ptr(), std::shared_ptr< const CoordinateSystem > coordsys = nullptr )

explicitdelete

Image() [2/2]

template<typename T , class C >

lsst::gauss2d::Image< T, C >::Image ( std::shared_ptr< const CoordinateSystem > coordsys = nullptr )

inlineexplicit

Definition at line 115 of file image.h.

            : _coordsys_ptr(coordsys == nullptr ? nullptr : std::move(coordsys)),
              _coordsys(_coordsys_ptr == nullptr ? COORDS_DEFAULT : *_coordsys_ptr) {}

~Image()

template<typename T , class C >

lsst::gauss2d::Image< T, C >::~Image ( )

default

Member Function Documentation

_check_row_col()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::_check_row_col ( size_t row, size_t col ) const

inline

Definition at line 133 of file image.h.

{ return self_const()._check_row_col_impl(row, col); }

_check_row_col_impl()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::_check_row_col_impl ( size_t row, size_t col ) const

inline

Definition at line 134 of file image.h.

                                                           {
        if (!((row < this->get_n_rows()) && (col < this->get_n_cols()))) {
            throw std::out_of_range("row,col = " + std::to_string(row) + "," + std::to_string(col)
                                    + " n_rows,n_cols = " + std::to_string(this->get_n_rows()) + ","
                                    + std::to_string(this->get_n_cols()));
        }
    }

_get_value()

template<typename T , class C >

T & lsst::gauss2d::Image< T, C >::_get_value ( size_t row, size_t col )

inline

Definition at line 123 of file image.h.

{ return static_cast<C&>(*this)._get_value_impl(row, col); }

_get_value_impl()

template<typename T , class C >

T & lsst::gauss2d::Image< T, C >::_get_value_impl ( size_t row, size_t col )

inline

Definition at line 124 of file image.h.

                                               {
        _check_row_col(row, col);
        return this->_get_value_unchecked(row, col);
    }

_get_value_unchecked()

template<typename T , class C >

T & lsst::gauss2d::Image< T, C >::_get_value_unchecked ( size_t row, size_t col )

inline

Definition at line 128 of file image.h.

                                                           {
        return self()._get_value_unchecked_impl(row, col);
    }

_get_value_unchecked_impl()

template<typename T , class C >

T & lsst::gauss2d::Image< T, C >::_get_value_unchecked_impl ( size_t row, size_t col )

inlinedelete

_value_default_ptr()

template<typename T , class C >

static const T * lsst::gauss2d::Image< T, C >::_value_default_ptr ( )

inlinestatic

Definition at line 121 of file image.h.

{ return &_value_default; };

add_value()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::add_value ( size_t row, size_t col, T value )

inline

Definition at line 150 of file image.h.

{ self().add_value_impl(row, col, value); }

add_value_impl()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::add_value_impl ( size_t row, size_t col, T value )

inline

Definition at line 151 of file image.h.

{ this->_get_value(row, col) += value; }

add_value_unchecked()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::add_value_unchecked ( size_t row, size_t col, T value )

inline

Definition at line 152 of file image.h.

                                                              {
        self().add_value_unchecked_impl(row, col, value);
    }

add_value_unchecked_impl()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::add_value_unchecked_impl ( size_t row, size_t col, T value )

inline

Definition at line 155 of file image.h.

                                                                   {
        self()._get_value_unchecked(row, col) += value;
    }

fill()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::fill ( T value )

inline

Definition at line 158 of file image.h.

{ self().fill_impl(value); }

fill_impl()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::fill_impl ( T value )

inline

Definition at line 159 of file image.h.

                            {
        const size_t n_rows = get_n_rows();
        const size_t n_cols = get_n_cols();
        for (size_t row = 0; row < n_rows; ++row) {
            for (size_t col = 0; col < n_cols; ++col) {
                this->set_value_unchecked(row, col, value);
            }
        }
    }

get_coordsys()

template<typename T , class C >

const CoordinateSystem & lsst::gauss2d::Image< T, C >::get_coordsys ( ) const

inline

Definition at line 142 of file image.h.

{ return _coordsys; };

get_coordsys_ptr_const()

template<typename T , class C >

std::shared_ptr< const CoordinateSystem > lsst::gauss2d::Image< T, C >::get_coordsys_ptr_const ( ) const

inline

Definition at line 143 of file image.h.

{ return _coordsys_ptr; };

get_n_cols()

template<typename T , class C >

size_t lsst::gauss2d::Image< T, C >::get_n_cols ( ) const

inline

Definition at line 145 of file image.h.

{ return static_cast<const C&>(*this).get_n_cols_impl(); }

get_n_cols_impl()

template<typename T , class C >

size_t lsst::gauss2d::Image< T, C >::get_n_cols_impl ( ) const

delete

get_n_rows()

template<typename T , class C >

size_t lsst::gauss2d::Image< T, C >::get_n_rows ( ) const

inline

Definition at line 147 of file image.h.

{ return static_cast<const C&>(*this).get_n_rows_impl(); }

get_n_rows_impl()

template<typename T , class C >

size_t lsst::gauss2d::Image< T, C >::get_n_rows_impl ( )

delete

get_value()

template<typename T , class C >

T lsst::gauss2d::Image< T, C >::get_value ( size_t row, size_t col ) const

inline

Definition at line 168 of file image.h.

{ return self_const().get_value_impl(row, col); }

get_value_impl()

template<typename T , class C >

T lsst::gauss2d::Image< T, C >::get_value_impl ( size_t row, size_t col ) const

inline

Definition at line 169 of file image.h.

                                                          {
        _check_row_col(row, col);
        return self_const().get_value_unchecked(row, col);
    }

get_value_unchecked()

template<typename T , class C >

T lsst::gauss2d::Image< T, C >::get_value_unchecked ( size_t row, size_t col ) const

inline

Definition at line 173 of file image.h.

                                                               {
        return self_const().get_value_unchecked_impl(row, col);
    }

get_value_unchecked_impl()

template<typename T , class C >

T lsst::gauss2d::Image< T, C >::get_value_unchecked_impl ( size_t row, size_t col ) const

inlinedelete

null_str()

static std::string_view lsst::gauss2d::Object::null_str ( const std::string_view & namespace_separator )

inlinestaticinherited

Definition at line 49 of file object.h.

                                                                              {
        return namespace_separator == CC_NAMESPACE_SEPARATOR ? "nullptr" : NULL_STR_GENERAL;
    }

operator!=()

template<typename T , class C >

const bool lsst::gauss2d::Image< T, C >::operator!= ( const Image< T, C > & other ) const

inline

Definition at line 248 of file image.h.

{ return !(*this == other); }

operator*=()

template<typename T , class C >

Image< T, C > & lsst::gauss2d::Image< T, C >::operator*= ( T value )

inline

Definition at line 213 of file image.h.

                                     {
        const size_t n_rows = get_n_rows();
        const size_t n_cols = get_n_cols();
        for (size_t row = 0; row < n_rows; ++row) {
            for (size_t col = 0; col < n_cols; ++col) {
                // Avoid annoying warning for bool case
                if constexpr (std::is_same_v<T, bool>) {
                    this->set_value_unchecked(row, col, value && this->get_value_unchecked(row, col));
                } else {
                    this->set_value_unchecked(row, col, value * this->get_value_unchecked(row, col));
                }
            }
        }
        return *this;
    }

operator+=()

template<typename T , class C >

Image< T, C > & lsst::gauss2d::Image< T, C >::operator+= ( T value )

inline

Definition at line 202 of file image.h.

                                     {
        const size_t n_rows = get_n_rows();
        const size_t n_cols = get_n_cols();
        for (size_t row = 0; row < n_rows; ++row) {
            for (size_t col = 0; col < n_cols; ++col) {
                this->add_value_unchecked(row, col, value);
            }
        }
        return *this;
    }

operator==()

template<typename T , class C >

bool lsst::gauss2d::Image< T, C >::operator== ( const Image< T, C > & other ) const

inline

Definition at line 232 of file image.h.

                                              {
        if (images_compatible<T, C, T, C>(*this, other)) {
            const size_t n_rows = get_n_rows();
            const size_t n_cols = get_n_cols();
            for (size_t row = 0; row < n_rows; ++row) {
                for (size_t col = 0; col < n_cols; ++col) {
                    if (this->get_value_unchecked(row, col) != other.get_value_unchecked(row, col)) {
                        return false;
                    }
                }
            }
            return true;
        }
        return false;
    }

repr()

template<typename T , class C >

std::string lsst::gauss2d::Image< T, C >::repr ( bool name_keywords, std::string_view namespace_separator ) const

inlineoverridevirtual

Return a full, callable string representation of this.

Parameters

name_keywords	Whether to prefix arguments with "{name}=", where name is the arg name in the header (as with keyword arguments in Python).
namespace_separator	The string to use to delimit namespaces, i.e. :: in C++ and . in Python.

Returns

A callable string representation of this, which should return an an identical object to this.

Note

The representation with name_keywords=false must be callable in C++. The representation with name_keywords=true should be callable in Python, if there are any bindings.

Implements lsst::gauss2d::Object.

Definition at line 190 of file image.h.

                                                                                          {
        return type_name_str<C>(false, namespace_separator) + "(" + (name_keywords ? "coordsys=" : "")
               + _coordsys.repr(name_keywords, namespace_separator) + ", " + (name_keywords ? "n_rows=" : "")
               + std::to_string(this->get_n_rows()) + ", " + (name_keywords ? "n_cols=" : "")
               + std::to_string(this->get_n_cols()) + ")";
    }

set_value()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::set_value ( size_t row, size_t col, T value )

inline

Definition at line 177 of file image.h.

{ return self().set_value_impl(row, col, value); }

set_value_impl()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::set_value_impl ( size_t row, size_t col, T value )

inline

Definition at line 178 of file image.h.

{ self()._get_value(row, col) = value; }

set_value_unchecked()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::set_value_unchecked ( size_t row, size_t col, T value )

inline

Definition at line 179 of file image.h.

                                                                     {
        self().set_value_unchecked_impl(row, col, value);
    }

set_value_unchecked_impl()

template<typename T , class C >

void lsst::gauss2d::Image< T, C >::set_value_unchecked_impl ( size_t row, size_t col, T value )

inline

Definition at line 182 of file image.h.

                                                                          {
        self()._get_value_unchecked(row, col) = value;
    }

shape()

template<typename T , class C >

std::array< size_t, 2 > lsst::gauss2d::Image< T, C >::shape ( ) const

inline

Definition at line 186 of file image.h.

{ return {this->get_n_rows(), this->get_n_cols()}; }

size()

template<typename T , class C >

size_t lsst::gauss2d::Image< T, C >::size ( ) const

inline

Definition at line 188 of file image.h.

{ return this->get_n_rows() * this->get_n_cols(); };

str()

template<typename T , class C >

std::string lsst::gauss2d::Image< T, C >::str ( ) const

inlineoverridevirtual

Return a brief, human-readable string representation of this.

Implements lsst::gauss2d::Object.

Definition at line 197 of file image.h.

                                   {
        return type_name_str<C>(true) + "(coordsys=" + _coordsys.str() + ", n_rows="
               + std::to_string(this->get_n_rows()) + ", n_cols=" + std::to_string(this->get_n_cols()) + ")";
    }

Member Data Documentation

_value_default

template<typename T , class C >

constexpr T lsst::gauss2d::Image< T, C >::_value_default = 0

staticconstexpr

Definition at line 120 of file image.h.

CC_NAMESPACE_SEPARATOR

constexpr std::string_view lsst::gauss2d::Object::CC_NAMESPACE_SEPARATOR = "::"

staticconstexprinherited

The C++ namespace separator.

Definition at line 45 of file object.h.

NULL_STR_GENERAL

constexpr std::string_view lsst::gauss2d::Object::NULL_STR_GENERAL = "None"

staticconstexprinherited

Definition at line 46 of file object.h.

PY_NAMESPACE_SEPARATOR

constexpr std::string_view lsst::gauss2d::Object::PY_NAMESPACE_SEPARATOR = "."

staticconstexprinherited

Definition at line 47 of file object.h.

---

The documentation for this class was generated from the following file:

• /j/snowflake/release/lsstsw/stack/lsst-scipipe-9.0.0/Linux64/gauss2d/g9125e01d80+34a971ddd9/include/lsst/gauss2d/image.h