TransformationDescription Class Reference [MapAlignment]

Generic description of a coordinate transformation. More...

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

List of all members.

Public Types
typedef TransformationModel::DataPoint	DataPoint
	Coordinate pair.
typedef TransformationModel::DataPoints	DataPoints
	Vector of coordinate pairs.
Public Member Functions
	TransformationDescription ()
	Default constructor.
	TransformationDescription (const DataPoints &data)
	Constructor from data.
	~TransformationDescription ()
	Destructor.
	TransformationDescription (const TransformationDescription &rhs)
	Copy constructor.
TransformationDescription &	operator= (const TransformationDescription &rhs)
	Assignment operator.
void	fitModel (const String &model_type, const Param &params=Param())
	Fits a model to the data.
DoubleReal	apply (DoubleReal value) const
	Applies the transformation to value.
const String &	getModelType () const
	Gets the type of the fitted model.
void	setDataPoints (const DataPoints &data)
	Sets the data points.
const DataPoints &	getDataPoints () const
	Returns the data points.
void	getModelParameters (Param &params) const
	Non-mutable access to the model parameters.
void	invert ()
	Computes an (approximate) inverse of the transformation.
Static Public Member Functions
static void	getModelTypes (StringList &result)
	Gets the possible types of models.
Protected Attributes
DataPoints	data_
	Data points.
String	model_type_
	Type of model.
TransformationModel *	model_
	Pointer to model.

---

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.
• b_spline (TransformationModelBSpline): Smoothing cubic B-spline.

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

)

Constructor from data.

~TransformationDescription

(

)

Destructor.

TransformationDescription

(

const TransformationDescription &

rhs

)

Copy constructor.

---

Member Function Documentation

DoubleReal apply

(

DoubleReal

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(), ChromatogramExtractor::outsideExtractionWindow_(), and MRMFeatureFinderScoring::scorePeakgroups_().

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

Fits a model to the data.

const DataPoints& getDataPoints

(

)

const

Returns the data points.

void getModelParameters

(

Param &

params

)

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(), and MRMFeatureFinderScoring::scorePeakgroups_().

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).

---

Member Data Documentation

DataPoints data_ [protected]

Data points.

TransformationModel* model_ [protected]

Pointer to model.

String model_type_ [protected]

Type of model.