Label Points Command

D_LabelPoints_64px    Label Points


Command Licensing and Default Menu Location

  • The Label Points command is part of the RPS Modeling Toolbox
  • The command is located on the Modeling Toolbox menu ribbon
  • The command is located in the Drafting menu group


Command Description

This command provides additional drafting capabilities to label point stations, offsets and cut/fill values to selected reference linestrings, alignments and / or surface models


Command Interface Description

The Label Points command dialog looks as follows

Select points:
Select the points that you want to label

Reference line:
Select the linestring or alignment that you wish to use as your reference for station, offset and elevation. Note that elevation reference can come from either a line or a surface model. The color coding of the labels will be determined as follow based on the selections of reference surface and / or reference line options

  • Reference Surface Only: Cut / Fill label colors are determined by the point to surface comparison
  • Reference Line Only: Cut / Fill label colors are determined by the point to line comparison
  • Reference Surface and Reference Line: Cut / Fill label colors are determined by the point to surface comparison.

Show line direction checkbox:
Check the checkbox to display the line direction indicators so that you can determine left and right references to the selected reference line.

Reference surface:
If you are comparing the points to a reference surface for cuts/ fills, selected it here from the list of project surface models.

Create CSV file checkbox:
Check the checkbox if you would also like to generate a CSV report of the data being labeled. If selected, define the file name and file location for the reported data. If you right click the file name field, you can define the path for the file using the Project data folder (for the current TBC project) or Browse
to your preferred location on the computer / network that you are using. Clicking the […] button takes you to the file browser and opens the last path used by the software as the default.

The CSV file created will have the following format and column order

Column 1: Point Number
Column 2: Northing (or Easting - based on TBC coordinate order setting)
Column 3: Easting (or Northing - based on TBC coordinate order setting)
Column 4: Elevation
Column 5: Feature Code
Column 6 and higher : Used for the values selected in the label definition in the order that they are defined in the label definition (and excluding the default values reported in columns 1 through 5). i.e. if you report Station, Offset, Dz (Point to Surface) and Dz (Point to Line), then these values will be reported in columns 6 through 9 accordingly.

Current ouput is a CSV file, however we plan yo upgrade the report outputs to a fully formatted Excel Report in the near future.

Report Precisions:
The reported values will be accurate to the following number of decimal places

  • Coordinates: 3DP (Metric), 2DP (Feet)
  • Offsets: 5DP (Metric), 5DP (Feet)
  • Delta Elevations: 5DP (Metric), 5DP (Feet)
  • Slopes: 3DP (Metric), 3DP (Feet)

DP = Decimal Places
Note that offsets and Dz Values are to 5DP so that computed slopes are accurate to 3DP

Report Notes:
Reported values for Delta Elevations Point to Line or Surface are positive when Point is above the line or surface and negative when the point is below the line or surface. (Point Elevation minus Line Elevation).

Reported values for Delta Elevations Line or Surface to Point are positive when line or surface are above the point and negative when the line or surface are below the point. (Line or Surface Elevation minus Point Elevation).

Reported values for slope between Point and Line are positive when the point is below the line and negative when the point is above the line.

Reported values for slope between Line and Point are positive when the Line is below the line and negative when the line is above the point.

Label definitions:
In this section you can define different labels for different use cases. For example you may want a label that compares the selected points to the selected line or alignment and displays Station, Offset and Dz values. You may also want a label that compares the selected points to the selected reference surface and displays Point ID and Cut/Fill values. You can create as many label definitions as you think you may need. These definitions are all stored in an external file so that you can use them on different projects.

To create a new label click the image button
To rename a label click the image button
To save a label definition click the image button
To delete a label definition click the image button

Edit Label:
To edit the content of a label, click the Edit label button. This will open the label editor as shown below.

image

In the Value codes area of the dialog you will find a list of all the values that can be used to create the label. In the Label text area of the dialog you will find the current definition of the selected label. The Label text area of the dialog acts like a text editor, you can enter freeform text, you can use CTRL C, CTRL V, CTRL X, DEL, Backspace, Enter etc. to move the text and value codes around into the desired order and format.

To add a value code into the label text, simply enter the string of text required as a prefix e.g. N: for Northing, then select the Value code required e.g. Point Northing and then click Insert Code to move it from the Value code field into the Label text field of the dialog.

