PDRblock::location Class Reference

Grid locations in an axis direction. More...

Inheritance diagram for PDRblock::location:
Collaboration diagram for PDRblock::location:

Public Member Functions

void reset (const scalar low, const scalar upp, const label nCells)
 Reset with min/max range and number of divisions. More...
 
bool good () const noexcept
 The location list is valid if it contains 2 or more points. More...
 
label nCells () const noexcept
 The number of cells in this direction. More...
 
label nPoints () const noexcept
 The number of points in this direction. More...
 
bool contains (const scalar p) const
 True if the location is within the range. More...
 
const scalar & min () const
 The first() value is considered the min value. More...
 
const scalar & max () const
 The last() value is considered the max value. More...
 
scalar centre () const
 Mid-point location, zero for an empty list. More...
 
scalar length () const
 The difference between min/max values, zero for an empty list. More...
 
void checkIndex (const label i) const
 Check that element index is within valid range. More...
 
scalar width (const label i) const
 Cell size at element position. More...
 
scalar C (const label i) const
 Cell centre at element position. More...
 
scalarMinMax edgeLimits () const
 Return min/max edge lengths. More...
 
gradingDescriptors grading () const
 Return edge grading descriptors for the locations. More...
 
label findCell (const scalar p) const
 Find the cell index enclosing this location. More...
 
label findIndex (const scalar p, const scalar tol) const
 Find the grid index, within the given tolerance. More...
 
const scalar & clip (const scalar &val) const
 If out of range, return the respective min/max limits, otherwise return the value itself. More...
 
- Public Member Functions inherited from List< T >
constexpr List () noexcept
 Default construct. More...
 
 List (const label len)
 Construct with given size. More...
 
 List (const label len, const T &val)
 Construct with given size and value for all elements. More...
 
 List (const label len, const Foam::zero)
 Construct with given size initializing all elements to zero. More...
 
 List (const Foam::one, const T &val)
 Construct with length=1, copying the value as the only content. More...
 
 List (const Foam::one, T &&val)
 Construct with length=1, moving the value as the only content. More...
 
 List (const Foam::one, const Foam::zero)
 Construct with length=1, initializing content to zero. More...
 
 List (const List< T > &list)
 Copy construct from list. More...
 
 List (const UList< T > &list)
 Copy construct contents from list. More...
 
 List (List< T > &list, bool reuse)
 Construct as copy or re-use as specified. More...
 
 List (const UList< T > &list, const labelUList &indices)
 Copy construct subset of list. More...
 
template<unsigned N>
 List (const UList< T > &list, const FixedList< label, N > &indices)
 Copy construct subset of list. More...
 
template<unsigned N>
 List (const FixedList< T, N > &list)
 Construct as copy of FixedList<T, N> More...
 
 List (const PtrList< T > &list)
 Construct as copy of PtrList<T> More...
 
template<class Addr >
 List (const IndirectListBase< T, Addr > &list)
 Construct as copy of IndirectList contents. More...
 
 List (std::initializer_list< T > list)
 Construct from an initializer list. More...
 
 List (List< T > &&list) noexcept
 Move construct from List. More...
 
template<int SizeMin>
 List (DynamicList< T, SizeMin > &&list)
 Move construct from DynamicList. More...
 
 List (Istream &is)
 Construct from Istream. More...
 
autoPtr< List< T > > clone () const
 Clone. More...
 
 ~List ()
 Destructor. More...
 
void clear ()
 Clear the list, i.e. set size to zero. More...
 
void resize (const label len)
 Adjust allocated size of list. More...
 
void resize (const label len, const T &val)
 Adjust allocated size of list and set val for new elements. More...
 
void resize_fill (const label len, const T &val)
 Adjust allocated size of list and set val for all elements. More...
 
void resize_nocopy (const label len)
 Adjust allocated size of list without necessarily. More...
 
void resize_unsafe (const label len) noexcept
 Change the addressed list size directly without affecting any memory management (advanced usage). More...
 
void setSize (const label n)
 Alias for resize() More...
 
void setSize (const label n, const T &val)
 Alias for resize() More...
 
void transfer (List< T > &list)
 Transfer the contents of the argument List into this list and annul the argument list. More...
 
template<int SizeMin>
void transfer (DynamicList< T, SizeMin > &list)
 Transfer the contents of the argument List into this list and annul the argument list. More...
 
TnewElmt (const label i)
 Return subscript-checked element of UList and resizing the list if required. More...
 
