slg: Stimuli List Generator

Program for automatic genaration of stimuli lists with given parameters.

Description
Setup
Usage
Bug tracker

Description

The program allows you:

  • automatically generate one stimuli list of given length with filters against categorical and/or numeric parameters
    For example, you have initial list of 200 verbs with the categorical parameters «instumentality» and the numeric parameters «frequency» and «imageability». From this list you can randomly generate a list of 30 instrumental verbs with the frequency from 35 to 100 and the imageability less than 3. Or, for example, a list of 40 verbs, 20 of them being instrumental and 20 being non-instrumental.
  • сгенерировать два листа, выбрав фильтры, а также (опционально) задав переменные, по которым эти листы не должны статистически различаться, и переменную, по которой они должны различаться
    Например, у нас все тот же список из 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

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

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

[contact-form-7 404 "Not Found"]