Parametry
W skrócie
- Dowiedz się, które słowa kluczowe zapytań dotyczących parametrów mają zastosowanie do komponentów, footprintów lub ogólnych obiektów PCB oraz jak używać każdego z nich w filtrze lub zapytaniu.
- Zobacz przykładowe zapytania służące do wyszukiwania obiektów według nazwy parametru, dopasowywania pełnych wartości lub ich fragmentów oraz wykluczania obiektów, które nie spełniają warunku.
- Dowiedz się, jak przekształcać tekstowe wartości parametrów w wartości liczbowe na potrzeby porównań z zakresami przy użyciu słów kluczowych takich jak 'StrToNumber' i 'StrToNumberDef'.

Funkcje zapytań PCB Parameters widoczne w oknie dialogowym Query Helper
Ta strona dokumentacji szczegółowo opisuje słowa kluczowe języka zapytań z kategorii Parameters dostępne w dokumentach PCB i bibliotek PCB. Aby uzyskać pomoc dotyczącą konkretnego słowa kluczowego zapytania, skorzystaj z poniższych rozwijanych sekcji lub zaznacz dowolne słowo kluczowe (albo kliknij w jego obrębie) w Query Helper lub w panelu Filter, a następnie naciśnij F1, aby od razu przejść do odpowiedniej sekcji.
CompParameterValue
Podsumowanie
Zwraca wartość tekstową parametru komponentu PCB, którą można sprawdzić w celu wyszukania komponentów PCB spełniających warunki zapytania.
Składnia
CompParameterValue(ParameterName : String) : String
Przykłady użycia
CompParameterValue('Mounting Technology') Like 'SM*'
Zwraca wszystkie komponenty zawierające parametr Mounting Technology o wartości tekstowej zaczynającej się od SM, takiej jak SMT, SMD itp. Zwracane są również powiązane obiekty podrzędne komponentu spełniającego warunki, takie jak ścieżki, łuki, pola lutownicze, teksty itp.
CompParameterValue('Mounting Technology') Like '*SM*'
Zwraca wszystkie komponenty i powiązane z nimi obiekty podrzędne, dla których parametr Mounting Technology ma wartość tekstową zawierającą *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Zwraca wszystkie komponenty i powiązane z nimi obiekty podrzędne, dla których wartość parametru VoltageRating jest większa niż 50 woltów. Wartość tekstowa zwracana przez CompParameterValue jest przekształcana na liczbę na potrzeby porównania za pomocą funkcji StrToNumber, która uwzględnia jednostki.
FootprintParameterValue
Podsumowanie
Zwraca wartość tekstową parametru footprintu PCB, którą można sprawdzić w celu wyszukania komponentów PCB spełniających warunki zapytania.
Składnia
FootprintParameterValue(ParameterName : String) : String
Przykłady użycia
FootprintParameterValue('Mounting Type') Like 'SMD'
Zwraca wszystkie komponenty i powiązane z nimi obiekty podrzędne, dla których parametr footprintu Mounting Type ma wartość tekstową zawierającą SMD.
HasCompParameter
Podsumowanie
Zwraca komponenty PCB zawierające parametr o określonej nazwie.
Składnia
HasCompParameter(ParameterName : String) : Boolean
Przykłady użycia
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Zwraca wszystkie obiekty nadrzędne komponentów, które mają parametr o nazwie Mounting Technology. Zwracane są również powiązane obiekty podrzędne komponentu spełniającego warunki, takie jak ścieżki, łuki, pola lutownicze, teksty itp.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Zwraca wszystkie komponenty i powiązane z nimi obiekty podrzędne, except dla tych obiektów nadrzędnych komponentów, które mają parametr Mounting Technology.
HasCompParameterValue
Podsumowanie
Zwraca komponenty PCB zawierające parametr o określonej nazwie, którego wartość spełnia warunki zapytania.
Składnia
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Przykłady użycia
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Zwraca wszystkie obiekty nadrzędne komponentów, które mają parametr o nazwie Mounting Technology i wartości równej SMT. Zwracane są również powiązane obiekty podrzędne komponentu spełniającego warunki, takie jak ścieżki, łuki, pola lutownicze, teksty itp.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Zwraca wszystkie komponenty i powiązane z nimi obiekty podrzędne, które nie mają parametru Design Item Status o wartości RoHS-Compliant.
HasFootprintParameter
Podsumowanie
Zwraca komponenty PCB zawierające parametr footprintu o określonej nazwie.
Składnia
HasFootprintParameter(ParameterName : String) : Boolean
Przykłady użycia
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Zwraca wszystkie obiekty nadrzędne komponentów, które mają parametr footprintu o nazwie IPC Density. Zwracane są również powiązane obiekty podrzędne komponentu spełniającego warunki, takie jak ścieżki, łuki, pola lutownicze, teksty itp.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Zwraca wszystkie komponenty i powiązane z nimi obiekty podrzędne, except dla tych obiektów nadrzędnych komponentów, które mają parametr footprintu IPC Density.
HasFootprintParameterValue
Podsumowanie
Zwraca komponenty PCB zawierające parametr footprintu o określonej nazwie, którego wartość spełnia warunki zapytania.
Składnia
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Przykłady użycia
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Zwraca wszystkie obiekty nadrzędne komponentów, które mają parametr footprintu o nazwie Mounting Method i wartości równej Press Fit. . Zwracane są również powiązane obiekty podrzędne komponentu spełniającego warunki, takie jak ścieżki, łuki, pola lutownicze, teksty itp.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Zwraca wszystkie komponenty i powiązane z nimi obiekty podrzędne, które nie mają parametru footprintu Mounting Method o wartości Press Fit.
HasParameter
Podsumowanie
Zwraca obiekty PCB zawierające parametr o określonej nazwie.
Składnia
HasParameter(ParameterName : String) : Boolean
Przykłady użycia
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Zwraca wszystkie obiekty, które mają parametr o nazwie Mounting Technology.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Zwraca wszystkie obiekty except te, które mają parametr Mounting Technology.
HasParameterValue
Podsumowanie
Zwraca obiekty PCB zawierające parametr o określonej nazwie, którego wartość spełnia warunki zapytania.
Składnia
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Przykłady użycia
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Zwraca wszystkie obiekty, które mają parametr o nazwie Mounting Technology i wartości równej SMT.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
Zwraca wszystkie obiekty, które nie mają parametru Design Item Status o wartości RoHS-Compliant.
ParameterValue
Podsumowanie
Zwraca wartość tekstową parametru obiektu PCB, którą można sprawdzić w celu wyszukania obiektów PCB spełniających warunki zapytania.
Składnia
ParameterValue(ParameterName : String) : String
Przykłady użycia
ParameterValue('Mounting Technology') Like 'SM*'
Zwraca wszystkie obiekty z parametrem Mounting Technology o wartości tekstowej zaczynającej się od SM, takiej jak SMT, SMD itp.
ParameterValue('Mounting Technology') Like '*SM*'
Zwraca wszystkie obiekty z parametrem Mounting Technology o wartości tekstowej zawierającej SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Zwraca wszystkie obiekty, których wartość parametru VoltageRating jest większa niż 50 woltów. Wartość tekstowa zwracana przez ParameterValue jest przekształcana na liczbę na potrzeby porównania za pomocą funkcji StrToNumber, która uwzględnia jednostki.
StrToNumber
Podsumowanie
Przekształca wskazaną wartość tekstową parametru na liczbę przy użyciu określonego typu jednostki.
Składnia
StrToNumber(Value : String , Unit : String) : Number
Przykłady użycia
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Przekształca wartość tekstową zwracaną przez parametr VoltageRating na liczbę, używając woltów (V) jako jednostki, a następnie zwraca wszystkie obiekty o wartości większej niż 50 V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Przekształca wartość tekstową zwracaną przez parametr Resistance na liczbę, używając omów jako jednostki, a następnie zwraca wszystkie obiekty o wartości od 1 kΩ do 10 kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Przekształca wartość tekstową zwracaną przez parametr CapacitanceValue na liczbę, używając faradów (F) jako jednostki pojemności, a następnie zwraca wszystkie obiekty o wartości mniejszej niż 2 nF (2e-9 w notacji naukowej).
Uwagi
Jeśli wartości tekstowej nie można przekształcić na liczbę, zostanie zgłoszony błąd skryptu. Aby obsłużyć taką sytuację, użyj funkcji StrToNumber, która w razie niepowodzenia konwersji zwraca wskazaną liczbę domyślną.
Funkcja konwersji ciągu znaków na liczbę z uwzględnieniem jednostek obsługuje szeroki zakres definicji typów jednostek, w tym:
- V – Napięcie
- A – Prąd
- Ohm – Rezystancja
- Z – Impedancja
- F – Pojemność
- H – Indukcyjność
- G – Konduktancja
- W – Moc
- Hz – Częstotliwość
- Q – Ładunek
- C – Temperatura
- dB – Decybele
- % – Procent
- m – Długość
- Kg – Masa
- s – Czas
Konwerter obsługuje standardowe mnożniki wartości (mikro, kilo, mega itp.), a tym samym ciągi znaków parametrów zawierające skróty przedrostków, takie jak mV, uA, kHz, itp.
Obsługiwane są również różne sposoby zapisu wartości. Na przykład tę samą wartość rezystancji można zapisać jako:
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Podsumowanie
Konwertuje ciąg znaków reprezentujący wartość wskazanego parametru na liczbę lub domyślną wartość liczbową, używając określonego typu jednostki.
Składnia
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Przykłady użycia
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Konwertuje ciąg znaków wartości zwrócony przez parametr VoltageRating na liczbę, używając napięcia (V) jako jednostki, a następnie zwraca wszystkie obiekty o wartości większej niż 50 V. Jeśli ciąg znaków parametru lub jednostka nie zostaną rozpoznane (nie można ich przekonwertować), zwracana jest wartość domyślna 10.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Konwertuje ciąg znaków wartości zwrócony przez parametr VoltageRating na liczbę, używając napięcia (V) jako jednostki, a następnie zwraca wszystkie obiekty o wartości znamionowej od 10 V do 50 V. Jeśli nie można odczytać wartości, przyjmowane jest napięcie 6 V (zdefiniowana wartość domyślna).
Uwagi
Funkcja konwersji ciągu znaków na liczbę z uwzględnieniem jednostek obsługuje szeroki zakres definicji typów jednostek, w tym:
- V – Napięcie
- A – Prąd
- Ohm – Rezystancja
- Z – Impedancja
- F – Pojemność
- H – Indukcyjność
- G – Konduktancja
- W – Moc
- Hz – Częstotliwość
- Q – Ładunek
- C – Temperatura
- dB – Decybele
- % – Procent
- m – Długość
- Kg – Masa
- s – Czas
Konwerter obsługuje standardowe mnożniki wartości (mikro, kilo, mega itp.), a tym samym ciągi znaków parametrów zawierające skróty przedrostków, takie jak mV, uA, kHz, itp.
Obsługiwane są również różne sposoby zapisu wartości. Na przykład tę samą wartość rezystancji można zapisać jako:
- 2k2
- 2.2k
- 2200
- 2,200