TransformationDescription Class Reference

Generic description of a coordinate transformation. More...

#include <OpenMS/ANALYSIS/MAPMATCHING/TransformationDescription.h>

Public Types
typedef TransformationModel::DataPoint	DataPoint
	Coordinate pair. More...
typedef TransformationModel::DataPoints	DataPoints
	Vector of coordinate pairs. More...

Public Member Functions
	TransformationDescription ()
	Default constructor. More...
	TransformationDescription (const DataPoints &data)
	Constructor from data. More...
	~TransformationDescription ()
	Destructor. More...
	TransformationDescription (const TransformationDescription &rhs)
	Copy constructor. More...
TransformationDescription &	operator= (const TransformationDescription &rhs)
	Assignment operator. More...
void	fitModel (const String &model_type, const Param &params=Param())
	Fits a model to the data. More...
double	apply (double value) const
	Applies the transformation to value. More...
const String &	getModelType () const
	Gets the type of the fitted model. More...
void	setDataPoints (const DataPoints &data)
	Sets the data points. More...
const DataPoints &	getDataPoints () const
	Returns the data points. More...
const Param &	getModelParameters () const
	Non-mutable access to the model parameters. More...
void	invert ()
	Computes an (approximate) inverse of the transformation. More...

Static Public Member Functions
static void	getModelTypes (StringList &result)
	Gets the possible types of models. More...

Protected Attributes
DataPoints	data_
	Data points. More...
String	model_type_
	Type of model. More...
TransformationModel *	model_
	Pointer to model. More...

Detailed Description

Generic description of a coordinate transformation.

This description primarily stores data points (coordinate pairs) from which a transformation model can be estimated. Applying the transformation to a coordinate (via apply) then means evaluating the model at that coordinate.

The following models are available:

• none (TransformationModel): (identity)
• identity: Same as none, but intended for reference files (used to indicate that no other model should be fit, because the identity is already optimal).
• linear (TransformationModelLinear):
• interpolated (TransformationModelInterpolated): Interpolation between pairs, extrapolation using first and last pair. Supports different interpolation types.

Remarks

TransformationDescription stores data points, TransformationModel stores parameters. That way, data can be modeled using different models/parameters, and models can still keep a representation of the data in the format they need (if at all).

Member Typedef Documentation

typedef TransformationModel::DataPoint DataPoint

Coordinate pair.

typedef TransformationModel::DataPoints DataPoints

Vector of coordinate pairs.

Constructor & Destructor Documentation

TransformationDescription

(

)

Default constructor.

TransformationDescription ( const DataPoints &  data )

explicit

Constructor from data.

~TransformationDescription

(

)

Destructor.

TransformationDescription

(

const TransformationDescription &

rhs

)

Copy constructor.

Member Function Documentation

double apply

(

double

value

)

const

Applies the transformation to value.

Returns the result of evaluating the fitted model at value. Returns value unchanged if no model was fitted.

Referenced by InternalCalibration::calibrateMapGlobally(), InternalCalibration::calibrateMapSpectrumwise(), OpenSwathWorkflow::prepare_coordinates_wrap(), and OpenSwathWorkflow::scoreAllChromatograms().

void fitModel	(	const String &	model_type,
		const Param &	params = Param()
	)

Fits a model to the data.

Referenced by OpenSwathWorkflow::RTNormalization().

const DataPoints& getDataPoints

(

)

const

Returns the data points.

const Param& getModelParameters

(

)

const

Non-mutable access to the model parameters.

const String& getModelType

(

)

const

Gets the type of the fitted model.

static void getModelTypes ( StringList &  result )

static

Gets the possible types of models.

void invert

(

)

Computes an (approximate) inverse of the transformation.

Referenced by ChromatogramExtractor::extractChromatograms(), OpenSwathWorkflow::performExtraction(), and OpenSwathWorkflow::scoreAllChromatograms().

TransformationDescription& operator=

(

const TransformationDescription &

rhs

)

Assignment operator.

void setDataPoints

(

const DataPoints &

data

)

Sets the data points.

Removes the model that was previously fitted to the data (if any).

Referenced by OpenSwathWorkflow::RTNormalization().

Member Data Documentation

DataPoints data_

protected

Data points.

TransformationModel* model_

protected

Pointer to model.

String model_type_

protected

Type of model.