Hold thinning decisions for one container. More...

#include <ThinningDecision.h>

Inheritance diagram for SG::ThinningDecision:

Collaboration diagram for SG::ThinningDecision:

Public Types
enum	Op { Op::Set = 0, Op::And = 1, Op::Or = 2 }

Public Member Functions
	ThinningDecision (const DataLink< SG::AuxVectorBase > &link)
	Constructor. More...

	ThinningDecision (const std::string &key)
	Constructor. More...

const DataLink< SG::AuxVectorBase > &	link () const
	Return link to object being thinned. More...

virtual void	lock () override
	Called when the object is locked in SG. More...

void	resize (const size_t size)
	Change the number of elements. More...

bool	thinned (size_t ndx) const
	Return true if element `ndx` should be thinned. More...

size_t	size () const
	Return the total size of the container being thinned. More...

size_t	thinnedSize () const
	Return the size of the container being thinned after thinning. More...

void	thinAll ()
	Mark that all elements should be thinned away. More...

void	keepAll ()
	Mark that all elements should be kept (not thinned). More...

void	thin (size_t ndx)
	Mark that index `ndx` in the container should be thinned away. More...

void	thin (size_t ndx, bool flag, Op op=Op::Set)
	Set thinning state for one element. More...

void	thin (const std::vector< bool > &v, Op op=Op::Set)
	Set the thinning state for the container from a bitmask. More...

void	thin (const ThinningDecisionBase &other, Op op=Op::Set)
	Set the thinning state for the container from a bitmask. More...

void	keep (size_t ndx)
	Mark that index `ndx` in the container should be kept (not thinned away). More...

void	keep (size_t ndx, bool flag, Op op=Op::Set)
	Set thinning state for one element. More...

void	keep (const std::vector< bool > &v, Op op=Op::Set)
	Set the thinning state for the container from a bitmask. More...

void	keep (const ThinningDecisionBase &other, Op op=Op::Set)
	Set the thinning state for the container from a bitmask. More...

void	buildIndexMap ()
	Build the index map. More...

size_t	index (size_t ndxOrig) const
	Return the index corresponding to `ndxOrig` after thinning. More...

Static Public Attributes
static const std::size_t	RemovedIdx = static_cast<std::size_t>(-1)
	Flag used to show that an index has been thinned away. More...

Private Attributes
DataLink< SG::AuxVectorBase >	m_link
	Link to the object being thinned. More...

boost::dynamic_bitset	m_mask
	Thinning map. Set to 1 for thinned elements. More...

std::vector< size_t >	m_indexMap
	Mapping from original indices to thinned indices. More...

Detailed Description

Hold thinning decisions for one container.

This essentially holds a bitmap of the elements to be thinned from the container, as well as the mapping of indices before and after thinning (the latter available only after the container has been locked in SG). See the base class ThinningDecisionBase for further details.

Definition at line 38 of file ThinningDecision.h.

Member Enumeration Documentation

◆ Op

enum SG::ThinningDecisionBase::Op

stronginherited

Enumerator
Set
And
Or

Definition at line 44 of file ThinningDecisionBase.h.

                 {
     Set = 0,
     And = 1,
     Or = 2
   };

Constructor & Destructor Documentation

◆ ThinningDecision() [1/2]

SG::ThinningDecision::ThinningDecision ( const DataLink< SG::AuxVectorBase > & link )

Constructor.

Parameters

link	Link to the container being thinned.

Initialized with all elements kept.

Definition at line 24 of file ThinningDecision.cxx.

   : m_link (link)
 {
   if (!m_link.isValid()) {
     throw SG::ExcInvalidThinningTarget (link.classID(), link.dataID());
   }
   resize (m_link->size_v());
 }

◆ ThinningDecision() [2/2]

SG::ThinningDecision::ThinningDecision ( const std::string & key )

Constructor.

Parameters

key	SG key of the container being thinned.

Initialized with all elements kept.

Definition at line 40 of file ThinningDecision.cxx.

   : ThinningDecision (DataLink<SG::AuxVectorBase> (key))
 {
 }

Member Function Documentation

◆ buildIndexMap()

void SG::ThinningDecisionBase::buildIndexMap ( )

inherited

Build the index map.

Definition at line 240 of file ThinningDecisionBase.cxx.

 {
   assert (m_indexMap.empty());
   size_t sz = m_mask.size();
   m_indexMap.resize (sz);
   size_t pos = 0;
   for (size_t i = 0; i < sz; i++) {
     m_indexMap[i] = thinned(i) ? RemovedIdx : pos++ ;
   }
 }

◆ index()

size_t SG::ThinningDecisionBase::index ( size_t ndxOrig ) const

inherited

Return the index corresponding to ndxOrig after thinning.

Parameters

ndxOrig Original container index.

Returns the index at which element ndxOrig ends up after thinning. If the element was thinned away, returns RemovedIdx.

This information is available only after buildIndexMap has been called.

◆ keep() [1/4]

void SG::ThinningDecisionBase::keep	(	const std::vector< bool > &	v,
		Op	op = `Op::Set`
	)

