Webgl pointcloud visualization of the Actuele Hoogtekaart Nederland (2) based on http://potree.org
- Massive-PotreeConverter: Used to extend PotreeConverter to deal with massive point clouds like AHN2. This visualization requires the point cloud data to be converted to the potree format.
- [ahn-pointcloud-viewer-ws] (https://github.com/NLeSC/ahn-pointcloud-viewer-ws): Contains the web service in charge of the communication between this application and the database with meta-data regarding the point cloud data.
- Install Git : http://git-scm.com/downloads
- Install Node.js : http://nodejs.org/ (Make sure add node to PATH option is checked)
- Create '$HOME/npm' folder (Where $HOME is c:\Users<username>\AppData\Roaming).
- Open node command prompt and run
npm install -g bower grunt-cli
- Install Ruby: http://rubyinstaller.org/ (Make sure add ruby to PATH option is checked)
- Open ruby command prompt and run
gem install compass
- Start Git bash
- Type: "git clone https://github.com/NLeSC/ahn-pointcloud-viewer"
- Type: "cd ahn-pointcloud-viewer"
- Type: "npm install -g grunt grunt-cli"
- Type: "npm install"
- Type: "bower install"
- Type: "bower update"
- Type: "grunt serve"
- Open browser, go to "http://localhost:9000"
- nodejs, http://nodejs.org/
- bower, http://bower.io
- compass, http://compass-style.org
- Java Development Kit, https://www.java.com/
Follow instructions at joyents github website: https://github.com/joyent/node/wiki/Installing-Node.js-via-package-manager#debian-and-ubuntu-based-linux-distributions
Install bower and grunt-cli globally
sudo npm install -g bower grunt-cli
Compass is used to convert the sass 2 css.
- Install Ruby using https://www.ruby-lang.org/en/documentation/installation/#apt
- Install Ruby dev and other dependecy packages
sudo apt-get install ruby-dev libffi-dev
- Install compass (for sass compilation)
gem install compass
git clone https://github.com/NLeSC/ahn-pointcloud-viewer
cd ahn-pointcloud-viewer
npm install
bower install
If you already have a installed the bower packages before, but need to update them for a new version of the code, run
bower update
grunt serve
Changes made to code will automatically reload web page.
grunt test
Generates test report and coverage inside test/reports
folder.
Tests in Chrome can be run with
grunt e2e-local
The pointcloud and minimap use a canvas and can't be tested automatically so they must be verified manually using the screenshots in the report.
Open e2e/reports/report.html
in a web-browser.
Run end-to-end tests on sauce labs
To connnect to Sauce Labs use sauce connect program. Here you can find the details on how to install and run it.
Before tests can be run the sauce labs credentials must be setup
export SAUCE_USERNAME=<your sauce labs username>
export SAUCE_ACCESS_KEY=<your sauce labs access key>
Tests in Chrome, Firefox on Windows, Linux and OSX can be run with
grunt e2e-sauce
The pointcloud and minimap use a canvas and can't be tested automatically so they must be verified manually using the screencast in the report at https://saucelabs.com/u/<your sauce labs username>
.
Travis-ci also runs end-to-end tests on sauce labs.
Note! Running grunt e2e-sauce
will undo all changes in app/
folder.
grunt build
The dist
folder has production ready distribution.
grunt jsdoc
API documentation is generated in doc/
directory.
Use Chrome FPS plotting to get the frame rate.
- Open developer tools
- On Console tab goto Rendering tab (bottom screen)
- Check the Show FPS meter checkbox
Deploy distribution to gh-pages
branch.
Make it available as http://nlesc.github.io/ahn-pointcloud-viewer
grunt build
grunt gh-pages