SFCGAL4J-ISO

Supporting 3D spatial operations

In order to support 3D spatial operations such as intersects, this module uses Simple Feature CGAL(SFCGAL), which is a C++ wrapper library around CGAL with the aim of supporting ISO 19107:2013 and OGC Simple Features Access 1.2 for 3D operations. Since SFCGAL is C++ library, this module employs JavaCPP as a bridge between C++ and Java. Due to dependency on SFCGAL, there exist limitations such as supported platforms. If you need 3D operations in gt-geometry, you have to install SFCGAL manually.

Supported platforms

Windows
GNU/Linux

Prerequisites

CMake
SFCGAL
CGAL
Boost
GMP
MPFR

License of third party libraries

SFCGAL is distributed under the terms of the LGPL(v2+). Starting from release 4.0. CGAL is available under the GPL(v3+)/LGPL(v3+). JavaCPP is available under Apache License(v2.0)/GPL(v2+) with "Classpath" exception. GeoTools licensed under the LGPL(v2+).

Installation on Windows (64 bit)

To use this extension on Windows, some open source libraries and tools(Mingw-w64,CMake,Boost,CGAL,SFCGAL) are required.

MinGW-w64

Downald the MinGW-w64 installer, and excute.
Choose the Version(5.2.0), Architecture(x86_64), Thread(win32).
Click the Next, Next and Finish.
Add MinGW\bin to the system PATH. (e.g., C:\dev\mingw-w64\x86_64-5.2.0-win32-seh-rt_v4-rev1\mingw64\bin)

Boost (1.55 version recommended)

Download the boost archive, unpack it to a target directory of your choice (e.g., C:\dev\boost_1_55_0).
Open a command-line terminal, such as cmd.

Run:

cd C:\dev\boost_1_55_0
./bootstrap.bat mingw
b2 clean
b2 -j4 -a --toolset=gcc variant=debug,release link=static threading=multi address-model=64 stage

Make sure the subdirectory stage/lib/ has been populated with the compiled libraries

Add BOOST_ROOT, BOOST_INCLUDEDIR and BOOST_LIBRARYDIR variables to the environment variables.

Variable Name	Description
BOOST_ROOT	Root directory of your Boost installation
BOOST_INCLUDEDIR	Directory containing the boost/version.hpp file
BOOST_LIBRARYDIR	Directory containing the compiled Boost libraries

Add Boost_ROOT\stage\lib to the system PATH. (e.g., C:\dev\boost_1_55_0\stage\lib).

CMake (3.4.0 version recommended)

Agree to the license.
Check "Add CMake to the system PATH for all users".
Check "create desktop icon".
Click the Next, Next, Next.
Finish.

CGAL (4.7 version recommended)

CGAL installation will need to connect to the internet for GMP and MPFR.
Agree to the license.
Just choose the default: with GMP and MPFR, and with examples and demos.
Choose "64-bit".
In the "Setting Environment Variables" screen, choose all users and make sure that CGAL_DIR is checked.
Install.

Add CGAL_DIR and other variables to the environment variables.

Variable Name	Description
CGAL_DIR	Root directory of your CGAL installation
GMP_DIR	Directory of Gmp default installation (CGAL_DIR\auxiliary\gmp)
GMP_INC_DIR	Directory containing the gmp.h file
GMP_LIB_DIR	Directory containing the compiled Gmp library
MPFR_DIR	Directory of Mpfr default installation (CGAL_DIR\auxiliary\gmp)
MPFR_INC_DIR	Directory containing the mpfr.h file
MPFR_LIB_DIR	Directory containing the compiled Mpfr library

Add CGAL_DIR\auxiliary\gmp\lib the to system PATH. (e.g., C:\dev\CGAL-4.7\auxiliary\gmp\lib)

Now you need to compile CGAL
Open CMake - cmake-gui (on the Desktop) -if you are using win7 make sure you open the program in administrator mode - right click on the icon and click on "run as administrator".
For both "Where is the source code" and "Where to build the binaries" specify the CGAL installation folder (C:\dev\CGAL-4.7)
Click Configure.
Choose "MinGW Makefiles" and click "Finish".
Check the CGAL_Boost_USE_STATIC_LIBS option (ON)
Check the WITH_CGAL_QT3(or QT5) option (OFF)
Set CMAKE_BUILD_TYPE option to Release.
Click Generate.
A solution named CGAL was created in the directory.
Open a command-line terminal, and change directory to target directory:
Run:
```
cd C:\dev\CGAL4.7
mingw32-make
```

SFCGAL (1.2.2 recommended)

Download the sfcgal archive, unpack it to a target directory of your choice (e.g., C:\dev\SFCGAL-1.2.2)
Open CMake - cmake-gui.
For both "Where is the source code" and "Where to build the binaries" specify the SFCGAL installation folder (C:\dev\SFCGAL-1.2.2)
Click Configure.
Choose "Mingw Makefiles" and click "Finish".
Check the Boost_USE_STATIC_LIBS option (ON).
Set CMAKE_BUILD_TYPE option to Release,
Click Generate.
A solution named SFCGAL was created in the directory.
Run:
```
cd C:\dev\SFCGAL-1.2.2
mingw32-make
```
Add SFCGAL_DIR variables to the environment variables.

Variable Name Description

SFCGAL_DIR Root directory of your SFCGAL installation.

Variable Name	Description
SFCGAL_DIR	Root directory of your SFCGAL installation.

Generate DLL files

Run the build.bat file in the getools\modules\unsupported\geometry\lib.
Make sure the subdirectory org\geotools\geometry\iso\sfcgal\wrapper\windows-x86_64 has been generated with the dll files.

Authors

Donguk Seo / Pusan National University (donguk.seo@pnu.edu)

STEMLab / sfcgal4j-iso