lar::util::simple_geo::Range< Data > Struct Template Reference

Definition of a range along one dimension. More...

#include "SimpleGeo.h"

Public Types
using	Data_t = Data
	Numeric type for boundaries. More...
using	Range_t = Range< Data >
	This range type. More...

Public Member Functions
	Range ()=default
	Default constructor: empty range. More...
	Range (Data_t lower, Data_t upper, bool doSort=false)
	Constructor from lower and upper bounds. More...
bool	isNull () const
	Returns whether the range is empty. More...
Data_t	length () const
	Returns the distance between upper and lower bounds. More...
bool	contains (Data_t v) const
	Returns whether the specified value is within the range. More...
bool	overlaps (Range_t const &r) const
	Returns whether the specified range overlaps this range. More...
Data_t	delta (Data_t v, Data_t margin=0.0) const
void	extendToInclude (Data_t)
	Extends the range to include the specified point. More...
void	extendToInclude (Range_t const &r)
	Extends the range to include the specified point. More...
void	intersect (Range_t const &r)
	Shortens this range to include only points also in r. More...

Public Attributes
Data_t	lower = 1.0
	Starting coordinate. More...
Data_t	upper = 0.0
	Ending coordinate. More...

Private Member Functions
void	sort ()
	Ensures order of boundaries. Corrupts invalid ranges. More...
void	makeNull ()
	Resets this range to be empty (that is, like default-constructed). More...

Detailed Description

template<typename Data = double>
struct lar::util::simple_geo::Range< Data >

Definition of a range along one dimension.

Definition at line 353 of file SimpleGeo.h.

Member Typedef Documentation

template<typename Data = double>

using lar::util::simple_geo::Range< Data >::Data_t = Data

Numeric type for boundaries.

Definition at line 354 of file SimpleGeo.h.

template<typename Data = double>

using lar::util::simple_geo::Range< Data >::Range_t = Range<Data>

This range type.

Definition at line 355 of file SimpleGeo.h.

Constructor & Destructor Documentation

template<typename Data = double>

lar::util::simple_geo::Range< Data >::Range ( )

default

Default constructor: empty range.

template<typename Data = double>

lar::util::simple_geo::Range< Data >::Range ( Data_t  lower, Data_t  upper, bool  doSort = false  )

inline

Constructor from lower and upper bounds.

Definition at line 364 of file SimpleGeo.h.

                                                               : lower(lower), upper(upper)
        {
          if (doSort) sort();
        }

Member Function Documentation

template<typename Data = double>

bool lar::util::simple_geo::Range< Data >::contains ( Data_t  v ) const

inline

Returns whether the specified value is within the range.

Definition at line 376 of file SimpleGeo.h.

Referenced by lar::util::simple_geo::Rectangle< double >::contains().

{ return (v >= lower) && (v <= upper); }

template<typename Data >

auto lar::util::simple_geo::Range< Data >::delta	(	Data_t	v,
		Data_t	margin = 0.0
	)		const

Returns a value that, added to v, makes it fall within a margin in the range.

Definition at line 472 of file SimpleGeo.h.

Referenced by geo::PlaneGeo::DeltaFromActivePlane().

{

  if (v < (lower + margin)) return lower + margin - v; // always positive
  if (v > (upper - margin)) return upper - margin - v; // always negative
  return 0.0;                                          // always zero

} // lar::util::simple_geo::Range<Data>::delta()

template<typename Data >

void lar::util::simple_geo::Range< Data >::extendToInclude

(

Data_t

v

)

Extends the range to include the specified point.

Definition at line 483 of file SimpleGeo.h.

{

  if (lower > upper)
    lower = upper = v;
  else if (lower > v)
    lower = v;
  else if (upper < v)
    upper = v;

} // lar::util::simple_geo::Range<Data>::extendToInclude()

template<typename Data >

void lar::util::simple_geo::Range< Data >::extendToInclude

(

Range_t const &

r

)

Extends the range to include the specified point.

Definition at line 497 of file SimpleGeo.h.

