• Введение.
• 1. Экспорт с Revit Server
• 1.1. Экспорт через eTransmit
• 1.2. Экспорт при помощи Batch файла
• 2. Получение NWC файлов и создание сводных моделей NWD, NWF
• 2.1. Создание скрипта для генерации NWC и создания сводной модели NWD
• 2.2. Первичное создание сводной модели NWF и финальная проверка всего процесса.
• 3. Заключение

Введение.

Одной из операционных задач BIM-отдела является подготовка и формирование BIM-моделей проприетарных форматов для последующего использования в тех или иных целях. На примере работы с программными продуктами Autodesk — Revit и Navisworks, подразумевается определённая логика разбивки и хранения разных форматов: RVT, NWC, NWF и NWD. Работая над крупными проектами, включающие в себя разные разделы проектной документации, корпуса зданий и секций, встаёт вопрос о единой структуре и правилах формирования файлов. В этой статье, на простом примере проекта, рассмотрен один из вариантов по автоматизации формирования BIM-моделей проекта, от пакетного экспорта файлов RVT с Revit Server до размещения соответствующих файлов разных форматов по нужным директориям и формированию сводной модели NWD.

Поэтапные действия пайплайна при помощи .bat файлов:

1. Пакетный экспорт Revit моделей с Revit Server;
2. Создание списка всех Revit моделей с их путями в файле TXT;
3. Генерация NWC файлов;
4. Создание (обновление при последующих итерациях) сводной модели NWD;
5. Перенос (обновление с заменой при последующих итерациях) NWC файлов в папку 03.NWC;
6. Первичное создание сводного файла NWF с последующим добавлением всех NWC файлов;
7. Итерационный запуск .bat файлов с актуализацией вышеперечисленных пунктов.

Но, обо всём по порядку.

1. Экспорт с Revit Server

На сколько мне известно, есть два основных решения пакетного экспорта моделей с Revit Server, не прибегая к программированию и API. Через стандартную утилиту RevitServerTool и при помощи плагина eTransmit, поставляющийся с установкой Revit.

1.1. Экспорт через eTransmit

Не буду подробно расписывать этот способ, так как о нём уже упоминал в одной из статей на Dzen. Но напомню в двух словах о процессе, поскольку в eTransmit нельзя выбрать несколько моделей с Revit Server, то основной смысл заключается в том, чтобы связать(залинковать) все актуальные модели в Базовом файле и именно его выбирать при экспорте через eTransmit, установив галку в поле "Добавить файлы" — "Связанные Revit модели".

Плюсы и минусы такого подхода:

1.2. Экспорт при помощи Batch файла

В качестве основного инструмента рассмотрим подробнее этот вариант.

При установке Revit утилита командной строки RevitServerTool, упомянутая выше, устанавливается автоматически. Находится по пути "C:\Program Files\Autodesk\Revit 20XX\RevitServerToolCommand" и используется для автоматизации создания локальных моделей на основе Revit Server.

В качестве примера представлена упрощённая структура проекта. На Revit Server есть четыре директории с моделями:

• 00.COORDINATION — Модели Базового и Разбивочных файлов;
• 01.ARCH — Архитектурные модели;
• 02.STR — Модели Конструктивных решений;
• 03.HVAC — Модели раздела Отопления и Вентиляции.

Папочная структура на локальном компьютере имеет аналогичную группировку для упрощения.

RVT-модели, содержимое папок с Revit Server, нам необходимо скачивать(экспортировать) к себе на локальный компьютер или сервер. Для этого следует воспользоваться возможностями RevitServerTool и создать исполняющий Batch File. Синтаксис кода:

RevitServerTool createLocalRVT <model path> [-server <server name>] [-destination <path>] [-overwrite]

• RevitServerTool — Отображение справки служебной команды;
• L | createLocalRVT — Создание локальной модели на основе указанной серверной модели;
• <model path> — Путь модели на Revit Server;
• [-s | -server <server name>] — Имя адреса Revit Server или IP (обязательный аргумент);
• [-d | -destination <path>] — Конечный путь, куда сохраняем модель;
• [-o | -overwrite] — Перезаписывание файла модели, если он уже существует.

Batch file — это текстовый файл, содержащий последовательность команд для поочередного исполнения и для его создания можно воспользоваться простым блокнотом, но для более удобной работы, лучшим решением будет Notepad++.

Открываем Notepad++ и вписываем команды для экспорта моделей из нашего примера:

