Gwyddion uses its custom data format
.gwy) to store data. This format has the following
Therefore, we recommend to use this format for saving of processed files.
Other data file formats are handled with appropriate file loading and saving modules. Beside a large number of file formats used in scanning probe microscopy, graphical file types (PNG, JPEG, TIFF, TARGA) and raw binary and text data can be imported too. If your SPM data format is not supported by Gwyddion yet or it is loaded incorrectly, you are encouraged to write an import module (if you can program) or contact the maintainers to help them improve the support.
The list of all supported file formats can be found in chapter Summaries and Tables.
Files are opened using
.dat are used for many different SPM file types this
approach is superior to relying on file extensions.
The only exception is the import of various raw data, either two-dimensional or graph, that must be chosen explicitly in the file open dialogue. See sections Raw Data File Import for details of import of raw data and manual extraction of data from unsupported formats and Specific Data Import for import of XYZ data, pixmap image data and graph data.
The list of files in the file open dialogue can be limited to only files Gwyddion recognizes as loadable by enabling the Show only loadable files option. The file type label then indicates the filtering by appending (filtered) to the end. This can be often convenient, on the other hand it can slow down listing of directories with many files.
The file list can be also filtered by name using the
Filter entry in the lower part. You can enter
either a file glob such as
*.dat or a file name
fragment such as
Press Enter to update the list after
modifying the filter.
A preview of the file content is show on the right side (for automatically loadable files). The small text above the preview shows the file type, i.e. name of the module used to load the file, and the number of images (img), graphs (gr), single-point spectra (sp), volume data (vol) and XYZ data (xyz) in the file.
File merging, performed by→ , is similar to normal file loading, except that the selected file (or files) is merged into the current open file. In other words, images, graphs and other types of data are added to those already present in the current file, together with all their settings and properties.
Much of the previous paragraphs applies to file saving too. One of the
main differences is the reliability of automatic file type determination.
While loading can and does examine the file contents, saving depends
on file name and extension. Combined with the large number of
different file types using the same extension such as
.dat it leads to ambiguities. Select the file
type explicitly before saving if you are unsure.
Since the only file type able to fully represent Gwyddion data
structures is its native data format, saving to
.gwy file is the only proper saving. Saving to
other file formats essentially consists of exporting of a limited
subset of the data, typically only the active image (without masks
and presentations). Therefore it does not
change the file name of the current file to the just saved file name.
export image data to graphics formats.
foo.png as the file name to export
a PNG image the current channel, similarly for other formats.
The history of recently opened files can be accessed with→ . The submenu contains the last 10 recently used files for quick recalling, an extensive recent file history is accessed with the last item .
Document history lists the files sorted by the last access time (the most recently accessed at the top), with previews and some additional information about a selected channel. The function of the bottom row of buttons is following:
The history can be searched/filtered by file name using the filter controls above the buttons. The filter is activated by pressing Enter in the filter pattern entry. To display all history entries, clear the entry and activate it. The filter pattern is interpreted in two ways:
?, it is interpreted as file glob. This means
?represents a single arbitrary character,
*represents an arbitrary sequence of zero or more characters, and the file name has to precisely match the pattern. Note directory separators (
\) are not treated specially, therefore in the pattern
*matches all leading directory components. The pattern syntax is described in GPatternSpec documentation.
Search case sensitivity, controlled by option Case sensitive, is useful mainly on systems distinguishing letter case in file names, such as Unix. On systems that do not distinguish the case themselves it is recommended to keep the setting on case insensitive.