Home

Welcome to the vgl wiki! Here you will find help on building and using VGL. VGL is the Open Source (Apache 2.0 license) library from Kitware and NYU-Poly.

License

Copyright 2013 Kitware Inc. & NYU-Poly

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Develop VGL

Build and Install

Download the data first from here: https://github.com/OpenGeoscience/geoweb-data.git

git clone https://github.com/OpenGeoscience/geoweb-data.git

VGL source has minimum dependencies but testing requires additional libraries and datasets. In order to build VGL on your system, follow the steps below:

git clone https://github.com/OpenGeoscience/vgl.git vgl-src mkdir vgl-build
cd vgl-build
cmake -DBUILD_TESTING:BOOL=ON ../vgl-src
ccmake .

Now set VGL_DATA_DIR to path_to_geoweb-data/documents

make

Now you should be set to run the tests. Start the python http sever

cd deploy (default deploy directory if you have not changed it)
python -m SimpleHTTPServer

Now visit http://localhost:8000/testing/drawCountries.html

Please contact us at [email protected] or [email protected]

Testing

VGL uses selenium, numpy, matplotlib, firefox, and ctest for testing. You can install most of the dependencies using pip as shown below:

pip install selenium
pip install numpy
pip install matplotlib

Depending on your OS and system, you may have to install libpng, libpng-dev etc. Once installed, you can
turn ON testing by setting BUILD_TESTING to ON in ccmake or cmake-gui. Configure, generate,
and build as usual and then run

cd path_to_build_dir
ctest

The output should looks something like this (may vary on Windows or Mac)

38: Problem opening file
38: no baseline image yet
38: Check in drawCountries-2013-10-14 18:04:45.226486.png as a new baseline
38: -1
1/1 Test #38: python-drawCountriesReg.py ....... Passed 8.12 sec

The following tests passed:
python-drawCountriesReg.py

100% tests passed, 0 tests failed out of 1

Please contact us at [email protected] or [email protected] if you have more questions on JavaScript testing for VGL.