:: COORDINATION
RevitServerTool L "PROJ\00.COORDINATION\PROJ-ORG-B01_03-FM.rvt" -s IP-address -d "O:\BIM\02.RVT\00.COORDINATION/" -o
RevitServerTool L "PROJ\00.COORDINATION\PROJ-ORG-B01-BF.rvt" -s IP-address -d "O:\BIM\02.RVT\00.COORDINATION/" -o
RevitServerTool L "PROJ\00.COORDINATION\PROJ-ORG-B02-BF.rvt" -s IP-address -d "O:\BIM\02.RVT\00.COORDINATION/" -o
RevitServerTool L "PROJ\00.COORDINATION\PROJ-ORG-B03-BF.rvt" -s IP-address -d "O:\BIM\02.RVT\00.COORDINATION/" -o
:: ARCH
RevitServerTool L "PROJ\01.ARCH\PROJ-ORG-B01-ARCH.rvt" -s IP-address -d "O:\BIM\02.RVT\01.ARCH/" -o
RevitServerTool L "PROJ\01.ARCH\PROJ-ORG-B02-ARCH.rvt" -s IP-address -d "O:\BIM\02.RVT\01.ARCH/" -o
RevitServerTool L "PROJ\01.ARCH\PROJ-ORG-B03-ARCH.rvt" -s IP-address -d "O:\BIM\02.RVT\01.ARCH/" -o
:: STR
RevitServerTool L "PROJ\02.STR\PROJ-ORG-B01-STR.rvt" -s IP-address -d "O:\BIM\02.RVT\02.STR/" -o
RevitServerTool L "PROJ\02.STR\PROJ-ORG-B02-STR.rvt" -s IP-address -d "O:\BIM\02.RVT\02.STR/" -o
RevitServerTool L "PROJ\02.STR\PROJ-ORG-B03-STR.rvt" -s IP-address -d "O:\BIM\02.RVT\02.STR/" -o
:: HVAC
RevitServerTool L "PROJ\03.HVAC\PROJ-ORG-B01-HVAC.rvt" -s IP-address -d "O:\BIM\02.RVT\03.HVAC/" -o
RevitServerTool L "PROJ\03.HVAC\PROJ-ORG-B02-HVAC.rvt" -s IP-address -d "O:\BIM\02.RVT\03.HVAC/" -o
RevitServerTool L "PROJ\03.HVAC\PROJ-ORG-B03-HVAC.rvt" -s IP-address -d "O:\BIM\02.RVT\03.HVAC/" -o

В примере выше мы указываем пути моделей на Revit Server и говорим создать локальную модель L для каждой, указывая свой адрес Revit Server -s IP-address и скачиваем к себе на локальный компьютер "O:\BIM\.." с перезаписью -o файлов модели, если они уже есть.

Команды :: или REM позволяют закомментировать строки. Скрипт их не выполняет и используются они в данном случае для визуального удобства и группировки.

Если в строках присутствует Кириллица, то необходимо поменять кодировку на OEM 866

Далее сохраняем файл по пути "C:\Program Files\Autodesk\Revit 20XX\RevitServerToolCommand" с расширением Batch file.

Запускать скрипт следует именно из директории "C:\Program Files\Autodesk\Revit 20XX\RevitServerToolCommand" с полным доступом на права.

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

Краткая демонстрация результата:

Плюсы и минусы такого подхода:

Теперь, когда мы получили RVT-модели с Revit Server приступим к следующему этапу нашего пайплайна.

2. Получение NWC файлов и создание сводных моделей NWD, NWF

Напомню вкратце, основной процесс по работе с Revit и Navisworks в части формирования сводных моделей. Вначале необходимо получить NWC файлы из файлов RVT, далее создать сводный файл NWF куда в последствии подгружаем файлы NWC и дополнительно сохраняем сводную модель в формате NWD для передачи заказчику или подрядчикам. Порядок действий может незначительно меняться, кому как удобнее. При всём этом обилии форматов не плохо было бы их раскидать по нужным местам. Отдельно хранить файлы NWC, в папке 03.NWC в нашем случае, которые там будут систематически обновляться скриптом. В другом месте формировать сводную модель NWF для работы с коллизиями, поисковыми наборами и т.д. и отдельно иметь место для хранения актуальной сводной модели в формате NWD у которой иные цели.

Бóльшую часть действий можно и нужно автоматизировать. Создадим скрипт Batch файла для реализации этой задачи.

2.1. Создание скрипта для генерации NWC и создания сводной модели NWD

Для задачи автоматизации выделил отдельную папку 05.Automation в которой будут храниться исполняющий Batch файл, журнал событий (log) и сгенерированный файл TXT со списком RVT-моделей, о котором ещё расскажу.

Полностью готовый код выглядит так:

:: Encoding for Cyrillic
CHCP 65001 > NUL
:: Getting all .rvt files from a folder and subfolders and creating a list of RVT-models in .txt format
DIR /b/s "O:\BIM\02.RVT\*.rvt" | findstr /i/v/r "BF FM \.[0-9][0-9][0-9][0-9]\." > "List RVT-models.txt"

:: Launching the FileToolsTaskRunner utility to generate .nwv files according to the list of .txt RVT-models created above. Additionally, a federated .nwd model and a .log file is created
start /wait "Navisworks Batch Utility" "C:\Program Files\Autodesk\Navisworks Manage 2023\FileToolsTaskRunner.exe" /i "O:\BIM\05.Automation\List RVT-models.txt" /of "O:\BIM\01.FM NWD\PROJ-ORG-B01_03-FM.nwd" /log "O:\BIM\05.Automation\Log.log"

:: Variables are set for the source path, for the destination path and for generating files  
set "source_folder=O:\BIM\02.RVT"
set "destination_folder=O:\BIM\03.NWC"
set "file_format=*.nwc"
:: Loop through the source path, extracting files of the required format and moving them to the final path
for /r "%source_folder%" %%G in (%file_format%) do (
move "%%G" "%destination_folder%"
)

