Skip to content

How To Use

EMS90 edited this page Jul 4, 2025 · 7 revisions

TRA. The tool allows the import & export, visualization, validation & analysis as well as the transformation of TRA and GRA files. The following sections are in the order of a usual workflow.

Import

TRA and GRA files can be imported via drag and drop from the Explorer area. Individual files can be added to the corresponding fields of a Track-container. A Track-container is predefined as a combination of left and right path (L/R.TRA), the associated gradient (L/R.GRA) and a stationing axis (S.TRA). When loading a file, the remaining fields are filled in by auto-completion if possible. Alternatively, it is possible to import an entire folder, and the files contained are grouped in Track-containers using auto-completion.

Batch processing

TRA. Tool follows the concept of batch processing of the loaded files, combinations allow different processing operations. As processing containers currently Interpolation, Transformation and Transformation VA are available. Executing a processing container applies to all previous Track-containers until the next occurrence of this type of processing container. This way multiple settings (for interpolation or transforms) can be applied to different subsets of Track-containers. Rearranging of containers is possible via drag&drop. By clicking on the buttons below, different types of containers can be added to the stack.

Interpolate

As geometries inside a TRA file are defined by parameters type, length, radius1 and radius2, 2/3D points have to be sampled to provide a visualization or export poly-line coordinates as csv. The interpolation container has two options: First is Delta defining the distance between sampled points, the second Tolerance describes the maximum allowed difference between the geometry and the sampled poly-line. This ensures a higher density of sampling-points at areas with higher curvature values. Pressing the Interpolate button, starts the sampling of all previous Track-geometries (see Batch processing). Depending on the amount of geometries and their complexity (some geometry types can only be calculated iterative) this can take some time. When a interpolation is calculated, the PlotView window shows up

Transform /Transform VA

By adding a transform container to the stack. TRA-elements can by transformed in other coordinate systems. Applying a transform not only affects the start point of a geometry element, but also has impact to the geometry parameters. By enabling Optimize Heading and Length these parameters a fitted to restore a consistent geometry after transform.

During the transformation, the coordinates are internally checked to ensure they lie within the valid bounding box for this CRS. This bounding box is defined by egbt22lib. If one or more points of a track—either interpolation points or element start points—fall outside the bounding box, a warning is displayed listing all affected elements for that track.

For more information about the different transform-options please see: https://github.com/dd-bim/egbt22trans/tree/main/egbt22trans

Export

Exporting is possible to TRA/GRA, csv and .dxf. Therefore the Export button on each Track-container instance can be used. To save all TRA(GRA) instances as TRA the Save all button can be used.

Clone this wiki locally