A superimposer that uses a voting scheme, also known as pose clustering, to find a good shift transformation. More...

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

Inheritance diagram for PoseClusteringShiftSuperimposer:

Collaboration diagram for PoseClusteringShiftSuperimposer:

Public Member Functions
	PoseClusteringShiftSuperimposer ()
	Default ctor. More...

	~PoseClusteringShiftSuperimposer () override
	Destructor. More...

void	run (const ConsensusMap &map_model, const ConsensusMap &map_scene, TransformationDescription &transformation) override
	Estimates the transformation and fills the given mapping function. (Has a precondition!) More...

Public Member Functions inherited from BaseSuperimposer
	BaseSuperimposer ()
	Constructor. More...

	~BaseSuperimposer () override
	Destructor. More...

Public Member Functions inherited from DefaultParamHandler
	DefaultParamHandler (const String &name)
	Constructor with name that is displayed in error messages. More...

	DefaultParamHandler (const DefaultParamHandler &rhs)
	Copy constructor. More...

virtual	~DefaultParamHandler ()
	Destructor. More...

DefaultParamHandler &	operator= (const DefaultParamHandler &rhs)
	Assignment operator. More...

virtual bool	operator== (const DefaultParamHandler &rhs) const
	Equality operator. More...

void	setParameters (const Param &param)
	Sets the parameters. More...

const Param &	getParameters () const
	Non-mutable access to the parameters. More...

const Param &	getDefaults () const
	Non-mutable access to the default parameters. More...

const String &	getName () const
	Non-mutable access to the name. More...

void	setName (const String &name)
	Mutable access to the name. More...

const std::vector< String > &	getSubsections () const
	Non-mutable access to the registered subsections. More...

Public Member Functions inherited from ProgressLogger
	ProgressLogger ()
	Constructor. More...

virtual	~ProgressLogger ()
	Destructor. More...

	ProgressLogger (const ProgressLogger &other)
	Copy constructor. More...

ProgressLogger &	operator= (const ProgressLogger &other)
	Assignment Operator. More...

void	setLogType (LogType type) const
	Sets the progress log that should be used. The default type is NONE! More...

LogType	getLogType () const
	Returns the type of progress log being used. More...

void	setLogger (ProgressLoggerImpl *logger)
	Sets the logger to be used for progress logging. More...

void	startProgress (SignedSize begin, SignedSize end, const String &label) const
	Initializes the progress display. More...

void	setProgress (SignedSize value) const
	Sets the current progress. More...

void	endProgress (UInt64 bytes_processed=0) const

void	nextProgress () const
	increment progress by 1 (according to range begin-end) More...

Additional Inherited Members
Public Types inherited from ProgressLogger
enum	LogType { CMD , GUI , NONE }
	Possible log types. More...

Static Public Member Functions inherited from DefaultParamHandler
static void	writeParametersToMetaValues (const Param &write_this, MetaInfoInterface &write_here, const String &key_prefix="")
	Writes all parameters to meta values. More...

Protected Member Functions inherited from DefaultParamHandler
virtual void	updateMembers_ ()
	This method is used to update extra member variables at the end of the setParameters() method. More...

void	defaultsToParam_ ()
	Updates the parameters after the defaults have been set in the constructor. More...

Protected Attributes inherited from DefaultParamHandler
Param	param_
	Container for current parameters. More...

Param	defaults_
	Container for default parameters. This member should be filled in the constructor of derived classes! More...

std::vector< String >	subsections_
	Container for registered subsections. This member should be filled in the constructor of derived classes! More...

String	error_name_
	Name that is displayed in error messages during the parameter checking. More...

bool	check_defaults_
	If this member is set to false no checking if parameters in done;. More...

bool	warn_empty_defaults_
	If this member is set to false no warning is emitted when defaults are empty;. More...

Protected Attributes inherited from ProgressLogger
LogType	type_

time_t	last_invoke_

ProgressLoggerImpl *	current_logger_

Static Protected Attributes inherited from ProgressLogger
static int	recursion_depth_

Detailed Description

A superimposer that uses a voting scheme, also known as pose clustering, to find a good shift transformation.

This algorithm works on two consensus maps. It computes an shift transformation that maps the elements of second map as near as possible to the elements in the first map.

The voting scheme hashes shift transformations between features in map one and features in map two. Each such pair defines a (potential) "pose" of the second map relative to the first. Then it finds a cluster in the parameter space of these poses. The shift transformation is then computed from this cluster of potential poses, hence the name pose clustering.

See also: PoseClusteringAffineSuperimposer

Parameters of this class are:

Name	Type	Default	Restrictions	Description
mz_pair_max_distance	float	0.5	min: 0.0	Maximum of m/z deviation of corresponding elements in different maps. This condition applies to the pairs considered in hashing.
num_used_points	int	2000	min: -1	Maximum number of elements considered in each map (selected by intensity). Use this to reduce the running time and to disregard weak signals during alignment. For using all points, set this to -1.
shift_bucket_size	float	3.0	min: 0.0	The shift of the retention time interval is being hashed into buckets of this size during pose clustering. A good choice for this would be about the time between consecutive MS scans.
max_shift	float	1000.0	min: 0.0	Maximal shift which is considered during histogramming. This applies for both directions.
dump_buckets	string			[DEBUG] If non-empty, base filename where hash table buckets will be dumped to. A serial number for each invocation will be appended automatically.
dump_pairs	string			[DEBUG] If non-empty, base filename where the individual hashed pairs will be dumped to (large!). A serial number for each invocation will be appended automatically.

Note:

If a section name is documented, the documentation is displayed as tooltip.
Advanced parameter names are italic.

Constructor & Destructor Documentation

◆ PoseClusteringShiftSuperimposer()

PoseClusteringShiftSuperimposer ( )

Default ctor.

◆ ~PoseClusteringShiftSuperimposer()

~PoseClusteringShiftSuperimposer ( )

inlineoverride

Destructor.

Member Function Documentation

◆ run()

void run	(	const ConsensusMap &	map_model,
		const ConsensusMap &	map_scene,
		TransformationDescription &	transformation
	)

overridevirtual

Estimates the transformation and fills the given mapping function. (Has a precondition!)

Note: Exactly two input maps must be given.

Precondition: For performance reasons, we trust that (the equivalent of:) maps[0].updateRanges(); maps[1].updateRanges(); has been done before calling this. You have been warned!

Exceptions

IllegalArgument is thrown if the input maps are invalid.

Implements BaseSuperimposer.