Теперь разберём его подробнее.

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

CHCP 65001 > NU

Следующая команда проходит по всем файлам формата RVT в папке 02.RVT и её вложенным папкам, после чего создаёт список найденных файлов с их путями в отдельном файле TXT в той же папке:

DIR /b/s "O:\BIM\02.RVT\*.rvt" > "List RVT-models.txt"

Этот список нужен для генерации NWC файлов при помощи утилиты FileToolsTaskRunner, которая устанавливается с Navisworks.

Можно сразу доработать код, исключив из поиска модели Разбивочного и Базовых файлов, за ненадобностью в сводных моделях Navisworks, а также потенциальные копии RVT-моделей, где в постфиксе имён добавляется ".001"; ".002" и т.д.

Добавим команду findstr с сопутствующими параметрами /i/v/r, значение которых можно узнать тут и указываем регулярное выражение для исключения копий:

DIR /b/s "O:\BIM\02.RVT\*.rvt" | findstr /i/v/r "BF FM \.[0-9][0-9][0-9][0-9]\." > "List RVT-models.txt"

В кавычках сочетание символов по которым исключаем поиск файлов и синтаксис регулярного выражения.

В качестве теста можно запустить команду и убедиться что создаётся файл TXT со списком путей моделей:

Далее добавим команду вызова Navisworks Batch Utility, но при помощи командной строки и утилиты FileToolsTaskRunner:

start /wait "Navisworks Batch Utility" "C:\Program Files\Autodesk\Navisworks Manage 2023\FileToolsTaskRunner.exe" /i "O:\BIM\05.Automation\List RVT-models.txt" /of "O:\BIM\01.FM NWD\PROJ-ORG-B01_03-FM.nwd" /log "O:\BIM\05.Automation\Log.log"

Аналог команды Batch Utility из интерфейса Navisworks, который уже упоминался в другой статье на Dzen.

В команде выше мы:

• Указываем путь до утилиты FileToolsTaskRunner, чтобы её запустить;
• Ссылаемся на ранее созданный список TXT с моделями, по которому будет происходить генерация NWC файлов;
• Далее создаём сводную модель NWD, сохраняя по пути "O:\BIM\01.FM NWD\" с именем PROJ-ORG-B01_03-FM.nwd;
• Параллельно создаётся журнал событий (log), в той же папке, где можно отслеживать исполнение действий по моделям.

Смотрим результат:

Осталось перемещать созданные NWC файлы в папку 03.NWC откуда впоследствии они будут подгружаться в NWF файл.

Для этого задаем три переменные:

• set "source_folder=O:\BIM\02.RVT" с указанием директории, откуда берём файлы NWC;
• set "destination_folder=O:\BIM\03.NWC" с указанием папки куда переносим/заменяем NWC файлы;
• set "file_format=*.nwc" с указанием нужного формата, который переносим — NWC.

И добавляем кусок кода с циклом для перебора:

set "source_folder=O:\BIM\02.RVT"
set "destination_folder=O:\BIM\03.NWC"
set "file_format=*.nwc"

for /r "%source_folder%" %%G in (%file_format%) do (
move "%%G" "%destination_folder%"
)

Теперь сгенерированные файлы NWC будут автоматический перемещаться в нужное нам место.

Создадим сводную модель NWF и посмотрим итоговый результат.

2.2. Первичное создание сводной модели NWF и финальная проверка всего процесса.

Для нового проекта, одноразовой акцией, является создание сводной модели NWF. В последующих итерациях нам достаточно очередной раз эту сводную модель, где будет обновление данных, если NWC файлы были обновлены.

Поэтому просто создадим файл с именем PROJ-ORG-B01_03-FM.nwf в папке 04.NWF и добавим в неё все файлы NWC из папки 03.NWF, после первого исполнения нашего скрипта.

По итогу мы имеем всего два Batch файла для запуска, которые экспортируют все RVT-модели с Revit Server, затем генерируют NWC файлы с перемещением в нужную область, создают сводную модель NWD и соответственно авто обновляется сводная рабочая модель NWF.

Демонстрация исполнения всего процесса:

Используя подобный подход под каждый проект можно быстро получать актуальные BIM-модели, формировать сводные файлы и разом структурировать данные.

3. Заключение

Возможно подход не идеален и может показаться на первый взгляд не простым, но если разобраться и потратить какое-то время, то выясниться, что это гораздо лучше, чем делать часть работы в ручную или пренебрегать структурированием. Использование удобных интерфейсов программ мне нравится куда больше, но ты либо упираешься в ограничение самой программы, либо прибегаешь к помощи программистов, если сам таким не являешься. А подход из статьи может использовать абсолютно каждый и гибко настраивать под себя. Необязательно для этого уметь программировать. Поскольку, разбираться с синтаксисом команд для Batch файлов, то ещё "удовольствие", вы можете обратиться за помощью к Сhat-GPT, если вам требуется модификация скрипта конкретно для ваших рабочих процессов, с чем он прекрасно справиться.

Как вы решаете подобные задачи и какими инструментами пользуетесь?

