Allow to customize the file path for saving the summary file

No changes in any analysis procedures have been introduced. Thus, data analyzed with this version are fully compatible to data analyzed with the previous version.

New in v0.2.4

1. Customizing file path for saving the summary file

The extended settings dialog now contains an additional section:

In this section, the user may customize the path at which the summary txt-file will be stored after processing all images. In previous versions the summary was always set to the "Desktop" path. Still by default, the file path here is set to the Desktop path. Now, the user can customize the path here if needed.

2. Warning if the summary file path is not correct

SpermQ will alert you if it cannot find the summary file path and ask you to correct the indicated path.

When you press OK in this dialog, it will pop up again in case you still have not provide a correct file path.

3. Catching exceptions when saving txt files

SpermQ now detects if a writing exception occurs while writing output text files and warn the user if that occurs.

4. Indicating the exact path where the summary was stored

After processing all images, SpermQ now provides the exact file path where the summary was stored, so that the file can be easily retrieved:

Show whole flagellum in oriented flagellum image ("...oriZCmedian.tif") for sperm of length > 130 µm

In previous versions (v0.2.2 and older), the following issue could occur:
The field of view for plotting the oriented flagellar track (file ending "oriZCmedian.tif" in the results folder) was limited to a fixed field of view of -50 to 130 µm in X and -130 to 130 µm in Y. Thus, when analyzing very long sperm (e.g., length > 150 µm), the end of the flagellum was eventually not displayed.

In the new version (v0.2.3), the field of view will be automatically extended if the flagellar track exceeds these fixed limits.

Note, that the "oriZCmedian.tif" output file from SpermQ is used to generate the plot "(D) Overlay of one beat cycle" in the PDFs generated by (SpermQ Evaluator)[https://github.com/IIIImaging/SpermQ_Evaluator].

Example:

"(D) Overlay of one beat cycle" plot generated with SpermQ and SpermQ Evaluator based on an artificial image showing a sperm of length of about 350 µm. Left: SpermQ version v0.2.2 applied. Right: SpermQ version v0.2.3 applied.

Additional output of flagellar coordinates

The new SpermQ version features the output of flagellar x and y coordinates as files with the endings _coordX.txt and _coordY.txt, respectively. The new output files contain tab-delimited tables, describing the flagellar x or y position, respectively, as a function of the arclength (columns) and time (rows).

Fix bug in file selection on Mac OS X

In previous versions a bug appeared: when files were selected by the user, not all home directories could be accessed. This bug is fixed now.

Initial Online Release

Initial online releasen for the SpermQ ImageJ plugin.