Настройки

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

Эти параметры настройки могут быть переданы во время выполнения программы с помощью параметров командной строки. Если параметры не передаются, то используются параметры из файла lig. Если в файле lig нет настроек, то применяются значения по умолчанию. Значения по умолчанию записаны в файле default.lig в папке, где находится исполняемый файл ligral. Если этот файл не существует, то будут использоваться значения, жёстко заданные в программе ligral.

Ниже приведены текущие доступные параметры настройки.

Шаг

Определение: этот параметр настройки используется для решателей с фиксированным шагом и определяет размер шага решателя. Значение по умолчанию: 0,01 секунды. Метод настройки:

• можно добавить параметр -s во время выполнения, например: ligral test.lig -s 0,01, чтобы установить размер шага равным 0,01 секунде;
• можно записать conf step_size = 0,01 в файле lig, что также приведёт к тому же результату.

Время

Определение: этот параметр настройки применяется ко всем решателям и устанавливает общее время моделирования. Значение по умолчанию: 10 секунд. Метод настройки:

• можно добавить параметр -t во время выполнения, например: ligral test.lig -t 10, чтобы задать общее время равным 10 секундам;
• можно написать conf stop_time = 10 в файле lig для достижения того же эффекта.

Папка вывода

Определение: все сигналы, помеченные как выходные в ligral (например, Scope, Print и PhaseDiagram), сохраняются в локальных файлах CSV (см. документацию модуля для подробностей). Кроме того, некоторые модули могут иметь выходные файлы, и этот параметр настройки определяет папку, в которой они сохраняются. Значение по умолчанию: выходные файлы помещаются в папку с тем же именем, что и файл lig. Если в файле lig не указана папка вывода, то выходные файлы будут помещены в папку folder/test/*, если программа запущена из папки folder и файл имеет имя test.lig. Метод настройки:

• можно добавить параметр -o во время выполнения, например: ligral test.lig -o out, чтобы указать папку вывода как out;
• можно записать conf output_folder = 'out' в файле lig для получения того же результата.

IP-адрес

Определение: программа ligral обменивается данными с другими программами через отправку и получение UDP-пакетов во время работы. Этот параметр настройки устанавливает IP-адрес шлюза. Значение по умолчанию: 127.0.0.1. Метод настройки:

• можно записать conf ip_address = '127.0.0.1' в файле lig, чтобы установить IP-адрес на 127.0.0.1.

Порт

Определение: программа ligral использует отправку и получение UDP-пакетов для обмена данными с другими программами во время работы. Этот параметр настройки задаёт порт приёма шлюза, а порт отправки равен порту приёма плюс один. Значения по умолчанию: порт приёма — 8783, порт отправки — 8784. Метод настройки:

• можно записать conf port = 8783 в файле lig, чтобы установить порт приёма равным 8783 и порт отправки равным 8784;
• также можно использовать listening_port и sending_port для настройки порта приёма и порта отправки соответственно.

Решатель

Определение: этот параметр настройки указывает, какой решатель используется для моделирования. В настоящее время доступны следующие решатели: ode1 (euler), ode2, ode2m, ode4, ode45 и другие, причём ode2m реализован в пакете control. Значение по умолчанию: ode4. Метод настройки:

• можно записать conf solver = 'ode2' в файле lig, чтобы выбрать решатель.

Моделирование в реальном времени

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

• можно записать conf realtime = true в файле lig, чтобы включить моделирование в реальном времени.

Интерпретатор Python

Определение: этот параметр настройки задаёт путь к исполняемому файлу Python (включая имя файла). Если файл уже находится в системном каталоге, можно указать только имя файла. На Windows обычно используется Python, а на Linux — Python3. В будущем может быть рассмотрена возможность автоматического определения системы и установки соответствующего значения по умолчанию. Значение по умолчанию: Python. Метод настройки:

• можно записать conf python = 'python' в файле lig, чтобы настроить путь к исполняемому файлу интерпретатора Python.

Информация об авторских правах

Определение: содержит набор параметров настройки, включая автора, дату, лицензию, адрес электронной почты и домашнюю страницу (или home_page), которые не влияют на работу программы. Значение по умолчанию: нет. Метод настройки:

• можно записать conf author = 'JRY Zheng' в файле lig.

Внутренний модуль построения графиков

Определение: набор параметров настройки для внутреннего модуля построения графиков. Параметры настройки:

• enable: включает или выключает внутренний модуль построения графиков;
• значение по умолчанию: выключен;
• метод настройки: conf inner_plotter.enable = true.
• output_script: сохраняет ли скрипт построения графика, действует только при моделировании не в реальном времени;
• значение по умолчанию: не сохранять скрипт;
• метод настройки: conf inner_plotter.output_script = true.
• save_figure: сохраняет ли график;
• значение по умолчанию: не сохраняет график;
• метод настройки: conf inner_plotter.save_figure = true.

Система ведения журнала

Определение: набор параметров настройки для системы ведения журнала. Параметры настройки:

• print_out: выводит ли журнал на экран;
• значение по умолчанию: да;
• метод настройки: conf logger.print_out = true.
• min_print_out_level: минимальный уровень журнала для вывода на экран (от низкого до высокого: debug, info, warning, prompt, error, fatal);
• значение по умолчанию: предупреждение;
• метод настройки: conf logger.min_print_out_level = 'warning'.
• min_log_file_level: минимальный уровень журнала для записи в файл;
• значение по умолчанию: информация;
• метод настройки: conf logger.min_log_file_level = 'info'.
• print_out_plain_text: выводить ли метаинформацию журнала (например, метку времени, отправителя и т.д.) на экран;
• значение по умолчанию: нет;
• метод настройки: conf logger.print_out_plain_text = false.
• log_file: файл журнала, пустой означает отсутствие вывода;
• значение по умолчанию: есть;
• метод настройки: conf logger.log_file = 'ligral.log'.

Линейный инструмент

Определение: набор параметров настройки линейного инструмента. См. линейный инструмент (linearizer.md) для использования.

Инструмент выравнивания

Определение: набор параметров настройки инструмента выравнивания. См. инструмент выравнивания (trimmer.md) для использования.

Инструмент изменения размера шага

Определение: набор параметров настройки инструмента изменения размера шага. См. инструмент изменения размера шага (variable_step_solver.md) для использования.