RootNTuple Class Reference

#include <LdfNTuple.h>

Inheritance diagram for RootNTuple:

[legend]Collaboration diagram for RootNTuple:

[legend]List of all members.

---

Detailed Description

A DataSource class implemented with a ROOT TBranch objects from a ROOT TTree to store the column data.

Author:

Kaustuv <Kaustuv@stanford.edu>

Paul F. Kunz <Paul_Kunz@slac.stanford.edu>

Definition at line 31 of file LdfNTuple.h.

Public Types
typedef void(hippodraw::Observer::*	Action )(const Observable *)
	The member function of the Observer that is called.
typedef std::list< hippodraw::Observer * >	ObserverList_t
	The type of STL container to maintain list of Observer objects.
Public Member Functions
int	addColumn (const std::string &label, const std::vector< double > &column)
	Adds a column to the end of the RootNTuple.
int	addColumn (const std::string &label, const std::vector< double > &column)
	Adds a column to the end of the RootNTuple.
void	addObserver (hippodraw::Observer *)
	Adds an Observer to the Observer list.
virtual void	addRow (const std::vector< double > &row)
	Raises an assertion, as the contained ROOT file should not be changed.
virtual void	addRow (const std::vector< double > &row)
	Raises an assertion, as the contained ROOT file should not be changed.
virtual void	clear ()
	Removes all the cached data vectors, does not change the contained ROOT file.
virtual void	clear ()
	Removes all the cached data vectors, does not change the contained ROOT file.
unsigned int	columns () const
	Returns the number of columns or data arrays available from this DataSource.
virtual void	copy (const DataSource &)
	Raises assertion as contained ROOT NTuple should not be copied.
virtual void	copy (const DataSource &)
	Raises assertion as contained ROOT NTuple should not be copied.
std::string	createBinding (const std::string &name, const std::vector< int > &indices) const
	Creates complete binding string from the array variable name and indexes.
std::string	createBinding (const std::string &name, const std::vector< int > &indices) const
	Creates complete binding string from the array variable name and indexes.
double *	doubleArrayAt (unsigned int row, unsigned int column) const
	Returns pointer to a double array type in given row.
double *	doubleArrayAt (unsigned int row, unsigned int column) const
	Returns pointer to a double array type in given row.
virtual bool	empty () const
	Returns true, if RootNTuple is empty, i.e.
virtual bool	empty () const
	Returns true, if RootNTuple is empty, i.e.
void	expandIfNeeded (const std::vector< std::string > &labels) const
	Expand the labels if needed.
void	expandIfNeeded (const std::vector< std::string > &labels) const
	Expand the labels if needed.
virtual bool	fillRange (unsigned int column, Range &) const
	Fills the Range object from data indexed by column.
float *	floatArrayAt (unsigned int row, unsigned int column) const
	Returns pointer to a float array type in given row.
float *	floatArrayAt (unsigned int row, unsigned int column) const
	Returns pointer to a float array type in given row.
virtual const std::vector< double > &	getColumn (unsigned int index) const
	Returns the data in the column with index column.
virtual const std::vector< double > &	getColumn (const std::string &name, const std::vector< int > &indices) const
	Returns the column with label name.
virtual const std::vector< double > &	getColumn (const std::string &name) const
	Returns the data in the column with label name.
virtual const std::vector< double > &	getColumn (unsigned int index) const
	Returns the data in the column with index column.
virtual const std::vector< double > &	getColumn (const std::string &name, const std::vector< int > &indices) const
	Returns the column with label name.
virtual const std::vector< double > &	getColumn (const std::string &name) const
	Returns the data in the column with label name.
const std::vector< int > &	getColumnShape (unsigned int column) const
	Returns the shape of multidimensional array.
const std::vector< int > &	getColumnShape (unsigned int column) const
	Returns the shape of multidimensional array.
virtual const std::string &	getLabelAt (unsigned int index) const
	Returns the label for the column at index index.
virtual const std::vector< std::string > &	getLabels () const
	Returns the list of available labels.
const std::string &	getName () const
	Returns the name of the ntuple.
const ObserverList_t &	getObservers () const
	Returns the list of observers.
unsigned int	getRank () const
	Returns the rank of the data source.
unsigned int	getRank () const
	Returns the rank of the data source.
virtual const std::vector< double > &	getRow (unsigned int) const =0
	Returns a const reference to slice along the axis known as a row.
virtual const std::vector< double > &	getRow (unsigned int i) const
	Returns a const reference to slice along the axis known as a row.
virtual const std::vector< double > &	getRow (unsigned int i) const
	Returns a const reference to slice along the axis known as a row.
const std::vector< unsigned int > &	getShape () const
	Returns the shape of the data elements.
const std::vector< unsigned int > &	getShape () const
	Returns the shape of the data elements.
TBranch *	getTBranch (const std::string &column)
	Get the TBranch associated with this column.
TBranch *	getTBranch (const std::string &column)
	Get the TBranch associated with this column.
hippodraw::RootData::Type	getType (unsigned int column) const
	Returns the type of data in column.
hippodraw::RootData::Type	getType (unsigned int column) const
	Returns the type of data in column.
virtual int	indexOf (const std::string &label) const
	Returns the index of the column whose label is label.
virtual unsigned int	indexOfMaxElement (unsigned int index) const
	Returns row index of the maximum element in a column for the given column.
virtual unsigned int	indexOfMinElement (unsigned int index) const
	Returns row index of the minimum element in a column for the given column.
int *	intArrayAt (unsigned int row, unsigned int column) const
	Returns pointer to a int array type in given row.
int *	intArrayAt (unsigned int row, unsigned int column) const
	Returns pointer to a int array type in given row.
virtual bool	isMultiDimensional (const std::string &column) const
	Answers if rows of column are composed of the multidimensional data.
virtual bool	isMultiDimensional (const std::string &column) const
	Answers if rows of column are composed of the multidimensional data.
bool	isNull () const
	Returns true if the receiving objects is a null object.
