================================================================================
       QC-MLL EMERGENCY GUIDE / CHEAT SHEET FOR RESTRICTED LAB PCS
================================================================================

1. INSTALLATION (NO ADMIN / RESTRICTED LAB PC)
--------------------------------------------------------------------------------
Always use the --user flag if you do not have administrator permissions:

  pip install --user qc-mll

Offline installation using a wheel file on a USB / drive:
  pip install --user qc_mll-0.1.0-py3-none-any.whl

Force reinstall / upgrade:
  pip install --user --upgrade --force-reinstall qc-mll


2. EXECUTION COMMANDS (WHEN PATH IS BROKEN)
--------------------------------------------------------------------------------
In lab computers, Windows PATH often omits AppData\Roaming\Python\Python3X\Scripts.
If 'ml' says "command not found", use Python module execution directly:

Windows:
  python -m ml
  py -m ml
  python -m ml_helper
  py -m ml_helper

Linux / macOS:
  python3 -m ml
  python3 -m ml_helper
  python -m ml


3. PROGRAM NUMBER CHEAT SHEET
--------------------------------------------------------------------------------
Choice | Algorithm / Topic                     | Dataset Needed
-------+---------------------------------------+-----------------------------
  1    | Find-S & Candidate Elimination        | data.csv
  2    | CN2 & FOIL Rule Induction             | 2data.csv
  3    | Bagging & Gradient Boosting Ensemble  | 3data.csv
  4    | K-Means Clustering & Plotting         | 4data.csv
  5    | Self-Organizing Map (SOM / MiniSom)   | 5data.csv
  6    | Monte Carlo Numerical Integration     | (None / random)


4. ZERO-INSTALL EMERGENCY ONE-LINER
--------------------------------------------------------------------------------
If pip or network is completely disabled, extract the .whl or .tar.gz (wheels are
standard ZIP archives, you can rename .whl to .zip and unzip it).
Navigate into the unzipped folder and run:

  python -m ml

Or single command execution without prompting:
  python -c "import ml_helper.cli; import sys; sys.argv=['ml', '1']; ml_helper.cli.main()"


5. CLIPBOARD BEHAVIOR
--------------------------------------------------------------------------------
- Windows: Automatically uses 'clip' (instantly available to Ctrl+V into IDE).
- Linux: Uses 'xclip', 'xsel', or 'wl-copy' if installed; otherwise silently
  continues and prints code directly to terminal.
- macOS: Uses 'pbcopy'.
- To paste in terminal: Right Click or Shift+Insert.
- To paste in editor/IDE: Ctrl+V (or Cmd+V on Mac).

================================================================================
