Altium NEXUS Documentation


Created: August 2, 2022 | Updated: August 2, 2022
This documentation page references Altium NEXUS/NEXUS Client (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer (with Altium Designer Enterprise Subscription) and a connected Altium 365 Workspace. Check out the FAQs page for more information.

Parent page: PCB Query Functions - Parameters


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


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).


A scripting error will be thrown if the Value string cannot be converted to a number. To allow for this situation, use the StrToNumberDef 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
Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
You are reporting an issue with the following selected text
and/or image within the active document: