Inferno-App

This repository contains a PySide6 application that integrates Python and R functionality using the Inferno R package. Below you will find a detailed step-by-step guide to get the app running locally on your machine. Instructions are provided for Windows, macOS, and Linux.

---

Table of Contents

1. Prerequisites
   • Install Python 3.12
   • Install R and Inferno Package
2. Set R_HOME Environment Variable (if required)
3. Clone the Repository
4. Create a Python Virtual Environment
5. Install Python Dependencies
6. Run the App
7. Troubleshooting

---

1. Prerequisites

Install Python 3.12

Windows

1. Download the installer from python.org.
2. Run the installer, check “Add Python to PATH,” and follow the steps.
3. Verify the installation by opening Command Prompt and running:

   python --version

macOS

1. Download the macOS installer from python.org.
2. Run the installer and follow the steps.
3. Verify:

   python3 --version

Linux

1. Use your distribution's package manager or download the source from python.org. For Ubuntu/Debian, you may need to add a PPA or download a .tar.xz source package if Python 3.12 is not in the official repositories yet.
2. Example (Ubuntu):

   sudo apt update
   sudo apt install python3.12 python3.12-venv python3.12-dev

3. Verify:

   python3.12 --version

---

Install R and Inferno Package

You need to install R and then install the Inferno package from GitHub.

1. Download and install R:

   • Windows
   • macOS
   • Linux

2. Install the remotes package within R, then use remotes to install Inferno:

   1. Launch R (e.g., open R.exe on Windows, or run R in a terminal).
   2. Run the following lines:

      install.packages("remotes")
      remotes::install_github("pglpm/inferno")

   3. Close R after the installation completes.

---

2. Set R_HOME Environment Variable (if required)

On some systems (especially on Windows), you may need to explicitly set the R_HOME environment variable to point to your R installation path.

• Windows:

  1. Open Control Panel → System and Security → System → Advanced system settings.
  2. Click Environment Variables.
  3. Under System variables, click New (or Edit if R_HOME exists).
  4. Variable name: R_HOME
  5. Variable value: Path to your R installation (e.g., C:\Program Files\R\R-4.4.2).
  6. Click OK to save.

• macOS/Linux:

  export R_HOME="/usr/local/lib/R"

  Adjust the path to match your R installation.

---

3. Clone the Repository

Clone this repository using Git (or simply download the ZIP):

git clone https://github.com/h587916/Inferno-App.git
cd Inferno-App

---

4. Create a Python Virtual Environment

Windows

python -m venv venv
venv\Scripts\activate

macOS/Linux

python3 -m venv venv
source venv/bin/activate

Note: Depending on your system, you may need to use python3.12 instead of python3.

---

5. Install Python Dependencies

Install all required Python dependencies using the requirements.txt file:

pip install -r requirements.txt

---

6. Run the App

Finally, start the application:

python main.py

The PySide6 app should now launch and be ready for use!

---

7. Troubleshooting

R not found

• Ensure R_HOME is set properly on Windows or that your R binary is discoverable on macOS/Linux.

Package installation issues

• Ensure you have the latest versions of pip and setuptools:

pip install --upgrade pip setuptools

Permission errors

• Try running terminal or command prompt as administrator (Windows) or use sudo on Linux/macOS (though generally recommended only if absolutely necessary).

Rtools Not Found on Windows

If you encounter errors like:

task 1 failed - "Failed to create the shared library. Run 'printErrors()' to see the compilation errors."

or

Sys.which("g++")
[1] ""

it means R cannot find the g++ compiler from Rtools. Follow these steps to fix it:

1. Verify Rtools Installation

Make sure Rtools 4.4 is installed. Download and install it from: 👉 Rtools 4.4 for Windows

2. Add Rtools to PATH Manually

1. Open Windows Search → Search for "Environment Variables".
2. Click "Edit the system environment variables".
3. In System variables, find Path → Click Edit.
4. Click New and add:

   C:\rtools44\usr\bin
   C:\rtools44\x86_64-w64-mingw32.static.posix\bin
   

5. Click OK → Restart your computer.

3. Check if Windows Recognizes g++

1. Open Command Prompt (Win + R, type cmd, press Enter).
2. Run:

   where g++

   If successful, it should return:

   C:\rtools44\x86_64-w64-mingw32.static.posix\bin\g++.exe
   

4. Verify g++ in R

Open R and run:

Sys.which("g++")

If this returns a valid path, Rtools is now set up correctly!

---