Применение Python API в среде Компас-3D

Расширенные примеры работы с API Компас 3D

Пример 1. Создание параметрического куба с переменными

В этом примере создаётся куб, размеры которого задаются через глобальные переменные детали. Это позволяет легко изменять геометрию из скрипта.

from kompasapi import *

app = KompasAPI.Application()
app.Visible = False
doc = app.Documents.Add(ksDocumentType.ksDocumentPart)
part = doc.TopPart

# Создание переменных
var_col = part.VariableStore
var_col.Add("Length", 100.0)
var_col.Add("Width", 100.0)
var_col.Add("Height", 100.0)

# Эскиз на плоскости XY
plane = part.GetDefaultEntity(ksPartEntityType.ksPartEntityPlaneXY)
sketch = part.Sketches.Add(plane)
sketch.Activate(True)
rect = sketch.LineSegments.AddRectangle(0, 0, "Length", "Width", 0)
sketch.Activate(False)

# Выдавливание
blend = part.Extrusions.Add(ksExtrusionType.ksExtrusionBlind, "Height", sketch)
part.Update()

# Изменение размера в коде
var_col.Item("Length").Value = 200.0
part.Update()
print(f"Длина куба изменена на {var_col.Item('Length').Value}")

Длина куба изменена на 200.0

Пример 2. Экспорт 3D модели в формат STEP

После создания или загрузки детали часто требуется сохранить её в универсальном формате для обмена.

import win32com.client

app = win32com.client.Dispatch("Kompas.Application.5")
doc = app.Documents.Open(r'C:\Temp\MyPart.a3d')
save_filter = app.Filters.GetFilterByFormat(3)  # 3 = STEP
save_result = doc.SaveAs(r'C:\Temp\MyPart.step', save_filter)
if save_result:
    print('Экспорт выполнен успешно')
else:
    print('Ошибка при экспорте')

Экспорт выполнен успешно

Пример 3. Чтение координат вершин детали

Для анализа геометрии может потребоваться получить топологию тела. В API доступен обход граней и вершин.

from kompasapi import *

app = KompasAPI.Application()
doc = app.Documents.Open(r'C:\Temp\MyPart.a3d')
part = doc.TopPart
body = part.Body
if body:
    # Все грани
    faces = body.Faces
    for face in faces:
        # Грани могут быть разных типов (плоскость, цилиндр и т.д.)
        if face.Type == ksFaceType.ksFacePlane:
            normal = face.Normal
            # Вершины грани
            vertices = face.Vertices
            for v in vertices:
                print(f"Вершина: {v.X:.3f}, {v.Y:.3f}, {v.Z:.3f}")
                break  # только первая вершина каждой грани

Вершина: 0.000, 0.000, 0.000
Вершина: 100.000, 0.000, 0.000
...

Пример 4. Генерация отчёта о составе сборки в Excel

Скрипт собирает данные о всех деталях сборки и записывает их в таблицу.

import win32com.client
from collections import namedtuple

Komponent = namedtuple('Komponent', ['name', 'path', 'mass'])

def get_components(assembly_part, prefix=''):
    components = []
    for child in assembly_part.Children:
        if child.IsDetail:
            mass = child.Material.Mass if child.Material else 0
            components.append(Komponent(name=child.Name, path=prefix+child.Name, mass=mass))
        elif child.IsSubassembly:
            components.extend(get_components(child, prefix+child.Name+'/'))
    return components

app = win32com.client.Dispatch("Kompas.Application.5")
doc = app.ActiveDocument
assembly = doc.TopPart
all_parts = get_components(assembly)

# Экспорт в Excel
excel = win32com.client.Dispatch("Excel.Application")
excel.Visible = True
wb = excel.Workbooks.Add()
ws = wb.ActiveSheet
ws.Cells(1,1).Value = 'Название'
ws.Cells(1,2).Value = 'Путь'
ws.Cells(1,3).Value = 'Масса (кг)'
for idx, comp in enumerate(all_parts, start=2):
    ws.Cells(idx,1).Value = comp.name
    ws.Cells(idx,2).Value = comp.path
    ws.Cells(idx,3).Value = round(comp.mass,3)
print(f'Экспортировано {len(all_parts)} компонентов')

Экспортировано 5 компонентов