Работа с языком запросов

Altium Training

Altium Essentials: PCB Global Editing and List Panel

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

Краткий обзор

Работа с сотнями объектов проекта по отдельности может замедлить внесение изменений в схемы и печатные платы. В этой статье представлен язык запросов Altium Designer и описано, как с помощью логических запросов находить, подсвечивать, выделять и редактировать нужные группы объектов. Рассматриваются область действия фильтра, создание запросов с помощью Query Helper и Query Builder, настройки отображения и способы повторного использования запросов. На этой странице также приведены списки операторов логических выражений запросов и глобальных системных функций запросов. Читайте дальше, чтобы эффективнее управлять объектами проекта и быстрее вносить однотипные изменения.

- Узнайте, как запросы позволяют находить определённые объекты и как область действия фильтра определяет, в каких документах и среди каких объектов выполняется поиск.
- Научитесь создавать и проверять выражения запросов, а затем управлять выделением, масштабированием и маскированием результатов.
- Разберитесь, как применять и сбрасывать фильтры, повторно использовать избранные и недавние запросы, а также расставлять скобки, чтобы сделать выражения понятнее.
Узнайте больше с ИИ:

Что такое запрос?

Пожалуй, самая сложная задача при работе над сложным электронным проектом — управление большим количеством объектов проекта. От компонентов, меток цепей и текстовых строк на листах схемы до сотен компонентов и дорожек, образующих трассировку печатной платы,  — ко всем этим объектам необходимо иметь доступ для просмотра и редактирования. Как и в большинстве приложений Windows, можно дважды щелкнуть объект и изменить его свойства. Это удобно для одного объекта, но вряд ли подойдет, если нужно отредактировать более 300 строк позиционных обозначений компонентов или изменить все переходные отверстия на плате. Для таких изменений необходим одновременный доступ к нескольким объектам. 

В основе редакторов схем и печатных плат Altium Designer лежит мощный механизм запросов. Вводя запросы, можно с помощью фильтрации находить и редактировать именно те объекты, которые вам нужны.

Мощная система фильтрации и редактирования данных в Altium Designer позволяет указать программе, какой набор объектов требуется получить. Такое указание вводится в виде запроса. Запрос — это строка, составленная с использованием определенных ключевых слов и синтаксиса, которая возвращает нужные объекты. Что делать с этими объектами дальше, решать вам. Например, можно подсветить их и приглушить все остальные объекты, а можно просмотреть или отсортировать их свойства и изменить определенные общие для них атрибуты.

Запросы можно применять в разных местах, но основным центром управления служат Filter панели, показанные на изображениях ниже. Нажмите F12, чтобы отобразить или скрыть панель Filter .

Панели PCB Filter и SCH Filter с запросамиПанели PCB Filter и SCH Filter с запросами

Панели PCBLIB Filter и SCHLIB Filter с запросами
Панели PCBLIB Filter и SCHLIB Filter с запросами

Элементы управления на панели позволяют задать, к каким объектам будет применяться запрос и как обрабатывать объекты, соответствующие и не соответствующие запросу.

Язык запросов также используется в диалоговом окне PCB Rules and Constraints Editor для определения областей действия правил проектирования (подробнее см. страницу Определение правил проектирования печатных плат, настройка их областей действия и управление ими). Обратите внимание: набор объектов, на которые распространяется правило проектирования, зависит не только от запроса, но и от типа правила (например, правило Width действует только на дорожки, а правило Routing Via Style — только на переходные отверстия и т. д.). Поэтому результаты подсветки или определения набора объектов при использовании одного и того же выражения запроса в панели Filter и в области действия правила могут различаться.

Где найти результаты запроса?

Итак, вы составили запрос в панели Filter . Как получить доступ к объектам, найденным по этому запросу? В среде Altium Designer доступны два способа доступа к объектам и их редактирования.

  • Графически — после применения фильтра по умолчанию все объекты, не соответствующие запросу, маскируются (отображаются приглушённо и становятся недоступными для редактирования), а остальные остаются без изменений. Этот режим отлично подходит для поиска и просмотра объектов в рабочей области. Поскольку замаскированные объекты недоступны для редактирования, такие команды, как Ctrl+A (выбрать всё), применяются только к объектам, найденным по запросу.

  • List панель — панель List (Shift+F12) представляет данные проекта в виде электронной таблицы. По умолчанию в ней отображаются все объекты проекта, но после применения фильтра — только объекты, возвращаемые запросом. Панель List поддерживает стандартные для электронных таблиц операции сортировки и выделения, позволяя напрямую редактировать одну или несколько ячеек. 