В архитектурно-строительной сфере с появлением BIM-технологий всё больше приходится работать с данными, анализировать их и визуализировать для наглядности и понимания. При проектировании зданий и сооружений большое внимание уделяется качеству проектных решений, в том числе предотвращению коллизий на строительной площадке. Работая с BIM-моделями(упрощённо: 3D-модель с атрибутивной информацией элементов) мы можем более качественно и заблаговременно получать информацию о потенциальных коллизиях. Полученные данные необходимо анализировать и принимать в работу, а также визуализировать для донесения более широкому кругу людей, в том числе.

Эта статья является более расширенной версией поста с Dzen про формирование динамической матрицы коллизий. Судя по обратной связи, многим не хватило более подробного раскрытия процесса импорта и преобразования отчёта .xml в Power BI и дальнейшая работа с данными. В этой статье я постараюсь дать более подробный гайд, но также освещу весь процесс начиная с формирования поисковых наборов (Search Sets) в Autodesk Navisworks для более целостной картины.

В конце должны получить примерно такой результат:

Подготовка проверок на коллизии в Autodesk Navisworks

Создание поисковых наборов

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

Формирование отчёта проверок

Для получения и подготовки отчёта переходим на вкладку Clash Detective и формируем проверки на коллизии. В зависимости от требований и регламентов структура будет отличаться.

Нажимаем Запустить проверку и видим некоторую информацию о конфликтах(коллизиях) и их количестве:

После чего переходим на вкладку Отчёт

Экспорт отчёта в XML

Перед экспортом отчёта, для упрощения в данном случае, в поле Содержимое оставим выборку только у пункта Сводка и в поле Включить эти статусы: уберём всю выборку, нам нужна только общая информация о количестве коллизий в каждой проверки, без детализации. Тип отчёта — Все тесты (совм.); Формат отчёта — XML.

В итоге получаем файл отчёта в .xml формате.

Структура XML отчёта

XML (от англ. eXtensible Markup Language) — «расширяемый язык разметки» и прежде чем идти дальше, необходимо изучить/освежить знания о структуре XML. Вкратце об XML можно почитать тут. Некоторая выдержка из источника:

XML документ должен содержать корневой элемент. Этот элемент является «родительским» для всех других элементов.

Все элементы в XML документе формируют иерархическое дерево. Это дерево начинается с корневого элемента и разветвляется на более низкие уровни элементов.

Все элементы могут иметь подэлементы (дочерние элементы):

<корневой>
   <потомок>
     <подпотомок>.....</подпотомок>
   </потомок>
</корневой>

Похожую структуру мы увидим, если откроем наш отчёт в VS Code, например, или Notepad++

Для дальнейшей работы с импортом и преобразованием в Power BI, нам достаточно обобщённо понимать эту иерархию и вложенность. По сути, в элементах <clashtest>...</clashtest> записаны наши проверки из Navisworks:

На иллюстрации выше показана одна из проверок и как она выглядит в XML-структуре с минимальным набором информации.

Формирование отчёта в Power BI

Связь с источником данных — импорт отчёта XML

Устанавливаем Microsoft Power BI, если его нет и запускаем программу. Далее устанавливаем связь с источником данных или другими словами — импортируем, ранее подготовленный .xml отчёт.

Нажимаем на текст Получение данных из другого источника и в выпадающем окне выбираем нужный формат — XML

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

Если мы вернёмся к .xml отчёту в текстовом редакторе и сопоставим с появившейся таблицей, то заметим в ней верхнеуровневый элемент <batchtest></batchtest> и некоторые атрибуты units="m" filename="" filepath="" из корневого элемента <exchange></exchange>.

Начальный фрагмент XML-структуры из .xml отчёта:

<?xml version="1.0" encoding="UTF-8" ?>

<exchange xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" units="m" filename="" filepath="">
  <batchtest name="Report" internal_name="Report" units="m">
    <clashtests>
      <clashtest name="АИ1 Стены-АИ1 Стены" test_type="hard" status="ok" tolerance="0.010" merge_composites="0">
        <linkage mode="none"/>
        <left>
...

Мы понимаем, что нужная информация лежит внутри иерархии и её необходимо достать/преобразовать в нужный нам табличный вид для последующей работы с данными. Жмём Преобразовать данные

Настройка представления таблицы. Редактор Power Query

Попадаем в Редактор Power Query для последующего преобразования и подготовки данных.

Теперь предстоит добраться до нужной информации и для этого мы проваливаемся внутри структуры до нужного уровня вложенности. В столбце batchtest нажимаем на значение ячейки Table, потом clashtests — Table и т.д., как в примере:

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

В новом табличном представлении уже видим столбцы Attribute:name и Attribute:tolerance со знакомыми названиями проверок на коллизии и их допусками, которые изначально формировали в Navisworks.

Далее, нужно извлечь из столбца summary вложенные значения с количеством найденных коллизий, а именно Attribute:total и изменить тип значений на Целое число, нажав ПКМ по заголовку столбца:

Также следует разбить столбец Attribute:name на два, тем самым разделив левую часть проверки (А) и правую (B). Для последующего представления в матрице:

Для этого, в интерфейсе Редактора Power Query есть функция Разделить столбец. Поскольку в наименованиях моих проверок есть понятный разделить в виде символа - дефис, то делить, я буду по нему (у вас может быть другой).

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

