{"about":{"site":"https://codewithpapers.app","non_affiliation":"Code with Papers and Syntology are not affiliated with, endorsed by, or sponsored by Papers with Code, Meta, or the pwc-archive mirror.","licence":"CC BY-SA 4.0","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","attribution":"https://codewithpapers.app/attribution","modified":"archive material modified by Syntology; see the attribution page"},"url":"/paper/pianomotion10m-dataset-and-benchmark-for-hand","title":"PianoMotion10M: Dataset and Benchmark for Hand Motion Generation in Piano Performance","arxiv_id":"2406.09326","date":"2024-06-13","proceeding":null,"authors":["Qijun Gan","Song Wang","Shengtao Wu","Jianke Zhu"],"abstract":"Recently, artificial intelligence techniques for education have been received increasing attentions, while it still remains an open problem to design the effective music instrument instructing systems. Although key presses can be directly derived from sheet music, the transitional movements among key presses require more extensive guidance in piano performance. In this work, we construct a piano-hand motion generation benchmark to guide hand movements and fingerings for piano playing. To this end, we collect an annotated dataset, PianoMotion10M, consisting of 116 hours of piano playing videos from a bird's-eye view with 10 million annotated hand poses. We also introduce a powerful baseline model that generates hand motions from piano audios through a position predictor and a position-guided gesture generator. Furthermore, a series of evaluation metrics are designed to assess the performance of the baseline model, including motion similarity, smoothness, positional accuracy of left and right hands, and overall fidelity of movement distribution. Despite that piano key presses with respect to music scores or audios are already accessible, PianoMotion10M aims to provide guidance on piano fingering for instruction purposes. The source code and dataset can be accessed at https://github.com/agnJason/PianoMotion10M.","url_abs":"https://arxiv.org/abs/2406.09326v2","url_pdf":"https://arxiv.org/pdf/2406.09326v2.pdf","source":{"archive":"pwc-archive (Hugging Face), CC BY-SA 4.0","snapshot":"2025-07-28","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","row_kind":"abstracts"},"code_links":[{"paper_slug":"pianomotion10m-dataset-and-benchmark-for-hand","repo_url":"https://github.com/agnjason/pianomotion10m","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok","spdx":"Apache-2.0"}}],"tasks":[{"task_slug":"motion-generation","task_name":"Motion Generation"},{"task_slug":null,"task_name":"Position"}],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"atlas_url":"https://app.syntology.ai/?focus=2406.09326","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2406.09326"}},"developers":"https://syntology.ai/developers","read_at":"2026-09-24T18:15:14+00:00","read_at_is":"when the build read Syntology's graph, not when any sample ran","claim":"Per-sample execution status on synthesized fixtures; not a correctness claim about the paper. Samples come from repositories linked to the paper, official or community; repo_kind says which.","repos":[{"provenance":"deterministic:regex_extraction","url":"https://github.com/agnJason/PianoMotion10M","reach":{"status":"ok","spdx":"Apache-2.0"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/agnjason/pianomotion10m","reach":{"status":"ok","spdx":"Apache-2.0"}}],"summary":{"ran_honours":4,"ran":5,"ran_violates":3,"ran_fixture":1,"unverified":2},"by_repo_kind":{"official":{"samples":15,"ran":13,"repositories":1}},"repo_kind_vocabulary":{"official":"The archive marks this repository official for the paper","named_in_paper":"The archive records that the paper mentions this repository; it is not marked official","listed":"In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper","found_in_text":"Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted","community":"Not in the archive's code links for this paper; a community repository Syntology harvested"},"n_pointer_only_for_licence":0,"samples":[{"code_sha256_prefix":"7f1040f5e3991d5e","entry":"identity","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/denoise_diffusion.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/denoise_diffusion.py","link_basis":"harvester_set","language":"python","status":"ran_honours","verification_level":2,"contract_check":"HONOURS","metamorphic_tier":"invariant","behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"7f1040f5e3991d5e"}},{"code_sha256_prefix":"0b4dc4c570105906","entry":"GaussianDiffusion1D_piano2pose","repo":"agnjason/pianomotion10m","repo_kind":"official","path":"models/denoise_diffusion.py","file_url":"https://github.com/agnjason/pianomotion10m/blob/HEAD/models/denoise_diffusion.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":"deterministic","behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"0b4dc4c570105906"}},{"code_sha256_prefix":"c0cec5eb44a6d5fb","entry":"MW2","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/evaluate.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/evaluate.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"c0cec5eb44a6d5fb"}},{"code_sha256_prefix":"05e94467a0de94a4","entry":"cosine_beta_schedule","repo":"agnjason/pianomotion10m","repo_kind":"official","path":"models/denoise_diffusion.py","file_url":"https://github.com/agnjason/pianomotion10m/blob/HEAD/models/denoise_diffusion.py","link_basis":"first_harvest_node","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":"well_formed","behaviour_fingerprint":true,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"05e94467a0de94a4"}},{"code_sha256_prefix":"d1ef6b8cb9a28a53","entry":"default","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/denoise_diffusion.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/denoise_diffusion.py","link_basis":"harvester_set","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":"deterministic","behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"d1ef6b8cb9a28a53"}},{"code_sha256_prefix":"7ed01fed1fc1f58f","entry":"enc_dec_mask","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/utils.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/utils.py","link_basis":"plan_row","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":"deterministic","behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"7ed01fed1fc1f58f"}},{"code_sha256_prefix":"608e364a9d2376a3","entry":"exists","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/denoise_diffusion.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/denoise_diffusion.py","link_basis":"harvester_set","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":"deterministic","behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"608e364a9d2376a3"}},{"code_sha256_prefix":"48d5d027f2a36562","entry":"fid","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/evaluate.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/evaluate.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"48d5d027f2a36562"}},{"code_sha256_prefix":"f7b0318637b0548a","entry":"init_biased_mask","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/utils.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/utils.py","link_basis":"plan_row","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":"deterministic","behaviour_fingerprint":true,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"f7b0318637b0548a"}},{"code_sha256_prefix":"482723f534770483","entry":"linear_beta_schedule","repo":"agnjason/pianomotion10m","repo_kind":"official","path":"models/denoise_diffusion.py","file_url":"https://github.com/agnjason/pianomotion10m/blob/HEAD/models/denoise_diffusion.py","link_basis":"first_harvest_node","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":"well_formed","behaviour_fingerprint":true,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"482723f534770483"}},{"code_sha256_prefix":"e45a37313dcbbaac","entry":"linear_interpolation","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/wav2vec.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/wav2vec.py","link_basis":"plan_row","language":"python","status":"ran_fixture","verification_level":1,"contract_check":"RAISES","metamorphic_tier":"invariant","behaviour_fingerprint":true,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"e45a37313dcbbaac"}},{"code_sha256_prefix":"ae9bd94543a16207","entry":"loc_distance","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/evaluate.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/evaluate.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"ae9bd94543a16207"}},{"code_sha256_prefix":"4537026d64143186","entry":"velocity_loss","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/utils.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"4537026d64143186"}},{"code_sha256_prefix":"e44e6e20f6209f87","entry":"scatter","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/BalancedDataParallel.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/BalancedDataParallel.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"e44e6e20f6209f87"}},{"code_sha256_prefix":"ca2a9ebf352702e2","entry":"scatter_kwargs","repo":"agnJason/PianoMotion10M","repo_kind":"official","path":"models/BalancedDataParallel.py","file_url":"https://github.com/agnJason/PianoMotion10M/blob/HEAD/models/BalancedDataParallel.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"ca2a9ebf352702e2"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}