Панели PCB List и SCH List  отображают результаты запросов PCB/SCH из предыдущего раздела.Панели PCB List и SCH List  отображают результаты запросов PCB/SCH из предыдущего раздела.

Параметры подсветки

При каждом применении запроса (или ином использовании функции фильтрации данных) для каждого объекта целевого документа определяется, входит ли он в результаты фильтрации. Однако то, как впоследствии отображаются объекты, вошедшие и не вошедшие в результаты, зависит от параметров подсветки, выбранных на панели Filter . Доступны три независимых параметра подсветки: можно выбрать один, два или все три.

Масштабирование

Если при применении запроса включен параметр Zoom , вид целевого документа обновляется так, чтобы отображалась область, занимаемая всеми объектами, вошедшими в результаты. Отображение остальных объектов в обновленном виде зависит от их расположения относительно этой области: каждый из них может отображаться полностью, частично или не отображаться вовсе. 

Этот параметр часто выбирают совместно с одним или обоими другими параметрами. Если параметр Mask не включен, объекты, не вошедшие в результаты, по-прежнему будут отображаться в графическом представлении, если они находятся в пределах обновленной области просмотра. На первый взгляд использование только этого параметра может показаться бессмысленным. Однако иногда требуется изменить графическое представление так, чтобы оно охватывало определенные объекты, не меняя при этом состояние выделения или маскирования каких-либо объектов документа.

Выделение

Если параметр Select включен, все объекты, вошедшие в результаты, выделяются, а со всех остальных объектов выделение снимается. Выделенные объекты отображаются более заметно, чем невыделенные.

Если при применении текущего запроса выбран параметр Select, все объекты, входящие в набор результатов, переходят в выделенное состояние, а все остальные объекты (не входящие в набор результатов) — в невыделенное. Этот параметр обычно выбирают непосредственно перед операциями глобального редактирования, поскольку при их выполнении изменяются свойства только выделенных объектов. Однако параметр Select может быть полезен и в других случаях, например при перемещении, копировании или удалении определенных объектов.

Маскирование

Параметр подсветки Mask определяет новое состояние маскирования объектов в целевом документе. Если он выбран, все объекты, вошедшие в результаты, маскируются, а со всех остальных объектов маскирование снимается. Главная особенность маскированных объектов заключается в том, что ни сами объекты, ни их свойства нельзя редактировать. (Маскированные объекты отображаются в списке приглушенными, но появляются в нем только в том случае, если на панели List выбран параметр all objects .) Главная особенность маскированных объектов заключается в том, что ни сам объект, ни его свойства нельзя редактировать.

Конструктор запросов

В редакторе печатных плат предусмотрено специальное диалоговое окно Query Builder. Оно позволяет создавать сложные запросы, выбирая условия проверки из раскрывающихся списков. Одно из преимуществ Query Builder — возможность создавать запросы для разных типов объектов.

Диалоговое окно Building Query (часть функции Query Builder) помогает пользователям, имеющим небольшой опыт составления запросов: запрос автоматически формируется в соответствии с условиями, заданными разработчиком.

В левой части этого диалогового окна расположены элементы управления, помогающие разработчику задать свойства, которыми должен обладать объект документа, чтобы попасть в результаты формируемого запроса. При добавлении или изменении каждого условия соответствующий запрос обновляется и отображается в правой части окна. Если затем закрыть окно нажатием кнопки OK (или Apply), запрос будет применен либо его текст будет скопирован обратно на панель Filter — в зависимости от того, каким способом было открыто это диалоговое окно.

Диалоговое окно Query Builder можно открыть следующими способами (как показано на рисунке ниже):

  • На панели PCB Filter нажмите кнопку Query Builder , чтобы создать запрос и загрузить его строку на панель.
  • В диалоговом окне PCB Rules and Constraints Editor нажмите кнопку Builder , чтобы создать запрос, определяющий объекты, к которым применяется это правило. 

Если диалоговое окно Query Builder открыто из диалогового окна PCB Rules and Constraints Editor, в нем отображаются только параметры, подходящие для данного типа правила.

