{"id":13578998,"url":"https://github.com/yiling-chen/view-finding-network","last_synced_at":"2026-01-22T06:43:13.155Z","repository":{"id":91310411,"uuid":"80857216","full_name":"yiling-chen/view-finding-network","owner":"yiling-chen","description":"A deep ranking network that learns to find good compositions in a photograph.","archived":false,"fork":false,"pushed_at":"2021-11-24T08:42:58.000Z","size":44216,"stargazers_count":74,"open_issues_count":7,"forks_count":16,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-11-05T17:48:28.456Z","etag":null,"topics":["aesthetics","dataset","deep-learning","evaluation","tensorflow"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yiling-chen.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,"roadmap":null,"authors":null}},"created_at":"2017-02-03T18:29:53.000Z","updated_at":"2024-04-07T01:57:09.000Z","dependencies_parsed_at":"2023-04-10T12:02:50.257Z","dependency_job_id":null,"html_url":"https://github.com/yiling-chen/view-finding-network","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiling-chen%2Fview-finding-network","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiling-chen%2Fview-finding-network/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiling-chen%2Fview-finding-network/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yiling-chen%2Fview-finding-network/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yiling-chen","download_url":"https://codeload.github.com/yiling-chen/view-finding-network/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247399818,"owners_count":20932875,"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":["aesthetics","dataset","deep-learning","evaluation","tensorflow"],"created_at":"2024-08-01T15:01:35.693Z","updated_at":"2026-01-22T06:43:13.148Z","avatar_url":"https://github.com/yiling-chen.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# View Finding Network\n\nThis repository contains the dataset and scripts used in the following article:\n\n[Yi-Ling Chen](https://yiling-chen.github.io/), Jan Klopp, [Min Sun](http://aliensunmin.github.io/), [Shao-Yi Chien](http://www.ee.ntu.edu.tw/profile?id=101), [Kwan-Liu Ma](http://www.cs.ucdavis.edu/~ma/), [\"Learning to Compose with Professional Photographs on the Web\"](https://arxiv.org/abs/1702.00503), in Proc. of ACM Multimedia 2017. [(Supplemetnal)](pdf/mm2017-supplemental.pdf)\n\n**News**  Check out this [PyTorch implementation](https://github.com/remorsecs/pytorch-view-finding-network) if you are interested.\n\n## Dependencies\n\nYou will need to have `tensorflow` (version \u003e 1.0), `skimage`, `tabulate`, `pillow` installed on your system to run the scripts.\n\n## Download the dataset\n\n* Clone the repository to your local disk.\n* Under a command line window, run the following command to get the training images from Flickr:\n```bash\n$ python download_images.py -w 4\n```\nThe above command will launch 4 worker threads to download the images to a default folder (./images).\n\n## Training\n\n* Run `create_dbs.py` to generate the TFRecords files used by Tensorflow.\n* Run `vfn_train.py` to start training.\n```bash\n$ python vfn_train.py --spp 0\n```\nThe above example starts training with SPP disabled. Or you may want to enable SPP with either `max` or `avg` options.\n```bash\n$ python vfn_train.py --pooling max\n```\nNote that if you changed the output filenames when running `create_dbs.py`, you will need to provide the new filenames to `vfn_train.py`. Take a look at the script to check out other available parameters or run the following command.\n```bash\n$ python vfn_train.py -h\n```\n\n## Evaluation\n\nWe provide the evaluation script to reproduce our evaluation results on [Flickr cropping dataset](https://github.com/yiling-chen/flickr-cropping-dataset). For example,\n```bash\n$ python vfn_eval.py --spp false --snapshot snapshots/model-wo-spp\n```\nYou will need to get `sliding_window.json` and the test images from the [Flickr cropping dataset](https://github.com/yiling-chen/flickr-cropping-dataset) and specify the path of your model when running `vfn_eval.py`. You can also try our pre-trained model, which can be downloaded from [here](https://drive.google.com/drive/folders/0B0sDVRDPL5zBd3ozNlFmZEZpY1k?resourcekey=0-8LArgbYDQT07L-Dob6Yo9w\u0026usp=sharing).\n\nIf you want to get an aesthetic score of a patch, please take a look at the example featured by [ModelDepot](https://modeldepot.io/yilingchen/view-finding-network)\n\n## Questions?\nIf you have questions/suggestions, feel free to send an email to (yiling dot chen dot ntu at gmail dot com).\n\n**If this work helps your research, please cite the following article:**\n\n    @inproceedings{chen-acmmm-2017,\n      title={Learning to Compose with Professional Photographs on the Web},\n      author={Yi-Ling Chen and Jan Klopp and Min Sun and Shao-Yi Chien and Kwan-Liu Ma},\n      booktitle={ACM Multimedia 2017},\n      year={2017}\n    }\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyiling-chen%2Fview-finding-network","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyiling-chen%2Fview-finding-network","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyiling-chen%2Fview-finding-network/lists"}