没有什么比低质量数据更能阻碍机器学习系统的成功。而且如果没有合适的工具,改进模型可能既耗时又低效。
FiftyOne 通过让您更快、更有效地可视化数据集和解释模型,加速您的机器学习工作流程。
使用 FiftyOne 可以实际操作您的数据,包括可视化复杂标签、评估模型、探索感兴趣的场景、识别故障模式、发现标注错误等等!
您可以通过加入我们的 Slack 社区、阅读我们在 Medium 上的博客以及关注我们的社交媒体来参与其中:
安装
您可以通过 pip
安装最新版的 FiftyOne:
pip install fiftyone
查阅 安装指南 以获取故障排除和其他有关启动和运行 FiftyOne 的信息。
快速入门
通过打开 Python Shell 并运行下面的代码片段,立即开始使用 FiftyOne,它会下载一个 小数据集 并启动 FiftyOne App, 以便您进行探索:
import fiftyone as fo
import fiftyone.zoo as foz
dataset = foz.load_zoo_dataset("quickstart")
session = fo.launch_app(dataset)
然后查看这个 Colab 笔记本以了解在快速入门数据集上的一些常见工作流程。
请注意,如果您在脚本中运行上述代码,则必须包括session.wait()
以阻止执行,直到您关闭应用程序。有关更多信息,请参见此页面。
文档
FiftyOne 的完整文档可在fiftyone.ai上找到。特别是,您可以参考以下资源:
示例
请查看fiftyone-examples仓库,以获取使用 FiftyOne 的开源和社区贡献示例。
贡献 FiftyOne
FiftyOne 是开源的,欢迎社区贡献!
查看贡献指南以了解如何参与。
从源代码安装
以下说明适用于 macOS 和 Linux 系统。Windows 用户可能需要进行调整。如果您在 Google Colab 中工作,请跳到此处。
先决条件
您将需要:
- Python (3.8 - 3.11)
- Node.js - 在 Linux 上,我们推荐使用nvm来安装最新版本。
- Yarn - 一旦安装了 Node.js,您可以通过
corepack enable
启用 Yarn。 - 在 Linux 上,您至少需要
openssl
和libcurl
包。在基于 Debian 的发行版上,您可能需要安装libcurl4
或libcurl3
而不是libcurl
,这取决于您的发行版的年龄。例如:
# Ubuntu
sudo apt install libcurl4 openssl
# Fedora
sudo dnf install libcurl openssl
安装
我们强烈建议您在虚拟环境中安装 FiftyOne,以保持工作空间的整洁。
首先,克隆仓库:
git clone https://github.com/voxel51/fiftyone
cd fiftyone
然后运行安装脚本:
# Mac 或 Linux
bash install.bash
# Windows
.\install.bat
注意: 如果在导入 FiftyOne 时遇到问题,您可能需要将克隆仓库的路径添加到您的 PYTHONPATH
:
export PYTHONPATH=$PYTHONPATH:/path/to/fiftyone
注意: 安装脚本会将 nvm
设置添加到您的 ~/.bashrc
或 ~/.bash_profile
中,这是安装和构建应用程序所必需的。
注意: 当您拉取应用程序的新更改时,您需要重新构建它,您可以通过重新运行安装脚本或只是在 ./app
目录中运行 yarn build
来完成此操作。
升级源代码安装
要将现有的源代码安装升级到最新版本,只需拉取最新的 develop
分支并重新运行安装脚本:
git checkout develop
git pull
bash install.bash
开发者安装
如果您想为 FiftyOne 贡献代码,您应该使用安装脚本的 -d
标志执行开发者安装:
# Mac 或 Linux
bash install.bash -d
# Windows
.\install.bat -d
虽然不是必需的,但开发人员通常更喜欢将他们的 FiftyOne 安装配置为连接到自安装和管理的 MongoDB 实例,您可以通过遵循这些简单步骤来实现这一点。
在 Google Colab 中从源代码安装
您可以通过在Google Colab中运行以下命令来从源代码安装,然后重新启动运行时:
%%shell
git clone --depth 1 https://github.com/voxel51/fiftyone.git
cd fiftyone
# Mac 或 Linux
bash install.bash
# Windows
.\install.bat
Docker 安装
请参阅这些说明以了解如何构建和运行包含 FiftyOne 源代码或发布版本的 Docker 镜像。
在 Storybook 上进行 UI 开发
Voxel51 目前正在实施一个Storybook,其中包含其基本 UI 组件的示例。您可以通过在 /app/packages/components 中运行 yarn storybook 来访问当前的 Storybook 实例。当 Storybook 实例正在运行时,对组件的任何更改都会触发 Storybook 应用程序的刷新。
%%shell
cd /app/packages/components
yarn storybook
生成文档
有关构建和贡献文档的信息,请参阅文档指南。
卸载
您可以通过以下方式卸载 FiftyOne:
pip uninstall fiftyone fiftyone-brain fiftyone-db fiftyone-desktop
贡献者
特别感谢这些出色的人们为 FiftyOne 做出的贡献!🙌
引用
如果您在研究中使用 FiftyOne,请随意引用该项目(但前提是您真的喜欢它 😊):
@article{moore2020fiftyone,
title={FiftyOne},
author={Moore, B. E. and Corso, J. J.},
journal={GitHub. Note: https://github.com/voxel51/fiftyone},
year={2020}
}