Скрипты — сверхмощное средство!

1. Введение в SPSS-скрипты (также известные как SAX Basic);
2. Перечень примеров скриптов;
3. Примеры скриптов;
4. Программы на Visual Basic (VB).

Введение

Скрипты, или сценарии — достаточно свежая струя в развитии SPSS. Если вы никогда не использовали Visual Basic (VB) или Visual Basic for Applications (VBA), изучение данной возможности программирования покажется вам нелёгким занятием. SPSS использует Sax Basic, разработанный компанией Sax Software. Добавив библиотеку типов (свойств и методов) Sax (Sax's Type Library) в вашу обычную среду разработки (например, VB6, Excel или Access), вы можете создавать сценарии SPSS, используя привычные средства. Таким образом, язык Sax Basic отличается от обычного Visual Basic лишь специальной библиотекой типов.

Скрипты позволяют пользователю сделать то, что нельзя сделать с помощью синтаксиса, например, отформатировать интерактивный график IGRAPH или создать обработчик ошибок. Когда это возможно, я предпочитаю использовать синтаксис вместо скриптов. По мере того, как моё знание синтаксиса росло, я открывал пути делать такие вещи, которые раньше мог делать только через скрипты, например, экспортировать или создать переменную, которая имеет те же метки значений, что и другая переменная. В то время, как синтаксис обрабатывается командным процессором SPSS, скрипты обрабатываются на уровне графической оболочки приложения и оперируют её объектами (документами), их свойствами и методами.

Скрипты могут быть вызваны из синтаксиса и наоборот. Однако важной особенностью здесь является параллельность (или асинхронность) выполнения вызванной программы. Так, например, синтаксис, вызывающий скрипт, не приостанавливается до окончания работы скрипта, а продолжает своё выполнение. При таком параллельном (несогласованном, асинхронном) исполнении этих двух процессов, возможно возникновение ошибок, если в ходе выполнения процессы должны обмениваться данными. Например, синтаксис может попытаться обратиться к результатам работы скрипта в то время, когда второй ещё выполняется (результаты отсутствуют). В некоторых случаях возникновение ошибок будет вовсе не очевидным и пользователь будет озадачен тем, что программа работает без видимых сбоев, но даёт неверные результаты! Таким образом, при комбинировании синтаксиса и скриптов нужно учитывать указанное обстоятельство и составлять программу соответствующим образом. Спасибо Кириллу Орлову за комментарии по данной теме для посетителей русской версии сайта.

Fabrizio Arosio разработал скрипт (см. раздел Утилиты ниже), который заставляет выполнять исходный код и вызываемый скрипт в синхронном режиме (последовательно, один за одним). Эта утилита работает, однако вы должны следить за тем, чтобы в конце синтаксиса не оставалось замыкающих пробелов (иначе возникает бесконечный цикл). См. также раздел «Об асинхронности» для получения дополнительной информации.

Важно отметить, что в версиях SPSS для Макинтош (Mac) скрипты использовать нельзя.

---

Перечень примеров скриптов

Скрипты сгруппированы по следующим темам:

1. Автоскрипты 
2. Работа с редактором данных (объект ISPSSDataDoc)
3. Диалоги
4. Распределения
5. Работа с простым окном результатов (Draft Output)
6. Величина эффекта
7. IGRAPH (интерактивные графики)
8. Импорт и экспорт (см. также соответствующий раздел синтаксиса)
9. Работа с метками переменных и значений (см. также соответствующий раздел синтаксиса)
10. Длинные имена переменных (требует версии 12+)
11. Форматирование выдачи
12. Работа с окном результатов (Output)
13. Печать
14. Мобильные (сводные, pivot) таблицы
15. Редактор синтаксиса
16. Специальные операции над данными
17. Утилиты
18. Работа с несколькими файлами (см. также соответствующий раздел синтаксиса)

---

Покажите мне данные, и я найду там ошибки!

---

Примеры скриптов

NB: Файлы со значком добавлены или обновлены менее 30 дней назад.

• Автоскрипты

  1. Автоматизация отладки.SBS Упрощает отладку автоскриптов
  2. Выделение итога в таблице SUMMARIZE или вставка разрыва страницы.SBS Это пример того, как синтаксис передаёт аргумент в автоскрипт. Такая возможность может быть очень полезной. Проверьте работоспособность с помощью этого синтаксиса.

     ▲ наверх

• Работа с редактором данных (объект ISPSSDataDoc)

  1. Отформатировать длину переменных.SBS Автоматически изменяет длину строковых переменных в любом sav-файле на длину таких же переменных из шаблонного sav-файла
  2. Создать пустой файл данных с n строчками.sbs (n определяет пользователь при запуске)
  3. Отобразить число наблюдений и переменных в файле данных.SBS
  4. Найти число наблюдений.SBS (работает и для взвешенных файлов)
  5. Загрузить данные и показать значения переменных во всплывающем окне.SBS
  6. Установить ширину колонок в редакторе данных по ширине переменных.sbs
  7. Разделить текущие данные на n групп.sbs (n определяет пользователь при запуске)

     ▲ наверх

• Диалоги

  1. Запрос имени файла у пользователя;
  2. Определение макроса с рабочей папкой по заданному пользователем имени файла;
  3. Запрос финансового года и запуск синтаксиса с этим параметром;
  4. Запрос имени пользователя и создание макроса с именем пользователя;
  5. Работа со списком переменных (1) (с сайта SPSS);
  6. Работа со списком переменных (2) (с сайта SPSS);
  7. Работа со списком переменных (3) (с сайта SPSS).

     ▲ наверх

• Распределения

  1. Графики распределений;
  2. Генерация и подгонка распределений случайных величин;
  3. Генерация случайных переменных (нормальное и равномерное распределения, асимметрия, корреляции, округление, пропущенные значения).

     ▲ наверх

• Работа с простым окном результатов (Draft Output)

  1. Очистить рабочее простое окно результатов.SBS

     ▲ наверх

• Величина эффекта

  1. Раздел синтакса «T-критерии, средние, дисперсионный анализ» содержит несколько примеров вычисления величины эффекта.

     ▲ наверх

• IGRAPH (интерактивные графики)

  1. Изменить цвет фона у всех интерактивных графиков в окне результатов.SBS
  2. Изменить цвет столбцов у всех интерактивных графиков без группирующих переменных.SBS
  3. Экспортировать все интерактивные графики в jpeg указанного размера.SBS
  4. Экспортировать выделенный интерактивный график в jpeg указанного размера.SBS
  5. Формат графика IGRAPH.SBS
  6. Формат графика IGRAPH.SPS (этот синтаксис создаёт данные, два графика и вызывает вышеприведённый скрипт)

     ▲ наверх

• Импорт и экспорт

  …MS Access:

  1. Импорт из SPSS через VBA в ACCESS.mdb Это файл MS Access 2000. См. инструкции в модуле GetSPSSvars.
  2. Экспорт меток из MS Access в SPSS.txt  Это код на Visual Basic.

     ▲ наверх

  …редактор данных (Data Editor):

  1. Экспорт содержимого сводных таблиц в редактор данных.SBS

     ▲ наверх

  …E-mail:

  1. Сохранить все вложения в указанную директорию.SBS (Это VB-скрипт для Outlook) Обрабатывает все сообщения в заданной папке.
  2. Отправить документ в качестве вложения по электронной почте.SBS Этот скрипт SaxBasic использует Outlook 2000 чтобы отослать сообщение со вложением заданному адресату. Вложением может быть HTML-файлом, созданным SPSS, или spo-файлом, или любым другим документом.

     ▲ наверх

  …Excel:

  1. Конвертация в формат Excel 5/95.SBS Ранние версии SPSS могли экспортировать данные в формат Excel 2.1; это — автоматическая конвертация в формат Excel 5/95.
  2. Экспорт таблиц на лист MS Excel.sbs
  3. Экспорт таблиц на лист MS Excel v2.sbs Тот же экспорт с последующей группировкой строк. Очень удобно.
  4. Экспорт таблиц на лист MS Excel v3.sbs  Аналогия с предыдущим, но добавлена опция экспорта графиков.
  5. Экспорт таблиц на лист MS Excel v4.sbs Развитие v3 — эта версия экспортирует все слои в сводных таблицах.

     ▲ наверх

  …HTML:

  1. Экспорт всех сводных таблиц из всех файлов spo в файлы HTM.SBS
  2. Экспорт целевых объектов из всех файлов spo в файлы HTM.SBS (это расширение предыдущего скрипта. Данная версия поддерживает выбор объектов IGRAPH)

     ▲ наверх

  …MS PowerPoint:

  1. Экспорт сводных таблиц (Pivot Tables) в PowerPoint.SBS
  2. Добавление/обновление данных из Excel в диаграмму PowerPoint.ZIP (845 Кб) Эта VB .NET-программа (автор Кирилл Орлов) для тех, кто наполняет графики PowerPoint данными из Excel (например, данными сводных таблиц, импортированных в Excel из SPSS output). Файл справки имеется.

     ▲ наверх

  …Stata:

  1. Из SPSS в STATA (англ.). Автор: Alasdair Crockett. Имеется Руководство по экспорту (англ.), объясняющее, как использовать этот скрипт. Ссылки даны на оригинальные (английские) версии документов, которые, скорее всего, не будут переводиться на русский язык, поскольку с 14 версии SPSS имеет встроенный импорт/экспорт файлов Stata.

     ▲ наверх

  …текстовый/Word-файл:

  1. Экспорт метаданных (словаря SPSS) в текстовый файл (автор — Jean-Francois Allaire);
  2. Экспорт сводных таблиц в Word (скрипт, разработанный корп. SPSS, с дополнительным форматированием таблиц от John Hendrickx);
  3. Экспорт .sav-файла в свободный текстовый формат;
  4. Экспорт видимой выдачи в Word через HTML  (можно указать, импортировать ссылки на графики, или встраивать графики в документ как картинки);

     ▲ наверх

  …XML:

  1. Экспорт файла данных SPSS в XML-файл (спасибо автору — Tom Diericks. Доп. информацию по XML см. на xmlfiles (англ.), в Википедии (рус.). Примеч: скрипт требует Microsoft XML parser не ниже версии 3.0. Можно загрузить с сайта Microsoft. Для версий SPSS от 11.0 и выше см. комментарий в тексте скрипта;
  2. Экспорт в Triple-S (скрипт создаёт XML-файл для Triple-S v1.2 и соответствующий .dat-файл из текущего файла данных SPSS). Спасибо автору — Chris Johnson;
  3. Экспорт данных из SPSS в Pulsar Beta 0.16 (спасибо Александру Бугакову). Скрипт основан на предыдущем решении от Криса Джонсона;
  4. Экспорт выдачи SPSS в формат XML.

     ▲ наверх

• Работа с метками переменных и значений

  1. Сделать приставку к именам всех переменных;
  2. Добавить слово «index» (или любое другое) в начало метки каждой переменной;
  3. Добавить метки значений вида «месяц, год»;
  4. Добавление календарных меток с помощью цикла и функции DateAdd;
  5. Вставка имени переменной в начало её метки;
  6. Назначение переменным меток, совпадающих с их именами (может быть реализовано через синтаксис);
  7. Запись меток переменных и значений заглавными буквами;
  8. Обеспечить отдельный вызов макроса для каждой метки значения данной переменной (очень полезный программистский приём);
  9. Определить макросы с метками переменных (можно реализовать и через синтаксис);
  10. Удалить метки значений у всех переменных;
  11. Экспорт меток переменных и значений в несколько текстовых файлов (спасибо Wouter Egberink, который прислал мне этот код)
  12. Экспорт имён и меток переменных в .txt-файл для импорта в MS Access;
  13. Копировать метки значений одной переменной в другую переменную (можно реализовать и через синтаксис);
  14. Удалить подписи строк и столбцов в таблице (перемещено в раздел Мобильные таблицы);
  15. «Обратный» AUTORECODE. Создание новой строковой переменной, значения которой являются метками соответствующих значений исходной (можно реализовать и через синтаксис). Решение для версий SPSS, ранее 10.0, адаптировано мной (А. Б.) к современным версиям;
  16. «Обратный» AUTORECODE — схожая адаптация решения, представленного выше, в версии автора.

      ▲ наверх

• Длинные имена переменных

  1. Длинные — в короткие и короткие .por-имена — в длинные. Скрипты автоматизируют переключение между короткими и длинными вариантами именования переменных в разных ситуациях. Скрипты сопряжены с данным файлом синтаксиса. Автор: Jon Peck, см. источник (англ.).

     ▲ наверх

• Форматирование выдачи

  1. Автоподгонка строк и столбцов всех мобильных таблиц;
  2. Применение шаблона TableLook ко всем готовым таблицам;
  3. Поиск/замена текста в мобильных таблицах;
  4. Добавление в частотные таблицы сносок со статистиками переменных;
  5. Автоподгонка—2 (масштабирование ширины таблицы для устранения переносов меток).

     ▲ наверх

• Работа с окном результатов (Output)

  1. Добавить в нужных местах разрывы страниц перед печатью (скрипт автоматически вставляет разрывы страниц в выдачу, подготовленную с помощью этого синтаксиса, который можно настроить под свои задачи);
  2. Как сделать для каждого синтаксиса свой файл результатов (из AnswerNet);
  3. Изменить метку и заголовок последней вызванной процедуры (автор: Michael Wexler);
  4. Создание нового окна результатов с указанным именем файла;
  5. Запись имени файла данных (.sav) в нижний колонтитул документа результатов (.spo);
  6. Убрать таблицы «Statistics», «Notes» и «Сase processing summary»;
  7. Очистить рабочее окно результатов;
  8. Правка текстового блока выдачи (скрипт вызывается этим синтаксисом);
  9. Вставка текстового блока в редактор выдачи SPSS Viewer (с эмуляцией нажатия клавиш);
  10. Построение оглавления таблиц и замена табличных заголовков по оглавлению;
  11. Удаление символов разрыва страницы;
  12. Замена меток «Page Title» в «дереве» выдачи на содержимое заголовков от команды «TITLE» (упрощает ориентирование в большом файле выдачи SPSS);
  13. Сохранение результатов в файл с указанным именем. Скрипт вызывается этим синтаксисом;
  14. Сохранение результатов в файл с указанным (в скрипте) именем;
  15. Поиск по меткам объектов в окне результатов;
  16. Выделение последней таблицы в текущем окне результатов;
  17. Построение и вставка перечня заголовков таблиц в файл с результатами (output);

      ▲ наверх

• Мобильные (сводные, pivot) таблицы

  1. Вставка сноски в каждую мобильную таблицу;
  2. Применить некоторые команды скрипта ко всем мобильным таблицам;
  3. Автоматизация вращения (pivoting) мобильных таблиц (примеры манипулирования слоями, строками и столбцами);
  4. Автоскрипт для форматирования таблицы с корреляциями (удаляет элементы на главной диагонали и выше её, выделяет значимые корреляции, переносит информацию о размере выборок и уровнях значимости в слои); Спасибо Ферду Бриттону (Ferd Britton);
  5. Изменить формат выдачи процедуры Means (скрипт вызывается из этого синтаксиса);
  6. Поиск/замена текста в мобильных таблицах (дубликат). Удобно, например, для перевода стандартных меток на другие языки/другую систему именований;
  7. Замена «Sig» на «p=»;
  8. Объединение в одну графу: «среднее ± станд. откл. » (скрипт вызывается из этого синтаксиса);
  9. Создание мобильной таблицы (Pivot Table);
  10. Создание таблицы из результатов ROC-анализа (скрипт вызывается из этого синтаксиса);
  11. Вырезать некоторые строки. Cпасибо автору, Марку Бакстеру (Mark Baxter);
  12. Поочерёдная демонстрация всех слоёв таблицы;
  13. Определить пользовательские заголовки. Примеч.: для избежания проблем, связанных с асинхронностью, полезно изменить скрипт так, чтобы он работал разом со всем окном результатов после окончания расчётов;
  14. Удаление сносок во всех таблицах;
  15. Транспонирование (строки — в столбцы, столбцы — в строки) мобильной таблицы;
  16. Скрыть столбцы «Valid Percent» и «Valid» в таблице «Frequencies» (это дополнение к следующему ниже скрипту);
  17. Скрыть столбец в мобильной таблице;
  18. Подсветка значимых уровней во всех таблицах ANOVA в назначенном окне результатов. (содержит хороший технический пример организации прохода по всем элементам выдачи);
  19. Подсветка значимых уровней в таблице к t-проверке для двух независимых выборок;
  20. Курсивное начертание процентных показателей;
  21. Выключка заголовков мобильных таблиц влево/вправо/по центру;
  22. Выделение итогов жирным шрифтом (применяется к выделенной таблице, может изменять и другие параметры: цвет шрифта и фона, отступы и проч.);
  23. Выделение итогов во всех таблицах (аналогичен предыдущему скрипту, но обрабатывает все таблицы в назначенном окне результатов);
  24. Раскрытие каждого слоя таблицы перед обработкой (см. аналогичный скрипт выше)
  25. Удаление значка процентов из ячеек мобильной таблицы (фактически, задаётся другой числовой формат);
  26. Замена пустых ячеек данных пользовательской константой;
  27. Обратить порядок следования столбцов;
  28. Разворот внутренних меток столбцов на 90° во всех таблицах;
  29. Округление частот в перекрёстных таблицах до заданного разряда;
  30. Установить число знаков после десятичной точки (для всех ячеек или определённого столбца);
  31. Установить число десятичных знаков для процентов;
  32. Замена текста в таблицах по заданному перечню;
  33. Управление шириной столбцов «через синтаксис» (пояснения находятся в этом файле синтаксиса). (Спасибо автору — Jason Burke — за модернизацию прежнего решения!);
  34. «Светофор»: условное форматирование ячеек;
  35. «Светофор» с фиксированными границами (как предыдущий скрипт, но без диалогового окна);
  36. «Светофор» с тремя граничными значениями;
  37. Заменить процентный формат;
  38. Заменить «научный» (##.#E±##) формат (стандартная процедура из файла Global.SBS);
  39. Отменить группировку строк или столбцов;
  40. Выделение значимых уровней в таблицах;
  41. Удаление подписей всех строк и столбцов в выделенной таблице.

      ▲ наверх

• Печать

  1. Печать всех .spo-файлов из папки по маске;
  2. Печать текущего файла синтаксиса через MS Word (автоматически добавляются путь, дата, время, номера страниц. Удобно назначить данному скрипту кнопку на панели инструментов окна редактора синтаксиса);
  3. Печать пути к файлу данных в нижнем колонтитуле файла выдачи;
  4. Настройка параметров печати файла выдачи (может работать в паре с синтаксисом). Решение AnswerNet;
  5. Настройка параметров печати файла выдачи (2). Другой вариант взаимодействия с синтаксисом: настройки печати скрипт берёт из журнала синтаксиса;
  6. Настройка параметров печати файла выдачи (3). Упрощенный вариант настройки. Можно добавить верхний колонтитул, дату и время, номера страниц;
  7. «Тумблер» отображения номеров страниц при печати файла выдачи (.spo).

     ▲ наверх

• Редактор синтаксиса

  1. Закрытие всех окон редактора синтаксиса.SBS
  2. Конвертирование синтаксиса в скрипт.sbs
  3. Поиск/замена в окне редактора синтаксиса.sbs
  4. Вставка текста из скрипта в окно синтаксиса.sbs
  5. Запуск синтаксиса в пакетном (batch) режиме.SBS Нахожу этот скрипт очень полезным. Его удобно «привязать» к кнопке на панели инструментов редактора синтаксиса, чтобы иметь возможность пускать синтаксис на исполнение до первой ошибки.
  6. Создание синтаксиса, описывающего метки переменных и значений.SBS

     ▲ наверх

• Специальные операции над данными

  1. Задать коды пропущенных значений для всех числовых переменных.SBS
  2. Стандартизация значений по строкам.sbs

     ▲ наверх

• Утилиты

  1. Добавить текущую дату ко всем файлам *.sav в заданной папке.SBS
  2. Ежечасная загрузка и обработка данных с экспортом результатов в HTML.SPS
  3. Автоматический запуск скрипта или синтаксиса при каждом запуске SPSS.SBS
  4. Вызов скрипта B из скрипта A.SBS
  5. Конвертация синтаксиса для вызова его из скрипта.SPS (автор — Rolf Kjoeller)
  6. Создание нового окна результатов (output).sbs
  7. DOS.sbs Это скрипт для запуска команды DOS или .bat-файла из синтаксиса; автор — Fabrizio
  8. Расстояние Левенштейна между двумя строками (скрипт работает в паре с данным синтаксисом);
  9. Работа с состоянием окна программы.SBS (сворачиваем и разворачиваем)
  10. Заготовка скрипта: выбор нужной процедуры в зависимости от переданного из синтаксиса параметра.SBS
  11. Включение даты из файла данных в имя этого файла.SBS
  12. Запуск скриптов из синтаксиса.sbs Скрипт написан Fabrizio для того, чтобы обойти проблему асинхронного выполнения скриптов. При запуске следует убедиться, в конце выполняемого синтаксиса отсутствуют лишние пробелы и пустые строки.
  13. Переключение выдачи между обычным и текстовым окнами результатов.sbs (автор — Karel Asselberghs)
  14. Доработка синтаксиса: расстановка точек-терминаторов.SBS
  15. Запись оглавления окна результатов в текстовый файл.SBS

      ▲ наверх

• Работа с несколькими файлами

  (см. также соответствующий раздел синтаксиса)
  1. Объединить все .sav-файлы из заданной папки.SBS (пользователь указывает путь и маску имени файла, скрипт делает остальное… В итоговый .sav-файл добавляется переменная, указывающая на файл-источник записей)
  2. Объединить все .sav или текстовые файлы из заданной папки.SBS Это расширение предыдущего скрипта. Данная версия может объединять либо .sav-файлы, либо файлы текстового формата. Также добавляется переменная, указывающая на источник каждой записи. Перед использованием следует подправить команду GET DATA под соответствующий формат текстового файла
  3. Конвертация всех файлов из папки в другой формат.SBS Может конвертировать… 
     из *sav в *.por
     из *.por в *.sav
     из *.sav в *.xls
  4. Создать отдельный .sav-файл из каждого .txt-файла.SBS
  5. Экспорт всех сводных таблиц (и/или графиков) из всех .spo-файлов в файл .htm.SBS (обрабатываются файлы .spo, расположенные в заданной папке и удовлетворяющие заданной маске. На каждый .spo-файл создаётся отдельный файл .htm)
  6. Экспорт объектов заданных типов из всех .spo-файлов в .htm-файл.SBS (это развитие предыдущего скрипта; поддерживает кроме сводных таблиц и графиков ещё и объекты IGRAPH)
  7. Перечислить все файлы в указанной директории.SBS
  8. Единообразно обработать 17 архивированных .zip-файлов.SBS

     ▲ наверх

---

Программы на Visual Basic (VB)

spssrun.exe

Автор программы: Alexis-Michel Mugabushaka из университета Касселя, Германия. Действие программы аналогично SPSS Production's facility. Вы «кормите» её перечнем файлов синтаксиса или указываете файл, содержащий такой перечень. Программа запускает файлы синтаксиса один за другим и создаёт отдельный для каждого синтаксиса файл выдачи, имеющий то же имя, что и файл синтаксиса. См. также Как сделать для каждого синтаксиса свой файл результатов.SBS

ViewSav

ViewSav — кодировочная таблица для файлов данных SPSS. Облегчает просмотр словаря и базовые манипуляции с описанием переменных. Автор программы: Karel Asselberghs с факультета социологии университета Амстердама. На его сайте есть ещё 2 утилиты SPSS: CRC32SAV и LISTSAV. Первая считает и сравнивает контрольную сумму для разных частей файла данных SPSS: заголовка, словаря и самих данных. Это позволяет вам проверить 2 файла с данными на абсолютную идентичность. Вторая утилита выводит переменные и метки их значений в один список (исходный код прилагается).

▲ наверх