На рисунке ниже показано использование диалогового окна Query Builder для создания запроса, выбирающего контактные площадки и переходные отверстия цепи 5V.

Диалоговое окно Query Builder
Диалоговое окно Query Builder

  • При необходимости добавьте другие условия, чтобы сузить целевой набор объектов проекта. Условия можно объединять логическими операторами AND или OR. По умолчанию используется логический оператор AND.
  • Чтобы изменить логический оператор между условиями, щелкните запись AND или OR в столбце Condition Type/Operator , затем выберите нужный оператор. Предварительный вид запроса обновится соответствующим образом.
  • Диалоговое окно Query Builder (Building Query from Board ) предлагает более простой способ создания запроса с использованием контекстно-зависимых типов условий и значений, позволяя составлять его только из подходящих «строительных блоков». Для создания более сложных запросов с полным указанием ключевых слов и синтаксиса операторов используйте диалоговое окно Помощник по запросам.
  • Вы можете в любой момент изменить любое условие в строке запроса, щелкнув соответствующую запись в столбце Condition Type/Operator  и выбрав нужное новое условие из доступных записей раскрывающегося списка. Предварительный вид запроса обновится соответствующим образом.
  • Используйте сочетания клавиш Ctrl+Up Arrow и Ctrl+Down Arrow  для перемещения выбранного условия вверх или вниз по структуре. 
  • Используйте сочетания клавиш Ctrl+Right Arrow и Ctrl+Left Arrow  для увеличения или уменьшения отступа в выбранной позиции структуры (добавления или удаления скобок).

Помощник по запросам

Следующий шаг в освоении составления запросов — использование диалогового окна Query Helper. Диалоговое окно Query Helper содержит поле Query , в котором можно ввести нужный запрос, используя кнопки синтаксиса под полем Query (например, And, Or, <, Not,  Like и т. д.), а также полный список всех ключевых слов запросов в поле Categories .

Диалоговое окно «Помощник по запросам» помогает проектировщикам создавать собственные запросы. Для каждого ключевого слова в списке приведено краткое описание. Чтобы открыть интерактивную справку, выделите ключевое слово и нажмите клавишу F1. Откроется диалоговое окно библиотеки документации Altium Designer, в котором подробно описано, какие объекты документа возвращает выделенное ключевое слово, как его использовать, а также приведен один или несколько примеров использования.

Диалоговое окно можно открыть следующими способами:

  • Нажмите кнопку Helper на панели Filter .

PCB Filter доступ через панель 

SCH Filter доступ через панель

Кнопка Helper становится доступна после нажатия Advanced в диалоговом окне File-based Libraries Search.

File-based Libraries Search доступ через диалоговое окноFile-based Libraries Search доступ через диалоговое окно

Используйте раздел Query в верхней части диалогового окна, чтобы составить выражение запроса с помощью доступных функций. В текстовом поле можно просмотреть и/или дополнительно отредактировать поисковое выражение. Для редактирования вводите текст непосредственно в это поле. Чтобы найти нужные ключевые слова для добавления, начните вводить текст. По мере ввода в диалоговом окне будет появляться раскрывающееся меню доступных ключевых слов, соответствующих уже введенному тексту. Щелкните ключевое слово, чтобы автоматически завершить ввод. Если нужное ключевое слово выделено, нажатие Enter также автоматически завершит ввод.

Найдите нужное ключевое слово в Categories доступных ключевых слов. Используйте поле Mask, если не знаете точное ключевое слово. Например, в Query Helper редактора схем ввод *har в поле Mask позволяет найти ключевые слова, относящиеся именно к жгутам, как показано на изображении ниже. Обратите внимание, что поле Mask выполняет поиск как по полю Name ключевого слова, так и по полю Description , поэтому с его помощью можно быстрее всего найти подходящие ключевые слова.

Если нажать F1, когда ключевое слово выделено или курсор находится внутри введенного ключевого слова, откроется документация по этому слову. Это наиболее полезный источник информации для изучения основных принципов работы каждого ключевого слова запросов.

Дважды щелкните ключевое слово в таблице, чтобы добавить его в запрос в текущей позиции курсора.

В средней области диалогового окна расположены кнопки синтаксиса с различными операторами для составления выражений. Подробнее о назначении каждой кнопки синтаксиса см. в разделе Логические операторы выражений запросов ниже. Используйте кнопку Check Syntax (в левом нижнем углу диалогового окна), чтобы проверить синтаксическую правильность выражения.

