{"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/disentangling-by-factorising","title":"Disentangling by Factorising","arxiv_id":"1802.05983","date":"2018-02-16","proceeding":"ICML 2018 7","authors":["Hyunjik Kim","andriy mnih"],"abstract":"We define and address the problem of unsupervised learning of disentangled representations on data generated from independent factors of variation. We propose FactorVAE, a method that disentangles by encouraging the distribution of representations to be factorial and hence independent across the dimensions. We show that it improves upon $\\beta$-VAE by providing a better trade-off between disentanglement and reconstruction quality. Moreover, we highlight the problems of a commonly used disentanglement metric and introduce a new metric that does not suffer from them.","url_abs":"https://arxiv.org/abs/1802.05983v3","url_pdf":"https://arxiv.org/pdf/1802.05983v3.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":"disentangling-by-factorising","repo_url":"https://github.com/1Konny/FactorVAE","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok","spdx":"MIT"}},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/AliLotfi92/Disentangling-by-Factorising","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok"}},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/AliLotfi92/Disentangling_by_Factorising","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":null},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/Guiliang/FactorVAE","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":null},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/Michedev/FactorVAE","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok"}},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/OZA15015/custom_FVAE","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":null},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/carbonati/variational-zoo","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"tf","reach":null},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/clementchadebec/benchmark_VAE","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":null},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/danielbraithwt/Readings","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"none","reach":{"status":"ok"}},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/ducnx/FactorVAE","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":null},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/elda27/FactorVAE","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"tf","reach":{"status":"ok"}},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/facebookresearch/disentangling-correlated-factors","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok","spdx":"MIT"}},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/gene-chou/conditional-factor-vae","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":null},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/mcharrak/discreteVAE","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"tf","reach":{"status":"ok"}},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/mmrl/disent-and-gen","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":null},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/nicolasigor/FactorVAE","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"tf","reach":null},{"paper_slug":"disentangling-by-factorising","repo_url":"https://github.com/wangdedi1997/Disentanglement-Beta-FactorVAE","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"tf","reach":null}],"tasks":[{"task_slug":"disentanglement","task_name":"Disentanglement"}],"methods":[],"datasets_introduced":[{"slug":"3d-shapes-dataset","name":"3D Shapes Dataset","full_name":""}],"methods_introduced":[],"results":[],"syntology":{"atlas_url":"https://app.syntology.ai/?focus=1802.05983","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"1802.05983"}},"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":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/facebookresearch/disentangling-correlated-factors","reach":{"status":"ok","spdx":"MIT"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/clementchadebec/benchmark_VAE","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/wangdedi1997/Disentanglement-Beta-FactorVAE","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/OZA15015/custom_FVAE","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/carbonati/variational-zoo","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/AliLotfi92/Disentangling-by-Factorising","reach":{"status":"ok"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/AliLotfi92/Disentangling_by_Factorising","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/1Konny/FactorVAE","reach":{"status":"ok","spdx":"MIT"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/danielbraithwt/Readings","reach":{"status":"ok"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/nicolasigor/FactorVAE","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/gene-chou/conditional-factor-vae","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/Michedev/FactorVAE","reach":{"status":"ok"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/Guiliang/FactorVAE","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/mmrl/disent-and-gen","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/elda27/FactorVAE","reach":{"status":"ok"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/ducnx/FactorVAE","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/mcharrak/discreteVAE","reach":{"status":"ok"}}],"summary":{"ran":5,"ran_draft_wrong":3,"ran_honours":1,"ran_violates":1,"unverified":14},"by_repo_kind":{"listed":{"samples":24,"ran":10,"repositories":10}},"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":6,"samples":[{"code_sha256_prefix":"2ac2573096dd729f","entry":"FactorLoss","repo":"mmrl/disent-and-gen","repo_kind":"listed","path":"src/training/loss.py","file_url":"https://github.com/mmrl/disent-and-gen/blob/HEAD/src/training/loss.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":"deterministic","behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"2ac2573096dd729f"}},{"code_sha256_prefix":"cf4c65d2fe9af40c","entry":"FactorVAE1","repo":"Guiliang/FactorVAE","repo_kind":"listed","path":"model.py","file_url":"https://github.com/Guiliang/FactorVAE/blob/HEAD/model.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":"deterministic","behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"cf4c65d2fe9af40c"}},{"code_sha256_prefix":"73d0c8f4c7646b0f","entry":"FactorVAE1","repo":"AliLotfi92/Disentangling_by_Factorising","repo_kind":"listed","path":"FactorizedVAE.py","file_url":"https://github.com/AliLotfi92/Disentangling_by_Factorising/blob/HEAD/FactorizedVAE.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":"deterministic","behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"73d0c8f4c7646b0f"}},{"code_sha256_prefix":"bec5ff7fdcceb70f","entry":"FactorVAE1","repo":"ducnx/FactorVAE","repo_kind":"listed","path":"model.py","file_url":"https://github.com/ducnx/FactorVAE/blob/HEAD/model.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"bec5ff7fdcceb70f"}},{"code_sha256_prefix":"ac9b4cd1604cceb7","entry":"_gaussian_kl","repo":"mmrl/disent-and-gen","repo_kind":"listed","path":"src/training/loss.py","file_url":"https://github.com/mmrl/disent-and-gen/blob/HEAD/src/training/loss.py","link_basis":"first_harvest_node","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"MISDECLARED","metamorphic_tier":"invariant","behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"ac9b4cd1604cceb7"}},{"code_sha256_prefix":"1618797ac42b1d4d","entry":"_permute_dims","repo":"mmrl/disent-and-gen","repo_kind":"listed","path":"src/training/loss.py","file_url":"https://github.com/mmrl/disent-and-gen/blob/HEAD/src/training/loss.py","link_basis":"first_harvest_node","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":"1618797ac42b1d4d"}},{"code_sha256_prefix":"7c1f2ad3c96fb760","entry":"init_optimizer","repo":"mmrl/disent-and-gen","repo_kind":"listed","path":"src/training/loss.py","file_url":"https://github.com/mmrl/disent-and-gen/blob/HEAD/src/training/loss.py","link_basis":"first_harvest_node","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"7c1f2ad3c96fb760"}},{"code_sha256_prefix":"6523d8d6272a3cc5","entry":"is_power_of_2","repo":"1Konny/FactorVAE","repo_kind":"listed","path":"dataset.py","file_url":"https://github.com/1Konny/FactorVAE/blob/HEAD/dataset.py","link_basis":"harvester_set","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"6523d8d6272a3cc5"}},{"code_sha256_prefix":"e65cfdcf1fad978e","entry":"permute_dims","repo":"carbonati/variational-zoo","repo_kind":"listed","path":"vzoo/losses/disentangled_losses.py","file_url":"https://github.com/carbonati/variational-zoo/blob/HEAD/vzoo/losses/disentangled_losses.py","link_basis":"first_harvest_node","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"e65cfdcf1fad978e"}},{"code_sha256_prefix":"f017532fc389cbfe","entry":"str2bool","repo":"1Konny/FactorVAE","repo_kind":"listed","path":"utils.py","file_url":"https://github.com/1Konny/FactorVAE/blob/HEAD/utils.py","link_basis":"harvester_set","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":"deterministic","behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"f017532fc389cbfe"}},{"code_sha256_prefix":"827f05f31dbb1dcc","entry":"AELoss","repo":"mmrl/disent-and-gen","repo_kind":"listed","path":"src/training/loss.py","file_url":"https://github.com/mmrl/disent-and-gen/blob/HEAD/src/training/loss.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":"827f05f31dbb1dcc"}},{"code_sha256_prefix":"39e6b74d32f518be","entry":"Beta_Factor_VAE","repo":"wangdedi1997/Disentanglement-Beta-FactorVAE","repo_kind":"listed","path":"beta_factorVAE.py","file_url":"https://github.com/wangdedi1997/Disentanglement-Beta-FactorVAE/blob/HEAD/beta_factorVAE.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"39e6b74d32f518be"}},{"code_sha256_prefix":"b634434403efcc68","entry":"FactorVAE","repo":"nicolasigor/FactorVAE","repo_kind":"listed","path":"factor_vae_mine_v3.py","file_url":"https://github.com/nicolasigor/FactorVAE/blob/HEAD/factor_vae_mine_v3.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":"b634434403efcc68"}},{"code_sha256_prefix":"0081025339279ee3","entry":"FactorVAE","repo":"gene-chou/conditional-factor-vae","repo_kind":"listed","path":"models.py","file_url":"https://github.com/gene-chou/conditional-factor-vae/blob/HEAD/models.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"0081025339279ee3"}},{"code_sha256_prefix":"469a9d4b711b6f36","entry":"FactorVAE1","repo":"OZA15015/custom_FVAE","repo_kind":"listed","path":"model.py","file_url":"https://github.com/OZA15015/custom_FVAE/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":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"469a9d4b711b6f36"}},{"code_sha256_prefix":"30676973d384c175","entry":"MINE","repo":"nicolasigor/FactorVAE","repo_kind":"listed","path":"factor_vae_mine_v3.py","file_url":"https://github.com/nicolasigor/FactorVAE/blob/HEAD/factor_vae_mine_v3.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":"30676973d384c175"}},{"code_sha256_prefix":"b773ab7c4411241a","entry":"VAE","repo":"nicolasigor/FactorVAE","repo_kind":"listed","path":"factor_vae_mine_v3.py","file_url":"https://github.com/nicolasigor/FactorVAE/blob/HEAD/factor_vae_mine_v3.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":"b773ab7c4411241a"}},{"code_sha256_prefix":"cde89c348c9272a6","entry":"compute_factor_vae_loss","repo":"carbonati/variational-zoo","repo_kind":"listed","path":"vzoo/losses/disentangled_losses.py","file_url":"https://github.com/carbonati/variational-zoo/blob/HEAD/vzoo/losses/disentangled_losses.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"cde89c348c9272a6"}},{"code_sha256_prefix":"f55d759c3d225e46","entry":"kaiming_init","repo":"Guiliang/FactorVAE","repo_kind":"listed","path":"model.py","file_url":"https://github.com/Guiliang/FactorVAE/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":"f55d759c3d225e46"}},{"code_sha256_prefix":"36190b3f24d53e67","entry":"kl_divergence","repo":"1Konny/FactorVAE","repo_kind":"listed","path":"ops.py","file_url":"https://github.com/1Konny/FactorVAE/blob/HEAD/ops.py","link_basis":"harvester_set","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":"36190b3f24d53e67"}},{"code_sha256_prefix":"aed5880c62317c0e","entry":"normal_init","repo":"Guiliang/FactorVAE","repo_kind":"listed","path":"model.py","file_url":"https://github.com/Guiliang/FactorVAE/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":"aed5880c62317c0e"}},{"code_sha256_prefix":"e2f78217c9061bef","entry":"permute_dims","repo":"1Konny/FactorVAE","repo_kind":"listed","path":"ops.py","file_url":"https://github.com/1Konny/FactorVAE/blob/HEAD/ops.py","link_basis":"harvester_set","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":"e2f78217c9061bef"}},{"code_sha256_prefix":"2cbe0cbb9e1cf86e","entry":"recon_loss","repo":"1Konny/FactorVAE","repo_kind":"listed","path":"ops.py","file_url":"https://github.com/1Konny/FactorVAE/blob/HEAD/ops.py","link_basis":"harvester_set","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":"2cbe0cbb9e1cf86e"}},{"code_sha256_prefix":"8752210a3f89714d","entry":"return_data","repo":"1Konny/FactorVAE","repo_kind":"listed","path":"dataset.py","file_url":"https://github.com/1Konny/FactorVAE/blob/HEAD/dataset.py","link_basis":"harvester_set","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":"8752210a3f89714d"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}