2dcomboselector 0.2.1b0
A Python tool for interactive 2D combination selection and analysis.
Requires Python: >=3.8


# 2DComboSelector




# 🛠️ Installation
Welcome! This guide will help you install, update, and launch **2dcomboselector**. No prior experience with Python or command line tools is required.

## **Option 1: Easiest – Use the All-in-One Installer (Recommended for New Users)**
We provide a Windows installer that bundles Python and all dependencies.  
**Download and run this file:**

> [Download 2dcomboselector Installer (Windows)](https://github.com/Chapel-Saint-Auret/2dcomboselector/releases/latest)

- Double-click the downloaded `.exe` file.
- Follow the on-screen instructions.

**After installation, you’ll find a shortcut to launch the tool on your Desktop or in the Start Menu.**

---

## **Option 2: Manual Installation via Python and pip**

> **You need Python 3.8 or newer.**  
> If you don’t have Python, [download it here](https://www.python.org/downloads/).
>
> Note: Make sure to select the option "Add python 3.X.X to PATH during python installation  
> <img src="https://github.com/user-attachments/assets/0e868fc8-2c0d-4a30-8b78-ac3479515fc2" width="25%">

### **Step 1: Make sure Python and pip are available**
- On Windows, open the Start menu, type **cmd** and run Command Prompt.
- Type `python --version` and `pip --version`
- If you see errors, Python may not be installed or not in your PATH.  
  [See this guide for help](https://realpython.com/add-python-to-path/).

### **Step 2: Install 2dcomboselector**
In your Command Prompt or PowerShell, run:
```sh
pip install 2dcomboselector
```
This will automatically install all required libraries.

If you see errors, try:
```sh
python -m pip install 2dcomboselector
```


# 🔄 Update

**To update to the newest version:**

- If you installed with the installer:  
  Download and run the latest installer from [the Releases page](https://github.com/Chapel-Saint-Auret/2dcomboselector/releases/latest).

- If you already have it installed with pip and want to upgrade to the latest version:
    ```sh
    pip install --upgrade 2dcomboselector
    ```
    Or, if pip isn’t in your PATH:
    ```sh
    python -m pip install --upgrade 2dcomboselector
    ```

---

# 🚀 How to Launch

## **If you used the installer:**
- Double-click the **2dcomboselector** icon on your Desktop or Start Menu.

## **If you installed with pip:**
- Open Command Prompt (or Terminal on Mac/Linux).
- Run:
    ```sh
    combo-selector
    ```
    If that doesn’t work, try:
    ```sh
    python -m combo-selector
    ```

# ℹ️ Troubleshooting & Help

- If you see “command not found” or “not recognized as an internal or external command,”  
  make sure Python and pip are installed and added to your system PATH.
- For additional help, see the [FAQ](https://github.com/Chapel-Saint-Auret/2dcomboselector/wiki/FAQ) or open an [issue](https://github.com/Chapel-Saint-Auret/2dcomboselector/issues).

---

Thank you for using **2dcomboselector**!  
Feel free to suggest improvements or ask questions on our [GitHub Discussions](https://github.com/Chapel-Saint-Auret/2dcomboselector/discussions).