template<class... Args>
Templace_back (Args &&... args)
 Construct an element at the end of the list, return reference to the new list element. More...
 
void push_back (const T &val)
 Append an element at the end of the list. More...
 
void push_back (T &&val)
 Move append an element at the end of the list. More...
 
void push_back (const UList< T > &list)
 Append a List to the end of this list. More...
 
template<class Addr >
void push_back (const IndirectListBase< T, Addr > &list)
 Append IndirectList contents at the end of this list. More...
 
label push_uniq (const T &val)
 Append an element if not already in the list. More...
 
void pop_back (label n=1)
 Reduce size by 1 or more elements. Can be called on an empty list. More...
 
void operator= (const UList< T > &list)
 Assignment to UList operator. Takes linear time. More...
 
void operator= (const List< T > &list)
 Assignment operator. Takes linear time. More...
 
template<class Addr >
void operator= (const IndirectListBase< T, Addr > &list)
 Assignment from IndirectList. Takes linear time. More...
 
template<unsigned N>
void operator= (const FixedList< T, N > &list)
 Copy assignment from FixedList. More...
 
void operator= (std::initializer_list< T > list)
 Assignment to an initializer list. More...
 
void operator= (const T &val)
 Assignment of all entries to the given value. More...
 
void operator= (const Foam::zero)
 Assignment of all entries to zero. More...
 
void operator= (List< T > &&list)
 Move assignment. Takes constant time. More...
 
template<int SizeMin>
void operator= (DynamicList< T, SizeMin > &&list)
 Move assignment. Takes constant time. More...
 
IstreamreadList (Istream &is)
 Read List from Istream, discarding contents of existing List. More...
 
void shallowCopy (const UList< T > &)=delete
 No shallowCopy permitted. More...
 
template<class TypeT = T>
std::enable_if< std::is_same< bool, TypeT >::value, bool >::type set (const label i, bool val=true)
 A bitSet::set() method for a list of bool. More...
 
void append (const T &val)
 Append an element at the end of the list. More...
 
void append (T &&val)
 Move append an element at the end of the list. More...
 
void append (const UList< T > &list)
 Append a List to the end of this list. More...
 
template<class Addr >
void append (const IndirectListBase< T, Addr > &list)
 Append IndirectList contents at the end of this list. More...
 
label appendUniq (const T &val)
 Same as push_uniq() More...
 
 List (const SLList< T > &list)
 Copy construct from SLList. More...
 
void operator= (const SLList< T > &list)
 Copy assign from SLList in linear time. More...
 
template<>
void resize (const label newLen)
 
- Public Member Functions inherited from UList< T >
 UList (const UList< T > &)=default
 Copy construct. More...
 
constexpr UList () noexcept
 Default construct, zero-sized and nullptr. More...
 
 UList (T *__restrict__ v, const label len) noexcept
 Construct from components. More...
 
label fcIndex (const label i) const noexcept
 The forward circular index. The next index in the list which returns to the first at the end of the list. More...
 
label rcIndex (const label i) const noexcept
 The reverse circular index. The previous index in the list which returns to the last at the beginning of the list. More...
 
const TfcValue (const label i) const
 Return forward circular value (ie, next value in the list) More...
 
TfcValue (const label i)
 Return forward circular value (ie, next value in the list) More...
 
const TrcValue (const label i) const
 Return reverse circular value (ie, previous value in the list) More...
 
TrcValue (const label i)
 Return reverse circular value (ie, previous value in the list) More...
 
const Tcdata () const noexcept
 Return pointer to the underlying array serving as data storage. More...
 
Tdata () noexcept
 Return pointer to the underlying array serving as data storage. More...
 
const char * cdata_bytes () const noexcept
 Return pointer to the underlying array serving as data storage,. More...
 
char * data_bytes () noexcept
 Return pointer to the underlying array serving as data storage,. More...
 
Tfront ()
 Access first element of the list, position [0]. More...
 
const Tfront () const
 Access first element of the list. More...
 
Tback ()
 Access last element of the list, position [size()-1]. More...
 
const Tback () const
 Access last element of the list, position [size()-1]. More...
 
std::streamsize size_bytes () const noexcept
 Number of contiguous bytes for the List data. More...
 
std::streamsize byteSize () const
 Number of contiguous bytes for the List data, runtime FatalError if type is not contiguous. More...
 
void checkStart (const label start) const
 Check start is within valid range [0,size) More...
 
