Kill3rbee / orange3

🍊 :bar_chart: :bulb: Orange: Interactive data analysis https://orange.biolab.si

Orange

Orange is a component-based data mining software. It includes a range of data visualization, exploration, preprocessing and modeling techniques. It can be used through a nice and intuitive user interface or, for more advanced users, as a module for the Python programming language.

This is a development version of Orange 3. The stable version 2.7 is still available (binaries and sources).

Installing

Orange requires Python 3.6 or newer.

First, install Anaconda for your OS. Create virtual environment for Orange:

conda create python=3 --name orange3

In your Anaconda Prompt add conda-forge to your channels:

conda config --add channels conda-forge

This will enable access to the latest Orange release. Then install Orange3:

conda install orange3

Installing with pip

To install Orange with pip, run the following.

# Install some build requirements via your system's package manager
sudo apt install virtualenv git build-essential python3-dev

# Create a separate Python environment for Orange and its dependencies ...
virtualenv --python=python3 --system-site-packages orange3venv
# ... and make it the active one
source orange3venv/bin/activate

# Clone the repository and move into it
git clone https://github.com/biolab/orange3.git
cd orange3

# Install Qt dependencies for the GUI
pip install PyQt5

# Install other minimum required dependencies
pip install -r requirements-core.txt  # For Orange Python library
pip install -r requirements-gui.txt   # For Orange GUI

pip install -r requirements-sql.txt   # To use SQL support
pip install -r requirements-opt.txt   # Optional dependencies, may fail

# Finally install Orange in editable/development mode.
pip install -e .

Installation of SciPy and qt-graph-helpers is sometimes challenging because of their non-python dependencies that have to be installed manually. More detailed, if mostly obsolete, guides for some platforms can be found in the wiki.

Missing WebKit/WebEngine

Some distributions of PyQt5 come without WebKit or WebEngine, required by some add-ons and for reporting. Running pip install PyQtWebEngine may solve this issue.

Starting Orange GUI

To start Orange GUI from the command line, run:

orange-canvas
# or
python3 -m Orange.canvas

Append --help for a list of program options.

Compiling on Windows

Get appropriate wheels for missing libraries. You will need numpy+mkl and scipy.

Install them with

pip install some-wheel.whl

Install Visual Studio compiler. Then go to Orange3 folder and run:

python setup.py build_ext -i --compiler=msvc install