Parâmetros
Num relance
- Saiba quais palavras-chave de consulta de parâmetros se aplicam a componentes, footprints ou objetos de PCB em geral e como cada uma é usada em um filtro ou consulta.
- Veja exemplos de consultas para encontrar objetos pelo nome do parâmetro, buscar correspondências exatas ou parciais de valores e excluir objetos que não atendam a uma condição.
- Entenda como os valores de parâmetros em formato de texto podem ser convertidos em valores numéricos para comparações por faixa usando palavras-chave como 'StrToNumber' e 'StrToNumberDef'.
As funções de consulta de PCB Parameters exibidas na caixa de diálogo Query Helper
Esta página de referência detalha as palavras-chave da linguagem de consulta da categoria Parameters disponível em documentos de PCB e de biblioteca de PCB. Para obter ajuda sobre uma palavra-chave de consulta específica, use as seções recolhíveis a seguir ou selecione (ou clique dentro de) qualquer palavra-chave no Query Helper ou em um painel Filter e pressione F1 para acessar sua seção imediatamente.
CompParameterValue
Resumo
Retorna o valor textual de um parâmetro de componente de PCB, que pode ser testado para retornar componentes de PCB que atendam à consulta.
Sintaxe
CompParameterValue(ParameterName : String) : String
Exemplo de uso
CompParameterValue('Mounting Technology') Like 'SM*'
Retorna todos os componentes que contêm o parâmetro Mounting Technology cujo valor textual começa com SM, como SMT, SMD, etc. Os objetos filhos associados a um objeto de componente que atende à consulta, como trilhas, arcos, pads, textos etc., também são retornados.
CompParameterValue('Mounting Technology') Like '*SM*'
Retorna todos os componentes e seus objetos filhos associados nos quais o parâmetro Mounting Technology tem um valor textual que inclui *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Retorna todos os componentes e seus objetos filhos associados nos quais o valor do parâmetro VoltageRating é maior que 50 volts. O valor textual retornado por CompParameterValue é convertido em um número para a comparação pela função StrToNumber, que reconhece unidades.
FootprintParameterValue
Resumo
Retorna o valor textual de um parâmetro de footprint de PCB, que pode ser testado para retornar componentes de PCB que atendam à consulta.
Sintaxe
FootprintParameterValue(ParameterName : String) : String
Exemplo de uso
FootprintParameterValue('Mounting Type') Like 'SMD'
Retorna todos os componentes e seus objetos filhos associados nos quais o parâmetro de footprint Mounting Type tem um valor textual que inclui SMD.
HasCompParameter
Resumo
Retorna componentes de PCB que contêm o parâmetro com o nome especificado.
Sintaxe
HasCompParameter(ParameterName : String) : Boolean
Exemplo de uso
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Retorna todos os objetos pais de componentes que têm o parâmetro de nome Mounting Technology. Os objetos filhos associados a um objeto de componente que atende à consulta, como trilhas, arcos, pads, textos etc., também são retornados.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Retorna todos os componentes e seus objetos filhos associados, except os objetos pais de componentes que têm o parâmetro Mounting Technology.
HasCompParameterValue
Resumo
Retorna componentes de PCB que contêm o parâmetro com o nome especificado e cujo valor atende à consulta.
Sintaxe
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemplo de uso
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Retorna todos os objetos pais de componentes que têm o parâmetro de nome Mounting Technology com uma propriedade de valor correspondente a SMT. Os objetos filhos associados a um objeto de componente que atende à consulta, como trilhas, arcos, pads, textos etc., também são retornados.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Retorna todos os componentes e seus objetos filhos associados que não têm um parâmetro Design Item Status com o valor RoHS-Compliant.
HasFootprintParameter
Resumo
Retorna componentes de PCB que contêm o parâmetro de footprint com o nome especificado.
Sintaxe
HasFootprintParameter(ParameterName : String) : Boolean
Exemplo de uso
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Retorna todos os objetos pais de componentes que têm o parâmetro de footprint de nome IPC Density. Os objetos filhos associados a um objeto de componente que atende à consulta, como trilhas, arcos, pads, textos etc., também são retornados.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Retorna todos os componentes e seus objetos filhos associados, except os objetos pais de componentes que têm o parâmetro de footprint IPC Density.
HasFootprintParameterValue
Resumo
Retorna componentes de PCB que contêm o parâmetro de footprint com o nome especificado e cujo valor atende à consulta.
Sintaxe
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemplo de uso
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Retorna todos os objetos pais de componentes que têm o parâmetro de footprint de nome Mounting Method com uma propriedade de valor correspondente a Press Fit. . Os objetos filhos associados a um objeto de componente que atende à consulta, como trilhas, arcos, pads, textos, etc., também são retornados.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Retorna todos os componentes e seus objetos filhos associados que não têm um parâmetro de footprint Mounting Method com o valor Press Fit.
HasParameter
Resumo
Retorna objetos de PCB que contêm o parâmetro com o nome especificado.
Sintaxe
HasParameter(ParameterName : String) : Boolean
Exemplo de uso
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Retorna todos os objetos que têm o parâmetro de nome Mounting Technology.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Retorna todos os objetos except aqueles que têm o parâmetro Mounting Technology.
HasParameterValue
Resumo
Retorna objetos de PCB que contêm o parâmetro com o nome especificado e cujo valor atende à consulta.
Sintaxe
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemplo de uso
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Retorna todos os objetos que têm o parâmetro de nome Mounting Technology e uma propriedade de valor correspondente a SMT.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
Retorna todos os objetos que não têm um parâmetro Design Item Status com o valor RoHS-Compliant.
ParameterValue
Resumo
Retorna o valor textual de um parâmetro de objeto de PCB, que pode ser testado para retornar objetos de PCB que atendam à consulta.
Sintaxe
ParameterValue(ParameterName : String) : String
Exemplo de uso
ParameterValue('Mounting Technology') Like 'SM*'
Retorna todos os objetos com o parâmetro Mounting Technology cujo valor textual começa com SM, como SMT, SMD etc.
ParameterValue('Mounting Technology') Like '*SM*'
Retorna todos os objetos com o parâmetro Mounting Technology cujo valor textual inclui SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Retorna todos os objetos cujo valor do parâmetro VoltageRating é maior que 50 volts. O valor textual retornado por ParameterValue é convertido em um número para a comparação pela função StrToNumber, que reconhece unidades.
StrToNumber
Resumo
Converte o valor textual do parâmetro indicado em um número usando o tipo de unidade estipulado.
Sintaxe
StrToNumber(Value : String , Unit : String) : Number
Exemplo de uso
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Converte o valor textual retornado pelo parâmetro VoltageRating em um número, usando volts (V) como unidade, e então retorna todos os objetos com um valor maior que 50 V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Converte o valor textual retornado pelo parâmetro Resistance em um número, usando ohms como unidade, e então retorna todos os objetos com um valor entre 1 kΩ e 10 kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Converte o valor textual retornado pelo parâmetro CapacitanceValue em um número, usando a unidade de capacitância (F), e então retorna todos os objetos com um valor menor que 2 nF (2e-9 em notação científica).
Notas
Um erro de script será gerado se o valor textual não puder ser convertido em um número. Para lidar com essa situação, use a função StrToNumber, que retorna um número padrão indicado se a conversão falhar.
A função de conversão de string em número com reconhecimento de unidades aceita uma ampla variedade de definições de tipos de unidade, incluindo:
- V – Tensão
- A – Corrente
- Ohm – Resistência
- Z – Impedância
- F – Capacitância
- H – Indutância
- G – Condutância
- W – Potência
- Hz – Frequência
- Q – Carga
- C – Temperatura
- dB – Decibéis
- % – Porcentagem
- m – Comprimento
- Kg – Massa
- s – Tempo
O conversor aceita fatores de escala padrão (micro, quilo, mega etc.) e, portanto, strings de parâmetros que contêm abreviações de prefixos, como mV, uA, kHz, etc.
Também são aceitos vários formatos de valores. Por exemplo, o mesmo valor de resistência pode ser representado como:
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Resumo
Converte a string de valor do parâmetro especificado em um número, ou em um número padrão, usando o tipo de unidade estipulado.
Sintaxe
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Exemplo de uso
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Converte a string de valor retornada pelo parâmetro VoltageRating em um número, usando tensão (V) como unidade, e retorna todos os objetos com um valor superior a 50V. Se a string do parâmetro ou a unidade não for reconhecida (não puder ser convertida), será retornado o valor padrão 10.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Converte a string de valor retornada pelo parâmetro VoltageRating em um número, usando tensão (V) como unidade, e retorna todos os objetos com um valor nominal entre 10V e 50V. Se o valor não puder ser lido, será assumida uma tensão de 6V (o valor padrão definido).
Notas
A função de conversão de string em número com reconhecimento de unidades aceita uma ampla variedade de definições de tipos de unidade, incluindo:
- V – Tensão
- A – Corrente
- Ohm – Resistência
- Z – Impedância
- F – Capacitância
- H – Indutância
- G – Condutância
- W – Potência
- Hz – Frequência
- Q – Carga
- C – Temperatura
- dB – Decibéis
- % – Porcentagem
- m – Comprimento
- Kg – Massa
- s – Tempo
O conversor aceita fatores de escala padrão (micro, quilo, mega etc.) e, portanto, strings de parâmetros que contêm abreviações de prefixos, como mV, uA, kHz, etc.
Também são aceitos vários formatos de valores. Por exemplo, o mesmo valor de resistência pode ser representado como:
- 2k2
- 2.2k
- 2200
- 2,200
Localizado por IA