История запросов

При вводе и применении нового запроса на панели фильтрации (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) он добавляется в историю запросов. Чтобы открыть этот список, нажмите кнопку History на панели. Откроется диалоговое окно Expression Manager с активной вкладкой History .

На вкладке История диалогового окна Expression Manager приведен список ранее использованных выражений запросов. Здесь показан пример истории запросов для схемы. Наведите указатель мыши на изображение, чтобы увидеть аналогичный пример списка для печатной платы.На вкладке История диалогового окна Expression Manager приведен список ранее использованных выражений запросов. Здесь показан пример истории запросов для схемы. Наведите указатель мыши на изображение, чтобы увидеть аналогичный пример списка для печатной платы.

Чтобы использовать запрос из истории, выберите его запись в списке и нажмите кнопку Apply Expression или дважды щелкните саму запись. Диалоговое окно закроется, а выражение запроса будет загружено в центральную область соответствующей панели фильтрации.

Запрос из истории можно добавить в список избранных запросов, выбрав его запись и нажав кнопку Add To Favorites. Для очистки истории используйте кнопку Clear History.

До девяти последних использованных выражений запросов из списка будут доступны в подменю History контекстного меню панели фильтрации.

Обратите внимание: содержимое списка History является общим для панелей фильтрации в одной среде проектирования и доступно из каждой из них (SCH Filter / SCHLIB Filter в среде редактирования схем; PCB Filter / PCBLIB Filter в среде редактирования печатных плат). Некоторые выражения запросов могут не возвращать результатов в редакторе схем, особенно если они созданы для поиска объектов, доступных только в редакторе библиотек схем.

Избранные запросы

Любой заданный запрос можно добавить в список избранных запросов двумя способами:

  • Нажмите кнопку Add To Favorites или щелкните правой кнопкой мыши в основной области Query Expression и выберите команду Add to Favorites в контекстном меню, чтобы добавить выражение запроса, заданное в данный момент в центральной области активной панели фильтрации.
  • Выберите запись запроса из истории на вкладке History диалогового окна Expression Manager, затем нажмите кнопку Add To Favorites.

Избранные выражения запросов сохраняются на вкладке Favorites диалогового окна Expression Manager, где также выполняется управление ими. Открыть это окно можно с помощью кнопки Favorites на панели фильтрации (SCH Filter / SCHLIB Filter, PCB Filter / PCBLIB Filter) или щелкнув правой кнопкой мыши в основной области Query Expression панели фильтрации и выбрав команду Organize Favorites в контекстном меню. Из рабочей области проекта это диалоговое окно можно открыть, нажав сочетание клавиш Y, а затем выбрав Organize Favorites во всплывающем меню фильтрации.

Откройте список избранных запросов с панели фильтрации редактора или из рабочей области проекта через всплывающее меню фильтрации.Откройте список избранных запросов с панели фильтрации редактора или из рабочей области проекта через всплывающее меню фильтрации.

При добавлении выражения запроса в список Favorites ему присваивается уникальное имя. По умолчанию присваивается стандартное имя — Favorite_n, где n — следующий свободный номер. Имя записи можно изменить в любой момент одним из следующих способов:

  • Выберите запись запроса и нажмите кнопку Rename.
  • Выберите запись запроса, затем выберите команду Изменить в контекстном меню.
  • Выберите запись запроса, затем повторно щелкните в поле Name.

В каждом случае введите нужное имя, а затем щелкните за пределами поля Name, чтобы применить изменение.

Чтобы изменить избранное выражение запроса, выберите его запись в списке и нажмите кнопку Edit (или щелкните правой кнопкой мыши и выберите Edit в контекстном меню). Откроется диалоговое окно Edit Favorite. В нем можно изменить имя избранного запроса и само выражение, а также определить способ обработки объектов проекта — как соответствующих фильтру, так и не соответствующих ему.

Изменение существующего избранного запроса в диалоговом окне Edit Favorite, показанном здесь для схемы (слева) и печатной платы (справа).Изменение существующего избранного запроса в диалоговом окне Edit Favorite, показанном здесь для схемы (слева) и печатной платы (справа).

