Parámetros
De un vistazo
- Aprende qué palabras clave de consulta de parámetros se aplican a componentes, huellas u objetos de PCB en general, y cómo se utiliza cada una en un filtro o una consulta.
- Consulta ejemplos de consultas para buscar objetos por el nombre de un parámetro, encontrar coincidencias exactas o parciales de valores y excluir objetos que no cumplan una condición.
- Comprende cómo convertir los valores de parámetros expresados como cadenas en valores numéricos para realizar comparaciones por rangos mediante palabras clave como 'StrToNumber' y 'StrToNumberDef'.

Las funciones de consulta de PCB de Parameters que se muestran en el cuadro de diálogo Query Helper
Esta página de referencia detalla las palabras clave del lenguaje de consulta de la categoría Parameters disponibles en los documentos de PCB y de bibliotecas de PCB. Para obtener ayuda sobre una palabra clave de consulta específica, utilice las siguientes secciones desplegables o seleccione una palabra clave (o haga clic dentro de ella) en Query Helper o en un panel Filter y, a continuación, pulse F1 para acceder inmediatamente a su sección.
CompParameterValue
Resumen
Devuelve el valor de cadena de un parámetro de componente de PCB, que se puede evaluar para obtener los componentes de PCB que cumplen la consulta.
Sintaxis
CompParameterValue(ParameterName : String) : String
Ejemplo de uso
CompParameterValue('Mounting Technology') Like 'SM*'
Devuelve todos los componentes que incorporan el parámetro Mounting Technology cuyo valor de cadena comienza por SM, como SMT, SMD, etc. También se devuelven los objetos secundarios asociados a un objeto de componente que cumple la consulta, como pistas, arcos, pads, texto, etc.
CompParameterValue('Mounting Technology') Like '*SM*'
Devuelve todos los componentes y sus objetos secundarios asociados en los que el parámetro Mounting Technology tiene un valor de cadena que incluye *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Devuelve todos los componentes y sus objetos secundarios asociados en los que el valor del parámetro VoltageRating es superior a 50 voltios. El valor de cadena devuelto por CompParameterValue se convierte en un número para la comparación mediante la función StrToNumber, que reconoce las unidades.
FootprintParameterValue
Resumen
Devuelve el valor de cadena de un parámetro de huella de PCB, que se puede evaluar para obtener los componentes de PCB que cumplen la consulta.
Sintaxis
FootprintParameterValue(ParameterName : String) : String
Ejemplo de uso
FootprintParameterValue('Mounting Type') Like 'SMD'
Devuelve todos los componentes y sus objetos secundarios asociados en los que el parámetro de huella Mounting Type tiene un valor de cadena que incluye SMD.
HasCompParameter
Resumen
Devuelve los componentes de PCB que incorporan el nombre de parámetro especificado.
Sintaxis
HasCompParameter(ParameterName : String) : Boolean
Ejemplo de uso
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Devuelve todos los objetos principales de componente que tienen el nombre de parámetro Mounting Technology. También se devuelven los objetos secundarios asociados a un objeto de componente que cumple la consulta, como pistas, arcos, pads, texto, etc.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Devuelve todos los componentes y sus objetos secundarios asociados, except aquellos objetos principales de componente que tienen el parámetro Mounting Technology.
HasCompParameterValue
Resumen
Devuelve los componentes de PCB que incorporan el nombre de parámetro especificado con un valor que cumple la consulta.
Sintaxis
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Ejemplo de uso
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Devuelve todos los objetos principales de componente que tienen el nombre de parámetro Mounting Technology con una propiedad de valor que coincide con SMT. También se devuelven los objetos secundarios asociados a un objeto de componente que cumple la consulta, como pistas, arcos, pads, texto, etc.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Devuelve todos los componentes y sus objetos secundarios asociados que no tienen un parámetro Design Item Status con un valor de RoHS-Compliant.
HasFootprintParameter
Resumen
Devuelve los componentes de PCB que incorporan el nombre de parámetro de huella especificado.
Sintaxis
HasFootprintParameter(ParameterName : String) : Boolean
Ejemplo de uso
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Devuelve todos los objetos principales de componente que tienen el nombre de parámetro de huella IPC Density. También se devuelven los objetos secundarios asociados a un objeto de componente que cumple la consulta, como pistas, arcos, pads, texto, etc.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Devuelve todos los componentes y sus objetos secundarios asociados, except aquellos objetos principales de componente que tienen el parámetro de huella IPC Density.
HasFootprintParameterValue
Resumen
Devuelve los componentes de PCB que incorporan el nombre de parámetro de huella especificado con un valor que cumple la consulta.
Sintaxis
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Ejemplo de uso
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Devuelve todos los objetos principales de componente que tienen el nombre de parámetro de huella Mounting Method con una propiedad de valor que coincide con Press Fit. . También se devuelven los objetos secundarios asociados a un objeto de componente que cumple la consulta, como pistas, arcos, pads, texto, etc.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Devuelve todos los componentes y sus objetos secundarios asociados que no tienen un parámetro de huella Mounting Method con un valor de Press Fit.
HasParameter
Resumen
Devuelve los objetos de PCB que incorporan el nombre de parámetro especificado.
Sintaxis
HasParameter(ParameterName : String) : Boolean
Ejemplo de uso
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Devuelve todos los objetos que tienen el nombre de parámetro Mounting Technology.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Devuelve todos los objetos except aquellos que tienen el parámetro Mounting Technology.
HasParameterValue
Resumen
Devuelve los objetos de PCB que incorporan el nombre de parámetro especificado con un valor que cumple la consulta.
Sintaxis
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Ejemplo de uso
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Devuelve todos los objetos que tienen el nombre de parámetro Mounting Technology y una propiedad de valor que coincide con SMT.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
Devuelve todos los objetos que no tienen un parámetro Design Item Status con un valor de RoHS-Compliant.
ParameterValue
Resumen
Devuelve el valor de cadena de un parámetro de objeto de PCB, que se puede evaluar para obtener los objetos de PCB que cumplen la consulta.
Sintaxis
ParameterValue(ParameterName : String) : String
Ejemplo de uso
ParameterValue('Mounting Technology') Like 'SM*'
Devuelve todos los objetos con el parámetro Mounting Technology cuyo valor de cadena comienza por SM, como SMT, SMD, etc.
ParameterValue('Mounting Technology') Like '*SM*'
Devuelve todos los objetos con el parámetro Mounting Technology cuyo valor de cadena incluye SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Devuelve todos los objetos que tienen un valor del parámetro VoltageRating superior a 50 voltios. El valor de cadena devuelto por ParameterValue se convierte en un número para la comparación mediante la función StrToNumber, que reconoce las unidades.
StrToNumber
Resumen
Convierte la cadena de valor del parámetro indicado en un número utilizando el tipo de unidad especificado.
Sintaxis
StrToNumber(Value : String , Unit : String) : Number
Ejemplo de uso
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Convierte la cadena de valor devuelta por el parámetro VoltageRating en un número, utilizando voltios (V) como unidad, y luego devuelve todos los objetos con un valor superior a 50 V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Convierte la cadena de valor devuelta por el parámetro Resistance en un número, utilizando ohmios como unidad, y luego devuelve todos los objetos con un valor entre 1 kΩ y 10 kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Convierte la cadena de valor devuelta por el parámetro CapacitanceValue en un número, utilizando la capacitancia (F) como unidad, y luego devuelve todos los objetos con un valor inferior a 2 nF (2e-9 en notación científica).
Notas
Se producirá un error de script si la cadena de valor no se puede convertir en un número. Para contemplar esta situación, utilice la función StrToNumber, que devuelve un número predeterminado especificado si falla la conversión.
La función de conversión de cadenas a números que tiene en cuenta las unidades acepta una amplia variedad de definiciones de tipos de unidad, entre ellas:
- V – Tensión
- A – Corriente
- Ohm – Resistencia
- Z – Impedancia
- F – Capacitancia
- H – Inductancia
- G – Conductancia
- W – Potencia
- Hz – Frecuencia
- Q – Carga
- C – Temperatura
- dB – Decibelios
- % – Porcentaje
- m – Longitud
- Kg – Masa
- s – Tiempo
El convertidor acepta factores de escala estándar (micro, kilo, mega, etc.) y, por lo tanto, cadenas de parámetros que contienen abreviaturas de prefijos como mV, uA, kHz,, etc.
También se admiten varios formatos de valor. Por ejemplo, un mismo valor de resistencia puede representarse como:
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Resumen
Convierte la cadena de valor del parámetro especificado en un número, o en un número predeterminado, utilizando el tipo de unidad indicado.
Sintaxis
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Ejemplos de uso
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Convierte la cadena de valor devuelta por el parámetro VoltageRating en un número, utilizando la tensión (V) como unidad, y luego devuelve todos los objetos con un valor superior a 50V. Si no se reconoce la cadena del parámetro o la unidad (no se puede convertir), se devuelve un valor predeterminado de 10.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Convierte la cadena de valor devuelta por el parámetro VoltageRating en un número, utilizando la tensión (V) como unidad, y luego devuelve todos los objetos con un valor nominal entre 10V y 50V. Si no se puede leer el valor, se supone una tensión de 6V (el valor predeterminado definido).
Notas
La función de conversión de cadenas a números que tiene en cuenta las unidades acepta una amplia variedad de definiciones de tipos de unidad, entre ellas:
- V – Tensión
- A – Corriente
- Ohm – Resistencia
- Z – Impedancia
- F – Capacitancia
- H – Inductancia
- G – Conductancia
- W – Potencia
- Hz – Frecuencia
- Q – Carga
- C – Temperatura
- dB – Decibelios
- % – Porcentaje
- m – Longitud
- Kg – Masa
- s – Tiempo
El convertidor acepta factores de escala estándar (micro, kilo, mega, etc.) y, por lo tanto, cadenas de parámetros que contienen abreviaturas de prefijos como mV, uA, kHz,, etc.
También se admiten varios formatos de valor. Por ejemplo, un mismo valor de resistencia puede representarse como:
- 2k2
- 2.2k
- 2200
- 2,200