Перейти к содержанию

Отчёты и экспорт результатов

Результат решённой расчётной задачи можно открыть в интерфейсе OpenCS и сохранить как расчётное обоснование. Отчёт собирается не из одного итогового числа: в него входят исходные данные, геометрия и материалы, нормативные проверки, промежуточные величины, предупреждения и доступные графические представления.

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

Что происходит при экспорте

flowchart LR
    Task[Расчётная задача] --> Result[Сохранённый результат]
    Result --> Provider[Поставщик отчёта]
    Provider --> Model[ReportDocument]
    Model --> HTML[HTML]
    Model --> Markdown[Markdown]
    Model --> Pandoc[Pandoc]
    Pandoc --> DOCX[DOCX]
    Pandoc --> ODT[ODT]
    Pandoc --> RTF[RTF]
    Pandoc --> Typst[Typst]
    Typst --> PDF[PDF]

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

HTML и Markdown формируются напрямую. DOCX, ODT, RTF и PDF формируются локальным Pandoc из Markdown-источника. Формулы передаются в LaTeX-представлении; SVG-иллюстрации сохраняются как локальные ресурсы отчёта. Для PDF Pandoc использует Typst-шаблон и комплект шрифтов.

Пользовательские установки не нужны: Pandoc и Typst входят в поставляемую сборку OpenCS в каталоге Tools/Pandoc. Вместе с ними поставляются шаблоны, Lua-фильтр, Word-шаблон, шрифты, лицензии и манифест контрольных сумм.

Для чего нужен Typst

Typst используется только на последнем этапе формирования PDF:

Markdown + LaTeX + SVG → Pandoc → Typst → PDF

Для DOCX, ODT и RTF Typst не нужен: Pandoc напрямую формирует эти форматы. Для DOCX дополнительно используется встроенный эталонный шаблон Word.

WebView2 в экспорте отчётов не используется. Для SVG-иллюстраций также не требуется Svg.Skia.

Как получить отчёт

  1. Откройте в дереве проекта нужную расчётную задачу.
  2. Раскройте задачу и выберите сохранённый результат.
  3. Перед экспортом проверьте статус, протокол и предупреждения результата.
  4. Откройте контекстное меню результата и выберите команду Отчёт.
  5. В диалоге сохранения выберите расширение файла.
  6. После экспорта откройте файл соответствующим просмотрщиком и проверьте итоговые значения, предупреждения и графику.

Отчёт является документированным представлением результата, но не заменяет исходный проект и проверку расчётной модели. При спорном результате сохраняйте проект, исходные усилия, параметры задачи и журнал расчёта вместе с экспортированным файлом.

Что входит в отчёт

В зависимости от вида задачи поставщик отчёта добавляет:

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

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

Округление и обозначения

Числа форматируются единообразно для формул, таблиц и подписей схем. Используются разумные профили округления по единицам: размеры в метрах, силы, моменты, напряжения, площади и деформации получают различное число знаков после запятой; лишние нули не выводятся.

Коэффициент использования обозначается Кисп.. Его округление выполняется в сторону увеличения, чтобы представление не создавало ложного запаса. Буква η не используется как второе обозначение коэффициента использования: она оставлена для коэффициента влияния прогиба по п. 8.1.15 СП 63.

Трассировка упрощённых проверок СП 63

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

  • название проверки;
  • пункт СП или код формулы;
  • формулу;
  • подстановку фактических значений;
  • результат с единицей измерения;
  • статус выполнения и пояснение.

Для числового условия прочности в зависимости от нормативной ветви выводится сравнение фактического усилия с несущей способностью, например:

\[ M \le M_{\mathrm{ult}} \]

Для наклонного сечения отдельно проверяются поперечная сила и момент:

\[ Q \le Q_{\mathrm{ult}}, \qquad M \le M_{\mathrm{ult}} \]

Нормальное сечение

Отчёт sp63_normal содержит исходные данные по форме сечения, оси изгиба, схеме статической определимости, режиму устойчивости, длине элемента и расчётной длине l0, доле длительного момента ψ, порогу гибкости и ручным усилиям. Для таврового или двутаврового сечения дополнительно выводится пролёт.

Основные разделы отчёта:

  • Вердикт — статус, нормативная ветвь и результат проверки прочности;
  • Ход расчёта — последовательность формул и подстановок;
  • Числовые условия прочности — таблица с колонками «Формула», «Описание», «Пункт СП», «Факт», «Допуск», «Кисп.», «Результат»;
  • Конструктивные требования раздела 10 (справочно) — отдельная таблица, не входящая в итоговый вердикт прочности (состав проверок по формам сечения — в разделе конструктивные требования);
  • Причины неприменимости формульного режима и Справочные сообщения;
  • Переменные расчёта — отдельная таблица исходных переменных без дублирования столбца переменных в таблицах проверок;
  • Влияние прогиба η — отдельный блок по п. 8.1.15 с Ncr, жёсткостью, усиленным моментом и историей итераций.

