=========================================
2R Configuration Space App!
Designed and Developed by Pouya Mohammadi
=========================================
For feedbacks, suggestions, bug-reports and etc, do not hesitate to send me an email:
			cspace [dot] application [at-sign] gmail [dot] com
========================================= 
Acknowledgement:
First of all, thank you for using this software. I developed this little tiny application while working with Prof. Jean Paul Laumond (LAAS CNRS), Prof. Giuseppe Oriolo (University of Sapienza Rome) and Prof. Marilena Vendittelli (University of Sapienza Rome). 
Initially it was developed for testing some concepts and ideas related to Configuration Space, however, after our work was done I decided to add some features and remove some others to make it suitable for public. The result is what you have.
=========================================
Legal:
This software is published only and only for educational purposes. Feel free to distribute it under this condition.
=========================================
Technical Note:
Calculation of c-scape has a brute-force nature. This causes the application to have some lags on slow machines. In future releases I may use OpenCL for this calculation but till then, thanks for your patience! One trick that can decrease the lag is to turn-off high resolution calculation from the settings tab in the application.
Overall, the software executes more smoothly on Linux and Mac OS X comparing to Windows (what a surprise!!)
=========================================
How to run:
You can run this application on Linux, Mac and PC. Here is a very brief explanation about running it on different platforms. 

If (you are a familiar with java api and classpath) {
	simply scape this part and make sure you have java and java3d api installed (or add the included jars and dynamic libraries to classpath) and simply "java -jar 2R_C_Space.jar".
}
else {follow these instructions for your platform}:

Linux.
Tested on Ubuntu 12.04 64bits and Mint 32bits:
	1. Extract the "zip" file to a preferred location.
	2. Open your command shell (e.g. Terminal) and "cd" to extracted folder.
	3. You have to grant execution permission to "launcher_linux.sh" by running this command:

			"chmod +x launcher_linux.sh"

	4. Run the application by:

			"source launcher_linux.sh"

Mac OS X.
Tested on 10.6.8 (Snow Leopard):
	1. Extract the "zip" file to a preferred location.
	2. Simply double click on "2R_C_Space.jar"	
	OR
	2. From terminal "cd" to extracted folder.
	3. Type in:

			"java -jar 2R_C_Space.jar"

Windows.
Tested on XP 32bits and Seven 64bits:
	0. Make sure you don't want to run the software on Linux or Mac OS X.
	1. Extract the "zip" file to a preferred location.
	2. Run "launcher_windows.bat" from command line or explorer.


If any methods above failed:
	This app uses Java3D API for the graphics and some other java archive files(jar), "so" files and dlls for 32 and 64 bit operating systems are already included. However, if you had problems running this app from above instructions, follow the instructions bellow:

	1. Make sure you have java installed!
	2. From Oracle website download and install Java3d api.
	3. From command line/shell "cd" to the extracted directory and run:

			"java -jar 2R_C_Space.jar"

	4. If all failed, please send me an email to address mentioned at the beginning of this document.
=========================================
Files.
.
├── 2R_C_Space.jar
├── launcher_linux.sh
├── launcher_windows.bat
├── lib
│   ├── AbsoluteLayout.jar
│   ├── j3dcore.jar
│   ├── j3dutils.jar
│   ├── jgrapht-jdk1.6.jar
│   ├── swing-layout-1.0.4.jar
│   └── vecmath.jar
├── linux32lib
│   ├── libj3dcore-ogl-cg.so
│   └── libj3dcore-ogl.so
├── linux64lib
│   └── libj3dcore-ogl.so
├── README.TXT
├── win32dll
│   ├── j3dcore-d3d.dll
│   ├── j3dcore-ogl-cg.dll
│   ├── j3dcore-ogl-chk.dll
│   └── j3dcore-ogl.dll
└── win64dll
    └── j3dcore-ogl.dll
