AbstractDataTable is the base-class of all DataTable_(templated) allowing storage of DataTable_ templated on different types to be stored in a container like std::vector. More...

Inheritance diagram for OpenSim::AbstractDataTable:

Public Member Functions
	AbstractDataTable ()=default

	AbstractDataTable (const AbstractDataTable &)=default

	AbstractDataTable (AbstractDataTable &&)=default

AbstractDataTable &	operator= (const AbstractDataTable &)=default

AbstractDataTable &	operator= (AbstractDataTable &&)=default

virtual std::shared_ptr< AbstractDataTable >	clone () const =0

virtual	~AbstractDataTable ()=default

virtual unsigned	numComponentsPerElement () const =0
	Get number of components per element of the DataTable. More...

size_t	getNumRows () const
	Get number of rows. More...

size_t	getNumColumns () const
	Get number of dependent columns. More...

bool	hasColumn (const size_t columnIndex) const
	Check if the table has a column with the given index. More...

MetaData accessors/mutators.
template<typename Value >
void	addTableMetaData (const std::string &key, const Value &value)
	Add key-value pair to the table metadata. More...

bool	hasTableMetaDataKey (const std::string &key) const
	Whether or not table metadata for the given key exists. More...

template<typename Value >
Value	getTableMetaData (const std::string &key) const
	Get table metadata for a given key. More...

std::string	getTableMetaDataAsString (const std::string &key) const
	Get table metadata for a given key as a string. More...

void	removeTableMetaDataKey (const std::string &key)
	Remove key-value pair associated with the given key from table metadata. More...

std::vector< std::string >	getTableMetaDataKeys () const
	Get table metadata keys. More...

const TableMetaData &	getTableMetaData () const
	Get metadata associated with the table. More...

TableMetaData &	updTableMetaData ()
	Update metadata associated with the table. More...

const IndependentMetaData &	getIndependentMetaData () const
	Get metadata associated with the independent column. More...

void	setIndependentMetaData (const IndependentMetaData &independentMetaData)
	Set metadata associated with the independent column. More...

const DependentsMetaData &	getDependentsMetaData () const
	Get metadata associated with the dependent columns. More...

void	setDependentsMetaData (const DependentsMetaData &dependentsMetaData)
	Set metadata associated with the dependent columns. More...

void	removeDependentsMetaDataForKey (const std::string &key)
	Remove key-value pair associated with the given key from dependents metadata. More...

Column-labels related accessors/mutators.
Following functions operate on column labels of dependent columns only excluding the independent column. Following are examples on using setColumnLabels(). If you have a sequence of strings, you can pretty much call setColumnLabels() on it. // Simplest way to set column labels is to provide them directly to // setColumnLabels. table.setColumnLabels({"col1", "col2", "col3"}); // if you have a sequence container like std::vector or std::list of // std::string holding column labels, pass the container directly to // setColumnLabels. std::list<std::string> columnLabels{"col1", "col2", "col3"}; table.setColumnLabels(columnLabels); // If you have a sequence container like std::vector or std::list of // std::string holding column labels but you want to use only a subset // of them to set column labels of the table, use iterators like below. std::vector<std::string> columnLabels{"col-not-used1", "col1", "col2", "col3", "col-not-used2"}; table.setColumnLabels(columnLabels.begin() + 1, columnLabels.end() - 1);
bool	hasColumnLabels () const
	Does the table have non-zero number of column labels. More...

std::vector< std::string >	getColumnLabels () const
	Get column labels. More...

const std::string &	getColumnLabel (const size_t columnIndex) const
	Get column label of a given column. More...

template<typename InputIt >
void	setColumnLabels (InputIt first, InputIt last)
	Set column labels using a pair of iterators. More...

template<typename Container >
void	setColumnLabels (const Container &columnLabels)
	Set column labels using a sequence container. More...

void	setColumnLabels (const std::initializer_list< std::string > &columnLabels)
	Set column labels using a std::initializer_list. More...

void	setColumnLabel (const size_t columnIndex, const std::string &columnLabel)
	Set the label for a column. More...

size_t	getColumnIndex (const std::string &columnLabel) const
	Get index of a column label. More...

bool	hasColumn (const std::string &columnLabel) const
	Check if the table has a column with the given label. More...

Detailed Description

