from_Solis: import kinetic series type

[ddkohler]

Changes

from_solis: imports "kinetic series" type data, which has multiple camera images. The camera images are stacked along the new axis "frame".

Checklist

• added tests, if applicable
• updated documentation, if applicable
• updated CHANGELOG.md
• tests pass

[ddkohler]

Check failure seems unrelated to the code changes. @ksunden anything to worry about?

[ksunden]

Does this have any relation to #973?

[ddkohler]

@ksunden somewhat related. In this PR, import discovers the data shape by inspecting the ascii array. One could determine the acquisition type/data shape from the metadata (fields Acquisition Mode, Number in Kinetic Series), so importing this acquisition type from metadata is a possible strategy. Metadata is optional in Solis exports, so importing based solely on metadata is not reliable.

[kameyer226]

does anyone know how long the method get_frames takes to actually get the frames? I haven't been impressed with Python's speed of handling for and while loops...reminds me of Matlab.

[ddkohler]

@kameyer226 from experience I can say that for "large" files (hundreds of MB) the whole import function can take seconds. I haven't been too concerned with run times of file opening, since they only need to be run once (after that they can be saved as wt5 files).

[untzag]

@ddkohler looks like we are removing support for a previous txt format? Is that intended?

[ddkohler]

@untzag I did changed the docstring, but support has not changed. I felt the docstring was misleading. Solis software exports readable files with an .asc suffix--there are never .txt files involved.