Namespace for LArSoft dumping utilities. More...

Namespaces
	details

Classes
struct	ArrayDumper
	Dumps the first N elements of an array. More...

struct	ArrayDumper< T * >

struct	VectorDumper
	Manipulator managing the dump of the vector content into a stream. More...

struct	VectorDumper< T * >

struct	VectorDumper< T[3]>

Functions
template<size_t N, typename Array >
auto	array (Array const &a)
	Returns a manipulator which will print the specified array. More...

template<typename Vector >
auto	vector (Vector const &v)
	Returns a manipulator which will print the specified array. More...

template<typename Vector3D >
auto	vector3D (Vector3D const &v)
	Returns a manipulator which will print the specified vector. More...

template<typename Stream , typename Array >
Stream &	operator<< (Stream &&out, ArrayDumper< Array > &&manip)
	Dumps the array contained in the manipulator into a stream. More...

template<typename Stream , typename Vector >
Stream &	operator<< (Stream &&out, VectorDumper< Vector > &&manip)
	Dumps the vector contained in the manipulator into a stream. More...

template<typename String , typename Vector >
String	operator+ (String const &s, VectorDumper< Vector > const &manip)
	Concatenates a vector to the specified string. More...

template<typename Vector >
std::string	operator+ (const char *s, VectorDumper< Vector > const &manip)
	Creates a string with s concatenated to the rendered vector. More...

template<typename String , typename Vector >
String	operator+ (VectorDumper< Vector > const &manip, String const &s)

template<typename Vector >
std::string	operator+ (VectorDumper< Vector > const &manip, const char *s)
	Creates a string with the rendered vector concatenated to s. More...

template<typename String , typename Vector >
String &	operator+= (String &s, VectorDumper< Vector > const &manip)
	Appends a string rendering of a vector to the specified string. More...

Detailed Description

Namespace for LArSoft dumping utilities.

Function Documentation

template<size_t N, typename Array >

auto lar::dump::array ( Array const & a )

Returns a manipulator which will print the specified array.

Template Parameters

N	the number of entries to be printed
Array	the type of array to be printed

Parameters

a	the array to be printed

Returns: a manipulator

Example of usage:

double const data[5] = { 1., 2., 3., 4., 6. };

std::cout << "Data: " << lar::dump::array<5>(data) << std::endl;

will produce an output like:

Data: { 1; 2; 3; 4; 6 }

Addition of specific classes can be achieved via specialization of the class ArrayDumper.

Requirements

the type Array is required to respond to a global function cbegin() (like std::cbegin()) with a forward iterator
the value type of the iterator returned by the aforementioned Array method must have its insertion operator into a stream defined
the array a must not fall out of scope until the insertion into the stream happens

Definition at line 250 of file DumpUtils.h.

Referenced by lar_content::LArGraph::ConnectRegions(), util::LArFFTW::DoInvFFT(), lar_content::LArGraph::MakeGraph(), and geo::vect::details::makeIndexSeqImpl().

     {
       return ArrayDumper<Array>(a, N);
     }

template<typename String , typename Vector >

String lar::dump::operator+	(	String const &	s,
		VectorDumper< Vector > const &	manip
	)

Concatenates a vector to the specified string.

Template Parameters

String	a string type that can handle "addition" to `std::string`
Vector3D	the type of 3D vector to be printed

Parameters

s	the string
manip	the manipulator containing the vector to be printed

Returns: a new string with s concatenated to a rendering of the vector

See also: VectorDumper

Example of usage:

TVector3 pos;
std::runtime_error e("Position: " + lar::dump::vector3D(pos));
std::cout << e.what() << std::endl;

will produce an output like:

Position: { 0; 0; 0 }

Requirements

the type Vector3D is required to provide constant accessor methods returning the vector components, called X(), Y() and Z()
the values returned by the aforementioned Vector3D methods must have their insertion operator into Stream defined

Definition at line 435 of file DumpUtils.h.

     {
       return s + std::string(manip);
     }

template<typename Vector >

std::string lar::dump::operator+	(	const char *	s,
		VectorDumper< Vector > const &	manip
	)

Creates a string with s concatenated to the rendered vector.

Definition at line 442 of file DumpUtils.h.

     {
       return std::string(s) + manip;
     }

template<typename String , typename Vector >

String lar::dump::operator+	(	VectorDumper< Vector > const &	manip,
		String const &	s
	)

See also: documentation of function with arguments swapped.

Definition at line 449 of file DumpUtils.h.

     {
       return std::string(manip) + s;
     }

template<typename Vector >

std::string lar::dump::operator+	(	VectorDumper< Vector > const &	manip,
		const char *	s
	)

Creates a string with the rendered vector concatenated to s.

Definition at line 456 of file DumpUtils.h.

     {
       return manip + std::string(s);
     }

