Installation

ParticleTrieur

ParticleTrieur is distributed as a Java JAR file. It requires the installation of Java 8 to run.

  1. Install Amazon Corretto 8 or another Java 8 JRE / JDK

  2. Test the java installation by opening command prompt (Windows) or terminal (macOS) and running java -version. It should return something like:

C:\Users\rossm>java -version
openjdk version "1.8.0_212"
OpenJDK Runtime Environment Corretto-8.212.04.2 (build 1.8.0_212-b04)
OpenJDK 64-Bit Server VM Corretto-8.212.04.2 (build 25.212-b04, mixed mode)

  1. Download the latest release of ParticleTrier.jar from the github repostory releases page

  2. Save the JAR file in a convient location

To run ParticleTrieur:

  1. Open command prompt (Windows) or terminal (macOS / linux)

  2. Change directory to the one containing ParticleTrieur.jar

cd /PATH/TO/PARTICLETRIEUR

  1. Execute the jar file

java -jar ParticleTrieur.jar

Note

The latest version of ParticleTrieur may be called ParticleTrieur-dev.jar or similar. Update the instructions above accordingly.

MISO

The MISO library is required to perform CNN training using ParticleTrieur but can also be used stand alone.

  1. Install Anaconda from here. Use the default installation options, making sure that Install for: Just me is selected.

  2. Open the Anaconda command prompt (Windows) or terminal (MacOS / Linux).

  3. Create a new python environment called miso2:

conda create -n miso python=3.9

  1. Activate the miso environment:

conda activate miso

  1. Install Tensorflow v2.10.1

conda install -c conda-forge cudatoolkit=11.2 cudnn=8.1.0
pip install tensorflow==2.10.1

  1. Install the MISO library:

pip install miso

Setup is complete!

To update the MISO library in the future, perform steps 2, 4 and 6, or click the Update Library button in the Training dialog in ParticleTrieur