AbstractDataTable is the base-class of all DataTable_(templated) allowing storage of DataTable_ templated on different types to be stored in a container like std::vector.

DataTable_ represents a matrix and an additional column. The columns of the matrix are dependent columns. The additional column is the independent column. All dependent columns and the independent column can have metadata. AbstractDataTable offers:

Interface to access metadata of independent column and dependent columns.
A heterogeneous container to store metadata associated with the DataTable_ in the form of key-value pairs where key is of type std::string and value can be of any type.

This class is abstract and cannot be used directly. Create instances of DataTable_ instead. See DataTable_ for details on usage.

Constructor & Destructor Documentation

◆ AbstractDataTable() [1/3]

OpenSim::AbstractDataTable::AbstractDataTable ( )

default

◆ AbstractDataTable() [2/3]

OpenSim::AbstractDataTable::AbstractDataTable ( const AbstractDataTable & )

default

◆ AbstractDataTable() [3/3]

OpenSim::AbstractDataTable::AbstractDataTable ( AbstractDataTable && )

default

◆ ~AbstractDataTable()

virtual OpenSim::AbstractDataTable::~AbstractDataTable ( )

virtualdefault

Member Typedef Documentation

◆ DependentsMetaData

typedef ValueArrayDictionary OpenSim::AbstractDataTable::DependentsMetaData

◆ IndependentMetaData

typedef ValueArrayDictionary OpenSim::AbstractDataTable::IndependentMetaData

◆ TableMetaData

typedef ValueArrayDictionary OpenSim::AbstractDataTable::TableMetaData

Member Function Documentation

◆ addTableMetaData()

template<typename Value >

void OpenSim::AbstractDataTable::addTableMetaData	(	const std::string &	key,
		const Value &	value
	)

inline

Add key-value pair to the table metadata.

If using this function from Python/Java/Matlab, use:

addTableMetaDataString(key, value)

where both 'key' and 'value' are strings. The above call translates to C++ as:

addTableMetaData<std::string>(key, value)

Template Parameters

Value Type of the value. This need not be specified explicitly in most cases. It will be deduced automatically.

Exceptions

KeyExists If the key provided already exists in table metadata.

Examples:: exampleTracking.cpp.

◆ appendColumnLabel()

void OpenSim::AbstractDataTable::appendColumnLabel ( const std::string & columnLabel )

protected

Append column-label.

Referenced by OpenSim::DataTable_< double, SimTK::Real >::appendColumn().

◆ clone()

virtual std::shared_ptr<AbstractDataTable> OpenSim::AbstractDataTable::clone ( ) const

pure virtual

Implemented in OpenSim::DataTable_< ETX, ETY >, OpenSim::DataTable_< double, ETY >, OpenSim::DataTable_< double, ET >, OpenSim::DataTable_< double, Rotation >, OpenSim::DataTable_< double, ValueT >, OpenSim::DataTable_< double, SimTK::Vec3 >, OpenSim::DataTable_< double, SimTK::Rotation >, and OpenSim::DataTable_< double, SimTK::Real >.

◆ getColumnIndex()

size_t OpenSim::AbstractDataTable::getColumnIndex ( const std::string & columnLabel ) const

Get index of a column label.

Exceptions

NoColumnLabels	If table has no column labels.
KeyNotFound	If columnLabel is not found to be label for any column.

Referenced by OpenSim::TableSource_< ET >::getColumnAtTime(), OpenSim::DataTable_< double, SimTK::Real >::getDependentColumn(), and OpenSim::DataTable_< double, SimTK::Real >::updDependentColumn().

◆ getColumnLabel()

const std::string& OpenSim::AbstractDataTable::getColumnLabel ( const size_t columnIndex ) const

Get column label of a given column.

Exceptions

ColumnIndexOutOfRange	If columnIndex is out of range of number of columns.
NoColumnLabels	If column labels have not be set for the table.

◆ getColumnLabels()

std::vector<std::string> OpenSim::AbstractDataTable::getColumnLabels ( ) const

Get column labels.

Exceptions

NoColumnLabels If column labels have not be set for the table.

Referenced by OpenSim::analyze(), OpenSim::TableReporter_< InputT, ValueT >::clearTable(), OpenSim::TabOpUseAbsoluteStateNames::operate(), OpenSim::DataTable_< double, SimTK::Real >::removeColumn(), OpenSim::DataTable_< double, SimTK::Real >::removeColumnAtIndex(), OpenSim::TableSource_< ET >::setTable_impl(), and OpenSim::DataTable_< double, SimTK::Real >::validateDependentsMetaData().

