{"id":19274632,"url":"https://github.com/kjappelbaum/oximachine_featurizer","last_synced_at":"2025-08-02T21:34:17.062Z","repository":{"id":48403605,"uuid":"203357346","full_name":"kjappelbaum/oximachine_featurizer","owner":"kjappelbaum","description":"featurizing MOFs for the oximachine","archived":false,"fork":false,"pushed_at":"2024-02-08T11:43:55.000Z","size":74754,"stargazers_count":7,"open_issues_count":7,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-25T05:23:27.183Z","etag":null,"topics":["csd","machine-learning","mofs","oxidation-states","oximachine"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kjappelbaum.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-08-20T10:54:12.000Z","updated_at":"2024-09-02T03:35:40.000Z","dependencies_parsed_at":"2023-02-08T18:31:22.702Z","dependency_job_id":"b19c8132-b5c6-405e-bbe2-47b85cd89b59","html_url":"https://github.com/kjappelbaum/oximachine_featurizer","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/kjappelbaum/oximachine_featurizer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjappelbaum%2Foximachine_featurizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjappelbaum%2Foximachine_featurizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjappelbaum%2Foximachine_featurizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjappelbaum%2Foximachine_featurizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kjappelbaum","download_url":"https://codeload.github.com/kjappelbaum/oximachine_featurizer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kjappelbaum%2Foximachine_featurizer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268456847,"owners_count":24253299,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"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":["csd","machine-learning","mofs","oxidation-states","oximachine"],"created_at":"2024-11-09T20:46:46.933Z","updated_at":"2025-08-02T21:34:17.033Z","avatar_url":"https://github.com/kjappelbaum.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# oximachine_featurizer\n\n[![Actions Status](https://github.com/kjappelbaum/mof_oxidation_states/workflows/Python%20package/badge.svg)](https://github.com/kjappelbaum/mof_oxidation_states/actions)\n[![Documentation Status](https://readthedocs.org/projects/oximachine-featurizer/badge/?version=latest)](https://oximachine-featurizer.readthedocs.io/en/latest/?badge=latest)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3567274.svg)](https://doi.org/10.5281/zenodo.3567274)\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/kjappelbaum/oximachine_featurizer/main?filepath=examples%2Fexample.ipynb)\n[![codecov](https://codecov.io/gh/kjappelbaum/oximachine_featurizer/branch/main/graph/badge.svg)](https://codecov.io/gh/kjappelbaum/oximachine_featurizer)\n\nMine oxidation states for structures from the (MOF) subset of the CSD and calculate features for them. Runscripts are automatically installed for the most important steps. Some of these runscripts contain hard coded paths, that would need to be updated.\nThis code generates inputs that can be used with the [learnmofox package](https://github.com/kjappelbaum/learn_mof_ox_state.git) to replicate our work [1].\n\nIf you're just interested in using a pre-trained model, the [oximachinerunner](https://github.com/kjappelbaum/oximachinerunner) package.\n\n\u003e ⚠️ **Warning**: For the mining of the oxidation states, you need the CSD Python API.\n\u003e You need to export the `CSD_HOME` path. Due to the licensing issues, this cannot be done automatically.\n\n## Installation\n\nThe commands below automatically install several command-line tools (CLI) which are detailed below.\n\nThe full process should take some seconds.\n\n### Latest version\n\nTo install the latest version of the software with all dependencies, you can use\n\n```bash\npip install git+https://github.com/kjappelbaum/oximachine_featurizer.git\n```\n\n### Stable release\n\n```bash\npip install oximachine_featurizer\n```\n\n## How to use it\n\nTo run the default featurization on one structure you can use the CLI\n\n```bash\nrun_featurization \u003cstructure\u003e \u003coutdir\u003e\n```\n\nfor each metal center this should take seconds if there is no disorder.\n\nSome output can be found on the [MaterialsCloud Archive (doi: 10.24435/materialscloud:2019.0085/v1 )](https://doi.org/10.24435/materialscloud:2019.0085/v1).\n\nMore details can be found in the [documentation](https://oximachine-featurizer.readthedocs.io/en/latest/).\n\n## Example usage\n\nThe use of the main functions of this package is shown in the Jupyter Notebook in the example directory.\nIt contains some example structures and the output, which should be produces in seconds.\n\n## Testing the installation\n\nFor testing, you can---as it is done for the continuous integration (CI)---use `pytest` and run the files in the `test` directory. For example\n\n```(bash)\npip install pytest\npytest test/main\n```\n\n\n## References\n\n[1] Jablonka, Kevin Maik; Ongari, Daniele; Moosavi, Seyed Mohamad; Smit, Berend (2020): Using Collective Knowledge to Assign Oxidation States. ChemRxiv. Preprint. https://doi.org/10.26434/chemrxiv.11604129.v1\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkjappelbaum%2Foximachine_featurizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkjappelbaum%2Foximachine_featurizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkjappelbaum%2Foximachine_featurizer/lists"}