template<typename String , typename Vector >

String& lar::dump::operator+=	(	String &	s,
		VectorDumper< Vector > const &	manip
	)

Appends a string rendering of a vector to the specified string.

Definition at line 463 of file DumpUtils.h.

Referenced by util::quantities::concepts::Quantity< Unit, T >::operator value_t(), lar::sparse_vector< T >::const_iterator::operator++(), lar::sparse_vector< T >::iterator::operator++(), util::quantities::concepts::Interval< Q, Cat >::operator+=(), util::quantities::concepts::Point< Q, Cat, IV >::operator+=(), lar::sparse_vector< T >::const_iterator::operator-=(), lar::sparse_vector< T >::iterator::operator-=(), and sim::SimPhotons::SimPhotons().

     {
       return s += std::string(manip);
     }

template<typename Stream , typename Array >

Stream& lar::dump::operator<<	(	Stream &&	out,
		ArrayDumper< Array > &&	manip
	)

Dumps the array contained in the manipulator into a stream.

Template Parameters

Stream	the type of output stream
Array	the type of array to be printed
NPrint	the number of element of the array to be printed

Parameters

out	the output stream
manip	the manipulator containing the array to be printed

Returns: a reference to the output stream

See also: ArrayDumper

Example of usage:

double const data[5] = { 1., 2., 3., 4., 6. };

std::cout << "Position: " << lar::dump::array<5>(data) << std::endl;

will produce an output like:

Position: { 1, 2, 3, 4, 5 }

Requirements

the type Vector3D is required to provide constant accessor methods returning the vector components, called X(), Y() and Z()
the values returned by the aforementioned Vector3D methods must have their insertion operator into Stream defined

Definition at line 362 of file DumpUtils.h.

     {
       manip(std::forward<Stream>(out));
       return out;
     }

template<typename Stream , typename Vector >

Stream& lar::dump::operator<<	(	Stream &&	out,
		VectorDumper< Vector > &&	manip
	)

Dumps the vector contained in the manipulator into a stream.

Template Parameters

Stream	the type of output stream
Vector3D	the type of 3D vector to be printed

Parameters

out	the output stream
manip	the manipulator containing the vector to be printed

Returns: a reference to the output stream

See also: VectorDumper

Example of usage:

TVector3 pos;

std::cout << "Position: " << lar::dump::vector3D(pos) << std::endl;

will produce an output like:

Position: { 0; 0; 0 }

Requirements

the type Vector3D is required to provide constant accessor methods returning the vector components, called X(), Y() and Z()
the values returned by the aforementioned Vector3D methods must have their insertion operator into Stream defined

Definition at line 398 of file DumpUtils.h.

     {
       manip(std::forward<Stream>(out));
       return out;
     }

template<typename Vector >

auto lar::dump::vector ( Vector const & v )

Returns a manipulator which will print the specified array.

Template Parameters

Vector type of vector to be printed

Parameters

v	the vector to be printed

Returns: a manipulator

Example of usage:

std::vector<double> data = { 1., 2., 3., 4., 6. };

std::cout << "Data: " << lar::dump::vector(data) << std::endl;

will produce an output like:

Data: { 1; 2; 3; 4; 6 }

Addition of specific classes can be achieved via specialization of the class ArrayDumper.

Requirements

a method Vector::size() const must be available returning the number of elements in the vector
the type Vector is required to respond to a global function cbegin() (like std::cbegin()) with a forward iterator
the value type returned by the aforementioned Vector method must have its insertion operator into a stream defined
the vector v must not fall out of scope until the insertion into the stream happens

Definition at line 289 of file DumpUtils.h.

     {
       return ArrayDumper<Vector>(v, v.size());
     }

template<typename Vector3D >

auto lar::dump::vector3D ( Vector3D const & v )

Returns a manipulator which will print the specified vector.

Template Parameters

Vector3D the type of 3D vector to be printed

Parameters

v	the vector to be printed

Returns: a manipulator

Example of usage:

TVector3 pos;

std::cout << "Position: " << lar::dump::vector3D(pos) << std::endl;

will produce an output like:

Position: { 0; 0; 0 }

Addition of specific classes can be achieved via specialization of the class VectorDumper.

Requirements

the type Vector3D is required to provide constant accessor methods returning the vector components, called X(), Y() and Z()
the values returned by the aforementioned Vector3D methods must have their insertion operator into a stream defined
the vector v must not fall out of scope until the insertion into the stream happens

Definition at line 326 of file DumpUtils.h.

Referenced by phot::PhotonLibraryAnalyzer::beginJob(), and sim::dump::DumpMCParticle().

     {
       return VectorDumper<Vector3D>(v);
     }

Namespaces

Classes

Functions

Detailed Description

Function Documentation

Requirements

Requirements

Requirements

Requirements

Requirements

Requirements