You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
==> [Run it on a Jupyter Notebook right now in your browser!](https://mybinder.org/v2/gh/MannLabs/alphaquant/main?urlpath=%2Fdoc%2Ftree%2Fexample_nbs%2Fdifferential_expression.ipynb) No login or installation required.
12
-
<==
12
+
<==
13
13
14
14
# AlphaQuant
15
15
AlphaQuant is an innovative open-source Python package for proteomics data analysis. It implements tree-based quantification - a hierarchical approach to organize and analyze quantitative data across multiple levels - from fragments and MS1 isotopes through charge states, modifications, peptides, and genes.
@@ -50,16 +50,18 @@ AlphaQuant is designed for proteomics researchers analyzing DDA or DIA experimen
50
50
## Installation
51
51
52
52
AlphaQuant can be installed and used on all major operating systems (Windows, macOS and Linux).
53
-
There are currently two different types of installation possible:
53
+
There are currently four different types of installation possible:
54
54
55
-
*[**One-click GUI installer**](#one-click-gui-installation) Choose this installation if you only want the GUI and/or keep things as simple as possible.
55
+
*[**One-click GUI installer**](#one-click-gui-installation) Choose this installation if you only want the GUI and/or keep things as simple as possible. Install time should be in the order of minutes.
56
56
57
57
*[**Pip installer:**](#pip) Choose this installation if you want to use AlphaQuant as a Python package in an existing python 3.11 environment (e.g. a Jupyter notebook). If needed, the GUI can be installed with pip as well.
58
58
59
59
*[**Developer installation:**](#developer-installation) Choose this installation if you are familiar with CLI tools, [conda](https://docs.conda.io/en/latest/) and Python. This installation allows access to all available features of AlphaQuant and even allows to modify its source code directly. Generally, the developer version of AlphaQuant outperforms the precompiled versions which makes this the installation of choice for high-throughput experiments.
60
60
61
61
*[**Docker**](#docker) Choose this installation if you want to use AlphaQuant without any installation to your system.
62
-
62
+
63
+
E2E tests are run on GitHub's "-latest" runner images, which correspond to Ubuntu 22.04, macOS 14, and Windows Server 2022 at the time of public release.
64
+
63
65
### One-click GUI installation
64
66
Currently available for **MacOS**, **Windows**.
65
67
You can download the latest release of alphaquant [here](https://github.com/Mannlabs/alphaquant/releases/latest).
@@ -69,8 +71,7 @@ You can download the latest release of alphaquant [here](https://github.com/Mann
69
71
(can be looked up by clicking on the Apple Symbol > *About this Mac* > *Chip* ("M1", "M2", "M3" -> `arm64`, "Intel" -> `x64`),
70
72
`alphaquant-X.Y.Z-macos-darwin-arm64.pkg` or `alphaquant-X.Y.Z-macos-darwin-x64.pkg`. Open the parent folder of the downloaded file in Finder,
71
73
right-click and select *open*. If you receive a warning during installation click *Open*. If you want to use `.raw` files on Thermo instruments alphaRaw is required, which depends on Mono. A detailed guide to installing alphaRaw with mono can be found [here](https://github.com/MannLabs/alpharaw#installation).
72
-
***Linux:** Installers are provided, but undergo only limited testing: `alphaquant-X.Y.Z-linux-x64.deb` build and install it via `dpkg -i alphaquant-X.Y.Z-linux-x64.deb`. In case of issues, follow the steps for the
73
-
[developer installation](docs/installation.md#developer-installation) in order to use the GUI.
74
+
74
75
75
76
76
77
@@ -140,15 +141,15 @@ The containerized version can be used to run AlphaQuant without any installation
140
141
Install the latest version of docker (https://docs.docker.com/engine/install/).
141
142
142
143
#### 2. Prepare folder structure
143
-
Set up your data to match the expected folder structure:Create a folder and store its name in a variable,
144
+
Set up your data to match the expected folder structure:Create a folder and store its name in a variable,
144
145
e.g. `DATA_FOLDER=/home/username/data; mkdir -p $DATA_FOLDER`
145
146
146
147
#### 3. Start the container
147
148
```bash
148
149
docker run -v $DATA_FOLDER:/app/data -p 41215:41215 mannlabs/alphaquant:latest
149
150
```
150
151
After initial download of the container, alphaquant will start running immediately,
151
-
and can be accessed under [localhost:41215](localhost:41215).
152
+
and can be accessed under [localhost:41215](localhost:41215).
152
153
153
154
Note: in the app, the local `$DATA_FOLDER` needs to be referred to as "`/app/data`".
154
155
@@ -192,7 +193,7 @@ import alphaquant.run_pipeline as aq_pipeline
For more detailed examples and advanced use cases, we provide several Jupyter notebooks with example data in the [example_nbs folder](example_nbs): There, you can use very simple calls in order to:
196
+
For more detailed examples and advanced use cases, we provide several Jupyter notebooks with example data in the [example_nbs folder](example_nbs): There, you can use very simple calls (execution time in the order of minutes) in order to:
196
197
* perform very sensitive differential expression analysis on a single condition, analyze and visualize proteoforms [here](example_nbs/differential_expression.ipynb)
197
198
* analyze multiple condition together and inspect proteoform profiles [here](example_nbs/multi_condition_analysis.ipynb)
198
199
* perform phosphosite and ptm mapping with subsequent differential expression analysis, as well as proteome normalization of phospho sites [here](example_nbs/differential_expression_PTM.ipynb)
@@ -290,7 +291,7 @@ In case of issues, check out the following:
290
291
A manuscript has been submitted to bioRxiv:
291
292
> **Tree-based quantification infers proteoform regulation in bottom-up proteomics data**
292
293
> Constantin Ammar, Marvin Thielert, Caroline A M Weiss, Edwin H Rodriguez, Maximilian T Strauss, Florian A Rosenberger, Wen-Feng Zeng, Matthias Mann
0 commit comments