Total-Ion-Current Quantification
Summary
Normalize mass spectrometry imaging pixel intensities to total ion current (TIC) to account for local variation in ion abundance and enable cross-pixel intensity comparisons. This is a preprocessing step in MSI workflows that stabilizes visualization and quantification by removing global intensity artifacts unrelated to spatial distribution.
When to use
Apply this skill when you have loaded a mass spectrometry imaging pixel array (NumPy format) and need to correct for variations in total ion signal across pixels before generating ion images or ratio images. Use TIC normalization when pixel-to-pixel ion abundance varies due to instrumental drift, sample surface topology, or uneven ionization efficiency, rather than genuine analyte abundance differences. This is especially relevant for nano-DESI MSI data where surface contact and ion yield can vary locally.
When NOT to use
- Input pixel array is already normalized to an internal standard or has been normalized by another method; applying TIC normalization a second time will distort the intensities.
- The goal is to preserve absolute ion abundance information across the imaging region without correction; TIC normalization will obscure global differences in ionization efficiency.
- Data contains significant spatial structure in total ion signal that is itself scientifically meaningful (e.g., matrix crystallinity or ion suppression effects); TIC normalization will remove that signal.
Inputs
- Pixel array in NumPy format (2D or 3D: spatial dimensions × m/z bins)
- Associated metadata JSON file with m/z axis information
- Optional: scale parameter (float, 0–1 quantile)
Outputs
- TIC-normalized pixel array (same shape as input)
- Visualization image(s) with corrected intensity scales
- CSV or figure file(s) saved according to image_savetype
How to apply
Load the pixel array (NumPy format) and associated metadata JSON using MSIGen's load_pixels function. Set the normalize parameter to 'TIC' when calling get_and_display_images. MSIGen will compute the sum of all ion intensities across the m/z dimension for each pixel, then divide each pixel's intensity values by its corresponding TIC. Optionally apply pixel intensity scaling via the scale parameter (quantile-based; e.g., scale=0.999 sets maximum display intensity to the 99.9th percentile of pixel values) to enhance visualization contrast post-normalization. Save the normalized image output according to the image_savetype parameter (publication-style figures, raw images, or CSV arrays).
Related tools
- MSIGen (Core library for loading pixel arrays, applying TIC normalization via get_and_display_images function, and saving normalized output) — https://github.com/LabLaskin/MSIGen
- Python (Runtime environment; MSIGen requires Python >=3.9 and <=3.11)
- Jupyter Notebook (Interactive environment for exploratory application of TIC normalization and visualization of results)
- NumPy (Underlying array format for pixel data; normalization operates on NumPy arrays)
Examples
pixels, metadata = msigen.load_pixels('path/to/saved/pixels'); vis.get_and_display_images(pixels, metadata, normalize='TIC', scale=0.999)
Evaluation signals
- Pixel intensity values after normalization should fall in the range [0, 1] or proportional to TIC, with no pixel exceeding the sum of its pre-normalized intensities.
- Pixels with high total ion current should have proportionally reduced individual ion intensities; pixels with low TIC should have proportionally higher normalized intensities for the same analyte.
- Spatial patterns in ion images should become more visible (contrast improvement) after TIC normalization if local TIC variation was obscuring analyte distribution.
- When comparing ion images before and after TIC normalization, the relative intensity ranking of high-abundance pixels should be preserved, but absolute intensity differences should be reduced.
- Metadata JSON should contain the TIC value (sum of intensities) for each pixel; verify that normalization divides by these values correctly.
Limitations
- TIC normalization assumes that variation in total ion signal is primarily noise or instrumental artifact; if TIC variation is correlated with scientifically meaningful sample properties (e.g., local matrix concentration), normalization will remove that signal.
- Pixels with very low TIC (near-zero ion signal) may produce unstable or artificially high normalized intensities if not handled with a small pseudocount or minimum threshold; MSIGen's implementation details on zero-handling are not fully specified in the article.
- TIC normalization is sensitive to outlier pixels with extremely high or low TIC; quantile-based scaling (scale parameter) is recommended post-normalization to improve visualization, but this is a separate, optional step.
- Not suitable for time-of-flight (TOF) or other high-resolution instruments where m/z binning strategy significantly affects total ion count; article focuses on nano-DESI MSI and does not address resolution-dependent effects.
Evidence
- [other] MSIGen supports image normalization to total ion current (TIC) via normalize='TIC' parameter and to an internal standard via normalize='intl_std' parameter when processing pixel arrays.: "normalize='TIC' parameter and to an internal standard via normalize='intl_std' parameter when processing pixel arrays"
- [other] Call MSIGen's get_and_display_images function with the chosen normalization parameters (normalize, std_idx, std_precursor, std_mass, std_fragment, std_mobility, std_charge) to apply normalization across all image layers.: "Call MSIGen's get_and_display_images function with the chosen normalization parameters (normalize, std_idx, ...) to apply normalization across all image layers"
- [other] Optionally apply pixel intensity scaling via scale parameter (quantile-based; e.g., 0.999 sets max to 99.9th percentile) or manual threshold.: "scale parameter (quantile-based; e.g., 0.999 sets max to 99.9th percentile)"
- [other] Load the pixel array (NumPy format) and associated metadata JSON file using MSIGen's load_pixels function.: "Load the pixel array (NumPy format) and associated metadata JSON file using MSIGen's load_pixels function"
- [intro] MSIGen is designed with nano-DESI MSI in mind: "is designed with nano-DESI MSI in mind"
- [methods] normalize = 'TIC' to normalize the images to total ion current: "normalize = 'TIC' to normalize the images to total ion current"
1---2name: total-ion-current-quantification3description: Use when you have loaded a mass spectrometry imaging pixel array (NumPy format) and need to correct for variations in total ion signal across pixels before generating ion images or ratio images.4license: CC-BY-4.05---67# Total-Ion-Current Quantification89## Summary1011Normalize mass spectrometry imaging pixel intensities to total ion current (TIC) to account for local variation in ion abundance and enable cross-pixel intensity comparisons. This is a preprocessing step in MSI workflows that stabilizes visualization and quantification by removing global intensity artifacts unrelated to spatial distribution.1213## When to use1415Apply this skill when you have loaded a mass spectrometry imaging pixel array (NumPy format) and need to correct for variations in total ion signal across pixels before generating ion images or ratio images. Use TIC normalization when pixel-to-pixel ion abundance varies due to instrumental drift, sample surface topology, or uneven ionization efficiency, rather than genuine analyte abundance differences. This is especially relevant for nano-DESI MSI data where surface contact and ion yield can vary locally.1617## When NOT to use1819- Input pixel array is already normalized to an internal standard or has been normalized by another method; applying TIC normalization a second time will distort the intensities.20- The goal is to preserve absolute ion abundance information across the imaging region without correction; TIC normalization will obscure global differences in ionization efficiency.21- Data contains significant spatial structure in total ion signal that is itself scientifically meaningful (e.g., matrix crystallinity or ion suppression effects); TIC normalization will remove that signal.2223## Inputs2425- Pixel array in NumPy format (2D or 3D: spatial dimensions × m/z bins)26- Associated metadata JSON file with m/z axis information27- Optional: scale parameter (float, 0–1 quantile)2829## Outputs3031- TIC-normalized pixel array (same shape as input)32- Visualization image(s) with corrected intensity scales33- CSV or figure file(s) saved according to image_savetype3435## How to apply3637Load the pixel array (NumPy format) and associated metadata JSON using MSIGen's load_pixels function. Set the normalize parameter to 'TIC' when calling get_and_display_images. MSIGen will compute the sum of all ion intensities across the m/z dimension for each pixel, then divide each pixel's intensity values by its corresponding TIC. Optionally apply pixel intensity scaling via the scale parameter (quantile-based; e.g., scale=0.999 sets maximum display intensity to the 99.9th percentile of pixel values) to enhance visualization contrast post-normalization. Save the normalized image output according to the image_savetype parameter (publication-style figures, raw images, or CSV arrays).3839## Related tools4041- **MSIGen** (Core library for loading pixel arrays, applying TIC normalization via get_and_display_images function, and saving normalized output) — https://github.com/LabLaskin/MSIGen42- **Python** (Runtime environment; MSIGen requires Python >=3.9 and <=3.11)43- **Jupyter Notebook** (Interactive environment for exploratory application of TIC normalization and visualization of results)44- **NumPy** (Underlying array format for pixel data; normalization operates on NumPy arrays)4546## Examples4748```49pixels, metadata = msigen.load_pixels('path/to/saved/pixels'); vis.get_and_display_images(pixels, metadata, normalize='TIC', scale=0.999)50```5152## Evaluation signals5354- Pixel intensity values after normalization should fall in the range [0, 1] or proportional to TIC, with no pixel exceeding the sum of its pre-normalized intensities.55- Pixels with high total ion current should have proportionally reduced individual ion intensities; pixels with low TIC should have proportionally higher normalized intensities for the same analyte.56- Spatial patterns in ion images should become more visible (contrast improvement) after TIC normalization if local TIC variation was obscuring analyte distribution.57- When comparing ion images before and after TIC normalization, the relative intensity ranking of high-abundance pixels should be preserved, but absolute intensity differences should be reduced.58- Metadata JSON should contain the TIC value (sum of intensities) for each pixel; verify that normalization divides by these values correctly.5960## Limitations6162- TIC normalization assumes that variation in total ion signal is primarily noise or instrumental artifact; if TIC variation is correlated with scientifically meaningful sample properties (e.g., local matrix concentration), normalization will remove that signal.63- Pixels with very low TIC (near-zero ion signal) may produce unstable or artificially high normalized intensities if not handled with a small pseudocount or minimum threshold; MSIGen's implementation details on zero-handling are not fully specified in the article.64- TIC normalization is sensitive to outlier pixels with extremely high or low TIC; quantile-based scaling (scale parameter) is recommended post-normalization to improve visualization, but this is a separate, optional step.65- Not suitable for time-of-flight (TOF) or other high-resolution instruments where m/z binning strategy significantly affects total ion count; article focuses on nano-DESI MSI and does not address resolution-dependent effects.6667## Evidence6869- [other] MSIGen supports image normalization to total ion current (TIC) via normalize='TIC' parameter and to an internal standard via normalize='intl_std' parameter when processing pixel arrays.: "normalize='TIC' parameter and to an internal standard via normalize='intl_std' parameter when processing pixel arrays"70- [other] Call MSIGen's get_and_display_images function with the chosen normalization parameters (normalize, std_idx, std_precursor, std_mass, std_fragment, std_mobility, std_charge) to apply normalization across all image layers.: "Call MSIGen's get_and_display_images function with the chosen normalization parameters (normalize, std_idx, ...) to apply normalization across all image layers"71- [other] Optionally apply pixel intensity scaling via scale parameter (quantile-based; e.g., 0.999 sets max to 99.9th percentile) or manual threshold.: "scale parameter (quantile-based; e.g., 0.999 sets max to 99.9th percentile)"72- [other] Load the pixel array (NumPy format) and associated metadata JSON file using MSIGen's load_pixels function.: "Load the pixel array (NumPy format) and associated metadata JSON file using MSIGen's load_pixels function"73- [intro] MSIGen is designed with nano-DESI MSI in mind: "is designed with nano-DESI MSI in mind"74- [methods] normalize = 'TIC' to normalize the images to total ion current: "normalize = 'TIC' to normalize the images to total ion current"
HolobiomicsLab 