bool	isValidLabel (const std::string &label) const
	Returns true if label is a valid label for a column in the DataSource.
virtual void	notifyObservers () const
	Notifies observers.
virtual void	notifyObservers () const
	Notifies observers.
virtual double	operator[] (std::vector< unsigned int > &indices) const
	Raises an assertion, as a ROOT NTuple does not really have shape.
virtual double	operator[] (std::vector< unsigned int > &indices) const
	Raises an assertion, as a ROOT NTuple does not really have shape.
void	removeObserver (hippodraw::Observer *)
	Removes an Observer from the Observer list.
void	replaceColumn (const std::string &label, const std::vector< double > &data)
	Replaces the data in column labeled label.
void	replaceColumn (unsigned int index, const std::vector< double > &data)
	Replaces the data in column index.
void	replaceColumn (const std::string &label, const std::vector< double > &data)
	Replaces the data in column labeled label.
void	replaceColumn (unsigned int index, const std::vector< double > &data)
	Replaces the data in column index.
virtual void	reserve (unsigned int count)=0
	For each column, reserves enough space for the NTuple to grow to count rows.
virtual void	reserve (unsigned int)
	Does nothing as the contained ROOT file controls the size.
virtual void	reserve (unsigned int)
	Does nothing as the contained ROOT file controls the size.
	RootNTuple (TTree *tree)
	A constructor taking TTree from ROOT file as argument.
	RootNTuple (TTree *tree)
	A constructor taking TTree from ROOT file as argument.
const std::vector< int > &	rowDataDimSize (const std::string &column) const
	Size of the multidimensional matrix in various dimensions.
const std::vector< int > &	rowDataDimSize (const std::string &column) const
	Size of the multidimensional matrix in various dimensions.
virtual unsigned int	rows () const
	Returns the size of the slice for the next to last dimension.
virtual unsigned int	rows () const
	Returns the size of the slice for the next to last dimension.
virtual bool	setLabelAt (const std::string &s, unsigned int index)
	Changes the label of a data column to s.
virtual void	setLabels (const std::vector< std::string > &v)
	Assigns the label to each column from the vector of strings @ v.
void	setName (const std::string &name)
	Sets the name of the ntuple.
virtual bool	setReleventIndex (const std::string &column, const std::vector< unsigned int > &index)
	In case we are dealing with multidimensional data in rows of this column we would like to deal with on one entry of this multidimensional data.
virtual bool	setReleventIndex (const std::string &column, const std::vector< unsigned int > &index)
	In case we are dealing with multidimensional data in rows of this column we would like to deal with on one entry of this multidimensional data.
virtual void	setShape (std::vector< unsigned int > &shape)
	Sets the shape of the data elements.
virtual void	setShape (std::vector< unsigned int > &shape)
	Sets the shape of the data elements.
void	setTitle (const std::string &title)
	Sets the title of the ntuple to title.
void	smartExpandRootNTuple (const std::string &column) const
	Suppose we encounter a RootTuple which has multi-dimensional data sitting in the rows of the concerned column.
void	smartExpandRootNTuple (const std::string &column) const
	Suppose we encounter a RootTuple which has multi-dimensional data sitting in the rows of the concerned column.
virtual double	sum (unsigned int column) const
	Returns the sum of all the elements in the sequence of column column.
virtual void	throwIfInvalidLabel (const std::string &label) const
	Throws a DataSourceException object if label is not a valid label for this DataSource.
void	throwIfInvalidRowSize (const std::vector< double > &row)
	Throws a DataSourceException if the size of the row is not equal to the number of columns, otherwise does nothing.
const std::string &	title () const
	Returns a const reference to the title of the ntuple.
virtual double	valueAt (unsigned int row, unsigned int column) const
	Returns the value in the table in position given by the row and column indexes.
virtual double	valueAt (unsigned int row, unsigned int column) const
	Returns the value in the table in position given by the row and column indexes.
virtual	~RootNTuple ()
	The destructor.
virtual	~RootNTuple ()
	The destructor.
Protected Member Functions
virtual void	addLabel (const std::string &label)
	Adds a new label for a column.
virtual void	copyPrivate (const DataSource &other)
	Copies the contents of the other DataSource.
bool	isValidColumn (unsigned int index) const
	Returns true if index is valid, otherwise throws a DataSourceException.
void	notifyObservers (Action action) const
	An internal method to iterate over all observers and to send the message action.
	RootNTuple (const RootNTuple &)
	The copy constructor.
	RootNTuple ()
	The default constructor.
	RootNTuple (const RootNTuple &)
	The copy constructor.
	RootNTuple ()
	The default constructor.
Protected Attributes
std::vector< double >	m_array
	A temporary array that can be returned by const reference.
std::vector< unsigned int >	m_shape
	The shape of the data.
Private Member Functions
int	addColumn (const std::string &label, RootBranch *)
	Adds a column to the end of the RootNTuple.
int	addColumn (const std::string &label, RootBranch *)
	Adds a column to the end of the RootNTuple.
void	expandIfNeeded (const std::string &label) const
void	expandIfNeeded (const std::string &label) const
void	fillDataCache (unsigned int column)
	Fills the data cache for column column.
void	fillDataCache (unsigned int column)
	Fills the data cache for column column.
void	initBranches ()
	Initializes the columns of the NTuple.
void	initBranches ()
	Initializes the columns of the NTuple.
bool	rotateWheels (std::vector< int > &wheels, const std::vector< int > &sz, unsigned int d)
	A hack to generate labels.
bool	rotateWheels (std::vector< int > &wheels, const std::vector< int > &sz, unsigned int d)
	A hack to generate labels.
Private Attributes
unsigned int	m_cur_entry
	Index into the current position in the branches.
std::vector< RootBranch * >	m_data
	The RootBranch objects that contains the data.
std::vector< std::vector< double > * >	m_data_cache
	A cache of data already read.
std::vector< std::vector< double > * >	m_data_cache
	A cache of data already read.