void checkSize (const label size) const
 Check size is within valid range [0,size]. More...
 
void checkRange (const label start, const label len) const
 Check that start and length define a valid range. More...
 
void checkIndex (const label i) const
 Check index is within valid range [0,size) More...
 
bool uniform () const
 True if all entries have identical values, and list is non-empty. More...
 
bool contains (const T &val) const
 True if the value is contained in the list. More...
 
bool contains (const T &val, label pos, label len=-1) const
 Is the value contained in the list? More...
 
label find (const T &val) const
 Find index of the first occurrence of the value. More...
 
label find (const T &val, label pos, label len=-1) const
 Find index of the first occurrence of the value. More...
 
label rfind (const T &val, label pos=-1) const
 Find index of the last occurrence of the value. More...
 
void moveFirst (const label i)
 Move element to the first position. More...
 
void moveLast (const label i)
 Move element to the last position. More...
 
void swapFirst (const label i)
 Swap element with the first element. Fatal on an empty list. More...
 
void swapLast (const label i)
 Swap element with the last element. Fatal on an empty list. More...
 
void shallowCopy (T *__restrict__ ptr, const label len) noexcept
 Copy the pointer and size. More...
 
void shallowCopy (const UList< T > &list) noexcept
 Copy the pointer and size held by the given UList. More...
 
void deepCopy (const UList< T > &list)
 Copy elements of the given UList. Sizes must match! More...
 
template<class Addr >
void deepCopy (const IndirectListBase< T, Addr > &list)
 Copy elements of the given indirect list. Sizes must match! More...
 
SubList< Tslice (const label pos, label len=-1)
 Return SubList slice (non-const access) - no range checking. More...
 
const SubList< Tslice (const label pos, label len=-1) const
 Return SubList slice (const access) - no range checking. More...
 
SubList< Tslice (const labelRange &range)
 Return SubList slice (non-const access) - with range checking. More...
 
const SubList< Tslice (const labelRange &range) const
 Return SubList slice (const access) - with range checking. More...
 
Toperator[] (const label i)
 Return element of UList. More...
 
const Toperator[] (const label i) const
 Return element of constant UList. More...
 
 operator const Foam::List< T > & () const
 Allow cast to a const List<T>&. More...
 
void operator= (const T &val)
 Assignment of all entries to the given value. More...
 
void operator= (const Foam::zero)
 Assignment of all entries to zero. More...
 
iterator begin () noexcept
 Return an iterator to begin traversing the UList. More...
 
iterator end () noexcept
 Return an iterator to end traversing the UList. More...
 
iterator begin (const label i) noexcept
 Return iterator at offset i from begin, clamped to [0,size] range. More...
 
const_iterator cbegin () const noexcept
 Return const_iterator to begin traversing the constant UList. More...
 
const_iterator cend () const noexcept
 Return const_iterator to end traversing the constant UList. More...
 
const_iterator begin () const noexcept
 Return const_iterator to begin traversing the constant UList. More...
 
const_iterator end () const noexcept
 Return const_iterator to end traversing the constant UList. More...
 
const_iterator cbegin (const label i) const noexcept
 Return const_iterator at offset i from begin, clamped to [0,size] range. More...
 
const_iterator begin (const label i) const noexcept
 Return const_iterator at offset i from begin, clamped to [0,size] range. More...
 
reverse_iterator rbegin ()
 Return reverse_iterator to begin reverse traversing the UList. More...
 
reverse_iterator rend ()
 Return reverse_iterator to end reverse traversing the UList. More...
 
const_reverse_iterator crbegin () const
 Return const_reverse_iterator to begin reverse traversing the UList. More...
 
const_reverse_iterator crend () const
 Return const_reverse_iterator to end reverse traversing the UList. More...
 
const_reverse_iterator rbegin () const
 Return const_reverse_iterator to begin reverse traversing the UList. More...
 
const_reverse_iterator rend () const
 Return const_reverse_iterator to end reverse traversing the UList. More...
 
bool empty () const noexcept
 True if List is empty (ie, size() is zero) More...
 
label size () const noexcept
 The number of elements in the container. More...
 
label capacity () const noexcept
 Size of the underlying storage. More...
 
void swap (UList< T > &list) noexcept
 Swap content with another UList of the same type in constant time. More...
 
bool operator== (const UList< T > &list) const
 Equality operation on ULists of the same type. More...
 
