Uxtrt Test R

-abdpath (optional)

Path to the abend (abnormal end) file. Specify an abend file if you think something is going wrong and you want to see the error messages. If you do not specify an abend file the error messages are silently dropped.

-abduxtrt.abd

-celllibpath

Specifies the path to the MicroStation V7 cell library.

-celllibtopo.cel # File in working directory. -celllibC:\Cells\topo.cel # Absolute path. -celllib..\..\data\topo.cel. # Relative path.

-cfgpath

Specifies the path to the uxtrt configuration file.

-cfgtopo_filled.xml # File in working directory. -cfgC:\Config\topo_filled.xml # Absolute path. -cfg..\..\cfg\topo_unfilled.cfg # Relative path.

-clipclipmode

Specifies the uxtrt clipmode

-clip0 # Unclipped. -clip1 # Clipped. -clip2 # Clipped and closed.

-dbgpath (optional)

Path to the debug file. Specify a debug file if you want a blow-by-blow record of program execution. The debug file can get ridiculously large so it is often combined with -part= and -recno=. If you do not specify a debug file no debug output is created.

-dbguxtrt.dbg

-diradddirectory

The directory where the uxtrt add files are created. The trailing slash is required.

-diraddadd\ # Directory below working directory. -diraddC:\Temp\add\ # Absolute directory. -diradd..\..\tmp\add\ # Relative directory.

-dirdeldirectory

The directory where the uxtrt del files are created. The trailing slash is required.

-gmlpath

Path to the OS-!MasterMap Topo GML file to be translated.

-gml58116-SX9192-2c1.gz # File in working directory. -gmlC:\Temp\58116-SX9192-2c1.gz # Absolute path. -gml..\tmp\58116-SX9192-2c1.gz # Relative path.

-leaveadd1 (optional)

Normally the translator deletes the uxtrt add files after they have been processed. If you specify this parameter the add files are not deleted.

-leavedel1 (optional)

Normally the translator deletes the uxtrt del files after they have been processed. If you specify this parameter the del files are not deleted.

-lstpath

Path to the uxtrt list file?. This text file lists the tiles to be created from the GML file specified with -gml=.

-lsttiles.lst # File in working directory. -lstC:\Temp\tiles.lst # Absolute path. -lst..\tmp\tiles.lst # Relative path.

-noupdate1 (optional)

Normally the translator records the FID in the uxtrt del files so old features can be removed from an existing tile. If you specify this parameter the FID is only recorded if an update file is being processed. You are unlikely to ever have to use this parameter.

-noupdate1 # 1 is the only valid option.

-part (optional)

There are three main parts to the translation of a .gz file (see below). Normally all three parts take place sequentially. The -part parameter allows you to specify that only one of the three parts takes place. See also -dbg=.

-part1 # Create the add files. -part2 # Process the del files. -part3 # Process add files.

(Part One)

• For every element in the .gz file: * Calculate the extents of the element from the geometry. * Use the extents to determine which map tiles could cover the element. * For each map tile: ** Use the extents of the tile to trim the element according to the uxtrt clipmode. This may result in one element becoming multiple elements, elements with holes becoming simple polygons, or polygons becoming collections of lines. * Add the results of the trim to one of the uxtrt add files. * Add the FID to one of the uxtrt del files (but see -noupdate above).

(Part Two)

• For every one of the uxtrt del files: * Create an indexed 'delete list' from the contents of the 'del file'. * For every element in the target DGN file: * If the element has a FID that matches one on the 'delete list' -> mark it as deleted.
• Delete the del files.

(Part Three)

• For every one of the uxtrt add files: ** Append the contents of the 'add' file to the target DGN. If the target does not exist the 'add file' is copied in its entirety.

-recnointeger (optional)

Process only the specified record. This is used to single out and process a particular record that causes a problem. It can also be used to quickly test a workflow since processing time is greatly reduced when only one record is processed. See also -dbg= and -part=.

-recno1 # Process only record number 1. recno=20398 # Process only record number 20398.

-seedpath

The path to the seed file. Note: This is a MicroStation V7 file.

-seedtopo.td7 # File in working directory. -seedC:\Temp\topo.td7 # Absolute path. -seed..\tmp\topo.td7 # Relative path.

-verbose1 (optional)

Turn debugging on. The higher the value the more debugging output there is. If you do not want any debugging do not specify this parameter. A value of '0' will still produce debug output.

-verbose1 # Display normal debugging output. -verbose3 # Display quite a high level of debugging output. -verbose0 # Specify a lower level of debugging output. -verbose # The same as -verbose0

See Also

• MM Topo User Guide