Параметры

Функции запросов PCB, показанные в диалоговом окне ParametersQuery Helper
На этой справочной странице подробно описаны ключевые слова языка запросов из категории Parameters , доступные в документах PCB и библиотек PCB. Чтобы получить справку по конкретному ключевому слову запроса, используйте следующие сворачиваемые разделы или выделите (или щёлкните внутри) нужное ключевое слово в панели Query Helper или Filter, затем нажмите F1, чтобы сразу перейти к соответствующему разделу.
CompParameterValue
Сводка
Возвращает строковое значение параметра компонента PCB, которое можно проверять, чтобы находить компоненты PCB, удовлетворяющие запросу.
Синтаксис
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
Сводка
Возвращает строковое значение параметра посадочного места (Footprint) PCB, которое можно проверять, чтобы находить компоненты PCB, удовлетворяющие запросу.
Синтаксис
FootprintParameterValue(ParameterName : String) : String
Примеры использования
FootprintParameterValue('Mounting Type') Like 'SMD'
Возвращает все компоненты и связанные с ними дочерние объекты, у которых параметр посадочного места Mounting Type имеет строковое значение, содержащее SMD.
HasCompParameter
Сводка
Возвращает компоненты PCB, содержащие параметр с указанным именем.
Синтаксис
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
Сводка
Возвращает компоненты PCB, содержащие параметр с указанным именем, значение которого удовлетворяет запросу.
Синтаксис
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
Сводка
Возвращает компоненты PCB, содержащие параметр посадочного места (Footprint) с указанным именем.
Синтаксис
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
Сводка
Возвращает компоненты PCB, содержащие параметр посадочного места (Footprint) с указанным именем, значение которого удовлетворяет запросу.
Синтаксис
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
Сводка
Возвращает объекты PCB, содержащие параметр с указанным именем.
Синтаксис
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
Сводка
Возвращает объекты PCB, содержащие параметр с указанным именем, значение которого удовлетворяет запросу.
Синтаксис
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
Сводка
Возвращает строковое значение параметра объекта PCB, которое можно проверять, чтобы находить объекты PCB, удовлетворяющие запросу.
Синтаксис
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 , в число, используя вольты (V) как единицу измерения, затем возвращает все объекты со значением больше 50V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Преобразует строку значения, возвращаемую параметром Resistance , в число, используя омы как единицу измерения, затем возвращает все объекты со значением в диапазоне от 1kΩ до 10kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Преобразует строку значения, возвращаемую параметром CapacitanceValue , в число, используя ёмкость (F) как единицу измерения, затем возвращает все объекты со значением меньше 2nF (2e-9 в научной нотации).
Примечания
Если строку значения невозможно преобразовать в число, будет выдана ошибка скрипта. Чтобы учесть такую ситуацию, используйте функцию StrToNumber, которая возвращает заданное число по умолчанию, если преобразование не удалось.
Функция преобразования строки в число с учётом единиц измерения принимает широкий набор определений типов единиц, включая:
- V – Напряжение
- A – Ток
- Ohm – Сопротивление
- Z – Импеданс
- F – Ёмкость
- H – Индуктивность
- G – Проводимость
- W – Мощность
- Hz – Частота
- Q – Заряд
- C – Температура
- dB – Децибелы
- % – Проценты
- m – Длина
- Kg – Масса
- s – Время
Преобразователь принимает стандартные коэффициенты масштабирования (micro, kilo, mega и т. п.) и, следовательно, строки параметров, содержащие сокращения префиксов, такие как 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, в число, используя напряжение (V) как единицу измерения, затем возвращает все объекты со значением больше 50V. Если строка параметра или единица измерения не распознаны (преобразование невозможно), возвращается значение по умолчанию 10.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Преобразует строку значения, возвращаемую параметром VoltageRating, в число, используя напряжение (V) как единицу измерения, затем возвращает все объекты с номиналом в диапазоне от 10V до 50V. Если значение невозможно прочитать, предполагается напряжение 6V (заданное значение по умолчанию).
Примечания
Функция преобразования строки в число с учётом единиц измерения принимает широкий набор определений типов единиц, включая:
- V – Напряжение
- A – Ток
- Ohm – Сопротивление
- Z – Импеданс
- F – Ёмкость
- H – Индуктивность
- G – Проводимость
- W – Мощность
- Hz – Частота
- Q – Заряд
- C – Температура
- dB – Децибелы
- % – Проценты
- m – Длина
- Kg – Масса
- s – Время
Преобразователь принимает стандартные коэффициенты масштабирования (micro, kilo, mega и т. п.) и, следовательно, строки параметров, содержащие сокращения префиксов, такие как mV, uA, kHz, и т. д.
Также поддерживаются несколько форматов записи значений. Например, одно и то же значение сопротивления может быть представлено как:
- 2k2
- 2.2k
- 2200
- 2,200