#include <DataSource.h>
A data source is a class which is able to supply one or more arrays of data. Access to the arrays can be by name, called a label, or by an index. It provides translation of label to index and vice verse. It also provides a name by which it can be uniquely identified in a client application and a title for the data set. These attributes have concrete implementations in this base class.
All member functions that access the data are pure virtual functions in this class and thus must be implemented in derived classes. This class does not provide the interface for creating or modifying the data.
A DataSource can also have a shape, meaning that a single array can be seen as a multi-dimension array with different sizes of each dimension.
Definition at line 55 of file DataSource.h.
Public Types | |
typedef void(Observer::* | Action )(const Observable *) |
The member function of the Observer that is called. | |
typedef std::list < Observer * > | ObserverList_t |
The type of STL container to maintain list of Observer objects. | |
Public Member Functions | |
virtual int | addColumn (const std::string &label, const std::vector< double > &data) |
Adds column vector. | |
virtual int | addColumn (const std::string &label, const std::vector< double > &data, const std::vector< intptr_t > &shape) |
Adds column vector. | |
void | addObserver (Observer *) |
Adds an Observer to the Observer list. | |
virtual void | addRow (const std::vector< double > &row) |
Adds a row to the data source. | |
virtual void | append (const DataSource *source) |
Appends the contents of the DataSource source. | |
virtual void | clear ()=0 |
Clears the data source. | |
unsigned int | columns () const |
Returns the number of columns or data arrays available from this DataSource. | |
virtual double * | doubleArrayAt (unsigned int row, unsigned int column) const |
Returns an array at row and column. | |
virtual bool | empty () const =0 |
Returns true , if DataSource is empty, i.e., has no data. | |
virtual void | eraseRow (unsigned int index) |
Erase a row from the data source. | |
virtual void | expandIfNeeded (const std::vector< std::string > &labels) const |
Expand the multidimension column if needed. | |
virtual bool | fillRange (unsigned int column, Range &) const |
Fills the Range object from data indexed by column. | |
virtual void | fillShape (std::vector< int > &v, const std::string &label) const |
Fills the vector with the shape of a column. | |
virtual void | fillShape (std::vector< int > &v, unsigned int column) const |
Fills the vector with the shape of a column. | |
virtual const std::vector< double > & | getColumn (unsigned int column) const |
Returns the data in the column with index column. | |
virtual const std::vector< double > & | getColumn (const std::string &name) const |
Returns the data in the column with label name. | |
const std::vector < std::string > & | getDuplicatedLabels () const |
Returns the column labels that were duplicated, or an empty vector. | |
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 data source. | |
const ObserverList_t & | getObservers () const |
Returns the list of observers. | |
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 < unsigned int > & | getShape () const |
Returns the shape of the data elements. | |
virtual int | indexOf (const std::string &label) const |
Returns true if the specified column labeled label has been filled. | |
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. | |
virtual bool | isMultiDimensional (const std::string &column) const |
Returns true if the column contains multidimensional data. | |
bool | isNull () const |
Returns true if the receiving objects is a null object. | |
virtual bool | isUseable (const std::string &column) const |
Returns true if the column is usable. | |
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 Observer objects of a change. | |
virtual double | operator[] (std::vector< unsigned int > &indices) const =0 |
void | removeObserver (Observer *) |
Removes an Observer from the Observer list. | |
virtual void | replaceColumn (const std::string &label, const std::vector< double > &data, const std::vector< intptr_t > &shape) |
Replaces or adds column vector. | |
virtual void | replaceColumn (unsigned int index, const std::vector< double > &array) |
Replaces column at index with the contents of array. | |
virtual void | replaceColumn (const std::string &label, const std::vector< double > &array) |
Replaces data in column label with contents of array. | |
virtual void | reserve (unsigned int count)=0 |
For each column, reserves enough space for the data source to grow to count rows. | |
virtual unsigned int | rows () const =0 |
Returns the number of rows. | |
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 data source. | |
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 | setTitle (const std::string &title) |
Sets the title of the data source to title. | |
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 data source. | |
virtual double | valueAt (unsigned int row, unsigned int column) const =0 |
Returns the value in the table in position given by the row and column indexes. | |
virtual double | valueAtNoCache (unsigned int row, unsigned int column) const |
Returns the value in the table in position given by the row and column indexes without storing it into cache. | |
virtual | ~DataSource () |
The destructor. | |
Protected Member Functions | |
virtual void | addLabel (const std::string &label) |
Adds a new label for a column. | |
virtual void | checkWidth (const DataSource *source) |
Checks the number of columns. | |
virtual void | copyPrivate (const DataSource &other) |
Copies the contents of the other DataSource. | |
DataSource () | |
The default constructor creating an data source with 0 columns. | |
DataSource (bool dummy) | |
A constructor for creating a null object. | |
DataSource (const DataSource &nt) | |
The copy constructor creates an data source that is a copy of an existing one. | |
DataSource (const char *name) | |
Constructs an DataSource object with name name. | |
DataSource (const std::string &name) | |
Constructs an DataSource object with name name. | |
DataSource (const std::vector< std::string > &labels) | |
A constructor taking list of array labels as argument. | |
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. | |
Protected Attributes | |
std::vector< double > | m_array |
A temporary array that can be returned by const reference. | |
std::vector < std::string > | m_dups |
A list of labels that duplicated others in a DataSource file. | |
std::vector < unsigned int > | m_shape |
The shape of the data. | |
Private Attributes | |
std::string | m_ds_name |
The name of the data source . | |
bool | m_is_null |
A flag to indicate the object is null. | |
std::vector < std::string > | m_labels |
The labels of the vectors of the data. | |
std::string | m_title |
The title. |
typedef void( Observer::* Action)(const Observable *) [inherited] |
typedef std::list< Observer * > ObserverList_t [inherited] |
The type of STL container to maintain list of Observer objects.
Definition at line 45 of file Observable.h.
DataSource | ( | const std::vector< std::string > & | labels | ) | [protected] |
A constructor taking list of array labels as argument.
Definition at line 85 of file DataSource.cxx.
DataSource | ( | const std::string & | name | ) | [protected] |
DataSource | ( | const char * | name | ) | [protected] |
Constructs an DataSource object with name name.
Definition at line 66 of file DataSource.cxx.
DataSource | ( | const DataSource & | nt | ) | [protected] |
The copy constructor creates an data source that is a copy of an existing one.
Definition at line 74 of file DataSource.cxx.
DataSource | ( | bool | dummy | ) | [protected] |
A constructor for creating a null object.
A null DataSource is one that is a place holder for one that got deleted while other objects were referencing it. This can happen, for example, if a user deletes an DataSource before deleting other objects that use it. Classes that reference DataSource objects can be Observer of then in order to receive the Observer::willDelete signal. When received they can replace the referenced DataSource with a null one. They can then continue to function until a valid data source is given to them. The parameter dummy is not used.
Definition at line 100 of file DataSource.cxx.
DataSource | ( | ) | [protected] |
The default constructor creating an data source with 0 columns.
Definition at line 92 of file DataSource.cxx.
~DataSource | ( | ) | [virtual] |
The destructor.
Definition at line 107 of file DataSource.cxx.
References Observable::notifyObservers(), and Observer::willDelete().
int addColumn | ( | const std::string & | label, | |
const std::vector< double > & | data | |||
) | [virtual] |
Adds column vector.
If implemented in a derived class, adds a new column with label and returns its index.
Reimplemented in NTuple, FitsNTuple, PyNTuple, QtRootNTuple, and RootNTuple.
Definition at line 390 of file DataSource.cxx.
int addColumn | ( | const std::string & | label, | |
const std::vector< double > & | data, | |||
const std::vector< intptr_t > & | shape | |||
) | [virtual] |
Adds column vector.
Adds a new column with label and returns its index. The number of rows, as defined by first element of the shape, must be the same as existing columns, if any. Not all derived classes support the notion of shape, therefore as convenience to developers, the implementation in this base class throws a std::runtime_error object.
Reimplemented in FitsNTuple.
Definition at line 400 of file DataSource.cxx.
void addLabel | ( | const std::string & | label | ) | [protected, virtual] |
Adds a new label for a column.
Definition at line 154 of file DataSource.cxx.
References DataSource::m_labels.
Referenced by RootNTuple::addColumn(), NumArrayTuple::addColumn(), NTuple::addColumn(), ListTuple::addColumn(), and FitsNTuple::addColumn().
void addObserver | ( | hippodraw::Observer * | observer | ) | [inherited] |
Adds an Observer to the Observer list.
Definition at line 52 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().
void addRow | ( | const std::vector< double > & | row | ) | [virtual] |
Adds a row to the data source.
Since most derived classes are not capable of adding a row, the implementation of this member functions throws std::runtime_error.
Reimplemented in CircularBuffer, NTuple, RTuple, and PyNTuple.
Definition at line 548 of file DataSource.cxx.
Referenced by DataSource::append().
void append | ( | const DataSource * | source | ) | [virtual] |
Appends the contents of the DataSource source.
Appends the contents of the DataSource source to end by adding rows.
Reimplemented in NTuple, and PyNTuple.
Definition at line 580 of file DataSource.cxx.
References DataSource::addRow(), DataSource::checkWidth(), DataSource::getRow(), DataSource::rows(), and num_util::size().
Referenced by NTuple::append().
void checkWidth | ( | const DataSource * | source | ) | [protected, virtual] |
Checks the number of columns.
Check that the number of columns of source is the same as the receiving object. Throws a std::runtime_error if they are different, otherwise does nothing.
Definition at line 565 of file DataSource.cxx.
References DataSource::columns(), and hippodraw::String::convert().
Referenced by NTuple::append(), and DataSource::append().
virtual void clear | ( | ) | [pure virtual] |
Clears the data source.
Implemented in CircularBuffer, NTuple, RTuple, FitsNTuple, NumArrayTuple, ListTuple, PyNTuple, and RootNTuple.
Referenced by PyDataSource::clear(), and hippodraw::Python::export_DataSource().
unsigned int columns | ( | ) | const [inline] |
Returns the number of columns or data arrays available from this DataSource.
Reimplemented in QtRootNTuple.
Definition at line 458 of file DataSource.h.
References DataSource::m_labels.
Referenced by PyDataSource::addColumn(), ProfileProjector::changedNTuple(), Profile2DProjector::changedNTuple(), MeshProjector::changedNTuple(), MapMatrixProjector::changedNTuple(), Map3Projector::changedNTuple(), Map2Projector::changedNTuple(), Map1Projector::changedNTuple(), EqualEntriesHist1DProjector::changedNTuple(), DyHist2DProjector::changedNTuple(), DyHist1DProjector::changedNTuple(), DataSource::checkWidth(), QtRootNTuple::columns(), PyDataSource::columns(), NTupleSorter::columns(), NTuple::copy(), CreateNTuple::createButtonClicked(), NTupleXML::createChildren(), NTupleProjector::createEmptyNTuple(), NTupleProjector::dataRange(), NTupleProjector::dataRangeWithError(), hippodraw::Python::export_CircularBuffer(), hippodraw::Python::export_DataSource(), DataSource::fillRange(), NTuple::getColumn(), NumArrayTuple::getNumArray(), NTupleProjector::getPos(), NTupleProjector::getPosWithError(), NTuple::getRow(), DataSource::indexOfMaxElement(), DataSource::indexOfMinElement(), DataSource::isValidColumn(), RTuple::operator[](), RootNTuple::replaceColumn(), NumArrayTuple::replaceColumn(), NTuple::replaceColumn(), ListTuple::replaceColumn(), FitsNTuple::replaceColumn(), NTuple::setLabels(), DataSource::sum(), and DataSource::throwIfInvalidRowSize().
void copyPrivate | ( | const DataSource & | other | ) | [protected, virtual] |
Copies the contents of the other DataSource.
For use by derived classes only.
Definition at line 114 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().
double * doubleArrayAt | ( | unsigned int | row, | |
unsigned int | column | |||
) | const [virtual] |
Returns an array at row and column.
If the DataSource is capable of containing an array in a column, then returns pointer to the array for a single row, otherwise throws std::runtime_error exception.
Reimplemented in FitsNTuple, and RootNTuple.
Definition at line 593 of file DataSource.cxx.
virtual bool empty | ( | ) | const [pure virtual] |
Returns true
, if DataSource is empty, i.e., has no data.
Implemented in NTuple, RTuple, FitsNTuple, NumArrayTuple, ListTuple, and RootNTuple.
void eraseRow | ( | unsigned int | index | ) | [virtual] |
Erase a row from the data source.
The implementation throws std::runtime_error.
Reimplemented in NTuple.
Definition at line 556 of file DataSource.cxx.
void expandIfNeeded | ( | const std::vector< std::string > & | labels | ) | const [virtual] |
Expand the multidimension column if needed.
Do nothing in base class. Reimplemented in RootNTuple.
Reimplemented in QtRootNTuple, and RootNTuple.
Definition at line 602 of file DataSource.cxx.
Referenced by DataRepController::createDataRep(), and DisplayController::createDisplay().
bool fillRange | ( | unsigned int | column, | |
Range & | range | |||
) | const [virtual] |
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 415 of file DataSource.cxx.
References DataSource::columns(), DataSource::rows(), Range::setRange(), num_util::size(), and DataSource::valueAt().
void fillShape | ( | std::vector< int > & | v, | |
const std::string & | label | |||
) | const [virtual] |
Fills the vector with the shape of a column.
Returns via the vector v, the shape of the data at column column. Most derived classes will only support a vector in a column. Thus as convenience to implementers of derived classes the implementation of this base class returns a shape of size 1 containing the number of rows.
Definition at line 328 of file DataSource.cxx.
References DataSource::fillShape(), and DataSource::indexOf().
void fillShape | ( | std::vector< int > & | v, | |
unsigned int | column | |||
) | const [virtual] |
Fills the vector with the shape of a column.
Returns via the vector v, the shape of the data at column column. Most derived classes will only support a vector in a column. Thus as convenience to implementers of derived classes this base class implementation returns a shape of size 1 containing the number of rows.
Reimplemented in RootNTuple.
Definition at line 320 of file DataSource.cxx.
References DataSource::rows().
Referenced by DataSource::fillShape().
const vector< double > & getColumn | ( | unsigned int | column | ) | const [virtual] |
Returns the data in the column with index column.
Reimplemented in NTuple, FitsNTuple, QtRootNTuple, and RootNTuple.
Definition at line 228 of file DataSource.cxx.
References DataSource::isValidColumn(), DataSource::m_array, DataSource::rows(), num_util::size(), and DataSource::valueAt().
const vector< double > & getColumn | ( | const std::string & | name | ) | const [virtual] |
Returns the data in the column with label name.
Reimplemented in NTuple, QtRootNTuple, and RootNTuple.
Definition at line 243 of file DataSource.cxx.
References DataSource::indexOf().
Referenced by PyDataSource::columnAsNumArray(), NTupleXML::createChildren2D(), hippodraw::Python::export_DataSource(), NTupleProjector::fillColumnAfterCuts(), PyDataSource::getColumn(), and ProjectorBase::getZValues().
const vector< string > & getDuplicatedLabels | ( | ) | const |
Returns the column labels that were duplicated, or an empty vector.
Definition at line 534 of file DataSource.cxx.
References DataSource::m_dups.
const string & getLabelAt | ( | unsigned int | index | ) | const [virtual] |
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 179 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(), MeshProjector::getZLabel(), MapMatrixProjector::getZLabel(), and Map3Projector::getZLabel().
const vector< string > & getLabels | ( | ) | const [virtual] |
Returns the list of available labels.
Reimplemented in QtRootNTuple.
Definition at line 172 of file DataSource.cxx.
References DataSource::m_labels.
Referenced by Inspector::availPlotTypesActivated(), NTupleProjector::createEmptyNTuple(), hippodraw::Python::export_DataSource(), DisplayController::getDataSourceLabels(), QtRootNTuple::getLabels(), PyDataSource::getLabels(), RootNTuple::getRow(), PyDataSource::replaceColumn(), RootNTuple::smartExpandRootNTuple(), Inspector::updateCutVarGroupBox(), and NTupleController::writeNTupleToFile().
const string & getName | ( | ) | const |
Returns the name of the data source.
Definition at line 136 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 & getObservers | ( | ) | const [inherited] |
Returns the list of observers.
Definition at line 60 of file Observable.cxx.
References Observable::m_list.
unsigned int getRank | ( | ) | const |
Returns the rank of the data source.
Returns the number of axes of the data source, i.e the rank.
Definition at line 343 of file DataSource.cxx.
References DataSource::m_shape.
Referenced by RTuple::operator[](), NTuple::operator[](), and RootNTuple::smartExpandRootNTuple().
virtual const std::vector< double >& getRow | ( | unsigned | int | ) | const [pure virtual] |
Returns a const reference to slice along the axis known as a row.
Implemented in NTuple, RTuple, FitsNTuple, NumArrayTuple, ListTuple, QtRootNTuple, and RootNTuple.
Referenced by DataSource::append(), RTuple::copy(), NTuple::copy(), and NTupleController::writeNTupleToFile().
const vector< unsigned int > & getShape | ( | ) | const [virtual] |
Returns the shape of the data elements.
Reimplemented in FitsNTuple, NumArrayTuple, ListTuple, and RootNTuple.
Definition at line 313 of file DataSource.cxx.
References DataSource::m_shape.
Referenced by ProjectorBase::getShape().
int indexOf | ( | const std::string & | label | ) | const [virtual] |
Returns true
if the specified column labeled label has been filled.
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 193 of file DataSource.cxx.
References DataSource::m_labels.
Referenced by RootNTuple::addColumn(), NumArrayTuple::addColumn(), NTuple::addColumn(), ListTuple::addColumn(), NTupleController::createNTuple(), DataSource::fillShape(), RootNTuple::getColumn(), NTuple::getColumn(), DataSource::getColumn(), QtRootNTuple::getColumnAsArray(), QtRootNTuple::getColumnShape(), NumArrayTuple::getNumArray(), RootNTuple::getTBranch(), NTupleProjector::indexOf(), RootNTuple::initBranches(), FitsNTuple::initColumns(), RootNTuple::isMultiDimensional(), RootNTuple::isUseable(), NumArrayTuple::replaceColumn(), ListTuple::replaceColumn(), FitsNTuple::replaceColumn(), DataSource::replaceColumn(), NTupleProjector::setAxisBinding(), RootNTuple::setReleventIndex(), RootNTuple::smartExpandRootNTuple(), and QtRootNTuple::valueAt().
unsigned int indexOfMaxElement | ( | unsigned int | index | ) | const [virtual] |
Returns row index of the maximum element in a column for the given column.
Reimplemented in NTuple.
Definition at line 476 of file DataSource.cxx.
References DataSource::columns(), DataSource::rows(), num_util::size(), and DataSource::valueAt().
unsigned int indexOfMinElement | ( | unsigned int | index | ) | const [virtual] |
Returns row index of the minimum element in a column for the given column.
Reimplemented in NTuple.
Definition at line 497 of file DataSource.cxx.
References DataSource::columns(), DataSource::rows(), num_util::size(), and DataSource::valueAt().
bool isMultiDimensional | ( | const std::string & | column | ) | const [virtual] |
Returns true
if the column contains multidimensional data.
Returns false
. Derived classes should return true
if the column contains multidimensional data.
Reimplemented in QtRootNTuple, and RootNTuple.
Definition at line 451 of file DataSource.cxx.
bool isNull | ( | ) | const |
Returns true
if the receiving objects is a null object.
Definition at line 125 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 isUseable | ( | const std::string & | column | ) | const [virtual] |
Returns true
if the column is usable.
Returns true
. Derived classes should return false
if the column is not usable in the context of a DataSource.
Reimplemented in RootNTuple.
Definition at line 458 of file DataSource.cxx.
bool isValidColumn | ( | unsigned int | index | ) | const [protected] |
Returns true
if index is valid, otherwise throws a DataSourceException.
Definition at line 212 of file DataSource.cxx.
References DataSource::columns(), hippodraw::String::convert(), and num_util::size().
Referenced by RootNTuple::getColumn(), NTuple::getColumn(), FitsNTuple::getColumn(), and DataSource::getColumn().
bool isValidLabel | ( | const std::string & | label | ) | const |
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 257 of file DataSource.cxx.
References DataSource::m_labels.
Referenced by FitsNTuple::checkLabel(), and DataSource::throwIfInvalidLabel().
void notifyObservers | ( | Action | action | ) | const [protected, inherited] |
An internal method to iterate over all observers and to send the message action.
Definition at line 72 of file Observable.cxx.
References Observable::m_list.
void notifyObservers | ( | ) | const [virtual, inherited] |
Notifies Observer objects of a change.
If interval counting is disabled, then Observer::Update is sent immediately. If interval counting is enabled, then the current count is incremented. If the current count is equal to the interval count, then the Observer::update message is sent and the current count reset to 0.
Reimplemented in NTuple, FitsNTuple, NumArrayTuple, ListTuple, and RootNTuple.
Definition at line 93 of file Observable.cxx.
References Observer::update().
Referenced by XyPlotter::addDataRep(), XyPlotter::addDataRepStacked(), FunctionController::addFunctionRep(), StHist2DProjector::addValues(), StHist1DProjector::addValues(), XyPlotter::autoScale(), Inspector::contourLevelsTextBox_returnPressed(), Inspector::contourSlider_valueChanged(), Inspector::contourTextBox_returnPressed(), FunctionRep::fitFunction(), RootNTuple::notifyObservers(), NumArrayTuple::notifyObservers(), NTuple::notifyObservers(), ListTuple::notifyObservers(), FitsNTuple::notifyObservers(), XyPlotter::removeDataRep(), FunctionRep::restoreParameters(), DataRep::set(), CutPlotter::setActive(), PlotterBase::setAspectRatio(), XyPlotter::setAutoRanging(), XyPlotter::setBoxEdge(), QtDisplay::setContourLevels(), CutPlotter::setCutColor(), XyPlotter::setCutEnabled(), XyPlotter::setCutInverted(), XyPlotter::setCutRangeAt(), ProjectorBase::setDirty(), DataRep::setErrorDisplay(), XyPlotter::setHighRange(), XyPlotter::setLabel(), PlotterBase::setLabel(), DataSource::setLabelAt(), DataSource::setLabels(), XyPlotter::setLowRange(), DataSource::setName(), DisplayController::setNTuple(), FunctionRep::setParameters(), DyHistogramEqualEntries::setPointRep(), DyHistogram::setPointRep(), DataRep::setPointRep(), TextPlotter::setRepColor(), DataRep::setRepColor(), DataRep::setRepSize(), DataRep::setRepStyle(), XyPlotter::setReverse(), XyPlotter::setScaling(), XyPlotter::setShowGrid(), PlotterBase::setTitle(), DataSource::setTitle(), XyPlotter::setTransform(), XyPlotter::setValueRep(), PlotterBase::update(), NTupleProjector::update(), DataRep::update(), CutPlotter::update(), BinningProjector::update(), CutPlotter::updateTargets(), DataRep::~DataRep(), DataSource::~DataSource(), NTuple::~NTuple(), PlotterBase::~PlotterBase(), RootNTuple::~RootNTuple(), and RTuple::~RTuple().
virtual double operator[] | ( | std::vector< unsigned int > & | indices | ) | const [pure virtual] |
Implemented in NTuple, RTuple, FitsNTuple, NumArrayTuple, ListTuple, and RootNTuple.
void removeObserver | ( | hippodraw::Observer * | observer | ) | [inherited] |
Removes an Observer from the Observer list.
Definition at line 66 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 replaceColumn | ( | const std::string & | label, | |
const std::vector< double > & | data, | |||
const std::vector< intptr_t > & | shape | |||
) | [virtual] |
Replaces or adds column vector.
If column label exists, replaces that column with data, otherwise adds a new column with label. In both cases, the number of rows, as defined by first element of the shape, must be the same as existing columns, if any. Not all derived classes support the notion of shape, therefore as convenience to developers, the implementation in this base class throws a std::runtime_error object.
Reimplemented in FitsNTuple.
Definition at line 378 of file DataSource.cxx.
void replaceColumn | ( | unsigned int | index, | |
const std::vector< double > & | array | |||
) | [virtual] |
Replaces column at index with the contents of array.
Reimplemented in NTuple, FitsNTuple, PyNTuple, and RootNTuple.
Definition at line 350 of file DataSource.cxx.
void replaceColumn | ( | const std::string & | label, | |
const std::vector< double > & | array | |||
) | [virtual] |
Replaces data in column label with contents of array.
If column label label exists, replace it contents with array, otherwise throw std::runtime_error.
Reimplemented in PyNTuple.
Definition at line 360 of file DataSource.cxx.
References DataSource::indexOf().
Referenced by hippodraw::Python::export_DataSource(), hippodraw::Python::export_FitsNTuple(), PyNTuple::replaceColumn(), and PyDataSource::saveColumnFromNumArray().
virtual void reserve | ( | unsigned int | count | ) | [pure virtual] |
For each column, reserves enough space for the data source to grow to count rows.
Implemented in CircularBuffer, NTuple, RTuple, FitsNTuple, NumArrayTuple, ListTuple, and RootNTuple.
virtual unsigned int rows | ( | ) | const [pure virtual] |
Returns the number of rows.
Implemented in NTuple, RTuple, FitsNTuple, NumArrayTuple, ListTuple, QtRootNTuple, and RootNTuple.
Referenced by DataSource::append(), RTuple::copy(), NTuple::copy(), NTupleXML::createChildren2D(), NTupleProjector::createEmptyNTuple(), NTupleController::createNTuple(), NTupleController::createNTupleToFile(), Map1Projector::dataRangeOn(), hippodraw::Python::export_DataSource(), NTupleProjector::fillColumnAfterCuts(), Bins1DHist::fillDataSource(), NTupleProjector::fillNTuple(), DataSource::fillRange(), DataSource::fillShape(), DataSource::getColumn(), NTupleProjector::getNumberOfEntries(), DataSource::indexOfMaxElement(), DataSource::indexOfMinElement(), PyDataSource::rows(), MapMatrixProjector::setNTuple(), DataSource::sum(), NTupleController::writeNTupleToFile(), and FitsController::writeNTupleToFile().
bool setLabelAt | ( | const std::string & | s, | |
unsigned int | index | |||
) | [virtual] |
Changes the label of a data column to s.
s | the new label. | |
index | the column number starting at zero. |
Definition at line 161 of file DataSource.cxx.
References DataSource::m_labels, and Observable::notifyObservers().
void setLabels | ( | const std::vector< std::string > & | v | ) | [virtual] |
Assigns the label to each column from the vector of strings @ v.
Reimplemented in NTuple.
Definition at line 297 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 setName | ( | const std::string & | name | ) |
Sets the name of the data source.
Definition at line 130 of file DataSource.cxx.
References DataSource::m_ds_name, and Observable::notifyObservers().
Referenced by hippodraw::Python::export_DataSource(), PyDataSource::registerNTuple(), DataSourceController::registerNTuple(), and PyDataSource::setName().
bool 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 index of this relevant entry.
Reimplemented in RootNTuple.
Definition at line 465 of file DataSource.cxx.
void 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 DataSource is not equal to the product of the shape, then an assertion is raised.
Reimplemented in FitsNTuple, NumArrayTuple, ListTuple, and RootNTuple.
Definition at line 306 of file DataSource.cxx.
References DataSource::m_shape.
void setTitle | ( | const std::string & | title | ) | [virtual] |
Sets the title of the data source to title.
Reimplemented in PyNTuple.
Definition at line 146 of file DataSource.cxx.
References DataSource::m_title, and Observable::notifyObservers().
Referenced by hippodraw::Python::export_DataSource(), NTupleController::readAsciiNTuple(), PyNTuple::setTitle(), and PyDataSource::setTitle().
double sum | ( | unsigned int | column | ) | const [virtual] |
Returns the sum of all the elements in the sequence of column column.
Reimplemented in NTuple.
Definition at line 518 of file DataSource.cxx.
References DataSource::columns(), DataSource::rows(), num_util::size(), and DataSource::valueAt().
void throwIfInvalidLabel | ( | const std::string & | label | ) | const [virtual] |
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 268 of file DataSource.cxx.
References DataSource::isValidLabel().
Referenced by RootNTuple::getColumn(), NTuple::getColumn(), QtRootNTuple::getColumnAsArray(), and QtRootNTuple::valueAt().
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.
Definition at line 281 of file DataSource.cxx.
References DataSource::columns(), hippodraw::String::convert(), and num_util::size().
Referenced by RTuple::addRow(), NTuple::addRow(), and NTuple::replaceRow().
const string & title | ( | ) | const |
Returns a const reference to the title of the data source.
Definition at line 141 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 valueAt | ( | unsigned int | row, | |
unsigned int | column | |||
) | const [pure virtual] |
Returns the value in the table in position given by the row and column indexes.
Implemented in NTuple, RTuple, FitsNTuple, NumArrayTuple, ListTuple, and RootNTuple.
Referenced by DataSource::fillRange(), DataSource::getColumn(), DataSource::indexOfMaxElement(), DataSource::indexOfMinElement(), DataSource::sum(), and DataSource::valueAtNoCache().
double valueAtNoCache | ( | unsigned int | row, | |
unsigned int | column | |||
) | const [virtual] |
Returns the value in the table in position given by the row and column indexes without storing it into cache.
Reimplemented in RootNTuple.
Definition at line 541 of file DataSource.cxx.
References DataSource::valueAt().
Referenced by NTupleController::createNTuple().
std::vector< double > m_array [mutable, protected] |
A temporary array that can be returned by const reference.
Definition at line 88 of file DataSource.h.
Referenced by DataSource::getColumn(), RootNTuple::getRow(), and FitsNTuple::getRow().
std::string m_ds_name [private] |
The name of the data source .
Although the use of this data member is optional, the suggested use within an application is as follows.
Definition at line 66 of file DataSource.h.
Referenced by DataSource::copyPrivate(), DataSource::getName(), and DataSource::setName().
std::vector< std::string > m_dups [protected] |
A list of labels that duplicated others in a DataSource file.
Definition at line 100 of file DataSource.h.
Referenced by DataSource::getDuplicatedLabels(), RootNTuple::initBranches(), and FitsNTuple::initColumns().
bool m_is_null [private] |
A flag to indicate the object is null.
A null object is a place holder so that classes that use this class can continue to function after their valid object has been deleted. This can happen, for example, if the user deletes his data source without first deleting objects that use it.
Definition at line 82 of file DataSource.h.
Referenced by DataSource::copyPrivate(), and DataSource::isNull().
std::vector<std::string> m_labels [private] |
The labels of the vectors of the data.
Definition at line 74 of file DataSource.h.
Referenced by DataSource::addLabel(), DataSource::columns(), DataSource::copyPrivate(), DataSource::getLabelAt(), DataSource::getLabels(), DataSource::indexOf(), DataSource::isValidLabel(), DataSource::setLabelAt(), and DataSource::setLabels().
std::vector< unsigned int > m_shape [protected] |
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 96 of file DataSource.h.
Referenced by DataSource::copyPrivate(), DataSource::getRank(), RootNTuple::getShape(), NumArrayTuple::getShape(), ListTuple::getShape(), FitsNTuple::getShape(), DataSource::getShape(), RTuple::operator[](), NTuple::operator[](), RootNTuple::setShape(), NumArrayTuple::setShape(), ListTuple::setShape(), FitsNTuple::setShape(), and DataSource::setShape().
std::string m_title [private] |
The title.
The title is descriptive of the data source.
Definition at line 70 of file DataSource.h.
Referenced by DataSource::copyPrivate(), DataSource::setTitle(), and DataSource::title().