Описание

Инструмент для создания графиков на чертеже в программе КОМПАС-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-разрядная версия) Не работает группировка объектов графика по макроэлементам и слоям.