{"id":32178006,"url":"https://github.com/openforcefield/cmiles","last_synced_at":"2026-02-18T22:02:26.894Z","repository":{"id":51329980,"uuid":"142616856","full_name":"openforcefield/cmiles","owner":"openforcefield","description":"Generate canonical molecule identifiers for quantum chemistry database","archived":false,"fork":false,"pushed_at":"2021-05-17T14:52:01.000Z","size":15815,"stargazers_count":23,"open_issues_count":20,"forks_count":7,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-10-21T20:47:57.774Z","etag":null,"topics":["cheminformatics","database","forcefield","forcefield-parameterization","quantum-chemistry"],"latest_commit_sha":null,"homepage":"https://cmiles.readthedocs.io","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/openforcefield.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":"2018-07-27T19:37:26.000Z","updated_at":"2022-12-20T19:21:50.000Z","dependencies_parsed_at":"2022-09-09T23:21:50.281Z","dependency_job_id":null,"html_url":"https://github.com/openforcefield/cmiles","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/openforcefield/cmiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openforcefield%2Fcmiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openforcefield%2Fcmiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openforcefield%2Fcmiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openforcefield%2Fcmiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openforcefield","download_url":"https://codeload.github.com/openforcefield/cmiles/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openforcefield%2Fcmiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29596331,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T20:59:56.587Z","status":"ssl_error","status_checked_at":"2026-02-18T20:58:41.434Z","response_time":162,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cheminformatics","database","forcefield","forcefield-parameterization","quantum-chemistry"],"created_at":"2025-10-21T20:44:57.229Z","updated_at":"2026-02-18T22:02:26.889Z","avatar_url":"https://github.com/openforcefield.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"## CMILES is no longer actively maintained\n\nAs of May 2021, CMILES is no longer being actively maintained. Most of its essential functionality\nhas been migrated to the [Open Force Field Toolkit](https://github.com/openforcefield/openff-toolkit/) \nand [QCSubmit](https://github.com/openforcefield/openff-qcsubmit/) packages. \n\nAPI points that handle former CMILES functions in these packages include:\n\n* [openff.toolkit.toplogy.Molecule.to_smiles](https://open-forcefield-toolkit.readthedocs.io/en/latest/api/generated/openff.toolkit.topology.Molecule.html#openff.toolkit.topology.Molecule.to_smiles) with the `mapped=True` keyword argument\n* [openff.toolkit.topology.Molecule.from_mapped_smiles](https://open-forcefield-toolkit.readthedocs.io/en/latest/api/generated/openff.toolkit.topology.Molecule.html#openff.toolkit.topology.Molecule.from_mapped_smiles)\n* [openff.toolkit.topology.Molecule.from_qcschema](https://open-forcefield-toolkit.readthedocs.io/en/latest/api/generated/openff.toolkit.topology.Molecule.html#openff.toolkit.topology.Molecule.from_qcschema)\n* And the [openff-qcsubmit dataset class](https://openforcefield.github.io/openff-qcsubmit/datasets/) \n\ncmiles\n==============================\n[//]: # (Badges)\n[![CI Status](https://github.com/openforcefield/cmiles/workflows/CI/badge.svg)](https://github.com/openforcefield/cmiles/actions?query=branch%3Amaster+workflow%3ACI) \n[![codecov](https://codecov.io/gh/openforcefield/cmiles/branch/master/graph/badge.svg)](https://codecov.io/gh/openforcefield/cmiles/branch/master)\n[![Documentation Status](https://readthedocs.org/projects/cmiles/badge/?version=latest)](https://cmiles.readthedocs.io/en/latest/?badge=latest)\n\n\nGenerate canonical identifiers for chemical databases, specifically quantum\nchemical data. \n \ncmiles seeks to address several issues:\n\n1. *Link the QC molecule to its cheminformatics molecular graph to make QC data\nuseful to the force field and machine learning communities.*  \n    A QC molecule is identified by its elements and geometry. Each conformer\n    is considered a separate molecule. However, from a cheminformatics perspective,\n    the connectivity graph is the identity of the molecule. \n2. *Canonical identifiers.*      \n    When indexing a chemical database, it is crucial that the identifier\n    is canonical to reduce redundancy and search failures.  \n    **Problem**:  \n    Each toolkit has its own canonicalization algorithm. This algorithm may\n    change in different versions of the toolkit.   \n    **Solution**:  \n    Distribute cmiles as a Docker image with pinned dependencies.  \n  \n3. *Canonical order of QC geometry.*   \n    Since QC molecules are identified by their elements and geometry, canonical\n    atomic order can reduce redundancy.  \n    **Problem**:  \n    In cheminformatics toolkits, the order of atoms in a molecular graph are arbitrary.\n     Therefore, every time you generate a new molecular graph, the order of the atoms can change.  \n    **Solution**:  \n    Use the toolkits canonical atomic ranking to generate a SMILES string that has\n    explicit hydrogens and map indices that correspond to the canonical atomic ranking.\n    Then, this mapped SMILES can be used as a SMARTS pattern to find the mapping of\n    a molecular graph's these map indices to atomic indices. This map is then used\n    to generate canonical order for the xyz coordinates and symbols in the QC molecule.\n    `cmiles.utils` provides functions that will do this.   \n    In addition, the mapped SMILES ensure that all molecular graphs generated can be mapped\n    to QC geometries if those geometries are in the order of the map.   \n    \n4. *Standardize compounds*    \n    Provide an index to find all protomers of a molecule.  \n    **Problem**:  \n    Different protomeric states are different QC molecules. However, sometimes all\n    protomers and / tautomers of a molecule are needed. SMILES strings are different\n    for each protomer. While InChI standardizes molecular charge states, it only\n    standardize the tautomers it recognizes and not others. Some tautomers\n    it does not capture are keto-enol and enamine-imine.\n    \n    `cmiles` does not yet offer a full solution. Currently it provides the InChI, the\n    [unique protomer from openeye](https://docs.eyesopen.com/toolkits/python/quacpactk/OEProtonFunctions/OEGetUniqueProtomer.html)\n    and `MolStandardize` from rdkit. rdkit's solution only addresses tautomers of the \n    same charge states and openeye's solution does not capture indoles, isoindoles and \n    some mesomers. However, the union of these identifiers captures more than each individual solution. \n    \n    \n#### How to use cmiles\n`cmiles` has one main function, `to_molecule_id(molecule)` This \nfunction returns a dictionary with 10 identifiers generated with either OpenEye\nor RDKit. \n\n1. Canonical SMILES\n2. Canonical, isomeric SMILES\n3. Canonical, isomeric, explicit hydrogen SMILES\n4. Canonical, explicit hydrogen SMILES\n5. Canonical, isomeric, explicit hydrogen, mapped SMILES.\n6. Molecular formula in Hill notation\n7. InChI\n8. InChIKey\n9. unique protomer SMILES\n10. Standardized tautomer SMILES\n\n`cmiles.utils` provides functions to generate atom maps and map ordered geometries.\n\n### Dependencies\nOne of the following cheminformatics toolkits:  \n* openeye  \n* rdkit  \n\n### Copyright\n\nCopyright (c) 2018, Chaya D. Stern\n\n\n#### Acknowledgements\n \nProject based on the \n[Computational Chemistry Python Cookiecutter](https://github.com/choderalab/cookiecutter-python-comp-chem)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenforcefield%2Fcmiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenforcefield%2Fcmiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenforcefield%2Fcmiles/lists"}