pyRevit Revit API

Детали: Перед первым запуском необходимо сначала воспользоваться плагином 1.2 для настройки.
Если вы запустите раньше, то программа выдаст соответствующее предупреждение сообщение.
После запуска плагина появляется окно Worksets, в котором можно выбрать нужный раздел.
Файл настроек хранится в папке %appdata%/MEI_pyrevit.

Детали: В окне настроек рабочих наборов, добавьте имена рабочих наборов согласно ТИМ стандарту.

Детали: При нажатии на кнопку плагина появится окно, в котором можно выбрать рабочий набор, к которому вы хотите применить следующие действия:
• Удалить полностью.
• Удалить и переместить.
• Переименовать.
❗ При выборе действия «Удалить и переместить» станет активен выбор в столбце «Параметр», в котором из выпадающего списка можно выбрать тот рабочий набор, в который будут скопировано содержимое рабочего набора, который будет удален.

Детали: После нажатия на плагин откроете окно со следующей информацией:
1. Общая информация.
2. Виды для координации.
3. Элементы модели по категориям (весь проект).
4. Проверка параметров элементов модели.
5. Статистика модели.
6. Предупреждения модели.
7. Revit-связи.
8. Импортированные CAD.
9. Координаты базовых точек.
10. Рабочие наборы (Всего: ).
11. Фазы проекта.
12. Варианты (Design Options).

Детали: Используется БИМ отделом для еженедельной отчетности.
При запуске плагин спрашивает сохранить файл отчета или нет. Сохранять может только сотрудник БИМ отдела!
Если плагин запустился не планово, то не обходимо внести изменения руками в файл отчетности доступный БИМ отделу.

Детали: После нажатия кнопки плагина нажмите на интересующий вас объект. Откроется окно с данными по выбранному объекту.

Детали: После запуска плагина появится окно со сведениями проекта, которое включает в себя параметры.
Можно выбрать Имя параметра и присвоить ему соответствующие значения.
В поле Текущее значение указывается значение уже имеющееся в проекте. Если Вам необходимо перенести данное значение в соседнее поле Значение – просто нажмите на данное поле с текстом.
❗ С помощью кнопки «Сохранить» можно создать файл .json и применять его в дальнейшем без повторного заполнения параметров.

Детали: В окне плагина необходимо указать полный путь к файлу с указание полного названия файла с расширением. Каждый файл — это новая строка.
❗ Плагин автоматически добавит связь в рабочий набор, согласно ТИМ-стандарту, и закрепит его.

Детали: Для заполнения параметров из Классификатора МССК необходимо предварительно подключить файл MSSK5Revit.
Для записи соответствующих данных названию поля выберите соответствующие параметры.

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

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

Детали: Плагин анализирует имена файлов и сопоставляет их с листами или видами проекта. При этом в названии файлов ищется имя Вида или Листа.
После выполнения плагина выбранный параметр у элементов будет содержать имя DWG/DXF файла, с которым связан данный элемент.

Детали: По результату работы плагина формирует файл JSON, содержащий метаданные видов и листов проекта из Autodesk Revit.
Файл используется для корректной привязки и позиционирования чертежей DWG и DXF при формировании IFC при использовании специализированной программы.

Детали: Нажатие на кнопку плагина открывает окно для просмотра Log-файла проекта.

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

Детали: Данный плагин показывает какие импортированные элементы САПР в проекте существую, и позволяет перейти на вид или удалить элемент из проекта.

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

Детали: Данный плагин позволяет выбрать файл модели, который будет подгружен по связи в проект и из которого будут скопированы уровни и оси. При этом все элементы будут размещены в правильных рабочих наборах.
❗ Мониторинг скопированных элементов, в связи с ограничением API Revit выполняется в ручном режиме.

Детали: ❗ Удаление выполняется безвозвратно (в обход Корзины), а файлы, занятые или заблокированные другими процессами в данный момент, автоматически и безопасно пропускаются.
Доступные следующие периоды для очистки старше:
• Все файлы (без ограничений).
• 1 недели.
• 2 недели.
• 3 недели.
• 1 месяца.
• 3 месяцев.
• 6 месяцев.
• 1 года.
• 1.5 года.
Значение по умолчанию: 6 месяцев.

Детали: Плагин собирает все элементы либо с текущего активного вида, либо с выбранного пользователем 3D-вида. При этом из проверки автоматически исключаются системные и вспомогательные категории.
Далее происходит обработка и проверка элементов модели по правилам:
• Плагин читает IDS файл (XML) с требованиями к параметрам.
• Плагин читает файл сопоставления (TXT), который подсказывает скрипту, как параметры из спецификации IDS называются внутри Revit.
В результате генерируется Excel-документ (.xlsx). Для удобства фильтрации в режимах проверки по IDS каждая найденная ошибка выводится в отдельную строку.
Пользователю доступно 6 режимов проверки:
1. Проверка заполнения параметров IFC классов ("Экспорт в IFC как" и "IfcExportAs")
2. Проверка соответствия значений параметров IFC классов
3. Наличие параметров из требований IDS
4. Заполненность параметров из требований IDS
5. Соответствие значений требованиям IDS
6. Полная проверка (все пункты)

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

Детали: Предусмотрена пакетная работа с файлами для передачи модели RVT или выгрузки IFC.
Доступны два режима режимы сохранения совместной работы для RVT файлов: Режим eTransmit и Центральное хранилище.
Перед сохранением RVT плагин может выполнить ряд автоматических процедур по облегчению файла.
Плагин поддерживает настройку параметров экспорта IFC идентичные стандартному окну экспорта IFC Revit.
По итогу завершения работы генерируется подробный текстовый отчет выполнения.

Детали: Во все экземпляры элементов проекта плагин запишет ID элемента Revit в выбранный параметр.
❗ К выбору доступны только параметры с типом данных Текст или Целое.

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

Детали: Плагин позволяет выполнить следующие действия с файлами:
• Отсоединение модель и пересохранить как центральную моделью
• Включить рабочие наборы для совместной работы с моделью
• Удалить связанные файлы RVT/DWG,
• Добавление 3D-текста с датой и именем файла в 3ю четверть модели.
Плагин позволяет выбрать сразу несколько моделей в папке.

Детали: Плагин дает возможность анализа следующих данных:
1. Загружаемые семейства (RFA)
2. Неиспользуемые семейства (RFA)
3. Растровые изображения и PDF
4. Внедренные CAD-чертежи
5. Модели в контексте
Плагин так же позволяет выполнять следующие действия:
• Выделить элемент в Revit.
• Выгрузить в папку (Доступно только для вкладки семейств).
• Удалить выбранные - удаляет элементы из модели.
❗ Для защиты от случайных ошибок, удаление загружаемых семейств разрешено только если они не размещены в модели.

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

Детали: Доступны три режима подрезки для этажа:
• От низа до верха - останутся линии среза пройдут от уровня выбранного Плана этажа до верха, т.е до уровня находящегося над ним, и вы увидите лишь то, что находится между ними.
• От низа до секущей - линии среза пройдут от уровня выбранного Плана этажа до значения уровня секущей плоскости. Вы увидите лишь то, что находится между ними.
• От секущей до верха - линии среза пройдут от значения уровня секущей плоскости до значения высоты этажа, или же значения уровня, расположенного выше. Вы увидите лишь то, что находится между ними.

Детали: При нажатии на кнопку плагина появляется окно, в котором показаны элементы, которые не видны на текущем виде.
В плагине не гарантируется 100% отображение элементов не видных на виде, но в значительной части поможет быстрее определится с причиной не видимости объекта.
❗Работает в соответствии с настройками Секущего диапазона

Детали: Для перехода на вид с выбранным элементом нажмите дважды на строку вида. После подтверждения перехода откроется вид, а интересующий элемент подсветится синим.

Детали: Откроется вид, в котором останутся только те элементы, которые вы выделили ранее (в отличие от базового функционал происходит скрытие не выбранных элементов и возможность обрезать вид по элементу из связанного файла).
❗Однако, в связанных файлах элемент обрезается, но изолируется весь связанный файл, а не выделенный элемент из-за особенности API Revit.

Детали: Нажав на кнопку в Диспетчере проекта будет найден и показан вид активной вкладки.
❗Если диспетчер проекта был закрыт, то он автоматически откроется.

Детали: Доступны трив варианта заполнения:
• Имя уровня целиком — полное имя (например, «Этаж_01»).
• Номер этажа (цифра) — только число (например, «01»).
• Высотная отметка уровня (мм) — высота в миллиметрах (например, «3000»).

Детали: ❗Имена параметров чувствительны к регистру! Вводите точно, как в проекте.

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

