PCB Layout Parameters Query Functions in Altium Designer

Summary

Returns the string Value of a PCB component Parameter, which can be tested to return PCB components that comply with the Query.

Syntax

CompParameterValue(ParameterName : String) : String

Example Usage

CompParameterValue(‘Design Item Id’) Like 'CAP*'
Returns all components that incorporate the Design Item Id Parameter that has a Value string beginning with CAP, such as CAP-NP-100nF-50V-0805, CAP-P-22uF-10V-MCCT-B, etc. The associated child objects of a complying component object, such as tracks, arcs, pads, text etc, are also returned.

CompParameterValue(‘Design Item Id’) Like '*0805*'
Returns all components and their associated child objects where the Design Item Id Parameter has a Value string which includes 0805.

StrToNumber(CompParameterValue('VoltageRating'),V)  >  50
Returns all components and their associated child objects where the VoltageRating Parameter Value is greater than 50 volts. The string Value returned by CompParameterValue is converted to a number for the comparison by the unit-aware StrToNumber function.

Summary

Returns the string Value of a PCB Footprint Parameter, which can be tested to return PCB components that comply with the Query.

Syntax

FootprintParameterValue(ParameterName : String) : String

Example Usage

FootprintParameterValue(‘Mounting Type’) Like 'SMD'
Returns all components and their associated child objects where the Mounting Type Footprint Parameter has a Value string that includes SMD.

Summary

Returns PCB components incorporating the specified Parameter Name.

Syntax

HasCompParameter(ParameterName : String) : Boolean

Example Usage

HasCompParameter(‘Design Item Id’)
HasCompParameter(‘Design Item Id’) = True
Returns all component parent objects that have the Design Item Id Parameter Name. The associated child objects of a complying component object, such as tracks, arcs, pads, text etc, are also returned.

Not HasCompParameter(‘Design Item Id’)
HasCompParameter(‘Design Item Id’) = False
Returns all components and their associated child objects, except for those component parent objects that have the Design Item Id Parameter.

Summary

Returns PCB components that incorporate the specified Parameter Name that has a Value that complies with the Query.

Syntax

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

Example Usage

HasCompParameterValue(‘Design Item Id’,'LED-RED-HSMHC170')
HasCompParameterValue(‘Design Item Id’,'LED-RED-HSMHC170') = True
Returns all  component parent objects that have the Design Item Id Parameter Name with a matching Value property of LED-RED-HSMHC170. The associated child objects of a complying component object, such as tracks, arcs, pads, text, etc, are also returned.

Not HasCompParameterValue(‘Design Item Status’,'RoHS-Compliant')
HasCompParameterValue(‘Design Item Status’,'RoHS-Compliant') = False
Returns all components and their associated child objects that do not have a Design Item Status Parameter with a Value of RoHS-Compliant.

Summary

Returns PCB components incorporating the specified Footprint Parameter Name.

Syntax

HasFootprintParameter(ParameterName : String) : Boolean

Example Usage

HasFootprintParameter(‘IPC Density’)
HasFootprintParameter(‘IPC Density’) = True
Returns all component parent objects that have the IPC Density Footprint Parameter Name. The associated child objects of a complying component object, such as tracks, arcs, pads, text, etc., are also returned.

Not HasFootprintParameter(‘IPC Density’)
HasFootprintParameter(‘IPC Density’) = False
Returns all components and their associated child objects, except for those component parent objects that have the IPC Density Footprint Parameter.

Summary

Returns PCB components that incorporate the specified Footprint Parameter Name that has a Value that complies with the Query.

Syntax

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

Example Usage

HasFootprintParameterValue(‘Mounting Method’,'Press Fit')
HasFootprintParameterValue(‘Mounting Method’,'Press Fit') = True
Returns all  component parent objects that have the Mounting Method Footprint Parameter Name with a matching Value property of Press Fit. The associated child objects of a complying component object, such as tracks, arcs, pads, text, etc., are also returned.

Not HasFootprintParameterValue(‘Mounting Method’,'Press Fit')
HasFootprintParameterValue(‘Mounting Method’,'Press Fit') = False
Returns all components and their associated child objects that do not have a Mounting Method Footprint Parameter with a Value of Press Fit.

Summary

Returns PCB objects incorporating the specified Parameter Name.

Syntax

HasParameter(ParameterName : String) : Boolean

Example Usage

HasParameter(‘Design Item Id’)
HasParameter(‘Design Item Id’) = True
Returns all objects that have the Design Item Id Parameter Name.