std::vector< bool >	m_multiDimensional
	Answers if rows of column are composed of the multidimensional data.
TTree *	m_tree
	The ROOT TTree object which is the source of the data.
TTree *	m_tree
	The ROOT TTree object which is the source of the data.

---

Member Typedef Documentation

typedef void( hippodraw::Observer::* Observable::Action)(const Observable *) [inherited]

The member function of the Observer that is called. Definition at line 83 of file Observable.h.

typedef std::list< hippodraw::Observer * > Observable::ObserverList_t [inherited]

The type of STL container to maintain list of Observer objects. Definition at line 46 of file Observable.h.

---

Constructor & Destructor Documentation

RootNTuple::RootNTuple (   )  [protected]

The default constructor. Note: The default constructor is protected because implementation depends on opening ROOT file before adding columns. Definition at line 55 of file LdfNTuple.cxx.

RootNTuple::RootNTuple (  const RootNTuple &   )  [protected]

The copy constructor.

RootNTuple::RootNTuple (  TTree *  tree  )

A constructor taking TTree from ROOT file as argument. Definition at line 46 of file LdfNTuple.cxx. References initBranches().

RootNTuple::~RootNTuple (   )  [virtual]

The destructor. Definition at line 62 of file LdfNTuple.cxx.

RootNTuple::RootNTuple (   )  [protected]

The default constructor. Note: The default constructor is protected because implementation depends on opening ROOT file before adding columns.

RootNTuple::RootNTuple (  const RootNTuple &   )  [protected]

The copy constructor.

RootNTuple::RootNTuple (  TTree *  tree  )

A constructor taking TTree from ROOT file as argument.

virtual RootNTuple::~RootNTuple (   )  [virtual]

The destructor.

---

Member Function Documentation

int RootNTuple::addColumn (  const std::string &  label, const std::vector< double > &  column )

Adds a column to the end of the RootNTuple. If the size of the input array is the same as the size of the existing columns adds input array to then end of the RootNTuple . Gives the column the label label. Returns the index of the newly created column. If the size of the input array differs from the size of existing columns or if the label already exists, then throws a DataSourceException object. Reimplemented in QtRootNTuple.

int RootNTuple::addColumn (  const std::string &  label, RootBranch *  )  [private]

Adds a column to the end of the RootNTuple. If the size of the input array is the same as the size of the existing columns adds input array to then end of the RootNTuple . Gives the column the label label. Returns the index of the newly created column. If the size of the input array differs from the size of existing columns or if the label already exists, then throws a DataSourceException object. Note: This method is private because ROOT files are intended to be read only.

int RootNTuple::addColumn (  const std::string &  label, const std::vector< double > &  column )

Adds a column to the end of the RootNTuple. If the size of the input array is the same as the size of the existing columns adds input array to then end of the RootNTuple . Gives the column the label label. Returns the index of the newly created column. If the size of the input array differs from the size of existing columns or if the label already exists, then throws a DataSourceException object. Reimplemented in QtRootNTuple. Definition at line 294 of file LdfNTuple.cxx. References DataSource::addLabel(), DataSource::indexOf(), m_data, m_data_cache, m_multiDimensional, and rows().

int RootNTuple::addColumn (  const std::string &  label, RootBranch *  )  [private]

Adds a column to the end of the RootNTuple. If the size of the input array is the same as the size of the existing columns adds input array to then end of the RootNTuple . Gives the column the label label. Returns the index of the newly created column. If the size of the input array differs from the size of existing columns or if the label already exists, then throws a DataSourceException object. Note: This method is private because ROOT files are intended to be read only. Definition at line 274 of file LdfNTuple.cxx. References DataSource::addLabel(), DataSource::indexOf(), m_data, and m_data_cache. Referenced by QtRootNTuple::addColumn(), initBranches(), and smartExpandRootNTuple().

void DataSource::addLabel (  const std::string &  label  )  [protected, virtual, inherited]

Adds a new label for a column. Definition at line 150 of file DataSource.cxx. References DataSource::m_labels. Referenced by NumArrayTuple::addColumn(), NTuple::addColumn(), ListTuple::addColumn(), addColumn(), and FitsNTuple::addColumn().

void Observable::addObserver (  hippodraw::Observer *   )  [inherited]

Adds an Observer to the Observer list. Definition at line 49 of file Observable.cxx. References Observable::m_list. Referenced by CutPlotter::addCutTarget(), XyPlotter::addDataRep(), FunctionRep::FunctionRep(), BinningProjector::normalizeTo(), DataRepController::setAxisBindings(), DisplayController::setNTuple(), CutPlotter::setNTuple(), and TextPlotter::setParentDataRep().

virtual void RootNTuple::addRow (  const std::vector< double > &  row  )  [virtual]

Raises an assertion, as the contained ROOT file should not be changed. Implements DataSource.

void RootNTuple::addRow (  const std::vector< double > &  row  )  [virtual]

Raises an assertion, as the contained ROOT file should not be changed. Implements DataSource. Definition at line 243 of file LdfNTuple.cxx.

virtual void RootNTuple::clear (   )  [virtual]

Removes all the cached data vectors, does not change the contained ROOT file. Implements DataSource.

void RootNTuple::clear (   )  [virtual]

Removes all the cached data vectors, does not change the contained ROOT file. Implements DataSource. Definition at line 223 of file LdfNTuple.cxx. References m_data_cache.

unsigned int DataSource::columns (   )  const [inline, inherited]