Детали: Плагин работает только с семействами:
• 002_MEI_Выноска для многослойной конструкции(тип1).rfa
• 002_MEI_Выноска для многослойной конструкции(тип2).rfa.
В название материала попадает текст указанный в параметре Описание материала. Если в данном параметре текст отсутствует, то будет указано Имя материала.
❗Плагин автоматически добавляет для работы имя id элементов, к которому привязана мультивыноска ParentElementID и удалять данный параметр запрещается.

Детали: ❗Обновление работает только при наличии заполненного параметра ParentElementID.

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

Детали: После запуска плагина автоматически найдет определенные Относительные высотные отметки и к ним подставит новые Абсолютные высотные отметки.
❗ Работает только с заранее настроенным проектом с загруженными семействами.

Детали: Плагин считывает значение Высотной отметки, вычисляет разницу, указанную в специальном параметре экземпляра у уровня (По умолчанию выбирается параметр: MEI_Разница между УЧБ и УБП) и результат оформляется в виде текстового примечания с размещается в нужной позиции относительно самой Высотной отметки.
Способ размещения:
• Рядом: Текст УБП будет размещен сбоку от существующей высотной отметки (на заданном расстоянии).
• Наложить: Текст УБП будет наложен строго поверх текущей высотной отметки, полностью центрируясь по ней.

Детали: Если вы выберите действие «Удалить» подпись, то произойдет удаление подписи с листа, а не из проекта!
Установка и удаление применяется ко всем листам!
❗ Данная настройка подписи работает ТОЛЬКО для Основной надписи.
При заполнении данных рамки ФИО лица может быть вписано в двух вариантах: Фамилия или Фамилия и инициалы.
❗ С рамками ADSK плагин не работает - ломает проект и рамки.

Детали: Данный плагин позволяет настроить параметры для работы плагина Подпись на листах.

Детали: По умолчанию используется: ADSK_Штамп Количество листов.

Детали: Необходимо выделите листы, которые необходимо объединить в набор, удерживая Ctrl для выбора нескольких листов или используйте Shift для выбора диапазона
❗ Листы должны быть выделены перед запуском команды!

Детали: ❗ Для обхода данного ограничения именование листа используется символ Zero Width Space (нулевой пробел) — юникод-символ `\u200B`.
Дерево листов динамически считывает активную конфигурацию организации листов из Диспетчера проекта.
Нумерация листов ведется в рамках своей группы.
Колонка «Будущий номер» на лету пересчитывает и показывает итоговые номера при любых изменениях настроек, перестановке листов или переключении чекбоксов.

Детали: ❗ Без предварительного выделения элементов плагин не сработает.

Детали: ❗ Плагин «Цвета по параметрам» работает через механизм фильтров видов в Autodesk Revit.
Созданные плагином фильтры являются временными служебными фильтрами. При очистке визуализации через кнопку «Очистить всё» плагин:автоматически удаляет созданные фильтры и возвращает отображение вида к исходному состоянию.
❗Если пользователь хочет оставить данные фильтры фильтры после анализа, необходимо переименовать фильтры, в соответствии с ТИМ стандартом.

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

Детали: Файл в формате Excel должен быть создан на основе шаблона который доступен по ссылке внутри плагина.

Детали: Файл в формате Excel (.xlsx, .xls) или CSV должен быть создан согласно описанию внутри плагина, а именно:
• Первая строка файла - заголовок.
• Первый столбец - имя ключа.
• Остальные столбцы - по порядку колонок ключевой спецификации.

Детали: Перенос данных между элементами происходит по совпадению значений в выбранном столбце-ключе (например, по «Марке», «ID» или «Имени»).
Интерфейс позволяет сопоставить любые текстовые и числовые столбцы из источника со столбцами в целевой спецификации.
Если в источнике несколько элементов с одним ключом (связь «многие-к-одному»), плагин автоматически соберет их значения и склеит через запятую «,» или перенос строки «\n» в зависимости от выбранной настройки.
Настройка «Синхронная построчная склейка» означает: если у элемента не заполнено значение в одном из столбцов, скрипт поставит прочерк `-`. Это гарантирует, что при переносе нескольких столбцов списки склейки идеально совпадут по длине и порядку, не нарушая связей данных.
Напротив числовых параметров в окне сопоставления доступна галочка «Сумма». Если она активирована, плагин просуммирует значения этого столбца.
❗ Группировка для суммирования происходит по всем параметрам, которые находятся строго выше первой строки с галочкой «Сумма». То есть, элементы с одинаковым ключом сначала разбиваются на группы по верхним параметрам, а затем их числа складываются. В целевой параметр записываются уже готовые суммы по этим группам.

