Learn R Programming

LipidMS v3.1

Lipid Annotation for LC-MS/MS DIA and DDA data analysis. New features:

  • Batch processing: peak-picking, grouping and alignment wrapped in batchdataProcessing(). Lipid annotation for msbatch objects simplified with annotatemsbatch().
  • New lipid classes: plasmanyl and plasmenyl PC and PE, acylceramides and ceramides phosphate.
  • GUI through shiny app running LipidMSapp().
  • Improved graphical outputs for lipid annotation.
  • RT modelling to detect incorrect annotations and to propose new ones based on previous high confidence annotations identified by fragmentation rules.
    • Interactive shiny app to check the proposed annotations based on RT criteria through manualfilterapp().
    • Interactive shiny app to check new predicted annotations based on RT through manualpredictionapp().

Citation:

If you use this software in your research, please cite:

  • Alcoriza-Balaguer MI., et al. (2019) LipidMS: An R Package for Lipid Annotation in Untargeted Liquid Chromatography-Data Independent Acquisition-Mass Spectrometry Lipidomics. Anal Chem, 2019, 91(1), 836-845. doi:10.1021/acs.analchem.8b03409.
  • LipidMS 3.0: an R-package and a web-based tool for LC-MS/MS data processing and lipid annotation. Bioinformatics, 2022. doi.org/10.1093/bioinformatics/btac581

References:

Copy Link

Version

Install

install.packages('LipidMS')

Monthly Downloads

336

Version

3.1.0

License

GPL (>= 2)

Maintainer

M Alcoriza-Balaguer

Last Published

October 27th, 2025

Functions in LipidMS (3.1.0)

alignmsbatch

Align samples from an msbatch
MassLysoPI

Calculate formula and mass of LPI
MassPC

Calculate formula and mass of PC
MassMG

Calculate formula and mass of MG
MassPCo

Calculate formula and mass of PCo
annotateIsotopes

Annotate isotopes
adductsTable

Adducts table
acylcerdb

AcylCeramides database
chainFrags

Search of chain specific fragments
MassPIP3

Calculate formula and mass of PIP3
MassLysoPS

Calculate formula and mass of LysoPS
baconjdb

Bile acids conjugates database
cerdb

Ceramides database
MassPIP2

Calculate formula and mass of PIP2
MassPS

Calculate formula and mass of PS
batchdataProcessing

Process several mzXML files (peakpicking and isotope annotation) and create an msbatch for batch processing.
MassPIP

Calculate formula and mass of PIP
badb

Bile acids database
createLipidDB

Customizable lipid DBs creator
combineChains

Combine chain fragments that could belong to the same precursor.
annotatemsbatch

Lipid annotation for an msbatch
assignDB

Load LipidMS default data bases
coelutionScore

calculate coelution score between two peaks
coelutingFrags

Coeluting fragments extraction
checkClass

Search of class fragments to confirm the lipid class.
crossTables

Cross the original MS1 peaklist with the annotation results
carnitinesdb

Carnitines database
MassPA

Calculate formula and mass of PA
combineClassesAdducts

Creates a list that maps lipid classes with their database name and default adducts.
crossAdducts

Cross different candidates tables to remove false positives.
dbTwoChains

Creation of a database for FAHFA, DG and PL.
clustdist

Calculate max distance between clusters.
MassSphP

Calculate formula and mass of sphingoid phosphate bases
diffcb

Difference between two carbon:bounds structures
confLevels

Confidence Annotation Levels
dbsAdducts

Create tables containing the m/z of lipids along with their preferred adducts
chains

extract chains composition from a lipid name
MassTG

Calculate formula and mass of TG
MassPI

Calculate formula and mass of PI
MassPG

Calculate formula and mass of PG
checkIntRules

Check intensity rules
dataProcessing

Process mzXML files individually: peakpicking and isotope annotation
checkIntensityRules

Check intensity rules
getInclusionList

Obtain an inclusion list from the annotation results
clust

Clustering for MS peaks based on mz or RT.
fillpeaksmsbatch

Fill peaks from a grouped msbatch
groupmsbatch

Group features from an msbatch
cldb

Cardiolipins database
filtermsms

Presence or absence of an mz value within a vector of mz values
dbFourChains

