パラメーター

概要

PCBコンポーネントのパラメーターの文字列値を返します。この値を評価することで、クエリに一致するPCBコンポーネントを取得できます。

構文

CompParameterValue(ParameterName : String) : String

使用例

CompParameterValue('Mounting Technology') Like 'SM*'
SMで始まる文字列値（SMT、SMDなど）を持つMounting Technologyパラメーターを含む、すべてのコンポーネントを返します。条件に一致するコンポーネントオブジェクトに関連付けられた子オブジェクト（トラック、アーク、パッド、テキストなど）も返されます。

CompParameterValue('Mounting Technology') Like '*SM*'
Mounting Technology パラメーターの文字列値に*SM*が含まれる、すべてのコンポーネントとその関連子オブジェクトを返します。

StrToNumber(CompParameterValue('VoltageRating'),V) > 50
VoltageRatingパラメーターの値が50ボルトを超える、すべてのコンポーネントとその関連子オブジェクトを返します。CompParameterValueが返す文字列値は、単位を認識するStrToNumber関数によって数値に変換され、比較に使用されます。

概要

PCBフットプリントのパラメーターの文字列値を返します。この値を評価することで、クエリに一致するPCBコンポーネントを取得できます。

構文

FootprintParameterValue(ParameterName : String) : String

使用例

FootprintParameterValue('Mounting Type') Like 'SMD'
Mounting Type フットプリントパラメーターの文字列値にSMDが含まれる、すべてのコンポーネントとその関連子オブジェクトを返します。

概要

指定した名前のパラメーターを含むPCBコンポーネントを返します。

構文

HasCompParameter(ParameterName : String) : Boolean

使用例

HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Mounting Technologyという名前のパラメーターを持つ、すべてのコンポーネント親オブジェクトを返します。条件に一致するコンポーネントオブジェクトに関連付けられた子オブジェクト（トラック、アーク、パッド、テキストなど）も返されます。

Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Mounting Technologyパラメーターを持つコンポーネント親オブジェクトをexcept、すべてのコンポーネントとその関連子オブジェクトを返します。

概要

指定した名前のパラメーターを含み、その値がクエリに一致するPCBコンポーネントを返します。

構文

HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean

使用例

HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Mounting Technologyという名前のパラメーターを持ち、その値プロパティがSMTと一致する、すべてのコンポーネント親オブジェクトを返します。条件に一致するコンポーネントオブジェクトに関連付けられた子オブジェクト（トラック、アーク、パッド、テキストなど）も返されます。

Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
値がRoHS-CompliantであるDesign Item Statusパラメーターを持たない、すべてのコンポーネントとその関連子オブジェクトを返します。

概要

指定した名前のフットプリントパラメーターを含むPCBコンポーネントを返します。

構文

HasFootprintParameter(ParameterName : String) : Boolean

使用例

HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
IPC Density という名前のフットプリントパラメーターを持つ、すべてのコンポーネント親オブジェクトを返します。条件に一致するコンポーネントオブジェクトに関連付けられた子オブジェクト（トラック、アーク、パッド、テキストなど）も返されます。

Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
IPC Density フットプリントパラメーターを持つコンポーネント親オブジェクトをexcept、すべてのコンポーネントとその関連子オブジェクトを返します。

概要

指定した名前のフットプリントパラメーターを含み、その値がクエリに一致するPCBコンポーネントを返します。

構文

HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean

使用例

HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Mounting Method という名前のフットプリントパラメーターを持ち、その値プロパティがPress Fit. と一致する、すべてのコンポーネント親オブジェクトを返します。条件に一致するコンポーネントオブジェクトに関連付けられた子オブジェクト（トラック、アーク、パッド、テキストなど）も返されます。

Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Mounting Method フットプリントパラメーターが指定の値を持たない、すべてのコンポーネントとその関連子オブジェクトを返します。Press Fit.

概要

指定した名前のパラメーターを含むPCBオブジェクトを返します。

構文

HasParameter(ParameterName : String) : Boolean

使用例

HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Mounting Technologyという名前のパラメーターを持つ、すべてのオブジェクトを返します。

Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Mounting Technologyパラメーターを持つオブジェクトをexcept、すべてのオブジェクトを返します。

概要

指定した名前のパラメーターを含み、その値がクエリに一致するPCBオブジェクトを返します。

構文

HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean

使用例

HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Mounting Technologyという名前のパラメーターを持ち、その値プロパティがSMTと一致する、すべてのオブジェクトを返します。

Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
値がRoHS-CompliantであるDesign Item Statusパラメーターを持たない、すべてのオブジェクトを返します。