Чтобы удалить запрос из списка Favorites , выберите его запись в списке, затем нажмите кнопку Remove или выберите команду Remove в контекстном меню. Появится диалоговое окно с запросом подтверждения удаления.

Обратите внимание: содержимое списка Favorites  является общим для панелей фильтрации в одной среде проектирования и доступно из каждой из них (SCH Filter / SCHLIB Filter в среде редактирования схем; PCB Filter / PCBLIB Filter в среде редактирования печатных плат). Некоторые выражения запросов могут не возвращать результатов в редакторе схем, особенно если они созданы для поиска объектов, доступных только в редакторе библиотек схем.

Использование избранных запросов

Использовать избранные запросы можно тремя способами:

  1. На вкладке Favorites диалогового окна Expression Manager — выберите запись запроса и нажмите кнопку Apply Expression или дважды щелкните по записи. Диалоговое окно закроется, а выражение запроса будет загружено в центральную область соответствующей панели фильтрации.

  2. В верхней части контекстного меню панели фильтрации (доступно до десяти выражений запросов, последними добавленных в список Favorites ).

  3. Во всплывающем меню фильтрации рабочей области проекта (нажмите Y) — в верхней части меню отображается до десяти избранных выражений запросов. Выбранное выражение запроса будет загружено в центральную область соответствующей панели фильтрации.

Также можно назначить сочетание клавиш для избранного запроса, настроив меню Filter. Дополнительные сведения о настройке среды Altium Designer см. в разделе Настройка и адаптация Altium Designer.

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

Редакторы схем и печатных плат поставляются с набором готовых примеров запросов. Эти примеры доступны в меню фильтрации, которое можно открыть щелчком правой кнопки мыши в области выражения на панели фильтрации или с помощью сочетания клавиш Y в рабочей области проекта. Наведите указатель на Examples, чтобы открыть подменю.

При выборе пункта подменю применяется запрос, соответствующий этому фильтру. Чтобы увидеть само выражение запроса из примера, после его применения откройте список History . Этот список также доступен во всплывающем меню фильтрации.

Чтобы сбросить фильтрацию, нажмите Shift+C в рабочей области проекта или щелкните в ней правой кнопкой мыши и выберите команду Clear Filter в контекстном меню.

Инструменты построения запросов

Пожалуй, самый простой способ написать запрос — поручить это Altium Designer! Для этого можно использовать диалоговое окно Find Similar Objects или диалоговое окно Query Builder .

Диалоговое окно поиска похожих объектов

При использовании диалогового окна поиска похожих объектов формируется запрос для поиска нужных объектов. Если включен параметр Create Expression, этот запрос отображается на панели Filter . Это отличный способ изучить различные ключевые слова запросов.

Диалоговое окно Find Similar Objects открывается, если щелкнуть правой кнопкой мыши по любому незамаскированному объекту в документе проекта и выбрать Find Similar Objects в контекстном меню.

Слева: версия для печатных плат; справа: версия для схемСлева: версия для печатных плат; справа: версия для схем

Это диалоговое окно позволяет найти объекты, похожие на тот, по которому вы щелкнули правой кнопкой мыши, а затем указать, какие атрибуты объекта должны совпадать (или различаться) для соответствия условиям поиска. Предположим, вы хотите изменить все контактные площадки GND в проекте. Можно щелкнуть правой кнопкой мыши по одной из таких площадок, выбрать Find Similar Objects, а затем изменить значение поля Net с Any (настройка по умолчанию) на Same. При нажатии Apply в диалоговом окне будут выделены все контактные площадки GND. Если включен параметр Create Expression , на панели Filter появится следующий запрос: (ObjectKind = 'Pad') And (Net = 'GND').

Например, на схеме можно задать одинаковое значение свойства Color для всех объектов питания в документе с определенным значением свойства Text (например, 'GND'). Аналогично, на печатной плате можно задать одинаковое значение свойства Hole Size для всех переходных отверстий в документе с определенным значением свойства Via Diameter.

Дополнительную информацию об использовании диалогового окна Find Similar Objects см. в разделе Использование инструментов поиска похожих объектов.

Параметр Clear Existing

Включите параметр Clear Existing , чтобы сбросить текущее выделение или маску редактирования перед выполнением поиска. Отключите этот параметр, если вы выполняете несколько последовательных поисков и хотите накапливать их результаты.

Панель инструментов фильтрации

