Использование скриптов PYTHON в программных продуктах

Использование скриптов PYTHON в программных продуктах CREDO III Введение С 2010 года в платформу CREDO III встроена поддержка скриптов языка программирования Python, и сейчас уже возможно практическое применение скриптов а программных продуктах. Скрипты — это несложные микропрограммы, которые позволяют автоматически выполнять последовательности команд в программах на платформе CREDO III, а также других скриптов. Скрипты имеют доступ ко всем функциям и данным как самой платформы CREDO, так и элементам текущего проекта. Сами скрипты могут реализовывать серьезные функции и объекты, в том числе элементы пользовательского интерфейса (окна, диалоги, кнопки). Сцена́рный язы́к или скри́птовый язы́к (англ. scripting language, в русской литературе
принято название язык сценариев) — высокоуровневый язык программирования для написания
сценариев — кратких описаний выполняемых системой действий. Разница между программами
и сценариями довольно размыта. Сценарий — это программа, имеющая дело с готовыми
программными компонентами[1] ‐ Wikipedia.
Установка скриптов Компания «Кредо‐Диалог» разработала и бесплатно предоставляет для использования ряд скриптов, созданных по сценариям пользователей для большей автоматизации проектирования объектов: 1. Автоматизированный экспорт объектов из ПП CREDO II (CREDO_TER, CAD_CREDO, CREDO_MIX) в формат DXF с использованием программы CREDO КОНВЕРТЕР. 2. Автоматизированное создание чертежей разреза по заданным сечениям в ПП CREDO ЛИНЕЙНЫЕ ИЗЫСКАНИЯ, CREDO ГЕНПЛАН и CREDO ДОРОГИ. 3. Автоматизированное выполнение поперечного выравнивания с получением линии руководящих отметок (ЛРО) для дальнейшего проектирования. 4. Групповое автоматизированное пересоздание ведомостей профиля (с выбором комплекта ведомостей). Запуск скриптов Для использования скриптов необходимо перейти на сайт компании www.credo‐
dialogue.com и в разделе – Центр загрузки/Скрипты для CREDO III версии 1.12 с пакетом исправлений № 1 скачать архив со скриптами (http://www.credo‐
dialogue.com/Downloads/correction_renovation/CREDO_III_1_12_macros.aspx). Затем распакуйте скаченный архив в корень диска D. В результате вы получите папку D:\CredoIII_1_12_Макросы, которая будет иметь следующую структуру: — Папка Macroses: содержит папки с соответствующими скриптами (CREDOII‐DXF, Пересоздание_ведомостей_профиля_1_12, Ремонт_1_12, Чертежи_Разреза_1_12), системные папки, необходимые для работы скриптов (Library, Data, Images), а также папку Logs, в которую будет сохраняться техническая информация о работе того или иного скрипта. —Папка Результаты: содержит папку Ведомости, в которую в последующем будут сохраняться созданные скриптом ведомости (Пересоздание_ведомостей_профиля_1_12). — Файл Macroses.bat: файл регистрации скриптов в программных продуктах на платформе CREDO III. Для регистрации скриптов в ПП на платформе CREDO III (CREDO ДОРОГИ 1.12, CREDO ГЕНПЛАН 1.12, CREDO ЛИНЕЙНЫЕ ИЗЫСКАНИЯ 1.12, CREDO КОНВЕРТЕР 1.12) необходимо двойным щелчком мыши запустить файл ‐ D:\CredoIII_1_12_Макросы\Macroses.bat. Эта операция пропишет в системном реестре путь к скопированным скриптам, таким
образом, в последующем система будет знать, где расположены системные библиотеки
скриптов и сами скрипты. При необходимости возможно перемещение папки
CredoIII_1_12_Макросы в другое место. Для регистрации папки со скриптами в новом меcте
жесткого
диска
ПК
необходимо
повторно
запустить
файл
CredoIII_1_12_Макросы\Macroses.bat.!
Для проверки правильной установки скриптов запустите имеющуюся у Вас систему на платформе CREDO III. Откройте любой существующий набор проектов или создайте новый набор проектов и выберите команду главного меню Данные/Запуск сценариев. Результат команды представлен на рисунке. В окне отображена информация о месте расположения папки со скриптами и необходимыми системными библиотеками — D:\CredoIII_1_12_Макросы\Macroses. Ниже приведены названия скриптов. Обратите внимание на системные настройки и информацию по исправлению проблем: — Переключение между языками ввода должно осуществляться по Ctrl+Shift. Язык ввода по умолчанию должен быть английский. — Система CREDO ДОРОГИ может аварийно завершить работу либо скрипт может останавливаться в случае несоответствующих данных. — В случае возникновения проблем, необходимо выслать актуальный лог‐файл (...\Macroses\Logs\) и информацию об операционной системе, которая установлена на данном компьютере. — Если по каким‐либо причинам не открывается окно со скриптом или скрипт сразу вылетает, нужно открыть «Диспетчер задач» и принудительно завершить работу всех процессов «Roads.exe» ВНИМАНИЕ!!! Во время выполнения скрипта работать за компьютером нельзя!
Описание скриптов Для запуска скриптов, после выбора команды Данные/Запуск сценариев, в окне Запуск сценариев даблкликом укажите нужный скрипт. Запуск представленных скриптов должен осуществляется на определенных этапах проектирования, которые будут рассмотрены ниже, в соответствующих разделах. Работа со скриптом «CREDOII‐DXF» Данный скрипт автоматизировано выполняет экспорт объектов из ПП CREDO II (CREDO_TER, CAD_CREDO, CREDO_MIX) в формат DXF с использованием программы CREDO КОНВЕРТЕР. Приведем последовательность действий выполняемых скриптом:  Чтение скриптом настроек (наличие папок, в которых будут находиться DOS‐проекты для импорта, папок для экспортированных DXF‐файлов, а также путей к файлам «Схема соответствия для экспорта» и «Схема соответствия для импорта»).  Открытие схемы соответствия для экспорта (задается в файле с настройками, который будет рассмотрен позже).  Установка масштаба съемки 1:1000 в Свойствах набора проектов/Масштаб и системы координат.  Создание нового узла. 
Импорт в созданный узел DOS‐объекта из указанного в настройках места с настройкой схемы соответствия.  Экспорт набора проекта в DXF с флагом создавать тематические слои с сохранением в указанное в настройках место. Каждый скрипт можно настроить, например, для указания папки сохранения результата. В папке D:\CredoIII_1_12_Макросы\Macroses\CREDOII‐DXF\Data\settings.txt расположен текстовый файл с настройками. Рассмотрим его подробнее: В строке [схема соответствия для экспорта] – прописывается название используемой схемы соответствия (настроена на схему по умолчанию). При необходимости использования своей схемы ее нужно создать, сохранить в библиотеку разделяемых ресурсов, а затем вместо «Экспорт в DXF» ввести имя созданной и сохраненной схемы. Обратите внимание, что написание не должно отличаться от имени схемы, сохраненной в библиотеке разделяемых ресурсов, в противном случае возникнет ошибка. В строке [путь для импорта] – указывается путь к папке, откуда будут экспортироваться DOS‐объекты. Соответственно, [путь для экспорта] – путь сохранения для конвертированных в DXF‐ файлов. В [схема соответствия для импорта] – указывается имя, сохраненной в библиотеке общих ресурсов, схемы. Для использования своей схемы, необходимо проделать шаги, описанные выше. Таким образом, перед запуском скрипта должны выполняться следующие условия: 1. Запущена система CREDO КОНВЕРТЕР с созданным пустым новым набором проектов. 2. Наличие DOS‐объектов в созданной папке D:\DOS\ (имя папки задано по умолчанию). 3. Наличие сохраненных схем соответствия для экспорта и импорта в библиотеке разделяемых ресурсов, и введенные их имена в настроечном файле. !Все остальные файлы и папки в D:\CredoIII_1_12_Макросы\Macroses\CREDOII‐DXF\ (кроме
D:\CredoIII_1_12_Макросы\Macroses\CREDOII‐DXF\Data\settings.txt) являются системными. Не
редактируйте и не перемещайте их.
Работа со скриптом «Автоматизированное создание чертежей разреза по заданным сечениям» в ПП CREDO ЛИНЕЙНЫЕ ИЗЫСКАНИЯ, CREDO ГЕНПЛАН и CREDO ДОРОГИ Данный скрипт позволяет автоматизировано получить чертежи DXF по заданным линиям разреза. Причем количество линий разреза не ограничивается. Другими словами, возможно предварительное нанесение необходимых линий разреза в плане для последующего создания чертежей. Приведем краткую последовательность действий скрипта:  С помощью команды Поиск происходит поиск всех ЛТО с названием «Обозначение разреза». Далее для каждой найденной маски ЛТО выполняются действия, описанные ниже.  К ЛТО применяет шаблон разреза.  У найденного ЛТО разреза вначале считывается отметка земли.  Выполняется автоматизированный переход в профиль ЛТО.  Назначается черный профиль.  Создается чертеж и экспортируются данные в dxf, который сохраняется в 
D:\CredoIII_1_12_Макросы\Macroses\Чертежи_Разреза_1_12\Data с разреза. По окончании выполнения скрипта выдается соответствующее сообщение. именем Для корректной работы скрипта необходимо выполнить ряд предварительных действий и настроек: 1. Нанести в плане линейные тематические объекты (ЛТО) «Обозначение разреза». Обратите внимание на то, что при создании ЛТО, в панели параметров, необходимо задать семантические свойства (см. рис.) — имя разреза (1, 2, 3, 4 и т.д.). Это нужно для идентифицирования готовых чертежей DXF и недопущения удаления созданных чертежей разрезов. В файле общих ресурсов, выпускаемых с Пакетом обновлений №1 для CREDO III ver.1.12, уже
присутствует линейный тематический объект «Обозначение разреза», который необходимо
использовать для нанесения линий разрезов в плане. Для их использования импортируйте dbx
или обновите библиотеку разделяемых ресурсов.
2. При необходимости можно отредактировать шаблон_для_разреза.mpm, который расположен в D:\CredoIII_1_12_Макросы\Macroses\Чертежи_Разреза_1_12\Data или создать свой шаблон и сохранить его в вышеприведенную папку с таким же именем (исходный шаблон должен быть удален). В шаблоне могут быть заданы следующие параметры: соотношения масштабов, стиль вычерчивания, шаблон чертежа и другие оформительские настройки.
Перед запуском скрипта должны выполняться следующие условия: 1. Запущена система CREDO III с открытым набором проектов. 2. Исходный проект должен быть активным. 3. Исходный проект должен содержать слои Рельеф (видимость этого слоя должна быть включена и слой должен находиться на верхнем уровне в дереве слоев). 4. Т.к. будет использован шаблон, все ЛТО разреза должны быть без набора проектов профилей. Если у ЛТО разреза уже будет профиль, то чертеж будет создаваться без применения к маске ЛТО разреза шаблона. 5. Поверхность должна присутствовать на всем протяжении всех ЛТО разреза. 6. Видимость слоя, где хранятся разрезы, должна быть включена. 7. Наличие шаблона «шаблон_для_разреза.mpm», в папке D:\CredoIII_1_12_Макросы Macroses\Чертежи_Разреза_1_12\Data\. 8. Запуск скрипта осуществляется после выбора команды Данные/Запуск сценариев и и последующего двойного щелчка мыши по строке – Чертежи_разреза_1_12. !Все остальные файлы и папки в d:\CredoIII_1_12_Макросы\Macroses\Чертежи_Разреза_1_12\ являются системными. Не редактируйте и не перемещайте их.
Работа со скриптом «Автоматизированное выполнение поперечного выравнивания с получением линии руководящих отметок (ЛРО) для дальнейшего проектирования» Данный скрипт предназначен для быстрого, автоматизированного получения поперечного выравнивания, путем расчета ЛРО и эскизной лини при выполнении ремонтов по типовым параметрам. Перед запуском скрипта необходимо выполнить следующие действия: 1. Выбрать команду Информация. 2. Навести курсор в режиме захвата точки на начальную точку трассы. В окне параметры отобразиться следующая информация: При помощи перебора (клавиша F3), нужно выбрать информацию о точке начала трассы, как показано на рисунке. Далее захватываем эту точку начала трассы. В меню выбираем команду Данные/Запуск сценариев и запускаем скрипт. После запуска скрипта, выполняются следующие действия: 



