Parametry

Funkcje zapytań PCB pokazane w oknie dialogowym Parameters
Ta strona referencyjna opisuje słowa kluczowe języka zapytań z kategorii Parameters dostępne w dokumentach PCB oraz bibliotekach PCB. Aby uzyskać pomoc dotyczącą konkretnego słowa kluczowego zapytania, skorzystaj z poniższych zwijanych sekcji albo zaznacz (lub kliknij wewnątrz) dowolne słowo kluczowe w panelu Query Helper lub 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 przetestować, aby zwrócić komponenty PCB spełniające zapytanie.
Składnia
CompParameterValue(ParameterName : String) : String
Przykładowe użycie
CompParameterValue('Mounting Technology') Like 'SM*'
Zwraca wszystkie komponenty, które zawierają parametr Mounting Technology o wartości tekstowej zaczynającej się od SM, np. SMT, SMD, itd. Zwracane są również powiązane obiekty podrzędne komponentu spełniającego warunek, takie jak ścieżki, łuki, pady, tekst itp.
CompParameterValue('Mounting Technology') Like '*SM*'
Zwraca wszystkie komponenty oraz ich powiązane obiekty podrzędne, w których parametr Mounting Technology ma wartość tekstową zawierającą *SM*.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
Zwraca wszystkie komponenty oraz ich powiązane obiekty podrzędne, w których wartość parametru VoltageRating jest większa niż 50 woltów. Wartość tekstowa zwrócona przez CompParameterValue jest konwertowana na liczbę do porównania przez funkcję StrToNumber uwzględniającą jednostki.
FootprintParameterValue
Podsumowanie
Zwraca wartość tekstową parametru Footprint PCB, którą można przetestować, aby zwrócić komponenty PCB spełniające zapytanie.
Składnia
FootprintParameterValue(ParameterName : String) : String
Przykładowe użycie
FootprintParameterValue('Mounting Type') Like 'SMD'
Zwraca wszystkie komponenty oraz ich powiązane obiekty podrzędne, w których parametr Mounting Type Footprint ma wartość tekstową zawierającą SMD.
HasCompParameter
Podsumowanie
Zwraca komponenty PCB zawierające wskazaną nazwę parametru.
Składnia
HasCompParameter(ParameterName : String) : Boolean
Przykładowe użycie
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Zwraca wszystkie obiekty nadrzędne komponentów, które mają nazwę parametru Mounting Technology. Zwracane są również powiązane obiekty podrzędne komponentu spełniającego warunek, takie jak ścieżki, łuki, pady, tekst itp.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Zwraca wszystkie komponenty oraz ich powiązane obiekty podrzędne, except dla tych obiektów nadrzędnych komponentów, które mają parametr Mounting Technology.
HasCompParameterValue
Podsumowanie
Zwraca komponenty PCB, które zawierają wskazaną nazwę parametru o wartości spełniającej zapytanie.
Składnia
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Przykładowe użycie
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Zwraca wszystkie obiekty nadrzędne komponentów, które mają nazwę parametru Mounting Technology z pasującą właściwością wartości SMT. Zwracane są również powiązane obiekty podrzędne komponentu spełniającego warunek, takie jak ścieżki, łuki, pady, tekst itp.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
Zwraca wszystkie komponenty oraz ich powiązane obiekty podrzędne, które nie mają parametru Design Item Status o wartości RoHS-Compliant.
HasFootprintParameter
Podsumowanie
Zwraca komponenty PCB zawierające wskazaną nazwę parametru Footprint.
Składnia
HasFootprintParameter(ParameterName : String) : Boolean
Przykładowe użycie
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
Zwraca wszystkie obiekty nadrzędne komponentów, które mają nazwę parametru IPC Density Footprint. Zwracane są również powiązane obiekty podrzędne komponentu spełniającego warunek, takie jak ścieżki, łuki, pady, tekst itp.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
Zwraca wszystkie komponenty oraz ich powiązane obiekty podrzędne, except dla tych obiektów nadrzędnych komponentów, które mają parametr IPC Density Footprint.
HasFootprintParameterValue
Podsumowanie
Zwraca komponenty PCB, które zawierają wskazaną nazwę parametru Footprint o wartości spełniającej zapytanie.
Składnia
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Przykładowe użycie
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Zwraca wszystkie obiekty nadrzędne komponentów, które mają nazwę parametru Mounting Method Footprint z pasującą właściwością wartości Press Fit. . Zwracane są również powiązane obiekty podrzędne komponentu spełniającego warunek, takie jak ścieżki, łuki, pady, tekst, itd.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Zwraca wszystkie komponenty oraz ich powiązane obiekty podrzędne, które nie mają parametru Mounting Method Footprint o wartości Press Fit.
HasParameter
Podsumowanie
Zwraca obiekty PCB zawierające wskazaną nazwę parametru.
Składnia
HasParameter(ParameterName : String) : Boolean
Przykładowe użycie
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Zwraca wszystkie obiekty, które mają nazwę parametru 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 wskazaną nazwę parametru o wartości spełniającej zapytanie.
Składnia
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
Przykładowe użycie
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Zwraca wszystkie obiekty, które mają nazwę parametru Mounting Technology oraz pasującą właściwość wartości 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 przetestować, aby zwrócić obiekty PCB spełniające zapytanie.
Składnia
ParameterValue(ParameterName : String) : String
Przykładowe użycie
ParameterValue('Mounting Technology') Like 'SM*'
Zwraca wszystkie obiekty z parametrem Mounting Technology, którego wartość tekstowa zaczyna się od SM, np. SMT, SMD itd.
ParameterValue('Mounting Technology') Like '*SM*'
Zwraca wszystkie obiekty z parametrem Mounting Technology, którego wartość tekstowa zawiera SM.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Zwraca wszystkie obiekty, które mają wartość parametru VoltageRating większą niż 50 woltów. Wartość tekstowa zwrócona przez ParameterValue jest konwertowana na liczbę do porównania przez funkcję StrToNumber uwzględniającą jednostki.
StrToNumber
Podsumowanie
Konwertuje wskazany tekst wartości parametru na liczbę, używając określonego typu jednostki.
Składnia
StrToNumber(Value : String , Unit : String) : Number
Przykładowe użycie
StrToNumber(ParameterValue('VoltageRating'),V) > 50
Konwertuje tekst wartości zwrócony 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ż 50V.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Konwertuje tekst wartości zwrócony przez parametr Resistance na liczbę, używając omów jako jednostki, a następnie zwraca wszystkie obiekty o wartości pomiędzy 1kΩ a 10kΩ.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Konwertuje tekst wartości zwrócony przez parametr CapacitanceValue na liczbę, używając pojemności (F) jako jednostki, a następnie zwraca wszystkie obiekty o wartości mniejszej niż 2nF (2e-9 w notacji naukowej).
Uwagi
Zostanie zgłoszony błąd skryptu, jeśli tekst wartości nie może zostać przekonwertowany na liczbę. Aby uwzględnić taką sytuację, użyj funkcji StrToNumber, która zwraca wskazaną domyślną liczbę, jeśli konwersja się nie powiedzie.
Funkcja konwersji tekstu na liczbę uwzględniająca jednostki akceptuje 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 akceptuje standardowe współczynniki skalowania wartości (micro, kilo, mega itd.) i dlatego obsługuje ciągi parametrów zawierające skróty prefiksów, takie jak mV, uA, kHz, itd.
Obsługiwanych jest także kilka formatów zapisu wartości. Na przykład ta sama wartość rezystancji może być przedstawiona jako:
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
Podsumowanie
Konwertuje wskazany tekst wartości parametru na liczbę lub liczbę domyślną, używając określonego typu jednostki.
Składnia
StrToNumber(Value : String , Unit : String , Default : Number) : Number
Przykładowe użycie
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
Konwertuje tekst 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ż 50V. Jeśli ciąg parametru lub jednostka są nierozpoznane (nie można ich przekonwertować), zwracana jest wartość domyślna 10.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Konwertuje tekst 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 pomiędzy 10V a 50V. Jeśli wartości nie da się odczytać, przyjmowane jest napięcie 6V (zdefiniowana wartość domyślna).
Uwagi
Funkcja konwersji tekstu na liczbę uwzględniająca jednostki akceptuje 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 akceptuje standardowe współczynniki skalowania wartości (micro, kilo, mega itd.) i dlatego obsługuje ciągi parametrów zawierające skróty prefiksów, takie jak mV, uA, kHz, itd.
Obsługiwanych jest także kilka formatów zapisu wartości. Na przykład ta sama wartość rezystancji może być przedstawiona jako:
- 2k2
- 2,2k
- 2200
- 2 200