slg: Stimuli List Generator

Программа для автоматической генерации стимульных листов с заданными характеристиками.

Описание работы программы
Установка и запуск программы
Инструкция по использованию
Сообщить об ошибке
Скачать программу

Описание работы программы

С помощью программы вы можете:

  • сгенерировать автоматически один лист заданной длины со стимулами, задав фильтры категориальных и количественных переменных
    Например, у вас есть исходный список из 200 глаголов с категориальными параметром «инструментальность» и количественными «частотность» и «представимость». Вы можете из этого списка сгенерировать случайным образом лист, например из 30 инструментальных глаголов с частотой от 35 до 100 и представимостью меньше трех. Или список из 40 глаголов, из которых 20 будут инструментальными и 20 неинструментальными.
  • сгенерировать два листа, выбрав фильтры, а также (опционально) задав переменные, по которым эти листы не должны статистически различаться, и переменную, по которой они должны различаться
    Например, у нас все тот же список из 200 глаголов с категориальными параметром «инструментальность» и количественными «частотность» и «представимость». Вы можете из этого списка сгенерировать два листа так, чтобы они значимо отличались по частотности входящих в них глаголов (один лист с высокочастотными глаголами, другой — с низкочастотными), и при этом чтобы они не различались по переменной «представимость».

Установка и запуск программы

Windows

Если вы пользуетесь ОС Windows и у вас на компьютере не установлен Python 2.7, вы можете воспользоваться пакетом установки для Windows, скачав его по ссылке внизу. В этом случае ваш порядок действий следующий:

  • скачиваете и запускаете пакет установки setup-slg-0.x.exe
  • указываете папку для установки. Важно: НЕ указывайте папку, для которой установлены права администратора (вроде C:\\Program Files). Лучше всего установите просто в корень диска (например, D:\\slg)
  • обязательно установите галочку напротив «создать ярлык на рабочем столе». Этот ярлык необходим для запуска программы

Для запуска программы вам необходимо кликнуть дважды на созданный ярлык на рабочем столе. После этого запустится окно командной стоки, его можно свернуть (не закрывая: в нем в фоновом режиме запущена программа). Одновременно с этим запустится окно браузера по умолчанию, и в нем откроется ссылка с адресом http://127.0.0.1/ и приветственным окном программы. Если вы в какой-то момент закрыли окно браузера, программа будет продолжать работать, и можно снова зайти по этому адресу и возобновить работу. Для того, чтобы завершить работу программы, необходимо просто закрыть окно командной строки.

Linux

Если вы используете Linux, вы можете скачать исходный код из репозитория по ссылке внизу. Для работы программы требуется наличие следующих компонентов:

  • Python 2.7
  • Numpy, SciPy. Для установки можно воспользоваться командой:
    $ pip install numpy scipy matplotlib ipython jupyter pandas sympy nose
  • Flask. Для установки можно воспользоваться командой:
    $ pip install Flask

Для запуска программы вам необходимо перейти в каталог с основным скриптом app.py и запустить его, набрав в терминале:
$ cd slg/slg/
$ python app.py

После этого запустится окно браузера по умолчанию, и в нем откроется ссылка с адресом http://127.0.0.1/ и приветственным окном программы. Если вы в какой-то момент закрыли окно браузера, программа будет продолжать работать, и можно снова зайти по этому адресу и возобновить работу. Для того, чтобы завершить работу программы, необходимо вернуться в терминал и завершить процесс, нажав ctrl + C.

Инструкция по использованию

После запуска программы следуйте инструкциям в интерфейсе. Порядок создания листов следующий:

  • на первой странице вы выбираете количество листов, которые вы хотите создать (1 или 2)
  • после нажатия кнопки далее произойдет считывание исходного файла с данными и, если во время считывания произойдет ошибка, появится соответствующее сообщение
  • далее появится страница с выбором параметров для листов. Фильтры количественных параметров работают включительно
  • на третьей странице выбираете размер листов и статистический тест (если необходим). После генерации листов созданный zip-файл будет сохранен в папку по умолчанию с загружаемыми файлами из браузера

Создание файла со стимулами

Для того, чтобы использовать программу для генерации стимулов из вашего собственного исходного файла, необходимо подготовить этот файл в соответствии с формальными требованиями:

  • файл должен называться data.tsv и находиться в каталоге slg/slg/data/. При установке программы изначально там находится файл с таким именем с изначальным списком стимулов. Этот файл необходимо заменить на свой
  • файл представляет из себя текстовый документ в формате tsv (tab-separated values) в кодировке utf-8. Это значит, что на каждой строке находится строка таблицы, а колонки разделены знаком табуляции. Самый простой способ создать такой файл – создать таблицу в редакторе таблиц (MS Excel, LibreOffice Calc) и скопировать в текстовый редактор
  • первая колонка всегда называется name и в ней указываются названия стимулов
  • количество и названия остальных колонок опциональны
  • допускаются переменные только трех типов: categorical, float или int. Тип переменной указывается во второй строке нужной колонки
  • разделитель для floatточка
  • если какое-то значение нерелевантно для данного стимула, то в ячейку записывается NR (например, инструментальность для существительных)

Пример таблицы:

name POS instrumentality frequency phonemes
categorical categorical float int
1. автобус (a bus) noun NR 64.8 7
2. автомат (a sub-machine gun) noun NR 56 7
3. бинтовать (bandage tr) verb on 0.7 8

Сообщить об ошибке

Пожалуйста, укажите как можно более подробно условия, в которых возникла ошибка, ваши действия, при которых она возникла, и какие данные были переданы для обработки программой, по адресу stimulidatabase@gmail.com

Скачать программу

Ссылка для скачивания:
Windows, пакет установки
Linux