Installation

Overall

PanGraphViewer is written in python3 and can run on Windows, macOS and Linux systems.

• We have fully tested the program in Windows 10, Ubuntu 18.04, Ubuntu 20.04, macOS Big Sur and macOS Monterey.

• For other equivalent systems, PanGraphViewer may work, but for older versions, there might be some problems in installing some python3 libraries, for instance the PyQtWebEngine library.

• There are two PanGraphViewer versions: Desktop-based version and Web browser-based version.

• To make it easy to run PanGraphViewer, we strongly encourage users to use miniconda3 or micromamba to install all dependencies.

• The minimum python3 recommended is python3.6.

Miniconda3

Depending on the system, users can download miniconda3 or micromamba

To make it easy, we recommond installing pkg version on macOS and exe on Windows.

After the installation of miniconda3, users may follow the steps below to install PanGraphViewer

Preparation for insallation

1. Open powershell or terminal

   On Windows

   Users need to find or search Anaconda Powershell Prompt (miniconda3) and then open it.

   On Linux/macOS

   Users need to find or search Terminal and then open it.

2. Update conda if there are errors in creating the following virtual environments

   conda update -n base conda
   

Desktop-based version

1. Create virtual environment pangraphviewer_app

   cd panGraphViewerApp
   conda env create -y -f pangraphviewer_app.yml
   

2. Activate virtual environment pangraphviewer_app

   conda activate pangraphviewer_app
   

Web browser-based version

1. Create virtual environment pangraphviewer_web

   cd panGraphViewerWeb
   conda env create -y -f pangraphviewer_web.yml
   

2. Activate virtual environment pangraphviewer_web

   conda activate pangraphviewer_web