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.