Панель Filter Toolbar доступна для документов печатных плат и позволяет маскировать все объекты в документе, кроме объектов с указанным свойством или объектов, входящих в состав указанного компонента. Крайнее правое поле панели инструментов используется для задания запроса. Можно ввести запрос в это поле или выбрать один из последних запросов в раскрывающемся списке (из списка History  запросов). При применении запросов с панели Filter Toolbar нельзя указать используемые параметры: во всех случаях предыдущий запрос сбрасывается, а к текущему запросу применяются параметры Mask и Zoom. Чтобы использовать параметры запросов, воспользуйтесь панелью Filter , диалоговым окном Query Builder, диалоговым окном Query Helper или диалоговым окном Find Similar Objects .

  • Если плата не разведена, при применении фильтра станут видны линии логических связей выбранной цепи. Если плата разведена, при применении фильтра станут видны трассы выбранной цепи.
  • При включенной маске все объекты, не попадающие под действие фильтра, будут недоступны для выделения и редактирования. Степень маскирования можно настроить вручную с помощью ползунка Masked Objects, расположенного в разделе Mask and Dim Settings на вкладке View Options панели View Configuration.
  • Вы можете в любой момент вручную сбросить текущий примененный фильтр с помощью сочетания клавиш Shift+C или нажав кнопку  на панели инструментов Filter .

Операторы логических выражений запросов

Ниже приведено краткое описание операторов, которые можно использовать при составлении логических выражений на языке запросов.

Арифметические операторы

Оператор Описание Пример
+ Оператор сложения NetPinCount + NetViaCount
- Оператор вычитания ArcStopAngle - ArcStartAngle
* Оператор умножения PadXSize_BottomLayer * PadYSize_BottomLayer
/ Оператор деления HoleDiameter / ViaDiameter
Div Оператор целочисленного деления Color Div 65536
Вычисляется результат деления Color на 65536, дробная часть результата отбрасывается
Mod Оператор остатка от деления Color Mod 256
Вычисляется остаток от деления Color на 256 без определения дробной части результата

Логические операторы

Оператор Описание Пример
And Оператор логического И IsPad And OnMultiLayer
Чтобы попасть в результаты запроса, объект должен быть контактной площадкой и находиться на слое Multi-Layer
&& Оператор логического И
(более низкий приоритет)
IsPad && OnMultiLayer
Чтобы попасть в результаты запроса, объект должен быть контактной площадкой и находиться на слое Multi-Layer
Or Оператор логического ИЛИ IsPad Or IsVia
Чтобы попасть в результаты запроса, объект должен быть контактной площадкой или переходным отверстием
|| Оператор логического ИЛИ
(более низкий приоритет)
IsPad || IsVia
Чтобы попасть в результаты запроса, объект должен быть контактной площадкой или переходным отверстием
Xor Оператор логического исключающего ИЛИ OnMultiLayer Xor (HoleDiameter <> 0)
Чтобы попасть в результаты запроса, объект должен либо находиться на слое Multi-Layer и иметь нулевое значение Hole Diameter, либо не
находиться на слое Multi-Layer и иметь ненулевое значение Hole Diameter.
Not Оператор логического НЕ Not OnMultiLayer
Чтобы попасть в результаты запроса, объект не должен находиться на слое Multi-Layer

При использовании оператора Not в выражениях запросов редактора печатных плат для исключения примитивов определенного типа учитывайте, что эти примитивы не будут исключены, если они входят в состав групповых объектов, которые также не исключены выражением. Например, выражение запроса Not IsPad возвращает все объекты, кроме свободных контактных площадок, но при этом возвращает компоненты, которые могут содержать контактные площадки. Поэтому площадки в составе компонентов попадут в результаты этого запроса. Кроме того, контактные площадки могут входить в состав цепей, которые в редакторе печатных плат также считаются групповыми объектами. Чтобы исключить все контактные площадки, следует использовать выражение запроса Not IsPad And Not IsComponent And Not IsNet.

Операторы сравнения