В результате получится два столбца — левая(А) и правая(B) проверки. Attribute:name.1 и Attribute:name.2

Жмём Закрыть и применить в верхнем левом углу и переходим к последнему шагу в части подготовки данных — группировка всех проверок в соответствующие разделы проектной документации: АР, КР, ОВ и т.д., чтобы выводить общие показатели по ним.

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

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

Выделяем первый столбец с заголовком Attribute:name.1 и группируем его, нажимая на инструмент Группы данных — Создать группы данных. Тут немного ручной работы, но довольно быстрой и понятной. В окне Группы в левой колонке находятся Несгруппированные значения, которые необходимо сгруппировать, переместив в правую колонку и задав логическое имя группе. Алгоритм действий прост — выделяем через SHIFT все нужные наборы (идентифицируя по префиксу в данном случае АИ.., АР.., ВК.., и т.д.) жмём Группировать, два раза кликаем ЛКМ на сформированный заголовок группы, чтобы сразу переименовать в понятный раздел.

Соответственно, таким же образом поступаем и со вторым столбцом Attribute:name.2. На выходе должны сформироваться два дополнительных столбца с постфиксом (группы) в конце таблицы.

Именно этими значениями в дальнейшем мы будем оперировать и выводить на финальный отчёт в матрице коллизий.

Переходим обратно в основную рабочую область — Представление отчёта.

Рабочая область Power BI и подготовка отчёта

Вкратце опишу основные области, с которыми будем работать:

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

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

Сразу можно ещё скорректировать ячейку в верхнем левом углу. Сейчас там Attribute:name.1 (группы), а мы хотим написать "Раздел", для обозначения аббревиатур в заголовках вертикальной и горизонтальной линиях. Для этого в поле Визуализации под заголовком Строки наводим на плашку с именем Attribute:name.1 (группы) в область стрелки и в выпадающем списке выбираем "Переименовать для этого визуального элемента".

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

Финальная настройка визуально-интерактивной матрицы коллизий

Выделяем отчёт и переходим на появившуюся вкладку Форматирование визуального элемента в поле Визуализации.

Детально рассматривать все настройки не буду, покажу несколько, в качестве примера, чтобы получить более менее приемлемый вид.

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

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

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

По итогу, после ряда манипуляций получаем подобный результат:

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

Для обновления данных перезаписываем отчёт .xml из Navisworks и обновляем в Power BI: вкладка Главная — поле Запросы — кнопка Обновить, таблица скорректируется, если были изменения.

Заключение

В статье рассмотрен относительно упрощённый пример формирования матрицы коллизий в Power BI. Если подключить дополнительные атрибуты при экспорте отчёта в XML из Navisworks, то можно пойти дальше и вести временную шкалу проверок, получать метрики по исправленным и добавленным коллизиям и т.д., но основная цель статьи — более подробно раскрыть процесс импорта и преобразования XML данных в Power BI для BIM-специалистов. Если остались вопросы — пишите.

Спасибо за внимание.

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

Основным популяризатором и разработчиком программ в области BIM, принято считать компанию Autodesk с их приложениями для AEC (Architecture, Engineering, and Construction) индустрии — Revit, Navisworks, ACC (Autodesk Construction Cloud, ex-BIM360) и др., но в последнее время, активно набирает обороты недовольство пользователей продуктов Autodesk, аргументируя это стагнацией в части разработки нового полезного функционала и недоработки существующего, при этом явным повышением цен на программное обеспечение. Ещё одной проблемой, является замкнутая экосистема Autodesk и их закрытый формат данных (Closed BIM), работая с которым, ты ограничен в действиях и вынужден оставаться в контуре Autodesk. На примере Revit и Autodesk Platform Services, ex-Forge.

По мере развития BIM-технологии и нежеланием быть зависимым от больших корпораций, свою популярность приобрела концепция OpenBIM и сопутствующий ей IFC формат.

С тенденцией перехода сервисов в облачные решения, начали появляться open-source библиотеки или бесплатные программы по работе с BIM-моделями в web, такие, как xeokit, IFC++, IfcOpenShell и др., а соответственно и BIM-стартапы, преследующие цели OpenBIM или закрывающие конкретные задачи. Одну из таких библиотек мы и рассмотрим, развернув на её основе простое BIM-решение для просмотра модели IFC формата.

Библиотека IFC.js

IFC.js — это библиотека JavaScript для работы с моделями IFC в браузере. Она полностью бесплатная и распространяется по свободной лицензии MIT.

Идейным создателем и одним из разработчиков библиотеки IFC.js, является Antonio González Viegas — BIM software developer. И в качестве предпосылки для создания этого open-source решения и его описания, приведу вольный перевод с его слов:

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

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

Это не относится к таким секторам, как видеоигры, где существует множество инструментов и технологий (видеоигровых движков), которые позволяют любому создать продукт высокого уровня с минимальными затратами времени и ресурсов. Было бы здорово иметь то же самое в секторе AEC?

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

IFC.js — молодой проект, который развивается и растет с каждым днем. Наша цель — позволить каждому разрабатывать программное обеспечение BIM с такой же легкостью, с какой разрабатываются видеоигры. IFC.js бесплатен, у него нет владельца, и любой может использовать его или участвовать в проекте.

