Matrix Science header
Public Member Functions

ms_xml_parameters Class Reference
[Mascot configuration files module]

A class that represents a base parametersType. More...

#include <ms_xml_parameters.hpp>

Inheritance diagram for ms_xml_parameters:
Inheritance graph
[legend]

List of all members.

Public Member Functions

 ms_xml_parameters ()
 Default constructor.
 ms_xml_parameters (const ms_xml_parameters &src)
 Copying constructor.
virtual ~ms_xml_parameters ()
 Destructor.
virtual void clearParameters ()=0
 Deletes all parameters from the list.
void defaultValues ()
 Call this member if you want to start again.
virtual bool deleteParameterByName (const char *name)=0
 Remove a parameter from the list in memory by its unique name.
virtual bool deleteParameterByNumber (const int idx)=0
 Remove a parameter from the list in memory by its index.
virtual int getNumberOfParameters () const =0
 Returns the number of parameters held.
virtual std::string getParameterSchemaType () const =0
 Obtain a symbolic name for the parameter element schema type.
virtual std::string getSchemaType () const =0
 Returns name of the schema type that can be used to validate this element.
std::string validateDeep (const ms_xml_schema *pSchemaFileObj) const
 Performs validation of all child elements in addition to 'shallow' validation.
std::string validateShallow (const ms_xml_schema *pSchemaFileObj) const
 Performs simple validation of the top-level elements only.

Detailed Description

A class that represents a base parametersType.

The Mascot configuration files quantitation.xml and crosslinking.xml use a common node structure for a set of key-value pairs. ms_xml_parameters is a base class for ms_quant_parameters and ms_crosslinking_parameters, because the parameter sets share the same API.


Constructor & Destructor Documentation

Default constructor.

Assigns reasonable default values to all internal members.

Copying constructor.

Parameters:
srcanother instance of this class to copy the content from.

Member Function Documentation

void defaultValues (  )

Call this member if you want to start again.

All internal values are reset to their defaults, as if the object had been freshly created with the default constructor.

Reimplemented in ms_crosslinking_filters, ms_crosslinking_parameters, ms_crosslinking_scope, ms_crosslinking_settings, ms_quant_average, ms_quant_integration, ms_quant_multiplex, ms_quant_normalisation, ms_quant_outliers, ms_quant_parameters, ms_quant_precursor, ms_quant_quality, ms_quant_replicate, and ms_quant_reporter.

bool deleteParameterByName ( const char *  name ) [pure virtual]

Remove a parameter from the list in memory by its unique name.

Parameters:
namename of the parameter for deletion.
Returns:
TRUE if the parameter has been found and successfully deleted and FALSE otherwise.

Implemented in ms_crosslinking_parameters, and ms_quant_parameters.

bool deleteParameterByNumber ( const int  idx ) [pure virtual]

Remove a parameter from the list in memory by its index.

Parameters:
idxnumber of the parameter for deletion from 0 to (getNumberOfParameters() - 1).
Returns:
TRUE if the parameter has been found and successfully deleted and FALSE otherwise.

Implemented in ms_crosslinking_parameters, and ms_quant_parameters.

int getNumberOfParameters (  ) const [pure virtual]

Returns the number of parameters held.

Returns:
total number of parameters in the list.

Implemented in ms_crosslinking_parameters, and ms_quant_parameters.

std::string getParameterSchemaType (  ) const [pure virtual]

Obtain a symbolic name for the parameter element schema type.

The obtained type name can be used to get a corresponding type description object from ms_xml_schema.

Returns:
symbolic type name for the element.

Implemented in ms_crosslinking_filters, ms_crosslinking_parameters, ms_crosslinking_scope, ms_crosslinking_settings, and ms_quant_parameters.

std::string getSchemaType (  ) const [pure virtual]

Returns name of the schema type that can be used to validate this element.

Additional information about the current object can be retrieved from the associated XML schema file. Every element in an XML document is defined with a named type, which you can use to find out what kind of limits (numerical or otherwise) are defined for values of that type.

See also:
validateShallow(), validateDeep()
Returns:
a symbolic fully qualified type name (for example, "mqm:nameType").

Implemented in ms_crosslinking_filters, ms_crosslinking_parameters, ms_crosslinking_scope, ms_crosslinking_settings, ms_quant_average, ms_quant_integration, ms_quant_multiplex, ms_quant_normalisation, ms_quant_outliers, ms_quant_parameters, ms_quant_precursor, ms_quant_quality, ms_quant_replicate, and ms_quant_reporter.

std::string validateDeep ( const ms_xml_schema *  pSchemaFileObj ) const

Performs validation of all child elements in addition to 'shallow' validation.

The current object can be checked against an XML schema. When using this method all possible checks are performed. However, this is not a substitute for the schema: some schema-defined constraint are not applied (unique fields, foreign keys etc.).

In order to make sure that current object is free from all syntax errors validate it as a part of the whole document.

See also:
validateShallow(), getSchemaType()
Parameters:
pSchemaFileObja valid schema object instance to validate against.
Returns:
user-friendly description of any errors found during validation or an empty string if no errors detected.

Reimplemented in ms_quant_average, ms_quant_integration, ms_quant_multiplex, ms_quant_normalisation, ms_quant_outliers, ms_quant_precursor, ms_quant_quality, ms_quant_replicate, and ms_quant_reporter.

std::string validateShallow ( const ms_xml_schema *  pSchemaFileObj ) const

Performs simple validation of the top-level elements only.

The current object can be checked against some basic constraints in a schema without looking at children element types. When using this method only the current object and children derived from standard types (for example, restrictions with enumerations) are checked. For more thorough validation, use validateDeep().

See also:
getSchemaType()
Parameters:
pSchemaFileObja valid schema object instance to validate against.
Returns:
user-friendly description of any errors found during validation or an empty string if no errors detected.

Reimplemented in ms_quant_average, ms_quant_integration, ms_quant_multiplex, ms_quant_normalisation, ms_quant_outliers, ms_quant_precursor, ms_quant_quality, ms_quant_replicate, and ms_quant_reporter.


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

Copyright © 2022 Matrix Science Ltd.  All Rights Reserved. Generated on Thu Mar 31 2022 01:12:39