Value code options:
Here is a list of the available value codes and what they provide

  • Delta Z (Line - Point): The elevation difference of the Point to the line (Line Z - Point Z)

  • Delta Z (Point - Line): The elevation difference of the line to the point (Point Z - Line Z)

  • Delta Z (Point - Surface): The elevation difference of the point to the surface (Point Z - Surface Z)

  • Delta Z (Surface - Point): The elevation difference of the surface to the point (Surface Z - Point Z)

  • Slope (Line - Point): The slope from the line to the point in %

  • Slope (Point - Line): The slope from the point to the line in %

  • Line Elevation: The elevation of the line at the station of the point

  • Surface Elevation: The elevation of the surface at the location of the point

  • Point ID: The points Number / ID

  • Point Code: The points Code

  • Point Description 1: The points description 1

  • Point Description 2: The points description 2

  • Point Northing: The points Northing

  • Point Easting: The points Easting

  • Point Elevation: The points Elevation

  • Point Station: The points Station along the reference line

  • Point Offset (2D): The points horizontal Offset to the reference line

  • Point Offset (3D): The points slope distance Offset to the reference line

  • Surface Slope: The slope of the selected surface at the point location

  • Surface Slope Direction: The direction of the surface slope at the point location

Layer:
Select the layer on which you wish to place the point labels. If you wish to create a new layer click the [New …] button to open the New layer creation dialog.

image

You can also create a new layer group from within the new layer dialog by clicking the [New …] button next to the layer group selector.

image

Use cut/fill color checkbox:
Check this checkbox if you wish to color code the text labels based on their High, Low or In Grade tolerance status. You can apply High and Low tolerance values to the Delta Z values being computed using the RPS Settings controls. Click the orange R in the command header bar to open RPS Settings.

image

image

Select a color for the Cut tolerance (High / Above Grade) e.g. Red

Select a color for Within tolerance (On or Within Grade tolerance) e.g. Green

Select a color for Fill tolerance (Low / Below Grade) e.g. Blue

Define your Cut / High tolerance value e.g. 0.05’ / 0.005m

Define your Fill / Low tolerance value e.g. -0.05’ / 0.005m

The text labels created will then be color coded in the above example Red, Blue or Green depending on the selected points High, Low or In Grade Tolerance status.

Label offset:
Select or enter the offset for the label from the point e.g. 0.2’ / 0.05m to create a small space between the points location and the text insertion point. You can use the slider bar or simply enter the desired value.

Label direction:
When working with a reference line, it is often required that the text labels be oriented parallel, perpendicular or at a defined angle to the selected line or alignment. When working with just a surface as the reference you may wish to rotate the labels to an absolute orientation angle on the plans.

Absolute / Relative to line selection:
If you choose the Absolute option e.g. 90 degrees, then the labels will be aligned to that absolute orientation in the model.
If you choose the Relative to line option e.g. 90 degrees, then the labels will be aligned at that orientation relative to the selected reference line.

Use case tips:
If the points are to the right of the reference line, the relative to line option will add an entered angle of 90 degrees to the lines direction to orientate the text 90 degrees to the line. If the point is on the left side of the line then the text will be rotated by -90 degrees to the line direction.

Auto Flip definition in the selected text style will be honored however when labeling with a reference line, auto flip may create results where different labels are labeled in different orientations which may make the text harder to read for the viewer - we recommend that text labeling with respect to reference lines does not require auto flip in the text style definition.

Auto adjust label checkbox:
Select this checkbox to auto adjust the justification of the text to the side of the line that the point is on. Point labels on the right side of the line will be justified with the selected text attachment location, points on the left of the line will be justified in the opposite direction i.e. if points to the right are set to Left Middle then points on the left will be Right Middle. If points to the right are set to Top Middle then points on the left will be set to Bottom Middle etc. In this way all text is written clear of the reference line.

Text Style:
Select the text style to use for the point labels. The text styles are defined in the text style manager. You can select “New style” from the pull down list of text styles to open the text style manager.

Use case tips:
We recommend that you establish appropriate text styles for the point labels in your project template in order to save having to set them up here. We recommend defining the text styles in Sheet Units, and we recommend the use of stroke fonts if you are going to be labeling a large number of points. Note that sheet unit text styles, will draw the text at the height in sheet units based on the scale defined for the plan view in Project Settings, View, Plan View, Plot Scale. Be sure to have that setting at an appropriate value for the scale of work that you are working with. i.e. a text style set to 0.06 inch high at 50 scale will result in text 3’ high on the drawing, at 10 scale the same text would be 0.6’ high.

Text attachment location:
While the text style defines the text font, text sizing, bold, italic, whiteout and auto flip type settings as well as a default justification, this setting will control where the text box is placed in relation to the point for the purposes of this command. Typically use Center Left / Right for text being drawn at an angle to the reference line, or Bottom Middle / Top Middle for text being drawn parallel to the reference line. Typically use this in combination with the Auto adjust label checkbox being enabled.

Apply
When you tap apply, the text labels will be placed and the command will ready itself for another selection set and repeat process execution. If you do not want to make a second selection and repeat the process tap Close to finish the process.

OK
Executes the command and closes on completion

Cancel
Closes the command without further execution.


Video Demonstration

The following video shows how to utilize the Label Points command


*** ## Use Case Videos The following videos show the use of the Label Points command in a work process context
***

Feedback and Enhancement Requests

If you would like to provide feedback on the use of the Label Points command or to request enhancements or improvements to the command please Click Here