tatami_stats::LocalOutputBuffer< Output_ > Class Template Reference

Local output buffer for running calculations. More...

#include <utils.hpp>

Public Member Functions
template<typename Index_ >
	LocalOutputBuffer (size_t thread, Index_ start, Index_ length, Output_ *output, Output_ fill)
template<typename Index_ >
	LocalOutputBuffer (size_t thread, Index_ start, Index_ length, Output_ *output)
	LocalOutputBuffer ()=default
Output_ *	data ()
const Output_ *	data () const
void	transfer ()

Detailed Description

template<typename Output_>
class tatami_stats::LocalOutputBuffer< Output_ >

Local output buffer for running calculations.

A typical parallelization scenario involves dividing the set of objective vectors into contiguous blocks, where each thread operates on a block at a time. However, in running calculations, an entire block's statistics are updated when its corresponding thread processes an observed vector. If these statistics are stored in a global buffer, false sharing at the boundaries of the blocks can result in performance degradation.

To avoid this, the LocalOutputBuffer class provides thread-local storage for output statistics. Once the calculations are finished per thread, callers should use transfer() to transfer the local statistics to the global buffer. The exception is that of the first thread, which is allowed to directly write to the global output buffer.

Template Parameters

Output_

Type of the result.

Constructor & Destructor Documentation

LocalOutputBuffer() [1/3]

template<typename Output_ >

template<typename Index_ >

tatami_stats::LocalOutputBuffer< Output_ >::LocalOutputBuffer ( size_t  thread, Index_  start, Index_  length, Output_ *  output, Output_  fill  )

inline

Template Parameters

Index_

Type of the start index and length.

Parameters

	thread	Identity of the thread, starting from zero to the total number of threads.
	start	Index of the first objective vector in the contiguous block for this thread.
	length	Number of objective vectors in the contiguous block for this thread.
[out]	output	Pointer to the global output buffer.
	fill	Initial value to fill the buffer.

LocalOutputBuffer() [2/3]

template<typename Output_ >

template<typename Index_ >

tatami_stats::LocalOutputBuffer< Output_ >::LocalOutputBuffer ( size_t  thread, Index_  start, Index_  length, Output_ *  output  )

inline

Overloaded constructor that sets the default fill = 0.

Template Parameters

Index_

Type of the start index and length.

Parameters

	thread	Identity of the thread, starting from zero to the total number of threads.
	start	Index of the first objective vector in the contiguous block for this thread.
	length	Number of objective vectors in the contiguous block for this thread.
[out]	output	Pointer to the global output buffer.

LocalOutputBuffer() [3/3]

template<typename Output_ >

tatami_stats::LocalOutputBuffer< Output_ >::LocalOutputBuffer ( )

default

Default constructor.

Member Function Documentation

data() [1/2]

template<typename Output_ >

Output_ * tatami_stats::LocalOutputBuffer< Output_ >::data ( )

inline

Returns

Pointer to an output buffer to use for this thread. This contains at least length addressable elements (see the argument of the same name in the constructor).

data() [2/2]

template<typename Output_ >

const Output_ * tatami_stats::LocalOutputBuffer< Output_ >::data ( ) const

inline

Returns

Const pointer to an output buffer to use for this thread. This contains at least length addressable elements (see the argument of the same name in the constructor).

transfer()

template<typename Output_ >

void tatami_stats::LocalOutputBuffer< Output_ >::transfer ( )

inline

Transfer results from the local buffer to the global buffer (i.e., output in the constructor).

---

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

• tatami_stats/utils.hpp