Как вы уже возможно поняли, преследуется концепция Open BIM, противопоставляя решение тяжеловесным и закрытым проприетарным программам. IFC.js даёт возможность BIM-специалистам или разработчикам из других сфер создавать свои собственные BIM-решения, решающие их бизнес-задачи внутри компаний или же создавать свои коммерческие BIM-стартапы. В этом плане, лицензия IFC.js даёт полную свободу действий. Библиотека предназначена для всех, кто хочет разрабатывать BIM-приложения, будь то разработчики, создающие сервисы для строительной отрасли, так и архитекторы совместно с другими специалистами.

Структура IFC.js

В связи с тем, что IFC.js большая, мульти-язычная библиотека (C++, TypeScript JavaScript и т.д.) и держать её в одном репозитории было бы сложно и громоздко, её разбили на три основные части:

• web-ifc — ядро библиотеки: IFC парсер, написанный с нуля на языке C и скомпилирован через Emscripten в WebAssembly. Этот репозиторий инкапсулирует сложность чтения файлов IFC и загрузки их данных в память. Demo

• web-ifc-three — эта библиотека адаптирует web-ifc к Three.js, создавая оптимизированную 3D-сцену, в которой пользователи могут напрямую взаимодействовать с IFC. Эта библиотека является официальным IFC загрузчиком в Three.js. Благодаря этому, приложения BIM можно создавать с помощью Three.js всего за пару строк кода. Demo

• web-ifc-viewer — это решение для просмотра IFC в браузере со множеством примеров того, что можно сделать с помощью IFC.js. Навигация по сценам, изменение материалов, выбор элементов по нажатию на них, планы разрезов и т. д. В этом репозитории есть пример всех этих функций, поэтому его можно повторно использовать в открытых приложениях BIM из коробки. Demo

Каждая последующая часть зависит от предыдущей, в такой последовательности: web-ifc — web-ifc-three — web-ifc-viewer

Обучение

На данный момент, проводятся два курса IFC.js crash course и Advanced BIM frontend course по работе с их библиотекой в web. Курс IFC.js crach cource, как заявляет создатель, подходит для начального уровня и обучение ведётся с нуля, но под конец, как по мне, без хорошей базы в программировании будет тяжеловато.

Программа поддержки

В целях ускорения разработки проекта, а так же его улучшения — команда IFC.js реализовала программу поддержки, где даёт возможность заработать сообществу, принося свой вклад в проект. Если вкратце, то формируются карточки с разного рода заданиями, например исправление бага или реализации инструментов, таких как проверка на коллизии, формирование планов, разрезов и т.д.

Разработка BIM-сервиса для просмотра IFC формата

Создание BIM-приложения с IFC.js довольно простое, как указано на сайте с документацией. Последующий урок взят оттуда в качестве вольного перевода, с некоторыми сокращениями, отклонениями и комментариями. Развёрнутое демо-приложение находиться тут. Для выполнения следующих шагов необходим Node.js и любая IDE, но в статье я буду использовать VS Code в качестве среды разработки и расширение Live Preview в части локального сервера, не разворачивая Node.js. И если у вас нет файлов IFC, вы можете их скачать отсюда.

Установка библиотек

Вначале, создаём пустую папку и запускаем менеджер пакетов npm с помощью команды npm init. Будет создан файл package.json, содержащий некоторые данные, такие как имя проекта, версия, описание, команды и зависимости.

Все вышеперечисленные свойства можно сразу заполнить, либо прожав Enter и использовать значения по умолчанию.

Кроме того, при помощи npm необходимо установить следующие зависимости: модуль web-ifc-three (с ним ставится и Three.js), входящий в IFC.js и rollup.js в качестве сборщика проекта для JavaScript.

    //Install IFC.js
    npm i web-ifc-three

    // Install a bundler: we will use rollup.js for this guide
    npm i rollup --save-dev
    npm i @rollup/plugin-node-resolve --save-dev

Сразу можно проверить наличие в package.json файле свойство "type": "module" и добавить его, если оно отсутствует.

Следующим шагом, будет создание HTML файла с именемindex.html в качестве основного документа приложения. HTML будет иметь:

• canvas элемент, используемый для рендеринга сцены Three.js;
• input элемент, который будет открывать файлы IFC с нашего компьютера в приложении.
• Тэг script, ссылающийся на файл bundle.js, представляющий собой сборку приложения, которую мы создадим дальше с помощью rollup.

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8"/>
    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
    <link rel="stylesheet" href="styles.css"/>
    <title>Document</title>
  </head>
  <body>
    <input type="file" name="load" id="file-input"/>
    <canvas id="three-canvas"></canvas>
    <script src="bundle.js"></script>
  </body>
</html>

Добавление стилей

Создаём CSS файл styles.css, где произведём сброс стилей, сделаем наш canvas на весь экран и зададим свойства нашей будущей кнопки для загрузки IFC-модели:

* {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
}

html,
body {
  overflow: hidden;
}

#three-canvas {
  position: fixed;
  top: 0;
  left: 0;
  outline: none;
}

#file-input {
  z-index: 1;
  position: absolute;
}

Сборка проекта