Returns the number of columns or data arrays available from this DataSource. Note: This function was selected to be in line sine it contributes heavily in time for addRow member function. Definition at line 332 of file DataSource.h. References DataSource::m_labels. Referenced by PyDataSource::addColumn(), ProfileProjector::changedNTuple(), Profile2DProjector::changedNTuple(), MapMatrixProjector::changedNTuple(), Map3Projector::changedNTuple(), Map2Projector::changedNTuple(), Map1Projector::changedNTuple(), DyHist2DProjector::changedNTuple(), DyHist1DProjector::changedNTuple(), QtRootNTuple::columns(), PyDataSource::columns(), NTupleSorter::columns(), NTuple::copy(), NTupleXML::createChildren(), NTupleProjector::dataRange(), NTupleProjector::dataRangeWithError(), hippodraw::Python::export_CircularBuffer(), hippodraw::Python::export_DataSource(), DataSource::fillRange(), NTuple::getColumn(), NTupleProjector::getNTupleAfterCuts(), NumArrayTuple::getNumArray(), NTupleProjector::getPos(), NTupleProjector::getPosWithError(), NTuple::getRow(), DataSource::indexOfMaxElement(), DataSource::indexOfMinElement(), DataSource::isValidColumn(), RTuple::operator[](), NumArrayTuple::replaceColumn(), NTuple::replaceColumn(), ListTuple::replaceColumn(), replaceColumn(), FitsNTuple::replaceColumn(), NTuple::setLabels(), DataSource::sum(), and DataSource::throwIfInvalidRowSize().

virtual void RootNTuple::copy (  const DataSource &   )  [virtual]

Raises assertion as contained ROOT NTuple should not be copied.

void RootNTuple::copy (  const DataSource &   )  [virtual]

Raises assertion as contained ROOT NTuple should not be copied. Definition at line 68 of file LdfNTuple.cxx.

void DataSource::copyPrivate (  const DataSource &  other  )  [protected, virtual, inherited]

Copies the contents of the other DataSource. For use by derived classes only. Definition at line 110 of file DataSource.cxx. References DataSource::m_ds_name, DataSource::m_is_null, DataSource::m_labels, DataSource::m_shape, and DataSource::m_title. Referenced by RTuple::copy(), and NTuple::copy().

std::string RootNTuple::createBinding (  const std::string &  name, const std::vector< int > &  indices )  const

Creates complete binding string from the array variable name and indexes. Reimplemented in QtRootNTuple.

std::string RootNTuple::createBinding (  const std::string &  name, const std::vector< int > &  indices )  const

Creates complete binding string from the array variable name and indexes. Reimplemented in QtRootNTuple. Definition at line 576 of file LdfNTuple.cxx. References num_util::size(). Referenced by QtRootNTuple::createBinding(), and getColumn().

double* RootNTuple::doubleArrayAt (  unsigned int  row, unsigned int  column )  const

Returns pointer to a double array type in given row.

double * RootNTuple::doubleArrayAt (  unsigned int  row, unsigned int  column )  const

Returns pointer to a double array type in given row. Definition at line 195 of file LdfNTuple.cxx. References num_util::data(), and m_data. Referenced by QtRootNTuple::valueAt().

virtual bool RootNTuple::empty (   )  const [virtual]

Returns true, if RootNTuple is empty, i.e. has no data. Implements DataSource.

bool RootNTuple::empty (   )  const [virtual]

Returns true, if RootNTuple is empty, i.e. has no data. Implements DataSource. Definition at line 164 of file LdfNTuple.cxx. References rows().

void RootNTuple::expandIfNeeded (  const std::string &  label  )  const [private]

void RootNTuple::expandIfNeeded (  const std::vector< std::string > &  labels  )  const

Expand the labels if needed. For each label in labels, expand the variable name if it is an array. Note: Although the object changes its labels, it is still logically a const function as the state of the data doesn't change. Reimplemented in QtRootNTuple.

void RootNTuple::expandIfNeeded (  const std::string &  label  )  const [private]

Definition at line 509 of file LdfNTuple.cxx. References isMultiDimensional(), and smartExpandRootNTuple().

void RootNTuple::expandIfNeeded (  const std::vector< std::string > &  labels  )  const

Expand the labels if needed. For each label in labels, expand the variable name if it is an array. Note: Although the object changes its labels, it is still logically a const function as the state of the data doesn't change. Reimplemented in QtRootNTuple. Definition at line 524 of file LdfNTuple.cxx. References num_util::size(). Referenced by QtRootNTuple::expandIfNeeded(), and getColumn().

void RootNTuple::fillDataCache (  unsigned int  column  )  [private]

Fills the data cache for column column.

void RootNTuple::fillDataCache (  unsigned int  column  )  [private]

Fills the data cache for column column. Definition at line 150 of file LdfNTuple.cxx. References num_util::data(), m_data, m_data_cache, operator[](), rows(), num_util::size(), and valueAt(). Referenced by getColumn(), and valueAt().

bool DataSource::fillRange (  unsigned int  column, Range &  )  const [virtual, inherited]

Fills the Range object from data indexed by column. Returns true if all the data in the column was valid, otherwise returns false. Invalid data is +/- HUGE_VAL or NAN. Invalid data is not used in setting the range. Reimplemented in NTuple, and FitsNTuple. Definition at line 323 of file DataSource.cxx. References DataSource::columns(), std::max(), std::min(), DataSource::rows(), Range::setRange(), num_util::size(), and DataSource::valueAt().

float* RootNTuple::floatArrayAt (  unsigned int  row, unsigned int  column )  const

Returns pointer to a float array type in given row.

float * RootNTuple::floatArrayAt (  unsigned int  row, unsigned int  column )  const

Returns pointer to a float array type in given row. Definition at line 204 of file LdfNTuple.cxx. References num_util::data(), and m_data. Referenced by QtRootNTuple::valueAt().

virtual const std::vector< double >& RootNTuple::getColumn (  unsigned int  index  )  const [virtual]

Returns the data in the column with index column. Reimplemented from DataSource. Reimplemented in QtRootNTuple.

virtual const std::vector< double >& RootNTuple::getColumn (  const std::string &  name, const std::vector< int > &  indices )  const [virtual]

Returns the column with label name. The column should be one that has an array on the TBranch. The vector indexes is used as the indexes into the array. Reimplemented in QtRootNTuple.

virtual const std::vector< double >& RootNTuple::getColumn (  const std::string &  name  )  const [virtual]

Returns the data in the column with label name. Reimplemented from DataSource. Reimplemented in QtRootNTuple.