inherited

Set the thinning state for the container from a bitmask.

Parameters

v	Thinning state mask; should have the same size as the container. Element `ndx` should be kept if bit `ndx` is set in the map.
op	Logical operation for combining with existing thinning state. Set — Keep if `flag` is true. And — Keep if `flag` is true and element was originally kept, else not. Or — Keep if `flag` is true or element was originally kept, else not.

Definition at line 172 of file ThinningDecisionBase.cxx.

 {
   size_t sz = m_mask.size();
   if (sz != v.size()) {
     throw std::out_of_range ("ThinningDecisionBase::keep(): inconsistent vector sizes.");
   }
   for (size_t i = 0; i < sz; i++) {
     bool flag = v[i];
     if (op == Op::And)
       flag &= !m_mask[i];
     else if (op == Op::Or)
       flag |= !m_mask[i];
     m_mask.set (i, !flag);
   }
 }

◆ keep() [2/4]

void SG::ThinningDecisionBase::keep	(	const ThinningDecisionBase &	other,
		Op	op = `Op::Set`
	)

inherited

Set the thinning state for the container from a bitmask.

Parameters

other	Thinning state mask; should have the same size as the container. Element `ndx` should be kept if bit `ndx` is set in the map.
op	Logical operation for combining with existing thinning state. Set — Keep if `flag` is true. And — Keep if `flag` is true and element was originally kept, else not. Or — Keep if `flag` is true or element was originally kept, else not.

Definition at line 222 of file ThinningDecisionBase.cxx.

 {
   size_t sz = m_mask.size();
   if (sz != other.size()) {
     throw std::out_of_range ("ThinningDecisionBase::keep(): inconsistent vector sizes.");
   }
   if (op == Op::And)
     m_mask |= ~other.m_mask;
   else if (op == Op::Or)
     m_mask &= ~other.m_mask;
   else
     m_mask = ~other.m_mask;
 }

◆ keep() [3/4]

void SG::ThinningDecisionBase::keep ( size_t ndx )

inherited

Mark that index ndx in the container should be kept (not thinned away).

Parameters

ndx	Index of element to keep.

Definition at line 84 of file ThinningDecisionBase.cxx.

 {
   if (ndx >= m_mask.size()) {
     throw std::out_of_range ("ThinningDecisionBase::thin");
   }
   m_mask.set (ndx, false);
 }

◆ keep() [4/4]

void SG::ThinningDecisionBase::keep	(	size_t	ndx,
		bool	flag,
		Op	op = `Op::Set`
	)

inherited

Set thinning state for one element.

Parameters

ndx	Index of element to alter.
flag	If true, keep this element; if false, thin it it.
op	Logical operation for combining with existing thinning state. Set — Keep if `flag` is true. And — Keep if `flag` is true and element was originally kept, else not. Or — Keep if `flag` is true or element was originally kept, else not.

Definition at line 124 of file ThinningDecisionBase.cxx.

 {
   if (ndx >= m_mask.size()) {
     throw std::out_of_range ("ThinningDecisionBase::thin");
   }
   if (op == Op::And)
     flag &= !m_mask[ndx];
   else if (op == Op::Or)
     flag |= !m_mask[ndx];
   m_mask.set (ndx, !flag);
 }

◆ keepAll()

void SG::ThinningDecisionBase::keepAll ( )

inherited

Mark that all elements should be kept (not thinned).

Definition at line 60 of file ThinningDecisionBase.cxx.

 {
   m_mask.reset();
 }

◆ link()

const DataLink< SG::AuxVectorBase > & SG::ThinningDecision::link ( ) const

Return link to object being thinned.

Definition at line 49 of file ThinningDecision.cxx.

 {
   return m_link;
 }

◆ lock()

void SG::ThinningDecision::lock ( )

overridevirtual

Called when the object is locked in SG.

Build the index map.

Implements ILockable.

Definition at line 60 of file ThinningDecision.cxx.

 {
   buildIndexMap();
 }

◆ resize()

void SG::ThinningDecisionBase::resize ( const size_t size )

inherited

Change the number of elements.

Parameters

size	The new number of elements.

Definition at line 33 of file ThinningDecisionBase.cxx.

 {
   m_mask.resize (size);
 }

◆ size()

size_t SG::ThinningDecisionBase::size ( ) const

inherited

Return the total size of the container being thinned.

◆ thin() [1/4]

void SG::ThinningDecisionBase::thin	(	const std::vector< bool > &	v,
		Op	op = `Op::Set`
	)

inherited

Set the thinning state for the container from a bitmask.

Parameters

v	Thinning state mask; should have the same size as the container. Element `ndx` should be thinned if bit `ndx` is set in the map.
op	Logical operation for combining with existing thinning state. Set — Thin if `flag` is true. And — Thin if `flag` is true and element was originally thinned, else not. Or — Thin if `flag` is true or element was originally thinned, else not.

