Menu
▾
▴
#3 File PlugIn for Nanonis File Format
here is the specification for the nanonis file format,
which would be nice to be implemented.
Nanonis File Format Version 1
A Nanonis file format consists of am ASCII header
followed by the binary image data.
Header
The header consiste of tags surrounded by colons (':')
followed by one or more lines of values. The file has
to start with the tag NANONIS_VERSION. The following
tags are recognized as of version 1 of the file format.
SCANIT_TYPE Describes the data format for the binary
data. Usually this is FLOAT LSBFIRST, ie., the binary
data is stored as 4-byte floating point data with the
least significant bit first.
REC_DATE Date at which the image was taken. The format
is dd.mm.yyyy.
REC_TIME Time at which the image was taken. The format
is hh:mm:ss.
REC_TEMP Temperature during the scan. Unit is Kelvin [K].
ACQ_TIME Time it took to take the image. Unit is
seconds [s].
SCAN_PIXEL 2x1 array, number of pixels in x- and
y-direction.
SCAN_FILE File name under which the file was originally
stored.
SCAN_TIME Time per line for forward and backward scan.
Unit is seconds [s].
SCAN_RANGE Scan range in x and y. Units are meters [m].
SCAN_OFFSET Offset in x and y for the scan. Unit is
meters [m].
SCAN_ANGLE Rotation angle of the image. Unit is degrees
[deg].
SCAN_DIR Direction of the scan. Can be 'up' or 'down'.
BIAS
Bias voltage at the time when file was saved. Unit is
volts [V].
Z-CONTROLLER
Only available when selected to include in scan file.
Contains information about the selected controller at
the time when file was saved. The first line shows the
parameter names (tab-separated), the second line gives
the values. The parameters are: Controller name, on/off
(0/1), setpoint, proportional gain, integral gain.
DATA_INFO This field contains information about the
channels in the file. The first line after the header
contains a tab-separated list with the field
description of the lines following. Usually this is
Channel, Name, Unit, Direction, Calibration and Offset.
The data in the fields Calibration and Offset can be
used to reverse calculate the voltage read at the AD
converters. It is not needed for the calibration of the
data.
SCANIT_END End of header.
Binary Data
The binary data begins after the header and is
introduced by the (hex) code \1A\04. According to
SCANIT_TYPE the data is encoded in 4 byte big endian
floats. The channels are stored one after the other,
forward scan followed by backward scan.
The data is stored chronologically as it is recorded.
On an up-scan, the first point corresponds to the lower
left corner of the scanfield (forward scan). On a
down-scan, it is the upper left corner of the
scanfield. Hence, backward scan data start on the right
side of the scanfield.
best regards
-- tuxmas
Logged In: YES
user_id=238291
Could you please send an example file to
my address? I will see what I can do.
Please include a screenshot or bitmap,
so that I can see what to expect...
stefan
Logged In: YES
user_id=1546751
Originator: YES
hi stefan
I found this posting again but can't remember if we where able to import the nanonis files to gxsm. was it you to ask for help at the gwyddion project? meanwhile there is a file importet for nanonis implemented, so you could also use it for gxsm
-- tuxmas
Logged In: YES
user_id=90747
Originator: NO
What is the status, I do not know about it existing so far.
A sample data file would help also.
Is there a current need for it? Priorities?
Logged In: YES
user_id=1546751
Originator: YES
Changed priority to 1 because there is no need of it at the moment.
Think this would only be a "nice-to-have" feature in gxsm.
Logged In: YES
user_id=238291
Originator: NO
Once upon a time I wrote a python-script to import nanonis files to Gxsm.
Didn't I check it in?
Yo
Stefan
Logged In: YES
user_id=1546751
Originator: YES
I only remember that you sent it to me by mail, but I have to apologize that I don't know if it worked. I believe it did, otherwise I would have responded with another request...
any one started on this?
who is still interested in this?
may attach a sample file here for testing!