const vector< double > & RootNTuple::getColumn (  unsigned int  index  )  const [virtual]

Returns the data in the column with index column. Reimplemented from DataSource. Reimplemented in QtRootNTuple. Definition at line 558 of file LdfNTuple.cxx. References fillDataCache(), and m_data_cache.

const vector< double > & RootNTuple::getColumn (  const std::string &  name, const std::vector< int > &  indices )  const [virtual]

Returns the column with label name. The column should be one that has an array on the TBranch. The vector indexes is used as the indexes into the array. Reimplemented in QtRootNTuple. Definition at line 548 of file LdfNTuple.cxx. References createBinding(), and getColumn().

const vector< double > & RootNTuple::getColumn (  const std::string &  name  )  const [virtual]

Returns the data in the column with label name. Reimplemented from DataSource. Reimplemented in QtRootNTuple. Definition at line 536 of file LdfNTuple.cxx. References expandIfNeeded(), DataSource::indexOf(), and DataSource::throwIfInvalidLabel(). Referenced by QtRootNTuple::getColumn(), and getColumn().

const std::vector< int >& RootNTuple::getColumnShape (  unsigned int  column  )  const

Returns the shape of multidimensional array.

const vector< int > & RootNTuple::getColumnShape (  unsigned int  column  )  const

Returns the shape of multidimensional array. Definition at line 413 of file LdfNTuple.cxx. References m_data, and rowDataDimSize(). Referenced by rowDataDimSize(), and QtRootNTuple::valueAt().

const string & DataSource::getLabelAt (  unsigned int  index  )  const [virtual, inherited]

Returns the label for the column at index index. Returns the label for the column at index index, or throws a DataSourceException if index is out of range. Definition at line 175 of file DataSource.cxx. References DataSource::isNull(), DataSource::m_labels, and DataSource::title(). Referenced by NTupleXML::createChildren2D(), hippodraw::Python::export_ListTuple(), hippodraw::Python::export_NTuple(), hippodraw::Python::export_NumArrayTuple(), NTupleProjector::getAxisBindings(), NTupleProjector::getXLabel(), NTupleProjector::getYLabel(), Map1Projector::getYLabel(), Profile2DProjector::getZLabel(), MapMatrixProjector::getZLabel(), and Map3Projector::getZLabel().

const vector< string > & DataSource::getLabels (   )  const [virtual, inherited]

Returns the list of available labels. Reimplemented in QtRootNTuple. Definition at line 168 of file DataSource.cxx. References DataSource::m_labels. Referenced by Inspector::availPlotTypesActivated(), hippodraw::Python::export_DataSource(), DisplayController::getDataSourceLabels(), QtRootNTuple::getLabels(), PyDataSource::getLabels(), NTupleProjector::getNTupleAfterCuts(), PyDataSource::replaceColumn(), smartExpandRootNTuple(), Inspector::updateCutVarGroupBox(), and NTupleController::writeNTupleToFile().

const string & DataSource::getName (   )  const [inherited]

Returns the name of the ntuple. See also: m_ds_name. Definition at line 132 of file DataSource.cxx. References DataSource::m_ds_name. Referenced by HiNTupleXML::createElement(), NTupleProjector::getNTupleName(), DataSourceController::registerNTuple(), NTupleController::saveNTuples(), and NTupleXML::setAttributes().

const Observable::ObserverList_t & Observable::getObservers (   )  const [inherited]

Returns the list of observers. Definition at line 57 of file Observable.cxx. References Observable::m_list.

unsigned int RootNTuple::getRank (   )  const

Returns the rank of the data source. Returns the number of axes of the data source, i.e the rank. Reimplemented from DataSource.

unsigned int RootNTuple::getRank (   )  const

Returns the rank of the data source. Returns the number of axes of the data source, i.e the rank. Reimplemented from DataSource. Definition at line 383 of file LdfNTuple.cxx. References DataSource::m_shape.

virtual const std::vector< double >& DataSource::getRow (  unsigned  int  )  const [pure virtual, inherited]

Returns a const reference to slice along the axis known as a row. Referenced by RTuple::copy(), NTuple::copy(), and NTupleController::writeNTupleToFile().

virtual const std::vector< double >& RootNTuple::getRow (  unsigned int  i  )  const [virtual]

Returns a const reference to slice along the axis known as a row.

const vector< double > & RootNTuple::getRow (  unsigned int  row  )  const [virtual]

Returns a const reference to slice along the axis known as a row. Todo: Could bypass calling valueAt if performance is shown to be an issue. Definition at line 261 of file LdfNTuple.cxx. References DataSource::m_array, m_data, num_util::size(), and valueAt().

const std::vector< unsigned int >& RootNTuple::getShape (   )  const

Returns the shape of the data elements. Reimplemented from DataSource.

const vector< unsigned int > & RootNTuple::getShape (   )  const

Returns the shape of the data elements. Reimplemented from DataSource. Definition at line 376 of file LdfNTuple.cxx. References DataSource::m_shape.

TBranch* RootNTuple::getTBranch (  const std::string &  column  )

Get the TBranch associated with this column.

TBranch * RootNTuple::getTBranch (  const std::string &  column  )

Get the TBranch associated with this column. Definition at line 440 of file LdfNTuple.cxx. References DataSource::indexOf(), and m_data. Referenced by smartExpandRootNTuple().

hippodraw::RootData::Type RootNTuple::getType (  unsigned int  column  )  const

Returns the type of data in column.

RootData::Type RootNTuple::getType (  unsigned int  column  )  const

Returns the type of data in column. Definition at line 186 of file LdfNTuple.cxx. References num_util::data(), and m_data. Referenced by QtRootNTuple::valueAt().

int DataSource::indexOf (  const std::string &  label  )  const [virtual, inherited]

