Имя

gwyddion — Отображение и анализ данных СЗМ

Аннотация

gwyddion [ОПЦИЯ...] [ФАЙЛ...]

Описание

Gwyddion – графическая программа отображения и анализа данных СЗМ (Сканирующей Зондовой Микроскопии), написанная с использованием Gtk+.

Параметры

Программа принимает все стандартные опции Gtk+, Gdk и GtkGLExt, такие, как --display или --sync. См. документацию по этим пакетам для описания опций тулкитов.

Поведение опции удалённого управления --remote-* не определено, когда на данном дисплее запущено более одного экземпляра Gwyddion. Они могут выбирать произвольный экземпляр программы для работы с ним. Последняя заданная опция удалённого управления (включая --new-instance) переопределяет все предыдущие заданные.

Если каталог задан как аргумент ФАЙЛ, программа открывает диалог выбора файлов в заданном каталоге.

Опции Gwyddion:

--help

Выводит короткую справку и завершается.

--version

Выводит информацию о версии и завершается.

--no-splash

Отключает заставку при старте.

--remote-new

Открывает на экране файлы заданные в командной строке в запущенном экземпляре Gwyddion. Запускает новый экземпляр, если ни одного не запущено.

Вероятно, это наиболее полезная из опций удалённого управления. Ассоциации с типами файлов обычно настроены для запуска Gwyddion с этой опцией.

--remote-existing

Запускает файлы, указанные в командной строке, в уже запущенном экземпляре Gwyddion. Возвращает ошибку, если ни одного экземпляра не запущено.

Может быть полезно для случая, если вы хотите обрабатывать ситуацию с незапущенным Gwyddion иным способом, отличным от его запуска.

--remote-query

Успешно завершается, если Gwyddion уже запущен на дисплее и печатает идентификатор экземпляра. Возвращает ошибку, если Gwyddion не запущен.

Идентификатор экземпляра зависит от используемого интерфейса удалённого управления. В некоторых случаях он представляет полезную информацию, как, например, глобальный идентификатор окна, в некоторых нет. С libXmu эта опция печатает X11 Window, на Win32 печатается HWND, в то время как с LibUnique печатается идентификатор запуска.

--new-instance

Запускает новый экземпляр программы. Может также использоваться чтобы проигнорировать предыдущие опции удалённого управления и убедиться, что будет запущен новый экземпляр, когда меняется режим управления программой по умолчанию.

--identify

Вместо запуска пользовательского интерфейса и открытия FILE, определяет тип файла для каждого и завершает свою работу.

Тип файла СЗМ, который будет напечатан, соответствует описанию, показанному в списке поддерживаемых форматов файлов в руководстве пользователя. За типом файла следует (в квадратных скобках) название модуля импорта файлов программы Gwyddion, который будет использован для загрузки файла, и оценка правильности детекции в баллах. Оценка значительно ниже 100 означает, что хотя в ходе детекции был найден возможно подходящий тип файла, но в правильности его детектирования нет уверенности.

Если тип файла вообще не распознан, то вместо типа файла печатается Unknown. Код выхода из программы будет 1 если любой из FILE не был распознан.

--check

Вместо запуска пользовательского интерфейса и открытия FILE, загружает файлы, проверяет их на наличие ошибок (выводя ошибки на стандартный вывод ошибок stderr) и завершается.

--convert-to-gwy=OUTFILE.gwy

Вместо запуска пользовательского интерфейса и открытия FILE, загружает файлы, объединяет все данные и записывает файл в формате GWY OUTFILE.gwy.

--disable-gl

Полностью отключает OpenGL, включая все проверки на его доступность. Эта опция, разумеется, будет действовать только в том случае, если Gwyddion был собран с поддержкой OpenGL, и наиболее заметным эффектом от её использование будет недоступность опции трёхмерного просмотра. Однако, эта опция может оказаться полезной в том случае, если система сломана настолько, что даже проверка поддержки OpenGL приводит к ошибкам X-сервера. Также она может оказаться полезной при удалённом запуске Gwyddion через перенаправление X11, в том случае, если время запуска оказывается чрезмерно долгим.

--log-to-file

Перенаправляет сообщения от GLib, Gtk+, Gwyddion, и т.д. в ~/.gwyddion/gwyddion.log или в файл, указанный в переменной окружения GWYDDION_LOGFILE. Эта опция наиболее полезна в среде Unix, поскольку на платформе Win32 сообщения по умолчанию перенаправляются в файл. Вывод сообщений в файл и на консоль не исключают друг друга, сообщения могут выводиться одновременно двумя вариантами.

--no-log-to-file

Предотвращает перенаправление сообщений от GLib, Gtk+, Gwyddion, и т.д. в файл. Наиболее полезна на платформе Win32 (где сообщения перенаправляются в файл по умолчанию).

--log-to-console

