agentsclimarketplace

Intensity normalization spectra

Skill HolobiomicsLab/asb-skill-collections/collections/metabolomics/v2/skills/intensity-normalization-spectra

Use when after noise reduction when working with imported imzML MSI data where pixel-to-pixel or sample-to-sample intensity variations due to instrumental sensitivity or sample loading differences must be corrected before mean intensity calculation, ROI analysis, or metabolite annotation.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill intensity-normalization-spectra

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 15 stars15 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as CC-BY-4.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

7.5 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it

intensity-normalization-spectra

Summary

Standardize mass spectrometry imaging (MSI) spectral intensities across all pixels and m/z values using one of four normalization methods (TIC, RMS, median, or reference peak) to enable valid comparative analysis and reduce instrumental/sample-preparation bias in downstream ROI and biochemical annotation workflows.

When to use

Apply this skill after noise reduction when working with imported imzML MSI data where pixel-to-pixel or sample-to-sample intensity variations due to instrumental sensitivity or sample loading differences must be corrected before mean intensity calculation, ROI analysis, or metabolite annotation. Essential when comparing spectra across multiple tissue regions or samples.

When NOT to use

  • Input is already a centroid-mode dataset without raw ion counts (normalization assumes quantitative intensity values).
  • Profile-mode data that has not yet been converted to centroid mode (use profile→centroid conversion first).
  • Exploratory visualization only, where relative peak heights within a single spectrum are sufficient and inter-pixel comparisons are not needed.

Inputs

  • Imported MSI spectral data (imzML format) with noise reduction applied
  • Per-pixel spectral intensity matrix (m/z × pixel)
  • Optional: reference m/z value for internal standard normalization

Outputs

  • Intensity-normalized spectral dataset (m/z × pixel matrix)
  • Normalized mean spectrum (exportable as CSV)
  • Normalized ion image visualization
  • Preprocessed MSI data compatible with ROI analysis and database annotation

How to apply

Within the MSI-Explorer napari plugin, load preprocessed (noise-reduced) imzML data and select one of four normalization methods: Total Ion Current (TIC) normalizes to the sum of all intensities per pixel; Root Mean Square (RMS) normalizes to the per-pixel RMS; Median normalizes to the median intensity; Reference Peak (internal standard) normalizes to a user-specified m/z peak. Execute the normalization, then verify by calculating and visualizing the mean spectrum and corresponding ion image. The choice of method depends on your experimental design: TIC is standard for untargeted profiling, RMS for variance-driven comparisons, Median for robust outlier resistance, and Reference Peak when an internal standard was spiked. Output is the normalized spectral dataset in the standardized MSI data format, ready for downstream visualization and ROI analysis.

Related tools

  • napari (Interactive visualization and UI platform hosting the MSI-Explorer plugin for parameter selection, normalization execution, and real-time spectrum/image display) — https://github.com/napari/napari
  • MSI-Explorer (Napari plugin implementing noise reduction and four normalization methods (TIC, RMS, Median, Reference Peak) for MSI spectra preprocessing and ROI analysis) — https://github.com/MMV-Lab/MSI-Explorer
  • Python (Programming language for scripting and automation of normalization workflows via the MSI-Explorer API)

Examples

# Within napari MSI-Explorer plugin GUI: load imzML → Plugins > MSI-Explorer → select noise reduction (e.g. 3%) → select TIC normalization → click Execute → click Show true mean spectrum → Export spectrum data as CSV

Evaluation signals

  • Mean spectrum after normalization shows comparable total/RMS intensities across all samples or ROIs (no systematic intensity drift by region).
  • Ion images for the same m/z peak appear uniform in intensity scale across tissue regions after normalization (contrast-to-noise ratio is stable).
  • Per-pixel normalization factors (e.g., TIC sums or RMS values) are within expected ranges; extreme outliers or zero-valued normalizers indicate failed or spurious normalization.
  • Normalized spectral data can be successfully exported as CSV and reimported for downstream annotation and ROI analysis without schema or format errors.
  • Before/after comparison: unnormalized spectra show systematic intensity variation by pixel; normalized spectra show consistent scaling with preserved peak patterns.

Limitations

  • Reference Peak normalization requires a priori knowledge of an internal standard m/z value; incorrect selection yields misleading results.
  • TIC normalization can be biased by a small number of intense ions; not recommended for data with extreme peak outliers (apply hotspot removal beforehand).
  • Normalization assumes imzML data is in quantitative intensity units; if imported data is already log-transformed or in arbitrary units, results may not be interpretable.
  • No automatic method selection guidance provided; user must choose the normalization method; inappropriate choice can suppress or amplify biologically relevant variability.

Evidence

  • [other] Apply intensity normalization to standardize spectral intensities across all pixels and m/z values.: "Apply intensity normalization to standardize spectral intensities across all pixels and m/z values."
  • [readme] The normalization methods that the user can apply are - Total ion current (TIC) - Root mean square (RMS) - Medium - Reference peak (or internal standard): "The normalization methods that the user can apply are - Total ion current (TIC) - Root mean square (RMS) - Medium - Reference peak (or internal standard)"
  • [readme] The pre-processing capabilities of MSI-Explorer enhance data quality and prepare MSI data for downstream analysis. Pre-processing steps involve noise reduction and normalization.: "The pre-processing capabilities of MSI-Explorer enhance data quality and prepare MSI data for downstream analysis."
  • [readme] After pre-processing steps are chosen, click Execute and Show true mean spectrum to calculate the mean intensity.: "After pre-processing steps are chosen, click Execute and Show true mean spectrum to calculate the mean intensity."
  • [intro] It covers data import, visualization, mean intensity calculation, region of interest (ROI) analysis, annotation with selected databases and pre-processing such as noise reduction and normalization.: "pre-processing such as noise reduction and normalization"

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.