Orange 是一个适合新手和专家的数据挖掘和可视化工具箱。要使用 Orange 探索数据,不需要编程或深入的数学知识。我们相信基于工作流的数据科学工具通过隐藏复杂的底层机制和暴露直观的概念来实现数据科学的民主化。任何拥有数据或有动力研究数据的人都应该有办法这样做。
为了方便安装,请从我们的网站下载最新发布的 Orange 版本。要安装附加组件,请前往菜单栏中的Options -> Add-ons...
。
首先,为您的操作系统安装 Miniconda。
然后,创建一个新的conda环境,并安装orange3:
# Add conda-forge to your channels for access to the latest release
conda config --add channels conda-forge
# Perhaps enforce strict conda-forge priority
conda config --set channel_priority strict
# Create and activate an environment for Orange
conda create python=3.10 --yes --name orange3
conda activate orange3
# Install Orange
conda install orange3
要安装附加组件,请使用:
conda install orange3- < addon name >
有关详细信息,请参阅特定的附加存储库。
我们建议使用我们的独立安装程序或 conda,但 Orange 也可以通过 pip 安装。您将需要一个 C/C++ 编译器(在 Windows 上,我们建议使用 Microsoft Visual Studio 构建工具)。 Orange 需要 PyQt 才能运行。安装:
pip install -r requirements-pyqt.txt
pip install PyQt6 PyQt6-WebEngine
要使用 winget 安装 Orange,请运行:
winget install --id UniversityofLjubljana.Orange
确保您已激活正确的虚拟环境。如果遵循上述 conda 说明:
conda activate orange3
运行orange-canvas
或python3 -m Orange.canvas
。添加--help
以获取程序选项列表。
第一次启动可能需要一段时间。
想写一个小部件吗?使用 Orange3 示例附加模板。
想参与吗?加入我们的 Discord,在 #general 中介绍自己!
请查看我们的贡献指南和风格指南。
查看我们的小部件开发文档,获取有关编写 Orange 小部件的综合指南。
核心 Orange 的开发主要分为三个存储库:
biolab/orange-canvas-core 实现了画布,
biolab/orange-widget-base 是一个方便的小部件 GUI 库,
biolab/orange3 将所有这些整合在一起并实现了基础数据挖掘工具箱。
此外,附加组件还为更具体的用例实现了额外的小部件。任何人都可以编写附加组件。我们的一些第一方附加组件:
首先,按此页面右上角的 fork 按钮来 fork 存储库。
设置您的 GitHub 用户名,
export MY_GITHUB_USERNAME=replaceme
创建一个 conda 环境,克隆你的 fork,并安装它:
conda create python=3.10 --yes --name orange3
conda activate orange3
git clone ssh://[email protected]/ $MY_GITHUB_USERNAME /orange3
# Install PyQT and PyQtWebEngine. You can also use PyQt6
pip install -r requirements-pyqt.txt
pip install -e orange3
现在您已准备好使用 git。如果您不熟悉,请参阅 GitHub 有关拉取请求和分叉的指南。如果您遇到问题,请联系 Discord。
使用python -m Orange.canvas
运行 Orange(激活 conda 环境后)。
python -m Orange.canvas -l 2 --no-splash --no-welcome
将跳过启动屏幕和欢迎窗口,并输出更多调试信息。使用-l 4
了解更多。
添加--clear-widget-settings
以在启动前清除小部件设置。
要探索 Orange 的黑暗面,请尝试--style=fusion:breeze-dark
参数--help
列出所有可用选项。
要运行测试,请使用unittest Orange.tests Orange.widgets.tests
如果您希望贡献 Orange 的基础组件(小部件基础和画布),您还必须从 Github 克隆这两个存储库,而不是将它们安装为 Orange3 的依赖项。
首先,分叉您想要贡献的所有存储库。
设置您的 GitHub 用户名,
export MY_GITHUB_USERNAME=replaceme
创建一个 conda 环境,克隆您的分支并安装它们:
conda create python=3.10 --yes --name orange3
conda activate orange3
# Install PyQT and PyQtWebEngine. You can also use PyQt6
pip install -r requirements-pyqt.txt
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
在orange3
之前安装orange-base-widget
和orange-canvas-core
是至关重要的,以确保orange3
将使用您的本地版本。