Note that only the legacy version of pycroscopy can be installed at this time. We are currently working on the thoroughly reimagined version of pycroscopy.
Preparing for pycroscopy¶
Pycroscopy requires many commonly used scientific and numeric python packages such as numpy, h5py etc. To simplify the installation process, we recommend the installation of Anaconda which contains most of the prerequisite packages, conda - a package / environment manager, as well as an interactive development environment - Spyder.
Do you already have Anaconda installed?
No? Download and install Anaconda for Python 3.6
Yes? Is your Anaconda based on python 3.6+?
No? Uninstall existing Python / Anaconda distribution(s). Restart computer afterwards.
Yes? Proceed to install pycroscopy
Pycroscopy is expected to only work on Python 3.6+.
We currently do not support 32 bit architectures
Once the appropriate Anaconda distribution has been successfully installed, pycroscopy can be installed easily either via the python package index (pypi / pip) or conda-forge (conda).
Open a terminal (mac / linux) or command prompt (windows - be sure to install in a location where you have write access. Don’t install as administrator unless you are required to do so.) and type:
pip install pycroscopy
First, open a terminal / command window. Add conda-forge to your channels with:
conda config --append channels conda-forge
Once the conda-forge channel has been enabled, pycroscopy can be installed with:
conda install pycroscopy
Installing the legacy version¶
The upcoming version of pycroscopy will not share any code or capabilities with the legacy version. In order to install the last legacy version of pycroscopy before this major revision, please use the following commands in a terminal:
pip install pycroscopy==0.60.7
Installing from a specific branch (advanced users ONLY)¶
Here, we are installing pycroscopy from the latest development branch. Note that we do not recommend installing pycroscopy this way.
Before you can install pycroscopy, you need to install git.
conda install git
Once git has installed, you can install a specific branch of pycroscopy (
dev in this case):
pip install -U git+https://github.com/pycroscopy/pycroscopy@dev
We recommend periodically updating your anaconda distribution. To fully update run the following commands in a terminal / command window.
conda upgrade anaconda conda update --all
If you installed pycroscopy via conda, the last command should update pycroscopy as well.
Updating via pip¶
If you already have pycroscopy installed and want to update to the latest version, use the following command in a terminal / command window:
pip install -U --no-deps pycroscopy
If it does not work try reinstalling the package:
pip uninstall pycroscopy pip install pycroscopy
Updating via conda¶
If you installed pycroscopy via conda, open a terminal / command window and type:
conda update pycroscopy