s2-geometry-library

• License: Apache 2.0 (see COPYING)
• Upstream: https://code.google.com/archive/p/s2-geometry-library/ (unmaintained)
• With fixes from micolous, silicontrip and yjwong.
• Presentation: https://docs.google.com/presentation/d/1Hl4KapfAENAOf4gv-pSngKwvS_jwNVHRPZTTDzXXn6Q/view?pli=1
• Documentation: none provided by upstream, read the presentation; other ports have better documentation

This package has Python bindings which target Python 2.7. You can also use it as a C++ library.

In Python code, import s2.

Dependencies

You'll need the development (-dev or -devel) versions of these libraries in order to build the library.

• OpenSSL (used for BIGNUM functions)

You'll need these build-time dependencies:

• SCons
• SWIG (must be swig in your PATH)

A C++ compiler supporting C++11 (g++ 4.8 or later, clang 3.3 or later) is also required.

Mac OS X specific notes

Make sure you are using python.org Python, and that it is the default in your path (not Apple's Python or Macports Python).

Install scons using easy_install, not MacPorts.

Other dependencies will need to be installed with MacPorts using the +universal build flag.

Make sure /opt/local/bin and /Library/Frameworks/Python.framework/Versions/2.7/bin are not only listed in $PATH, but also in /etc/paths before /usr/bin (otherwise Python bindings will fail to build).

Building

The Linux From Scratch way (also for OSX)

scons
sudo scons install

This will also build the Python bindings.

You can uninstall the library with sudo scons install -c.

As a Debian package

This is currently broken, and needs to be ported to scons.

apt-get install python-dev debhelper libgflags-dev cdbs swig build-essential fakeroot autoconf libtool pkg-config
./autogen.sh
pushd ..
tar jcf s2_1.0.0.orig.tar.bz2 s2-geometry-library/ --exclude=.git
popd
dpkg-buildpackage -rfakeroot

Installing the Debian package

Once built:

dpkg -i ../libs2*.deb ../python-s2*.deb

Running the tests (Python)

python test.py