Navigate to the main website

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Contact us here if you need more help.
  • Home
  • VTube Technical Articles
  • VTube Reports

List of Report Template HTML Tokens

Use these HTML tokens in report templates to enhance your ability to create dynamic reports.

Written by Michael Cone

Updated at April 11th, 2026

Article Link Copied!

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • VTube Update Articles
  • VTube Technical Articles
    VTube General (STEP and LASER) VTube Reports VTube-LASER VTube Configuration and Maintenance VTube-STEP VTube Installation SOLIDWORKS Configuration VTube Cloud License Server VTube Communications
  • Downloadable Resources
  • VTube Videos
  • Measuring Devices
    HEXAGON Articulated Arms Metronor
  • Utility Software
  • Partners
  • Benderlink Hardware
  • Bending Terminology
  • Benderlink Software
  • Benderlink Update Articles
  • CNC Bender ProControl
  • Bender to XYZ
  • General Software Topics
  • Windows Technical Articles
    Cable Specs
  • TubeCAD
+ More

Table of Contents

PRELIMINARY DEFINITIONS LIST OF VTUBE TOKENS

PRELIMINARY DEFINITIONS

WHAT IS A TOKEN? A "token" is a pre-defined word that VTube replaces with a value to show the current value in a report.

In VTube report templates, the tag <vtube_val> will be followed by a token word like "diameter". When VTube finds DIAMETER between the <vtube_val> tags, it will replace the "diameter" word with an actual diameter value, like "3.000." See the example below.

WHAT IS A TAG? A "tag" is text that HTML uses to control formatting. Tags are enclosed in corner brackets < and >. So, <vtube_val> is an HTML tag that we created for VTube report templates.)

WHAT IS A REPORT TEMPLATE? A report template is an HTML file that contains HTML formatting tags to control how a VTube report looks.

VTube's templates always include tokens that tell VTube where to put values in the report. For example, this is a one-line report template:

<vtube_val>diameter</vtube_val>

The above text in a CSV report will create this output if the diameter is 3" in the current VTube project.

Tokens are case-insensitive. DIAMETER, diameter, and Diameter are all the same to VTube.

LIST OF VTUBE TOKENS

This is a list of available HTML tokens for VTube report templates.

Token Name Description of Values Printed
ab_length_master This token reports the Crow flight distance from endpoint A to endpoint B of the MASTER (Nominal) data.
ab_length_measured_before_trim This token reports the crow flight distance from endpoint A to endpoint B of the MEASURED part before applying the trim calculation.
ab-angledelta1 The AB length (crow-flight from end A to End B) always forms a vector. This value reports the angle difference between the MASTER AB and the MEASURED AB vector in degrees.
ab-angledelta2 The AB length (crow-flight from end A to End B) always forms a vector. This value reports the angle difference between the MASTER AB and the MEASURED-ALIGNED AB vector in degrees.
ab-anglemaster This token reports the angle difference between the end A straight's vector and the end B straight's vector in a MASTER tube.
ab-anglemeasured This token reports the angle difference between the end A straight's vector and the end B straight's vector in a MEASURED tube.
ab-anglemeasuredaligned This token reports the angle difference between the end A straight's vector and the end B straight's vector in a MEASURED-ALIGNED tube.
ab-lendelta Changed to ab-len-master-measuredaligned-delta for clarity in 4.3 build 1619
ab-len-master-measuredaligned-delta This value reports the difference between the AB Master LENGTH and the AB MEASURED-ALIGNED Length.
ab-lenmaster This value reports the MASTER calculation for the length from End A to End B.
ab-lenmeasured This value reports the MEASURED calculation for the length from End A to End B.
AB-LenOOT This value reports the value that is Out Of Tolerance between the MASTER and MEASURED lengths from End A to End B.
AB-LenTolNeg The AB length (crow-flight from end A to end B) tolerance in the negative direction
AB-LenTolPos The AB length (crow-flight from end A to end B) tolerance in the positive direction
PassFail_Tangents_EndLengths_ABLength_EndAngles
 
This token reports if a measurement result passes or fails based on the tangents, end lengths, and AB lengths attributes.
 
PassFail_Tangents_EndLengths_ABLength
 
This token reports if a measurement passes or fails based on the tangents, end lengths, and AB lengths.

 
a_end_length_adjustment
 
This token reports the End "A" length adjustment. The adjustment dynamically adds material to the tube end without moving the endpoint. This token alters both the MASTER and MEASURED length.
 
a-endangledifference This value reports the end A angle difference between MASTER and MEASURED
a-endangledifferencetolerance This value reports the tolerance for the end A angle difference between MASTER and MEASURED
a-endlengthdifference This value reports the A end length difference between MASTER and MEASURED
a-endlengthdifferencetolerance This value reports tolerance for the A end length difference between MASTER and MEASURED
a-endlengthdifferencetoleranceneg This value reports tolerance for the A end length difference between MASTER and MEASURED in the negative direction
a-endlengthdifferencetolerancepos This value reports tolerance for the A end length difference between MASTER and MEASURED in the positive direction
aendoffset This token shows the A-End Offset for the MEASURED tube. If a user needed to extend the end of a tube for a scan, they could enter the value of the extension so VTube-LASER knew it was measuring something longer than the end of the tube, but would know the length and be able to push back the measurement to the actual end of the tube.
A-EndOffset This token shows the T1 dev value for the first straight in a project. This value can also be found in the Inspection Data window under Tan/Mid
EndTrimProfileReport_EndA
 
This token shows a user information about the end trim data for end A. Information included is:
Tube Data Source 
End Trim Profile Cloud Count
Solutions Found
End Trim Profile Cloud Data
 
EndADiameter
 

The diameter of End A. This can vary between the end and the rest of the tube

EndA_TolT1
 
This token reflects the tolerance used for end A. By changing the default tolerance, the "A" Offset value will change. 
 
b-endangledifference
 
This value reports the end B angle difference between MASTER and MEASURED 
 
b_end_length_adjustment
 
This token alters both the MASTER and MEASURED B length. This token reports the End "B" length adjustment. The adjustment dynamically adds material to the tube end without moving the endpoint.
 
b-endangledifferencetolerance
 
This value reports the tolerance for the end B angle difference between MASTER and MEASURED
 
b-endlengthdifference
 
This value reports the B end length difference between MASTER and MEASURED 
 
b-endlengthdifferencetolerance
 
This value reports tolerance for the B end length difference between MASTER and MEASURED 
 
b-endlengthdifferencetoleranceneg
 
This value reports tolerance for the B end length difference between MASTER and MEASURED in the negative direction
 
b-endlengthdifferencetolerancepos
 
This value reports tolerance for the B end length difference between MASTER and MEASURED in the positive direction
 
bendoffset
 
This token shows the B-End Offset for the MEASURED tube. If a user needed to extend the end of a tube for a scan, they could enter the value of the extension so VTube-LASER knew it was measuring something longer than the end of the tube, but would know the length and be able to push back the measurement to the actual end of the tube. 
 
B-EndOffset
 
This token shows the T2 dev value for the last straight in a project. This value can also be found in the Inspection Data window under Tan/Mid
 
EndTrimProfileReport_EndB

 
This token shows a user information about the end trim data for end B. Information included is:
Tube Data Source 
End Trim Profile Cloud Count
Solutions Found
End Trim Profile Cloud Data
 
EndBDiameter
 

The diameter of End B. This can vary between the end and the rest of the tube

EndB_TolT2
 
This token reflects the tolerance used for end B. By changing the default tolerance, the "B" Offset value will change. 
 
alignment-plp-linepoint1-coordinate This token shows the coordinates of Line Point 1 in the PLP alignment
alignment-plp-linepoint1-setup This token shows the setup for Line Point 1. Ex: Straight1-End1 (S1-End 1)
alignment-plp-linepoint2-coordinate This token shows the coordinates of Line Point 2 in the PLP alignment
alignment-plp-linepoint2-setup This token shows the setup for Line Point 2.
Alignment-PLP-PlanePoint1-Coordinate This token shows the coordinates of Plane Point 1 in the PLP alignment
Alignment-PLP-PlanePoint1-Setup This token shows the setup for Plane Point 1.
alignment-plp-planepoint2-coordinate This token shows the coordinates of Plane Point 2 in the PLP alignment
alignment-plp-planepoint2-setup This token shows the setup for Plane Point 2.
alignment-plp-planepoint3-coordinate This token shows the coordinates of Plane Point 3 in the PLP alignment
alignment-plp-planepoint3-setup This token shows the setup for Plane Point 3.
alignment-plp-translationpoint-coordinate This token shows the coordinates of the Translation point in the PLP alignment
alignment-plp-translationpoint-setup This token shows the setup for the Translation Point.
alignment-type

The token shows the type of alignment used to compare MEASURED to MASTER data.

AmbientTemperature Ambient Temperature of the environment in which the arm is located
armaccuracyspec The specs of the arm to determine accuracy
armcalibrationdate The last date the arm was calibrated.
armcertificationdate The last date the arm was certified.
armserialnumber The serial number of the arm
array_a The value for the MASTER angle (L)
array_a_fullspringback This token shows the angle (A) values of the MASTER tube with Springback taken into account. If there is no springback in the project, the values will be the same as the MASTER tube data.
array_l_fullspringback
 
This token shows the length (L) values of the MASTER tube with Springback taken into account. If there is no springback in the project, the values will be the same as the MASTER tube data. 
 
fixedspringback
 
This token shows the fixed springback in degrees used in a project
Springback = [(Bend Angle x Proportional %) + Fixed]
 
proportionalspringback
 
This token shows the proportional spring back used in a project shown in percentages. 
Springback = [(Bend Angle x Proportional %) + Fixed]
 
array_a_unbent This token reflects the Angle (A) in an Unbent tube. This value should be 0 since when a tube is unbent there is no rotation or angle.
array_l_unbent
 
The value for the master UNBENT lengths. This should be the only value in an unbent tube report since there should be no rotation or angle values
 
array_r_unbent
 
This token shows all the unbent rotations for the MASTER LRA table. This value should be 0 since there are no rotation or angle values for an unbent tube. 
 
array_r_unbent_cwpos
 
This token shows the rotation of an unbent tube in the CLOCKWISE positive direction. This should be 0 because there is no rotation value in an unbent tube. 
 
array_radius_lra_unbent
 
This token shows the radius associated with each row of the unbent MASTER LRA data
 
array_radius_xyz_unbent
 
This token shows the radius for each row of the MASTER XYZ table in the unbent orientation
 
array_x_unbent
 
This token shows all of the X values for an unbent tube. These will be the same X values as a bent tube. 
 
array_y_unbent
 
This token shows all of the Y values for an unbent tube. These will be the same Y values as a bent tube. 
 
array_z_unbent
 
This token shows all of the Z values for an unbent tube. These are the same Z values as a bent tube. 
 
array_abender_plus_adjustments This token shows the angle (A) values that are currently in the Bender Setup page plus the adjustments (The orange columns) These values will change with each recall.
array_abendersetup This token shows the angle (A) values that are currently in the Bender Setup page in the blue columns. These values will change with each recall (if the blue columns change).
array_aerr This token reports the angle (A) error. This value will be the opposite of the correction values. Example: If VTube is reporting a 0.5-degree angle correction, the error will be -0.5.
array_lerr
 
This token reports the length (L) error. This value will be the opposite of the correction values. Example: If VTube reports a 1-inch correction, the error will be "-1".
 
