ZSPACE

GitHub license Documentation GitHub Releases GitHub Issues

ZSPACE is a C++ library collection of geometry data-structures and algorithms framework. It is implemented as a header-only C++ library, whose dependencies, are header-only or static libraries. Hence ZSPACE can be easily embedded in C++ projects.

Optionally the library may also be pre-compiled into a statically or dynamically linked library, for faster compile times.

Installation

  1. Download and follow the instructions to install Visual Studio 2019 from Microsoft.
  2. Open Visual Studio 2019 and click on "Clone a repository" VS_1
  3. Go to GitZHCODE/zspace_alice.
    • Click on "Code" button and copy HTTPS directory from the web page. Git_3
    • Paste the directory to the "Repository location" in Visual Studio.
    • Click on "Clone". VS_4

Launching

  1. Browse to "Users\name\source\repos\GitZHCODE\zspace_alice\ALICE_PLATFORM", double click on "ALICE.sln" to open the solution. Folder_5
  2. Change the "Solution Configurations" to "Release_zSpaceDLL". Click on "Local Windows Debugger" (play button) to launch Alice. Alice_6
  3. If it successfully loaded, you should be able to see Alice viewer window and Console window pop up on your screen. Alice_7

Citing

If you use the library of ZSPACE in a project, please refer to the GitHub repository.

@misc{zspace-framework, title = {{zspace}: A simple C++ header-only collection of geometry data-structures, algorithms and city data visualization framework.}, author = {Vishu Bhooshan and Shajay Bhooshan and others}, note = {https://github.com/venumb/ZSPACE}, year = {2018}, }

License

The library is licensed under the MIT License.

Third party dependencies

The library has some dependencies on third-party tools and services, which have different licensing as listed below. Thanks a lot!

  • OPENGL for display methods. End users, independent software vendors, and others writing code based on the OpenGL API are free from licensing requirements.

  • Eigen for matricies and related methods. It is an open source project licensed under MPL2.

  • Spectra for large scale eigen value problems. It is an open source project licensed under MPL2.

  • Armadillo for matricies and related methods. It is an open source project licensed under Apache License 2.0.

  • Alglib free edition for linear programming optimisation methods.

  • JSON for Modern C++ to create a JSON file. It is an open source project licensed under MIT License.

  • SQLITE for SQL database engine. It is an open source project dedicated to the public domain.

  • LodePNG for creating PNG images. It is a project licensed under ZLIB License.

  • TooJPEG for creating JPEG images. It is a project licensed under ZLIB License.