Описание

Инструмент для создания графиков на чертеже в программе КОМПАС-3D.

Обзор Библиотеки (youtube)

Использование

Зависимости

1. КОМПАС-3D v21 и выше.
2. Python 3.2 и выше.
3. NumPy

Опционально:

1. pandas
2. openpyxl

Использование с установкой

1. Скачайте последний релиз проекта artchart-{version}.tar.gz из репозитория (раздел релизы на gitflic).
2. Для установки откройте командную строку в папке загрузки и введите следующую команду:

python -m pip install artchart-{version}.tar.gz

3. Создайте новую директорию для сохранения скриптов. В этой директории создайте новый файл скрипта, например test1.py.
4. Скопируйте в файл test1.py код инициализации API КОМПАС-3D (*).
5. Скопируйте код из примера (examples/A00_simple_line.cdm) в конец файла test1.py.
6. Откройте КОМПАС-3D, создайте новый файл чертежа (файл должен быть активным).
7. Запустите скрипт test1.py любым удобным вам способом. *) При запуске, скрипт создаст график на новом виде активного документа-чертежа.

Использование без установки

1. Скачайте исходный код проекта из репозитория.
2. Создайте новую директорию для сохранения макросов. В этой директории создайте новый файл скрипта, например test1.py.
3. Скопируйте в файл test1.py код инициализации API КОМПАС-3D (*).
4. Скопируйте код из примера (examples/A00_simple_line.cdm) в конец файла test1.py.
5. В файле test1.py раскомментируйте следующие строчки и добавьте абсолютный путь до кода библиотеки:

# import sys
# sys.path.append(r"/абслютный/путь/до/artchart/src/")

Например:

import sys
sys.path.append(r"C:/Users/user/Documents/Dev/artchart/src/")

6. Установите библиотеку pywin32. Для этого в командной строке введите:

python -m pip install pywin32

7. Откройте КОМПАС-3D, создайте новый файл чертежа (файл должен быть активным).
8. Запустите скрипт test1.py любым удобным вам способом. *) При запуске, скрипт создаст график на новом виде активного документа-чертежа.

Код инициализации API КОМПАС-3D (*)

1. Откройте КОМПАС-3D, создайте новый файл чертежа.
2. В панели Приложения -> КОМПАС-Макро -> Макросы. Далее нажимаем Создать.
3. Задайте имя для файла макроса, например test1.cdm, и нажмите сохранить. Далее откроется встроенная среда разработки PyScripter.
4. В среде разработки откроется созданный файл test1.cdm:

import pythoncom
from win32com.client import Dispatch, gencache
. . .
# Какой-то мутный код
. . .

5. Для работы скрипта необходимо из этого файла скопировать следующие строчки (Инициализация API КОМПАС-3D):

import pythoncom
from win32com.client import Dispatch, gencache

kompas6_constants = gencache.EnsureModule("{цифры}", 0, 1, 0).constants
kompas6_constants_3d = gencache.EnsureModule("{цифры}", 0, 1, 0).constants

kompas_api7_module = gencache.EnsureModule("{цифры}", 0, 1, 0)
application = kompas_api7_module.IApplication(Dispatch("Kompas.Application.7")._oleobj_.QueryInterface(kompas_api7_module.IApplication.CLSID, pythoncom.IID_IDispatch))

Documents = application.Documents
kompas_document = application.ActiveDocument
kompas_document_2d = kompas_api7_module.IKompasDocument2D(kompas_document)

Ограничения (To-Do)

1. Нет возможности задать координаты для создания вида графика.
2. Можно создавать только графики из прямых линий (добавить тип scatter).
3. Не поддерживается файл чертежа-фрагмент (.frw).
4. Линии могут строится за границей поля.
5. Нет возможности автоматически задавать стиль линий графика.
6. Нет возможности автоматически создавать подписывать оси и линии.
7. Нет возможности подписывать масштаб графика (зачем это вообще в современном мире?).

Протестированно

1. КОМПАС-3D Учебная версия 23.0.3.2285 (64-разрядная версия)
2. КОМПАС-3D Учебная версия 23.0.1.2182 (64-разрядная версия) Отображается ошибка далее при открытии PyScripter.

Could not write file
  "C:\ . . . \remserver.py" and cannot use a remote Python engine

При нажатии abort всё работает нормально.

3. КОМПАС-3D Учебная версия 21.0.1.1158 (64-разрядная версия) Не работает группировка объектов графика по макроэлементам и слоям.