Paramètres

Les fonctions de requête PCB affichées dans la boîte de dialogue ParametersQuery Helper
Cette page de référence détaille les mots-clés du langage de requête de la catégorie Parameters disponibles dans les documents PCB et de bibliothèque PCB. Pour obtenir de l’aide sur un mot-clé de requête spécifique, utilisez les sections repliables suivantes ou surlignez (ou cliquez dans) n’importe quel mot-clé donné dans le Query Helper ou un panneau Filter, puis appuyez sur F1 pour accéder immédiatement à sa section.
CompParameterValue
Résumé
Renvoie la valeur de chaîne d’un paramètre de composant PCB, qui peut être testée pour renvoyer les composants PCB conformes à la requête.
Syntaxe
CompParameterValue(ParameterName : String) : String
Exemple d’utilisation
CompParameterValue('Mounting Technology') Like 'SM*'
Renvoie tous les composants qui intègrent le paramètre Mounting Technology dont la chaîne de valeur commence par SM, comme SMT, SMD, etc. Les objets enfants associés d’un objet composant conforme, tels que les pistes, arcs, pastilles, textes, etc., sont également renvoyés.
CompParameterValue('Mounting Technology') Like '*SM*'
Renvoie tous les composants et leurs objets enfants associés pour lesquels le paramètre Mounting Technology a une chaîne de valeur qui inclut *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Renvoie tous les composants et leurs objets enfants associés pour lesquels la valeur du paramètre VoltageRating est supérieure à 50 volts. La valeur de chaîne renvoyée par CompParameterValue est convertie en nombre pour la comparaison par la fonction StrToNumber, sensible aux unités.
FootprintParameterValue
Résumé
Renvoie la valeur de chaîne d’un paramètre d’empreinte PCB, qui peut être testée pour renvoyer les composants PCB conformes à la requête.
Syntaxe
FootprintParameterValue(ParameterName : String) : String
Exemple d’utilisation
FootprintParameterValue('Mounting Type') Like 'SMD'
Renvoie tous les composants et leurs objets enfants associés pour lesquels le paramètre d’empreinte Mounting Type a une chaîne de valeur qui inclut SMD.
HasCompParameter
Résumé
Renvoie les composants PCB intégrant le nom de paramètre spécifié.
Syntaxe
HasCompParameter(ParameterName : String) : Boolean
Exemple d’utilisation
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Renvoie tous les objets parents de composant qui possèdent le nom de paramètre Mounting Technology. Les objets enfants associés d’un objet composant conforme, tels que les pistes, arcs, pastilles, textes, etc., sont également renvoyés.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Renvoie tous les composants et leurs objets enfants associés, except pour les objets parents de composant qui possèdent le paramètre Mounting Technology.
HasCompParameterValue
Résumé
Renvoie les composants PCB qui intègrent le nom de paramètre spécifié avec une valeur conforme à la requête.
Syntaxe
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemple d’utilisation
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Renvoie tous les objets parents de composant qui possèdent le nom de paramètre Mounting Technology avec une propriété de valeur correspondante de SMT. Les objets enfants associés d’un objet composant conforme, tels que les pistes, arcs, pastilles, textes, etc., sont également renvoyés.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Renvoie tous les composants et leurs objets enfants associés qui ne possèdent pas de paramètre Design Item Status avec une valeur de RoHS-Compliant.
HasFootprintParameter
Résumé
Renvoie les composants PCB intégrant le nom de paramètre d’empreinte spécifié.
Syntaxe
HasFootprintParameter(ParameterName : String) : Boolean
Exemple d’utilisation
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Renvoie tous les objets parents de composant qui possèdent le nom de paramètre d’empreinte IPC Density . Les objets enfants associés d’un objet composant conforme, tels que les pistes, arcs, pastilles, textes, etc., sont également renvoyés.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Renvoie tous les composants et leurs objets enfants associés, except pour les objets parents de composant qui possèdent le paramètre d’empreinte IPC Density .
HasFootprintParameterValue
Résumé
Renvoie les composants PCB qui intègrent le nom de paramètre d’empreinte spécifié avec une valeur conforme à la requête.
Syntaxe
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemple d’utilisation
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Renvoie tous les objets parents de composant qui possèdent le nom de paramètre d’empreinte Mounting Method avec une propriété de valeur correspondante de Press Fit. Les objets enfants associés d’un objet composant conforme, tels que les pistes, arcs, pastilles, textes, etc., sont également renvoyés.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Renvoie tous les composants et leurs objets enfants associés qui ne possèdent pas de paramètre d’empreinte Mounting Method avec une valeur de Press Fit.
HasParameter
Résumé
Renvoie les objets PCB intégrant le nom de paramètre spécifié.
Syntaxe
HasParameter(ParameterName : String) : Boolean
Exemple d’utilisation
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Renvoie tous les objets qui possèdent le nom de paramètre Mounting Technology.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Renvoie tous les objets except ceux qui possèdent le paramètre Mounting Technology.
HasParameterValue
Résumé
Renvoie les objets PCB intégrant le nom de paramètre spécifié avec une valeur conforme à la requête.
Syntaxe
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Exemple d’utilisation
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Renvoie tous les objets qui possèdent le nom de paramètre Mounting Technology et une propriété de valeur correspondante de SMT.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
Renvoie tous les objets qui ne possèdent pas de paramètre Design Item Status avec une valeur de RoHS-Compliant.
ParameterValue
Résumé
Renvoie la valeur de chaîne d’un paramètre d’objet PCB, qui peut être testée pour renvoyer les objets PCB conformes à la requête.
Syntaxe
ParameterValue(ParameterName : String) : String
Exemple d’utilisation
ParameterValue('Mounting Technology') Like 'SM*'
Renvoie tous les objets avec le paramètre Mounting Technology dont la chaîne de valeur commence par SM, comme SMT, SMD, etc.
ParameterValue('Mounting Technology') Like '*SM*'
Renvoie tous les objets avec le paramètre Mounting Technology dont la chaîne de valeur inclut SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Renvoie tous les objets qui ont une valeur de paramètre VoltageRating supérieure à 50 volts. La valeur de chaîne renvoyée par ParameterValue est convertie en nombre pour la comparaison par la fonction StrToNumber, sensible aux unités.
StrToNumber
Résumé
Convertit la chaîne de valeur du paramètre indiqué en un nombre à l’aide du type d’unité spécifié.
Syntaxe
StrToNumber(Value : String , Unit : String) : Number
Exemple d’utilisation
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Convertit la chaîne de valeur renvoyée par le paramètre VoltageRating en nombre, en utilisant les volts (V) comme unité, puis renvoie tous les objets ayant une valeur supérieure à 50V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Convertit la chaîne de valeur renvoyée par le paramètre Resistance en nombre, en utilisant les ohms comme unité, puis renvoie tous les objets ayant une valeur comprise entre 1kΩ et 10kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Convertit la chaîne de valeur renvoyée par le paramètre CapacitanceValue en nombre, en utilisant la capacité (F) comme unité, puis renvoie tous les objets ayant une valeur inférieure à 2nF (2e-9 en notation scientifique).
Remarques
Une erreur de script sera générée si la chaîne de valeur ne peut pas être convertie en nombre. Pour gérer cette situation, utilisez la fonction StrToNumber, qui renvoie un nombre par défaut spécifié si la conversion échoue.
La fonction de conversion de chaîne en nombre sensible aux unités accepte une large gamme de définitions de types d’unités, notamment :
- V – Tension
- A – Courant
- Ohm – Résistance
- Z – Impédance
- F – Capacité
- H – Inductance
- G – Conductance
- W – Puissance
- Hz – Fréquence
- Q – Charge
- C – Température
- dB – Décibels
- % – Pourcentage
- m – Longueur
- Kg – Masse
- s – Temps
Le convertisseur accepte les facteurs d’échelle de valeur standard (micro, kilo, méga, etc.) et, par conséquent, les chaînes de paramètres contenant des abréviations de préfixe telles que mV, uA, kHz, etc.
Plusieurs formats de valeur sont également pris en charge. Par exemple, la même valeur de résistance peut être représentée comme suit :
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Résumé
Convertit la chaîne de valeur du paramètre indiqué en un nombre, ou en un nombre par défaut, à l’aide du type d’unité spécifié.
Syntaxe
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Exemple d’utilisation
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Convertit la chaîne de valeur renvoyée par le paramètre VoltageRating en nombre, en utilisant la tension (V) comme unité, puis renvoie tous les objets ayant une valeur supérieure à 50V. Si la chaîne du paramètre ou l’unité n’est pas reconnue (ne peut pas être convertie), une valeur par défaut de 10 est renvoyée.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Convertit la chaîne de valeur renvoyée par le paramètre VoltageRating en nombre, en utilisant la tension (V) comme unité, puis renvoie tous les objets ayant une valeur nominale comprise entre 10V et 50V. Si la valeur ne peut pas être lue, une tension de 6V (la valeur par défaut définie) est supposée.
Remarques
La fonction de conversion de chaîne en nombre sensible aux unités accepte une large gamme de définitions de types d’unités, notamment :
- V – Tension
- A – Courant
- Ohm – Résistance
- Z – Impédance
- F – Capacité
- H – Inductance
- G – Conductance
- W – Puissance
- Hz – Fréquence
- Q – Charge
- C – Température
- dB – Décibels
- % – Pourcentage
- m – Longueur
- Kg – Masse
- s – Temps
Le convertisseur accepte les facteurs d’échelle de valeur standard (micro, kilo, méga, etc.) et, par conséquent, les chaînes de paramètres contenant des abréviations de préfixe telles que mV, uA, kHz, etc.
Plusieurs formats de valeur sont également pris en charge. Par exemple, la même valeur de résistance peut être représentée comme suit :
- 2k2
- 2.2k
- 2200
- 2,200