array_rerr
 
This token reports the rotation (R) error. This value will be the opposite of the correction values. Example: If VTube is reporting a 0.5-degree rotation correction, the error will be -0.5.
 
array_rerr_cwpos
 
The rotation error of a measured tube in a Clockwise positive rotation setup.
 
array_rbender_plus_adjustments_cwpos
 
This token shows the rotation (R) values, in a clockwise positive direction, that are currently in the Bender Setup page plus the adjustments (The orange columns) These values will change with each recall.
 
array_rbendersetup_cwpos
 
This token shows the rotation (R) values, in a clockwise positive direction, that are currently in the Bender Setup page in the blue columns. These values will change with each recall (if the blue columns change).
 
array_rcor_cwpos
 
This token shows the correction values for the rotations (R) in a clockwise direction in a project.
 
array_rmeas_cwpos
 
This token shows the rotation (R) values for each row in the MEASURED LRA table in a CLOCKWISE positive direction.
 
array_r_360cwpos
 
The 360cwpos token allows a user to look at the CLOCKWISE rotation in a 360-degree rotation method for each bend. 
 
array_ameas
 
This token shows all MEASURED angle values (A) 
 
array_aligned_straight_vector_x
 
Insert the X value of an aligned straight's vector.
 
array_aligned_straight_vector_y Insert the Y value of an aligned straight's vector.
array_aligned_straight_vector_z Insert the Z value of an aligned straight's vector.
 
array_master_straight_vector_x

 
Insert the X value of a MASTER straight's vector.
 
array_master_straight_vector_y

 
Insert the Y value of a MASTER straight's vector.

 
array_master_straight_vector_z

 
Insert the Z value of a MASTER straight's vector.

 
array_measured_straight_vector_x

 
Insert the X value of a measured straight's vector.
 
array_measured_straight_vector_y
 
Insert the Y value of a measured straight's vector.

 
array_measured_straight_vector_z
 
Insert the Z value of a measured straight's vector.

 
array_aligned_straight_Zintercept_x
 
Insert the X value for the aligned straight's Z intercept (XY plane).
 
array_aligned_straight_Zintercept_y
 
Insert the Y value for the aligned straight's Z intercept (XY plane).
 
array_master_straight_Zintercept_x

 
Insert the X value for the master straight's Z intercept (XY plane).
 
array_master_straight_Zintercept_y

 
Insert the Y value for the master straight's Z intercept (XY plane).

 
array_measured_straight_Zintercept_x

 
Insert the X value for the measured straight's Z intercept (XY plane).

 
array_measured_straight_Zintercept_y

 
Insert the Y value for the measured straight's Z intercept (XY plane).

 
array_aligned_tan_x1 This token reports all of the tangent 1 values in the X axis for the ALIGNED tube
array_aligned_tan_x2 This token reports all of the tangent 2 values in the X axis for the ALIGNED tube
array_master_tan_x1
 
This token reports all of the tangent 1 values in the X axis for the MASTER tube 
 
array_master_tan_x2
 
This token reports all of the tangent 2 values in the X axis for the MASTER tube 
 
array_measured_tan_x1
 
This token reports all of the tangent 1 values in the X axis for the MEASURED tube.
 
array_measured_tan_x2
 
This token reports all of the tangent 2 values in the X axis for the MEASURED tube
 
array_aligned_tan_y1 This token reports all of the tangent 1 values in the Y axis for the ALIGNED tube
array_aligned_tan_y2 This token reports all of the tangent 2 values in the Y axis for the ALIGNED tube
array_master_tan_y1
 
This token reports all of the tangent 1 values in the Y axis for the MASTER tube
 
array_master_tan_y2
 
This token reports all of the tangent 2 values in the Y axis for the MASTER tube
 
array_measured_tan_y1
 
This token reports all of the tangent 1 values in the Y axis for the MEASURED tube.
 
array_measured_tan_y2
 
This token reports all of the tangent 2 values in the Y axis for the MEASURED tube.
 
array_aligned_tan_z1 This token reports all of the tangent 1 values in the Z axis for the ALIGNED tube
array_aligned_tan_z2 This token reports all of the tangent 2 values in the Z axis for the ALIGNED tube
array_master_tan_z1
 
This token reports all of the tangent 1 values in the Z axis for the MASTER tube
 
array_master_tan_z2
 
This token reports all of the tangent 2 values in the Z axis for the MASTER tube
 
array_measured_tan_z1
 
This token reports all of the tangent 1 values in the Z axis for the MEASURED tub.e
 
array_measured_tan_z2
 
This token reports all of the tangent 2 values in the Z axis for the MEASURED tube.
 
array_arclength Report the arc length for each angle in a bent tube.
array_dev_tmt_average This token shows the average of all the deviations between tangent 1, midpoint and tangent 2 (tmt). This will show the average deviation value for each straight in a project.
array_bend_straightness_nominal This token will show the straightness value for the MASTER bend data. Combine this array value with the BENDNUMBER count in an array section.
array_bend_straightness_measured This token will show the straightness value for the MEASURED bend data. Combine this array value with the BENDNUMBER count in an array section.
array_dev_tmt_maximum This token shows the maximum tangent point deviation in any straight. If, for straight 1, T1 dev is larger than T2 dev, then the value returned is T1 dev.
 
