afmformats.formats.fmt_workshop.ws_map
¶
Functions¶
load_map()
: Load a set of zipped csv AFM workshop data
- afmformats.formats.fmt_workshop.ws_map.load_map(path, callback=None, meta_override=None)[source]¶
Load a set of zipped csv AFM workshop data
If you are recording quantitative force-maps (i.e. multiple curves on an x-y-grid) with AFM workshop setups, then you might have realized that you get multiple .csv files (one file per indentation) instead of one file that contains all the data (as you might be accustomed to from other manufacturers). Since afmformats expects one file per measurement, it would not be straight forward to obtain a properly enumerated quantitative imaging group.
This function offers a workaround - it loads a zip archive created from the the .csv files.
The files are structured like this:
Force-Distance Curve File Format: 3 Date: Wednesday, August 1, 2018 Time: 1:07:47 PM Mode: Mapping Point: 16 X, um: 27.250000 Y, um: 27.250000 Extend Z-Sense(nm),Extend T-B(V),Retract Z-Sense(nm),Retract T-B(V) 13777.9288,0.6875,14167.9288,1.0917 13778.9288,0.6874,14166.9288,1.0722 13779.9288,0.6876,14165.9288,1.0693 13780.9288,0.6877,14164.9288,1.0824 13781.9288,0.6875,14163.9288,1.0989 ...
Please make sure that the
Point
is enumerated from 1 onwards (and matches the alphanumerical order of the files in the archive) and thatMode
isMapping
. TheX
andY
coordinates can be used by e.g. PyJibe to display QMap data on a grid.- Parameters
path (str or pathlib.Path) – path to zip file containing AFM workshop .csv files
callback (callable) – function for progress tracking; must accept a float in [0, 1] as an argument.
meta_override (dict) – if specified, contains key-value pairs of metadata that are used when loading the files (see
afmformats.meta.META_FIELDS
)