greyhound-server
v1.0.1
Published
[![Build Status](https://api.travis-ci.org/hobu/greyhound.svg)](https://travis-ci.org/hobu/greyhound)
Downloads
18
Readme
GREYHOUND
A point cloud streaming framework for dynamic web services and native applications.
See it in action with the dynamic Plas.io client at speck.ly and the Potree client at potree.entwine.io.
Getting started
Obtaining Greyhound
Using Docker
docker run -it -p 8080:8080 connormanning/greyhound
Natively
Prior to installing natively, you must first install PDAL and its dependencies, and then install Entwine. Then you can install Greyhound via NPM.
npm install -g greyhound-server
greyhound
Indexing some data
Greyhound uses data indexed by Entwine. See the instructions for how to use Entwine. If you are eager to get started, we have some publicly hosted data you can index and serve locally:
docker run -it -v $HOME:$HOME connormanning/entwine build \
-i https://entwine.io/sample-data/red-rocks.laz \
-o ~/greyhound/red-rocks
Viewing the data
You've just indexed a LAZ file from the internet (data credit to DroneMapper) and created a local Entwine dataset. It's sitting at ~/greyhound/red-rocks
. Now let's start Greyhound and take a look at the data. We'll map our top-level output directory into one of the default search paths for the Greyhound container.
docker run -it -p 8080:8080 -v ~/greyhound:/greyhound connormanning/greyhound
Now that Greyhound is awake, you should be able to browse your data with Plasio or Potree.
Further reading
See the client documentation if you are interested in developing an application that streams data from Greyhound. For instructions regarding configuring and deploying Greyhound, see the administrator documentation.