{"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/on-the-convergence-of-clustered-federated","title":"On the Convergence of Clustered Federated Learning","arxiv_id":"2202.06187","date":"2022-02-13","proceeding":null,"authors":["Jie Ma","Guodong Long","Tianyi Zhou","Jing Jiang","Chengqi Zhang"],"abstract":"Knowledge sharing and model personalization are essential components to tackle the non-IID challenge in federated learning (FL). Most existing FL methods focus on two extremes: 1) to learn a shared model to serve all clients with non-IID data, and 2) to learn personalized models for each client, namely personalized FL. There is a trade-off solution, namely clustered FL or cluster-wise personalized FL, which aims to cluster similar clients into one cluster, and then learn a shared model for all clients within a cluster. This paper is to revisit the research of clustered FL by formulating them into a bi-level optimization framework that could unify existing methods. We propose a new theoretical analysis framework to prove the convergence by considering the clusterability among clients. In addition, we embody this framework in an algorithm, named Weighted Clustered Federated Learning (WeCFL). Empirical analysis verifies the theoretical results and demonstrates the effectiveness of the proposed WeCFL under the proposed cluster-wise non-IID settings.","url_abs":"https://arxiv.org/abs/2202.06187v2","url_pdf":"https://arxiv.org/pdf/2202.06187v2.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":"on-the-convergence-of-clustered-federated","repo_url":"https://github.com/jie-ma-ai/FedBase/blob/main/fedbase/baselines/wecfl.py","is_official":1,"mentioned_in_paper":0,"mentioned_in_github":0,"framework":"pytorch","reach":{"status":"ok","spdx":"MIT"}}],"tasks":[{"task_slug":"federated-learning","task_name":"Federated Learning"}],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"syntology_url":"https://syntology.ai/paper/2202.06187","atlas_url":"https://app.syntology.ai/?focus=2202.06187","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2202.06187"}},"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/jie-ma-ai/FedBase/blob/main/fedbase/baselines/wecfl.py","reach":{"status":"ok","spdx":"MIT"}}],"summary":{"ran":1,"ran_draft_wrong":2,"unverified":3},"by_repo_kind":{"official":{"samples":6,"ran":3,"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":"ae1e2b2d017d9af0","entry":"blackbox_mc","repo":"jie-ma-ai/FedBase","repo_kind":"official","path":"fedbase/utils/model_utils.py","file_url":"https://github.com/jie-ma-ai/FedBase/blob/HEAD/fedbase/utils/model_utils.py","link_basis":"harvester_set","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":"ae1e2b2d017d9af0"}},{"code_sha256_prefix":"d9def42110729a85","entry":"conv1x1","repo":"jie-ma-ai/FedBase","repo_kind":"official","path":"fedbase/model/resnet.py","file_url":"https://github.com/jie-ma-ai/FedBase/blob/HEAD/fedbase/model/resnet.py","link_basis":"harvester_set","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":"deterministic","behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"d9def42110729a85"}},{"code_sha256_prefix":"160bb14bd76201b4","entry":"conv3x3","repo":"jie-ma-ai/FedBase","repo_kind":"official","path":"fedbase/model/resnet.py","file_url":"https://github.com/jie-ma-ai/FedBase/blob/HEAD/fedbase/model/resnet.py","link_basis":"harvester_set","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"OUTPUT_MISDECLARED","metamorphic_tier":"deterministic","behaviour_fingerprint":false,"licence":"MIT","inline_ok":true,"mcp_get_code":{"code_sha256":"160bb14bd76201b4"}},{"code_sha256_prefix":"1c44445eed1fe5bd","entry":"load_checkpoint","repo":"jie-ma-ai/FedBase","repo_kind":"official","path":"fedbase/utils/model_utils.py","file_url":"https://github.com/jie-ma-ai/FedBase/blob/HEAD/fedbase/utils/model_utils.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":"1c44445eed1fe5bd"}},{"code_sha256_prefix":"d9637905b644bd69","entry":"resnet18","repo":"jie-ma-ai/FedBase","repo_kind":"official","path":"fedbase/model/resnet.py","file_url":"https://github.com/jie-ma-ai/FedBase/blob/HEAD/fedbase/model/resnet.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":"d9637905b644bd69"}},{"code_sha256_prefix":"67933efee7675d5f","entry":"similarity","repo":"jie-ma-ai/FedBase","repo_kind":"official","path":"fedbase/utils/model_utils.py","file_url":"https://github.com/jie-ma-ai/FedBase/blob/HEAD/fedbase/utils/model_utils.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":"67933efee7675d5f"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}