array_devmp This token shows the deviation of the Midpoint (middle of a straight) for all straights in a project
array_devt1 This token shows the deviation of tangent 1 (beginning of the straight) for all straights in a project
array_devt2 This token shows the deviation of tangent 2 (end of the straight) for all straights in a project
array_dofbend_lra  
array_DrillBitBoss_AngleToFirstBendPlane_OrientationBendPlaneToBoss The Angle of a hole to the first bend plane, in the orientation of the bend plane to the hole
array_DrillBitBoss_AngleToFirstBendPlane_OrientationBossToBendPlane The Angle of a hole to the first bend plane, in the orientation of the bend plane to the plane the hole is on.
array_DrillBitBoss_AngleToFirstDrillBitBoss_OrientationCurrentBossToFirstBoss The Angle of the first hole to the first bend plane, in the orientation of the selected hole to the first hole
array_DrillBitBoss_AngleToFirstDrillBitBoss_OrientationFirstBossToCurrentBoss The Angle of the first hole to the first bend plane, in the orientation of the first hole to the selected hole.
array_DrillBitBoss_AngleToNextBendPlane_OrientationBendPlaneToBoss The Angle of a hole to the next bend plane, in the orientation of the bend plane to the hole.
array_DrillBitBoss_AngleToNextBendPlane_OrientationBossToBendPlane The Angle of a hole to the next bend plane, in the orientation of the hole to the bend plane.
array_DrillBitBoss_AngleToPreviousBendPlane_OrientationBendPlaneToBoss The Angle of a hole to the previous bend plane, in the orientation of the plane to the hole.
array_DrillBitBoss_AngleToPreviousBendPlane_OrientationBossToBendPlane The Angle of a hole to the previous bend plane, in the orientation of the hole to the plane.
array_DrillBitBoss_Diameter This token shows the diameter of the drill bit boss.
array_DrillBitBoss_Distance_ToEndA This token shows the length value of the center of a circle back to end A in an unbent tube.
array_DrillBitBoss_Distance_ToNextTangent The distance between a hole and the next tangent point
array_DrillBitBoss_Distance_ToPreviousTangent The distance between a hole and the previous tangent point.
array_end2tan The value of two lengths + the arc length. 
Example: Straight 1 = 10.057 + Straight 2 = 10.271 + Arc Length = 3.200 Total = 23.527
array_GDT_Straight_OD_Measured_Value_Of_Position
 
This displays the GD&T straight's OD measured values of position. The measured value of position is like a tangent envelope deviation - except that it always double the tangent envelope value.

Also, GD&T only requires one measured position per straight, so the largest value of the two tangents is returned in this token.

In the GD&T grid, both T1 and T2 positions have unique tolerances, so the position tolerance used for qualification is always whichever of the two tangents has the larger value.
 
array_index This token shows the number of straights in a particular project on a report
array_intersectionlengths_delta This token shows the delta/deviation between the MASTER and MEASURED intersection lengths
array_intersectionlengths_master This token shows all MASTER intersection lengths
array_intersectionlengths_measured This token shows all MEASURED intersection lengths
array_l The token for all MASTER length values (L).
array_lbender_plus_adjustments This token shows the length (L) values that are currently in the Bender Setup page plus the adjustments (The orange columns) These values will change with each recall.
array_lbendersetup This token shows the length (L) values that are currently in the Bender Setup page in the blue columns. These values will change with each recall (if the blue columns change).
array_rcor
 
This token shows the correction values for the rotations (R) in a counterclockwise direction in a project. 
 
array_acor
 
This token shows the correction values for the angles (A) in a project.
 
array_lcor This token shows the correction values for the lengths (L) in a project.
array_lcor_absolute This token shows the length (L) correction values for absolute bending projects.
array_rcor_absolute
 
This token shows the correction values for the rotations (R) in an absolute rotation direction. The dial on an absolute rotation spindle reads from 0-360 in a clockwise direction. 
 
array_length_master_conrac_compressionbend This token shows the MASTER length (C) distance for COMPRESSION bending.
array_length_master_conrac_drawbend This token shows the distance (C) values in an absolute or draw bending scenario for a MASTER tube. This value will always start with the largest value for bend 1 and get smaller further down the print. Example: If a the total tube cut length is 20", the first length value may be 18" then 15" then 12". The numbers will always decrease.
array_length_measured_conrac_drawbend This token shows the distance (C) values in an absolute or draw bending scenario for a MEASURED tube. This value will always start with the largest value for bend 1 and get smaller further down the print. Example: If a the total tube cut length is 20", the first length value may be 18" then 15" then 12". The numbers will always decrease.
array_lmeas The token for all MEASURED length values (L).
array_LRAdeviation_Aoot This token shows a user whether or not an angle is Out Of Tolerance based on a set angle tolerance. This angle degree tolerance can be set in Inspection Data under Data > Bender Data 
 