Definition at line 146 of file ThinningDecisionBase.cxx.

 {
   size_t sz = m_mask.size();
   if (sz != v.size()) {
     throw std::out_of_range ("ThinningDecisionBase::thin(): inconsistent vector sizes.");
   }
   for (size_t i = 0; i < sz; i++) {
     bool flag = v[i];
     if (op == Op::And)
       flag &= m_mask[i];
     else if (op == Op::Or)
       flag |= m_mask[i];
     m_mask.set (i, flag);
   }
 }

◆ thin() [2/4]

void SG::ThinningDecisionBase::thin	(	const ThinningDecisionBase &	other,
		Op	op = `Op::Set`
	)

inherited

Set the thinning state for the container from a bitmask.

Parameters

other	Thinning state mask; should have the same size as the container. Element `ndx` should be thinned if bit `ndx` is set in the map.
op	Logical operation for combining with existing thinning state. Set — Thin if `flag` is true. And — Thin if `flag` is true and element was originally thinned, else not. Or — Thin if `flag` is true or element was originally thinned, else not.

Definition at line 198 of file ThinningDecisionBase.cxx.

 {
   size_t sz = m_mask.size();
   if (sz != other.size()) {
     throw std::out_of_range ("ThinningDecisionBase::thin(): inconsistent vector sizes.");
   }
   if (op == Op::And)
     m_mask &= other.m_mask;
   else if (op == Op::Or)
     m_mask |= other.m_mask;
   else
     m_mask = other.m_mask;
 }

◆ thin() [3/4]

void SG::ThinningDecisionBase::thin ( size_t ndx )

inherited

Mark that index ndx in the container should be thinned away.

Parameters

ndx	Index of element to thin.

Definition at line 70 of file ThinningDecisionBase.cxx.

 {
   if (ndx >= m_mask.size()) {
     throw std::out_of_range ("ThinningDecisionBase::thin");
   }
   m_mask.set (ndx, true);
 }

◆ thin() [4/4]

void SG::ThinningDecisionBase::thin	(	size_t	ndx,
		bool	flag,
		Op	op = `Op::Set`
	)

inherited

Set thinning state for one element.

Parameters

ndx	Index of element to alter.
flag	If true, thin this element; if false, keep it.
op	Logical operation for combining with existing thinning state. Set — Thin if `flag` is true. And — Thin if `flag` is true and element was originally thinned, else not. Or — Thin if `flag` is true or element was originally thinned, else not.

Definition at line 102 of file ThinningDecisionBase.cxx.

 {
   if (ndx >= m_mask.size()) {
     throw std::out_of_range ("ThinningDecisionBase::thin");
   }
   if (op == Op::And)
     flag &= m_mask[ndx];
   else if (op == Op::Or)
     flag |= m_mask[ndx];
   m_mask.set (ndx, flag);
 }

◆ thinAll()

void SG::ThinningDecisionBase::thinAll ( )

inherited

Mark that all elements should be thinned away.

Definition at line 51 of file ThinningDecisionBase.cxx.

 {
   m_mask.set();
 }

◆ thinned()

bool SG::ThinningDecisionBase::thinned ( size_t ndx ) const

inherited

Return true if element ndx should be thinned.

◆ thinnedSize()

size_t SG::ThinningDecisionBase::thinnedSize ( ) const

inherited

Return the size of the container being thinned after thinning.

Definition at line 42 of file ThinningDecisionBase.cxx.

 {
   return m_mask.size() - m_mask.count();
 }

Member Data Documentation

◆ m_indexMap

std::vector<size_t> SG::ThinningDecisionBase::m_indexMap

privateinherited

Mapping from original indices to thinned indices.

Definition at line 207 of file ThinningDecisionBase.h.

◆ m_link

DataLink<SG::AuxVectorBase> SG::ThinningDecision::m_link

private

Link to the object being thinned.

Definition at line 76 of file ThinningDecision.h.

◆ m_mask

boost::dynamic_bitset SG::ThinningDecisionBase::m_mask

privateinherited

Thinning map. Set to 1 for thinned elements.

Definition at line 204 of file ThinningDecisionBase.h.

◆ RemovedIdx

const std::size_t SG::ThinningDecisionBase::RemovedIdx = static_cast<std::size_t>(-1)

staticinherited

Flag used to show that an index has been thinned away.

Definition at line 42 of file ThinningDecisionBase.h.

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

Public Types

Public Member Functions

Static Public Attributes

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ Op

Constructor & Destructor Documentation

◆ ThinningDecision() [1/2]

◆ ThinningDecision() [2/2]

Member Function Documentation

◆ buildIndexMap()

◆ index()

◆ keep() [1/4]

◆ keep() [2/4]

◆ keep() [3/4]

◆ keep() [4/4]

◆ keepAll()

◆ link()

◆ lock()

◆ resize()

◆ size()

◆ thin() [1/4]

◆ thin() [2/4]

◆ thin() [3/4]

◆ thin() [4/4]

◆ thinAll()

◆ thinned()

◆ thinnedSize()

Member Data Documentation

◆ m_indexMap

◆ m_link

◆ m_mask

◆ RemovedIdx