Home

Awesome

Sequential Gallery

macOS Ubuntu macOS-python Ubuntu-python GitHub license

This repository offers an implementation of Sequential Gallery and a library for its core algorithm, sequential plane search. It is about a human-in-the-loop Bayesian optimization; see our SIGGRAPH 2020 paper for details.

This repository includes the followings.

Publication

Yuki Koyama, Issei Sato, and Masataka Goto. 2020. Sequential Gallery for Interactive Visual Design Optimization. ACM Trans. Graph. 39, 4 (July 2020), pp.88:1--88:12. DOI: https://doi.org/10.1145/3386569.3392444

The software is provided mainly for researchers who want to use or extend the method described in the above paper. We also expect that the software is useful for developers who plan to use the method in their software.

Project Page

https://koyama.xyz/project/sequential_gallery/

Dependencies

Library (sps):

Application (sequential-gallery):

Python bindings (pysps):

Experiment:

Test:

Prerequisites

Eigen (3.x.x) and Qt (5.x.x) need to be installed beforehand.

macOS:

brew install eigen qt@5

Ubuntu 18.04:

sudo apt install libeigen3-dev qt5-default

Build

git clone https://github.com/yuki-koyama/sequential-gallery.git --recursive
cd sequential-gallery
mkdir build
cd build
cmake ../
make

Python

pysps can be built and installed by the pip command:

pip install git+https://github.com/yuki-koyama/sequential-gallery

Make sure that Eigen (and other necessary build tools) is installed on the system beforehand.

Implementation Notes

Code Format

clang-format -i ./app/*.*pp ./exp/*.*pp ./test/*.*pp ./sps/**/*.*pp ./python-bindings/*.*pp

Copyright

Copyright (c) 2021 National Institute of Advanced Industrial Science and Technology (AIST) - koyama.y@aist.go.jp

License

MIT License. See the LICENSE file for details.

Contributing

Pull requests are highly welcome. Please be aware that any contribution to this repository will be licensed under the above license condition.