Parametri

Le funzioni di query PCB mostrate nella finestra di dialogo ParametersQuery Helper
Questa pagina di riferimento descrive le parole chiave del linguaggio di query della categoria Parameters disponibili nei documenti PCB e libreria PCB. Per assistenza su una specifica parola chiave di query, utilizzare le seguenti sezioni comprimibili oppure evidenziare (o fare clic all'interno di) una determinata parola chiave nel Query Helper o in un pannello Filter, quindi premere F1 per accedere immediatamente alla relativa sezione.
CompParameterValue
Riepilogo
Restituisce il valore stringa di un parametro di un componente PCB, che può essere verificato per restituire i componenti PCB conformi alla query.
Sintassi
CompParameterValue(ParameterName : String) : String
Esempio di utilizzo
CompParameterValue('Mounting Technology') Like 'SM*'
Restituisce tutti i componenti che incorporano il parametro Mounting Technology con un valore stringa che inizia con SM, come SMT, SMD, ecc. Vengono restituiti anche gli oggetti figlio associati di un oggetto componente conforme, come tracce, archi, pad, testo ecc.
CompParameterValue('Mounting Technology') Like '*SM*'
Restituisce tutti i componenti e i relativi oggetti figlio associati in cui il parametro Mounting Technology ha un valore stringa che include *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Restituisce tutti i componenti e i relativi oggetti figlio associati in cui il valore del parametro VoltageRating è maggiore di 50 volt. Il valore stringa restituito da CompParameterValue viene convertito in un numero per il confronto dalla funzione StrToNumber, che riconosce le unità.
FootprintParameterValue
Riepilogo
Restituisce il valore stringa di un parametro Footprint PCB, che può essere verificato per restituire i componenti PCB conformi alla query.
Sintassi
FootprintParameterValue(ParameterName : String) : String
Esempio di utilizzo
FootprintParameterValue('Mounting Type') Like 'SMD'
Restituisce tutti i componenti e i relativi oggetti figlio associati in cui il parametro Footprint Mounting Type ha un valore stringa che include SMD.
HasCompParameter
Riepilogo
Restituisce i componenti PCB che incorporano il nome parametro specificato.
Sintassi
HasCompParameter(ParameterName : String) : Boolean
Esempio di utilizzo
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Restituisce tutti gli oggetti padre del componente che hanno il nome parametro Mounting Technology. Vengono restituiti anche gli oggetti figlio associati di un oggetto componente conforme, come tracce, archi, pad, testo ecc.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Restituisce tutti i componenti e i relativi oggetti figlio associati, except per quegli oggetti padre del componente che hanno il parametro Mounting Technology.
HasCompParameterValue
Riepilogo
Restituisce i componenti PCB che incorporano il nome parametro specificato con un valore conforme alla query.
Sintassi
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Esempio di utilizzo
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Restituisce tutti gli oggetti padre del componente che hanno il nome parametro Mounting Technology con una proprietà valore corrispondente di SMT. Vengono restituiti anche gli oggetti figlio associati di un oggetto componente conforme, come tracce, archi, pad, testo, ecc.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Restituisce tutti i componenti e i relativi oggetti figlio associati che non hanno un parametro Design Item Status con un valore pari a RoHS-Compliant.
HasFootprintParameter
Riepilogo
Restituisce i componenti PCB che incorporano il nome parametro Footprint specificato.
Sintassi
HasFootprintParameter(ParameterName : String) : Boolean
Esempio di utilizzo
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Restituisce tutti gli oggetti padre del componente che hanno il nome parametro Footprint IPC Density . Vengono restituiti anche gli oggetti figlio associati di un oggetto componente conforme, come tracce, archi, pad, testo, ecc.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Restituisce tutti i componenti e i relativi oggetti figlio associati, except per quegli oggetti padre del componente che hanno il parametro Footprint IPC Density .
HasFootprintParameterValue
Riepilogo
Restituisce i componenti PCB che incorporano il nome parametro Footprint specificato con un valore conforme alla query.
Sintassi
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Esempio di utilizzo
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Restituisce tutti gli oggetti padre del componente che hanno il nome parametro Footprint Mounting Method con una proprietà valore corrispondente di Press Fit. Vengono restituiti anche gli oggetti figlio associati di un oggetto componente conforme, come tracce, archi, pad, testo, ecc.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Restituisce tutti i componenti e i relativi oggetti figlio associati che non hanno un parametro Footprint Mounting Method con un valore di Press Fit.
HasParameter
Riepilogo
Restituisce gli oggetti PCB che incorporano il nome parametro specificato.
Sintassi
HasParameter(ParameterName : String) : Boolean
Esempio di utilizzo
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Restituisce tutti gli oggetti che hanno il nome parametro Mounting Technology.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Restituisce tutti gli oggetti except quelli che hanno il parametro Mounting Technology.
HasParameterValue
Riepilogo
Restituisce gli oggetti PCB che incorporano il nome parametro specificato con un valore conforme alla query.
Sintassi
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Esempio di utilizzo
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Restituisce tutti gli oggetti che hanno il nome parametro Mounting Technology e una proprietà valore corrispondente di SMT.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
Restituisce tutti gli oggetti che non hanno un parametro Design Item Status con un valore pari a RoHS-Compliant.
ParameterValue
Riepilogo
Restituisce il valore stringa di un parametro di un oggetto PCB, che può essere verificato per restituire gli oggetti PCB conformi alla query.
Sintassi
ParameterValue(ParameterName : String) : String
Esempio di utilizzo
ParameterValue('Mounting Technology') Like 'SM*'
Restituisce tutti gli oggetti con il parametro Mounting Technology che ha un valore stringa che inizia con SM, come SMT, SMD, ecc.
ParameterValue('Mounting Technology') Like '*SM*'
Restituisce tutti gli oggetti con il parametro Mounting Technology che ha un valore stringa che include SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Restituisce tutti gli oggetti che hanno un valore del parametro VoltageRating maggiore di 50 volt. Il valore stringa restituito da ParameterValue viene convertito in un numero per il confronto dalla funzione StrToNumber, che riconosce le unità.
StrToNumber
Riepilogo
Converte la stringa del valore del parametro indicato in un numero utilizzando il tipo di unità specificato.
Sintassi
StrToNumber(Value : String , Unit : String) : Number
Esempio di utilizzo
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Converte in un numero il valore stringa restituito dal parametro VoltageRating , utilizzando i volt (V) come unità, quindi restituisce tutti gli oggetti con un valore maggiore di 50V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Converte in un numero il valore stringa restituito dal parametro Resistance , utilizzando gli ohm come unità, quindi restituisce tutti gli oggetti con un valore compreso tra 1kΩ e 10kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Converte in un numero il valore stringa restituito dal parametro CapacitanceValue , utilizzando la capacità (F) come unità, quindi restituisce tutti gli oggetti con un valore inferiore a 2nF (2e-9 in notazione scientifica).
Note
Verrà generato un errore di scripting se la stringa del valore non può essere convertita in un numero. Per gestire questa situazione, utilizzare la funzione StrToNumber, che restituisce un numero predefinito specificato se la conversione non riesce.
La funzione di conversione da stringa a numero con riconoscimento delle unità accetta un'ampia gamma di definizioni di tipo di unità, tra cui:
- V – Tensione
- A – Corrente
- Ohm – Resistenza
- Z – Impedenza
- F – Capacità
- H – Induttanza
- G – Conduttanza
- W – Potenza
- Hz – Frequenza
- Q – Carica
- C – Temperatura
- dB – Decibel
- % – Percentuale
- m – Lunghezza
- Kg – Massa
- s – Tempo
Il convertitore accetta i fattori di scala standard dei valori (micro, kilo, mega, ecc.) e, pertanto, stringhe di parametro contenenti abbreviazioni di prefisso come mV, uA, kHz, ecc.
Sono supportate anche diverse forme di rappresentazione dei valori. Ad esempio, lo stesso valore di resistenza può essere rappresentato come:
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Riepilogo
Converte la stringa del valore del parametro indicato in un numero, oppure in un numero predefinito, utilizzando il tipo di unità specificato.
Sintassi
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Esempio di utilizzo
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Converte in un numero il valore stringa restituito dal parametro VoltageRating, utilizzando la tensione (V) come unità, quindi restituisce tutti gli oggetti con un valore maggiore di 50V. Se la stringa del parametro o l'unità non vengono riconosciute (non possono essere convertite), viene restituito un valore predefinito di 10.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Converte in un numero il valore stringa restituito dal parametro VoltageRating, utilizzando la tensione (V) come unità, quindi restituisce tutti gli oggetti con una tensione nominale compresa tra 10V e 50V. Se il valore non può essere letto, viene assunta una tensione di 6V (il valore predefinito definito).
Note
La funzione di conversione da stringa a numero con riconoscimento delle unità accetta un'ampia gamma di definizioni di tipo di unità, tra cui:
- V – Tensione
- A – Corrente
- Ohm – Resistenza
- Z – Impedenza
- F – Capacità
- H – Induttanza
- G – Conduttanza
- W – Potenza
- Hz – Frequenza
- Q – Carica
- C – Temperatura
- dB – Decibel
- % – Percentuale
- m – Lunghezza
- Kg – Massa
- s – Tempo
Il convertitore accetta i fattori di scala standard dei valori (micro, kilo, mega, ecc.) e, pertanto, stringhe di parametro contenenti abbreviazioni di prefisso come mV, uA, kHz, ecc.
Sono supportate anche diverse forme di rappresentazione dei valori. Ad esempio, lo stesso valore di resistenza può essere rappresentato come:
- 2k2
- 2.2k
- 2200
- 2,200