概要

PCBオブジェクトのパラメーターの文字列値を返します。この値を評価することで、クエリに一致するPCBオブジェクトを取得できます。

構文

ParameterValue(ParameterName : String) : String

使用例

ParameterValue('Mounting Technology') Like 'SM*'
SMで始まる文字列値（SMT、SMDなど）を持つMounting Technologyパラメーターを含む、すべてのオブジェクトを返します。

ParameterValue('Mounting Technology') Like '*SM*'
Mounting Technologyパラメーターの文字列値にSMが含まれる、すべてのオブジェクトを返します。

StrToNumber(ParameterValue('VoltageRating'),V)  >  50
VoltageRatingパラメーターの値が50ボルトを超える、すべてのオブジェクトを返します。ParameterValueが返す文字列値は、単位を認識するStrToNumber関数によって数値に変換され、比較に使用されます。

概要

指定した単位の種類を使用して、指定のパラメーター値の文字列を数値に変換します。

構文

StrToNumber(Value : String , Unit : String) : Number

使用例

StrToNumber(ParameterValue('VoltageRating'),V)  >  50
VoltageRating パラメーターが返す値の文字列を、ボルト（V）を単位として数値に変換し、値が50Vを超えるすべてのオブジェクトを返します。

StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Resistance パラメーターが返す値の文字列を、オームを単位として数値に変換し、値が1kΩから10kΩの範囲にあるすべてのオブジェクトを返します。

StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
CapacitanceValue パラメーターが返す値の文字列を、静電容量の単位であるファラド（F）を使用して数値に変換し、値が2nF（科学表記では2e-9）未満のすべてのオブジェクトを返します。

注意事項

値の文字列を数値に変換できない場合、スクリプトエラーが発生します。このような状況に対応するには、変換に失敗した場合に指定のデフォルト数値を返すStrToNumber関数を使用してください。

単位を認識する文字列から数値への変換関数は、次のような幅広い単位型の定義に対応しています。

• V – 電圧
• A – 電流
• Ohm – 抵抗
• Z – インピーダンス
• F – 静電容量
• H – インダクタンス
• G – コンダクタンス
• W – 電力
• Hz – 周波数
• Q – 電荷
• C – 温度
• dB – デシベル
• % – パーセント
• m – 長さ
• Kg – 質量
• s – 時間

この変換関数は標準的な倍率接頭辞（マイクロ、キロ、メガなど）に対応しているため、mV、uA、kHz, などの接頭辞の略号を含むパラメーター文字列を使用できます。

値のさまざまな表記形式にも対応しています。たとえば、同じ抵抗値を次のように表すことができます。

• 2k2
• 2.2k
• 2200
• 2,200

概要

指定された単位型を使用して、指定されたパラメーター値の文字列を数値に変換します。変換できない場合は、デフォルトの数値を返します。

構文

StrToNumber(Value : String , Unit : String , Default : Number) : Number

使用例

StrToNumberDef(ParameterValue('VoltageRating'),V,10)  >  50
VoltageRating パラメーターが返す値の文字列を、電圧（V）を単位として数値に変換し、値が50Vを超えるすべてのオブジェクトを返します。パラメーター文字列または単位を認識できない（変換できない）場合は、デフォルト値の 10 を返します。

StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
VoltageRating パラメーターが返す値の文字列を、電圧（V）を単位として数値に変換し、定格値が10V～50Vの範囲内にあるすべてのオブジェクトを返します。値を読み取れない場合は、電圧を6V（定義されたデフォルト値）とみなします。

注記

単位を認識する文字列から数値への変換関数は、次のような幅広い単位型の定義に対応しています。

• V – 電圧
• A – 電流
• Ohm – 抵抗
• Z – インピーダンス
• F – 静電容量
• H – インダクタンス
• G – コンダクタンス
• W – 電力
• Hz – 周波数
• Q – 電荷
• C – 温度
• dB – デシベル
• % – パーセント
• m – 長さ
• Kg – 質量
• s – 時間

この変換関数は標準的な倍率接頭辞（マイクロ、キロ、メガなど）に対応しているため、mV、uA、kHz, などの接頭辞の略号を含むパラメーター文字列を使用できます。

値のさまざまな表記形式にも対応しています。たとえば、同じ抵抗値を次のように表すことができます。

• 2k2
• 2.2k
• 2200
• 2,200