├── .gitignore ├── Chain_of_Images.pdf ├── LICENSE ├── README.md ├── coi_cot.png ├── dataset └── ogbg_hiv.py └── demo.jpg /.gitignore: -------------------------------------------------------------------------------- 1 | # Byte-compiled / optimized / DLL files 2 | __pycache__/ 3 | *.py[cod] 4 | *$py.class 5 | 6 | # C extensions 7 | *.so 8 | 9 | # Distribution / packaging 10 | .Python 11 | build/ 12 | develop-eggs/ 13 | dist/ 14 | downloads/ 15 | eggs/ 16 | .eggs/ 17 | lib/ 18 | lib64/ 19 | parts/ 20 | sdist/ 21 | var/ 22 | wheels/ 23 | share/python-wheels/ 24 | *.egg-info/ 25 | .installed.cfg 26 | *.egg 27 | MANIFEST 28 | 29 | # PyInstaller 30 | # Usually these files are written by a python script from a template 31 | # before PyInstaller builds the exe, so as to inject date/other infos into it. 32 | *.manifest 33 | *.spec 34 | 35 | # Installer logs 36 | pip-log.txt 37 | pip-delete-this-directory.txt 38 | 39 | # Unit test / coverage reports 40 | htmlcov/ 41 | .tox/ 42 | .nox/ 43 | .coverage 44 | .coverage.* 45 | .cache 46 | nosetests.xml 47 | coverage.xml 48 | *.cover 49 | *.py,cover 50 | .hypothesis/ 51 | .pytest_cache/ 52 | cover/ 53 | 54 | # Translations 55 | *.mo 56 | *.pot 57 | 58 | # Django stuff: 59 | *.log 60 | local_settings.py 61 | db.sqlite3 62 | db.sqlite3-journal 63 | 64 | # Flask stuff: 65 | instance/ 66 | .webassets-cache 67 | 68 | # Scrapy stuff: 69 | .scrapy 70 | 71 | # Sphinx documentation 72 | docs/_build/ 73 | 74 | # PyBuilder 75 | .pybuilder/ 76 | target/ 77 | 78 | # Jupyter Notebook 79 | .ipynb_checkpoints 80 | 81 | # IPython 82 | profile_default/ 83 | ipython_config.py 84 | 85 | # pyenv 86 | # For a library or package, you might want to ignore these files since the code is 87 | # intended to run in multiple environments; otherwise, check them in: 88 | # .python-version 89 | 90 | # pipenv 91 | # According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control. 92 | # However, in case of collaboration, if having platform-specific dependencies or dependencies 93 | # having no cross-platform support, pipenv may install dependencies that don't work, or not 94 | # install all needed dependencies. 95 | #Pipfile.lock 96 | 97 | # poetry 98 | # Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control. 99 | # This is especially recommended for binary packages to ensure reproducibility, and is more 100 | # commonly ignored for libraries. 101 | # https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control 102 | #poetry.lock 103 | 104 | # pdm 105 | # Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control. 106 | #pdm.lock 107 | # pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it 108 | # in version control. 109 | # https://pdm.fming.dev/#use-with-ide 110 | .pdm.toml 111 | 112 | # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm 113 | __pypackages__/ 114 | 115 | # Celery stuff 116 | celerybeat-schedule 117 | celerybeat.pid 118 | 119 | # SageMath parsed files 120 | *.sage.py 121 | 122 | # Environments 123 | .env 124 | .venv 125 | env/ 126 | venv/ 127 | ENV/ 128 | env.bak/ 129 | venv.bak/ 130 | 131 | # Spyder project settings 132 | .spyderproject 133 | .spyproject 134 | 135 | # Rope project settings 136 | .ropeproject 137 | 138 | # mkdocs documentation 139 | /site 140 | 141 | # mypy 142 | .mypy_cache/ 143 | .dmypy.json 144 | dmypy.json 145 | 146 | # Pyre type checker 147 | .pyre/ 148 | 149 | # pytype static type analyzer 150 | .pytype/ 151 | 152 | # Cython debug symbols 153 | cython_debug/ 154 | 155 | # PyCharm 156 | # JetBrains specific template is maintained in a separate JetBrains.gitignore that can 157 | # be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore 158 | # and can be added to the global gitignore or merged into this file. For a more nuclear 159 | # option (not recommended) you can uncomment the following to ignore the entire idea folder. 160 | #.idea/ 161 | -------------------------------------------------------------------------------- /Chain_of_Images.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/GraphPKU/CoI/c4dc4dd0be46a8e85873bb646e7d84e9ef1f82d6/Chain_of_Images.pdf -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2023 GraphPKU 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # CoI: Chain of Images for Intuitively Reasoning 2 | This repository is the official implementation of "[Chain of Images for Intuitively Reasoning](https://arxiv.org/pdf/2311.09241.pdf)". Welcome to discuss this paper with me on [知乎](https://www.zhihu.com/people/meng-fan-xu-4/posts). 3 | Comparing to CoT which utlize language as an intermedia for solving complex task, Chain of Images (CoI) convert complex language reasoning problems to simple pattern recognition by generating a series of images as intermediate representations. 4 | ![CoT v.s. CoI](coi_cot.png) 5 | # Demo 6 | Welcom to try the demo of CoI running on [huggingface space](https://huggingface.co/spaces/fxmeng/Chain-of-Image). 7 | ![DALL-E 3](demo.jpg) 8 | 9 | # Todo list 10 | - [ ] Release the CoIEval datasest 11 | - [ ] Release the checkpoint of SyMLLM framework 12 | - [ ] Build CoI Benchmark 13 | 14 | # Citation 15 | If you find CoI useful, please cite it in your publications. 16 | ``` 17 | @article{meng2023chain, 18 | title={Chain of Images for Intuitively Reasoning}, 19 | author={Meng, Fanxu and Yang, Haotong and Wang, Yiding and Zhang, Muhan}, 20 | journal={arXiv preprint arXiv:2311.09241}, 21 | year={2023} 22 | } 23 | ``` 24 | -------------------------------------------------------------------------------- /coi_cot.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/GraphPKU/CoI/c4dc4dd0be46a8e85873bb646e7d84e9ef1f82d6/coi_cot.png -------------------------------------------------------------------------------- /dataset/ogbg_hiv.py: -------------------------------------------------------------------------------- 1 | from ogb.graphproppred import GraphPropPredDataset 2 | from rdkit import Chem 3 | from rdkit.Chem import Draw 4 | from rdkit import Chem 5 | import numpy as np 6 | from collections import defaultdict 7 | from rdkit import Chem 8 | from rdkit.Chem.Draw import rdMolDraw2D 9 | from IPython.display import Image 10 | import json 11 | 12 | def edge_index_to_mol(node_features, edge_index): 13 | mol = Chem.RWMol() 14 | for atomic_num in node_features: 15 | mol.AddAtom(Chem.Atom(int(atomic_num))) 16 | for src, dst in zip(edge_index[0], edge_index[1]): 17 | if not mol.GetBondBetweenAtoms(int(src), int(dst)): 18 | mol.AddBond(int(src), int(dst), Chem.BondType.SINGLE) 19 | mol = mol.GetMol() 20 | return mol 21 | 22 | def count_six_membered_rings(mol): 23 | Chem.SanitizeMol(mol) 24 | num_membered_rings=defaultdict(int) 25 | ring_info = mol.GetRingInfo() 26 | for ring in ring_info.AtomRings(): 27 | num_membered_rings[len(ring)]+=1 28 | return num_membered_rings 29 | 30 | def draw_mol_to_svg(mol): 31 | d = Draw.MolDraw2DSVG(224, 224) 32 | opts = d.drawOptions() 33 | for i in range(mol.GetNumAtoms()): 34 | opts.atomLabels[i] = "" 35 | d.DrawMolecule(mol) 36 | d.FinishDrawing() 37 | svg = "\n" 38 | svg += " \n" 39 | for path in d.GetDrawingText().split('class')[1:]: 40 | svg+= "\n" 41 | svg+="" 42 | return svg 43 | 44 | dataset = GraphPropPredDataset(name='ogbg-molhiv')# Select a graph from the dataset 45 | for idx,graph in enumerate(dataset): 46 | edge_index = graph[0]['edge_index'] 47 | node_features = np.zeros(graph[0]['num_nodes']) 48 | mol = edge_index_to_mol(node_features, edge_index) 49 | rings = count_six_membered_rings(mol) 50 | if len(rings.keys())==1 and 6 in rings.keys(): 51 | output = { 52 | "idx" : idx, 53 | "edge_index" : ', '.join(f'({i}, {j})' for (i,j) in edge_index.T.tolist()), 54 | "svg" : draw_mol_to_svg(mol), 55 | "6 cycle" : rings[6] 56 | } 57 | with open(f'eval/ogbg-hiv_{rings[6]}.jsonl', "a") as jsonl_file: 58 | jsonl_file.write(json.dumps(output) + "\n") 59 | -------------------------------------------------------------------------------- /demo.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/GraphPKU/CoI/c4dc4dd0be46a8e85873bb646e7d84e9ef1f82d6/demo.jpg --------------------------------------------------------------------------------