MandyChen01/lafan1_retargeting_pkl_contact_mask

LAFAN1 Retargeting PKL Contact Mask Dataset

数据集描述

本数据集包含 LAFAN1 动作重定向数据的接触掩码（contact mask）信息，以 pickle (.pkl) 格式存储。

数据集结构

文件列表

数据集包含以下文件：

• —41 个 .pkl 文件：包含各种动作序列的接触掩码数据
• —dance1: 3 个文件
• —dance2: 5 个文件
• —fallAndGetUp1: 3 个文件
• —fallAndGetUp2: 2 个文件
• —fallAndGetUp3: 1 个文件
• —fight1: 3 个文件
• —fightAndSports1: 2 个文件
• —jumps1: 3 个文件
• —run1: 2 个文件
• —run2: 2 个文件
• —sprint1: 2 个文件
• —walk1: 3 个文件
• —walk2: 3 个文件
• —walk3: 5 个文件
• —walk4: 1 个文件
• —merged_motion.pkl: 合并后的动作数据

• —1 个 .txt 文件：mergedmotionkeys.txt（合并动作的键列表）

总大小

约 227 MB

重要说明

⚠️ 注意：由于 .pkl 文件是二进制格式，Hugging Face 的数据集查看器无法直接在网页上显示这些文件的内容。但所有文件都已成功上传，可以通过以下方式访问：

1. 1.在网页上查看文件列表：访问 Files and versions 标签页，可以看到所有文件列表
2. 2.使用 Python 下载：见下方使用示例
3. 3.使用命令行下载：见下方使用示例

使用方法

Python 示例

from huggingface_hub import hf_hub_download
import pickle

# 下载单个文件
file_path = hf_hub_download(
    repo_id="MandyChen01/lafan1_retargeting_pkl_contact_mask",
    repo_type="dataset",
    filename="dance1_subject1_0_3945_cont_mask.pkl"
)

# 加载数据
with open(file_path, 'rb') as f:
    data = pickle.load(f)
    print(data.keys() if isinstance(data, dict) else type(data))

下载整个数据集

from huggingface_hub import snapshot_download

local_dir = snapshot_download(
    repo_id="MandyChen01/lafan1_retargeting_pkl_contact_mask",
    repo_type="dataset",
    local_dir="./lafan_dataset"
)

命令行下载

# 下载整个数据集
hf download MandyChen01/lafan1_retargeting_pkl_contact_mask --repo-type=dataset

# 下载特定文件
hf download MandyChen01/lafan1_retargeting_pkl_contact_mask --repo-type=dataset --include "*.pkl"

文件命名规则

文件名格式：{动作类型}{编号}_subject{受试者编号}_{起始帧}_{总帧数}_cont_mask.pkl

例如：

• —dance1_subject1_0_3945_cont_mask.pkl：dance1 动作，受试者1，从第0帧开始，共3945帧
• —walk3_subject5_0_7399_cont_mask.pkl：walk3 动作，受试者5，从第0帧开始，共7399帧

数据格式

每个 .pkl 文件包含接触掩码数据，可以使用 Python 的 pickle 模块加载：

import pickle

with open('filename.pkl', 'rb') as f:
    contact_mask_data = pickle.load(f)

引用

如果使用本数据集，请引用 LAFAN1 原始数据集。

许可证

MIT License