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
Copy file name to clipboardExpand all lines: README.md
+15-10Lines changed: 15 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,29 +1,32 @@
1
1
2
+
2
3
# LipoCLEAN: A machine learning based quality filter for lipid identifications from MS-DIAL
3
4
There are three ways to install and run LipoCLEAN: as an executable, as a docker container, and as a python package.
4
5
5
6
## The executable version
6
7
This method requires no installation but it is somewhat slower than the other options.
7
8
1. Download the executable for your operating system, the trained model, and the example options file from the [releases page](https://github.com/stavis1/lipoCLEAN/releases).
8
9
2. Extract `example_analysis.zip` and `QE_Pro_model.zip` into the same folder. There should be no folders nested under `QE_Pro_model/` and all files from `example_analysis.zip` should be in the top level folder.
9
-
3. Run `lipoCLEAN.exe --options example_analysis_options.txt`
10
+
3. Run `lipoCLEAN.exe --options example_analysis_options.txt`.
10
11
4. The results will be in a folder named `example_output/` the `example_output/QC/` folder contains several plots to assess the quality of the results.
11
-
5. If you want a default version of the options file run `lipoCLEAN.exe --print options.txt`
12
+
5. If you want a default version of the options file run `lipoCLEAN.exe --print options.txt`.
13
+
6. To use the tool on other data edit the `options.txt` file.
12
14
13
15
On some systems the warning `No module named 'brainpy._c.composition'` will be displayed. This is not an error and does not impact the running of the tool.
14
16
15
-
## The conda version
16
-
To set up the conda environment for the tool:
17
+
## The Conda version
18
+
To set up the Conda environment for the tool:
17
19
1. Download the LipoCLEAN repository and navigate to the `environments` directory.
18
20
2. Run `conda env create -p lipo_env --file lipoCLEAN.yml`
19
21
3. Run `conda activate ./lipo_env`
20
22
4. Navigate to the repository root.
21
23
5. Run `pip install .`
22
-
7. Download the trained model, and the example options file from the [releases page](https://github.com/stavis1/lipoCLEAN/releases).
23
-
8. Extract `example_analysis.zip` and `QE_Pro_model.zip` into the same folder. There should be no folders nested under `QE_Pro_model/` and all files from `example_analysis.zip` should be in the top level folder.
24
-
9. Run `python -m lipoCLEAN --options example_analysis_options.txt`
25
-
10. The results will be in a folder named `example_output/` the `example_output/QC/` folder contains several plots to assess the quality of the results.
26
-
11. If you want a default version of the options file run `python -m lipoCLEAN --print options.txt`
24
+
6. Download the trained model, and the example options file from the [releases page](https://github.com/stavis1/lipoCLEAN/releases).
25
+
7. Extract `example_analysis.zip` and `QE_Pro_model.zip` into the same folder. There should be no folders nested under `QE_Pro_model/` and all files from `example_analysis.zip` should be in the top level folder.
26
+
8. Run `python -m lipoCLEAN --options example_analysis_options.txt`
27
+
9. The results will be in a folder named `example_output/` the `example_output/QC/` folder contains several plots to assess the quality of the results.
28
+
10. If you want a default version of the options file run `python -m lipoCLEAN --print options.txt`
29
+
11. To use the tool on other data edit the `options.txt` file.
27
30
28
31
On some systems the warning `No module named 'brainpy._c.composition'` will be displayed. This is not an error and does not impact the running of the tool.
29
32
@@ -34,6 +37,7 @@ The docker container has trained models provided under /models/. To use these ge
34
37
3. Extract `QE_Pro_model.zip`.
35
38
4. Run `docker run --rm -v /path/to/your/data/:/data/ stavisvols/lipoclean python -m lipoCLEAN --options /data/docker_example_analysis_options.txt`
36
39
5. If you want the default docker options file run `docker run --rm -v /path/to/your/data/:/data/ stavisvols/lipoclean python -m lipoCLEAN --print /data/options.txt`
40
+
6. To use the tool on other data edit the `options.txt` file.
37
41
38
42
## MS-Dial export settings for inference
39
43
1. Click "Export" along the top bar
@@ -45,7 +49,7 @@ The docker container has trained models provided under /models/. To use these ge
45
49
7. "Export format" should be "msp"
46
50
8. Click Export
47
51
48
-
A .txt will now be generated in the chosen directory with the information required for MSDpostprocess. The file name will start with "Mz"
52
+
A .txt will now be generated in the chosen directory with the information required for LipoCLEAN. The file name will start with "Mz"
49
53
50
54
## Prepare training data
51
55
1. Start with MS-DIAL exports using the same settings as described above for inference.
@@ -65,3 +69,4 @@ The tool is capable of being trained on multiple input files. The retention time
65
69
Our tests have shown that a model will likely generalize to a family of instruments but that this has limits. We expect that the QE_Pro_model will work for all orbitrap systems. We do not have the data necessary to know how well the TOF model will generalize to all TOF instruments so if you are working with e.g. TimsTOF data it would be a good idea to do an initial validation of the output. The publicly available datasets used were reprocessed from raw files and annotated in-house.
66
70
67
71
Disclaimer: We are not in any way associated with the developers of MS-DIAL, we are merely enthusiastic users of their software.
0 commit comments