Далее, создадим файл конфигурации с именем rollup.config.js, который будет включать в себя ссылки на ранее установленные дополнения.

import resolve from "@rollup/plugin-node-resolve";

export default {
  input: "app.js",
  output: [
    {
      format: "esm",
      file: "bundle.js",
    },
  ],
  plugins: [resolve()],
};

Также, в файле package.json изменим команды в области scripts для удобного управления объединением/сборки проекта. В каждой команде необходимо указать относительный путь к файлу конфигурации rollup.

• npm run build объединит проект и создаст файл с именем bundle.js в корневом каталоге проекта.
• npm run watch активирует режим просмотра, автоматически обновляя этот файл каждый раз, когда мы вносим и сохраняем изменения в код.

{
  "name": "example",
  "version": "1.0.0",
  "description": "-",
  "main": "app.js",
  "scripts": {
    "build": "rollup -c ./rollup.config.js",
    "watch": "rollup -w -c ./rollup.config.js"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "@rollup/plugin-node-resolve": "^11.2.1",
    "rollup": "^2.45.2"
  },
  "dependencies": {
    "three": "^0.128.0",
    "web-ifc-three": "0.0.102"
  }
}

WebAssembly

Далее, необходимо скопировать файл web-ifc.wasm в директорию проекта. Найти его можно по пути node_modules\web-ifc и скопировать куда угодно, впоследствии указав на него путь, но в примере он будет размещен в корне проекта.

Этот файл необходим, так как содержит скомпилированную C++ логику модуля web-ifc, являющемся ядром парсинга для чтения и записи IFC файлов.

Создание и настройка 3D сцены

Наконец, мы создадим JavaScript файл для нашего приложения. Разместить его можно где-угодно и задать произвольно имя, главное отразить это в файле rollup.config.js. В примере это будет app.js в корне проекта.

Базовая 3D-сцена Three.js

import { AmbientLight, AxesHelper, DirectionalLight, GridHelper, PerspectiveCamera, Scene, WebGLRenderer } from "three";
import { OrbitControls } from "three/examples/jsm/controls/OrbitControls.js";

//Creates the Three.js scene
const scene = new Scene();

//Object to store the size of the viewport
const size = {
  width: window.innerWidth,
  height: window.innerHeight,
};

//Creates the camera (point of view of the user)
const aspect = size.width / size.height;
const camera = new PerspectiveCamera(75, aspect);
camera.position.z = 15;
camera.position.y = 13;
camera.position.x = 8;

//Creates the lights of the scene
const lightColor = 0xffffff;

const ambientLight = new AmbientLight(lightColor, 0.5);
scene.add(ambientLight);

const directionalLight = new DirectionalLight(lightColor, 1);
directionalLight.position.set(0, 10, 0);
directionalLight.target.position.set(-5, 0, 0);
scene.add(directionalLight);
scene.add(directionalLight.target);

//Sets up the renderer, fetching the canvas of the HTML
const threeCanvas = document.getElementById("three-canvas");
const renderer = new WebGLRenderer({
  canvas: threeCanvas,
  alpha: true,
});

renderer.setSize(size.width, size.height);
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));

//Creates grids and axes in the scene
const grid = new GridHelper(50, 30);
scene.add(grid);

const axes = new AxesHelper();
axes.material.depthTest = false;
axes.renderOrder = 1;
scene.add(axes);

//Creates the orbit controls (to navigate the scene)
const controls = new OrbitControls(camera, threeCanvas);
controls.enableDamping = true;
controls.target.set(-2, 0, 0);

//Animation loop
const animate = () => {
  controls.update();
  renderer.render(scene, camera);
  requestAnimationFrame(animate);
};

animate();

//Adjust the viewport to the size of the browser
window.addEventListener("resize", () => {
  size.width = window.innerWidth;
  size.height = window.innerHeight;
  camera.aspect = size.width / size.height;
  camera.updateProjectionMatrix();
  renderer.setSize(size.width, size.height);
});

Загрузка IFC файлов

В завершении мы будем использовать IFC.js для загрузки IFC файлов. Создадим экземпляр загрузчика и событие, когда пользователь загружает IFC файл с помощью элемента ввода <input>

import { IFCLoader } from "web-ifc-three/IFCLoader";

// Sets up the IFC loading
const ifcLoader = new IFCLoader();

const input = document.getElementById("file-input");
input.addEventListener(
  "change",
  (changed) => {
    const file = changed.target.files[0];
    var ifcURL = URL.createObjectURL(file);
    ifcLoader.load(ifcURL, (ifcModel) => scene.add(ifcModel));
  },
  false
);

Готовый app.js файл будет так:

import {
  AmbientLight,
  AxesHelper,
  DirectionalLight,
  GridHelper,
  PerspectiveCamera,
  Scene,
  WebGLRenderer,
} from "three";
import { OrbitControls } from "three/examples/jsm/controls/OrbitControls.js";
import { IFCLoader } from "web-ifc-three/IFCLoader";


//Creates the Three.js scene
const scene = new Scene();

//Object to store the size of the viewport
const size = {
  width: window.innerWidth,
  height: window.innerHeight,
};

