Difference between revisions of "LipidXplorer Installation"
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | '''Note:''' The current package of LipidXplorer is mainly compatible with 64bit versions of '''Microsoft Windows''' ( | + | '''Note:''' The current package of LipidXplorer is mainly compatible with 64bit versions of '''Microsoft Windows''' (8,10,11) only. A Linux version is only available from source. If you need help, [https://lifs-tools.org/support please contact us]. |
=====File conversion===== | =====File conversion===== | ||
| − | LipidXplorer supports the generic file formats *.mzML and *.mzXML. Raw spectra as they are produced by the mass spectrometer have to be converted into one of those formats before they can be used with LipidXplorer. The recommended converter is [ | + | LipidXplorer supports the generic file formats *.mzML and *.mzXML. From LipidXplorer 1.5, it will drop the support on mzXML and add .dta/csv format. Raw spectra as they are produced by the mass spectrometer have to be converted into one of those formats before they can be used with LipidXplorer. The recommended converter is [https://proteowizard.sourceforge.io/download.html MSConvert] from the ProteoWizard package. It supports the formats of the main mass spectrometer vendors and is maintained by a team of developers. It comes with an easy-to-use graphical user interface. |
Details on how to use msConvert for LipidXplorer can be found [[LipidXplorer msconvert conversion|here]] | Details on how to use msConvert for LipidXplorer can be found [[LipidXplorer msconvert conversion|here]] | ||
| Line 8: | Line 8: | ||
====Binary Distribution for Windows==== | ====Binary Distribution for Windows==== | ||
| − | The binary distribution of LipidXplorer is a zip-Archive containing the LipidXplorer.exe file. You can download the latest release version from [https:// | + | The binary distribution of LipidXplorer is a zip-Archive containing the LipidXplorer.exe file. You can download the latest release version from [https://zenodo.org/records/15064195 here] |
Requirements: | Requirements: | ||
| Line 39: | Line 39: | ||
The sourcecode should now be cloned into the selected directory within the 'lipidxplorer' folder. | The sourcecode should now be cloned into the selected directory within the 'lipidxplorer' folder. | ||
| − | The next step is to import the | + | The next step is to import the .yml environment file, located in the lipidxplorer folder into anaconda. |
Please follow the instructions [https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#creating-an-environment-from-an-environment-yml-file here], just replace 'environment.yml' with wx-py27-anaconda.yml | Please follow the instructions [https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#creating-an-environment-from-an-environment-yml-file here], just replace 'environment.yml' with wx-py27-anaconda.yml | ||
| Line 54: | Line 54: | ||
# For further hints and tutorials, please see the [https://www.jetbrains.com/help/pycharm/quick-start-guide.html PyCharm Quickstart] | # For further hints and tutorials, please see the [https://www.jetbrains.com/help/pycharm/quick-start-guide.html PyCharm Quickstart] | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
----- | ----- | ||
'''[1]''' Herzog, R., Schwudke, D., Schuhmann, K., Sampaio, J.L., Bornstein, S.R., Schroeder, M., and Shevchenko, A. 2011. A novel informatics concept for high-throughput shotgun lipidomics based on the molecular fragmentation query language. Genome Biol 12(1): R8. | '''[1]''' Herzog, R., Schwudke, D., Schuhmann, K., Sampaio, J.L., Bornstein, S.R., Schroeder, M., and Shevchenko, A. 2011. A novel informatics concept for high-throughput shotgun lipidomics based on the molecular fragmentation query language. Genome Biol 12(1): R8. | ||
Latest revision as of 08:58, 31 July 2026
Note: The current package of LipidXplorer is mainly compatible with 64bit versions of Microsoft Windows (8,10,11) only. A Linux version is only available from source. If you need help, please contact us.
File conversion
LipidXplorer supports the generic file formats *.mzML and *.mzXML. From LipidXplorer 1.5, it will drop the support on mzXML and add .dta/csv format. Raw spectra as they are produced by the mass spectrometer have to be converted into one of those formats before they can be used with LipidXplorer. The recommended converter is MSConvert from the ProteoWizard package. It supports the formats of the main mass spectrometer vendors and is maintained by a team of developers. It comes with an easy-to-use graphical user interface.
Details on how to use msConvert for LipidXplorer can be found here
Binary Distribution for Windows
The binary distribution of LipidXplorer is a zip-Archive containing the LipidXplorer.exe file. You can download the latest release version from here
Requirements: The binary version of LipidXplorer requires a 64bit Windows installation to run. Everything else is already bundled in the .exe file.
In order to run LipidXplorer from the binary distribution, please proceed as follows:
- unzip the LipidXplorer-X.Y.Z.zip archive to a location of your choice,
- open the unzipped directory in your Windows Explorer,
- double-click LipidXplorer.exe to launch the application.
Please see the Tutorial for instructions on how to proceed.
Sourcecode Installation for Windows
Requirements: In order to work with the sourcecode and build LipidXplorer, you will need the following tools on your Windows PC (64 bit)
- Git (TortoiseGit)
- A Python IDE PyCharm CE
- Anaconda2, 64bit
The source code for LipidXplorer has been moved to the LIFS Tools GitHub. In order to clone it with TortoiseGit, follow these steps:
- open a folder in your Windows Explorer where you want to keep the sourcecode locally,
- right-click and select 'Git Clone...',
- enter the repository URL: https://github.com/lifs-tools/lipidxplorer.git ,
- left-click 'Ok'
The sourcecode should now be cloned into the selected directory within the 'lipidxplorer' folder.
The next step is to import the .yml environment file, located in the lipidxplorer folder into anaconda. Please follow the instructions here, just replace 'environment.yml' with wx-py27-anaconda.yml
In order to use the dependencies for your project, open a Conda2 shell and navigate to the location where your project was cloned to. Follow the instructions here to activate the environment. You can then run LipidXplorer by typing 'python LipidXplorer.py'.
Using PyCharm
If you use PyCharm as your IDE, the following instructions will help you get started:
- Use https://github.com/lifs-tools/lipidxplorer.git as the Git location: Set up the git repository
- Use the wx-py27 anaconda environment and the conda Python 2.7 interpreter: [1]
- For further hints and tutorials, please see the PyCharm Quickstart
[1] Herzog, R., Schwudke, D., Schuhmann, K., Sampaio, J.L., Bornstein, S.R., Schroeder, M., and Shevchenko, A. 2011. A novel informatics concept for high-throughput shotgun lipidomics based on the molecular fragmentation query language. Genome Biol 12(1): R8.