{"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/infusing-self-consistency-into-density","title":"Infusing Self-Consistency into Density Functional Theory Hamiltonian Prediction via Deep Equilibrium Models","arxiv_id":"2406.03794","date":"2024-06-06","proceeding":null,"authors":["Zun Wang","Chang Liu","Nianlong Zou","He Zhang","Xinran Wei","Lin Huang","Lijun Wu","Bin Shao"],"abstract":"In this study, we introduce a unified neural network architecture, the Deep Equilibrium Density Functional Theory Hamiltonian (DEQH) model, which incorporates Deep Equilibrium Models (DEQs) for predicting Density Functional Theory (DFT) Hamiltonians. The DEQH model inherently captures the self-consistency nature of Hamiltonian, a critical aspect often overlooked by traditional machine learning approaches for Hamiltonian prediction. By employing DEQ within our model architecture, we circumvent the need for DFT calculations during the training phase to introduce the Hamiltonian's self-consistency, thus addressing computational bottlenecks associated with large or complex systems. We propose a versatile framework that combines DEQ with off-the-shelf machine learning models for predicting Hamiltonians. When benchmarked on the MD17 and QH9 datasets, DEQHNet, an instantiation of the DEQH framework, has demonstrated a significant improvement in prediction accuracy. Beyond a predictor, the DEQH model is a Hamiltonian solver, in the sense that it uses the fixed-point solving capability of the deep equilibrium model to iteratively solve for the Hamiltonian. Ablation studies of DEQHNet further elucidate the network's effectiveness, offering insights into the potential of DEQ-integrated networks for Hamiltonian learning. We open source our implementation at https://github.com/Zun-Wang/DEQHNet.","url_abs":"https://arxiv.org/abs/2406.03794v2","url_pdf":"https://arxiv.org/pdf/2406.03794v2.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":"infusing-self-consistency-into-density","repo_url":"https://github.com/zun-wang/deqhnet","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":0,"framework":"pytorch","reach":{"status":"ok"}}],"tasks":[],"methods":[{"method_slug":"deq","method_name":"DEQ"}],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"syntology_url":null,"atlas_url":"https://app.syntology.ai/?focus=2406.03794","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2406.03794"}},"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/zun-wang/deqhnet","reach":{"status":"ok"}}],"summary":{"ran":7,"ran_draft_wrong":1,"ran_violates":2,"unverified":4},"by_repo_kind":{"official":{"samples":14,"ran":10,"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":14,"samples":[{"code_sha256_prefix":"c422c2e285c20f77","entry":"AO2Irreps","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/utils.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"c422c2e285c20f77"}},{"code_sha256_prefix":"5769828f592d2d69","entry":"ShiftedSoftPlus","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/models/DEQHNet.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/models/DEQHNet.py","link_basis":"plan_row","language":"python","status":"ran_draft_wrong","verification_level":1,"contract_check":"MISDECLARED","metamorphic_tier":"invariant","behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"5769828f592d2d69"}},{"code_sha256_prefix":"e0be8786de302cc4","entry":"criterion","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/train_wH.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/train_wH.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"e0be8786de302cc4"}},{"code_sha256_prefix":"f0105cb3f2e081c2","entry":"cutoff_function","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/models/functional.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/models/functional.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"f0105cb3f2e081c2"}},{"code_sha256_prefix":"13fe93dcab714714","entry":"get_mask","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/ori_dataset.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/ori_dataset.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"13fe93dcab714714"}},{"code_sha256_prefix":"72ee1e50041dc3a9","entry":"get_nonlinear","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHBench/QH9/models/utils.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHBench/QH9/models/utils.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"72ee1e50041dc3a9"}},{"code_sha256_prefix":"b0aeca26969b9a56","entry":"prod","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/models/DEQHNet.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/models/DEQHNet.py","link_basis":"plan_row","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":"well_formed","behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"b0aeca26969b9a56"}},{"code_sha256_prefix":"8a8c9b4681d48279","entry":"shifted_softplus","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/models/functional.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/models/functional.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"8a8c9b4681d48279"}},{"code_sha256_prefix":"bc43b93c22207f08","entry":"softplus_inverse","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/models/DEQHNet.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/models/DEQHNet.py","link_basis":"plan_row","language":"python","status":"ran_violates","verification_level":1,"contract_check":"VIOLATES","metamorphic_tier":"invariant","behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"bc43b93c22207f08"}},{"code_sha256_prefix":"9c5473293e4b62b7","entry":"switch_function","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/models/functional.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/models/functional.py","link_basis":"first_harvest_node","language":"python","status":"ran","verification_level":1,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":true,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"9c5473293e4b62b7"}},{"code_sha256_prefix":"98fd43d9c39ef1ed","entry":"matrix_transform","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/ori_dataset.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/ori_dataset.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":"98fd43d9c39ef1ed"}},{"code_sha256_prefix":"2c1722ba08fcc718","entry":"random_split","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/ori_dataset.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/ori_dataset.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":"2c1722ba08fcc718"}},{"code_sha256_prefix":"d530dac441249dac","entry":"train_one_batch","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/train_wH.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/train_wH.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":"d530dac441249dac"}},{"code_sha256_prefix":"0781eabc1d9cb6e3","entry":"validation_dataset","repo":"zun-wang/deqhnet","repo_kind":"official","path":"src/QHNet/train_wH.py","file_url":"https://github.com/zun-wang/deqhnet/blob/HEAD/src/QHNet/train_wH.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":"0781eabc1d9cb6e3"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}