Creation of a database for C.
.with_future_plan

Temporarily set a future plan and globals max size while running a block
frags

Search for fragments of interest withing a list of coeluting fragments
cbs

Total number of carbons and double bounds
ddaFrags

MS/MS scan extraction of a precursor in DDA
getallpeaks

Extract peaks from all msobjects in a msbatch.
getfeaturestable

Write features table based on groups
getFormula

Get formula and neutral mass for annotated compounds
dbThreeChains

Creation of a database for TG.
clustering

EIC extraction based on previous partitions generated by partitioning
dbSphingolipids

Creation of a database for Cer, CerP, GlcCer and SM
idCEpos

Cholesteryl Esters (CE) annotation for ESI+
idCerPpos

Ceramides phosphate (CerP) annotation for ESI+
findCandidates

Search of lipid candidates of a certain class
cerPdb

Ceramides Phosphate database
dbPlasmalogens

Creation of a database for PCo, PCp, PEo and PEp
dbOneChain

Creation of a database for Carnitines, CE, FA, HFA, LPL, MG, sphingoid bases and sphingoid bases phosphate.
filtrateAdducts

Remove low adduct supported candidates to avoid false positives.
findMS2precursor

find lisnks between MS1 peaks and precursors selected for MS2 in DDA
dgdb

DGs database
findPrecursor

Find candidate precursor from fullMS function
idCerneg

Ceramides (Cer) annotation for ESI-
idCerpos

Ceramides (Cer) annotation for ESI+
idAcylCerneg

Acylceramides (AcylCer) annotation for ESI-
idDGpos

Diacylglycerols (DG) annotation for ESI+
hfadb

HFAs database
idBAneg

Bile Acids (BA) annotation for ESI-
idAcylCerpos

Acylceramides (AcylCer) annotation for ESI+
fadb

FAs database
idLPGneg

Lysophosphoglycerols (LPG) annotation for ESI-
fahfadb

FAHFAs database
idFAHFAneg

FAHFA annotation for ESI-
idCarpos

Acylcarnitine annotation for ESI+
idCerPneg

Ceramides phosphate (CerP) annotation for ESI-
idLPCneg

Lysophosphocholines (LPC) annotation for ESI-
idLPIneg

Lysophosphoinositols (LPI) annotation for ESI-
idFAneg

Fatty Acids (FA) annotation for ESI-
idCLneg

Cardiolipines (CL) annotation for ESI-
idLPEpos

Lysophosphoethanolamines (LPE) annotation for ESI+
idLPEneg

Lysophosphoethanolamines (LPE) annotation for ESI-
idLPCpos

Lysophosphocholines (LPC) annotation for ESI+
idMGpos

Monoacylglycerol (MG) annotation for ESI+
idLPSneg

Lysophosphoserines (LPS) annotation for ESI-
idPCopos

Plasmanyl Phosphocholines (PCo) annotation for ESI+
idPCpos

Phosphocholines (PC) annotation for ESI+
idPConeg

Plasmanyl Phosphocholines (PCo) annotation for ESI-
idPCpneg

Plasmenyl Phosphocholines (PCp) annotation for ESI-
idPEoneg

Plasmanyl Phosphoethanolamines (PEo) annotation for ESI-
idPCppos

Plasmenyl Phosphocholines (PCp) annotation for ESI+
idPCneg

Phosphocholines (PC) annotation for ESI-
idNEG

Lipids annotation for ESI-
idPEopos

Plasmanyl Phosphoethanolamines (PEo) annotation for ESI+
idPEneg

Phosphoethanolamines (PE) annotation for ESI-
idPGpos

Phosphoglycerols (PG) annotation for ESI+
idPEpneg

Plasmenyl Phosphoethanolamines (PEp) annotation for ESI-
idPSneg

Phosphoserines (PS) annotation for ESI-
idPIneg

Phosphoinositols (PI) annotation for ESI-
idPGneg

Phosphoglycerols (PG) annotation for ESI-
idSMneg

Sphingomyelines (SM) annotation for ESI-
idPEpos

Phosphoethanolamines (PE) annotation for ESI+
idPOS

Lipids annotation for ESI+
idPIpos

Phosphoinositols (PI) annotation for ESI+
idPEppos