Returns the index of the column whose label is label. Returns the index of the data column whose label is label, or -1 if label does not exist. Definition at line 189 of file DataSource.cxx. References std::find(), and DataSource::m_labels. Referenced by NumArrayTuple::addColumn(), NTuple::addColumn(), ListTuple::addColumn(), addColumn(), FitsNTuple::addColumn(), NTuple::getColumn(), getColumn(), DataSource::getColumn(), NumArrayTuple::getNumArray(), getTBranch(), NTupleProjector::indexOf(), isMultiDimensional(), NumArrayTuple::replaceColumn(), NTuple::replaceColumn(), ListTuple::replaceColumn(), replaceColumn(), FitsNTuple::replaceColumn(), rowDataDimSize(), NTupleProjector::setAxisBinding(), setReleventIndex(), smartExpandRootNTuple(), and QtRootNTuple::valueAt().

unsigned int DataSource::indexOfMaxElement (  unsigned int  index  )  const [virtual, inherited]

Returns row index of the maximum element in a column for the given column. Reimplemented in NTuple. Definition at line 377 of file DataSource.cxx. References DataSource::columns(), DataSource::rows(), num_util::size(), and DataSource::valueAt().

unsigned int DataSource::indexOfMinElement (  unsigned int  index  )  const [virtual, inherited]

Returns row index of the minimum element in a column for the given column. Reimplemented in NTuple. Definition at line 398 of file DataSource.cxx. References DataSource::columns(), DataSource::rows(), num_util::size(), and DataSource::valueAt().

void RootNTuple::initBranches (   )  [private]

Initializes the columns of the NTuple.

void RootNTuple::initBranches (   )  [private]

Initializes the columns of the NTuple. Definition at line 75 of file LdfNTuple.cxx. References addColumn(), isMultiDimensional(), m_multiDimensional, and m_tree. Referenced by RootNTuple().

int* RootNTuple::intArrayAt (  unsigned int  row, unsigned int  column )  const

Returns pointer to a int array type in given row.

int * RootNTuple::intArrayAt (  unsigned int  row, unsigned int  column )  const

Returns pointer to a int array type in given row. Definition at line 213 of file LdfNTuple.cxx. References num_util::data(), and m_data. Referenced by QtRootNTuple::valueAt().

virtual bool RootNTuple::isMultiDimensional (  const std::string &  column  )  const [virtual]

Answers if rows of column are composed of the multidimensional data. Reimplemented from DataSource. Reimplemented in QtRootNTuple.

bool RootNTuple::isMultiDimensional (  const std::string &  column  )  const [virtual]

Answers if rows of column are composed of the multidimensional data. Reimplemented from DataSource. Reimplemented in QtRootNTuple. Definition at line 391 of file LdfNTuple.cxx. References DataSource::indexOf(), and m_multiDimensional. Referenced by expandIfNeeded(), initBranches(), QtRootNTuple::isMultiDimensional(), setReleventIndex(), and smartExpandRootNTuple().

bool DataSource::isNull (   )  const [inherited]

Returns true if the receiving objects is a null object. See also: DataSource( bool ). Definition at line 121 of file DataSource.cxx. References DataSource::m_is_null. Referenced by ProfileProjector::execute(), Profile2DProjector::execute(), DataSource::getLabelAt(), NTupleProjector::NTupleProjector(), NTupleProjector::setNTuple(), and NTupleProjector::~NTupleProjector().

bool DataSource::isValidColumn (  unsigned int  index  )  const [protected, inherited]

Returns true if index is valid, otherwise throws a DataSourceException. Definition at line 208 of file DataSource.cxx. References DataSource::columns(), and num_util::size(). Referenced by NTuple::getColumn(), and DataSource::getColumn().

bool DataSource::isValidLabel (  const std::string &  label  )  const [inherited]

Returns true if label is a valid label for a column in the DataSource. The search is case sensitive. If the label is not found, returns false. Definition at line 250 of file DataSource.cxx. References std::find(), and DataSource::m_labels. Referenced by DataSource::throwIfInvalidLabel().

void Observable::notifyObservers (  Action  action  )  const [protected, inherited]

An internal method to iterate over all observers and to send the message action. Definition at line 69 of file Observable.cxx. References std::bind2nd(), std::for_each(), Observable::m_list, and std::mem_fun().

virtual void RootNTuple::notifyObservers (   )  const [virtual]

Notifies observers. Todo: remove this method when Observable is exposed to Python. Reimplemented from Observable.

void RootNTuple::notifyObservers (   )  const [virtual]

Notifies observers. Todo: remove this method when Observable is exposed to Python. Reimplemented from Observable. Definition at line 135 of file LdfNTuple.cxx. References Observable::notifyObservers(). Referenced by replaceColumn().

virtual double RootNTuple::operator[] (  std::vector< unsigned int > &  indices  )  const [virtual]

Raises an assertion, as a ROOT NTuple does not really have shape. Implements DataSource.

double RootNTuple::operator[] (  std::vector< unsigned int > &  indices  )  const [virtual]

Raises an assertion, as a ROOT NTuple does not really have shape. Implements DataSource. Definition at line 250 of file LdfNTuple.cxx. Referenced by fillDataCache().

void Observable::removeObserver (  hippodraw::Observer *   )  [inherited]

Removes an Observer from the Observer list. Definition at line 63 of file Observable.cxx. References Observable::m_list. Referenced by BinningProjector::normalizeTo(), CutPlotter::removeFromTarget(), DisplayController::removeTextObservers(), NTupleProjector::setNTuple(), FunctionRep::willDelete(), FunctionRep::~FunctionRep(), and NTupleProjector::~NTupleProjector().

void RootNTuple::replaceColumn (  const std::string &  label, const std::vector< double > &  data )

Replaces the data in column labeled label. If the label is valid and if the size of data is the same as existing columns, then replaces the specified column with a copy of data in data. If the label is not valid or the sizes differ, then throws a DataSourceException. In neither case is the ROOT file modified.

void RootNTuple::replaceColumn (  unsigned int  index, const std::vector< double > &  data )

