Rosetta  2020.37
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Public Types | Public Member Functions | Private Attributes | List of all members
utility::FixedSizeLexicographicalIterator< S > Class Template Reference

#include <FixedSizeLexicographicalIterator.hh>

Public Types

typedef platform::Size Size
 
typedef fixedsizearray1< Size, Sfsarray
 

Public Member Functions

 FixedSizeLexicographicalIterator ()
 default constructor – requires that set_dimension_sizes later be called. or the default alphabet (size 0). More...
 
 FixedSizeLexicographicalIterator (fsarray const &dim_sizes)
 Constructor with dimension sizes. More...
 
void set_dimension_sizes (fsarray const &dim_sizes)
 Set the dimension sizes; resets the curr_pos_ to the beginning of the enumeration. More...
 
void begin ()
 reset the iterator to the beginning string (1,1,1,...) More...
 
bool at_end () const
 Is the iterator at the end? More...
 
Size operator++ ()
 Increment the iterator and return the number of dimensions that were advanced. the number of advanced dimensions ranges from 0 to ndims. 0 is returned only if the iterator is at the end. More...
 
Size size () const
 The number of dimensions. More...
 
Size ndims () const
 The number of dimensions. More...
 
Size operator[] (Size dim) const
 Access the ith dimension (from most-significant digit to least). If the iterator pointed to the string "MACE", then dimension "2" refers to the position holding "A". Unsigned dimension input. More...
 
Size dimsize (Size dim) const
 
Size index () const
 Give an integer index of the current state. This can be used to reset the lexicographical iterator to the current state again later. More...
 
void set_position_from_index (Size index)
 Set the state of the lexicographical iterator using a particular index. More...
 
Size continue_at_dimension (Size dim)
 Advance the nth dimension to its next value and reset the higher dimensions to their initial values. E.g. If there were four dimensions of size 5, and the current state was [ 1, 3, 2, 4 ], then continue_at_dimension( 2 ) would result in the state [ 1, 4, 1, 1 ], and if the state were [ 1, 5, 2, 3 ], then continue_at_dimension( 2 ) would result in the state [ 2, 1, 1, 1 ]. Returns the number of dimensions that were advanced (0 if at_end, but otherwise, >= dim) More...
 
Size num_states_total () const
 Returns the number of states that could be enumerated. More...
 

Private Attributes

fsarray dim_sizes_
 
fsarray curr_pos_
 

Member Typedef Documentation

Constructor & Destructor Documentation

default constructor – requires that set_dimension_sizes later be called. or the default alphabet (size 0).

– fake that there's one alphabet and that it has size 0.

template<platform::Size S>
utility::FixedSizeLexicographicalIterator< S >::FixedSizeLexicographicalIterator ( fsarray const &  dim_sizes)

Constructor with dimension sizes.

No alphabet may have size 0.

References test.T200_Scoring::ii.

Member Function Documentation

template<platform::Size S>
bool utility::FixedSizeLexicographicalIterator< S >::at_end ( ) const

Is the iterator at the end?

both curr_pos_ and dim_sizes_ must have size greater than 0. Therefore, even the empty set of alphabets (used by the default ctor) must contain 1 alphabet.

Referenced by apps::public1::scenarios::chemically_conjugated_docking::ubq_ras_distance().

template<platform::Size S>
void utility::FixedSizeLexicographicalIterator< S >::begin ( )

reset the iterator to the beginning string (1,1,1,...)

First element is the 1 string

Referenced by apps::public1::scenarios::chemically_conjugated_docking::ubq_ras_distance().

template<platform::Size S>
FixedSizeLexicographicalIterator< S >::Size utility::FixedSizeLexicographicalIterator< S >::continue_at_dimension ( Size  dim)

Advance the nth dimension to its next value and reset the higher dimensions to their initial values. E.g. If there were four dimensions of size 5, and the current state was [ 1, 3, 2, 4 ], then continue_at_dimension( 2 ) would result in the state [ 1, 4, 1, 1 ], and if the state were [ 1, 5, 2, 3 ], then continue_at_dimension( 2 ) would result in the state [ 2, 1, 1, 1 ]. Returns the number of dimensions that were advanced (0 if at_end, but otherwise, >= dim)

set the higher dimensions to their maximum values, and simply invoke the ++operator which will handle the logic of rolling over lower dimensions if the nth dimension is at its maximum value.

References test.T200_Scoring::ii.

template<platform::Size S>
Size utility::FixedSizeLexicographicalIterator< S >::dimsize ( Size  dim) const
inline
template<platform::Size S>
FixedSizeLexicographicalIterator< S >::Size utility::FixedSizeLexicographicalIterator< S >::index ( ) const

Give an integer index of the current state. This can be used to reset the lexicographical iterator to the current state again later.

References test.T200_Scoring::ii.

template<platform::Size S>
Size utility::FixedSizeLexicographicalIterator< S >::ndims ( ) const
inline

The number of dimensions.

References utility::FixedSizeLexicographicalIterator< S >::size().

template<platform::Size S>
FixedSizeLexicographicalIterator< S >::Size utility::FixedSizeLexicographicalIterator< S >::num_states_total ( ) const

Returns the number of states that could be enumerated.

References test.T200_Scoring::ii.

template<platform::Size S>
FixedSizeLexicographicalIterator< S >::Size utility::FixedSizeLexicographicalIterator< S >::operator++ ( )

Increment the iterator and return the number of dimensions that were advanced. the number of advanced dimensions ranges from 0 to ndims. 0 is returned only if the iterator is at the end.

Return the number of dimensions advanced by the increment operator so that an outside observer can track the progress of the iterator

References test.T200_Scoring::ii.

template<platform::Size S>
Size utility::FixedSizeLexicographicalIterator< S >::operator[] ( Size  dim) const
inline

Access the ith dimension (from most-significant digit to least). If the iterator pointed to the string "MACE", then dimension "2" refers to the position holding "A". Unsigned dimension input.

References utility::FixedSizeLexicographicalIterator< S >::curr_pos_.

template<platform::Size S>
void utility::FixedSizeLexicographicalIterator< S >::set_dimension_sizes ( fsarray const &  dim_sizes)

Set the dimension sizes; resets the curr_pos_ to the beginning of the enumeration.

References begin, debug_assert, and test.T200_Scoring::ii.

template<platform::Size S>
void utility::FixedSizeLexicographicalIterator< S >::set_position_from_index ( Size  index)

Set the state of the lexicographical iterator using a particular index.

No requirement that the index doesn't "overflow" the iterator; however, if it should overflow, then at_end() will return true.

References test.T200_Scoring::ii, and ObjexxFCL::index().

template<platform::Size S>
Size utility::FixedSizeLexicographicalIterator< S >::size ( ) const
inline

Member Data Documentation

template<platform::Size S>
fsarray utility::FixedSizeLexicographicalIterator< S >::curr_pos_
private
template<platform::Size S>
fsarray utility::FixedSizeLexicographicalIterator< S >::dim_sizes_
private

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