machine-learning-performance-metric-evaluation
Summary
Evaluate trained binary classifiers for MS/MS spectral discrimination by computing standard performance metrics (accuracy, precision, recall, F1-score) on held-out validation data. This skill assesses whether a classifier reliably distinguishes MS/MS spectra of compounds of interest from other compounds.
When to use
After training a binary MS/MS spectral classifier on labeled data, apply this skill to quantify classifier performance before deployment. Use this when you have a trained AnnoMe model and a validation subset of labeled MS/MS spectra (annotated as 'relevant' or 'other') that were held out from training.
When NOT to use
- Input validation set is not held-out from training; using training data to evaluate leads to inflated metrics and overfitting bias.
- MS/MS spectra are not preprocessed (normalized, features extracted) in the same manner as training data; metric values will not reflect true generalization.
- Dataset is extremely imbalanced (e.g., >95% one class) and only accuracy is reported; use F1-score, precision, or recall instead to avoid misleading conclusions.
Inputs
- Trained MS/MS binary classifier model (AnnoMe format)
- Validation subset of labeled MS/MS spectra (annotated as 'relevant' or 'other')
- Preprocessed MS/MS spectra (normalized, features extracted)
Outputs
- Classification metrics: accuracy, precision, recall, F1-score
- Confusion matrix (true positives, false positives, true negatives, false negatives)
- Serialized trained model with performance metadata
How to apply
Split your labeled MS/MS spectral dataset into non-overlapping training and validation subsets (typical 70/30 or 80/20). Train the binary classifier on the training subset using AnnoMe with default hyperparameters. After training converges, run inference on the validation subset to generate predictions for each spectrum. Compute accuracy (overall fraction of correct predictions), precision (true positives / predicted positives), recall (true positives / actual positives), and F1-score (harmonic mean of precision and recall) by comparing predicted labels to ground-truth labels. Log and serialize these metrics alongside the trained model. The F1-score is particularly useful when the validation dataset is imbalanced between 'relevant' and 'other' classes, as it penalizes both false positives and false negatives.
Related tools
Examples
uv run annome_classificationgui
Evaluation signals
- Accuracy, precision, recall, and F1-score are all in the range [0, 1] or [0, 100%] with no NaN or infinite values.
- Precision + false positive rate sum approximately to 1 (verify internal consistency of the confusion matrix).
- F1-score is ≤ min(precision, recall), confirming it is the harmonic mean and not inflated by class imbalance.
- Metrics are computed on the held-out validation set only, never on the training set (confirmed by data split logging).
- Model serialization succeeds and the saved model can be deserialized and used for new predictions without error.
Limitations
- Classification of MS/MS spectra into substance classes is a non-trivial task and the classifier will often fail, especially when the training dataset is highly imbalanced (see README limitations).
- Performance metrics computed on a single validation split may be optimistic or pessimistic; consider k-fold cross-validation for more robust estimates.
- High F1-score on validation data does not guarantee performance on truly novel, out-of-distribution MS/MS spectra from new plant extracts or chemical sources not represented in training.
- AnnoMe uses ensemble methods (LDA, NN, SVM, majority-vote aggregation) which can mask underlying classifier disagreement; examine per-classifier predictions to assess model consensus.
Evidence
- [other] Split dataset into training and validation subsets. Train the binary classifier in AnnoMe using the training subset with default hyperparameters. Evaluate classifier performance on the validation subset and log accuracy, precision, recall, and F1-score.: "Split dataset into training and validation subsets. Train the binary classifier in AnnoMe using the training subset with default hyperparameters. Evaluate classifier performance on the validation"
- [readme] Classification of MS/MS spectra into substance classes is a non-trivial task and most often the classification will not be successful, especially when the training dataset is highly imbalanced.: "Classification of MS/MS spectra into substance classes is a non-trivial task and most often the classification will not be successful, especially when the training dataset is highly imbalanced."
- [readme] Using training data consisting of annotated and labeled MS/MS spectra of compounds of interest and others, different classifiers (LDA, NN, SVM, etc.) are first trained using cross-validation and different random seeds. The results are then aggregated and a majority-vote is derived which indicates the final classification of the input MS/MS spectra to either "relevant" or "other".: "Using training data consisting of annotated and labeled MS/MS spectra of compounds of interest and others, different classifiers (LDA, NN, SVM, etc.) are first trained using cross-validation and"
1---2name: machine-learning-performance-metric-evaluation-23description: Use when after training a binary MS/MS spectral classifier on labeled data, apply this skill to quantify classifier performance before deployment.4license: CC-BY-4.05---67# machine-learning-performance-metric-evaluation89## Summary1011Evaluate trained binary classifiers for MS/MS spectral discrimination by computing standard performance metrics (accuracy, precision, recall, F1-score) on held-out validation data. This skill assesses whether a classifier reliably distinguishes MS/MS spectra of compounds of interest from other compounds.1213## When to use1415After training a binary MS/MS spectral classifier on labeled data, apply this skill to quantify classifier performance before deployment. Use this when you have a trained AnnoMe model and a validation subset of labeled MS/MS spectra (annotated as 'relevant' or 'other') that were held out from training.1617## When NOT to use1819- Input validation set is not held-out from training; using training data to evaluate leads to inflated metrics and overfitting bias.20- MS/MS spectra are not preprocessed (normalized, features extracted) in the same manner as training data; metric values will not reflect true generalization.21- Dataset is extremely imbalanced (e.g., >95% one class) and only accuracy is reported; use F1-score, precision, or recall instead to avoid misleading conclusions.2223## Inputs2425- Trained MS/MS binary classifier model (AnnoMe format)26- Validation subset of labeled MS/MS spectra (annotated as 'relevant' or 'other')27- Preprocessed MS/MS spectra (normalized, features extracted)2829## Outputs3031- Classification metrics: accuracy, precision, recall, F1-score32- Confusion matrix (true positives, false positives, true negatives, false negatives)33- Serialized trained model with performance metadata3435## How to apply3637Split your labeled MS/MS spectral dataset into non-overlapping training and validation subsets (typical 70/30 or 80/20). Train the binary classifier on the training subset using AnnoMe with default hyperparameters. After training converges, run inference on the validation subset to generate predictions for each spectrum. Compute accuracy (overall fraction of correct predictions), precision (true positives / predicted positives), recall (true positives / actual positives), and F1-score (harmonic mean of precision and recall) by comparing predicted labels to ground-truth labels. Log and serialize these metrics alongside the trained model. The F1-score is particularly useful when the validation dataset is imbalanced between 'relevant' and 'other' classes, as it penalizes both false positives and false negatives.3839## Related tools4041- **AnnoMe** (Trains binary classifiers on MS/MS spectra and computes performance metrics on validation data during model evaluation.) — https://github.com/chrboku/AnnoMe4243## Examples4445```46uv run annome_classificationgui47```4849## Evaluation signals5051- Accuracy, precision, recall, and F1-score are all in the range [0, 1] or [0, 100%] with no NaN or infinite values.52- Precision + false positive rate sum approximately to 1 (verify internal consistency of the confusion matrix).53- F1-score is ≤ min(precision, recall), confirming it is the harmonic mean and not inflated by class imbalance.54- Metrics are computed on the held-out validation set only, never on the training set (confirmed by data split logging).55- Model serialization succeeds and the saved model can be deserialized and used for new predictions without error.5657## Limitations5859- Classification of MS/MS spectra into substance classes is a non-trivial task and the classifier will often fail, especially when the training dataset is highly imbalanced (see README limitations).60- Performance metrics computed on a single validation split may be optimistic or pessimistic; consider k-fold cross-validation for more robust estimates.61- High F1-score on validation data does not guarantee performance on truly novel, out-of-distribution MS/MS spectra from new plant extracts or chemical sources not represented in training.62- AnnoMe uses ensemble methods (LDA, NN, SVM, majority-vote aggregation) which can mask underlying classifier disagreement; examine per-classifier predictions to assess model consensus.6364## Evidence6566- [other] Split dataset into training and validation subsets. Train the binary classifier in AnnoMe using the training subset with default hyperparameters. Evaluate classifier performance on the validation subset and log accuracy, precision, recall, and F1-score.: "Split dataset into training and validation subsets. Train the binary classifier in AnnoMe using the training subset with default hyperparameters. Evaluate classifier performance on the validation"67- [readme] Classification of MS/MS spectra into substance classes is a non-trivial task and most often the classification will not be successful, especially when the training dataset is highly imbalanced.: "Classification of MS/MS spectra into substance classes is a non-trivial task and most often the classification will not be successful, especially when the training dataset is highly imbalanced."68- [readme] Using training data consisting of annotated and labeled MS/MS spectra of compounds of interest and others, different classifiers (LDA, NN, SVM, etc.) are first trained using cross-validation and different random seeds. The results are then aggregated and a majority-vote is derived which indicates the final classification of the input MS/MS spectra to either "relevant" or "other".: "Using training data consisting of annotated and labeled MS/MS spectra of compounds of interest and others, different classifiers (LDA, NN, SVM, etc.) are first trained using cross-validation and"
HolobiomicsLab 