Детали: Два независимых движка генерации:
1. Встроенный Экспорт (Revit 2022+) - высокая скорость и автоматическое определение форматов без необходимости настройки принтеров в Windows.
2. PDFCreator (COM Interface) - классический надежный виртуальный принтер.
❗ Для печати через виртуальный принтер необходима установленная программа PDFCreator 5.3.3
При работе с виртуальным принтером предусмотрено авто-создание форматов. Если в Windows нет нужного формата бумаги (например, А1х3), кнопка "Создать форматы" добавит их в систему через Spooler (требует прав Администратора).
Доступен выбор цветового режима: Цветная или черно-белая печать.
Для виртуального принтера доступны следующие режимы графики: Векторная, Растровая (Revit) и Растровая (через Ghostscript через Ghostscript – листы как картинка).
Позволяет сохранять как самостоятельный PDF файл под каждый лист, так и объединить все листы в один PDF многостраничный файл.

Детали: Дерево спецификаций динамически считывает активную конфигурацию организации спецификаций из Диспетчера проекта.
Два Режимы экспорта:
• По файлам (каждая спецификация отдельно): создаётся отдельный файл *.xlsx для каждой выбранной спецификации.
• В один файл (все на отдельных листах): создаётся единая книга Excel, где каждая спецификация помещается на отдельный лист с корректным именем (до 31 символа, с очисткой от недопустимых символов Windows и Excel).
Кнопка «Выделить текущий вид» — автоматическое определение активного открытого вида в Revit и добавление его к выбранным спецификациям

Детали: Плагин создает спецификацию в категории Комплект мебели и заполняет ее шапку на основе данных таблицы Excel.
Что переносится из Excel:
• Текст и значения.
• Ширина столбцов и высота строк.
• Объединение ячеек.
• Выравнивание текста и центрирование по вертикали.
• Жирность текста.
• Границы ячеек (Рамки): тонкие и толстые линии.
• Цвет шрифта.
• Размер шрифта.

Детали: Опция «Создавать отсутствующие марки выбранного типа» позволяет автоматически создавать марки для помещений, где они отсутствуют.Таким образом Вы можете не использовать родной инструмент Revit установить марку для помещения, а сразу воспользоваться планигоном!
Расположение марки доступно в следующих вариантах:
• Центр – марка будет выровнена по центру помещения.
• Угол (правый нижний) – марка будет размещена в правом нижнем углу помещения.

Детали: ❗ Помещения будут считаться одинаковыми, если все выбранные параметры совпадают.

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

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

Детали: ❗ Настройка корректировка низа(м2) дает возможность добавить дополнительную площадь к площади низа марша(MEI_Площадь низа марша).

Детали: ❗Рекомендуется использовать CSV вместо XLSX.
Файл в зависимости от типа данных должен содержать:
• для типа Значение: Значение;R;G;B;Заливка
• для типа Диапазон: Не менее(число);Заголовок;R;G;B;Заливка
Образец заливки может быть пустым. Первая строка считается Заголовком и пропускается при импорте.

Детали: В результате работы плагина все элементы присоединенные к выбранному элементу будут отсоединены, кроме дотягивания к крыше, так как API Revit не позволяет управлять данным параметром.

Детали: Плагин работает только с элементами у которых есть в настройках типоразмера Структура.

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

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

Детали: Эскизы создаются за счет создания размеров на уникальный элемент и автоматически выносятся на указанный Лист.
Поддерживаются следующие элементы:
• Двери.
• Окна.
• Витражи.
Для витражей могут быть использованы три типа построения по криволинейности (параметр «Криволинейные посегментно» - данный параметр не затрагивает прямолинейные витражи):
• Нет – ставится один разрез по центру витража.
• Да (сегмент) – разрез ставится на каждый сегмент витража и выносится на лист как отдельностоящий разрез.
• Да (развертка) – создается чертежный вид, на котором автоматически воссоздается развернутый витраж в плоскости.
Плагин формирует специальные планы уровней на которых отображаются полученные разрезы в в разделе Диспетчера проекта.
Плагин создает фильтры, которые позволяют исключить видимость только данных разрезов на других видах!
При пересоздании существующие разрезы удаляются автоматически и создаются новые.
❗ Марка на эскизах – это текст, то есть при изменение он автоматически не изменится.

