# Black Box Geometric Computing with Python¶

This course is presented at Eurographics 2020 as a full day tutorial. A shorter version of this course was presented at Siggraph 2019.

In the course, we present a set of real-world examples from Geometry Processing, Physical Simulation, and Geometric Deep Learning. Each example is prototypical of a common task in research or industry and is implemented in a few lines of code. By the end of the course, attendees will have exposure to a swiss-army-knife of simple, composable, and high-performance tools for Geometric Computing.

## Course Material¶

The full course is available as videos here. It covers the theory and practice in an hands-on approach with many examples. We also publish the rendered Jupyter notebooks on this website and interactive and editable versions on Binder.

The course is divided into the following parts:

## Installation¶

The easiest way to install the libraries used in the course is trough the conda or miniconda python package manager.

All libraries are part of the channel conda forge, which we advise to add to your conda channels by:

conda config --add channels conda-forge


This step allows to install any conda forge package simply with conda install <package>.

To install all our packages just run:

conda install meshplot igl wildmeshing polyfempy

In addition, Jupyter can be easily installed to run the interactive notebooks:

conda install jupyter


Note: If the problem persists, you can post an issue on the github bugtracker of each library or here.

### Packages Description¶

More information about the libraries used in the course can be found on their websites:

## Motivation¶

Many disciplines of Computer Science have access to high level libraries allowing researchers and engineers to quickly produce prototypes. For instance, in Machine Learning, one can construct complex, state-of-the-art models which run on the GPU in just a few lines of Python.

In the field of Geometric Computing, however such high-level libraries are sparse. As a result, writing prototypes for geometry processing is time consuming and difficult even for advanced users.

In this course, we present a set of easy-to-use Python packages for applications in Geometric Computing. We have designed these libraries to have a shallow learning curve, while also enabling programmers to easily accomplish a wide variety of complex tasks. Furthermore, the libraries we present share NumPy arrays as a common interface, making them highly composable with each-other as well as existing scientific computing packages. Finally, our libraries are blazing fast, doing most of the heavy computations in C++ with a minimal constant-overhead interface to Python.

## Contact¶

This course is a group endeavor by Sebastian Koch, Teseo Schneider, Francis Williams, Chengchen Li, and Daniele Panozzo. Please contact us if you have questions or comments. For troubleshooting, please post an issue on github. We are grateful to the authors of all open source C++ libraries we are using. In particular, libigl, tetwild, polyfem, pybind11, and Jupyter.