Выводит сообщения от GLib, Gtk+, Gwyddion, и т.д. на консоль. Точнее, отладочные сообщения выводятся в стандартный вывод, ошибки и предупреждения в стандартный поток ошибок. В Unix сообщения печатаются на консоль по умолчанию. Вывод сообщений в файл и на консоль не исключает друг друга, сообщения могут выводиться двумя вариантами одновременно.

--no-log-to-console

Отменяет вывод сообщений на консоль. Наиболее полезна под Unix, где сообщения выводятся на консоль по умолчанию.

--disable-modules=MODULE,...

Предотвращает регистрацию модулей с заданными именами. В основном полезно для разработки и отладки. Например, вам может пригодиться использование --disable-modules=pygwy при запуске под Valgrind для ускорения процесса (и возможно избежания дополнительных ошибок).

--startup-time

Печатает общее время, затраченное на выполнение различных задач при старте (и закрытии). Полезно только для разработчиков и людей, собирающихся пожаловаться на слишком медленный запуск.

Окружение

На Linux/Unix следующие переменные окружения используются для переопределения вкомпилированных путей установки (версия под MS Windows всегда рассматривает пути относительно места установки). Они предназначены для переопределения системных путей установки и не являются списком путей, они могут содержать только один путь.

GWYDDION_DATADIR

Основной каталог данных, куда были установлены файлы ресурсов (цветовые градиенты, материалы OpenGL, …). Gwyddion ищет файлы ресурсов в его подкаталоге gwyddion.

Если не установлено, по умолчанию используется вкомпилированное значение ${datadir} обычно установленное в /usr/local/share.

GWYDDION_LIBDIR

Основной каталог модулей, куда они были установлены. Gwyddion ищет модули в его подкаталоге gwyddion/modules.

Если не установлен, по умолчанию используется вкомпилированное значение ${libdir}, обычно установленное в /usr/local/lib или /usr/local/lib64.

GWYDDION_LIBEXECDIR

Основной каталог lib-exec, куда были установлены подключаемые модули. Gwyddion ищет подключаемые модули в его подкаталоге gwyddion/plugins.

Если не установлено, по умолчанию используется вкомпилированное значение ${libexecdir} обычно установленное в /usr/local/libexec.

GWYDDION_LOCALEDIR

Каталог данных о локализации, куда были установлены каталоги сообщений (переводы).

Если не установлен, по умолчанию используется вкомпилированное значение ${datadir}/locale обычно установленное в /usr/local/share/locale.

Другие переменные, которые влияют на поведение Gwyddion при запуске включают в себя переменные GLib+ и переменные Gtk+, а также некоторые специфичные для Gwyddion переменные:

GWYDDION_LOGFILE

Имя файла, куда перенаправляются сообщения журналов. На MS Windows сообщения всегда отправляются в файл, поскольку работа с терминалом там весьма затруднительна. Местоположение журналов по умолчанию, gwyddion.log в каталоге пользователя внутри Documents and Settings (или Users), может быть переопределено с помощью переменной окружения GWYDDION_LOGFILE. На unix сообщения по умолчанию отправляются на терминал, и эта переменная будет действовать только при задании опции --log-to-file.

Если Gwyddion собран с поддержкой OpenMP, он использует распараллеливание вычислений (не все модули это поддерживают, но значительная часть да). Переменные окружения OpenMP такие, как OMP_NUM_THREADS можно использовать для его настройки.

Файлы

~/.gwyddion/settings

Сохранённые пользовательские настройки и состояния инструментов. Не стоит редактировать при запущенном Gwyddion, он всё равно перезапишет этот файл при выходе.

~/.gwyddion/glmaterials, ~/.gwyddion/gradients, ...

Пользовательские каталоги с различными ресурсами (материалами OpenGL, цветовыми градиентами, ...).

$GWYDDION_DATADIR/gwyddion/glmaterials, $GWYDDION_DATADIR/gwyddion/gradients ...

То же самое для общесистемных ресурсов.

~/.gwyddion/pixmaps

Каталог для пользовательских иконок. В основном полезно при установке модулей в домашний каталог.

$GWYDDION_DATADIR/gwyddion/pixmaps,

То же самое для общесистемных иконок.

~/.gwyddion/modules

Каталог для пользовательских модулей. Они должны находиться в подкаталогах file, graph, process, layer и tools в зависимости от их вида, хотя это больше традиция, чем обязательное правило.

$GWYDDION_LIBDIR/gwyddion/modules,

То же самое для общесистемных модулей.

~/.gwyddion/plugins

Каталог для пользовательских подключаемых модулей. Они должны находиться в подкаталогах file и process в зависимости от их вида.

$GWYDDION_LIBEXECDIR/gwyddion/plugins,

То же самое для общесистемных подключаемых модулей.

~/.gwyddion/pygwy

Каталог для пользовательских скриптов и модулей на python.

См. также

gwyddion-thumbnailer(1), gxsm(1)