Детали: ❗ Работает с только семействами отверстия и заданий Citrus и MEI.
Разрезы формируются в разделе Диспетчера проекта.
Плагин так же создает фильтр который позволяют исключить видимость только данных разрезов на других видах!

Детали: Виды на легенде выставляются построчно.
❗ Для работы необходимо, чтобы в проекте была Легенда с именем: "В_АР_Для плагина MEI" с наличием размещенного вида. Так же нужен любой 3Д Вид в проекте!

Детали: Основные требования к LandXML:
• Должны быть узлы Pnts и Faces.
• В Pnts каждая точка должна быть P id="..." с уникальным id.
• Координаты точки: минимум 3 числа в порядке Y X Z (север, восток, высота).
• В Faces каждая грань F должна ссылаться на существующие id точек.
Грани должны быть треугольными (3 индекса на грань).
• В файле должны быть валидные числовые значения координат.
• Единицы в файле должны соответствовать выбранному коэффициенту в плагине.
❗ Если программа (Сivil/NanoCad) экспортирует только контуры/точки без Faces, плагин не сработает.

Детали: Формат файла соответствует LandXML 1.2 (TIN) и удовлетворяет всем требованиям плагина Импорта LandXML.

Детали: Поддерживает создание зон сразу для нескольких корпусов на виде.
Режим «По пользовательским помещениям предполагает что вокруг корпуса пользовать сам создаст Границу помещения (инструмент «Разделитель помещений») и поставит в него помещение, а плагин уже позволит выбрать данное помещение и построить зону.

Детали: Плагин создает семейства в категории Обобщенные модели по очертанию здания отдельно для надземной и подземной части здания.
Обязательное условие для работы плагина заполненный параметр у стен Функция - Наружный слой.
❗ Данный плагин может не всегда точно построить модель со сложной формой, поэтому обязательно проверяйте результат работы плагина. Вы всегда можете отредактировать получившееся семейство, через редактор семейств.

Детали: Помещения группируются по квартирам. При включенной настройке «Учитывать номер корпуса» помещения группируются по связке Корпус + Квартира.
❗ Помещения с пустым номером квартиры или пустым типом помещения полностью игнорируются плагином и не участвуют в расчетах.
Учет коэффициентов позволяет настроить или полностью убрать понижающие коэффициенты для различных типов помещений.
Для работы плагина в проекте должны быть параметры у помещений заложенные в ТИМ стандарте организации.

Детали: По результатам работы плагина в диспетчере проекта появится новый 3D‑вид с заданным именем, на котором видны только элементы выбранной системы, а остальные скрыты.
​Если была включена опция «Сформировать фильтр» который будет выбирать только данный элемент, в списке фильтров видов создастся новый фильтр, настроенный по параметру имени системы; его можно применять и к другим видам проекта для быстрого включения/отключения нужной системы.

Детали: ❗ Плагин работает только с семействами Citrus и BimStep.
❗ Плагин работает только с отверстиями в связанной модели.

Детали: В плагине сравнения Room и Space строки вида «Номер ≠», «Имя ≠», «Площадь ≠» означают, что значения параметров не совпадают между архитектурным помещением Room и инженерным пространством Space.
Если в настройке указан допуск 2 м², то разница 1.8 м² не будет считаться ошибкой.

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

Детали: ❗ Для работы с данными плагинами нужно установить соответствующие плагины. При этом, вкладка с данным плагином должна быть активна.

Детали: Если обновление не требуется, то появится окно, которое сообщит текущую версию.
❗ После обновления плагина рекомендуется перезапустите Revit для более точного отображения элементов в меню плагина.

Детали: Версия плагина отображается в нижнем левом углу окна.
Все ссылки ведут на сетевые ресурсы компании.

Детали: Первая функция: Обновить и Сохранить - выполняет обновление всех отчетов, последующее их сжатие и сохранение файла.
Вторая функция: XML Отчет - Выгружает полученные отчеты в формате XML в заданные папки в виде совместного отчета по всем проверкам и в виде раздельных отчетов по каждой проверке.
❗ Данный плагин поддерживает работу через cmd, что позволяет автоматизировать процесс выгрузки таких отчетов.