Tutorial

This section provides a tutorial to generate visualization from any vector datasets

Downloading and running the code:

The code can be downloaded from https://github.com/aseldawy/spatialhadoop2

Compile the code using maven command
mvn assembly:assembly -Dmaven.javadoc.skip=true -DskipTests

To get the desired indexes(Image/Image-Data), run the following command
hadoop jar target/spatialhadoop-2.4.3-SNAPSHOT-uber.jar gplot InputFile OutputDirectory shape:Geometric Shape of the input file -overwrite -pyramid
For an Image-Data mixed index, add -adaptive option to the above command

Visualizing the Datasets

Run the Davinci.java from the source code. Go to the source directory and compile the code using
mvn exec:java -Dexec.mainClass="edu.umn.cs.spatialHadoop.visualization.DavinciServer"
After the code compiles successfully, the server will start

In your web browser, navigate to http://localhost:8889/dynamic/showImage.cgi/OutputDirectory/index.html to visualize the dataset of your choice.

End-to-end Examples

Visualizing LINEARWATER using HadoopViz

This section gives step-by-step instructions for visualizing a linear hydrography data, named as LINEARWATER, obtained from US Census Bureau TIGER Files using HadoopViz.

1. Download the dataset LINEARWATER from here

2. Clone the source code using the command git clone https://github.com/aseldawy/spatialhadoop2.git

3. Compile the code using
mvn assembly:assembly -Dmaven.javadoc.skip=true -DskipTests

4. After successfully compiling the code, run the following command
hadoop jar target/spatialhadoop-2.4.3-SNAPSHOT-uber.jar gplot LINEARWATER.csv.bz2 LINEARWATER.png shape:tiger -overwrite -pyramid

5. Once the program completes its execution, run the Davinci.java file from the source code

Go to the source directory and compile the code using
mvn exec: java -Dexec.mainClass= "edu.umn.cs.spatialHadoop.visualization.DavinciServer"
After the code compiles successfully, the server will start

6. In your web browser, navigate to
http://localhost:8889/dynamic/showImage.cgi/LINEARWATER.png/index.html

Visualizing LINEARWATER using AID

This section gives a step by step description of visualizing a linear hydrography data, named as LINEARWATER, obtained from US Census Bureau Tiger Files using AID.

1. Download the dataset LINEARWATER from here

2. Download the source code from https://github.com/aseldawy/spatialhadoop2 .

3. Compile the code using
mvn assembly:assembly -Dmaven.javadoc.skip=true

4. After successfully compiling the code, run the following command
hadoop jar target/spatialhadoop-2.4.3-SNAPSHOT-uber.jar gplot LINEARWATER.csv.bz2 LINEARWATER_Adapt.png shape:tiger -overwrite -pyramid -adaptive

5. Once the program completes its execution, run the Davinci.java file from the source code

Go to the source directory and compile the code using
mvn exec: java -Dexec.mainClass= "edu.umn.cs.spatialHadoop.visualization.DavinciServer"
After the code compiles successfully, the server will start

6.In your web browser, navigate to
localhost:8889/dynamic/showImage.cgi/
LINEARWATER_Adapt.png/index.html