# Preface

software features intended audience report feedback

## Software feature offerings and intended audience

This manual is about the &MsXpS; mass spectrometric software suite, a software environment that contains two modules:

- &MassXp; module (currently &MassXp3;): Allows users to define brand new polymer chemistries and use these polymer chemistry definitions to model linear polymer sequence. Once modelled, a polymer sequence can undergo chemical reactions (enzymatic or chemical cleavages, gas-phase fragmentations…). The obtained results are a model of what a mass spectrum would look like if the modelled experiment had actually been carried over up to the mass spectrometry analysis;

- &MineXp; module (currently &MineXp3;): Allows users to load mass spectrometry data from mzML files, visualize and mine the data throughout all their depth. The mass data visualization starts at the TIC chromatogram level and deepens to the mass spectra, the drift spectra, the XIC chromatograms.

As such, this manual is intended for people willing to learn how to use the comprehensive &MsXpS; software package.

Mass spectrometry has gained popularity across the past twenty years or so. Indeed, developments in polymer mass spectrometry have made this technique appropriate to accurately measure masses of polymers as heavy as many hundreds of kDa, and of any chemical type.

There are a number of utilities—sold by mass spectrometer constructors with their machines, usually as a marketing plus—that allow predicting/analyzing mass spectrometric data obtained on polymers. These programs are usually different from a constructor to another. Also, there are as many mass spectrometric data prediction/analysis computer programs as there are different polymer types. You will get a program for oligonucleotides, another one for proteins, maybe there is one program for saccharides, and so on. Thus, the biochemist/massist, for example, who happens to work on different biopolymer types will have to learn to use several different software packages. Also, if the software user does not own a mass spectrometer, chances are he will need to buy all these software packages.

The &MsXpS; mass spectrometric software is designed to provide free solutions to all these problems by providing the following features:

