Installation#

Prerequisites#

FlickerPrint is available for Windows, macOS and Linux and requires a working installation of Python 3 (Python 3.9 - Python 3.11, Python 3.10.8 is recommended) and Java. We recommend that you install Java in your home directory for easy access. There is also the option to use LaTeX for typsetting of figures, however this is not required.

System-Specific Prerequisites#

In addition to Python and Java, you will need to install a C compiler. Please install Visual Studio 2022 Community Edition (or higher) from here and install the Desktop Development with C++ tools and .NET dektop development tools.

In addition to Python and Java, you will need to install the xcode command line tools if you do not have them already. To do this, open the terminal and type:

xcode-select --install

No Linux-specific software is required, though you will still need a working installation of Python and Java, and a C compiler.

Installation via pip#

FlickerPrint can be installed directly using pip:

python -m pip install flickerprint

python3 -m pip install flickerprint

python3 -m pip install flickerprint

Note

The JAVA_HOME and PATH environment variables must be set correctly so that the Java installation can be found by the Python modules that require it. FlickerPrint will attempt to set these automatically on installation, though you can also set them manually using the instructions below.

Building from Source#

To install FlickerPrint from source, download the source code from GitHub. Open the terminal and navigate to the FlickerPrint/src directory. Then install it using pip:

python -m pip install .

python3 -m pip install .

python3 -m pip install .

Setting Environment Variables#

As part of the installation process, FlickerPrint will attempt to set the JAVA_HOME and PATH environment variables automatically. If this fails, you may need to set them manually. Instructions are provided below for each operating system.

When Java is installed on Windows, the JAVA_HOME environment variable is set automatically. However, if you need to set enviroment vairables manually, you can find instructions for doing so here.

You will need to set the JAVA_HOME environement variable and add it to your PATH. To do this open the terminal and type (changing <pathToJava/home> to the location of your Java installation):

export JAVA_HOME=<pathToJava/home>
export PATH=$JAVA_HOME/bin:$PATH

You may find it helpful to add the above lines to your config file for easy access in future (optional). To do so, open the appropriate config file for your system:

Likely

nano ~/.zprofile

Then add the above two lines to the file, save it and relaunch the terminal.

You will need to set the JAVA_HOME environement variable and add it to your PATH. To do this open the terminal and type (changing <pathToJava/home> to the location of your Java installation):

export JAVA_HOME=<pathToJava>
export PATH=$JAVA_HOME/bin:$PATH

You may find it helpful to add the above lines to your config file for easy access in future (optional). To do so, open the appropriate config file for your system:

Likely

nano ~/.bashrc

Then add the above two lines to the file, save it and relaunch the terminal.

Installation with Docker#

A Dockerfile is available in the root directory of the GitHub repository for building a Docker image of FlickerPrint. To build the image, open a terminal and navigate to the root directory of the repository. Then run the following command:

docker build -t flickerprint .

To run the image, use the following command:

docker run -it flickerprint