Оператор Описание Пример
< Оператор «меньше» HoleDiameter < 40
Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter меньше 40
<= Оператор «меньше или равно» HoleDiameter <= 40
Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter меньше или равное 40
>= Оператор «больше или равно» HoleDiameter >= 40
Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter больше или равное 40
> Оператор «больше» HoleDiameter > 40
Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter больше 40
<> Оператор «не равно» HoleDiameter <> 40
Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter, не равное 40
= Оператор «равно» HoleDiameter = 40
Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter, равное 40
Between...And... Оператор диапазона с включенными границами HoleDiameter Between 30 And 50
Чтобы попасть в результаты запроса, объект должен иметь значение Hole Diameter больше или равное 30 и
меньше или равное 50.
Like Оператор Like Name Like 'ADDR?*'
Возвращает объекты, у которых текстовая строка свойства Name начинается с ADDR и
содержит как минимум еще один символ

Подстановочные символы

Подстановочные символы позволяют задавать строки, содержимое которых определено не полностью. Обычно эти символы используются в сочетании с другими символами, в результате чего получаются частично заданные строки. Некоторые ключевые слова в виде исключения допускают строковые параметры, заданные не полностью, однако в большинстве случаев строки могут содержать подстановочные символы только при сравнении с помощью оператора Like.

Оператор Описание Пример
? Может заменять один символ любого типа Footprint Like 'DIP1?'
Возвращает объекты, у которых свойство Footprint имеет значение DIP10, DIP12, DIP14 и т. д.
* Может заменять любое количество символов любого типа Footprint Like 'SIP*'
Возвращает объекты, у которых свойство Footprint имеет значение SIP1, SIP12, SIP216 и т. д. (Также возвращаются все объекты, у которых свойство Footprint имеет значение SIP, поскольку '*' может заменять и no символов.)

Логические строки

Оператор Описание Пример
True Подтверждает условие, заданное ключевым словом IsPad = True
Чтобы попасть в результат, объект должен быть контактной площадкой
False Отрицает условие, заданное ключевым словом IsVia = False
Чтобы попасть в результат, объект не должен быть переходным отверстием

Круглые скобки и приоритет операций

Стоит ознакомиться с приоритетом операторов, используемых в логических выражениях запросов. Без этого выражение может выбирать не те объекты, которые требуются.

Круглые скобки имеют наивысший приоритет в порядке выполнения операций, установленном для различных операторов. Этот порядок определяет, как программа интерпретирует запросы, если пользователь не расставил круглые скобки. Ниже приведен порядок от наивысшего приоритета к наименьшему:

  1. Круглые скобки ()
  2. Not
  3. ^, *, /, Div, Mod, And
  4. +, -, Or, Xor
  5. =, <>, <, >, <=, >=
  6. &&, ||
Этот порядок приоритетов аналогичен используемому в языках типа Pascal. Неоднозначности разрешаются при обработке слева направо. Выражения в круглых скобках вычисляются от внутренних к внешним, а выражения одного уровня — слева направо.
Настоятельно рекомендуется использовать круглые скобки всякий раз, когда существует хотя бы малейшая вероятность неправильной интерпретации запроса. Широкое использование круглых скобок устраняет неоднозначность и облегчает чтение запросов другими пользователями.

Глобальные системные функции запросов

Глобальные системные функции запросов в диалоговом окне Query Helper
Глобальные системные функции запросов в диалоговом окне Query Helper

В этом разделе подробно описаны ключевые слова языка запросов, доступные в документах схем, печатных плат и библиотек в Altium Designer. Чтобы получить справку по определенному ключевому слову запроса, воспользуйтесь приведенными ниже раскрывающимися разделами либо выделите нужное ключевое слово (или щелкните внутри него) в Query Helper, на панели Filter или в поле Query правила проектирования печатной платы и нажмите F1, чтобы сразу перейти к соответствующему разделу.

Подробные сведения о ключевых словах языка запросов, доступных в конкретных редакторах и инструментах Altium Designer, приведены на следующих страницах:

Арифметические функции

Тригонометрические функции

Показательные и логарифмические функции

Агрегатные функции

Системные функции

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Меню
Contents
Доступность функций

Доступные вам функции зависят от того, какое решение Altium вы используете: Altium Develop, Altium Agile Teams, Altium Agile Enterprise или Altium Designer (при активной подписке).

Если вы не видите описанную функцию в используемом вами программном обеспечении, свяжитесь с отделом продаж Altium, чтобы узнать больше.

Устаревшая документация

Документация Altium Designer больше не разделена по версиям ПО. Если вам необходим доступ к документации по старым версиям Altium Designer, посетите раздел Устаревшая документация на странице Прочие установщики.

Contents