- &MassXp;:

  - Model ex nihilo polymer chemistry definitions (in the &xpd; module that is part of the &MassXp; program);

  - Peform simple yet powerful mass computations to be made in a mass desktop calculator that is both polymer chemistry definition-aware and fully programmable (that's the &xpc; module also part of the &MassXp; program);

  - Edit polymer sequences on a polymer chemistry definition-specific basis, along with chemical reaction simulations, finely configured mass spectrometric computations… (all taking place in the &xpe; module that is the main module of the &MassXp; program);

  - Customize the way each monomer will show up graphically during the program operation (in the &xpe; module);

  - Edit polymer sequences with immediate visualization of the mass changes elicited by the editing activity (in the &xpe; module);

  - Open an unlimited number of polymer sequences at any given time and of any given polymer chemistry definition type (in the &xpe; module);

  - Use a scripting console to automate a large number of tasks, including the generation of complex synthetic mass spectra of biopolymer intact molecules or of sets of biopolymer (bio)chemical lysate fragments (like peptides, for example) (in the &xps; module).

- &MineXp;:

  - Load mass spectometry data files in the mzML format, thanks to the excellent libpwiz library of ProteoWizard

    .

    fame;

  - Display the data in powerful ways in a unified graphical user interface. The interface was designed to integrate all the most useful characteristics of the various proprietary environments known by the author, thanks to the excellent libqcustomplot

    .

    library;

  - Configure the way mass spectrometry data integrations are performed and optionally configure and apply a Savitzky-Golay smoothing;

  - Perform data mining by performing data integrations in various ways;

  - Ion mobility mass spectrometry data are supported with an automatic &mz; = f(&dt;) color map plot calculation;

  - A specific data integration mode allows easy quantitation of spectral data at any level (TIC chromatogram, mass spectrum, drift spectrum);

  - Innovative data analysis recording allows to store the features mined during the data mining sessions in flexible ways that allow further data processing, like injection in databases;

  - A JavaScript scripting environment allows taking the control of the software and of all the widgets from a script file;

  - Convert data from mzML to the private (albeit open) database file format that allows to load data much faster. &MineXp; can slice big data files into smaller chunks retaining all the data selected by the user in the most flexible ways.

  - Use a scripting console to automate a large number of tasks.

## Feedback from the users

We are always grateful to any constructive feedback from the users.

The MsXpertSuite software team might be contacted via the following addresses

Addresses to report feedback to

## Project History

This is a brief history of &MsXpS;.

- 1998–2000

  The name &MassXp; comes from a project I started while I was a post-doctoral fellow at the École Polytechnique (Institut Européen de Chimie et Biologie, Université Bordeaux 1, Pessac, France);

  The &MassXp; program was published in Bioinformatics ( Rusconi, F. and Belghazi, M. Desktop prediction/analysis of mass spectrometric data in proteomic projects by using massXpert . Bioinformatics, 2002, 644–655 ).

  At that time, MS-Windows was at the Windows NT 4.0 version and the next big release was going to be you'll see what you'll see : MS-Windows 2000.

  When I tried &MassXp; on that new version (one colleague had it with a new machine), I discovered that my software would not run normally (the editor was broken). The Microsoft technical staff would advise to buy a new version of the compiler environment and rebuild . This was a no-go: I did not want to continue paying for using something I had already produced with legitimate software.

- 2001–2006

  During fall 1999, I decided that I would stop using Microsoft products for my development. At the beginning of 2000 I started as a CNRS research staff in a new laboratory and decided to start fresh: I switched to GNU/Linux (I never looked back). After some months of learning, I felt mature to start a new development project that would eventually become an official GNU package: GNU polyxmass .

  The GNU polyxmass software, much more powerful than what the initial &MassXp; software used to be, was published in BMC Bioinformatics in 2006 ( Rusconi, F. GNU polyxmass: a software framework for mass spectrometric simulations of linear (bio-)polymeric analytes . BMC Bioinformatics, 225– ).

  Following that publication I got a lot of feedback (very positive, in a way) along the lines: — Hey, your software looks very interesting; only it's a pity we cannot use it because it runs on GNU/Linux, and we only use MS-Windows and MacOSX! .

- 2007–2016

  In december 2006, I decided to make a full rewrite of GNU polyxmass. The software of which you are reading the user manual is the result of that rewrite. I decided to recycle the &MassXp; name because this software is written in C++, as was the first &MassXp; software. Also, because the first MS-Windows-based &MassXp; project is not developped anymore, taking that name was kind of a revival which I enjoyed. However, the toolkit I used this time is not the Microsoft Foundation Classes (first &MassXp; version) but the Trolltech Qt framework (see the About Qt menu in the Help menu in &MassXp;).

  Coding with the Qt libraries has one big advantage: it allows the developer to code once and to compile on the three main platforms available today: GNU/Linux, MacOSX, MS-Windows. Another advantage is that the Qt libraries are wonderful software, technically and philosophically (Free Software).

  The rewritten software was published in 2009 ( Rusconi, F. massXpert 2: a cross-platform software environment for polymer chemistry modelling and simulation/analysis of mass spectrometric data .Bioinformatics, 2009, 2741–2742 ).

- 2016–2022

  In 2016, I started a new project about visualization of mass spectrometric data. The project developed pretty quickly, as we needed at the mass spectrometry facility a software that would allow to cope efficiently with ion mobility mass spectrometric experimental data. &MineXp; was thus started.

  To bundle both &MassXp; and &MineXp; in a single software suite, I bought the &MsXpS; website and created that new name.

- 2023–

  The fundamental classes used in both &MassXp; and &MineXp; were structured in two private libraries: `libmass` and `libmassgui`. In 2023, I still used two copies of these libraries source code trees in each one of the two projects: one copy in the &MassXp; source code tree and one copy in the &MineXp; source code tree, although I was actually managing a single copy, making synchronizations of the private libraries in every direction… I happened to get fed up with this way of working and I finally decided to extract these copies ouf the source code trees of &MassXp; and &MineXp; and to create a new &XpMass; project containing two shared object libraries (dll files in MS-Windows):

  - libXpertMassCore;

  - libXpertMassGui;

  I also decided that I would stop bundling both &MassXp; and &MineXp; into a single package, now letting the users choose what package theyt actually want to download and install. See the updated &MsXpS; website

## Program and Documentation Availability and License

The programs and all the documentation that are shipped along with the &MsXpS; software suite are available at . Most of the time, a new version is published as source, as binary install packages for MacOSX and MS-Windows. No GNU/Linux are created outside of the autbuilder of the various distributions. As a Debian Developer, Filippo Rusconi creates Debian

packages that are uploaded on the distribution servers. These packages are available using the system's software management infrastructure (like apt , for example).

The software and all the documentation are all provided under the Free Software license GNU General Public License, Version 3, or later, at your option . For an in-depth study of the Free Software philosphy I kindly urge the reader to visit .