array_LRAdeviation_Ldeviation This token shows the length deviation between the MEASURED and MASTER tubes.
array_LRAdeviation_Loot This token shows a user whether or not a length is Out Of Tolerance. This length tolerance can be set in Inspection Data under Data > Bender Data
array_LRAdeviation_LTol This token shows the tolerance being used to qualify the length of measured tubes.
array_LRAdeviation_Rdeviation This token shows the rotation deviation between the MEASURED and MASTER tubes.
array_LRAdeviation_Root This token shows a user whether or not a rotation is Out Of Tolerance. This rotation tolerance can be set in Inspection Data under Data > Bender Data
array_LRAdeviation_RTol Insert the tolerance being used to qualify the rotation of measured tubes.
array_master_dbb_plus_arclen The master length plus the arc length. Example: Straight 1 = 10.057 + Arc Length = 3.200 Total = 13.257
array_master_tangent_distance This reports the distance between tangents of the MASTER tube.
array_measuredstraight_cylindricity This token shows the MEASURED straight cylindricity value. Cylindricity is the difference between the high and the low surface points relative to the cylinder centerline.
array_measuredstraight_cylindricity_score This token shows a user whether a measured cylinder's cylindricity is considered passing or whether the scan was a 'good' scan based on the tolerances set by the user. Anything below 100% is not considered 'good,' and the user may want to re-scan the tube.
array_measuredstraight_dcfuncertainty This token shows a user the Dual Cylinder Fit uncertainty fit of a scan. The DCF calculation divides the surface data into two groups, then calculates the cylinder data and intersection points twice to verify low absolute uncertainty. This token reports that number.
array_measuredstraight_dcfuncertainty_score This token shows a user whether a MEASURED cylinder was a 'good' scan or not based on the tolerances set by the user. This token is specifically looking at the DCF. Dual Cylinder Fit. Anything below 100% is not considered 'good' and the user may want to re-scan the tube.
array_measuredstraight_diameter This token shows the diameter of all measured straights.
array_measuredstraight_nearpassdeviation This token shows the Near Pass deviation on a measured tube. VTube calculates the Nearest Pass distance when finding 3-D intersections between two straights. This token reports the deviations. The default is .098in
array_measuredstraight_nearpassdeviation_score This token reports back to the user a score based on the Near Pass deviation so they can decide weather or not the scan was a quality scan or not.
array_measuredstraight_ovalitypercentage This token shows the ovality percentage found on a measured tube straight
array_measuredstraight_ovalitypercentage_score This token reports back to the user a score based on the ovality percentage deviation so they can decide weather or not the scan was a quality scan or not.
array_measuredstraight_wobbledeviation This token shows the wobble deviation. Wobble is a statistical prediction by the math engine regarding how confident it is for the cylinder centerline calculation from the surface points.
array_measuredstraight_wobbledeviation_score This token reports back to the user a score based on the wobble deviation so they can decide weather or not the scan was a quality scan or not.
array_midpoint_x This token reports all of the midpoint values in the X axis for the MASTER tube
array_midpoint_xfit This token reports all of the midpoint values in the X axis for the ALIGNED tube
array_midpoint_xmeas This token reports all of the midpoint values in the X axis for the MEASURED tube
array_midpoint_y This token reports all of the midpoint values in the Y axis for the MASTER tube
array_midpoint_yfit This token reports all of the midpoint values in the Y axis for the ALIGNED tube
array_midpoint_ymeas This token reports all of the midpoint values in the Y axis for the MEASURED tube
array_midpoint_z This token reports all of the midpoint values in the Z axis for the MASTER tube
array_midpoint_zfit This token reports all of the midpoint values in the Z axis for the ALIGNED tube
array_midpoint_zmeas This token reports all of the midpoint values in the Z axis for the MEASURED tube
array_mp_oot This token shows the out of tolerance values for the midpoints of all straights in a project.
array_notelist This token will show all the notes listed in a project. These notes can be added in the Part Setup menu under the Notes List tab
array_point_label

This token is for the MASTER point labels on the tube in the viewport. 

array_point_label_measured This token is for the MEASURED point labels on the tube in the viewport.
array_postarc_accumulated_master This token shows the user the current arc length plus the straight length for straight 1. For straight 2, the value = arc length + straight length + next straight length + next arc length.
array_postlength_accumulated_from_other_end_master  
array_postlength_accumulated_master This token shows the user the current length plus the previous length plus the arc length. Example: Straight #2 is 2.33", straight #1 is 2", the arc length is 1.571 so the Accum value is 5.914
array_r This token shows the rotation (R) values for each row in the MASTER LRA table.
array_radius_lra This token shows the radius associated with each row of the MASTER LRA data
array_radius_lra_bendersetup This token shows the radius values that are currently in the Bender Setup page in the last column. These values will change with each recall (if the value was to change)
array_radius_lrameas This token shows the radius associated with each row of the MEASURED LRA data
array_radius_xyz The radius values associated with each row of the XYZ table. If the radius values are not the same for each row, this token will reflect that.
array_radius_xyzdev  
array_radius_xyzfit This token shows the user the Measured Aligned XYZ radius values. If the radius is not measured, they will default to the nominal values. If they are measured, they will be linked to the correct radius in the Measured Aligned tube section on the report.
array_radius_xyzmeas This token shows the user the Measured XYZ radius values. If the radius is not measured, they will default to the nominal values. If they are measured, they will be linked to the correct radius in the Measured tube section on the report.
array_radiusqualificaiton_bendprofile_measure_type The bend profile measure type tells the user which type of measurement was taken. The options are "Inside Only", "Inside/Outside", "Four Sides", and "Outside Only"
array_radiusqualificaiton_bendprofile_measured_yes_no This token will let a user know right away if a bend was measured or not. YES if it was measured and NO if it was not measured.
array_radiusqualification_bendprofile_envelope_in_out This lets the user know right away if the measured bend profile is within their allowed tolerance they are using. IN if the bend is within tolerance and OUT if it is above the allowed tolerance.
array_radiusqualification_bendprofile_envelope_tolerance This shows the user what the tolerance is for the bend profile. This value can be adjusted in Inspection Data under Data > Bend Profiles > Envelope > Default Tolerance
array_radiusqualification_clr This shows the MEASURED center line of the radius of a tube.
array_radiusqualification_clr_deviation This shows the DEVIATION between the MASTER and MEASURED center line of the radius of a tube.
array_radiusqualification_clr_oot This shows how Out Of Tolerance the center line of a radius is between measured and master tubes.
array_radiusqualification_clr_tolerance This token dictates the tolerance allowed for the center line radius of a tube to determine weather or not the tube passes inspection.
array_radiusqualification_insideradius This token shows the measured inside radius of a bend.
array_radiusqualification_od_inplane_actual This token shows the MEASURED outside diameter of the bend profile in plane
array_radiusqualification_od_inplane_change  
array_radiusqualification_od_inplane_oot The Out Of Tolerance value for the bend radius Outside Diameter for In-Plane measures. MASTER -MEASURED - Tolerance = OOT
array_radiusqualification_od_inplane_tolerance The tolerance used to determine if the outside diameter of a bend radius is acceptable In-Plane
array_radiusqualification_od_nominal This token shows the MASTER outside diameter of the bend profile
array_radiusqualification_od_perpplane_actual This token shows the MEASURED outside diameter of the bend profile
array_radiusqualification_od_perpplane_change  
array_radiusqualification_od_perpplane_oot The out of tolerance of the diameter. Master OD - Measured OD - Tolerance
array_radiusqualification_od_perpplane_tolerance The tolerance used to determine whether or not the deviation between nominal and measured Diameter (OD) is acceptable.
array_radiusqualification_ovality_oot The Out Of Tolerance of bend profile ovality. Ovality - Tolerance
array_radiusqualification_ovality_percentage The bend profile ovality percentage ((Nominal OD - Minimum OD) / Nominal OD) x 100
array_radiusqualification_ovality_tolerance The tolerance used to determine whether or not the bend profile ovality is acceptable or not.
defaultradius
 
