Interactive multidimensional projections. # Prerequisites This program depends on the following libraries: * [CUBu](https://bitbucket.org/rmmartins/cubu) (download the sources and follow the instructions on README.md to build and install; you *must* edit this project's CMakeLists.txt and point the CUBU variable to the base folder) * Qt 5 (Qt5Widgets, Qt5Qml, Qt5Quick) * Armadillo 6.x.x (might work with older versions) * CUDA 7.5 (high chance of working with older versions) * CMake 2.8.12 (or newer) CMake *should* automatically find all the mentioned libraries under normal circumstances (not Windows). ## Windows On Windows, Armadillo should be installed in `C:\Program Files (x86)\Armadillo` (this is where CMake usually looks for Armadillo). Also remember to build `armadillo.lib` instead of the default `armadillo.dll`. # Building Assuming the current directory is the root of this project: mkdir build cd build cmake .. make For faster builds, you can use `make -j NUM_CORES`. # Usage This program needs a CUDA-enabled GPU (not necessarily powerful) to run. The program is run as follows: ./pm [options] dataset Options accepted are: Option | Description -------------------------| -------------------------------------------------------------------------------------------- -h, --help | Displays usage. -v, --version | Displays version information. -i, --indices | Filename to store the control points' indices. Omitting this option disables saving indices. -c, --cpoints | Filename to store the control points' map. Omitting this option disables saving this map. And the arguments are: Argument | Description ---------|----------------------------- dataset | Dataset filename (.tbl file) # File formats An **indices file** should be a file where each line contains an index (starting from zero) and nothing else. Each index will be considered a control point, in the context of the given dataset file. A **CP map file** should be a two-column file where each line contains the 2D coordinates of each control point (according to the indices file) and nothing else. Note that the number of lines of this file and the indices file are supposed to be the same. **Dataset files** are the same as CP map files, except they are allowed to have any number of columns. Note that the number of columns must be the same on each line.