パラメータ

概要

PCBコンポーネントのパラメータの文字列値を返します。この値をテストすることで、クエリに適合するPCBコンポーネントを返せます。

構文

CompParameterValue(ParameterName : String) : String

使用例

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

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
値プロパティがSMTに一致するMounting Technologyパラメータ名を持つ、すべてのコンポーネント親オブジェクトを返します。適合するコンポーネントオブジェクトに関連付けられた子オブジェクト（トラック、アーク、パッド、テキストなど）も返されます。

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
値プロパティがPress Fit. に一致するMounting Method フットプリントパラメータ名を持つ、すべてのコンポーネント親オブジェクトを返します。適合するコンポーネントオブジェクトに関連付けられた子オブジェクト（トラック、アーク、パッド、テキストなど）も返されます。

Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
値が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で始まるMounting Technologyパラメータを持つすべてのオブジェクト（例：SMT、SMDなど）を返します。

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

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 – 時間

このコンバータは標準的な値のスケーリング係数（micro、kilo、megaなど）を受け付けるため、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 – 時間

このコンバータは標準的な値のスケーリング係数（micro、kilo、megaなど）を受け付けるため、mV、uA、kHz,などの接頭辞略語を含むパラメータ文字列も扱えます。

また、複数の値表記もサポートします。たとえば、同じ抵抗値は次のように表せます。

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