Для расчётных слоёв арматуры выводится эквивалентная площадь As, диаметр, координата и разрешённая ось слоя. Это позволяет отличить параметризацию упрощённого метода от фактического набора точечных фибр.

Наклонное сечение

Отчёт shear_inclined документирует упрощённую проверку наклонных сечений по СП 63.13330. В нём есть:

  • область применимости, допущения и источник усилий;
  • исходные размеры, бетон, поперечная арматура и параметры хомутов;
  • ход проверок 8.55, 8.56 и 8.63;
  • справочные проверки 8.60 и 8.63s;
  • общий коэффициент использования и определяющий набор проверок;
  • предупреждения о неприменимости и неопределённой несущей способности.

Для всех сохранённых стоянок вдоль элемента выводится приложение с N, Q, критическими проекциями C, бетонной и поперечной составляющими несущей способности, моментами, сторонами растяжения, а также Кисп,Q и Кисп,M. Отчёт позволяет найти не только общий результат, но и конкретную стоянку, определившую проверку.

Схема параметрического железобетонного сечения

Для нормального и наклонного сечения документатор получает сохранённое параметрическое определение из диалога задания ЖБ-сечения. В отчёт попадает SVG-схема с:

  • геометрией сечения и отверстий;
  • осями и направлением изгиба;
  • продольной и поперечной арматурой;
  • стороной растяжения;
  • расчётными обозначениями a, a′ и h₀, если они определены.

Параметрическая схема добавляется рядом с исходными данными, поэтому читателю не нужно открывать OpenCS, чтобы понять постановку расчёта.

Если параметрическое определение отсутствует, повреждено, устарело относительно геометрии или имеет неподдерживаемую версию, экспорт не прерывается. В этом случае строится универсальная схема по фактической геометрии, а в отчёт добавляется предупреждение о причине перехода.

Другие виды отчётов

Документирование доступно для зарегистрированных поставщиков результатов:

  • НДС стержневого сечения (strain_state);
  • предельная нагрузка, предельный момент и предельная продольная сила (limit_force, limit_moment, limit_axial);
  • образование трещин (cracking);
  • ширина раскрытия трещин (crack_width);
  • полная кривизна (total_curvature);
  • история нагружения стадийного сечения (load_history);
  • нормальное сечение по упрощённым формулам СП 63 (sp63_normal);
  • наклонное сечение по упрощённым формулам СП 63 (shear_inclined);
  • ширина раскрытия трещин по упрощённой проверке (sp63_crack_width);
  • трещины в слоистой пластине (shell_layered_sls).

Для НДС и предельных состояний отчёт может включать карты деформаций и напряжений. Для расчётов трещин добавляются условия образования трещин, промежуточные величины, параметры ψs, ls, acrc и таблицы по стержням. Для слоистой пластины выводятся усилия Nx…Mxy, параметры φ1, φ2, acrc,lim, сходимость деформационной модели, acrc,max и таблица по парам «слой × направление».

Поддерживаемые форматы

Расширение Назначение и особенности
.html Автономная HTML-страница со встроенными SVG; не требует интернета и внешних файлов.
.md Markdown-исходник отчёта с формулами и встроенными изображениями. Удобен для хранения в проекте и дальнейшего редактирования.
.docx Документ Word с таблицами, формулами и схемами. Формируется Pandoc с эталонным шаблоном Word.
.odt OpenDocument с таблицами, формулами и встроенными изображениями. Формируется напрямую Pandoc.
.rtf Совместимый текстовый формат для старых редакторов. Текст и таблицы сохраняются, но SVG-схемы в этот формат не встраиваются.
.pdf Печатный документ через Pandoc и Typst; используется комплект шрифтов и шаблон A4.

Для полноценного отчёта с графикой предпочтительны DOCX, ODT или PDF. RTF полезен как простой обменный текстовый формат, но не как графический аналог Word-документа.

Диагностика

Если команда экспорта недоступна, для данного вида задачи ещё не зарегистрирован поставщик отчёта. Если экспорт сообщает об отсутствующем или повреждённом комплекте инструментов, нужно использовать полную папку сборки OpenCS: в ней должны находиться Tools/Pandoc/pandoc.exe, typst.exe, шаблоны, Lua-фильтр, шрифты и manifest.json.

Если в отчёте отсутствует графика, сначала проверьте, был ли соответствующий результат доступен для выбранного вида задачи. Для нормального и наклонного сечения проверьте также актуальность параметрического источника: при его отсутствии OpenCS выводит универсальную схему и предупреждение.

Если числовое условие имеет статус «не применяется», «несущая способность не определена» или «ошибка», не заменяйте его округлённым числом вручную. Откройте раздел «Причины неприменимости», «Справочные сообщения» и предупреждения отчёта, затем проверьте исходные данные задачи.

Отчёт документирует сохранённый результат. Изменение геометрии, материалов, усилий или параметров задачи требует повторного запуска расчёта и повторного экспорта.