Plasmenyl Phosphoethanolamines (PEp) annotation for ESI+
idSMpos

Sphyngomyelines (SM) annotation for ESI+
idSphneg

Sphingoid bases (Sph) annotation for ESI-
joinAnnotationResults

Summarize annotation results from an msbatch into the features table
indexrtpart

Index partitions or clusters assigned during alignment.
idSphPpos

Sphingoid bases phosphate (SphP) annotation for ESI+
idTGpos

Triacylglycerols (TG) annotation for ESI+
idSphpos

Sphingoid bases (Sph) annotation for ESI-
idSphPneg

Sphingoid bases phosphate (SphP) annotation for ESI-
joinfrags

Join fragments information when several peaks of the same fragment are coeluting with a unique candidate
lysopadb

LPAs database
lysopsdb

LPSs database
lysopidb

LPIs database
lysopcdb

LPCs database
lysopaodb

O-LPA database
pcpdb

P-PC database
lysopgdb

LPGs database
peakdetection

peak-pick based on previous EIC clusters generated by clustering
pidb

PIs database
pcodb

O-PC database
pcdb

PCs database
lysopepdb

P-LPE database
pepdb

P-PE database
lysopedb

LPEs database
lysopeodb

O-LPE database
plotLipids

Plot informative peaks for lipid annotation
organizeResults

Prepare output for LipidMS annotation functions
pgdb

PGs database
nlsphdb

Neutral losses db for sphingoid bases. It is employed by idCerneg function.
lysopcpdb

P-LPC database
lysopcodb

O-LPC database
plotticmsbatch

TIC for all samples in a msbatch
ploteicmsbatch

EIC for all samples in a msbatch
pedb

PEs database
partitioning

agglomarative partitioning for LC-HRMS data based on enviPick algorithm
padb

PAs database
readMSfile

Read mzXML file and initiate msobject
peodb

O-PE database
tgdb

TGs database
setmsbatch

Create msbatch for batch processing.
mgdb

MGs database
select

Check matches between chains composition and precursor structures
searchIsotopesmsbatch

Targeted isotopes search for msbatch
searchIsotopes

Targeted isotopes search
rtdevplot

Plot retention time deviation
sphPdb

Sphingoid bases phosphate database
smdb

SMs database
sphdb

Sphingoid bases database
rtcorrection

Correct RT based on a rtmodel.
readFileLipidClasses

Allows reading a CSV that contains lipid classes and adducts to perform annotations and retention time predictions.
mzMatch

mz match withing a vector of mz values
psdb

PSs database
sumChains

Calculate total number of carbons and double bounds of lipid chains
removeduplicatedpeaks

Remove duplicated features after grouping step
MassAcylCer

Calculate formula and mass of acylceramides
LipidMSapp

LipidMS shiny app
MassLysoPAo

Calculate formula and mass of LPAo
CEdb

CEs database
MassCerP

Calculate formula and mass of ceramides phosphate
MassGlcCer

Calculate formula and mass of glucoceramides
MassDG

Calculate formula and mass of DG
MassFAHFA

Calculate formula and mass of FAHFA
MassCarnitines

Calculate formula and mass of carnitines
MassLysoPC

Calculate formula and mass of LysoPC
MassCE

Calculate formula and mass of cholesterol esthers
MassCer

Calculate formula and mass of ceramides
MassFA

Calculate formula and mass of fatty acids
MassCL

Calculate formula and mass of CL
MassLysoPCp

Calculate formula and mass of LysoPCp
MassLysoPCo

Calculate formula and mass of LysoPCo
MassPE

Calculate formula and mass of PE
MassLysoPA

Calculate formula and mass of LPA
MassHFA

Calculate formula and mass of hydroxi fatty acids
MassLysoPG

Calculate formula and mass of LPG
MassSM

Calculate formula and mass of sphingomyelines
MassPCp

Calculate formula and mass of PCp
MassLysoPEp

Calculate formula and mass of LPEp
MassPEo

Calculate formula and mass of plasmanyl PE
MassLysoPE

Calculate formula and mass of LPE
MassPEp

Calculate formula and mass of plasmenyl PE
MassLysoPEo

Calculate formula and mass of LPEo
MassSph

Calculate formula and mass of sphingoid bases