The radius used for all rows of XYZ and LRA data. If one row has a different value, a user will need to go in and identify that. 
 
array_radiusqualification_oor_oot
 
The Out Of Tolerance of bend profile ovality. Out Of Round- Tolerance

 
array_radiusqualification_oor_percentage

 
The bend profile out of round percentage ((2x (OD Perp - OD In-plane)) / (OD Perp + OD in-plane)) x 100

 
array_radiusqualification_oor_tolerance

 
Bend Profile Out Of Round tolerance used to determine whether or not the bend profile is in tolerance or not. 

 
array_rbender_plus_adjustments This token shows the rotation (R) values, in a counter clockwise positive direction, that are currently in the Bender Setup page plus the adjustments (The orange columns) These values will change with each recall.
array_rbendersetup This token shows the rotation (R) values, in a counter clockwise positive direction, that are currently in the Bender Setup page in the blue columns. These values will change with each recall (if the blue columns change).
array_rmeas This token shows the rotation (R) values for each row in the MEASURED LRA table.
array_rotation_master_conrac This token shows the rotation for the MASTER tube in a Clockwise or Counter Clockwise direction. This is referred to as the Turn Angle (E)
array_rotation_measured_conrac This token shows the rotation for the MEASURED tube in a Clockwise or Counter Clockwise direction. This is referred to as the Turn Angle (E)
Array_RotationDirection Insert the rotation directions used in a part. The values inside this array will be clockwise (CW) or counter clockwise (CCW) viewed from the front of the bender.
Array_RotationDirection_Measured The rotation (CW or CCW) of a measured tube.
array_SpaceObject_Metrics_Deviation_Value The list of deviation values for transformed Space Objects
array_SpaceObject_Untransformed_Metrics_Deviation_Value The list of deviation values for untransformed Space Objects
array_SpaceObject_Metrics_Measured_Value The list of measured values for transformed Space Objects
array_SpaceObject_Untransformed_Metrics_Measured_Value The list of measured values for untransformed Space Objects
array_SpaceObject_Untransformed_Metrics_NamesList The list of names for all the untransformed Space Object metrics.
array_SpaceObject_Metrics_NamesList The list of names for all the transformed Space Object metrics.
array_SpaceObject_Untransformed_Metrics_NamesList The list of names for all the untransformed Space Object metrics.
array_SpaceObject_Metrics_Nominal_Value The list of nominal values for all Space Objects
array_SpaceObject_Untransformed_Metrics_Nominal_Value The list of nominal values for all untransformed Space Objects
array_SpaceObject_Metrics_OOT_Value The list of Out Of Tolerance values for transformed Space Objects
array_SpaceObject_Untransformed_Metrics_OOT_Value The list of Out Of Tolerance values for untransformed Space Objects
array_SpaceObject_Metrics_Tolerance_Value The list of tolerance values for transformed Space Objects
array_SpaceObject_Untransformed_Metrics_Tolerance_Value The list of tolerance values for untransformed Space Objects
array_SpaceObject_Name The list of transformed Space Object names.
array_SpaceObject_Untransformed_Name The list of untransformed Space Object names.
array_t1_oot This token shows the out-of-toleranceout-of-tolerance value for tangent 1 (beginning of the straight) for all straights in a project
array_t2_oot This token shows the out of tolerance value for tangent 2 (end of the straight) for all straights in a project
array_tolmp This token shows the deviation of the midpoint (middle of the straight) for all straights in a project
array_tolt1 This token shows the tolerance of tangent 1 (beginning of the straight) for all straights in a project
array_tolt2 This token shows the tolerance of tangent 2 (end of the straight) for all straights in a project
array_tolXint The overall tolerance allowed for all X values.
array_tolXint_neg The negative tolerance allowed for all X values in a project
array_tolXint_pos The positive tolerance allowed for all X values in a project
array_tolYint The overall tolerance allowed for all Y values.
array_tolYint_neg The negative tolerance allowed for all Y values in a project
array_tolYint_pos The positive tolerance allowed for all Y values in a project
array_tolZint The overall tolerance allowed for all Z values.
array_tolZint_neg The negative tolerance allowed for all Z values in a project
array_tolZint_pos The positive tolerance allowed for all Z values in a project
array_x This token shows the X values for each row in the MASTER XYZ table.
array_x_aligned_todatum_aligned This shows distances to the X datum in the measured aligned part
array_x_aligned_todatum_master The value showing the deviation in the X column between the MASTER and ALIGNED tubes for the
array_x_master_todatum_master This shows distances to the X datum in the MASTER part
array_xdev The X deviation between the MEASURED and MASTER tubes.
array_xfit The measured values for the X column
array_xint_outtol This token shows how far out of tolerance the measured X values are in a project
array_xmeas This token shows all of the X values for a MEASURED tube.
array_xyz_int_dev This token shows the XYZ Intersection deviation for the GD&T Centerline data.
array_xyz_int_outtol This is the XYZ Intersection 3D OUT OF TOLERANCE value returned in an array of values. This is for a GD&T true position qualification of the intersection points in a tube shape. (Added on June 28, 2024)
array_xyz_int_tol This is the XYZ Intersection 3D Tolerance returned in an array of values. This is for a GD&T true position qualification of the intersection points in a tube shape.
array_y This token shows the Y values for each row in the MASTER XYZ table.
array_y_aligned_todatum_aligned This shows distances to the Y datum in the measured aligned part
array_y_aligned_todatum_master The value showing the deviation in the Y column between the MASTER and ALIGNED tubes for the
array_y_master_todatum_master This shows distances to the Y datum in the MASTER part
array_ydev The Y deviation between the MEASURED and MASTER tubes.
array_yfit The measured values for the Y column
array_yint_outtol This token shows how far out of tolerance the measured Y values are in a project
array_ymeas This token shows all of the Y values for a MEASURED tube.
array_z This token shows the Z values for each row in the MASTER XYZ table.
array_z_aligned_todatum_aligned This shows distances to the Z datum in the measured aligned part
array_z_aligned_todatum_master The value showing the deviation in the Z column between the MASTER and ALIGNED tubes for the
array_z_master_todatum_master This shows distances to the Z datum in the MASTER part
array_zdev The Z deviation between the MEASURED and MASTER tubes.
array_zfit The measured values for the Z column
array_zint_outtol This token shows how far out of tolerance the measured Z values are in a project
array_zmeas This token shows all of the Z values for a MEASURED tube.
author The author of the currently loaded project.
BenderNumber The number of the bender being used in conjunction with the currently loaded project. This is the number inside VTube not necessarily the number at the bender control. Some controls require they be the same and others do not.
bendertype The type of bender being utilized for the particular project loaded.
bends The number of bends associated with the project currently loaded.
calclengthmaster_with_elong This token shows the calculated length of the MASTER tube with elongation compensation.
calclengthmaster_without_elong This token shows the calculated length of the MASTER tube with no elongation compensation.
calclengthmastermeasureddelta_with_elong This token shows the calculated difference of the MASTER tube minus the MEASURED tube with elongation compensation.
calclengthmastermeasureddelta_without_elong This token shows the calculated difference of the MASTER tube minus the MEASURED tube with no elongation compensation.
calclengthmeasured_with_elong The calculated MEASURED tube length based on the parametric data from the most current scan with a pre established elongation percentage
calclengthmeasured_without_elong The calculated MEASURED tube length based on the parametric data from the most current scan without elongation
calctubeelongationpercentage_cutlength_measuredlength This token calculates the elongation percentage from the CUT length minus the MEASURED tube length
calctubeelongationpercentage_masterlength_measuredlength This token calculates the elongation percentage from the MASTER tube length minus the MEASURED tube length
tubeelongationpercentage
 