Replaces the data in column index. If index is in a valid range and if the size of data is the same as existing columns, then replaces the specified column with a copy of data in data. If index is not a valid range or the sizes differ, then throws a DataSourceException. In neither case is the ROOT file modified.

void RootNTuple::replaceColumn (  const std::string &  label, const std::vector< double > &  data )

Replaces the data in column labeled label. If the label is valid and if the size of data is the same as existing columns, then replaces the specified column with a copy of data in data. If the label is not valid or the sizes differ, then throws a DataSourceException. In neither case is the ROOT file modified. Definition at line 353 of file LdfNTuple.cxx. References DataSource::indexOf(), and replaceColumn().

void RootNTuple::replaceColumn (  unsigned int  index, const std::vector< double > &  data )

Replaces the data in column index. If index is in a valid range and if the size of data is the same as existing columns, then replaces the specified column with a copy of data in data. If index is not a valid range or the sizes differ, then throws a DataSourceException. In neither case is the ROOT file modified. Definition at line 327 of file LdfNTuple.cxx. References DataSource::columns(), std::copy(), m_data_cache, notifyObservers(), rows(), and num_util::size(). Referenced by hippodraw::Python::export_RootNTuple(), and replaceColumn().

virtual void DataSource::reserve (  unsigned int  count  )  [pure virtual, inherited]

For each column, reserves enough space for the NTuple to grow to count rows. Implemented in CircularBuffer, NTuple, RTuple, FitsNTuple, NumArrayTuple, and ListTuple.

virtual void RootNTuple::reserve (  unsigned  int  )  [virtual]

Does nothing as the contained ROOT file controls the size.

void RootNTuple::reserve (  unsigned  int  )  [virtual]

Does nothing as the contained ROOT file controls the size. Definition at line 236 of file LdfNTuple.cxx.

bool RootNTuple::rotateWheels (  std::vector< int > &  wheels, const std::vector< int > &  sz, unsigned int  d )  [private]

A hack to generate labels.

bool RootNTuple::rotateWheels (  std::vector< int > &  wheels, const std::vector< int > &  sz, unsigned int  d )  [private]

A hack to generate labels. Definition at line 100 of file LdfNTuple.cxx. Referenced by smartExpandRootNTuple().

const std::vector< int >& RootNTuple::rowDataDimSize (  const std::string &  column  )  const

Size of the multidimensional matrix in various dimensions. Returns the shape of multidimensional array. Note: Chose int to be compatible with num_util.

const vector< int > & RootNTuple::rowDataDimSize (  const std::string &  column  )  const

Size of the multidimensional matrix in various dimensions. Returns the shape of multidimensional array. Note: Chose int to be compatible with num_util. Definition at line 400 of file LdfNTuple.cxx. References getColumnShape(), and DataSource::indexOf(). Referenced by getColumnShape(), QtRootNTuple::rowDataDimSize(), and smartExpandRootNTuple().

virtual unsigned int RootNTuple::rows (   )  const [virtual]

Returns the size of the slice for the next to last dimension. Implements DataSource.

unsigned int RootNTuple::rows (   )  const [virtual]

Returns the size of the slice for the next to last dimension. Implements DataSource. Definition at line 142 of file LdfNTuple.cxx. References m_tree. Referenced by addColumn(), empty(), fillDataCache(), replaceColumn(), and QtRootNTuple::rows().

bool DataSource::setLabelAt (  const std::string &  s, unsigned int  index )  [virtual, inherited]

Changes the label of a data column to s. Parameters: s  the new label. index  the column number starting at zero. Returns: true if index is less than the width of the ntuple; otherwise, it does nothing and returns false. Definition at line 157 of file DataSource.cxx. References DataSource::m_labels, and Observable::notifyObservers().

void DataSource::setLabels (  const std::vector< std::string > &  v  )  [virtual, inherited]

Assigns the label to each column from the vector of strings @ v. Reimplemented in NTuple. Definition at line 289 of file DataSource.cxx. References DataSource::m_labels, and Observable::notifyObservers(). Referenced by hippodraw::Python::export_ListTuple(), hippodraw::Python::export_NumArrayTuple(), RTuple::RTuple(), and NTuple::setLabels().

void DataSource::setName (  const std::string &  name  )  [inherited]

Sets the name of the ntuple. See also: m_ds_name. Definition at line 126 of file DataSource.cxx. References DataSource::m_ds_name, and Observable::notifyObservers(). Referenced by NTupleController::createNTuple(), hippodraw::Python::export_DataSource(), PyDataSource::registerNTuple(), DataSourceController::registerNTuple(), and PyDataSource::setName().

virtual bool RootNTuple::setReleventIndex (  const std::string &  column, const std::vector< unsigned int > &  index )  [virtual]

In case we are dealing with multidimensional data in rows of this column we would like to deal with on one entry of this multidimensional data. So here we set this relevant entry. Reimplemented from DataSource.

bool RootNTuple::setReleventIndex (  const std::string &  column, const std::vector< unsigned int > &  index )  [virtual]

In case we are dealing with multidimensional data in rows of this column we would like to deal with on one entry of this multidimensional data. So here we set this relevant entry. Reimplemented from DataSource. Definition at line 422 of file LdfNTuple.cxx. References DataSource::indexOf(), isMultiDimensional(), and m_data. Referenced by smartExpandRootNTuple().

virtual void RootNTuple::setShape (  std::vector< unsigned int > &  shape  )  [virtual]

Sets the shape of the data elements. Sets the shape data elements from the vector shape. The rank is given by the size of the vector. A rank of 2 correspond to table. If the total number of elements in the RootNTuple is not equal to the product of the shape, then an assertion is raised. Reimplemented from DataSource.

void RootNTuple::setShape (  std::vector< unsigned int > &  shape  )  [virtual]

Sets the shape of the data elements. Sets the shape data elements from the vector shape. The rank is given by the size of the vector. A rank of 2 correspond to table. If the total number of elements in the RootNTuple is not equal to the product of the shape, then an assertion is raised. Reimplemented from DataSource. Definition at line 363 of file LdfNTuple.cxx. References DataSource::m_shape, and num_util::size().

