如何在arc-art中快速定位作品:index.csv与metadata.csv元数据字段完全指南
如何在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,仅限非商业使用,商用需联系作者授权。
小结:快速定位作品的最短路径
- 想按标题、日期、规格筛选 → 打开 videos/metadata.csv(覆盖全部 152 件视频);
- 想找可打开的工程、关注分辨率/帧率/渲染注意事项 → 打开 blend/index.csv;
- 用
arc-NNN编号在两张表间跳转,复制blend/video列的路径直达文件; - 细节问题(模拟、缓存、改动说明)→ 查阅该工程目录下的
README.txt。
掌握这两张元数据表的全部字段后,无论是按年份整理作品、挑选学习素材,还是核对渲染参数,都能在几秒内精确定位到目标文件。