Report on installing the environment for Triangle of Sustainability - hguerra/InteractiveDataVisualization GitHub Wiki

Carneiro, Heitor Guerra.

February 23 2015, Version 1.

This document aims to instruct the installation and configuration of the desktop for the Triangle of Sustainability. The project is an interactive show to explore observations about deforestation of rainforests and related phenomena such as road networks, political situation, and market prices of agricultural products on maps and timelines.

The operation of the tool resources are required some applications on your environment, which will be describe later. The document model will be installed on a machine with Windows 32-bit.

Necessary applications

  • Java JDK
  • Kinect SDK 1.8
  • Simple-OpenNI
  • Processing
  • Eclipse IDE
  • Nasa World Wind Java SDK

Installation Requirements

Java JDK (Java Development Kit) [1]

The applications need Java Runtime to be executed. The compilation of the code requires Java Virtual Machine (JVM), a tool that will be generate the bytecode for the operating system running.

Kinect SDK 1.8 (The Kinect for Windows software development kit) [2]

The integrated developer toolkit includes resources to simplify and speed up application development, by using C++, C# and Visual Basic.

Compressed Files

Simple-OpenNI [3]

The API (Application Programming Interface) is a project initially for Processing IDE, with OpenNI’s structure (Open Natural Interaction) that is currently unavailable for download, adapted to Kinect toolkit.

Processing [4]

Processing is a programming language, development environment and online community. The software promoted literacy within the visual arts and visual literacy within technology. Another property is the open source code and free to download. The implementation using the IDE is the easier method to develop with Java on Kinect.

Eclipse IDE [5]

Eclipse is an integrated development environment (IDE). It contains a base workspace and an extensible plugin-in system for customizing the environment. Eclipse can be used to develop applications mostly in Java, but also in other programming languages like C/C++, PHP, and Python.

Processing Development Environment

After the Processing IDE download and the files extraction, in Documents\Processing\libraries on Windows, will be extracted the Simple-OpenNI library. In option Examples in Files, choice the Simple-OpenNI and open User.pde example to test your installation.

Eclipse Development Environment

After creating a new Java project in Eclipse, the first step is import the Simple-OpenNi and Processing Core libraries.

  • On the Package Explorer, click on the project folder and the open its properties by selecting Properties from the context menu or from the main menu.
  • Select Java Build Path and go to Libraries.
  • Select the SimpleOpenNI, core, gluger-rt and jogl-all libraries and press the Add External JARs button.
  • Expand all of imported libraries and double click on “Native Library Location: ”
  • Click External Folder and select the same library folder that contains the APIs.

Picture 1 - Java Build Path.

Eclipse Project Example

The Processing applications in Eclipse there are some characteristics:

  • Extends PApplet
  • System call: PApplet.main()
  • Required methods: setup() and draw()

The applications without main method can be running with right click on Class, select Run as, and after Java Applet.

Picture 2 - Application example without main method.

Java Application’s structure with main method.

Picture 3 - Java Application Example

NASA World Wind JAVA SDK [6]

World Wind is a free, open source API for virtual globe. Written in Java and allows developers quickly and easily create interactive visualizations of 3D globe, map and geographical information.

Extract the World Wind to anywhere on your hard drive.

APIs with Need be Imported:

  • gdal.jar
  • glugen.jar
  • jogl.jar
  • worldwind.jar
  • worldwinx.jar

Go to Project> Properties, select the tab Libraries, click on Add External JARs and add the API files.

Picture 4 – Java Build Path World Wind.

Copy the libraries glugen-rt.dll, jogl.dll, jogl_awt.dll, jogl_cg.dll to your java library path directory. Example in Windows 32 bits: C:\Program Files (x86)\Java\jre7\bin

References

http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html?ssSourceSiteId=otnpt [1].

http://www.microsoft.com/en-us/kinectforwindows/develop/learn.asp [2].

https://code.google.com/p/simple-openni/ [3].

https://processing.org/ [4].

https://www.eclipse.org/home/index.php [5].

http://worldwind.arc.nasa.gov/java/ [6].