libivcmp

Библиотека для сравнения кривых ВАХ.

Инструкция для Linux

1. Установите CMake:

   sudo apt update
   sudo apt install cmake build-essential

2. Создайте отдельную папку для сборки внутри проекта и перейдите в нее:

   mkdir build
   cd build

3. Сгенерируйте файлы конфигурации и соберите проект:

   cmake ..
   make

   В папке build появятся библиотека libivcmp.so и исполняемый файл ivcmpexample с примером.

4. Чтобы запустить пример, выполните команду (находясь в папке build):

   LD_LIBRARY_PATH=. ./ivcmpexample

Инструкция для Windows

1. Для сборки под Windows понадобятся CMake, MinGW (или MSVC) и Redistributable Packages 2013.
2. Для генерации файлов проекта откройте CMake GUI:
   • В поле "Where is the source code" укажите полный путь до корневой папки проекта ivcmp.
   • В поле "Where to build the binaries" укажите путь до каталога, куда будут помещены файлы сборки. Рекомендуется использовать папку build внутри каталога проекта.
   • Нажмите кнопку "Configure". В появившемся окне выберите генератор в зависимости от вашего компилятора (MinGW Makefiles или Visual Studio 2013), затем нажмите "Finish".
   • После успешной конфигурации нажмите кнопку "Generate".
3. Далее выполните сборку в зависимости от выбранного генератора:

   • Для Visual Studio 2013

     • В интерфейсе CMake GUI нажмите кнопку "Open Project".
     • В открывшемся окне Visual Studio выберите конфигурацию (например, Release) и соберите проект через меню Сборка -> Собрать решение (Build -> Build Solution).
     • Готово. Исполняемый файл ivcmpexample.exe, а также библиотека ivcmp.dll и файл связи ivcmp.lib появятся в подпапке Release (или Debug).

   • Для MinGW

     • Откройте командную строку и перейдите в созданную директорию сборки:

       cd путь/к/папке/build
       

     • Выполните сборку mingw:

       mingw32-make
       

       (путь до mingw должен быть в системных путях)

     • Готово. Исполняемый файл ivcmpexample.exe и библиотека ivcmp.dll будут находиться в папке сборки.

Отладочные данные

В исходном коде библиотеки в файле ivcmp.c есть макроопределение #define DEBUG_FILE_OUTPUT. По умолчанию оно закомментировано. Если его раскомментировать, библиотека начнет сохранять промежуточные состояния кривых и другую отладочную информацию в текстовые файлы.

Для построения графиков по этим данным в папке utils подготовлен скрипт plot_debug_data.py.

Порядок действий для визуализации

1. Раскомментируйте строку #define DEBUG_FILE_OUTPUT в файле ivcmp.c.

2. Пересоберите библиотеку по инструкции выше.

3. Выполните сравнение кривых с помощью обновленной библиотеки, чтобы в рабочей директории сгенерировались текстовые файлы с отладочными данными.

4. Скопируйте скрипт plot_debug_data.py в папку с отладочными файлами.

5. Установите необходимую библиотеку matplotlib:

   python -m pip install --upgrade pip
   python -m pip install matplotlib

6. Запустите скрипт визуализации:

   python plot_debug_data.py