Revit Python

Python + Revit API шпаргалка

Я устал периодически искать отдельные команды по зоопарку скриптов, поэтому решил сделать общую страницу с блоками кода

Шапка скрипта

			
			
import clr
# Import the Revit API
clr.AddReference('RevitAPI')
import Autodesk
from Autodesk.Revit.DB import *
			
# Import DocumentManager and TransactionManager
clr.AddReference('RevitServices')
import RevitServices
from RevitServices.Persistence import DocumentManager
from RevitServices.Transactions import TransactionManager

#Making windows
clr.AddReference('RevitAPIUI')
from Autodesk.Revit.UI import *
from Autodesk.Revit.UI.Selection import *
			
uiapp = DocumentManager.Instance.CurrentUIApplication
uidoc = uiapp.ActiveUIDocument
			
doc = DocumentManager.Instance.CurrentDBDocument
			
element = UnwrapElement(IN[0])

Выбор нескольких элементов

			
			
# getting preselected elements
selection = uidoc.Selection.GetElementIds() #preselected elements ids
elements = doc.GetElement(i) for i in selection.GetElementIds()] 
# choose elements
selection = uidoc.Selection.PickObjects(ObjectType.Element)
elements = [doc.GetElement(i) for i in selection]

Отрисовка простого окна с текстом

			
TaskDialog.Show('Заголовок', 'Основной текст')

Проведение транзакций для внесения изменений в модель

			
TransactionManager.Instance.EnsureInTransaction(doc)
element.LookupParameter('Комментарии').Set(mark)
TransactionManager.Instance.TransactionTaskDone()

Фильтр по категории из связного файла

			
link = UnwrapElement(IN[0])
cat = UnwrapElement(IN[1])
linkDoc = link.GetLinkDocument()
catFilter = ElementCategoryFilter(cat.Id)
linkedElements = list(FilteredElementCollector(linkDoc).WherePasses(catFilter).WhereElementIsNotElementType())

Поиск семейства

			
family_symbol_name = "_MAG Вывод"
family_symbol = None
collector = FilteredElementCollector(doc)
family_symbols = collector.OfClass(FamilySymbol).ToElements()
for symbol in family_symbols:
	if symbol.FamilyName == family_symbol_name:
		family_symbol = symbol
		break

Значение параметра по его названию

			
element.LookupParameter('TSL_Id исходного элемента').AsString()

Значение встроенного параметра

			
equipment.get_Parameter(BuiltInParameter.RBS_SYSTEM_CLASSIFICATION_PARAM).AsString()

Поиск координат объекта XYZ

			
location = element.Location.Point
location = origin.OfPoint(location)

Нахождения пространства в точке

			
space = doc.GetSpaceAtPoint(location)

Нахождения типоразмера элемента

			
typeId = equipment.GetTypeId()
type = doc.GetElement(typeId)

Элементы в цепи

			

circuit.Elements

Конвертация параметра человеческий/Revit

			
def convertFrom(x):
    try:
        length = UnitUtils.ConvertFromInternalUnits(x, UnitTypeId.Millimeters)
    except:
        length = UnitUtils.ConvertFromInternalUnits(x, DisplayUnitType.DUT_MILLIMETERS)
    return length


def convertTo(x):
    try:
        bits = UnitUtils.ConvertToInternalUnits(x, UnitTypeId.Millimeters)
    except:
        bits = UnitUtils.ConvertToInternalUnits(x, DisplayUnitType.DUT_MILLIMETERS)
    return bits

Фильтрация вложенных семейств

			
element.SuperComponent == None

Натуральная сортировка

			
def make_natural(s):
	return [int(text) if text.isdigit() else text.lower() for text in re.split('(\d+)', s)]
o_cable = sorted(cable, key=make_natural)

Удаление строк ключевой спецификации и создание новой

			
colTableData = schedule.GetTableData()
tsd = colTableData.GetSectionData(SectionType.Body)
tsd.InsertRow(1)
last_row(schedule).LookupParameter('KT_Наименование и техническая характеристика').Set('2. Кабельно-проводниковая продукция')

Выбор последний строки ключевой спецификации (по ключевому номеру)

			
def last_row(schedule):
	key_name = 0
	rows = UnwrapElement(FilteredElementCollector(doc, schedule.Id).ToElements())
	for j in rows:
		if int(j.get_Parameter(BuiltInParameter.REF_TABLE_ELEM_NAME).AsString()) > key_name:
			key_name = int(j.get_Parameter(BuiltInParameter.REF_TABLE_ELEM_NAME).AsString())
			row = doc.GetElement(j.Id)
	return row

Удаление цифр из строки и наоборот

			
str(''.join([n for n in i if not n.isdigit()]))  + str(''.join([n for n in i if n.isdigit()])) + 'мм'

Фильтры всех элементов по категории

			
FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_GenericAnnotation) #типовые аннотации
FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_LightingFixtures).OfClass(FamilyInstance) #осветительные приборы
FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_LightingDevices).OfClass(FamilyInstance) #выключатели
FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_ElectricalFixtures).OfClass(FamilyInstance) #розетки
FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_CableTray).OfClass(FamilyInstance) #лотки
FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_CableTrayFitting).OfClass(FamilyInstance) #соединители кабельных лотков
FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_DuctLinings).OfClass(FamilyInstance) #воздуховоды
FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_DuctFitting).OfClass(FamilyInstance) #соединители воздуховодов
FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_ElectricalEquipment).OfClass(FamilyInstance) #электрическое оборудование
FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_Levels).WhereElementIsNotElementType().ToElements() #уровни
FilteredElementCollector(doc).OfCategory(BuiltInCategory.OST_MEPSpaces).ToElements() #пространства
FilteredElementCollector(linkDoc).OfCategory(BuiltInCategory.OST_Rooms).WhereElementIsNotElementType().ToElements() #помещения

Поворот элемента

			
location = element.Location.Point
p1 = location
p2 = XYZ(location[0], location[1], 1)
myLine = Line.CreateBound(p1, p2)
ElementTransformUtils.RotateElement(doc, new.Id, myLine, math.pi / 2)

Добавить элементы в цепь

			
eset = ElementSet()
eset.Insert(newElement)
if panel != '':
	for circuit in all_circuits:
		if circuit.Name == panel:
			circuit.AddToCircuit(eset)

Фильтрация зависимых элементов

			
ids = element.GetDependentElements(ElementCategoryFilter(BuiltInCategory.OST_ElectricalFixtureTags))

Выделить элемент в модели (как в спецификации)

		
uidoc.ShowElements(element)

Удаление и создание строк ключевой спецификации

			
# Delete old Schedule
[doc.Delete(i.Id) for i in UnwrapElement(FilteredElementCollector(doc, schedule.Id).ToElements())]
# get schedule data
colTableData = schedule.GetTableData()
tsd = colTableData.GetSectionData(SectionType.Body)
#make a row
row = tsd.InsertRow(1)
row.LookupParameter('KT_Наименование и техническая характеристика').Set('2. Кабельно-проводниковая продукция')

Сбор всех элементов с активного вида с фильтрацией по категории

			
active_view = doc.ActiveView
elements = FilteredElementCollector(doc, active_view.Id).OfCategory(BuiltInCategory.OST_GenericAnnotation).WhereElementIsNotElementType()