VTube-LASER can calculate Tube Elongation Percentage by subtracting the current CUT LENGTH from the MEASURED LENGTH - then calculate the percentage by comparing that change to the total ARC LENGTHS in the measured tube. 
(Measured Length - Cut Length) / (Arc Length Sum for Whole Tube) X 100
 
comment1

Comment 1 can be found in Part Setup. It allows users to enter multi-line notes. This comment, if used, it is displayed at every VTube project load.

comment2 Comment 2 can be found in Part Setup. It allows users to enter multi-line notes. This comment, if used, it is displayed at every VTube project load.
customer The customer associated with the project currently loaded.
CustomField_Name1 The custom field tokens allow users to customize what they see in the equivalent of a Part Setup grid. Users can fill in the name and values individually and specifically for each project. This token allows a user to type in the field name for slot 1
CustomField_Name2 This token allows a user to type in the field name for slot 2. See CustomField_Name1
CustomField_Name3 This token allows a user to type in the field name for slot 3. See CustomField_Name1
CustomField_Name4 This token allows a user to type in the field name for slot 4. See CustomField_Name1
CustomField_Name5 This token allows a user to type in the field name for slot 5. See CustomField_Name1
CustomField_Value1 This token allows a user to type in the value related to field name 1.
CustomField_Value2 This token allows a user to type in the value related to field name 2
CustomField_Value3 This token allows a user to type in the value related to field name 3
CustomField_Value4 This token allows a user to type in the value related to field name 4
CustomField_Value5 This token allows a user to type in the value related to field name 5
cutlength

Cut length of the tube is determined by the parametric data of the tube. This can be altered based on the option selected in the drop down in row 27 in Part Setup. 
1- If the drop-down is "Disabled" then VTube will allow an operator to manually change the cut length if so desired 
2- If the drop-down is "ON Nominal" then VTube will always calculate the cut length based on the LRA data
3- If the drop down is "ON + Elong Comp" then VTube will include the elongation percentage that would be entered in row 37.

cylinder_fit_score

This is the token for Wobble, Cylindricity, OOR, Ovality, Near Pass, and DCF 

date This token displays the date of date the project was created
datetime This token displays the date and time the project was scanned
datum-coordinate This token displays the origin point (first row) of the MASTER XYX grid unless otherwise specified.
datum-setup

This is usually Straight 1 End 1 (S1-End 1) unless changed with the Point Selector inside the Datum Tab under Master Tube.

defaulttolerance The default tolerance chosen by a user for the shape of the tube based on Tan/Mid data.
diameter Diameter of the tube currently loaded.
DiameterCutPlane_ActiveYesNo_Now Report if the Diameter Cut Plane is currently active.
DiameterCutPlane_LaserLength_Now
 
Report the current Diameter Cut Plane laser line length.
 
DiameterCutPlane_ActiveYesNo_DuringMeasure_TubeStraights
 
Report if the Diameter Cut Plane was active during the last measure for tube straights.
 
DiameterCutPlane_LaserLength_DuringMeasure_TubeStraights
 
Report the Diameter Cut Plane laser line length during the last tube straight measure.
 
DofBend1

Degree of Bend D of bend = Centerline Radius / OD.
With the example of a 3in diameter tube, the DofBend with a 1", 2" and 3" radius is shown below.

DofBend2 Each project can have multiple radii. See DofBend1
DofBend3 See DofBend1
InnerDiameter This token is for the inner diameter of the tube (ID)
jobnumber The job number associated with the project currently loaded.
laser2sigmaerror The standard deviation of the laser error
lasercalibrationdate The last date the laser was calibrated
lasermaxerror The maximum laser error identified by the scanning arm
last_measurexyz_creation_datetime This token links the current date and time with the most recent MEASURED data
LinearUnitAbreviatedCapitalized This token shows which linear unit is being used as I or M for Imperial (inches) or Metric (millimeters)
materialspec The specification of the material being used for the current project loaded
measurexyz_note  
NPS Token for the Nominal Pipe Sizes. Double click the NPS rows to select a value or go to System Options > Global Level Lists > Edit Valid Tube and Pipe Size Selection Table to add, remove or edit current setups.
NPSCLR Nominal Pipe Size center line radius
NPSDofBend Nominal Pipe Size degree of bend D of bend = Centerline Radius / OD.
OORCalc_Measured_OD_Average This token shows the Measured OD Average of all OD scans
OORCalc_Measured_OD_High This token shows the Measured OD HIGH of all OD scans
OORCalc_Measured_OD_Low This token shows the Measured OD LOW of all OD scans
OORCalc_Measured_OD_OORPercentage This token shows the Measured OD Out Of Round percentage
OORCalc_Measured_OD_OvalityPercentage This token shows the Measured OD Ovality percentage of a tube being measured.
OORCalc_Surface_Cylindricity This token shows a tubes surface cylindricity in Inches or Millimeters.
OORCalc_Surface_HighPoint_Distance This token shows the highest point on a cylinder surface in Inches or Millimeters.
OORCalc_Surface_LowPoint_Distance This token shows the lowest point on a cylinder surface in Inches or Millimeters.
OORCalc_Surface_OOR_Percentage This token shows the Out Of Round percentage based on the high and low points on a surface
OORCalc_Surface_Ovality_Percentage This token shows the Ovality percentage based on the high and low points on a surface
array_bendprofile_oor_calcnote
 
 
array_bendprofile_oor_distance
 
 
array_bendprofile_oor_od
 
The out-of-round for an outside diameter of a bend profile.
 
array_bendprofile_oor_percentage
 
This token shows the out-of-round percentage for a bend profile scan.
 
array_bendprofile_oor_percentagetolerance
 
This token shows the tolerance being used to decide the out-of-round percentage. 
 
array_bendprofile_oor_separationangle
 
 
array_bendprofile_oor_sliceangle
 
 
array_bendprofile_oor_slicename
 
 
array_bendprofile_oor_span1
 
 
array_bendprofile_oor_span2
 
 
array_bendprofile_oor_surfacepointcount_in_width_region
 
 
array_measuredstraight_oorpercentage
 
This token shows the OUT OF ROUND percentage on a cylinder of a measured straight. The default is 8%
 
array_measuredstraight_oorpercentage_score
 
This token reports back to the user a score based on the out of round deviation so they can decide weather or not the scan was a quality scan or not. 
 
organization The organization associated with the project currently loaded. This is determined by the user or company using VTube.
partname The Part Name used alongside the Part Number used to distinguish parts from each other.
partnumber The Part Number used to distinguish parts from each other.
PassFail_QualifierAttributes_Result This token shows a user weather or not a scan passed or failed based on the pre-selected attributes
PassFail_QualifierAttributes_Setup This token shows the list of pre-selected qualification attributes.
points The number of XYZ points.
probe2sigmaerror The standard deviation of the probe error
probecalibrationdate The last date a probe was calibrated
probediameter The diameter of the probe being used for the project currently loaded in.
probemaxerror The maximum error that the probe identified
probename The name of the probe currently being used.
rec_alignment_angle The twist/angle of the rectangular/square legs
rec_fillet_radius This token is used to show the value of the fillet radius in a square/rectangular tube. The larger the fillet radius, the less sharp the angle
rec_wall_thickness The wall thickness of the rectangular tube currently loaded.
rec_width_1 The first width used to determine the sizing of a square/rectangular tube.
rec_width_2 The second width used to determine the sizing of a square/rectangular tube
revision The revision value used for the project currently loaded
straights The number of straights in the project currently loaded
supplier The supplier of materials or information of the project currently loaded
 
unit

The unit being used for a project. Imperial or Metric (I) (M)

viewport_image The blue viewport that shows the image of the project currently loaded.
wall The wall thickness of the tube currently loaded.
workorder The work order value of the project currently loaded.
x-span-aligned This token reflects the span of X in the MEASURED ALIGNED tube
x-span-master This token reflects the span of X in the MASTER tube
x-span-measured This token reflects the span of X in the MEASURED tube
y-span-aligned This token reflects the span of Y in the MEASURED ALIGNED tube
y-span-master This token reflects the span of Y in the MASTER tube
y-span-measured This token reflects the span of Y in the MEASURED tube
z-span-aligned This token reflects the span of Z in the MEASURED ALIGNED tube
z-span-master This token reflects the span of Z in the MASTER tube
z-span-measured This token reflects the span of Z in the MEASURED tube
report templates token

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • How to Import Report Templates Into VTube
  • How to Enter XYZ into VTube
  • VTube to SOLIDWORKS Tube Layout Builder
  • List of VTube HTML Value Tags

Copyright 2026 – Advanced Tubular Technologies.

Knowledge Base Software powered by Helpjuice

Expand