The plugin allows one to import spatio-temporal detections from a text file and also to export them.
The type of detection objects is DetectionResult which is part of the plugin SpotDetectionUtilities (plugins.nchenouard.spot.DetectionResult).
Objects are imported into the 'Swimming Pool' of ICY from where they can be used by other plugins, in particular the Spot Tracking plugin.
The plugin also allows one to proceed in the reverse direction: save some detection present in the Swimming Pool (for instance created by the Spot Detector plugin) into a text file.
The format of the exported/imported text file should be as follows: each line of the text file corresponds to a different detection, and each column (separated by a space) corresponds to a feature of the detection.
The columns are the following:
- Time: a positive integer value
- x-axis coordinate: a floating number
- y-axis coordinate: a floating number
- z-axis coordinate: a floating number
- intensity mean: a floating number
- min intensity value: a floating number
- max intensity value: a floating number
An example of valid file is the following:
0 488.0 504.5 0.0 875.5 863.0 888.0
1 288.625 137.125 0.0 926.5 730.0 1098.0
1 148.0 40.0 0.0 694.0 694.0 694.0
2 189.0 400.0 0.0 798.0 798.0 798.0
which corresponds to one detection at time 0, two detections at time 1, and one detection at time 2.
Note for developpers
import and export functions are public and usable in a static manner:
public static boolean exportResultsToFile(File f, DetectionResult dr); // export the results dr to the file f
public static boolean importResultsFromFileToPool(File f); // import results from file f into the SwimmingPool
public static DetectionResult importResultsFromFile(File f); // reads and returns the detections in file f
for a description of the object DetectionResult see plugins.nchenouard.spot.DetectionResult in the plugin Spot Detection Utilities.