🖥️Installing GWAStic

Installation with Anaconda and PyPI

Using Miniforge or Anaconda for installing Python and our software is optional but recommended for a more streamlined setup process; however, if you already have Python installed and prefer to skip this step, you can jump directly to the pip install step of our software.

If you encounter any installation problems, please an open issue on our GitHub repository. Providing details about the issue will help us assist you more effectively:

https://github.com/snowformatics/gwastic_desktop/issues

Windows

Note: Due to Anaconda's licensing limitations (maximum of 200 users per organization), we recommend considering an alternative, Miniforge, especially for larger teams.

Option 1: Download Miniforge 3 for Windows operating system:

https://conda-forge.org/miniforge/

Option 2: Download and install Anaconda from the official website:

https://www.anaconda.com/download/success

1. Open the Miniconda / Anaconda prompt, type prompt in the Windows search field.

2. Create a new environment (optional but recommended) by typing:

conda create --name gwastic_env python=3.9

1. Activate the environment by typing:

conda activate gwastic_env

1. Install GWASTic package by typing:

pip install gwastic_desktop

1. Start GWASTic by typing:

gwastic

Linux

1. Install Anaconda:

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
chmod +x Miniconda3-latest-Linux-x86_64.sh
./Miniconda3-latest-Linux-x86_64.sh
cd /home/username/miniconda3
source ~/miniconda3/bin/activate

1. Create a new environment (optional but recommended) and activate it:

conda create --name gwastic_env python=3.9
conda activate gwastic_env

1. Use the following command to install a package using pip:

pip install gwastic_desktop

1. Type the following command to start the software:

gwastic

MacOS

Important note:

We've received feedback from Mac users experiencing installation issues, and we've identified a problem specific to macOS involving a missing library necessary for parallel processing. We strongly recommend installing this dependency via Homebrew before proceeding with the installation of the GWASTic software:

brew install libomp

1. Download and install Anaconda from the official website:

Download Now | AnacondaAnaconda

Anaconda download link

1. Open the downloaded .pkg file to launch the installer and follow the on-screen instructions.

2. Open the terminal (press cmd + space to open search and type "terminal")

3. Create a new environment by typing in the terminal:

conda create --name gwastic_env python=3.9

1. Activate the environment by typing in the terminal:

conda activate gwastic_env

1. Install GWASTic package by typing in the terminal:

pip install gwastic_desktop

1. Start GWASTic by typing in the terminal:

gwastic

Troubleshooting

Error: xgboost.core.XGBoostError: XGBoost Library (libxgboost.dylib) could not be loaded

run: conda install -c conda-forge py-xgboost -y

Error: The program crash with bus error or segmentation fault error

run: conda install matplotlib

Note:

We strongly recommend installing this dependency via Homebrew before proceeding with the installation of the GWASTic software, which should solve the above problems:

brew install libomp

Updating to the latest version (optional):

pip install --upgrade