Что из себя представляет проект?

Отчет по проекту

В проекте реализован расчет электродвижущей силы плоской катушки, приводящейся во вращение двигателем, находящейся в однородном магнитном поле катушек Гельмгольца, для исследования явления электромагнитной индукции.

Создатели проекта

• Шахрай Вадим - программирование;
• Зуев Андрей - физика;
• Мироненко Алиса - 3D-модели приборов и устройств.

Краткое руководство по использованию программы

Экран приложения поделен на 2 окна:

• Окно моделирования;
• Окно настроек.

Окно моделирования

В этом окне происходит 3D-симуляция маленькой комнаты, в центре которой находится стол с различными приборами и устройствами. Приборы и устройства являются интерактивными - их можно включать по кнопке "Пуск", менять их параметры и подключать друг к другу проводами.

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

При наведении курсора мыши на интерактивный элемент какого-либо прибора или устройства, иконка курсора будет сменяться на следующие:

• - вращение, крутить колесико мыши;
• - нажатие на кнопку, нажать на левую кнопку мыши (ЛКМ);
• - выбор провода, нажать ЛКМ;
• - отмена выбора провода, нажать ЛКМ;
• - подключить провод к клемме, нажать ЛКМ;
• - отключить провод от клеммы, нажать ЛКМ.

Также вам доступно управление камерой: вращение, изменение расстояния до объекта и смена объекта просмотра (подробнее ниже). Вращение камерой осуществляется с помощью зажатия правой кнопки мыши (ПКМ) и движения мыши в стороны, а расстояние до объекта - с помощью зажатия средней кнопки мыши (СКМ) и движения мыши в сторону.

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

• Специальный цветовой индикатор корректности существующих соединений (зеленый - все соединения корректны, желтый - не все провода использованы, красный - есть некорректное соединение);
• Кнопки автоматического подключения и отключения всех проводов сразу;
• Кнопка просмотра корректных схем подключения.

Справа от него находиться блок смены объекта, на который направлена камера. В качестве объектов выступают приборы и устройства, находящиеся на столе. Они обозначены первой буквой их названия. Чтобы выбрать объект просмотра, нужно нажать на него курсором мыши. Чтобы отменить выбор (камера вернется в свое начальное положение), достаточно снова кликнуть на выбранный объект. В самом краю находится кнопка сокрытия окна "Настройки".

Окно настроек

Данное окно разделено на 3 секции:

• Вспомогательные кнопки;
• Результаты;
• Настройка приборов и устройств.

Вспомогательные кнопки представляют из себя переключатель темы приложения (светлая/темная), переключатель языка интерфейса (русский/английский) и кнопку для скачивания отчета по проекту, который содержит в себе полное его описание.

В секции "Результаты" будут выводиться контрольные значения эксперимента.

Последняя секция представляет из себя альтернативную и более точную систему для настройки параметров приборов и устройств. Также она содержит дополнительную информацию: используемые константы и пр.

Как запустить проект?

Данный проект доступен всем по ссылке https://vadimshahray.github.io/flat-coil-in-magnetic-field/. Если вы хотите клонировать данный репозиторий и запустить проект на локальной машине, на ней должна быть установлена Node.js.

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

npm install
npm start

или с помощью yarn:

yarn install
yarn start

Физика проекта

Информация о физике, используемой в проекте, находится в этом отчете.

Файловая структура проекта

├───public - статичные данные
└───src - рабочий корень проекта
    ├───components - UI/UX компоненты
    ├───constants - константы
    ├───hooks - React-хуки
    ├───models - 3D-компоненты
    ├───pages - web-страницы проекта
    ├───providers - провайдеры данных
    ├───selectors - Redux-селекторы
    ├───slices - Redux-слайсы
    ├───storage - локальное хранилище
    ├───styles - стилизация
    ├───types - типы
    └───utils - различный полезный функционал