Label Studio中如何正确导入本地图像及预标注数据

Label Studio作为一款强大的数据标注工具，支持导入本地存储的图像文件及预标注数据。本文将详细介绍如何正确配置和使用这一功能，帮助用户避免常见问题。

本地图像导入的正确方式

Label Studio不支持直接使用文件系统的绝对路径引用图像文件。正确的做法是通过配置本地文件服务来实现：

1. 环境变量配置 需要设置两个关键环境变量：

   • LABEL_STUDIO_LOCAL_FILES_SERVING_ENABLED=true：启用本地文件服务
   • LABEL_STUDIO_LOCAL_FILES_DOCUMENT_ROOT=/your/image/path：指定图像存储的根目录

2. JSON文件中的路径引用 在任务JSON文件中，图像路径应采用特殊URL格式：

   {
     "data": {
       "image": "/data/local-files/?d=relative/path/to/image.jpg"
     }
   }
   

   其中relative/path/to/image.jpg是相对于DOCUMENT_ROOT的相对路径。

预标注数据的注意事项

当导入包含预标注的矩形框数据时，需确保以下几点：

1. 标注配置一致性 项目配置中的XML标签定义必须与JSON中的字段匹配：

   <RectangleLabels name="label" toName="image">
     <Label value="Person" background="green"/>
   </RectangleLabels>
   

2. 字段对应关系 JSON中的from_name和to_name必须与XML配置中的name和toName完全一致，包括大小写。

3. 标签值匹配 rectanglelabels数组中的字符串必须与XML中定义的Label value完全匹配。

实用技巧

1. 先上传后引用 通过Label Studio的本地存储功能先上传图像，再在JSON中引用这些图像，可以避免路径问题。

2. 环境验证 启动Label Studio后，访问/data/local-files/端点验证服务是否正常。

3. 权限检查 确保Label Studio进程有权限访问DOCUMENT_ROOT指定的目录。

通过遵循以上指南，用户可以顺利地在Label Studio中导入本地图像和预标注数据，提高标注工作效率。