Installation Instructions

The usage of the console version:

ctdbtostf <OPTIONS> <input CTDB filename> <output STF filename>

The console version of CTDBtoSTF is a command line program that takes a set of options, the name of an existing CTDB to convert and the name of the created STF.

Options:

-all
Convert all the CTDB data, and derive geometry data where applicable. This option is implied if no option is specified.

-grid
Convert the grid data.

-abstract
Convert the abstract features.

-micro
Convert micro-terrains.

-volume
Convert the volumes features including MES volumes. If '-fea_geo' is also set, derived geometries will be generated.

-linear
Convert the linear features. If '-fea_geo' is also set, derived geometries will be generated.

-canopy
Convert canopies.

-lf
Convert the laid linear features. If '-fea_geo' is also set, derived geometries will be generated for laid linear features.

-tin
Convert TIN and water polygons.

-grid_geo
Derive polygonal terrain from elevation grid data if it exists in the CTDB. The derived geometry will be organized on patch basis.

-fea_geo
Derive geometry from features. It is enabled only when any of the '-lf', '-linear' and '-volume' option is set.

-verbose n
Prints up to n levels of progress details (0<=n<=2), where level 0 is the default level, which prints no progress information.

-GD [data_path]
Convert to Geodetic coordinate system. [data_path] tells where to find "coord.rdr". If not provided, seach under current directory.

-GCC [data_path]
Convert to Geocentric coordinate system. [data_path] tells where to find "coord.rdr". If not provided, seach under current directory.

Any combination of these options can be specified from the command line. If no options are specified then '-all' is implied.

The first argument after the options (if there is any) is the name of the existing CTDB. The extension for this file can be "c7l", "c7b", "m7l" or "m7b". The "l" indicates a little endian CTDB, while the "b" indicates big endian. Little endian CTDBs can only be converted on little endian machines, such as Windows or Linux running on x86 processors. Likewise, big endian CTDBs can only be converted on big endian machines, such as SGIs or Suns.

The final argument is the name for the created SEDRIS transmittal with the ".stf" extension.

The usage of the GUI version:

ctdbtostf_gui

The GUI version of CTDBtoSTF provides a graphic interface for user to input options, the name of an existing CTDB to convert and the name of the created STF. Please refer to the usage of console version for the explanation of the options.

Please keep in mind that the GUI version of CTDBtoSTF is simply a wrapper of the command line version. Once a user enters all required fields and hits the "Convert" button, the CTDBtoSTF GUI will try to launch "ctdbtostf.exe" (on Windows) or "ctdbtostf" (on Linux) under the same directory where the gui executable is located. So, before running the GUI, please make sure:

1. GUI and command line executables reside under the same directory, and

2. command line executable file name is "ctdbtostf" since it is hard coded in the GUI application.

For other questions, send a request to help@sedris.org.