Документация Engee

Работа с документацией Engee

Страница в процессе разработки.

Документация Engee — это не просто справочник, а полноценный навигатор по функциональности всей платформы. Она охватывает как базовые темы (например, запуск приложений или основы моделирования), так и продвинутые сценарии — интеграцию стороннего кода, генерацию на внешние языки, визуализацию, а также подключение внешних устройств.

working with docs 1

Так, при работе с Engee могут возникать разные вопросы: как правильно собрать модель, как реализовать систему управления, как встроить нейросеть или как запустить полунатурное моделирование на РИТМе. Все это уже подробно описано в документации, но чтобы не тратить время на хаотичное блуждание по ее разделам, важно с самого начала понять:

  • Как устроена структура документации;

  • Где искать нужные материалы под конкретную задачу;

  • Как пользоваться встроенными примерами и курсами;

  • Как быстро находить ответы с помощью встроенного поиска;

  • Как оставить обратную связь, если в документации что-то не так.

Эта статья поможет быстро освоиться в документации, понять ее структуру, научиться эффективно искать нужные материалы и получать максимум пользы от платформы.

Как открыть документацию

Документацию Engee можно открыть разными способами — как из браузера, так и напрямую из рабочего пространства:

  • Через браузер — самый универсальный способ: перейдите по ссылке https://engee.com/helpcenter/stable/ru/index.html. Это сразу же откроет главную страницу документации, работает на любом устройстве и не требует запуска сессии Engee.

  • Из личного кабинета — на главной странице вашего личного кабинета account icon доступна кнопка Документация Engee. Один клик — и вы сразу в документации. Это удобно для быстрого доступа к информации и также не требует запуска сессии Engee.

    working with docs 3

  • Из запущенной сессии Engee — доступно несколько способов перейти в нужный раздел прямо из рабочего пространства Engee:

    • При запуске платформы — если включена галочка «Всегда показывать при старте», то в стартовом окне при запуске сессии будут ссылки на популярные разделы документации:

      working with docs 4

    • Кнопка Документация documentation icon — находится в правом верхнем углу интерфейса, доступна из любого окна.

      working with docs 5

    • Контекстное меню блока — дважды кликните левой кнопкой мыши по блоку из Библиотеки block library icon и в открывшемся окне настроек окна настроек debug article icon 1 во вкладке Информация выберите «Документация» working with docs 7 — откроется соответствующая статья по блоку:

      working with docs 6

      Для открытия окна настроек необязательно выносить блок на холст, двойное нажатие сработает и в самой библиотеке block library icon.

Структура документации

Документация Engee организована по разделам. Все доступные разделы и их страницы представлены в левом боковом меню документации:

working with docs 2

Любой раздел раскрывает свое содержимое по нажатию левой кнопки мыши. Далее коротко рассмотрим эти разделы:

  • Об Engee — это первая точка входа для изучения документации по платформе. Здесь описано, что такое Engee, как устроено рабочее пространство, как работать с приложениями apps icon и как пользоваться личным кабинетом. Для знакомства с платформой рекомендуется начать со статьи Быстрый старт.

  • Прикладные применения — раздел с документацией по пакетам языка Julia для различных задач. В разделе описываются пакеты для работы со статистикой, машинным обучением, оптимизацией, нейронными сетями, обработкой сигналов и изображений, радиолокацией, связью, картами и многим другим полезным направлениям.

  • Среда вычислений — раздел ориентирован на инженеров и программистов, работающих с кодом. Здесь описывается работа с математикой, импортом данных, построением графиков, синтаксисом языка Julia, интеграцией стороннего кода и многом другим.

  • Среда моделирования и симуляции — в разделе описывается все о создании и управлении моделями: визуальное моделирование, библиотека блоков, программное управление симуляцией, конечные автоматы и полунатурное моделирование.

  • Учебные курсы — наборы интерактивных скриптов по основным темам: программирование, моделирование, математика, обработка сигналов, оптимизация, моделирование электрических и энергетических систем, ЦОС, САУ и др. Подробную информацию по работе с курсами см. в статье Как получить материалы курсов.

    working with docs 8

    Курсы также можно запускать напрямую со страниц документации — достаточно нажать кнопку «Открыть пример в Engee» на странице нужного курса:

    working with docs 9

  • Генерация кода — ключевой раздел для тех, кто хочет экспортировать модели в программный код. Включает материалы по трансляции в Cи, HDL, Julia, настройке пользовательских шаблонов генерации и практические примеры.

  • Примеры — интерактивные демонстрации, запускаемые по кнопке «Открыть в Engee». На основной странице с примерами каждый интерактивный блок при наведении отображает три первых примера, относящихся к выбранной области — это удобный способ быстро познакомиться с базовыми возможностями и типовыми сценариями работы:

    working with docs 10

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

    working with docs 11

  • Дополнительные материалы — описывается взаимодействие с Git, API Engee, а также использование терминологических словарей.

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

Как устроены статьи в документации

Цветовые плашки

Во многих статьях используются цветовые выделения текста — плашки, помогающие быстро сориентироваться в типе информации. Каждая из них подсказывает как воспринимать выделенную информацию:

Содержит дополнительную информацию или контекст. Необязательна для выполнения, но помогает лучше понять тему. Можно читать для общего понимания и расширения кругозора.

Полезные рекомендации, приемы и подсказки. Помогают упростить работу, ускорить выполнение операций или использовать функциональность более эффективно.

Ключевые моменты, без которых выполнение описанных действий может быть некорректным. Обязательно прочитайте перед тем, как продолжить — это может быть требование к параметрам, данным или последовательности действий.

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

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

Меню подзаголовков

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

working with docs 12

Это помогает быстро перейти к нужному разделу — особенно удобно на длинных страницах.

Можно делиться ссылками на конкретный раздел статьи: просто наведите курсор на подзаголовок, и слева от него появится значок ссылки. Кликнув по нему, вы добавите якорь к URL странице — такой URL можно отправить коллегам или сохранить для быстрого перехода к конкретному пункту статьи.

working with docs 13

Секции «Для опытных пользователей»

Иногда встречаются плашки с пометкой «Для опытных пользователей»:

advanced users ru

Это означает, что в таких секциях содержатся сложные или редкие сценарии работы: интеграция нестандартных библиотек, использование продвинутых параметров симуляции, настройка пользовательских шаблонов и т.д. Подобные секции необязательны к исполнению/изучению, но могут быть полезны для опытных разработчиков и энтузиастов.

Поиск по документации

В правой верхней части документации есть строка поиска. Она поддерживает:

working with docs 14

  • Быстрый предварительный просмотр результатов;

  • Ссылки на соответствующие статьи;

  • Возможность перейти к «Все результаты», чтобы использовать фильтры из бокового меню и уточнить запрос:

    working with docs 15

    working with docs 16

Если сразу не нашли нужное — просто используйте расширенный поиск!

Язык интерфейса и локализация

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

working with docs 19

Кроме того, ниже доступна опция «Английская локализация блоков» — при ее активации названия блоков и разделов в библиотеке отображаются на английском. Это может быть удобно тем, кто работает с англоязычными проектами или предпочитает терминологию на английском языке.

Как сообщить об ошибке

Если заметили неточность или опечатку в статье:

  1. Выделите проблемный фрагмент текста левой кнопкой мыши;

  2. Подождите пару секунд — появится ссылка с текстом «Если вы нашли ошибку…​»:

    working with docs 17

  3. Нажмите на нее — откроется форма для отправки сообщения:

    working with docs 18

Это напрямую отправит информацию разработчикам документации!