bool operator!= (const UList< T > &list) const
 The opposite of the equality operation. Takes linear time. More...
 
bool operator< (const UList< T > &list) const
 Compare two ULists lexicographically. Takes linear time. More...
 
bool operator> (const UList< T > &list) const
 Compare two ULists lexicographically. Takes linear time. More...
 
bool operator<= (const UList< T > &list) const
 Return true if !(a > b). Takes linear time. More...
 
bool operator>= (const UList< T > &list) const
 Return true if !(a < b). Takes linear time. More...
 
IstreamreadList (Istream &is)
 Read List contents from Istream. More...
 
void writeEntry (const word &keyword, Ostream &os) const
 Write the List as a dictionary entry with keyword. More...
 
OstreamwriteList (Ostream &os, const label shortLen=0) const
 Write List, with line-breaks in ASCII when length exceeds shortLen. More...
 
template<class TypeT = T>
std::enable_if< std::is_same< bool, TypeT >::value, bool >::type test (const label i) const
 Test bool value at specified position, always false for out-of-range access. More...
 
template<class TypeT = T>
std::enable_if< std::is_same< bool, TypeT >::value, bool >::type get (const label i) const
 Return bool value at specified position, always false for out-of-range access. More...
 
template<class TypeT = T>
std::enable_if< std::is_same< bool, TypeT >::value, bool >::type unset (const label i)
 Unset the bool entry at specified position, always false for out-of-range access. More...
 
Tfirst ()
 Access first element of the list, position [0]. More...
 
const Tfirst () const
 Access first element of the list. More...
 
Tlast ()
 Access last element of the list, position [size()-1]. More...
 
const Tlast () const
 Access last element of the list, position [size()-1]. More...
 
bool found (const T &val, label pos=0) const
 Same as contains() More...
 
template<>
const bool & operator[] (const label i) const
 
template<>
UPstream::commsStructoperator[] (const label procID)
 
template<>
const UPstream::commsStructoperator[] (const label procID) const
 
template<>
Foam::UPstream::commsStructoperator[] (const label procID)
 
template<>
const Foam::UPstream::commsStructoperator[] (const label procID) const
 

Additional Inherited Members

- Public Types inherited from List< T >
typedef SubList< TsubList
 Declare type of subList. More...
 
- Public Types inherited from UList< T >
typedef T value_type
 The value type the list contains. More...
 
typedef Tpointer
 The pointer type for non-const access to value_type items. More...
 
typedef const Tconst_pointer
 The pointer type for const access to value_type items. More...
 
typedef Treference
 The type used for storing into value_type objects. More...
 
typedef const Tconst_reference
 The type used for reading from constant value_type objects. More...
 
typedef Titerator
 Random access iterator for traversing a UList. More...
 
typedef const Tconst_iterator
 Random access iterator for traversing a UList. More...
 
typedef label size_type
 The type to represent the size of a UList. More...
 
typedef label difference_type
 The difference between iterator objects. More...
 
typedef std::reverse_iterator< iteratorreverse_iterator
 Reverse iterator (non-const access) More...
 
typedef std::reverse_iterator< const_iteratorconst_reverse_iterator
 Reverse iterator (const access) More...
 
- Static Public Member Functions inherited from List< T >
static const List< T > & null ()
 Return a null List. More...
 
- Static Public Member Functions inherited from UList< T >
static const UList< T > & null ()
 Return a UList reference to a nullObject. More...
 
static constexpr label max_size () noexcept
 The size of the largest possible UList. More...
 
- Protected Member Functions inherited from UList< T >
void setAddressableSize (const label n) noexcept
 Set addressed size to be inconsistent with allocated storage. More...
 
void size (const label n)
 Older name for setAddressableSize. More...
 
void writeEntry (Ostream &os) const
 Write the UList with its compound type. More...
 
labelRange validateRange (const labelRange &requestedRange) const
 Return a validated (start,size) subset range, which means that it always addresses a valid section of the list. More...
 
void fill_uniform (const T &val)
 Assign all entries to the given value. More...
 
void fill_uniform (const Foam::zero)
 Assign all entries to zero. More...
 
UList< T > & operator= (const UList< T > &)=delete
 No copy assignment (default: shallow copy) More...
 
template<>
void writeEntry (Ostream &os) const
 Character list writeEntry. More...
 
template<>
void operator= (const Foam::zero)
 Character list assign zero - avoids Foam::zero casting ambiguities. More...
 
template<>
void writeEntry (Ostream &os) const
 
