{"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/a-practical-recipe-for-federated-learning","title":"A Practical Recipe for Federated Learning Under Statistical Heterogeneity Experimental Design","arxiv_id":"2307.15245","date":"2023-07-28","proceeding":null,"authors":["Mahdi Morafah","Weijia Wang","Bill Lin"],"abstract":"Federated Learning (FL) has been an area of active research in recent years. There have been numerous studies in FL to make it more successful in the presence of data heterogeneity. However, despite the existence of many publications, the state of progress in the field is unknown. Many of the works use inconsistent experimental settings and there are no comprehensive studies on the effect of FL-specific experimental variables on the results and practical insights for a more comparable and consistent FL experimental setup. Furthermore, the existence of several benchmarks and confounding variables has further complicated the issue of inconsistency and ambiguity. In this work, we present the first comprehensive study on the effect of FL-specific experimental variables in relation to each other and performance results, bringing several insights and recommendations for designing a meaningful and well-incentivized FL experimental setup. We further aid the community by releasing FedZoo-Bench, an open-source library based on PyTorch with pre-implementation of 22 state-of-the-art methods, and a broad set of standardized and customizable features available at https://github.com/MMorafah/FedZoo-Bench. We also provide a comprehensive comparison of several state-of-the-art (SOTA) methods to better understand the current state of the field and existing limitations.","url_abs":"https://arxiv.org/abs/2307.15245v1","url_pdf":"https://arxiv.org/pdf/2307.15245v1.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":"a-practical-recipe-for-federated-learning","repo_url":"https://github.com/mmorafah/fedzoo-bench","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":0,"framework":"pytorch","reach":{"status":"ok","spdx":"MIT"}}],"tasks":[{"task_slug":"experimental-design","task_name":"Experimental Design"},{"task_slug":"federated-learning","task_name":"Federated Learning"}],"methods":[{"method_slug":null,"method_name":"Library"}],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"syntology_url":"https://syntology.ai/paper/2307.15245","atlas_url":"https://app.syntology.ai/?focus=2307.15245","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2307.15245"}},"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":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/mmorafah/fedzoo-bench","reach":{"status":"ok","spdx":"MIT"}}],"summary":{"unverified":12},"by_repo_kind":{"official":{"samples":12,"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":0,"samples":[{"code_sha256_prefix":"797c8119ed0a665f","entry":"main_apfl","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_apfl.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_apfl.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":"797c8119ed0a665f"}},{"code_sha256_prefix":"66da68096c279bbd","entry":"main_centralized","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_centralized.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_centralized.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":"66da68096c279bbd"}},{"code_sha256_prefix":"18bb5e727cff8124","entry":"main_cfl","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_cfl.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_cfl.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":"18bb5e727cff8124"}},{"code_sha256_prefix":"9d0706c7eb36ff57","entry":"main_ditto","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_ditto.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_ditto.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":"9d0706c7eb36ff57"}},{"code_sha256_prefix":"968eaad6650615c3","entry":"main_fedavg","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_fedavg.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_fedavg.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":"968eaad6650615c3"}},{"code_sha256_prefix":"5222423c65020a53","entry":"main_fedbn","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_fedbn.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_fedbn.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":"5222423c65020a53"}},{"code_sha256_prefix":"dd0cdba97be38f01","entry":"main_feddf","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_feddf.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_feddf.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":"dd0cdba97be38f01"}},{"code_sha256_prefix":"1670e82cdac01a0d","entry":"main_feddyn","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_feddyn.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_feddyn.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":"1670e82cdac01a0d"}},{"code_sha256_prefix":"18324f8f92c49118","entry":"main_fedem","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_fedem.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_fedem.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":"18324f8f92c49118"}},{"code_sha256_prefix":"38775ed0f1590c65","entry":"main_fednova","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_fednova.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_fednova.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":"38775ed0f1590c65"}},{"code_sha256_prefix":"fe09960f05b729b9","entry":"main_fedper","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_fedper.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_fedper.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":"fe09960f05b729b9"}},{"code_sha256_prefix":"aaf2d651afae6e95","entry":"main_fedprox","repo":"mmorafah/fedzoo-bench","repo_kind":"official","path":"src/benchmarks/main_fedprox.py","file_url":"https://github.com/mmorafah/fedzoo-bench/blob/HEAD/src/benchmarks/main_fedprox.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":"aaf2d651afae6e95"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}