GlycReSoft

Software for analyzing glycomics and glycoproteomics LC-MS/MS data.

Usage

This package provides several command line tools, available under the name glycresoft.

$ glycresoft -h
Commands:
  analyze           Identify structures in preprocessed data
  build-hypothesis  Build search spaces for glycans and glycopeptides
  config            Set persistent configuration options
  export            Write Data Collections To Text Files
  mzml              Inspect and preprocess mzML files
  tools             Odds and ends to help inspect data and diagnose issues

Installing

This program requires Python 3.8 or newer, last tested with Python 3.10. The simplest way to perform the installation is to use a virtual environment to isolate its dependencies.

pip install -v glycresoft

To install from source after cloning this repository. The dependencies are listed in requirements.txt. The build system requirements in pyproject.toml, which includes numpy and Cython. A C compiler compatible with your version of Python for your platform is also required.

pip install -v .

or alternatively to install certain dependencies from source

make install-dependencies

This will install this library and all of its dependencies into the current Python environment. The command line tool will be made available under the name glycresoft.

If you want to build the standalone executable that bundles all of its dependencies with its own version of Python, next run

pip install PyInstaller
make build-pyinstaller

This will install PyInstaller, a Python program which can package another Python program and all of its dependencies into a native executable, and run it on an entry point wrapper for GlycReSoft. Afterwards, the standalone executable and its static files are located in ./pyinstaller/dist/glycresoft-cli/, where the executable is named glycresoft-cli, which will operate essentially the same as the glycresoft executable installed above, save that it will do some platform specific configuration and can be used from outside the virtual environment it was created in.

When installing pre-compiled wheels from the package index, installation should take less than 5 minutes on a regular computer. Installing packages from source things may take up to 15 minutes.

For glycopeptide fragmentation modeling, please see https://github.com/mobiusklein/glycopeptide_feature_learning.

GUI

For a web-based graphical user interface, see https://github.com/mobiusklein/glycresoft_app. The wrapping desktop application: https://github.com/mobiusklein/glycresoft_desktop.

Usage

The general CLI information, see the Documentation, or the command-level --help menu.

For Glycopeptides

For a brief tutorial on the original high collision energy glycopeptide search tool, see the Original Tutorial.

For a tutorial on the stepped collision energy glycopeptide search tool, see the SCE Tutorial.

Citing

If you used glycresoft in your research, please cite

Klein, J., Carvalho, L., & Zaia, J. (2024). Expanding N-glycopeptide identifications by modeling fragmentation, elution, and glycome connectivity. Nature Communications, 15(1), 6168. https://doi.org/10.1038/s41467-024-50338-5