Not HasParameter(‘Design Item Id’)
HasParameter(‘Design Item Id’) = False
Returns all objects except those that have the Design Item Id Parameter.

Summary

Returns PCB objects incorporating the specified Parameter Name that has a Value that complies with the Query.

Syntax

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

Example Usage

HasParameterValue(‘Design Item Id’,'LED-RED-HSMHC170')
HasParameterValue(‘Design Item Id’,'LED-RED-HSMHC170') = True
Returns all objects that have the Design Item Id Parameter Name and a matching Value property of LED-RED-HSMHC170.

Not HasParameterValue(‘Design Item Status’,'RoHS-Compliant')
HasParameterValue(‘Design Item Status’,'RoHS-Compliant') = False
Returns all objects that do not have a Design Item Status Parameter with a Value of RoHS-Compliant.

Summary

Returns the string Value of a PCB object Parameter, which can be tested to return PCB objects that comply to the Query.

Syntax

ParameterValue(ParameterName : String) : String

Example Usage

ParameterValue(‘Design Item Id’) Like 'CAP*'
Returns all objects with the Design Item Id Parameter that has a Value string beginning with CAP, such as CAP-NP-100nF-50V-0805, CAP-P-22uF-10V-MCCT-B, etc.

ParameterValue(‘Design Item Id’) Like '*0805*'
Returns all objects with the Design Item Id Parameter that has a Value string which includes 0805.

StrToNumber(ParameterValue('VoltageRating'),V)  >  50
Returns all objects that have a VoltageRating Parameter Value greater than 50 volts. The string Value returned by ParameterValue is converted to a number for the comparison by the unit-aware StrToNumber function.

Summary

Converts the nominated Parameter Value string to a number, using the stipulated unit type.

Syntax

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

Example Usage

StrToNumber(ParameterValue('VoltageRating'),V)  >  50
Converts the Value string returned by the VoltageRating Parameter to a number, using Voltage (V) as the unit, then returns all objects with a Value greater than 50V.

StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Converts the Value string returned by the Resistance Parameter to a number, using Ohms as the unit, then returns all objects with a Value between 1kΩ and 10kΩ.

StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
Converts the Value string returned by the CapacitanceValue Parameter to a number, using Capacitance (F) as the unit, then returns all objects with a Value less than 2nF (2e-9 in scientific notation).

Notes

A scripting error will be thrown if the Value string cannot be converted to a number. To allow for this situation, use the StrToNumber function, which returns a nominated default number if the conversion fails.

The unit-aware string-to-number converter function accepts a large range of Unit type definitions, including:

• V – Voltage
• A – Current
• Ohm – Resistance
• Z – Impedance
• F – Capacitance
• H – Inductance
• G – Conductance
• W – Power
• Hz – Frequency
• Q – Charge
• C – Temperature
• dB – Decibels
• % – Percent
• m – Length
• Kg – Mass
• s – Time

The converter accepts standard value scaling factors (micro, kilo, mega, etc.,) and, therefore, Parameter strings containing prefix abbreviations such as mV, uA, kHz, etc.

Several value constructs are also supported. For example, the same resistance value can be represented as:

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

Summary

Converts the nominated Parameter Value string to a number, or a default number, using the stipulated unit type.

Syntax

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

Example Usage

StrToNumberDef(ParameterValue('VoltageRating'),V,10)  >  50
Converts the Value string returned by the VoltageRating Parameter to a number, using Voltage (V) as the unit, then returns all objects with a Value greater than 50V. If the Parameter string or unit is unrecognized (can't be converted), a default value of 10 is returned.

StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Converts the Value string returned by the VoltageRating Parameter to a number, using Voltage (V) as the unit, then returns all objects with a Value rating between 10V and 50V. If the value cannot be read, a voltage of 6V (the defined default value) is assumed.

Notes

The unit-aware string-to-number converter function accepts a large range of Unit type definitions, including:

• V – Voltage
• A – Current
• Ohm – Resistance
• Z – Impedance
• F – Capacitance
• H – Inductance
• G – Conductance
• W – Power
• Hz – Frequency
• Q – Charge
• C – Temperature
• dB – Decibels
• % – Percent
• m – Length
• Kg – Mass
• s – Time

The converter accepts standard value scaling factors (micro, kilo, mega, etc.,) and, therefore, Parameter strings containing prefix abbreviations such as mV, uA, kHz, etc.

Several value constructs are also supported. For example, the same resistance value can be represented as:

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