Parametri
A colpo d'occhio
- Scopri quali parole chiave delle query sui parametri si applicano a componenti, footprint o oggetti PCB in generale e come utilizzare ciascuna di esse in un filtro o in una query.
- Consulta esempi di query per trovare oggetti in base al nome del parametro, cercare corrispondenze esatte o parziali dei valori ed escludere gli oggetti che non soddisfano una condizione.
- Scopri come convertire i valori dei parametri espressi come stringhe in valori numerici per eseguire confronti basati su intervalli, utilizzando parole chiave come 'StrToNumber' e 'StrToNumberDef'.
Le funzioni di query PCB Parameters mostrate nella finestra di dialogo Query Helper
Questa pagina di riferimento descrive in dettaglio le parole chiave del linguaggio di query della categoria Parameters disponibili nei documenti PCB e nelle librerie PCB. Per informazioni su una parola chiave specifica, utilizza le seguenti sezioni espandibili oppure evidenzia una parola chiave (o fai clic al suo interno) nel Query Helper o in un pannello Filter, quindi premi 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 che soddisfano la query.
Sintassi
CompParameterValue(ParameterName : String) : String
Esempi di utilizzo
CompParameterValue('Mounting Technology') Like 'SM*'
Restituisce tutti i componenti che includono il parametro Mounting Technology con un valore stringa che inizia con SM, come SMT, SMD, ecc. Vengono restituiti anche gli oggetti figli associati a un componente che soddisfa la query, come piste, archi, pad, testi, ecc.
CompParameterValue('Mounting Technology') Like '*SM*'
Restituisce tutti i componenti e i relativi oggetti figli per i quali il parametro Mounting Technology ha un valore stringa che include *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Restituisce tutti i componenti e i relativi oggetti figli per i quali 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 tiene conto delle unità di misura.
FootprintParameterValue
Riepilogo
Restituisce il valore stringa di un parametro del footprint PCB, che può essere verificato per restituire i componenti PCB che soddisfano la query.
Sintassi
FootprintParameterValue(ParameterName : String) : String
Esempi di utilizzo
FootprintParameterValue('Mounting Type') Like 'SMD'
Restituisce tutti i componenti e i relativi oggetti figli per i quali il parametro del footprint Mounting Type ha un valore stringa che include SMD.
HasCompParameter
Riepilogo
Restituisce i componenti PCB che includono un parametro con il nome specificato.
Sintassi
HasCompParameter(ParameterName : String) : Boolean
Esempi di utilizzo
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Restituisce tutti gli oggetti padre dei componenti che hanno un parametro denominato Mounting Technology. Vengono restituiti anche gli oggetti figli associati a un componente che soddisfa la query, come piste, archi, pad, testi, ecc.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Restituisce tutti i componenti e i relativi oggetti figli, except per gli oggetti padre dei componenti che hanno il parametro Mounting Technology.
HasCompParameterValue
Riepilogo
Restituisce i componenti PCB che includono un parametro con il nome specificato e un valore che soddisfa la query.
Sintassi
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Esempi di utilizzo
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Restituisce tutti gli oggetti padre dei componenti che hanno un parametro denominato Mounting Technology con una proprietà valore corrispondente a SMT. Vengono restituiti anche gli oggetti figli associati a un componente che soddisfa la query, come piste, archi, pad, testi, ecc.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Restituisce tutti i componenti e i relativi oggetti figli che non hanno un parametro Design Item Status con valore RoHS-Compliant.
HasFootprintParameter
Riepilogo
Restituisce i componenti PCB che includono un parametro del footprint con il nome specificato.
Sintassi
HasFootprintParameter(ParameterName : String) : Boolean
Esempi di utilizzo
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Restituisce tutti gli oggetti padre dei componenti che hanno un parametro del footprint denominato IPC Density. Vengono restituiti anche gli oggetti figli associati a un componente che soddisfa la query, come piste, archi, pad, testi, ecc.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Restituisce tutti i componenti e i relativi oggetti figli, except per gli oggetti padre dei componenti che hanno il parametro del footprint IPC Density.
HasFootprintParameterValue
Riepilogo
Restituisce i componenti PCB che includono un parametro del footprint con il nome specificato e un valore che soddisfa la query.
Sintassi
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Esempi di utilizzo
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Restituisce tutti gli oggetti padre dei componenti che hanno un parametro del footprint denominato Mounting Method con una proprietà valore corrispondente a Press Fit. Vengono restituiti anche gli oggetti figli associati a un componente che soddisfa la query, come piste, archi, pad, testi, ecc.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Restituisce tutti i componenti e i relativi oggetti figli che non hanno un parametro del footprint Mounting Method con valore Press Fit.
HasParameter
Riepilogo
Restituisce gli oggetti PCB che includono un parametro con il nome specificato.
Sintassi
HasParameter(ParameterName : String) : Boolean
Esempi di utilizzo
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Restituisce tutti gli oggetti che hanno un parametro denominato 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 includono un parametro con il nome specificato e un valore che soddisfa la query.
Sintassi
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Esempi di utilizzo
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Restituisce tutti gli oggetti che hanno un parametro denominato Mounting Technology e una proprietà valore corrispondente a 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 valore RoHS-Compliant.
ParameterValue
Riepilogo
Restituisce il valore stringa di un parametro di un oggetto PCB, che può essere verificato per restituire gli oggetti PCB che soddisfano la query.
Sintassi
ParameterValue(ParameterName : String) : String
Esempi di utilizzo
ParameterValue('Mounting Technology') Like 'SM*'
Restituisce tutti gli oggetti con il parametro Mounting Technology il cui valore stringa inizia con SM, come SMT, SMD, ecc.
ParameterValue('Mounting Technology') Like '*SM*'
Restituisce tutti gli oggetti con il parametro Mounting Technology il cui valore stringa include SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Restituisce tutti gli oggetti con 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 tiene conto delle unità di misura.
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
Esempi di utilizzo
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Converte la stringa del valore restituita dal parametro VoltageRating in un numero, utilizzando i volt (V) come unità di misura, quindi restituisce tutti gli oggetti con un valore maggiore di 50 V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Converte la stringa del valore restituita dal parametro Resistance in un numero, utilizzando gli ohm come unità di misura, quindi restituisce tutti gli oggetti con un valore compreso tra 1 kΩ e 10 kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Converte la stringa del valore restituita dal parametro CapacitanceValue in un numero, utilizzando l'unità di misura della capacità (F), quindi restituisce tutti gli oggetti con un valore inferiore a 2 nF (2e-9 in notazione scientifica).
Note
Se la stringa del valore non può essere convertita in un numero, viene generato un errore di scripting. Per gestire questa situazione, utilizza 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 del 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 (micro, chilo, mega, ecc.) e, pertanto, le stringhe dei parametri contenenti abbreviazioni dei prefissi come mV, uA, kHz,, ecc.
Sono supportati anche diversi formati 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, o in un numero predefinito, utilizzando il tipo di unità specificato.
Sintassi
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Esempi di utilizzo
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Converte la stringa del valore restituita dal parametro VoltageRating in un numero, utilizzando la tensione (V) come unità, quindi restituisce tutti gli oggetti con un valore superiore a 50 V. Se la stringa del parametro o l'unità non viene riconosciuta (e non può quindi essere convertita), viene restituito il valore predefinito 10.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Converte la stringa del valore restituita dal parametro VoltageRating in un numero, utilizzando la tensione (V) come unità, quindi restituisce tutti gli oggetti con un valore nominale compreso tra 10 V e 50 V. Se il valore non può essere letto, viene assunta una tensione di 6 V (il valore predefinito specificato).
Note
La funzione di conversione da stringa a numero con riconoscimento delle unità accetta un'ampia gamma di definizioni del 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 (micro, chilo, mega, ecc.) e, pertanto, le stringhe dei parametri contenenti abbreviazioni dei prefissi come mV, uA, kHz,, ecc.
Sono supportati anche diversi formati dei valori. Ad esempio, lo stesso valore di resistenza può essere rappresentato come:
- 2k2
- 2.2k
- 2200
- 2,200
Localizzato tramite A