Parameter
Auf einen Blick
- Erfahren Sie, welche Schlüsselwörter für Parameterabfragen auf Bauteile, Footprints oder allgemeine PCB-Objekte anwendbar sind und wie Sie diese in einem Filter oder einer Abfrage verwenden.
- Entdecken Sie Beispielabfragen, mit denen Sie Objekte anhand von Parameternamen finden, Werte vollständig oder teilweise abgleichen und Objekte ausschließen, die eine Bedingung nicht erfüllen.
- Lernen Sie, wie Sie Parameterwerte in Form von Zeichenfolgen mit Schlüsselwörtern wie 'StrToNumber' und 'StrToNumberDef' in numerische Werte umwandeln, um sie mit Wertebereichen zu vergleichen.
Die PCB-Abfragefunktionen Parameters im Dialog Query Helper
Diese Referenzseite beschreibt die Schlüsselwörter der Abfragesprache aus der Kategorie Parameters, die in PCB- und PCB-Bibliotheksdokumenten verfügbar sind. Hilfe zu einem bestimmten Abfrageschlüsselwort erhalten Sie in den folgenden aufklappbaren Abschnitten. Alternativ können Sie ein Schlüsselwort in Query Helper oder einem Filter-Panel markieren (oder hineinklicken) und anschließend F1 drücken, um direkt zum zugehörigen Abschnitt zu gelangen.
CompParameterValue
Zusammenfassung
Gibt den Zeichenfolgenwert eines PCB-Bauteilparameters zurück. Dieser kann geprüft werden, um PCB-Bauteile zurückzugeben, die der Abfrage entsprechen.
Syntax
CompParameterValue(ParameterName : String) : String
Anwendungsbeispiele
CompParameterValue('Mounting Technology') Like 'SM*'
Gibt alle Bauteile zurück, die den Parameter Mounting Technology enthalten, dessen Zeichenfolgenwert mit SM beginnt, beispielsweise SMT, SMD usw. Die zugehörigen untergeordneten Objekte eines passenden Bauteilobjekts, wie Leiterbahnen, Kreisbögen, Pads, Texte usw., werden ebenfalls zurückgegeben.
CompParameterValue('Mounting Technology') Like '*SM*'
Gibt alle Bauteile und ihre zugehörigen untergeordneten Objekte zurück, bei denen der Parameter Mounting Technology einen Zeichenfolgenwert hat, der *SM* enthält.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Gibt alle Bauteile und ihre zugehörigen untergeordneten Objekte zurück, bei denen der Wert des Parameters VoltageRating größer als 50 Volt ist. Der von CompParameterValue zurückgegebene Zeichenfolgenwert wird für den Vergleich durch die einheitenberücksichtigende Funktion StrToNumber in eine Zahl umgewandelt.
FootprintParameterValue
Zusammenfassung
Gibt den Zeichenfolgenwert eines PCB-Footprint-Parameters zurück. Dieser kann geprüft werden, um PCB-Bauteile zurückzugeben, die der Abfrage entsprechen.
Syntax
FootprintParameterValue(ParameterName : String) : String
Anwendungsbeispiele
FootprintParameterValue('Mounting Type') Like 'SMD'
Gibt alle Bauteile und ihre zugehörigen untergeordneten Objekte zurück, bei denen der Footprint-Parameter Mounting Type einen Zeichenfolgenwert hat, der SMD enthält.
HasCompParameter
Zusammenfassung
Gibt PCB-Bauteile zurück, die einen Parameter mit dem angegebenen Namen enthalten.
Syntax
HasCompParameter(ParameterName : String) : Boolean
Anwendungsbeispiele
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Gibt alle übergeordneten Bauteilobjekte zurück, die einen Parameter mit dem Namen Mounting Technology besitzen. Die zugehörigen untergeordneten Objekte eines passenden Bauteilobjekts, wie Leiterbahnen, Kreisbögen, Pads, Texte usw., werden ebenfalls zurückgegeben.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Gibt alle Bauteile und ihre zugehörigen untergeordneten Objekte zurück, except für diejenigen übergeordneten Bauteilobjekte, die den Parameter Mounting Technology besitzen.
HasCompParameterValue
Zusammenfassung
Gibt PCB-Bauteile zurück, die einen Parameter mit dem angegebenen Namen enthalten, dessen Wert der Abfrage entspricht.
Syntax
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Anwendungsbeispiele
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Gibt alle übergeordneten Bauteilobjekte zurück, die einen Parameter mit dem Namen Mounting Technology und dem übereinstimmenden Wert SMT besitzen. Die zugehörigen untergeordneten Objekte eines passenden Bauteilobjekts, wie Leiterbahnen, Kreisbögen, Pads, Texte usw., werden ebenfalls zurückgegeben.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Gibt alle Bauteile und ihre zugehörigen untergeordneten Objekte zurück, die keinen Parameter Design Item Status mit dem Wert RoHS-Compliant besitzen.
HasFootprintParameter
Zusammenfassung
Gibt PCB-Bauteile zurück, die einen Footprint-Parameter mit dem angegebenen Namen enthalten.
Syntax
HasFootprintParameter(ParameterName : String) : Boolean
Anwendungsbeispiele
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Gibt alle übergeordneten Bauteilobjekte zurück, die einen Footprint-Parameter mit dem Namen IPC Density besitzen. Die zugehörigen untergeordneten Objekte eines passenden Bauteilobjekts, wie Leiterbahnen, Kreisbögen, Pads, Texte usw., werden ebenfalls zurückgegeben.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Gibt alle Bauteile und ihre zugehörigen untergeordneten Objekte zurück, except für diejenigen übergeordneten Bauteilobjekte, die den Footprint-Parameter IPC Density besitzen.
HasFootprintParameterValue
Zusammenfassung
Gibt PCB-Bauteile zurück, die einen Footprint-Parameter mit dem angegebenen Namen enthalten, dessen Wert der Abfrage entspricht.
Syntax
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Anwendungsbeispiele
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Gibt alle übergeordneten Bauteilobjekte zurück, die einen Footprint-Parameter mit dem Namen Mounting Method und dem übereinstimmenden Wert Press Fit. besitzen. Die zugehörigen untergeordneten Objekte eines passenden Bauteilobjekts, wie Leiterbahnen, Kreisbögen, Pads, Texte usw., werden ebenfalls zurückgegeben.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Gibt alle Bauteile und ihre zugehörigen untergeordneten Objekte zurück, die keinen Footprint-Parameter Mounting Method mit folgendem Wert besitzen: Press Fit.
HasParameter
Zusammenfassung
Gibt PCB-Objekte zurück, die einen Parameter mit dem angegebenen Namen enthalten.
Syntax
HasParameter(ParameterName : String) : Boolean
Anwendungsbeispiele
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Gibt alle Objekte zurück, die einen Parameter mit dem Namen Mounting Technology besitzen.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Gibt alle Objekte except denjenigen zurück, die den Parameter Mounting Technology besitzen.
HasParameterValue
Zusammenfassung
Gibt PCB-Objekte zurück, die einen Parameter mit dem angegebenen Namen enthalten, dessen Wert der Abfrage entspricht.
Syntax
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Anwendungsbeispiele
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Gibt alle Objekte zurück, die einen Parameter mit dem Namen Mounting Technology und dem übereinstimmenden Wert SMT besitzen.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
Gibt alle Objekte zurück, die keinen Parameter Design Item Status mit dem Wert RoHS-Compliant besitzen.
ParameterValue
Zusammenfassung
Gibt den Zeichenfolgenwert eines PCB-Objektparameters zurück. Dieser kann geprüft werden, um PCB-Objekte zurückzugeben, die der Abfrage entsprechen.
Syntax
ParameterValue(ParameterName : String) : String
Anwendungsbeispiele
ParameterValue('Mounting Technology') Like 'SM*'
Gibt alle Objekte mit dem Parameter Mounting Technology zurück, dessen Zeichenfolgenwert mit SM beginnt, beispielsweise SMT, SMD usw.
ParameterValue('Mounting Technology') Like '*SM*'
Gibt alle Objekte mit dem Parameter Mounting Technology zurück, dessen Zeichenfolgenwert SM enthält.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Gibt alle Objekte zurück, bei denen der Wert des Parameters VoltageRating größer als 50 Volt ist. Der von ParameterValue zurückgegebene Zeichenfolgenwert wird für den Vergleich durch die einheitenberücksichtigende Funktion StrToNumber in eine Zahl umgewandelt.
StrToNumber
Zusammenfassung
Wandelt den angegebenen Parameterwert als Zeichenfolge unter Verwendung des festgelegten Einheitentyps in eine Zahl um.
Syntax
StrToNumber(Value : String , Unit : String) : Number
Anwendungsbeispiele
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Wandelt den vom Parameter VoltageRating zurückgegebenen Zeichenfolgenwert unter Verwendung von Volt (V) als Einheit in eine Zahl um und gibt anschließend alle Objekte mit einem Wert größer als 50 V zurück.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Wandelt den vom Parameter Resistance zurückgegebenen Zeichenfolgenwert unter Verwendung von Ohm als Einheit in eine Zahl um und gibt anschließend alle Objekte mit einem Wert zwischen 1 kΩ und 10 kΩ zurück.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Wandelt den vom Parameter CapacitanceValue zurückgegebenen Zeichenfolgenwert unter Verwendung von Farad (F) als Einheit der Kapazität in eine Zahl um und gibt anschließend alle Objekte mit einem Wert kleiner als 2 nF (2e-9 in wissenschaftlicher Notation) zurück.
Hinweise
Wenn der Zeichenfolgenwert nicht in eine Zahl umgewandelt werden kann, wird ein Skriptfehler ausgelöst. Verwenden Sie für diesen Fall die Funktion StrToNumber, die bei fehlgeschlagener Umwandlung eine festgelegte Standardzahl zurückgibt.
Die einheitenberücksichtigende Funktion zur Umwandlung von Zeichenfolgen in Zahlen unterstützt zahlreiche Einheitentypen, darunter:
- V – Spannung
- A – Strom
- Ohm – Widerstand
- Z – Impedanz
- F – Kapazität
- H – Induktivität
- G – Leitwert
- W – Leistung
- Hz – Frequenz
- Q – Ladung
- C – Temperatur
- dB – Dezibel
- % – Prozent
- m – Länge
- Kg – Masse
- s – Zeit
Die Konvertierungsfunktion akzeptiert gängige Skalierungsfaktoren (Mikro, Kilo, Mega usw.) und damit auch Parameterzeichenfolgen mit Präfixabkürzungen wie mV, uA, kHz, usw.
Es werden auch verschiedene Wertdarstellungen unterstützt. Beispielsweise kann derselbe Widerstandswert wie folgt dargestellt werden:
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Zusammenfassung
Wandelt die angegebene Parameterwert-Zeichenfolge unter Verwendung des festgelegten Einheitentyps in eine Zahl um oder gibt einen Standardwert zurück.
Syntax
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Anwendungsbeispiele
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Wandelt die vom Parameter VoltageRating zurückgegebene Wertzeichenfolge in eine Zahl um, wobei Spannung (V) als Einheit verwendet wird, und gibt anschließend alle Objekte mit einem Wert größer als 50 V zurück. Wenn die Parameterzeichenfolge oder die Einheit nicht erkannt wird (und daher nicht konvertiert werden kann), wird der Standardwert 10 zurückgegeben.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Wandelt die vom Parameter VoltageRating zurückgegebene Wertzeichenfolge in eine Zahl um, wobei Spannung (V) als Einheit verwendet wird, und gibt anschließend alle Objekte mit einem Nennwert zwischen 10 V und 50 V zurück. Wenn der Wert nicht gelesen werden kann, wird eine Spannung von 6 V (der definierte Standardwert) angenommen.
Hinweise
Die einheitenberücksichtigende Funktion zur Umwandlung von Zeichenfolgen in Zahlen unterstützt zahlreiche Einheitentypen, darunter:
- V – Spannung
- A – Strom
- Ohm – Widerstand
- Z – Impedanz
- F – Kapazität
- H – Induktivität
- G – Leitwert
- W – Leistung
- Hz – Frequenz
- Q – Ladung
- C – Temperatur
- dB – Dezibel
- % – Prozent
- m – Länge
- Kg – Masse
- s – Zeit
Die Konvertierungsfunktion akzeptiert gängige Skalierungsfaktoren (Mikro, Kilo, Mega usw.) und damit auch Parameterzeichenfolgen mit Präfixabkürzungen wie mV, uA, kHz, usw.
Es werden auch verschiedene Wertdarstellungen unterstützt. Beispielsweise kann derselbe Widerstandswert wie folgt dargestellt werden:
- 2k2
- 2.2k
- 2200
- 2,200
KI-lokalisiert