{"id":13510729,"url":"https://github.com/chainer/chainer-chemistry","last_synced_at":"2025-04-13T07:48:48.253Z","repository":{"id":45811295,"uuid":"112321712","full_name":"chainer/chainer-chemistry","owner":"chainer","description":"Chainer Chemistry: A Library for Deep Learning in Biology and Chemistry","archived":false,"fork":false,"pushed_at":"2023-04-20T05:13:47.000Z","size":2388,"stargazers_count":662,"open_issues_count":31,"forks_count":132,"subscribers_count":53,"default_branch":"master","last_synced_at":"2025-04-13T07:48:39.413Z","etag":null,"topics":["biology","chainer","chemistry","deep-learning","graph-convolutional-networks","neural-network","python"],"latest_commit_sha":null,"homepage":"","language":"Python","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/chainer.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,"governance":null}},"created_at":"2017-11-28T10:35:09.000Z","updated_at":"2025-04-10T18:53:35.000Z","dependencies_parsed_at":"2023-01-23T11:15:15.222Z","dependency_job_id":"56cc1720-d78d-4977-88a1-787af14120b8","html_url":"https://github.com/chainer/chainer-chemistry","commit_stats":null,"previous_names":["pfnet-research/chainer-chemistry"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainer%2Fchainer-chemistry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainer%2Fchainer-chemistry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainer%2Fchainer-chemistry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chainer%2Fchainer-chemistry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chainer","download_url":"https://codeload.github.com/chainer/chainer-chemistry/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248681494,"owners_count":21144700,"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","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":["biology","chainer","chemistry","deep-learning","graph-convolutional-networks","neural-network","python"],"created_at":"2024-08-01T02:01:52.092Z","updated_at":"2025-04-13T07:48:48.223Z","avatar_url":"https://github.com/chainer.png","language":"Python","funding_links":[],"categories":["Python","chemistry","Machine Learning"],"sub_categories":[],"readme":"# Chainer Chemistry: A Library for Deep Learning in Biology and Chemistry\n\n[![PyPI](https://img.shields.io/pypi/v/chainer-chemistry.svg)](https://pypi.python.org/pypi/chainer-chemistry)\n[![GitHub license](https://img.shields.io/github/license/pfnet-research/chainer-chemistry.svg)](https://github.com/pfnet-research/chainer-chemistry/blob/master/LICENSE)\n[![travis](https://img.shields.io/travis/pfnet-research/chainer-chemistry/master.svg)](https://travis-ci.org/pfnet-research/chainer-chemistry)\n[![Read the Docs](https://readthedocs.org/projects/chainer-chemistry/badge/?version=latest)](http://chainer-chemistry.readthedocs.io/en/latest/?badge=latest)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/chainer-chemistry-overview.png\" alt=\"Chainer Chemistry Overview\" width=\"600\" /\u003e\n\u003c/p\u003e\n\nChainer Chemistry is a deep learning framework (based on Chainer) with\napplications in Biology and Chemistry. It supports various state-of-the-art\nmodels (especially GCNN - Graph Convolutional Neural Network) for chemical property prediction.\n\nFor more information, please refer to the [documentation](http://chainer-chemistry.readthedocs.io/en/latest/index.html).\nAlso, a quick introduction to deep learning for molecules and Chainer Chemistry\nis available [here](https://www.slideshare.net/KentaOono/deep-learning-for-molecules-introduction-to-chainer-chemistry-93288837).\n\n## Dependencies\n\nChainer Chemistry depends on the following packages:\n\n - [`chainer`](https://docs.chainer.org/en/stable/index.html)\n - [`pandas`](https://pandas.pydata.org)\n - [`scikit-learn`](http://scikit-learn.org/stable/)\n - [`tqdm`](https://pypi.python.org/pypi/tqdm)\n - [`h5py`](https://pypi.python.org/pypi/h5py)\n\nThese are automatically added to the system when installing the library via the\n`pip` command (see _Installation_). However, the following  needs to be\ninstalled manually:\n\n - [`rdkit (release 2019.03.2.0)`](https://github.com/rdkit/rdkit)\n\nPlease refer to the RDKit [documentation](http://www.rdkit.org/docs/Install.html)\nfor more information regarding the installation steps.\n\nNote that only the following versions of Chainer Chemistry's dependencies are\ncurrently supported:\n\n| Chainer Chemistry   | Chainer         | RDKit          | Python           |\n| ------------------: | --------------: | -------------: | ---------------: |\n| v0.1.0 ~ v0.3.0     | v2.0 ~ v3.0     | 2017.09.3.0    | 2.7, 3.5, 3.6    |\n| v0.4.0              | v3.0 ~ v4.0 *1  | 2017.09.3.0    | 2.7, 3.5, 3.6    |\n| v0.5.0              | v3.0 ~ v5.0 *2  | 2017.09.3.0    | 2.7, 3.5, 3.6    |\n| v0.6.0              | v6.0 ~      *3  | 2017.09.3.0    | 2.7, 3.5, 3.6    |\n| v0.7.0 ~ v0.7.1     | v7.0 ~          | 2019.03.2.0    | 3.6, 3.7      *4 |\n| master branch    *5 | v7.0 ~          | 2019.03.2.0    | 3.6, 3.7         |\n\n\n[Footnote]\n\n*1: We used `FunctionNode` in [this PR](https://github.com/pfnet-research/chainer-chemistry/pull/190),\nwhich is introduced after chainer v3. See [this issue](https://github.com/pfnet-research/chainer-chemistry/issues/192) for details.\n\n*2: Saliency modules only work after chainer v5.\n\n*3: Chainer v6 is released and [ChainerX](https://chainer.org/announcement/2018/12/03/chainerx.html) is newly introduced.\n    In order to support this new feature \u0026 API, we broke backward compatibility for chainer chemistry v0.6.0 release.\n    See [ChainerX Documentation](https://chainer.org/announcement/2018/12/03/chainerx.html) for details.\n\n*4: python 2.x support is dropped, following the same policy with `chainer` and `rdkit`.\n\n*5: As [announced in chainer blog](https://chainer.org/announcement/2019/12/05/released-v7.html),\n    further development will be limited to only serious bug-fixes and maintenance.\n\n## Installation\n\nChainer Chemistry can be installed using the `pip` command, as follows:\n\n```\npip install chainer-chemistry\n```\n\nExample to install rdkit with conda:\n```bash\n# newer conda version is necessary to install rdkit 2019.03.2.0\nconda install -n base conda==4.6.14\nconda install -c rdkit rdkit==2019.03.2.0\n```\n\nIf you would like to use the latest sources, please checkout the master branch\nand install with the following commands:\n\n```\ngit clone https://github.com/pfnet-research/chainer-chemistry.git\npip install -e chainer-chemistry\n```\n\n## Sample Code\n\nSample code is provided with this repository. This includes, but is not limited\nto, the following:\n\n- Training a new model on a given dataset\n- Performing inference on a given dataset, using a pretrained model\n- Evaluating and reporting performance metrics of different models on a given\ndataset\n\nPlease refer to the `examples` directory for more information.\n\n## Supported Models\n\nThe following graph convolutional neural networks are currently supported:\n\n- NFP: Neural Fingerprint [2, 3]\n- GGNN: Gated Graph Neural Network [4, 3]\n- WeaveNet [5, 3]\n- SchNet [6]\n- RSGCN: Renormalized Spectral Graph Convolutional Network [10]\u003cbr/\u003e\n \\* The name is not from the original paper - see [PR #89](https://github.com/pfnet-research/chainer-chemistry/pull/89) for the naming convention.\n- RelGCN: Relational Graph Convolutional Network [14]\n- GAT: Graph Attention Networks [15]\n- GIN: Graph Isomorphism Networks [17]\n- MPNN: Message Passing Neural Networks [3]\n- Set2Set [19]\n- GNN-FiLM: Graph Neural Networks with Feature-wise Linear Modulation [20]\n- MEGNet: MatErials Graph Network [24]\n- CGCNN: Crystal Graph Convolutional Neural Networks [25]\n\nWe test supporting the brand-new Graph Warp Module (GWM) [18]-attached models for:\n- NFP ('nfp_gwm')\n- GGNN ('ggnn_gwm')\n- RSGCN ('rsgcn_gwm')\n- GIN ('gin_gwm')\n\nIn the directory `examples/molnet_wle`, we have implemented the new preprocessing ''Weisfeiler-Lehman Embedding for Molecular Graph Neural Networks'' [26] for several GNN architectures. Please find the Readme in that directory for the usage and the details. \n\n## Supported Datasets\n\nThe following datasets are currently supported:\n\n### Chemical\n- QM9 [7, 8]\n- Tox21 [9]\n- MoleculeNet [11]\n- ZINC (only 250k dataset) [12, 13]\n- User (own) dataset\n\n### Network\n- cora [21]\n- citeseer [22]\n- reddit [23]\n\n## Research Projects\n\nIf you use Chainer Chemistry in your research, feel free to submit a\npull request and add the name of your project to this list:\n\n - BayesGrad: Explaining Predictions of Graph Convolutional Networks ([paper](https://arxiv.org/abs/1807.01985), [code](https://github.com/pfnet-research/bayesgrad))\n - Graph Warp Module: an Auxiliary Module for Boosting the Power of Graph Neural Networks ([paper](https://arxiv.org/abs/1902.01020), [code](https://github.com/k-ishiguro/chainer-chemistry/tree/gwm_for_CC))\n - GraphNVP: An Invertible Flow Model for Generating Molecular Graphs ([paper](https://arxiv.org/abs/1905.11600), [code](https://github.com/pfnet-research/graph-nvp))\n - Graph Residual Flow for Molecular Graph Generation ([paper](https://arxiv.org/abs/1909.13521))\n\n## Useful Links\n\nChainer Chemistry:\n\n - [Documentation](https://chainer-chemistry.readthedocs.io)\n - [Research Blog](https://preferredresearch.jp/2017/12/18/chainer-chemistry-beta-release/)\n\nOther Chainer frameworks:\n\n - [Chainer: A Flexible Framework of Neural Networks for Deep Learning](https://chainer.org/)\n - [ChainerRL: Deep Reinforcement Learning Library Built on Top of Chainer](https://github.com/chainer/chainerrl)\n - [ChainerCV: A Library for Deep Learning in Computer Vision](https://github.com/chainer/chainercv)\n - [ChainerMN: Scalable Distributed Deep Learning with Chainer](https://github.com/chainer/chainermn)\n - [ChainerUI: User Interface for Chainer](https://github.com/chainer/chainerui)\n\n## License\n\nThis project is released under the MIT License. Please refer to the\n[this page](https://github.com/pfnet-research/chainer-chemistry/blob/master/LICENSE)\nfor more information.\n\nPlease note that Chainer Chemistry is still in experimental development.\nWe continuously strive to improve its functionality and performance, but at\nthis stage we cannot guarantee the reproducibility of any results published in\npapers. Use the library at your own risk.\n\n\n## References\n\n[1] Seiya Tokui, Kenta Oono, Shohei Hido, and Justin Clayton. Chainer: a next-generation open source framework for deep learning. In *Proceedings of Workshop on Machine Learning Systems (LearningSys) in Advances in Neural Information Processing System (NIPS) 28*, 2015.\n\n[2] David K Duvenaud, Dougal Maclaurin, Jorge Iparraguirre, Rafael Bombarell, Timothy Hirzel, Alan Aspuru-Guzik, and Ryan P Adams. Convolutional networks on graphs for learning molecular fingerprints. In C. Cortes, N. D. Lawrence, D. D. Lee, M. Sugiyama, and R. Garnett, editors, *Advances in Neural Information Processing Systems (NIPS) 28*, pages 2224–2232. Curran Asso- ciates, Inc., 2015.\n\n[3] Justin Gilmer, Samuel S Schoenholz, Patrick F Riley, Oriol Vinyals, and George E Dahl. Neural message passing for quantum chemistry. *arXiv preprint arXiv:1704.01212*, 2017.\n\n[4] Yujia Li, Daniel Tarlow, Marc Brockschmidt, and Richard Zemel. Gated graph sequence neural networks. *arXiv preprint arXiv:1511.05493*, 2015.\n\n[5] Steven Kearnes, Kevin McCloskey, Marc Berndl, Vijay Pande, and Patrick Riley. Molecular graph convolutions: moving beyond fingerprints. *Journal of computer-aided molecular design*, 30(8):595–608, 2016.\n\n[6] Kristof Schütt, Pieter-Jan Kindermans, Huziel Enoc Sauceda Felix, Stefan Chmiela, Alexandre Tkatchenko, and Klaus-Rober Müller. Schnet: A continuous-filter convolutional neural network for modeling quantum interactions. In I. Guyon, U. V. Luxburg, S. Bengio, H. Wallach, R. Fergus, S. Vishwanathan, and R. Garnett, editors, *Advances in Neural Information Processing Systems (NIPS) 30*, pages 992–1002. Curran Associates, Inc., 2017.\n\n[7] Lars Ruddigkeit, Ruud Van Deursen, Lorenz C Blum, and Jean-Louis Reymond. Enumeration of 166 billion organic small molecules in the chemical universe database gdb-17. *Journal of chemical information and modeling*, 52(11):2864–2875, 2012.\n\n[8] Raghunathan Ramakrishnan, Pavlo O Dral, Matthias Rupp, and O Anatole Von Lilienfeld. Quantum chemistry structures and properties of 134 kilo molecules. *Scientific data*, 1:140022, 2014.\n\n[9] Ruili Huang, Menghang Xia, Dac-Trung Nguyen, Tongan Zhao, Srilatha Sakamuru, Jinghua Zhao, Sampada A Shahane, Anna Rossoshek, and Anton Simeonov. Tox21challenge to build predictive models of nuclear receptor and stress response pathways as mediated by exposure to environmental chemicals and drugs. *Frontiers in Environmental Science*, 3:85, 2016.\n\n[10] Kipf, Thomas N. and Welling, Max. Semi-Supervised Classification with Graph Convolutional Networks. *International Conference on Learning Representations (ICLR)*, 2017.\n\n[11] Zhenqin Wu, Bharath Ramsundar, Evan N. Feinberg, Joseph Gomes, Caleb Geniesse, Aneesh S. Pappu, Karl Leswing, Vijay Pande, MoleculeNet: A Benchmark for Molecular Machine Learning, arXiv preprint, arXiv: 1703.00564, 2017.\n\n[12] J. J. Irwin, T. Sterling, M. M. Mysinger, E. S. Bolstad, and R. G. Coleman. Zinc: a free tool to discover chemistry for biology. *Journal of chemical information and modeling*, 52(7):1757–1768, 2012.\n\n[13] Preprocessed csv file downloaded from https://raw.githubusercontent.com/aspuru-guzik-group/chemical_vae/master/models/zinc_properties/250k_rndm_zinc_drugs_clean_3.csv\n\n[14] Michael Schlichtkrull, Thomas N. Kipf, Peter Bloem, Rianne van den Berg, Ivan Titov, Max Welling. Modeling Relational Data with Graph Convolutional Networks. *Extended Semantic Web Conference (ESWC)*, 2018.\n\n[15] Veličković, P., Cucurull, G., Casanova, A., Romero, A., Liò, P., \u0026 Bengio, Y. (2017). Graph Attention Networks. arXiv preprint arXiv:1710.10903.\n\n[16] Dan Busbridge, Dane Sherburn, Pietro Cavallo and Nils Y. Hammerla. (2019). Relational Graph Attention Networks. https://openreview.net/forum?id=Bklzkh0qFm\n\n[17] Keyulu Xu, Weihua Hu, Jure Leskovec, Stefanie Jegelka, ``How Powerful are Graph Neural Networks?'', \tarXiv:1810.00826 [cs.LG], 2018 (to appear at ICLR19).\n\n[18] K. Ishiguro, S. Maeda, and M. Koyama, ``Graph Warp Module: an Auxiliary Module for Boosting the Power of Graph Neural Networks'', arXiv:1902.01020 [cs.LG], 2019.\n\n[19] Oriol Vinyals, Samy Bengio, Manjunath Kudlur. Order Matters: Sequence to sequence for sets. *arXiv preprint arXiv:1511.06391*, 2015.\n\n[20] Marc Brockschmidt, ``GNN-FiLM: Graph Neural Networks with Feature-wise Linear Modulation'', arXiv:1906.12192 [cs.ML], 2019.\n\n[21] McCallum, Andrew Kachites and Nigam, Kamal and Rennie, Jason and Seymore, Kristie, Automating the Construction of Internet Portals with Machine Learning. *Information Retrieval*, 2000.\n\n[22] C. Lee Giles and Kurt D. Bollacker and Steve Lawrence, CiteSeer: An Automatic Citation Indexing System. *Proceedings of the Third ACM Conference on Digital Libraries*, 1998.\n\n[23] William L. Hamilton and Zhitao Ying and Jure Leskovec, Inductive Representation Learning on Large Graphs. *Advances in Neural Information Processing Systems 30: Annual Conference on Neural Information Processing Systems 2017, 4-9 December 2017*\n\n[24] Chi Chen, Weike Ye, Yunxing Zuo, Chen Zheng, and Shyue Ping Ong. Graph networks as a universal machine learning framework for molecules and crystals. *Chemistry of Materials*, 31(9):3564–3572, 2019.\n\n[25] Tian Xie and Jeffrey C Grossman. Crystal graph convolutional neural networks for an accurate and interpretable prediction of material properties. *Physical review letters*, 120(14):145301, 2018.\n\n[26] Katsuhiko Ishiguro, Kenta Oono, and Kohei Hayashi, \"Weisfeiler-Lehman Embedding for Molecular Graph Neural Networks\", arXiv: 2006.06909, 2020. [paper link](https://arxiv.org/abs/2006.06909)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainer%2Fchainer-chemistry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchainer%2Fchainer-chemistry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchainer%2Fchainer-chemistry/lists"}