Installation
To install LumiSpy, you have the following options (independent of the operating system you use):
LumiSpy is included in the HyperSpy Bundle, a standalone program that includes a python distribution and all relevant libraries (recommended if you do not use python for anything else).
Installation using conda (recommended if you are also working with other python packages).
Installing the development version from GitHub. Refer to the appropriate section in the HyperSpy user guide (replacing
hyperspy
bylumispy
).
Installation using conda
Follow these 3 steps to install LumiSpy using conda and start using it.
1. Creating a conda environment
LumiSpy requires Python 3 and conda
– we suggest using the Python 3 version
of Miniconda.
We recommend creating a new environment for the LumiSpy package (or installing it in the HyperSpy environment, if you have one already). To create a new environment:
Load the anaconda prompt.
Run the following command:
(base) conda create -n lumispy -y
2. Installing the package in the new environment
Now activate the LumiSpy environment and install the package from conda-forge
:
(base) conda activate lumispy
(lumispy) conda install -c conda-forge lumispy -y
Required dependencies will be installed automatically.
Installation is completed! To start using it, check the next section.
Note
If you run into trouble, check the more detailed documentation in the HyperSpy user guide.
3. Getting Started
To get started using LumiSpy, especially if you are unfamiliar with Python, we recommend using Jupyter notebooks. Having installed LumiSpy as above, a Jupyter notebook can be installed and opened using the following commands entered into an anaconda prompt (from scratch):
(base) conda activate lumispy
(lumispy) conda install -c conda-forge jupyterlab -y
(lumispy) jupyter lab
Tutorials and exemplary workflows have been curated as a series of Jupyter notebooks that you can work through and modify to perform many common analyses.
Installation using pip
Alternatively, you can also find LumiSpy in the Python Package Index (PyPI)
and install it using (requires pip
):
pip install lumispy
Required dependencies will be installed automatically.
Updating the package
Using conda:
conda update lumispy -c conda-forge
Using pip:
pip install lumispy --upgrade
Note
If you want to be notified about new releases, please Watch (Releases only) the Lumispy repository on GitHub (requires a GitHub account).