template<>
void operator= (const Foam::zero)
 

Detailed Description

Grid locations in an axis direction.

The number of points is one larger than the number of elements it represents

Definition at line 181 of file PDRblock.H.

Member Function Documentation

◆ reset()

void reset ( const scalar  low,
const scalar  upp,
const label  nCells 
)

Reset with min/max range and number of divisions.

Definition at line 259 of file PDRblockLocation.C.

References UList< T >::back(), UList< T >::front(), and List< T >::resize_nocopy().

Here is the call graph for this function:

◆ good()

bool good ( ) const
inlinenoexcept

The location list is valid if it contains 2 or more points.

Definition at line 24 of file PDRblockI.H.

References UList< T >::size().

Here is the call graph for this function:

◆ nCells()

Foam::label nCells ( ) const
inlinenoexcept

The number of cells in this direction.

Definition at line 30 of file PDRblockI.H.

References UList< T >::size().

Here is the call graph for this function:

◆ nPoints()

Foam::label nPoints ( ) const
inlinenoexcept

The number of points in this direction.

Definition at line 36 of file PDRblockI.H.

References UList< T >::size().

Here is the call graph for this function:

◆ contains()

bool contains ( const scalar  p) const
inline

True if the location is within the range.

Definition at line 42 of file PDRblockI.H.

References p, and UList< T >::size().

Here is the call graph for this function:

◆ min()

const Foam::scalar & min ( ) const
inline

The first() value is considered the min value.

Definition at line 48 of file PDRblockI.H.

References UList< T >::empty().

Here is the call graph for this function:

◆ max()

const Foam::scalar & max ( ) const
inline

The last() value is considered the max value.

Definition at line 54 of file PDRblockI.H.

References UList< T >::empty().

Here is the call graph for this function:

◆ centre()

Foam::scalar centre ( ) const
inline

Mid-point location, zero for an empty list.

Definition at line 60 of file PDRblockI.H.

References UList< T >::empty().

Here is the call graph for this function:

◆ length()

Foam::scalar length ( ) const
inline

The difference between min/max values, zero for an empty list.

Definition at line 66 of file PDRblockI.H.

References UList< T >::empty(), and Foam::mag().

Here is the call graph for this function:

◆ checkIndex()

void checkIndex ( const label  i) const
inline

Check that element index is within valid range.

Definition at line 72 of file PDRblockI.H.

References Foam::abort(), Foam::FatalError, FatalErrorInFunction, ijkMesh::nCells(), and Foam::nl.

Here is the call graph for this function:

◆ width()

Foam::scalar width ( const label  i) const
inline

Cell size at element position.

Definition at line 84 of file PDRblockI.H.

References ijkAddressing::checkIndex().

Here is the call graph for this function:

◆ C()

Foam::scalar C ( const label  i) const
inline

Cell centre at element position.

Treats -1 and nCells positions like a halo cell.

Definition at line 94 of file PDRblockI.H.

References ijkAddressing::checkIndex(), and UList< T >::size().

Here is the call graph for this function:

◆ edgeLimits()

Foam::scalarMinMax edgeLimits ( ) const

Return min/max edge lengths.

Definition at line 281 of file PDRblockLocation.C.

References MinMax< T >::add().

Here is the call graph for this function:

◆ grading()

gradingDescriptors grading ( ) const

Return edge grading descriptors for the locations.

See also
Foam::gradingDescriptor

◆ findCell()

Foam::label findCell ( const scalar  p) const

Find the cell index enclosing this location.

Returns
-1 for out-of-bounds

Definition at line 294 of file PDRblockLocation.C.

References UList< T >::empty(), Foam::equal(), Foam::findLower(), and p.

Here is the call graph for this function:

◆ findIndex()

Foam::label findIndex ( const scalar  p,
const scalar  tol 
) const

Find the grid index, within the given tolerance.

Return -1 for out-of-bounds and -2 for a point that is within bounds, but not aligned with a grid point.

Definition at line 321 of file PDRblockLocation.C.

References delta, Foam::diff(), UList< T >::empty(), Foam::mag(), p, and UList< T >::size().

Here is the call graph for this function:

◆ clip()

const Foam::scalar & clip ( const scalar &  val) const
inline

If out of range, return the respective min/max limits, otherwise return the value itself.

If the range is invalid, always return the value.

Definition at line 120 of file PDRblockI.H.

References UList< T >::size().

Here is the call graph for this function:

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