//Creates the camera (point of view of the user)
const aspect = size.width / size.height;
const camera = new PerspectiveCamera(75, aspect);
camera.position.z = 15;
camera.position.y = 13;
camera.position.x = 8;

//Creates the lights of the scene
const lightColor = 0xffffff;

const ambientLight = new AmbientLight(lightColor, 0.5);
scene.add(ambientLight);

const directionalLight = new DirectionalLight(lightColor, 1);
directionalLight.position.set(0, 10, 0);
directionalLight.target.position.set(-5, 0, 0);
scene.add(directionalLight);
scene.add(directionalLight.target);

//Sets up the renderer, fetching the canvas of the HTML
const threeCanvas = document.getElementById("three-canvas");
const renderer = new WebGLRenderer({
  canvas: threeCanvas,
  alpha: true,
});

renderer.setSize(size.width, size.height);
renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2));

//Creates grids and axes in the scene
const grid = new GridHelper(50, 30);
scene.add(grid);

const axes = new AxesHelper();
axes.material.depthTest = false;
axes.renderOrder = 1;
scene.add(axes);

//Creates the orbit controls (to navigate the scene)
const controls = new OrbitControls(camera, threeCanvas);
controls.enableDamping = true;
controls.target.set(-2, 0, 0);

//Animation loop
const animate = () => {
  controls.update();
  renderer.render(scene, camera);
  requestAnimationFrame(animate);
};

animate();

//Adjust the viewport to the size of the browser
window.addEventListener("resize", () => {
  size.width = window.innerWidth;
  size.height = window.innerHeight;
  camera.aspect = size.width / size.height;
  camera.updateProjectionMatrix();
  renderer.setSize(size.width, size.height);
});

// Sets up the IFC loading
const ifcLoader = new IFCLoader();

const input = document.getElementById("file-input");
input.addEventListener(
  "change",
  (changed) => {
    const file = changed.target.files[0];
    var ifcURL = URL.createObjectURL(file);
    ifcLoader.load(ifcURL, (ifcModel) => scene.add(ifcModel));
  },
  false
);tURL(file);
    ifcLoader.load(ifcURL, (ifcModel) => scene.add(ifcModel));
  },
  false
);

И если всё настроенное корректно, то после вызова команды npm run build мы можем собрать и запустить наше приложение, запустив расширение Live Preview, которое мы устанавливали ранее, с адресом http://127.0.0.1:3000 в браузере или открыть index.html в папке проекта.

Заключение

Библиотека IFC.js действительно молодой проект и развивается довольно быстро, но уже сейчас даёт возможность реализовывать полноценные BIM-приложения. В связи с последними тенденциями и активным интересом в сторону подхода Open BIM — IFC.js прокладывает отличный путь для развития сервисов в строительной индустрии. Вокруг проекта уже сформировалось значительное комьюнити к которому можно присоединиться в Discord.

20-ого сентября состоится масштабное мероприятие проекта IFC.js с множеством новостей, улучшением и заменой некоторых компонентов библиотеки, а также многое другое.

P.S.

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

За развитием Arcol я слежу уже относительно давно. Примерно год назад записался в лист ожидания, а в этом месяце вышла публичная beta-версия.

Основной целью команды является переосмысление процессов проектирования и объединение разных ПО (Miro, Bluebeam, Sketchup, Revit и д. р.) в единый сервис для совместной работы над проектом. И судя по манифесту основателя сервиса, Arcol пытается воссоздать Revit в облачном исполнении, но более простой и удобный в использовании. Не зря UX/UI-дизайн взят за основу из популярной программы для дизайнеров — Figma

Интерфейс

По структуре интерфейс максимально схож с Figma или аналогом Figma в 3D — Spline

Основные области интерфейса:

1. Панель инструментов — делится на вкладки Design и Construct. В первом случае работа с эскизными линиями и поверхностями, которые в последствии можно выдавливать инструментом Push/Pull. Во вкладке Construct присутствуют уже более привычные инструменты для 3D-проектирования — Стены, Двери и Окна
2. Диспетчер проекта с разбивкой на Виды (Viewes - создание планов, фасадов и т.д.) и Доски (Boards - формирование листов с видами)
3. Структура проекта с разбивкой по уровням и вложенности элементов модели
4. Панель свойств и параметров где также находится панель со Слоями (Layers)

Коммуникация и совместная работа

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

Режим Markup

Режим Markup — некий симбиоз Figma Jam и Miro. В режиме Markup можно рисовать и оставлять всяческие аннотации поверх проекта. После чего формируется реестр с видами и пометками для дальнейшей коммуникации среди участников проекта

Геопозиционирование и контекст

В Arcol есть возможность выбрать адрес и размер границы участка (по умолчанию 500м) подгрузить его и автоматически получить объём окружающей застройки.

Формирование листов

В диспетчере проекта в поле Boards создаются чертёжные листы с видами проекта.

В заключении

С остальными функциями и возможностями можно ознакомится на практике или изучив документацию https://docs.arcol.io/

На данный момент продукт ещё сыроват и полноценно программу для 3D-проектирования пока не заменяет, но сам проект уже весьма интересный, по крайней мере как идея, и многообещающий. Остаётся пожелать только успехов в развитии! А мы со своей стороны будем пристально следить за релизами и обновлениями.