tnaake / MsQuality

7 stars 0 forks source link

Information on interpretability of the metrics #14

Open tnaake opened 1 year ago

tnaake commented 1 year ago

Add interpretation of the metrics in the vignette. Currently the interpretation is still lacking for the metrics

Should these interpretations be added to the mzQC obo file? @jorainer

Let's keep it rather basic (as this was also previously done for other metrics in the mzQC obo file). I have added some suggestions for each metric that we can discuss separately.

tnaake commented 1 year ago

Suggestions: chromatographyDuration: Longer times indicate better chromatographic separation.

tnaake commented 1 year ago

ticQuartersRtFraction: The metric informs about the dynamic range of the acquisition along the chromatographic separation.

tnaake commented 1 year ago

rtOverMsQuarters: The metric informs about the dynamic range of the acquisition along the chromatographic separation.

tnaake commented 1 year ago

ticQuartileToQuartileLogRatio: The metric informs about the dynamic range of the acquisition along the chromatographic separation.

tnaake commented 1 year ago

numberSpectra: An unusual low number may indicate incomplete sampling.

tnaake commented 1 year ago

mzAcquisitionRange: The metric informs about the dynamic range of the acquisition.

tnaake commented 1 year ago

rtAcquisitionRange: An unusual low range may indicate incomplete sampling.

tnaake commented 1 year ago

numberEmptyScans: An unusual high number may indicate incomplete sampling.

tnaake commented 1 year ago

medianPrecursorMz. The m/z distribution informs about the dynamic range of the acquisition.

tnaake commented 1 year ago

areaUnderTic: The metric informs about the dynamic range of the acquisition.

tnaake commented 1 year ago

areaUnderTicRtQuantiles: The metric informs about the dynamic range of the acquisition along the chromatographic separation.

tnaake commented 1 year ago

medianTicRtIqr: The metric informs about the dynamic range of the acquisition along the chromatographic separation.

tnaake commented 1 year ago

medianTicOfRtRange: The metric informs about the dynamic range of the acquisition along the chromatographic separation.

tnaake commented 1 year ago

meanCharge/medianCharge: Higher charges may indicate inefficient ionization or preference for e.g. longer peptides.

jorainer commented 1 year ago

Suggestions for some:

chromatographyDuration: the duration of the chromatography of a sample (in seconds). Longer duration could indicate a better separation of compounds which depends however also on the sampling/scan rate of the MS instrument. The duration of chromatographic runs for files/samples in an experiment should be very similar.

mzAcquisitionRange: the range of precursor m/z values for MSn scans within a sample. Depending on the used MS instrument configuration, these ranges should be similar. They might however differ between data files with DDA acquisition.

jorainer commented 1 year ago

ticQuartersRtFraction: The metric informs about the dynamic range of the acquisition along the chromatographic separation. This provides information on the sample (compound) flow along the chromatographic run and could indicate poor chromatographic runs (e.g. if no signal is measured for a big part of the chromatographic run).

jorainer commented 1 year ago

rtOverMsQuarters: The metric provides information on the retention times at which a certain proportion of MS scans (of the specified MS level) was measured. For MS1 scans the values are expected to be comparable across samples. For MS2 scans it depends on the acquisition mode and setting to select ions for fragmentation.

jorainer commented 1 year ago

numberEmptyScans: An unusual high number may indicate incomplete sampling, low sample volume or failed injection of a sample. The number of empty scans should be comparable across samples of an experiment.

jorainer commented 1 year ago

areaUnderTic: provides information about the total signal measured for a sample. These values should be (depending on the samples of the experiment) comparable across samples of an experiment.

jorainer commented 1 year ago

areaUnderTicRtQuantiles: The metric informs about the dynamic range of the acquisition along the chromatographic separation. Differences between samples of an experiment could indicate differences in chromatographic performance, or differences in sample content.