fiftyone

用于构建高质量数据集和计算机视觉模型的开源工具

---

网站 • 文档 • 立即尝试 • 教程 • 示例 • 博客 • 社区

---

没有什么比质量差的数据更能阻碍机器学习系统的成功了。如果没有合适的工具，改进模型可能既耗时又低效。

FiftyOne 使您能够更快、更有效地可视化数据集并解释模型，从而增强您的机器学习工作流程。

使用 FiftyOne 亲身实践您的数据，包括可视化复杂标签、评估您的模型、探索感兴趣的场景、识别故障模式、查找注释错误等等！

您可以通过加入我们的 Slack 社区、阅读我们在 Medium 上的博客以及在社交媒体上关注我们来参与其中：

安装

您可以通过pip安装最新稳定版本的 FiftyOne：

pip install fiftyone

请参阅安装指南以了解故障排除以及有关启动和运行 FiftyOne 的其他信息。

快速入门

通过打开 Python shell 并运行下面的代码片段，直接深入了解 FiftyOne，该代码片段会下载一个小数据集并启动 FiftyOne 应用程序，以便您可以探索它：

 import fiftyone as fo
import fiftyone . zoo as foz

dataset = foz . load_zoo_dataset ( "quickstart" )
session = fo . launch_app ( dataset )

然后查看此 Colab 笔记本，了解快速入门数据集上的一些常见工作流程。

请注意，如果您在脚本中运行上述代码，则必须包含session.wait()以阻止执行，直到您关闭应用程序。请参阅此页面了解更多信息。

文档

FiftyOne 的完整文档可在 Fifthone.ai 上找到。特别是，请参阅以下资源：

• 教程
• 食谱
• 用户指南
• CLI 文档
• API参考

示例

查看五十一个示例存储库，了解使用 FiftyOne 的开源和社区贡献的示例。

为五十一做出贡献

FiftyOne 和 FiftyOne Brain 是开源的，欢迎社区贡献！

查看贡献指南以了解如何参与。

从源安装

以下说明适用于 macOS 和 Linux 系统。 Windows 用户可能需要进行调整。如果您在 Google Colab 工作，请跳至此处。

先决条件

您将需要：

• Python（3.9 - 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 or Linux
bash install.bash

# Windows
. i nstall.bat

注意：如果您在导入 FiftyOne 时遇到问题，您可能需要将克隆存储库的路径添加到PYTHONPATH中：

 export PYTHONPATH= $PYTHONPATH :/path/to/fiftyone

注意：安装脚本会添加到~/.bashrc或~/.bash_profile中的nvm设置，这是安装和构建应用程序所需的

注意：当您对应用程序进行新的更改时，您将需要重建它，您可以通过重新运行安装脚本或仅在./app目录中运行yarn build来完成。

升级您的源安装

要将现有源安装升级到最前沿，只需提取最新的develop分支并重新运行安装脚本：

git checkout develop
git pull
bash install.bash

开发者安装

如果您想为 FiftyOne 做出贡献，您应该使用安装脚本的-d标志执行开发人员安装：

 # Mac or Linux
bash install.bash -d

# Windows
. i nstall.bat -d

虽然不是必需的，但开发人员通常更喜欢将其 FiftyOne 安装配置为连接到自行安装和托管的 MongoDB 实例，您可以通过执行以下简单步骤来完成此操作。

源安装在 Google Colab 中

您可以通过在单元中运行以下命令，然后重新启动运行时，从 Google Colab 中的源代码进行安装：

%%shell

git clone --depth 1 https://github.com/voxel51/fiftyone.git
cd fiftyone

# Mac or Linux
bash install.bash

# Windows
. i nstall.bat

Docker 安装

请参阅这些说明，了解如何构建和运行包含 FiftyOne 源或发布版本的 Docker 映像。

生成文档

有关构建和贡献文档的信息，请参阅文档指南。

卸载

您可以按如下方式卸载 FiftyOne：

pip uninstall fiftyone fiftyone-brain fiftyone-db

贡献者

特别感谢这些了不起的人为 FiftyOne 做出的贡献！ ？

引文

如果您在研究中使用 FiftyOne，请随意引用该项目（但前提是您喜欢它？）：

 @article { moore2020fiftyone ,
  title = { FiftyOne } ,
  author = { Moore, B. E. and Corso, J. J. } ,
  journal = { GitHub. Note: https://github.com/voxel51/fiftyone } ,
  year = { 2020 }
}