REQUIRMENTS
1.1 ImageJ
SMLocalizer require ImageJ2.0 (http://imagej.net/) or Fiji (https://fiji.sc/) to function. SMLocalizer will require writing privileges to the preference file ImageJ or Fiji, so the files needs to be placed in a location where the user has privileges, for example in C:\User\User\My Documents.
1.2 OS and hardware requirements
SMLocalizer will run on any system capable of running ImageJ or Fiji. At time of writing this includes (taken from http://imagej.net/Downloads) :
ImageJ will run on any system that has a Java 8 (or later) runtime installed. This includes, but is not limited to:
- Windows XP, Vista, 7 or 8 with Java installed from java.com
- Mac OS X 10.8 "Mountain Lion" or later with Java installed from java.com
- Ubuntu Linux 12.04 LTS or later with OpenJDK 8 installed
SMLM images are typically large, as such, SMLocalizer requires that the java heap space memory be set high enough for the files the user intends to load. Typical values should be 3x the raw data file size.
1.3 GPU acceleration
For GPU accelerated computation SMLocalizer 2.0 requires a NVIDIA geforce gtx970 or later graphics card. Older version may work but has not been tested. The main limitation is memory available, with the current code expecting 4 GB of memory available. Ensure that the latest drivers for the graphics card is installed. For windows, timeout can be an issue for larger data files, this can be fixed through changing the graphic device timout to 10+ seconds, see http://answers.microsoft.com for details on this.
The OS specific CUDA archives needs to be places in \plugins\jars directory of the main ImageJ directory (or into \jars for Fiji). Further, the .DLL (windows) or .SO (linux) files as well as CUDA .ptx files needs to be placed in the main directory. These files can be downloaded from https://sourceforge.net/projects/smlocalizer/files/?source=navbar in a .rar format. Download the Fiji or ImageJ .rar folder and extract it into the main directory.
INSTALLING SMLOCALIZER
Download the SMLocalizer.jar file from https://sourceforge.net/projects/smlocalizer/files/?source=navbar and start ImageJ/Fiji. In the plugins menu, select install Plugins and select the downloaded .jar file. Restart when promted. SMLocalizer is now installed and ready to use.