Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Information on interpretability of the metrics #14

Open
7 of 15 tasks
tnaake opened this issue Jul 21, 2023 · 20 comments
Open
7 of 15 tasks

Information on interpretability of the metrics #14

tnaake opened this issue Jul 21, 2023 · 20 comments

Comments

@tnaake
Copy link
Owner

tnaake commented Jul 21, 2023

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

  • chromatographyDuration
  • ticQuartersRtFraction
  • rtOverMsQuarters
  • ticQuartileToQuartileLogRatio
  • numberSpectra
  • mzAcquisitionRange
  • rtAcquisitionRange
  • numberEmptyScans
  • medianPrecursorMz
  • areaUnderTic
  • areaUnderTicRtQuantiles
  • medianTicRtIqr
  • medianTicOfRtRange
  • meanCharge
  • medianCharge

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
Copy link
Owner Author

tnaake commented Jul 21, 2023

Suggestions:
chromatographyDuration: Longer times indicate better chromatographic separation.

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

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

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

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

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

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

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

numberSpectra: An unusual low number may indicate incomplete sampling.

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

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

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

rtAcquisitionRange: An unusual low range may indicate incomplete sampling.

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

numberEmptyScans: An unusual high number may indicate incomplete sampling.

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

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

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

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

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

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

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

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

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

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

@tnaake
Copy link
Owner Author

tnaake commented Jul 21, 2023

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

@jorainer
Copy link
Collaborator

jorainer commented Aug 1, 2023

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
Copy link
Collaborator

jorainer commented Aug 1, 2023

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
Copy link
Collaborator

jorainer commented Aug 1, 2023

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
Copy link
Collaborator

jorainer commented Aug 1, 2023

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
Copy link
Collaborator

jorainer commented Aug 1, 2023

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
Copy link
Collaborator

jorainer commented Aug 1, 2023

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants