Webservice for ahn pointcloud viewer
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
gradle/wrapper
src
.gitignore
.travis.yml
LICENSE
README.md
build.gradle
config.yml-dist
gradlew
gradlew.bat
swagger.yaml

README.md

AHN pointcloud viewer web service

Build Status SonarCloud Gate SonarCloud Coverage DOI

Web service for the ahn-pointcloud-viewer web application. Ahn-point-cloud-viewer is a point cloud visualization for country sized point clouds.

The web service has the following api endpoints:

  1. Compute the number of points in a selected area
  2. Create a laz file of the selection and send a mail to an end-user with download location of the generated laz file

It uses a PostGIS database to approximate number of points in selected area.

Build

git clone git@github.com:NLeSC/ahn-pointcloud-viewer-ws.git
./gradlew build

The distribution is in the build/distributions directory.

Deployment

  1. Unpack distribution and cd to it.
  2. Create config file, use config.yml-dist as an example.
  3. Run it
bin/ahn-pointcloud-viewer-ws server config.yml

A web service will be started on http://localhost:8080

Development

To open in an IDE like Eclipse or Intellij IDEA, create project files with ./gradlew eclipse or ./gradlew idea respectively.

Perform tests with test and coverage reports in build/reports directory.

./gradlew test jacocoTestReport

Manual testing

First create config file config.yml, use config.yml-dist as an example.

  1. Create a database.

1.1 Start db

docker run -e POSTGRES_USER=ahn -e POSTGRES_PASSWORD=mysecret -p 5432:5432 -d mdillon/postgis

1.2 Fill it with test dataset

psql -h localhost -p 5432 -U ahn ahn < src/test/resources/test.sql
  1. Create a debug executable to run to create laz files. For example:
#!/bin/bash
echo `date -Iseconds`: $@ >> ahn-slicer.log
  1. Edit config.yml to set database and executable
  2. Start web service with ./gradlew run
  3. Test with a http client
virtualenv env
. env/bin/activate
pip install httpie
http -pHBhb http://localhost:8080/size left:=125932.60 bottom:=483568.840 right:=125942.60 top:=483588.840
http -pHBhb http://localhost:8080/laz left:=125932.60 bottom:=483568.840 right:=125942.60 top:=483588.840 email=someone@example.com

Api spec and documentation

The web service uses Swagger specification to describe it's endpoints.

The running web service will have the Swagger UI at /swagger and the Swagger spec at /swagger.json or /swagger.yaml.

The Swagger specification is available as ./swagger.yaml in this repo. It can be viewed in the swagger UI.

Database and create_user_file

This web service relies on a database which contains

  • a table with the extents of the files in the AHN2,
  • a table with the extents of the files in the octree structure and
  • a third table that contains, for each level of the octree, the ratio of points in the level divide by the total number of points .

To fill in a PostgreSQL database with the required information use the scripts fill_db_raw.py and fill_db_potree.py from the Massive-PotreeConverter repository.

The file create_user_file.py in src/main/python is used to create a user file from a selected region and it uses the described PostgreSQL database. The scripts uses LAStools.