Начало работы с Revit API на Python: инструменты и первый сценарий

Чему вы научитесь в этом руководстве?

Приступая к работе с Revit API, не стоит сразу ставить цель создать полноценное расширение. Сначала нужно понять, как находить элементы модели, работать с их свойствами и управлять изменениями. Вводный курс Autodesk знакомит с подходом к работе с Revit API с помощью бесплатных инструментов. Среди основных тем курса — фильтры элементов, транзакции (Transactions) и пользовательский интерфейс. Сохранение и использование инструментов Python также входят в учебные цели.

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

Требования и инструменты

В курсе Autodesk University перечислены RevitPythonShell, Revit Lookup и pyRevit. От участников курса ожидаются базовые знания Revit и начальный уровень владения Python. Согласно странице Autodesk для разработчиков Revit, API представляет собой интерфейс на базе .NET, предназначенный для автоматизации повторяющихся задач и расширения основных возможностей Revit.

Перед началом проверьте следующее:

• Установленную версию Revit и файл проекта.

• Базовые навыки работы с Revit и начальный уровень владения Python.

• Сведения об установке и совместимости RevitPythonShell, Revit Lookup и pyRevit с используемой версией Revit.

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

Пошаговый план для начала работы

1. Сначала изучите данные о помещениях в Revit. Выберите помещение и просмотрите поля на палитре Properties. В документации Autodesk по свойствам помещений перечислены, например, название, номер, назначение, отдел и отделка стен, потолка и пола. Значения площади и периметра доступны только для чтения; объём тоже доступен только для чтения, если включён расчёт объёмов. Понимание этого различия поможет определить, какие данные вы будете считывать, а какие — изменять.

2. Сформулируйте первую задачу как поиск элементов. Например, начните с изучения того, как отбирать помещения в проекте по заданному критерию. В числе базовых учебных целей курса Autodesk University указаны сбор и фильтрация элементов с помощью RevitPythonShell. До написания кода простыми словами опишите, какие элементы нужно выбрать и что означает условие фильтрации. Конкретные вызовы API сверяйте с руководством Autodesk для разработчиков и примерами кода.

3. Используйте Revit Lookup в рамках списка инструментов курса. Autodesk University упоминает Revit Lookup среди инструментов, используемых на курсе, но доступное описание не раскрывает функции программы или порядок работы с ней. Поэтому не предполагайте наличие определённых возможностей или конкретного пути в интерфейсе — уточните, как пользоваться инструментом, в его документации. Так вы не станете считать подтверждённой частью учебного плана функцию, о которой источники не сообщают.

4. Изучайте изменения модели вместе с темой Transactions. Курс относит выполнение операций над элементами через RevitPythonShell к основным темам. Перед экспериментами, меняющими данные модели, чётко и кратко сформулируйте желаемое изменение. Изменение названия помещения и чтение значения, доступного только для чтения, например площади, — разные операции. Не переходите к масштабной автоматизации, пока не проверите, как изменения повлияют на файл проекта. В источниках нет конкретного примера кода для начала и завершения транзакции, поэтому способ реализации нужно сверить с соответствующей документацией API.

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

6. Сравните результат со свойствами помещения. Сопоставление данных, полученных через API, со свойствами помещения, отображаемыми в Revit, поможет проверить, что именно было считано. Согласно документации Autodesk, номер помещения должен быть уникальным в проекте. Если номер уже используется, Revit выдаёт предупреждение, но позволяет продолжить. Не путайте появление предупреждения с полной блокировкой операции. Площадь и периметр доступны только для чтения; для объёма этот статус зависит от того, включён ли расчёт объёмов.

Частые ошибки

• Предполагать версию: во вводном курсе не указана конкретная версия Revit или инструментов. Отдельно проверьте сведения об установке и совместимости.

• Считать, что редактировать можно любое свойство помещения: площадь и периметр доступны только для чтения. Объём также указан как доступный только для чтения, если включён расчёт объёмов. Перед операцией проверьте статус свойства.

• Писать код, не определив фильтр: сначала решите, какие элементы и по какому условию нужно отобрать, затем обращайтесь к документации API и примерам кода.

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

• Приписывать инструменту функции, не упомянутые в источнике: RevitPythonShell, Revit Lookup и pyRevit перечислены среди инструментов курса, но источник не описывает все их возможности и актуальные шаги установки.

Следующие шаги: рабочие процессы в архитектуре и визуализации

Этот план поможет разобраться с данными проекта, такими как номер и название помещения, его назначение и отделка. На странице Revit API Autodesk упоминает возможности расширения основных функций программы в таких областях, как автоматизация, моделирование и строительство. Это может стать ориентиром для изучения повторяющихся операций с данными, но не означает, что конкретная автоматизация будет одинаково работать в любом проекте.

Для архитекторов и дизайнеров интерьеров приоритет — понять типы данных в модели и доступность тех или иных свойств. Команды BIM и визуализации могут на небольших тестах оценить, как работать с нужной им информацией. Прежде чем переходить к созданию более крупного инструмента, проверьте совместимость с используемой версией Revit, влияние изменений на проект и условия лицензирования. В курсе Autodesk University рассказывается о доступе к API с помощью бесплатных инструментов, но это не разъясняет актуальные лицензионные условия для всего ПО и всех версий.

Источники и лицензия

Руководство адаптировано на русский язык на основе страницы Autodesk для разработчиков Revit API, документации о свойствах помещений из справки Autodesk Revit 2025 и курса Autodesk University «Revit Programming for Beginners: Easily Access the Revit API Using Free Tools». В записях источников статус лицензии указан как «свободный»; поскольку сведения о конкретной лицензии Creative Commons не приведены, утверждение об открытой лицензии не делается.