Point cloud visualization of the current digital elevation model of the Netherlands (Actueel Hoogtebestand Nederland or AHN2). For further details, please refer to the publication by Martinez-Rubi et al. (2015).
- Massive-PotreeConverter extends the PotreeConverter to handle massive point cloud data such as AHN2.
- ahn-pointcloud-viewer-ws corresponds to a RESTful web service that enables communication between this web application (viewer) and database of point cloud (meta)data.
- Point cloud data in the potree format
- Node.js
- Bower
- Compass
- Java Development Kit
- Supported web browsers:
Install Git CLI/GUI clients
Install Node.js and required modules
- Make sure the Add node to PATH option is checked.
- Create '$HOME/npm' folder (where $HOME is C:\Users<username>\AppData\Roaming).
npm install -g bower grunt-cli
Install Ruby and required package
- Make sure the Add Ruby to PATH option is checked
gem install compass
git clone https://github.com/NLeSC/ahn-pointcloud-viewer
cd ahn-pointcloud-viewer
npm install -g grunt grunt-cli
npm install
bower install
bower update
grunt serve # starts the web server and opens http://localhost:9000 in your browser
See the documentation here.
curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo npm install -g bower grunt-cli
sudo apt-get install ruby-dev libffi-dev build-essential
sudo gem install compass
git clone https://github.com/NLeSC/ahn-pointcloud-viewer
cd ahn-pointcloud-viewer
npm install phantomjs
npm install
bower install
#bower update
grunt serve # starts the web server and opens http://localhost:9000 in your browser
grunt test
Note: This generates test and coverage reports (see the test/reports folder).
grunt e2e-local
Note: Both the point cloud 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 your browser).
Run end-to-end tests remotely on Sauce Labs
Connect to Sauce Labs using the sauce-connect program. Further details on how to install and run this tool can be found here.
Setup Sauce Labs credentials before running the tests.
export SAUCE_USERNAME=<your sauce labs username>
export SAUCE_ACCESS_KEY=<your sauce labs access key>
Run the tests in Google Chrome (Linux).
grunt e2e-sauce
Both the point cloud window and minimap use a canvas, which can't be tested automatically. Therefore, the tests must be verified manually using the screencast in the report at https://saucelabs.com/u/<your sauce labs username>.
Also Travis-CI runs end-to-end tests on Sauce Labs.
Note: Executing grunt e2e-sauce locally 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