{"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/argmax-flows-and-multinomial-diffusion","title":"Argmax Flows and Multinomial Diffusion: Learning Categorical Distributions","arxiv_id":"2102.05379","date":"2021-02-10","proceeding":"NeurIPS 2021 12","authors":["Emiel Hoogeboom","Didrik Nielsen","Priyank Jaini","Patrick Forré","Max Welling"],"abstract":"Generative flows and diffusion models have been predominantly trained on ordinal data, for example natural images. This paper introduces two extensions of flows and diffusion for categorical data such as language or image segmentation: Argmax Flows and Multinomial Diffusion. Argmax Flows are defined by a composition of a continuous distribution (such as a normalizing flow), and an argmax function. To optimize this model, we learn a probabilistic inverse for the argmax that lifts the categorical data to a continuous space. Multinomial Diffusion gradually adds categorical noise in a diffusion process, for which the generative denoising process is learned. We demonstrate that our method outperforms existing dequantization approaches on text modelling and modelling on image segmentation maps in log-likelihood.","url_abs":"https://arxiv.org/abs/2102.05379v3","url_pdf":"https://arxiv.org/pdf/2102.05379v3.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":"argmax-flows-and-multinomial-diffusion","repo_url":"https://github.com/didriknielsen/argmax_flows","is_official":1,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":null},{"paper_slug":"argmax-flows-and-multinomial-diffusion","repo_url":"https://github.com/ehoogeboom/multinomial_diffusion","is_official":1,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":null},{"paper_slug":"argmax-flows-and-multinomial-diffusion","repo_url":"https://github.com/YuzheZhang-1999/DiffTSR","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":null},{"paper_slug":"argmax-flows-and-multinomial-diffusion","repo_url":"https://github.com/compvis/imagebart","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok"}}],"tasks":[{"task_slug":"denoising","task_name":"Denoising"},{"task_slug":"image-segmentation","task_name":"Image Segmentation"},{"task_slug":"language-modelling","task_name":"Language Modelling"},{"task_slug":"segmentation","task_name":"Segmentation"},{"task_slug":"semantic-segmentation","task_name":"Semantic Segmentation"}],"methods":[{"method_slug":"diffusion","method_name":"Diffusion"}],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"syntology_url":"https://syntology.ai/paper/2102.05379","atlas_url":"https://app.syntology.ai/?focus=2102.05379","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2102.05379"}},"developers":"https://syntology.ai/developers","read_at":"2026-09-25T09:33:49+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/google/edward2","reach":{"status":"unanswered"}},{"provenance":"deterministic:regex_extraction","url":"https://github.com/TrentBrick/PyTorchDiscreteFlows","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/YuzheZhang-1999/DiffTSR","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/didriknielsen/argmax_flows","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/ehoogeboom/multinomial_diffusion","reach":null},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/compvis/imagebart","reach":{"status":"ok"}}],"summary":{"ran":1,"ran_honours":7,"ran_fixture":3,"ran_violates":1,"ran_draft_wrong":2,"unverified":6},"by_repo_kind":{"official":{"samples":12,"ran":9,"repositories":2},"listed":{"samples":7,"ran":5,"repositories":1},"found_in_text":{"samples":1,"ran":0,"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":2,"samples":[{"code_sha256_prefix":"4268dcf6913cd21f","entry":"MultinomialDiffusion","repo":"ehoogeboom/multinomial_diffusion","repo_kind":"official","path":"diffusion_utils/diffusion_multinomial.py","file_url":"https://github.com/ehoogeboom/multinomial_diffusion/blob/HEAD/diffusion_utils/diffusion_multinomial.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":"4268dcf6913cd21f"}},{"code_sha256_prefix":"e72047c1892c7a2a","entry":"_log_cdf","repo":"didriknielsen/argmax_flows","repo_kind":"official","path":"model/CategoricalNF/flows/mixture_cdf_layer.py","file_url":"https://github.com/didriknielsen/argmax_flows/blob/HEAD/model/CategoricalNF/flows/mixture_cdf_layer.py","link_basis":"first_harvest_node","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"e72047c1892c7a2a"}},{"code_sha256_prefix":"74b5245783db5aab","entry":"_log_pdf","repo":"didriknielsen/argmax_flows","repo_kind":"official","path":"model/CategoricalNF/flows/mixture_cdf_layer.py","file_url":"https://github.com/didriknielsen/argmax_flows/blob/HEAD/model/CategoricalNF/flows/mixture_cdf_layer.py","link_basis":"first_harvest_node","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"74b5245783db5aab"}},{"code_sha256_prefix":"c92a02b48d8fb1c4","entry":"cosine_beta_schedule","repo":"YuzheZhang-1999/DiffTSR","repo_kind":"listed","path":"model/TDM/models/diffusion_multinomial.py","file_url":"https://github.com/YuzheZhang-1999/DiffTSR/blob/HEAD/model/TDM/models/diffusion_multinomial.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":"c92a02b48d8fb1c4"}},{"code_sha256_prefix":"887b510303aa0cff","entry":"index_to_log_onehot","repo":"YuzheZhang-1999/DiffTSR","repo_kind":"listed","path":"model/TDM/models/diffusion_multinomial.py","file_url":"https://github.com/YuzheZhang-1999/DiffTSR/blob/HEAD/model/TDM/models/diffusion_multinomial.py","link_basis":"first_harvest_node","language":"python","status":"ran_fixture","verification_level":1,"contract_check":"RAISES","metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"887b510303aa0cff"}},{"code_sha256_prefix":"7e630357d1081630","entry":"inverse","repo":"didriknielsen/argmax_flows","repo_kind":"official","path":"model/CategoricalNF/flows/mixture_cdf_layer.py","file_url":"https://github.com/didriknielsen/argmax_flows/blob/HEAD/model/CategoricalNF/flows/mixture_cdf_layer.py","link_basis":"first_harvest_node","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":"7e630357d1081630"}},{"code_sha256_prefix":"39226fe0563dc032","entry":"log_1_min_a","repo":"YuzheZhang-1999/DiffTSR","repo_kind":"listed","path":"model/TDM/models/diffusion_multinomial.py","file_url":"https://github.com/YuzheZhang-1999/DiffTSR/blob/HEAD/model/TDM/models/diffusion_multinomial.py","link_basis":"first_harvest_node","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"39226fe0563dc032"}},{"code_sha256_prefix":"3d24f690340703af","entry":"log_add_exp","repo":"YuzheZhang-1999/DiffTSR","repo_kind":"listed","path":"model/TDM/models/diffusion_multinomial.py","file_url":"https://github.com/YuzheZhang-1999/DiffTSR/blob/HEAD/model/TDM/models/diffusion_multinomial.py","link_basis":"first_harvest_node","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"3d24f690340703af"}},{"code_sha256_prefix":"cf94102882d34c5a","entry":"mixture_inv_cdf","repo":"didriknielsen/argmax_flows","repo_kind":"official","path":"model/CategoricalNF/flows/mixture_cdf_layer.py","file_url":"https://github.com/didriknielsen/argmax_flows/blob/HEAD/model/CategoricalNF/flows/mixture_cdf_layer.py","link_basis":"first_harvest_node","language":"python","status":"ran_fixture","verification_level":1,"contract_check":"RAISES","metamorphic_tier":"invariant","behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"cf94102882d34c5a"}},{"code_sha256_prefix":"db244b4a1b9d7755","entry":"mixture_log_cdf","repo":"didriknielsen/argmax_flows","repo_kind":"official","path":"model/CategoricalNF/flows/mixture_cdf_layer.py","file_url":"https://github.com/didriknielsen/argmax_flows/blob/HEAD/model/CategoricalNF/flows/mixture_cdf_layer.py","link_basis":"first_harvest_node","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"db244b4a1b9d7755"}},{"code_sha256_prefix":"3ae2ea791a983a23","entry":"mixture_log_pdf","repo":"didriknielsen/argmax_flows","repo_kind":"official","path":"model/CategoricalNF/flows/mixture_cdf_layer.py","file_url":"https://github.com/didriknielsen/argmax_flows/blob/HEAD/model/CategoricalNF/flows/mixture_cdf_layer.py","link_basis":"first_harvest_node","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"3ae2ea791a983a23"}},{"code_sha256_prefix":"3ee1217b23068736","entry":"run_sequential_with_mask","repo":"didriknielsen/argmax_flows","repo_kind":"official","path":"model/CategoricalNF/flows/mixture_cdf_layer.py","file_url":"https://github.com/didriknielsen/argmax_flows/blob/HEAD/model/CategoricalNF/flows/mixture_cdf_layer.py","link_basis":"first_harvest_node","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":"3ee1217b23068736"}},{"code_sha256_prefix":"13bc23344ef8bd53","entry":"safe_log","repo":"didriknielsen/argmax_flows","repo_kind":"official","path":"model/CategoricalNF/flows/mixture_cdf_layer.py","file_url":"https://github.com/didriknielsen/argmax_flows/blob/HEAD/model/CategoricalNF/flows/mixture_cdf_layer.py","link_basis":"first_harvest_node","language":"python","status":"ran_honours","verification_level":1,"contract_check":"HONOURS","metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"13bc23344ef8bd53"}},{"code_sha256_prefix":"38d8ef27c0f4b98a","entry":"sum_except_batch","repo":"YuzheZhang-1999/DiffTSR","repo_kind":"listed","path":"model/TDM/models/diffusion_multinomial.py","file_url":"https://github.com/YuzheZhang-1999/DiffTSR/blob/HEAD/model/TDM/models/diffusion_multinomial.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":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"38d8ef27c0f4b98a"}},{"code_sha256_prefix":"62906ae69863334e","entry":"CouplingLayer","repo":"didriknielsen/argmax_flows","repo_kind":"official","path":"model/CategoricalNF/flows/mixture_cdf_layer.py","file_url":"https://github.com/didriknielsen/argmax_flows/blob/HEAD/model/CategoricalNF/flows/mixture_cdf_layer.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":"62906ae69863334e"}},{"code_sha256_prefix":"a15ee5030a6486ce","entry":"DiffusionWrapper","repo":"YuzheZhang-1999/DiffTSR","repo_kind":"listed","path":"model/TDM/models/diffusion_multinomial.py","file_url":"https://github.com/YuzheZhang-1999/DiffTSR/blob/HEAD/model/TDM/models/diffusion_multinomial.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":"a15ee5030a6486ce"}},{"code_sha256_prefix":"b2a81908ae5a22a5","entry":"DiscreteAutoregressiveFlow","repo":"TrentBrick/PyTorchDiscreteFlows","repo_kind":"found_in_text","path":"discrete_flows/disc_models.py","file_url":"https://github.com/TrentBrick/PyTorchDiscreteFlows/blob/HEAD/discrete_flows/disc_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":"b2a81908ae5a22a5"}},{"code_sha256_prefix":"0fd897703533ac05","entry":"FlowLayer","repo":"didriknielsen/argmax_flows","repo_kind":"official","path":"model/CategoricalNF/flows/mixture_cdf_layer.py","file_url":"https://github.com/didriknielsen/argmax_flows/blob/HEAD/model/CategoricalNF/flows/mixture_cdf_layer.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":"0fd897703533ac05"}},{"code_sha256_prefix":"790a25da85a326bc","entry":"MixtureCDFCoupling","repo":"didriknielsen/argmax_flows","repo_kind":"official","path":"model/CategoricalNF/flows/mixture_cdf_layer.py","file_url":"https://github.com/didriknielsen/argmax_flows/blob/HEAD/model/CategoricalNF/flows/mixture_cdf_layer.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":"790a25da85a326bc"}},{"code_sha256_prefix":"08aec1a58f72176a","entry":"MultinomialDiffusion","repo":"YuzheZhang-1999/DiffTSR","repo_kind":"listed","path":"model/TDM/models/diffusion_multinomial.py","file_url":"https://github.com/YuzheZhang-1999/DiffTSR/blob/HEAD/model/TDM/models/diffusion_multinomial.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":"08aec1a58f72176a"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}