{"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/learning-structured-representations-with","title":"Learning Structured Representations with Hyperbolic Embeddings","arxiv_id":"2412.01023","date":"2024-12-02","proceeding":null,"authors":["Aditya Sinha","Siqi Zeng","Makoto Yamada","Han Zhao"],"abstract":"Most real-world datasets consist of a natural hierarchy between classes or an inherent label structure that is either already available or can be constructed cheaply. However, most existing representation learning methods ignore this hierarchy, treating labels as permutation invariant. Recent work [Zeng et al., 2022] proposes using this structured information explicitly, but the use of Euclidean distance may distort the underlying semantic context [Chen et al., 2013]. In this work, motivated by the advantage of hyperbolic spaces in modeling hierarchical relationships, we propose a novel approach HypStructure: a Hyperbolic Structured regularization approach to accurately embed the label hierarchy into the learned representations. HypStructure is a simple-yet-effective regularizer that consists of a hyperbolic tree-based representation loss along with a centering loss, and can be combined with any standard task loss to learn hierarchy-informed features. Extensive experiments on several large-scale vision benchmarks demonstrate the efficacy of HypStructure in reducing distortion and boosting generalization performance especially under low dimensional scenarios. For a better understanding of structured representation, we perform eigenvalue analysis that links the representation geometry to improved Out-of-Distribution (OOD) detection performance seen empirically. The code is available at \\url{https://github.com/uiuctml/HypStructure}.","url_abs":"https://arxiv.org/abs/2412.01023v1","url_pdf":"https://arxiv.org/pdf/2412.01023v1.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":"learning-structured-representations-with","repo_url":"https://github.com/uiuctml/HypStructure","is_official":1,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok","spdx":"MIT"}}],"tasks":[{"task_slug":"ood-detection","task_name":"Out of Distribution (OOD) Detection"},{"task_slug":"representation-learning","task_name":"Representation Learning"}],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"atlas_url":"https://app.syntology.ai/?focus=2412.01023","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2412.01023"}},"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/uiuctml/HypStructure","reach":{"status":"ok","spdx":"MIT"}}],"summary":{"ran_draft_wrong":4,"ran_fixture":2,"unverified":9},"by_repo_kind":{"official":{"samples":15,"ran":6,"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":"28baecbc84c248a8","entry":"busemann","repo":"uiuctml/HypStructure","repo_kind":"official","path":"geom/horo.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/geom/horo.py","link_basis":"plan_row","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"28baecbc84c248a8"}},{"code_sha256_prefix":"1faaa541998d4b4c","entry":"circle_intersection_","repo":"uiuctml/HypStructure","repo_kind":"official","path":"geom/horo.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/geom/horo.py","link_basis":"plan_row","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"1faaa541998d4b4c"}},{"code_sha256_prefix":"caad5cf1736c5c6b","entry":"exp_unit_tangents","repo":"uiuctml/HypStructure","repo_kind":"official","path":"geom/hyperboloid.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/geom/hyperboloid.py","link_basis":"plan_row","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"caad5cf1736c5c6b"}},{"code_sha256_prefix":"a4880a4d1201ee27","entry":"from_poincare","repo":"uiuctml/HypStructure","repo_kind":"official","path":"geom/hyperboloid.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/geom/hyperboloid.py","link_basis":"plan_row","language":"python","status":"ran_fixture","verification_level":1,"contract_check":"RAISES","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"a4880a4d1201ee27"}},{"code_sha256_prefix":"1c82b403bc72b7cd","entry":"get_scores_multi_cluster","repo":"uiuctml/HypStructure","repo_kind":"official","path":"utils.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/utils.py","link_basis":"plan_row","language":"python","status":"ran_fixture","verification_level":1,"contract_check":"RAISES","metamorphic_tier":"deterministic","behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"1c82b403bc72b7cd"}},{"code_sha256_prefix":"7ae021ffa7f0e179","entry":"orthonormal","repo":"uiuctml/HypStructure","repo_kind":"official","path":"geom/euclidean.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/geom/euclidean.py","link_basis":"plan_row","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"7ae021ffa7f0e179"}},{"code_sha256_prefix":"3108ccfe785c00d0","entry":"circle_intersection","repo":"uiuctml/HypStructure","repo_kind":"official","path":"geom/horo.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/geom/horo.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"3108ccfe785c00d0"}},{"code_sha256_prefix":"7d2a17cffeebbaee","entry":"euc_reflection","repo":"uiuctml/HypStructure","repo_kind":"official","path":"geom/euclidean.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/geom/euclidean.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"7d2a17cffeebbaee"}},{"code_sha256_prefix":"cf06b847b490e55a","entry":"get_scores","repo":"uiuctml/HypStructure","repo_kind":"official","path":"utils.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"cf06b847b490e55a"}},{"code_sha256_prefix":"1f89c4ce7d2cf497","entry":"get_scores_one_cluster","repo":"uiuctml/HypStructure","repo_kind":"official","path":"utils.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"1f89c4ce7d2cf497"}},{"code_sha256_prefix":"168504328c1cde29","entry":"init_model","repo":"uiuctml/HypStructure","repo_kind":"official","path":"model.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/model.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"168504328c1cde29"}},{"code_sha256_prefix":"ae70f23184939b33","entry":"init_optim_schedule","repo":"uiuctml/HypStructure","repo_kind":"official","path":"param.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/param.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"ae70f23184939b33"}},{"code_sha256_prefix":"0d2e3df5a353b824","entry":"load_coarse_map","repo":"uiuctml/HypStructure","repo_kind":"official","path":"main_evaluate.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/main_evaluate.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"0d2e3df5a353b824"}},{"code_sha256_prefix":"8cf34e6994805544","entry":"load_params","repo":"uiuctml/HypStructure","repo_kind":"official","path":"param.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/param.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"8cf34e6994805544"}},{"code_sha256_prefix":"f1e92194323ca315","entry":"reflect","repo":"uiuctml/HypStructure","repo_kind":"official","path":"geom/euclidean.py","file_url":"https://github.com/uiuctml/HypStructure/blob/HEAD/geom/euclidean.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"f1e92194323ca315"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}