mhdbny/asymmetric-threat-tracker

Spatiotemporal Crime Prediction Software

Operating System Compatibility

• All instructions below apply to Windows XP and 7.
• Windows 8 should also work but hasn't been tested.
• Running on Linux via Mono should work (must compile from source -- see below).

Prerequisites

• Install ​PostgreSQL 9.2 or later. After installing PostgreSQL, use Stack Builder to install PostGIS 2.0 or later. PostGIS is located under the Spatial Extensions tab. Keep note of the file paths to "shp2pgsql.exe" and "pgsql2shp.exe".
• Install ​R 2.15.0 or later. Make sure the directory to which you install R packages is writable. Keep note of the file path to "R.exe".
• Install ​Java 1.6 or later. Keep note of the file path to "java.exe".
• Install the most current version of ​LibLinear. Keep note of the file paths to "train.exe" and predict.exe".
• Install the most current version of ​SvmRank. Keep note of the file paths to "svm_rank_learn.exe" and "svm_rank_classify.exe".

Installation

There are two installation choices: binary installer and compilation from source. Unless you are interested in modifying the ATT or understanding the nitty gritty of how it works, you will probably want to use the binary installer.

Binary Installer

Download and run the installer for the version you would like:

• 2.1.0 (5/27/2015)
• 2.0.0 (8/21/2014)
• 1.3 (5/27/2014)

After you run the installer, edit the configuration files in the Config sub-directory of the installation directory. Use values appropriate for your machine. Then run the ATT. If everything is installed/configured correctly, the system will start.

Compilation from Source

• Install a working version of Microsoft Visual Studio that is capable of running C# applications. ​Visual Studio Express 2013 is sufficient and free.
• Optional steps:
  • Go to Tools -> Extensions and Updates, then search for and install the License Header Manager. This is used to apply license text to each source code file.
  • Install the InstallShield Limited Edition for Visual Studio add-on if you want to build the installer package.
• Obtain the source code:
  • Clone the ATT GitHub repository.
  • Source archives:
    • 2.1.0 (5/27/2015) (zip, tar.gz)
    • 2.0.0 (8/21/2014) (zip, tar.gz)
    • 1.3 (5/27/2014) (zip, tar.gz)
• If you're going to build the installer or cut releases, edit "Installer\Installer.isl" replacing "C:\Users\matt\Documents\GitHub\asymmetric-threat-tracker" (or whatever appears) with the appropriate path to your local repository. This assumes that you have installed the InstallShield add-on as described above. If you're not going to work with the installer, skip this step.
• Open the ATT solution in Visual Studio by double-clicking the "ATT.sln" file.
• If you're not going to build the installer, unload the Installer project.
• Along the top menu in Visual Studio, change the configuration of the solution from "Debug" to "Release".
• Right-click the ATT project and select "Build".
• Copy "att_config.xml" from the ATT project into the Config folder within the GUI project. After copying, select the copied file and, within the properties window, set "Copy to Output Directory" to "Copy Always".
• Copy "gui_config.xml" from the GUI project into the Config folder within the GUI project. After copying, select the copied file and, within the properties window, set "Copy to Output Directory" to "Copy Always".
• Edit the "att_config.xml" and "gui_config.xml" files in Config appropriately for your machine. Consult the documentation within the config files for detailed instructions.
• Right-click the GUI project and select "Build".
• Right-click the GUI project and select "Set as Start Up Project".
• Run the ATT solution. If everything goes okay, it will initialize all of the database tables and present the GUI interface.