Происходит определение отметки земли в точке начала трассы АД (это необходимо для правильного назначения черного профиля). По определенным в первым пункте координатам, выполняется захват трассы и применение к ней шаблона параметры_дороги_и_ремонта.mpm (D:\CredoIII_1_12_Макросы\Macroses\Ремонт_1_12\Data\параметры_дороги_и_ремонта
.mpm). Выполняется переход в профиль и назначение черного профиля (по известной отметке земли). Далее выбирается слой, в котором расположены кодировки ПТО по существующей дороге, остальные параметры соответствия должны быть заданы в применяемом выше шаблоне. 
Так как в настройках ремонта (в применяемом шаблоне) выставлен параметр «С учетом существующего покрытия», на этом этапе выполняется расчет Изменений ширины ПЧ слева/справа;  По параметрам рассчитывается линия руководящих отметок;  По окончании выполнения скрипта выдается соответствующее сообщение. !После завершения скрипта, можно продолжать проектирование обычным способом.
Для запуска и корректной работы этого скрипта, необходимо:  Открытый набор проектов.  Исходный проект должен быть активным.  Так как будет использован шаблон, трасса АД должна быть без набора проектов профилей.  Если у трассы АД уже будет профиль, то переход в профиль будет осуществляться без применения шаблона и до конца скрипт не будет выполнен.  Вся трасса АД должна подлежать ремонту, то есть поверхность и ПТО с существующим покрытием и т.д. должны присутствовать на всем протяжении трассы, и быть корректными.  Слой с кодировкой элементов дороги находится в слое ПТО (слой должен находиться на верхнем уровне в дереве слоев ).  Слой с рельефом должен называться Рельеф (видимость этого слоя должна быть включена и слой должен находиться на верхнем уровне в дереве слоев).  Наличие шаблона трассы (по умолчанию, вместе со скриптом в папке D:\CredoIII_1_12_Макросы\Macroses\Ремонт_1_12\Data\ будет расположен шаблон, подготовленный сотрудниками компании «Кредо‐Диалог»). Шаблон можно исправить «под себя», либо создать новый ( с таким же названием), исходя из требований к проекту. Шаблон содержит следующие настройки:  Ширина проектного поперечника;  Интервал ремонта, со следующими параметрами (обратите внимание на то, что заданы слои и толщины усиления и выравнивания). !В последующем шаблон можно доработать, добавив оформительские настройки, например,
шаг ординат и отметок.