References lar::util::simple_geo::Range< Data >::isNull(), lar::util::simple_geo::Range< Data >::lower, r, and lar::util::simple_geo::Range< Data >::upper.

{

  if (r.isNull()) return;
  if (isNull()) {
    *this = r;
    return;
  }
  extendToInclude(r.lower);
  extendToInclude(r.upper);

} // lar::util::simple_geo::Range<Data>::extendToInclude()

template<typename Data >

void lar::util::simple_geo::Range< Data >::intersect

(

Range_t const &

r

)

Shortens this range to include only points also in r.

Definition at line 512 of file SimpleGeo.h.

References lar::util::simple_geo::Range< Data >::isNull(), lar::util::simple_geo::Range< Data >::lower, and lar::util::simple_geo::Range< Data >::upper.

{
  // this implementation explicitly makes the range default-constructed-null
  // if the intersection results empty
  if (isNull()) return;
  if (r.isNull()) {
    makeNull();
    return;
  }
  if (lower < r.lower) lower = r.lower;
  if (upper > r.upper) upper = r.upper;
  if (lower > upper) makeNull();
} // lar::util::simple_geo::Range<Data>::intersect()

template<typename Data = double>

bool lar::util::simple_geo::Range< Data >::isNull ( ) const

inline

Returns whether the range is empty.

Definition at line 370 of file SimpleGeo.h.

Referenced by lar::util::simple_geo::Range< Data >::extendToInclude(), lar::util::simple_geo::Range< Data >::intersect(), lar::util::simple_geo::Rectangle< double >::isNull(), and lar::util::simple_geo::Range< Data >::overlaps().

{ return lower >= upper; }

template<typename Data = double>

Data_t lar::util::simple_geo::Range< Data >::length ( ) const

inline

Returns the distance between upper and lower bounds.

Definition at line 373 of file SimpleGeo.h.

{ return std::max(upper - lower, Data_t(0.0)); }

template<typename Data = double>

void lar::util::simple_geo::Range< Data >::makeNull ( )

inlineprivate

Resets this range to be empty (that is, like default-constructed).

Definition at line 402 of file SimpleGeo.h.

{ *this = Range_t{}; }

template<typename Data >

bool lar::util::simple_geo::Range< Data >::overlaps

(

Range_t const &

r

)

const

Returns whether the specified range overlaps this range.

Definition at line 528 of file SimpleGeo.h.

References lar::util::simple_geo::Range< Data >::isNull(), lar::util::simple_geo::Range< Data >::lower, and lar::util::simple_geo::Range< Data >::upper.

{
  if (isNull() || r.isNull()) return false;
  return (r.lower < upper) && (lower < r.upper);
} // lar::util::simple_geo::Range<Data>::overlaps()

template<typename Data = double>

void lar::util::simple_geo::Range< Data >::sort ( )

inlineprivate

Ensures order of boundaries. Corrupts invalid ranges.

Definition at line 396 of file SimpleGeo.h.

        {
          if (lower > upper) std::swap(lower, upper);
        }

Member Data Documentation

template<typename Data = double>

Data_t lar::util::simple_geo::Range< Data >::lower = 1.0

Starting coordinate.

Definition at line 357 of file SimpleGeo.h.

Referenced by lar::util::simple_geo::Range< Data >::extendToInclude(), lar::util::simple_geo::Range< Data >::intersect(), geo::part::details::RangeLowerBoundExtractor< Range >::operator()(), lar::util::simple_geo::Range< Data >::overlaps(), and geo::PlaneGeo::PrintPlaneInfo().

template<typename Data = double>

Data_t lar::util::simple_geo::Range< Data >::upper = 0.0

Ending coordinate.

Definition at line 358 of file SimpleGeo.h.

Referenced by lar::util::simple_geo::Range< Data >::extendToInclude(), lar::util::simple_geo::Range< Data >::intersect(), lar::util::simple_geo::Range< Data >::overlaps(), and geo::PlaneGeo::PrintPlaneInfo().

---

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

• larcorealg/v10_00_02/source/larcorealg/Geometry/SimpleGeo.h