Naturtag

内容

• 摘要
• 用例
• 安装
• 使用
  • 图形用户界面
  • 命令行界面
  • 库
• 开发状态

摘要

Naturtag是一个用于自然摄影师的工具，可以为您的照片添加描述生物的有用元数据。它包括一个桌面应用程序、一个命令行界面，并且也可以作为一个Python库使用。

它主要适用于与iNaturalist一起使用；它可以为您的照片添加完整的观察元数据，或者仅仅是分类元数据。

用例

Naturtag使用XMP和EXIF元数据将此信息嵌入到您的本地照片收藏中。这有多种用途，包括

本地照片组织

Naturtag可以使用支持一些照片查看器/编辑器（如Lightroom、FastPictureViewer、Photo Mechanic和XnViewMP）的层次结构关键词（也称为结构化关键词）对您的照片进行标记。

这实际上为您提供了一个浏览和过滤照片的谱系树。

照片托管

Naturtag还可以简化在Flickr等照片托管网站上标记照片的过程。为此用例，此工具生成与iNaturalist的Flickr标记器相同格式的半结构化关键词。

使用以下标签进行示例搜索： https://www.flickr.com/photos/tags/taxonomy:class=arachnida

其他生物多样性工具

最后，naturtag可以改善与其他工具和系统的互操作性，这些工具和系统与生物多样性数据交互。例如，除了iNaturalist之外，您还可以将一些观察结果提交到具有更具体关注的另一个平台，例如 eBird、虫子指南 或 蘑菇观察员。对于这种情况，此工具支持 简单达尔文核心。

安装

有关下载和平台特定说明，请参阅 GitHub 发布 和 安装。

要仅安装naturtag作为Python包，请运行

pip install naturtag

使用

图形用户界面

此项目的主要界面仍在开发中。

它包括选择和标记图像的界面

以及用于标记图像的搜索和浏览物种的工具

有关更多信息，请参阅 应用程序指南。

命令行界面

Naturtag还包括一个命令行界面。它接受观察结果或物种，以及一些图像文件，并生成EXIF和XMP元数据以写入这些图像。您可以在以下链接中查看其实际操作：

有关更多信息，请参阅 CLI 文档。

库

您还可以将 naturtag 作为Python库导入，并在您自己的脚本或应用程序中使用其主要功能。基本示例

from naturtag import tag_images, refresh_tags

# Tag images with full observation metadata
tag_images(['img1.jpg', 'img2.jpg'], observation_id=1234)

# Refresh previously tagged images with latest observation and taxonomy metadata
refresh_tags(['~/observations/'], recursive=True)

有关更多信息，请参阅 API 参考。

开发状态

• 有关计划功能和当前进度，请参阅 问题。
• 如果您有任何建议、问题或请求，请 创建问题，或在 iNaturalist 社区论坛 上 ping 我（@jcook）。
• 在我不从事这项工作的时候，我通常在开发其他库，这些库可以受益于naturtag，包括 requests-cache、pyinaturalist 和 pyinaturalist-convert。