Запуск скрипта осуществляется в окне План при открытом наборе проектов с подготовленными данными. Работа со скриптом «Групповое автоматизированное пересоздание ведомостей профиля (с выбором комплекта ведомостей)» для системы CREDO ДОРОГИ Предложенный скрипт позволяет минимизировать затраты по пересозданию ведомостей профиля (объемы работ, параметров профиля) после редактирования профиля, поперечников, конструкции дорожной одежды либо других элементов. Запуск скрипта осуществляется из окна профиля командой главного меню Данные/Запуск сценария, и последующего двойного щелчка мыши по строке Пересоздание_ведомостей_профиля_1_12. Поскольку скрипт пересоздает ранее созданные ведомости, перед запуском скрипта необходимо хотя бы единожды создать нужные ведомости. Нужно это для того, чтобы в последующем скрипт «знал» параметры создания ведомостей (шаблон ведомости, шаг детализации, шаг отображения). Разумеется, не всегда нужно пересоздавать весь пакет ведомостей. Для того чтобы настроить типы пересоздаваемых ведомостей, перейдите в D: \CredoIII_1_12_Макросы\Macroses\Пересоздание_ведомостей_профиля_1_12\Data\ и откройте блокнотом файл settings.txt. Напротив ведомостей которые НЕ БУДУТ пересоздаваться стоит знак «‐». Соответственно, перед пересоздаваемыми ведомостями такого знака не будет. Для добавления пересоздаваемой ведомости в скрипт, перед запуском скрипта необходимо удалить знак «‐», стоящий перед названием ведомости, и сохранить файл settings.txt. Запуск скрипта осуществляется из окна профиля Вид работ/Все проекты командой главного меню Данные/Запуск сценария и последующего двойного щелчка мыши по строке ‐ Пересоздание_ведомостей_профиля_1_12, после настройки типа ведомостей в settings.txt. Ведомости будут сохранены в папку ‐ D://CredoIII_1_12_Макросы\Результаты\Ведомости\. При каждом запуске скрипта происходит очистка этой папки.