Skip to content

R3STRING

Command: R3STRING

Reads a survey data file and automatically draws points and connecting strings (polylines) into the current drawing, styled and layered according to the active configuration.

Prerequisites

An active configuration must be set. If not, the command will display an error — use R3MANAGECONFIGS to set one up. See Configuration.

Running the command

  1. Type R3STRING at the command line
  2. A file dialog opens — select your survey file
  3. R3Survey processes the file and draws everything in one operation

Supported file formats

Extension Format Notes
.xml LandXML Validates against active CodeList; runs audit
.csv CSV Comma-separated point data
.pta PTA Survey point format
.txt Leica Raw Must be a Leica total station raw export

Leica Raw (.txt) — prism pole preset

When opening a Leica Raw file, you are prompted to select the prism pole preset that was used in the field:

Select prism pole preset [Std145_205/Alt130_215]:
Option Heights
Std145_205 Standard: 1.45 m / 2.05 m (default)
Alt130_215 Alternate: 1.30 m / 2.15 m

Choose the preset that matches the pole configuration used during data collection.

Error logs

For Leica Raw and LandXML files, an error log is written beside the source file (.ErrorLog.txt). If the log contains any entries, it opens automatically in Notepad. Check it for:

  • Points that could not be processed
  • Attribute parsing errors
  • Audit warnings (LandXML only)

Unknown codes

If any point codes in the file are not found in the active CodeList, a warning dialog lists them:

The following codes were not found in the active CodeList:
 - NEWCODE
 - TESTPNT
 - XYZ

Proceed with stringing anyway?
  • Yes — continue; unknown codes are drawn with default styling
  • No — abort; fix the CodeList or the field data before proceeding

What gets drawn

After a successful run:

  • Points — drawn at each survey point location, on the layer and with the symbol/block/circle defined by the PointStyleConfig for that code
  • Strings — polylines connecting points with the same code (and matching attributes), on the layer and with the linetype defined by the StringStyleConfig
  • Labels — text labels at points, controlled by the PointStyleConfig label rules
  • Blocks — symbols inserted at points where the PointStyleConfig specifies Block(...) actions

File location memory

R3STRING remembers the last folder you selected a survey file from and opens there next time.

Notes

  • Stringing runs in a single AutoCAD transaction — if it fails partway through, no partial results are left in the drawing
  • All entities are drawn on the current model space; layout space is not affected
  • Running R3STRING twice from the same file will add duplicate entities — there is no deduplication