Параметры
Краткий обзор
- Узнайте, какие ключевые слова запросов для работы с параметрами применимы к компонентам, посадочным местам или любым объектам печатной платы и как использовать каждое из них в фильтре или запросе.
- Ознакомьтесь с примерами запросов для поиска объектов по имени параметра, точному или частичному совпадению значений, а также для исключения объектов, не соответствующих условию.
- Разберитесь, как преобразовывать строковые значения параметров в числовые для сравнения с заданными диапазонами с помощью таких ключевых слов, как 'StrToNumber' и 'StrToNumberDef'.

Функции запросов PCB Parameters, показанные в диалоговом окне Query Helper
На этой справочной странице подробно описаны ключевые слова языка запросов из категории Parameters , доступные в документах печатных плат и библиотек посадочных мест. Чтобы получить справку по конкретному ключевому слову запроса, воспользуйтесь следующими раскрывающимися разделами либо выделите нужное ключевое слово (или установите внутри него курсор) в Query Helper или на панели Filter, затем нажмите F1, чтобы сразу перейти к соответствующему разделу.
CompParameterValue
Краткое описание
Возвращает строковое значение параметра компонента печатной платы, которое можно проверить для отбора компонентов, соответствующих запросу.
Синтаксис
CompParameterValue(ParameterName : String) : String
Примеры использования
CompParameterValue('Mounting Technology') Like 'SM*'
Возвращает все компоненты, содержащие параметр Mounting Technology, строковое значение которого начинается с SM, например SMT, SMD и т. д. Также возвращаются связанные дочерние объекты подходящего компонента: дорожки, дуги, контактные площадки, текст и т. д.
CompParameterValue('Mounting Technology') Like '*SM*'
Возвращает все компоненты и связанные с ними дочерние объекты, у которых строковое значение параметра Mounting Technology содержит *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Возвращает все компоненты и связанные с ними дочерние объекты, у которых значение параметра VoltageRating превышает 50 вольт. Строковое значение, возвращаемое CompParameterValue, преобразуется в число для сравнения с помощью функции StrToNumber, учитывающей единицы измерения.
FootprintParameterValue
Краткое описание
Возвращает строковое значение параметра посадочного места печатной платы, которое можно проверить для отбора компонентов, соответствующих запросу.
Синтаксис
FootprintParameterValue(ParameterName : String) : String
Примеры использования
FootprintParameterValue('Mounting Type') Like 'SMD'
Возвращает все компоненты и связанные с ними дочерние объекты, у которых строковое значение параметра посадочного места Mounting Type содержит SMD.
HasCompParameter
Краткое описание
Возвращает компоненты печатной платы, содержащие параметр с указанным именем.
Синтаксис
HasCompParameter(ParameterName : String) : Boolean
Примеры использования
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Возвращает все родительские объекты компонентов, содержащие параметр с именем Mounting Technology. Также возвращаются связанные дочерние объекты подходящего компонента: дорожки, дуги, контактные площадки, текст и т. д.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Возвращает все компоненты и связанные с ними дочерние объекты, except тех родительских объектов компонентов, которые содержат параметр Mounting Technology.
HasCompParameterValue
Краткое описание
Возвращает компоненты печатной платы, содержащие параметр с указанным именем и значением, соответствующим запросу.
Синтаксис
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Примеры использования
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Возвращает все родительские объекты компонентов, содержащие параметр с именем Mounting Technology и значением SMT. Также возвращаются связанные дочерние объекты подходящего компонента: дорожки, дуги, контактные площадки, текст и т. д.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Возвращает все компоненты и связанные с ними дочерние объекты, у которых нет параметра Design Item Status со значением RoHS-Compliant.
HasFootprintParameter
Краткое описание
Возвращает компоненты печатной платы, содержащие параметр посадочного места с указанным именем.
Синтаксис
HasFootprintParameter(ParameterName : String) : Boolean
Примеры использования
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Возвращает все родительские объекты компонентов, содержащие параметр посадочного места с именем IPC Density . Также возвращаются связанные дочерние объекты подходящего компонента: дорожки, дуги, контактные площадки, текст и т. д.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Возвращает все компоненты и связанные с ними дочерние объекты, except тех родительских объектов компонентов, которые содержат параметр посадочного места IPC Density .
HasFootprintParameterValue
Краткое описание
Возвращает компоненты печатной платы, содержащие параметр посадочного места с указанным именем и значением, соответствующим запросу.
Синтаксис
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Примеры использования
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Возвращает все родительские объекты компонентов, содержащие параметр посадочного места с именем Mounting Method и значением Press Fit. . Также возвращаются связанные дочерние объекты подходящего компонента: дорожки, дуги, контактные площадки, текст и т. д.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Возвращает все компоненты и связанные с ними дочерние объекты, у которых нет параметра посадочного места Mounting Method со значением Press Fit.
HasParameter
Краткое описание
Возвращает объекты печатной платы, содержащие параметр с указанным именем.
Синтаксис
HasParameter(ParameterName : String) : Boolean
Примеры использования
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Возвращает все объекты, содержащие параметр с именем Mounting Technology.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Возвращает все объекты except тех, которые содержат параметр Mounting Technology.
HasParameterValue
Краткое описание
Возвращает объекты печатной платы, содержащие параметр с указанным именем и значением, соответствующим запросу.
Синтаксис
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Примеры использования
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Возвращает все объекты, содержащие параметр с именем Mounting Technology и значением SMT.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
Возвращает все объекты, у которых нет параметра Design Item Status со значением RoHS-Compliant.
ParameterValue
Краткое описание
Возвращает строковое значение параметра объекта печатной платы, которое можно проверить для отбора объектов, соответствующих запросу.
Синтаксис
ParameterValue(ParameterName : String) : String
Примеры использования
ParameterValue('Mounting Technology') Like 'SM*'
Возвращает все объекты с параметром Mounting Technology, строковое значение которого начинается с SM, например SMT, SMD и т. д.
ParameterValue('Mounting Technology') Like '*SM*'
Возвращает все объекты с параметром Mounting Technology, строковое значение которого содержит SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Возвращает все объекты, у которых значение параметра VoltageRating превышает 50 вольт. Строковое значение, возвращаемое ParameterValue, преобразуется в число для сравнения с помощью функции StrToNumber, учитывающей единицы измерения.
StrToNumber
Краткое описание
Преобразует указанное строковое значение параметра в число с использованием заданного типа единиц измерения.
Синтаксис
StrToNumber(Value : String , Unit : String) : Number
Примеры использования
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Преобразует строковое значение, возвращаемое параметром VoltageRating , в число, используя вольты (В) в качестве единицы измерения, затем возвращает все объекты со значением более 50 В.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Преобразует строковое значение, возвращаемое параметром Resistance , в число, используя омы в качестве единицы измерения, затем возвращает все объекты со значением от 1 кОм до 10 кОм.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Преобразует строковое значение, возвращаемое параметром CapacitanceValue , в число, используя единицу измерения ёмкости — фарад (Ф), затем возвращает все объекты со значением менее 2 нФ (2e-9 в экспоненциальной записи).
Примечания
Если строковое значение невозможно преобразовать в число, возникнет ошибка скрипта. Чтобы учесть такую ситуацию, используйте функцию StrToNumber, которая при неудачном преобразовании возвращает заданное число по умолчанию.
Функция преобразования строки в число с учетом единиц измерения поддерживает широкий набор типов единиц измерения, включая:
- V – Напряжение
- A – Ток
- Ohm – Сопротивление
- Z – Импеданс
- F – Емкость
- H – Индуктивность
- G – Проводимость
- W – Мощность
- Hz – Частота
- Q – Заряд
- C – Температура
- dB – Децибелы
- % – Проценты
- m – Длина
- Kg – Масса
- s – Время
Преобразователь поддерживает стандартные множители единиц измерения (микро, кило, мега и т. д.) и, соответственно, строки параметров, содержащие сокращенные обозначения приставок, такие как mV, uA, kHz, и т. д.
Также поддерживаются различные форматы записи значений. Например, одно и то же значение сопротивления можно представить следующим образом:
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Краткое описание
Преобразует строку значения указанного параметра в число с учетом заданного типа единиц измерения или возвращает число по умолчанию.
Синтаксис
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Примеры использования
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Преобразует строку значения, возвращаемую параметром VoltageRating, в число, используя в качестве единицы измерения вольты (В), затем возвращает все объекты со значением более 50 В. Если строка параметра или единица измерения не распознана (преобразование невозможно), возвращается значение по умолчанию 10.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Преобразует строку значения, возвращаемую параметром VoltageRating, в число, используя в качестве единицы измерения вольты (В), затем возвращает все объекты с номинальным значением от 10 В до 50 В. Если значение не удается прочитать, принимается напряжение 6 В (заданное значение по умолчанию).
Примечания
Функция преобразования строки в число с учетом единиц измерения поддерживает широкий набор типов единиц измерения, включая:
- V – Напряжение
- A – Ток
- Ohm – Сопротивление
- Z – Импеданс
- F – Емкость
- H – Индуктивность
- G – Проводимость
- W – Мощность
- Hz – Частота
- Q – Заряд
- C – Температура
- dB – Децибелы
- % – Проценты
- m – Длина
- Kg – Масса
- s – Время
Преобразователь поддерживает стандартные множители единиц измерения (микро, кило, мега и т. д.) и, соответственно, строки параметров, содержащие сокращенные обозначения приставок, такие как mV, uA, kHz, и т. д.
Также поддерживаются различные форматы записи значений. Например, одно и то же значение сопротивления можно представить следующим образом:
- 2k2
- 2.2k
- 2200
- 2,200