如何在arc-art中快速定位作品:index.csv与metadata.csv元数据字段完全指南

原创2026-11-11 10:31:521,419 阅读
文章标签:数据集3D建模图形学媒体生成

如何在arc-art中快速定位作品:index.csv与metadata.csv元数据字段完全指南

arc-art 是一个收录了艺术家 ARC 于 2019–2024 年创作的 154 件 Blender 3D 艺术作品(含工程文件、渲染视频与封面图)的开源数据集。当你想快速定位某件作品时,不必逐个翻文件夹——仓库提供了两张元数据表:blend/index.csv(Blender 工程索引)和 videos/metadata.csv(视频索引)。本指南将逐一解读全部字段,并示范如何用它们快速查找作品。

先认清 arc-art 的目录结构

arc-art 仓库由四个顶层目录组成,理解它们是读懂元数据的前提:

目录 内容 说明
videos/ 152 个作品视频 每件的"最终样子",含原始渲染或发布版
blend/ 119 个 Blender 工程 每个编号一个文件夹,内含 .blend、files/ 与 README.txt
thumbnails/ 每个工程一张静态封面图 页面预览用
viewer/ 页面展示用的 parquet 表 videos.parquet 与 blend_files.parquet

每件作品都有一个全局编号 arc-001 到 arc-154(按首次发布顺序编号)。视频与工程共用编号:videos/arc-001.mp4 对应 blend/arc-001/arc-001.blend。这个编号就是两张 CSV 表之间唯一的"外键"。

blend/index.csv 元数据字段逐项解读

blend/index.csv 共 15 列,按最新作品倒序排列,每行对应一个 Blender 工程:

字段 含义 示例值
id 作品编号(主键) arc-153
title 作品标题;无标题时填 Untitled Weight Waves
caption 发布时附带的文字说明 would you have this on your desk
first_posted 首次发布日期 2024-04-21
year 年份(便于按年筛选) 2024
blend 工程文件相对路径 blend/arc-153/arc-153.blend
video 对应视频相对路径 videos/arc-153.mp4
blender_made 创作时使用的 Blender 版本号 4.0
width / height 渲染分辨率(像素) 1080 / 1080
fps 帧率 24.0
frame_start / frame_end 动画首末帧 120 / 479
size_mb 视频大小(MB) 43.5
notes 渲染前需要知道的事项 如刚体模拟需从首帧播放
posted_at 原始发布页链接 —

一个典型的行数据长这样(取自 arc-143):

arc-143,Weight Waves,,2023-02-20,2023,blend/arc-143/arc-143.blend,videos/arc-143.mp4,3.4,2160,2160,50.0,120,239,0.6,,https://arc.art/work/weight-waves/

⚠️ 重点提示 notes 字段:部分工程含"实时模拟"(刚体碰撞在回放时才计算),渲染前必须从第一帧播放时间线或先烘焙,否则主体可能渲染为空。该字段就是为这类情况准备的。

videos/metadata.csv 元数据字段逐项解读

videos/metadata.csv 共 13 列,覆盖全部 152 个视频(比 blend/index.csv 多出 33 条,因为 35 件作品没有 Blender 工程,另有 2 件工程因模拟缓存丢失被剔除,只保留了视频):

字段 含义 示例值
file_name 视频文件名(主键,注意不是 arc-NNN) arc-154.mp4
title / caption 同 index.csv —
with 合作者署名,仅 4 件合作作品有值 TatsuyaBot
first_posted / year 发布日期与年份 2024-08-30
width / height / fps 视频规格 1080 / 1080 / 50.0
seconds 视频时长(秒) 14.4
copy 视频来源版本 original render 或 posted (twitter) 等
blend 对应工程路径;留空表示该作品无工程 blend/arc-153/arc-153.blend
posted_at 原始发布页链接 —

其中 copy 字段最值得留意:original render 表示保留了原始渲染输出(共 122 件),其余则是发布渠道的版本,如 posted (twitter)、posted (sothebys)(苏富比拍卖发布版)、posted (arc.art)(官网发布版)。想学渲染时,优先挑 original render。

实操:三个常见定位场景

以下示例用 Excel、Numbers 或 VS Code 打开 blend/index.csv 或 videos/metadata.csv 即可完成,无需写代码。

场景一:找某一年的所有作品 对 year 列排序或筛选。例如 2024 年有 arc-150 至 arc-154 等数件作品,一眼就能圈出当年产出。

场景二:找带工程、可直接打开学习的文件 在 blend 列非空的行里,直接复制单元格中的相对路径即可定位文件,比如 blend/arc-146/arc-146.blend(标题为 "Perfect loop (manually)")。注意官方建议用 Blender 4.3 或更新版本打开,早期作品(2019–2021)创作于 2.8–2.9,可能打不开或渲染有差异。

场景三:找合作作品 只有 videos/metadata.csv 的 with 列记录了合作者,筛选非空值即可找出全部 4 件合作作品(如与 TatsuyaBot、RAC 的合作)。版权上这些合作部分的署名权归合作者所有,引用时需注意。

两张表的对应关系与配套文件

  • 编号对应:videos/metadata.csv 的 blend 列与 blend/index.csv 的 video 列互为镜像,用 arc-NNN 编号即可在两张表之间交叉定位。
  • 逐件说明书:每个工程目录下的 blend/arc-001/README.txt 这类 README.txt,记录了标题、发布日期、Blender 版本、分辨率、帧范围及本次发布做的改动,是比 CSV 更详细的补充。
  • 页面数据源:viewer/blend_files.parquet 与 viewer/videos.parquet 是由两张 CSV 生成的表格式数据(最新在前,带封面图),供数据集页面展示使用,用 pandas 等工具可直接读取。
  • 许可提醒:全部素材为 CC BY-NC 4.0,仅限非商业使用,商用需联系作者授权。

小结:快速定位作品的最短路径

  1. 想按标题、日期、规格筛选 → 打开 videos/metadata.csv(覆盖全部 152 件视频);
  2. 想找可打开的工程、关注分辨率/帧率/渲染注意事项 → 打开 blend/index.csv;
  3. 用 arc-NNN 编号在两张表间跳转,复制 blend / video 列的路径直达文件;
  4. 细节问题(模拟、缓存、改动说明)→ 查阅该工程目录下的 README.txt。

掌握这两张元数据表的全部字段后,无论是按年份整理作品、挑选学习素材,还是核对渲染参数,都能在几秒内精确定位到目标文件。

登录后查看全文
arc-art