Orange Data Mining
Orange is a data mining and visualization toolbox for novice and expert alike. To explore data with Orange, one requires no programming or in-depth mathematical knowledge. We believe that workflow-based data science tools democratize data science by hiding complex underlying mechanics and exposing intuitive concepts. Anyone who owns data, or is motivated to peek into data, should have the means to do so.
Installing
Easy installation
For easy installation, Options -> Add-ons... in the menu bar.
Installing with Conda
First, install Miniconda for your OS.
Then, create a new conda environment, and install orange3:
# Add conda-forge to your channels for access to the latest release
conda config --add channels conda-forge
# Create and activate an environment for Orange
conda create python=3 --yes --name orange3
conda activate orange3
# Install Orange
conda install orange3
For installation of an add-on, use:
conda install orange3-<addon name>
See specific add-on repositories for details.
Running
Activate the environment,
conda activate orange3
and run either orange-canvas or python3 -m Orange.canvas.
Add --help for a list of program options.
Starting up for the first time may take a while.
Installing with pip
To install Orange with pip, run the following.
# Install build requirements via your system's package manager
sudo apt install virtualenv build-essential python3-dev
# Create an environment for Orange and its dependencies
virtualenv --python=python3 --system-site-packages orange3venv
# Activate the environment
source orange3venv/bin/activate
# Install Orange
pip install orange3
Running
Activate the environment by source orange3venv/bin/activate. Then run orange-canvas or python3 -m Orange.canvas. Add --help for a list of program options.
Starting up for the first time may take a while.
Installing with winget (Windows only)
To install Orange with winget, run:
winget install --id UniversityofLjubljana.Orange
Developing
Want to write a widget? Use the Orange3 example add-on template.
Want to get involved? Join us on
Take a look at our contributing guide and style guidelines.
Check out our widget development for a comprehensive guide on writing Orange widgets.
The Orange ecosystem
The development of core Orange is primarily split into three repositories:
biolab/orange-canvas-core implements the canvas,
biolab/orange-widget-base is a handy widget GUI library,
biolab/orange3 brings it all together and implements the base data mining toolbox.
Additionally, add-ons implement additional widgets for more specific use cases. Anyone can write an add-on. Some of our first-party add-ons:
- biolab/orange3-text
- biolab/orange3-bioinformatics
- biolab/orange3-timeseries
- biolab/orange3-single-cell
- biolab/orange3-imageanalytics
- biolab/orange3-educational
- biolab/orange3-geo
- biolab/orange3-associate
- biolab/orange3-network
- biolab/orange3-explain
Setting up for core Orange development
First, fork the repository by pressing the fork button in the top-right corner of this page.
Set your GitHub username,
export MY_GITHUB_USERNAME=replaceme
create a conda environment, clone your fork, and install it:
conda create python=3 --yes --name orange3
conda activate orange3
git clone ssh://[email protected]/$MY_GITHUB_USERNAME/orange3
pip install -e orange3
Now you're ready to work with git. See GitHub's guides on pull requests, forks if you're unfamiliar. If you're having trouble, get in touch on
Running
Run Orange with python -m Orange.canvas (after activating the conda environment).
python -m Orange.canvas -l 2 --no-splash --no-welcome will skip the splash screen and welcome window, and output more debug info. Use -l 4 for more.
Add --clear-widget-settings to clear the widget settings before start.
To explore the dark side of the Orange, try --style=fusion:breeze-dark
Argument --help lists all available options.
To run tests, use unittest Orange.tests Orange.widgets.tests
Setting up for development of all components
Should you wish to contribute Orange's base components (the widget base and the canvas), you must also clone these two repositories from Github instead of installing them as dependencies of Orange3.
First, fork all the repositories to which you want to contribute.
Set your GitHub username,
export MY_GITHUB_USERNAME=replaceme
create a conda environment, clone your forks, and install them:
conda create python=3 --yes --name orange3
conda activate orange3
git clone ssh://[email protected]/$MY_GITHUB_USERNAME/orange-widget-base
pip install -e orange-widget-base
git clone ssh://[email protected]/$MY_GITHUB_USERNAME/orange-canvas-core
pip install -e orange-canvas-core
git clone ssh://[email protected]/$MY_GITHUB_USERNAME/orange3
pip install -e orange3
# Repeat for any add-on repositories
It's crucial to install orange-base-widget and orange-canvas-core before orange3 to ensure that orange3 will use your local versions.
![[WIP] Selection of a single sheet from Excel](https://avatars.githubusercontent.com/u/16189966?v=4)
![[Feature/Documentation Request]: Workflow -> Python Script option?](https://avatars.githubusercontent.com/u/12863059?v=4)
![[ENH] New widget: Group By](https://avatars.githubusercontent.com/u/6421558?v=4)
9 Aug 16, 2022
1k Jan 08, 2023
851 Dec 27, 2022
6.3k Jan 03, 2023
443 Jan 01, 2023
32 Dec 14, 2022
1 Jan 03, 2022
36.9k Dec 28, 2022
48.9k Jan 03, 2023
180 Dec 28, 2022
186 Dec 23, 2022
3.2k Jan 08, 2023
3.1k Dec 31, 2022
349 Dec 25, 2022
147 Dec 14, 2022
37 Dec 21, 2022
1.3k Dec 31, 2022
915 Dec 29, 2022
1.8k Dec 31, 2022