Search In: Doc:Documentation: Altium Designer
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerAltium CircuitMakerAltium CircuitStudioCompany DashboardAltium Infrastructure Server
Ver: Version: 19
2120.220.120.019.119.018.118.017.117.016.116.015.1
Close
Search Search on Documentation
Documentation Altium Designer Documentation ... PCB Query Functions Attribute Checks

TraceLength

Created: September 12, 2015 | Updated: August 10, 2021 | Applies to versions: 15.1, 16.0, 16.1, 17.0, 17.1, 18.0, 18.1, 19.0, 19.1, 20.0, 20.1 and 20.2
Now reading version 19. For the latest, read: TraceLength for version 21

Parent page: PCB Query Functions - Attribute Checks

Summary

Returns arc and track objects on signal layers, whose length complies with the Query.

The length of each track is the (Pythagorean) distance between its endpoints and is equal to SQRT(SQR(X1 - X2) + SQR(Y1 - Y2)), where X1, Y1 are the coordinates of one end of the track, and X2, Y2 are the coordinates of its other end. The length of each arc is the product of its Radius and the difference between its End Angle and Start Angle, when that difference is measured in units of radians. (180 degrees = pi radians.)

Syntax

TraceLength : Number

The entered length is always in units of mils, irrespective of the measurement unit chosen for the board. (1 mil = 0.001 inch). To target an object using metric measurements, use the AsMM query keyword, for example, AsMM(Width) < 1.5 or, AsMM(Width) Between 1 And 1.2. Learn more about AsMM.

Example Usage

TraceLength Between 400 And 1800
Returns all arc and track objects that have a length between 400mil and 1800mil (inclusive).

TraceLength > 300
Returns all arc and track objects that have a length that is greater than 300mil.

IsTrack AND OnTopLayer AND (AsMM(TraceLength) < 1)
Returns all track objects that are on the Top Layer and have a length less than 1mm.

Note - due to an issue in the software, to correctly detect a TraceLength using the AsMM keyword or the AsMils keyword, the board units must be set to imperial before running the query.

 

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Note

The features available depend on your Altium product access level. Compare features included in the various levels of Altium Designer Software Subscription and functionality delivered through applications provided by the Altium 365 platform.

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.