◆ getDependentsMetaData()

const DependentsMetaData& OpenSim::AbstractDataTable::getDependentsMetaData ( ) const

Get metadata associated with the dependent columns.

◆ getIndependentMetaData()

const IndependentMetaData& OpenSim::AbstractDataTable::getIndependentMetaData ( ) const

Get metadata associated with the independent column.

◆ getNumColumns()

size_t OpenSim::AbstractDataTable::getNumColumns ( ) const

Get number of dependent columns.

Referenced by OpenSim::analyze(), OpenSim::DataTable_< double, SimTK::Real >::isEmpty(), OpenSim::DataTable_< double, SimTK::Real >::removeColumnAtIndex(), and OpenSim::TimeSeriesTable_< Rotation >::trimToIndices().

◆ getNumRows()

size_t OpenSim::AbstractDataTable::getNumRows ( ) const

Get number of rows.

Referenced by OpenSim::analyze(), OpenSim::DataTable_< double, SimTK::Real >::appendColumn(), OpenSim::TableSource_< ET >::getColumnAtTime(), OpenSim::TableSource_< ET >::getRowAtTime(), OpenSim::DataTable_< double, SimTK::Real >::isEmpty(), OpenSim::DataTable_< double, SimTK::Real >::removeRowAtIndex(), and OpenSim::TimeSeriesTable_< Rotation >::trim().

◆ getTableMetaData() [1/2]

template<typename Value >

Value OpenSim::AbstractDataTable::getTableMetaData ( const std::string & key ) const

inline

Get table metadata for a given key.

If using this function from Python/Java/Matlab, use the following table:

C++	Python / Java / Matlab	Example
getTableMetaData<std::string>	getTableMetaDataString	Marker table read from a C3D file could contain quantities DataRate and Units that can be retrieved with this method.
getTableMetaData<std::vector<SimTK::Matrix_<double>>>	getTableMetaDataVectorMatrix	Forces table read from a C3D file could contain quantities Calibration Matrices, Force Plate Corners and Force Plate Origins that can be retrieved with this method.
getTableMetaData<std::vector<unsigned>>	getTableMetaDataVectorUnsigned	Forces table read from a C3D file could contain quantity Force Plate Types that can be retrieved with this method

Template Parameters

Value Type of the value to be retrieved. For example if the metadata contains key-value pair ("sample-rate", 200), this could be specified as 'unsigned'.

Exceptions

KeyNotFound If the key provided is not found in table metadata.

◆ getTableMetaData() [2/2]

const TableMetaData& OpenSim::AbstractDataTable::getTableMetaData ( ) const

Get metadata associated with the table.

◆ getTableMetaDataAsString()

std::string OpenSim::AbstractDataTable::getTableMetaDataAsString ( const std::string & key ) const

inline

Get table metadata for a given key as a string.

Exceptions

KeyNotFound If the key provided is not found in table metadata.

Referenced by OpenSim::MocoTrack::setMarkersReferenceFromTRC().

◆ getTableMetaDataKeys()

std::vector<std::string> OpenSim::AbstractDataTable::getTableMetaDataKeys ( ) const

Get table metadata keys.

◆ hasColumn() [1/2]

bool OpenSim::AbstractDataTable::hasColumn ( const std::string & columnLabel ) const

Check if the table has a column with the given label.

Exceptions

NoColumnLabels If table has no column labels.

Referenced by OpenSim::DataTable_< double, SimTK::Real >::appendColumn().

◆ hasColumn() [2/2]

bool OpenSim::AbstractDataTable::hasColumn ( const size_t columnIndex ) const

Check if the table has a column with the given index.

◆ hasColumnLabels()

bool OpenSim::AbstractDataTable::hasColumnLabels ( ) const

Does the table have non-zero number of column labels.

Referenced by OpenSim::TableReporter_< InputT, ValueT >::clearTable().

◆ hasTableMetaDataKey()

bool OpenSim::AbstractDataTable::hasTableMetaDataKey ( const std::string & key ) const

inline

Whether or not table metadata for the given key exists.

Referenced by OpenSim::MocoTrack::setMarkersReferenceFromTRC().

◆ implementGetNumColumns()

virtual size_t OpenSim::AbstractDataTable::implementGetNumColumns ( ) const

protectedpure virtual

Get number of columns.

Implemented by derived classes.

Implemented in OpenSim::DataTable_< ETX, ETY >, OpenSim::DataTable_< double, ETY >, OpenSim::DataTable_< double, ET >, OpenSim::DataTable_< double, Rotation >, OpenSim::DataTable_< double, ValueT >, OpenSim::DataTable_< double, SimTK::Vec3 >, OpenSim::DataTable_< double, SimTK::Rotation >, and OpenSim::DataTable_< double, SimTK::Real >.

◆ implementGetNumRows()

virtual size_t OpenSim::AbstractDataTable::implementGetNumRows ( ) const

protectedpure virtual

Get number of rows.

Implemented by derived classes.

Implemented in OpenSim::DataTable_< ETX, ETY >, OpenSim::DataTable_< double, ETY >, OpenSim::DataTable_< double, ET >, OpenSim::DataTable_< double, Rotation >, OpenSim::DataTable_< double, ValueT >, OpenSim::DataTable_< double, SimTK::Vec3 >, OpenSim::DataTable_< double, SimTK::Rotation >, and OpenSim::DataTable_< double, SimTK::Real >.

◆ numComponentsPerElement()

virtual unsigned OpenSim::AbstractDataTable::numComponentsPerElement ( ) const

pure virtual

Get number of components per element of the DataTable.

See documentation for DataTable on possible return values.

Implemented in OpenSim::DataTable_< ETX, ETY >, OpenSim::DataTable_< double, ETY >, OpenSim::DataTable_< double, ET >, OpenSim::DataTable_< double, Rotation >, OpenSim::DataTable_< double, ValueT >, OpenSim::DataTable_< double, SimTK::Vec3 >, OpenSim::DataTable_< double, SimTK::Rotation >, and OpenSim::DataTable_< double, SimTK::Real >.

◆ operator=() [1/2]

AbstractDataTable& OpenSim::AbstractDataTable::operator= ( const AbstractDataTable & )

default

◆ operator=() [2/2]

AbstractDataTable& OpenSim::AbstractDataTable::operator= ( AbstractDataTable && )

default

◆ removeDependentsMetaDataForKey()

void OpenSim::AbstractDataTable::removeDependentsMetaDataForKey ( const std::string & key )

Remove key-value pair associated with the given key from dependents metadata.

Referenced by OpenSim::TimeSeriesTable_< Rotation >::TimeSeriesTable_().

◆ removeTableMetaDataKey()

void OpenSim::AbstractDataTable::removeTableMetaDataKey ( const std::string & key )

Remove key-value pair associated with the given key from table metadata.

◆ setColumnLabel()

void OpenSim::AbstractDataTable::setColumnLabel	(	const size_t	columnIndex,
		const std::string &	columnLabel
	)

Set the label for a column.

Exceptions

NoColumnLabels	If table has no column labels.
ColumnIndexOutOfRange	If columnIndex is out of range for number of columns in the table.

◆ setColumnLabels() [1/3]

template<typename InputIt >

void OpenSim::AbstractDataTable::setColumnLabels	(	InputIt	first,
		InputIt	last
	)

inline

Set column labels using a pair of iterators.

Example:

std::vector<std::string> labels{"col1", "col2", "col3", "col4", "col5"};
// Use subsequence of vector as labels.
setColumnLabels(labels.begin() + 2, labels.end());

Parameters

first	InputIterator representing the beginning of the sequence of labels.
last	InputIterator representing the sentinel or one past the end of sequence of labels.

Exceptions

IncorrectMetaDataLength If length of the input sequence of labels is incorrect – does not match the number of columns in the table.

Examples:: exampleMarkerTracking.cpp.

References OpenSim::ValueArray< T >::upd().

Referenced by OpenSim::TableReporter_< InputT, ValueT >::clearTable(), OpenSim::DataTable_< double, SimTK::Real >::DataTable_(), OpenSim::TableReporter_< InputT, ValueT >::extendFinalizeConnections(), OpenSim::TabOpUseAbsoluteStateNames::operate(), and OpenSim::DataTable_< double, SimTK::Real >::removeColumnAtIndex().

