Installation#

Check your version of python#

You will need python 3.8 or later. You can check your version of python by typing into a terminal:

$ python3 --version

It is recommended that you install into a “virtual environment” so this installation will not interfere with any existing Python software:

$ python3 -m venv /path/to/venv
$ source /path/to/venv/bin/activate

You can now use pip to install the library:

python3 -m pip install scanspec

If you require a feature that is not currently released you can also install from github:

python3 -m pip install git+git://github.com/dls-controls/scanspec.git

If you need to do any plotting (recommended), you should install the plotting extra:

python3 -m pip install scanspec[plotting]

If you need to run scanspec as a GraphQL service for generating points, you should install the graphql extra:

python3 -m pip install scanspec[graphql]

The library should now be installed and the commandline interface on your path. You can check the version that has been installed by typing:

scanspec --version