void DataSource::setTitle (  const std::string &  title  )  [inherited]

Sets the title of the ntuple to title. Definition at line 142 of file DataSource.cxx. References DataSource::m_title, and Observable::notifyObservers(). Referenced by hippodraw::Python::export_DataSource(), NTupleController::readAsciiNTuple(), and PyDataSource::setTitle().

void RootNTuple::smartExpandRootNTuple (  const std::string &  column  )  const

Suppose we encounter a RootTuple which has multi-dimensional data sitting in the rows of the concerned column. We expand this new ntuple to have additional columns with labels of form array[i][j][k] provided it has not been done before.

void RootNTuple::smartExpandRootNTuple (  const std::string &  column  )  const

Suppose we encounter a RootTuple which has multi-dimensional data sitting in the rows of the concerned column. We expand this new ntuple to have additional columns with labels of form array[i][j][k] provided it has not been done before. Definition at line 451 of file LdfNTuple.cxx. References addColumn(), DataSource::getLabels(), getTBranch(), DataSource::indexOf(), isMultiDimensional(), m_data, m_multiDimensional, rotateWheels(), rowDataDimSize(), and setReleventIndex(). Referenced by expandIfNeeded().

double DataSource::sum (  unsigned int  column  )  const [virtual, inherited]

Returns the sum of all the elements in the sequence of column column. Reimplemented in NTuple. Definition at line 419 of file DataSource.cxx. References DataSource::columns(), DataSource::rows(), num_util::size(), and DataSource::valueAt().

void DataSource::throwIfInvalidLabel (  const std::string &  label  )  const [virtual, inherited]

Throws a DataSourceException object if label is not a valid label for this DataSource. The exception object contains a message that the label is invalid. Derived classes may over-ride this method with more information on why the label is invalid. Definition at line 264 of file DataSource.cxx. References DataSource::isValidLabel(). Referenced by NTuple::getColumn(), getColumn(), and QtRootNTuple::valueAt().

void DataSource::throwIfInvalidRowSize (  const std::vector< double > &  row  )  [inherited]

Throws a DataSourceException if the size of the row is not equal to the number of columns, otherwise does nothing. Definition at line 277 of file DataSource.cxx. References DataSource::columns(), and num_util::size(). Referenced by RTuple::addRow(), NTuple::addRow(), and NTuple::replaceRow().

const string & DataSource::title (   )  const [inherited]

Returns a const reference to the title of the ntuple. Definition at line 137 of file DataSource.cxx. References DataSource::m_title. Referenced by hippodraw::Python::export_DataSource(), DataSource::getLabelAt(), PyDataSource::getTitle(), NTupleProjector::getTitle(), and NTupleController::writeNTupleToFile().

virtual double RootNTuple::valueAt (  unsigned int  row, unsigned int  column )  const [virtual]

Returns the value in the table in position given by the row and column indexes. Implements DataSource.

double RootNTuple::valueAt (  unsigned int  row, unsigned int  column )  const [virtual]

Returns the value in the table in position given by the row and column indexes. Implements DataSource. Definition at line 171 of file LdfNTuple.cxx. References fillDataCache(), and m_data_cache. Referenced by fillDataCache(), and getRow().

---

Member Data Documentation

std::vector< double > DataSource::m_array [mutable, protected, inherited]

A temporary array that can be returned by const reference. Definition at line 81 of file DataSource.h. Referenced by DataSource::getColumn(), getRow(), and FitsNTuple::getRow().

unsigned int RootNTuple::m_cur_entry [mutable, private]

Index into the current position in the branches. Definition at line 55 of file RootNTuple.h.

std::vector< RootBranch * > RootNTuple::m_data [private]

The RootBranch objects that contains the data. Definition at line 38 of file RootNTuple.h. Referenced by addColumn(), doubleArrayAt(), fillDataCache(), floatArrayAt(), getColumnShape(), getRow(), getTBranch(), getType(), intArrayAt(), setReleventIndex(), and smartExpandRootNTuple().

std::vector< std::vector < double > * > RootNTuple::m_data_cache [private]

A cache of data already read. Definition at line 42 of file RootNTuple.h.

std::vector< std::vector < double > * > RootNTuple::m_data_cache [private]

A cache of data already read. Definition at line 42 of file LdfNTuple.h. Referenced by addColumn(), clear(), fillDataCache(), getColumn(), replaceColumn(), and valueAt().

std::vector< bool > RootNTuple::m_multiDimensional [private]

Answers if rows of column are composed of the multidimensional data. Definition at line 47 of file RootNTuple.h. Referenced by addColumn(), initBranches(), isMultiDimensional(), and smartExpandRootNTuple().

std::vector< unsigned int > DataSource::m_shape [protected, inherited]

The shape of the data. The elements the DataSource can have an arbitrary number of dimensions, called rank. An ordinary table has rank of 2 and the shape is number of columns and number of rows. That is m_shape[0] is number of columns and m_share[1] is number of rows. Definition at line 89 of file DataSource.h. Referenced by DataSource::copyPrivate(), NumArrayTuple::getRank(), ListTuple::getRank(), getRank(), FitsNTuple::getRank(), DataSource::getRank(), NumArrayTuple::getShape(), ListTuple::getShape(), getShape(), FitsNTuple::getShape(), DataSource::getShape(), RTuple::operator[](), NTuple::operator[](), NumArrayTuple::setShape(), ListTuple::setShape(), setShape(), FitsNTuple::setShape(), and DataSource::setShape().

TTree* RootNTuple::m_tree [private]

The ROOT TTree object which is the source of the data. Definition at line 51 of file RootNTuple.h.

TTree* RootNTuple::m_tree [private]

The ROOT TTree object which is the source of the data. Definition at line 51 of file LdfNTuple.h. Referenced by initBranches(), and rows().

---

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

• LdfNTuple.h
• RootNTuple.h
• LdfNTuple.cxx
• RootNTuple.cxx

---