{"id":35313720,"url":"https://github.com/mhoffman/dbmi","last_synced_at":"2026-05-21T02:01:19.225Z","repository":{"id":25962420,"uuid":"29404296","full_name":"mhoffman/dbmi","owner":"mhoffman","description":"This python module implements an approximate theory for calculating adsorbate-adsorbate interactions based on relative shifts of d-band center. Currently only works with files from QuantumEspresso calculations using the ase-espresso interface of ASE.","archived":false,"fork":false,"pushed_at":"2015-12-11T23:34:53.000Z","size":47,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-03-28T04:35:35.605Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mhoffman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-01-17T20:18:54.000Z","updated_at":"2021-01-29T00:38:16.000Z","dependencies_parsed_at":"2022-07-09T15:17:45.257Z","dependency_job_id":null,"html_url":"https://github.com/mhoffman/dbmi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mhoffman/dbmi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhoffman%2Fdbmi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhoffman%2Fdbmi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhoffman%2Fdbmi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhoffman%2Fdbmi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mhoffman","download_url":"https://codeload.github.com/mhoffman/dbmi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mhoffman%2Fdbmi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33284873,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-20T15:12:43.734Z","status":"online","status_checked_at":"2026-05-21T02:00:07.181Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-30T18:12:10.796Z","updated_at":"2026-05-21T02:01:19.213Z","avatar_url":"https://github.com/mhoffman.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dbmi\n\n(*d-band mediated interactions*)\n\nThis python module implements an approximate theory for calculating spatially resolved adsorbate-adsorbate interactions based on relative shifts of different d-band centers.\n\nAs input it requires one DFT calculation with accompanying projected density of states for each: the empty (clean) substrate surface (primitive surface unit cell), an optimized adsorbate geometry in the low coverage limit (i.e. 3x3 - 6x6) surface slab and an optimized geometry of the high coverage limit (i.e. 1x1 or 2x2 overlayer). So far the surface are limited to those where the primitive surface unit cell consists of only one surface atom ((100), (110), or (111)). Currently only works with files from QuantumEspresso calculations using the [ase-espresso](https://github.com/vossjo/ase-espresso) interface of [ASE](https://wiki.fysik.dtu.dk/ase/).\n\n\nVery experimental, work in progress. Also needs a patched version of [ase-espresso](https://github.com/vossjo/ase-espresso), drop me a line or check back later.\n\n# Usage\n\nThere are currently only two functions that do useful work:\n\n    def collect_interaction_data(surface_name, adsorbate_name, site_name,\n                             clean_surface_logfile, clean_surface_dosfile,\n                             locov_logfile, locov_dosfile,\n                             hicov_logfile, hicov_dosfile,\n                             verbose=False,\n                             spinpol=False,\n                             adsorbate_species=['C', 'H', 'O', 'N'],\n                             surface_tol=1.,\n                             )\n\n    def calculate_interaction_energy(interactions, adsorbates, IR=4, pbc=None, verbose=False)\n\nThe function `collect_interaction_data` will collect all needed information from finished QuantumEspresso calculations. It requires that the projected density of states is found in a file as produced by the [ase-espresso](https://github.com/vossjo/ase-espresso) interface. The returned dictionary can be used for many different lateral interaction situations. `dbmi.merge(dict1, dict2)` can be used to merge the lateral interaction coefficients from two or more adsorbates. It may be useful to store it somewhere.\n\nThe function `calculate_interaction_energy` returns the full (a.ka. integrated) interaction energy. `interaction` is the dictionary containing all interaction coefficients, the `adsorbates` argument is a list of element of the form `[surface, molecule, site, cell_x, cell_y]`. The `pbc` parameter can be used to evaluate the adsorbates on a finite lattice wrapping around periodic boundaries in all directions. If no `pbc` is supplied an inifinite lattice is assumed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhoffman%2Fdbmi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmhoffman%2Fdbmi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmhoffman%2Fdbmi/lists"}