◆ setColumnLabels() [2/3]

template<typename Container >

void OpenSim::AbstractDataTable::setColumnLabels ( const Container & columnLabels )

inline

Set column labels using a sequence container.

Example:

std::vector<std::string> columnLabels{"col1", "col2", "col3"};

setColumnLabels(columnLabels);

Template Parameters

Container Any container type (like std::vector, std::list or your own) that supports begin() and end(). Type of the values produced by iterator should be std::string.

Exceptions

IncorrectMetaDataLength If length of the input sequence of labels is incorrect – does not match the number of columns in the table.

◆ setColumnLabels() [3/3]

void OpenSim::AbstractDataTable::setColumnLabels ( const std::initializer_list< std::string > & columnLabels )

Set column labels using a std::initializer_list.

Example:

setColumnLabels({"col1", "col2", "col3"});

Exceptions

IncorrectMetaDataLength If length of the input sequence of labels is incorrect – does not match the number of columns in the table.

◆ setDependentsMetaData()

void OpenSim::AbstractDataTable::setDependentsMetaData ( const DependentsMetaData & dependentsMetaData )

Set metadata associated with the dependent columns.

◆ setIndependentMetaData()

void OpenSim::AbstractDataTable::setIndependentMetaData ( const IndependentMetaData & independentMetaData )

Set metadata associated with the independent column.

◆ updTableMetaData()

TableMetaData& OpenSim::AbstractDataTable::updTableMetaData ( )

Update metadata associated with the table.

◆ validateDependentsMetaData()

virtual void OpenSim::AbstractDataTable::validateDependentsMetaData ( ) const

protectedpure virtual

Check if metadata for dependent column is valid.

Implemented by derived classes.

Implemented in OpenSim::DataTable_< ETX, ETY >, OpenSim::DataTable_< double, ETY >, OpenSim::DataTable_< double, ET >, OpenSim::DataTable_< double, Rotation >, OpenSim::DataTable_< double, ValueT >, OpenSim::DataTable_< double, SimTK::Vec3 >, OpenSim::DataTable_< double, SimTK::Rotation >, and OpenSim::DataTable_< double, SimTK::Real >.

◆ validateIndependentMetaData()

virtual void OpenSim::AbstractDataTable::validateIndependentMetaData ( ) const

protectedpure virtual

Check if metadata for independent column is valid.

Implemented by derived classes.

Implemented in OpenSim::DataTable_< ETX, ETY >, OpenSim::DataTable_< double, ETY >, OpenSim::DataTable_< double, ET >, OpenSim::DataTable_< double, Rotation >, OpenSim::DataTable_< double, ValueT >, OpenSim::DataTable_< double, SimTK::Vec3 >, OpenSim::DataTable_< double, SimTK::Rotation >, and OpenSim::DataTable_< double, SimTK::Real >.

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

OpenSim/Common/AbstractDataTable.h

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ AbstractDataTable() [1/3]

◆ AbstractDataTable() [2/3]

◆ AbstractDataTable() [3/3]

◆ ~AbstractDataTable()

Member Typedef Documentation

◆ DependentsMetaData

◆ IndependentMetaData

◆ TableMetaData

Member Function Documentation

◆ addTableMetaData()

◆ appendColumnLabel()

◆ clone()

◆ getColumnIndex()

◆ getColumnLabel()

◆ getColumnLabels()

◆ getDependentsMetaData()

◆ getIndependentMetaData()

◆ getNumColumns()

◆ getNumRows()

◆ getTableMetaData() [1/2]

◆ getTableMetaData() [2/2]

◆ getTableMetaDataAsString()

◆ getTableMetaDataKeys()

◆ hasColumn() [1/2]

◆ hasColumn() [2/2]

◆ hasColumnLabels()

◆ hasTableMetaDataKey()

◆ implementGetNumColumns()

◆ implementGetNumRows()

◆ numComponentsPerElement()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ removeDependentsMetaDataForKey()

◆ removeTableMetaDataKey()

◆ setColumnLabel()

◆ setColumnLabels() [1/3]

◆ setColumnLabels() [2/3]

◆ setColumnLabels() [3/3]

◆ setDependentsMetaData()

◆ setIndependentMetaData()

◆ updTableMetaData()

◆ validateDependentsMetaData()

◆ validateIndependentMetaData()