As of Dec 2024, pre-release binaries for LC-Inspector are distributed for Windows (64-bit) and MacOS (arm64). These can be found under Releases on the GitHub page of LC-Inspector's main branch, gui-redesign.
Since the binaries are currently NOT signed, it is possible for automatic antivirus/quarantine programs such as Microsoft Windows Defender to flag them as malware.
On Windows, if this happens, go into Windows Defender -> Protection history -> LC-Inspector, find the LC-Inspector entry and click Restore. If the warning "Windows protected your PC" appears, click More info and Run anyway.
On MacOS, the following command can be executed to remove an app from quarantine:
xattr -d com.apple.quarantine /path/to/app.app
so for example, if the app was copied to the Applications folder:
xattr -d com.apple.quarantine /Applications
If the command executes without any errors, the app should launch and work normally.
The graphical user interface (UI) of LC-Inspector is currently in early development. A lot of features visible in the UI is not functional yet. Bugs are prevalent and to be expected.
This package preprocesses, analyzes and annotates LC-MS data.
It was primarily designed to annotate LC-MS files of derivatized amino acids and polyamines but can be used with any targeted LC-MS workflow.
Input can only be plain text (.txt) files for LC chromatograms and mzML files for the MS data. Alternatively, annotation files (expected .txt) can be used if exact retention times of targeted compounds are known.
The script starts by parsing and preprocessing the given LC and MS files, interpolating intensity over a linearly-spaced m/z axis, reconstructing extracted ion chromatograms for a given set of peaks and plotting annotated LC spectra.
- Clone the repository or download the compressed version (Code -> Download ZIP) and unpack
- Install Python 3.12 or later
- Navigate to the folder containing
main.pyin the terminal (e.g., cmd on Windows or Terminal on MacOS) - Install the dependencies listed out in requirements.txt (
$ pip3 install -r requirements.txt):- pyyaml (≥ 6.0.2)
- pyqt6 (≥ 6.7.3)
- scipy (≥ 1.14.1)
- pyteomics (≥ 4.7.5)
- lxml (≥ 5.3.0)
- static_frame (≥ 2.15.1)
- pyqtgraph (≥ 0.13.7)
- Prepare the input data:
- The script expects the LC input data to be in .txt format.
- The script expects the MS input data to be in .mzml format.
- (OPTIONAL) Instead of the MS data, pre-annotated .txt files can be supplied if retention times are known (Thermo Chromeleon format).
- Run the script via the main.py file (
$ python3 main.py).
The graphical user interface version (on branches main and gui-redesign) allows the user to browse their machine and upload liquid chromatography files (.txt format) and open-format mass spectrometry files (.mzML ).
The script preprocesses the data and lets the user display the results in the "Results" tab of the main view. The plots are interactive, allowing the user to inspect the data closely, copy the plots to clipboard or export them in .png, .tif or .svg formats.
An unnotated export of the plot data is also possible, although this feature is not well-implemented.
The script version (branches cluster, ms-integration) produces results in the form of .csv files in the 'data/results' folder, alongside plots of calibration curves, background corrected chromatograms and recognized peaks in the 'data/plots' folder.
pyteomics library
hplc-py package by Griffin Chure from the Cremer lab:
https://cremerlab.github.io/hplc-py/
https://github.com/cremerlab/hplc-py
This project is distributed under the permissive MIT license. Details can be found in LICENSE.txt.
Created on 2024-02-29 Copyright (c) Mateusz Fido, ETH Zürich, 2024 mateusz.fido@org.chem.ethz.ch