MB-System Unix Manual Page

mbm_dslnavfix

Section: MB-System 5.0 (l)
Updated: 24 September 2002
Index

NAME

mbm_dslnavfix - Translate WHOI DSL AMS-120 navigation from UTM eastings and northings to longitude and latitude.

VERSION

Version 5.0

SYNOPSIS

mbm_dslnavfix -Fnavformat -Iinfile -Jutm_zone -Ooutfile [-Ddecimate -Eellipsoid -H -V]

DESCRIPTION

mbm_dslnavfix is a macro to translate WHOI DSL AMS-120 navigation from UTM eastings and northings to longitude and latitude. The WHOI DSL group typically provides processed AMS-120 navigation is files separate from the bathymetry and sidescan data. Moreover, the navigation is generally sampled less frequently than the sonar pings, and is reported in UTM easting and northing meters. The mbm_dslnavfix macro is used to translate the eastings and northings into the geographic coordinates (longitude and latitude) used by MB-System programs. The program mbprocess can be used to merge the translated navigation in with the bathymetry and sidescan.

The DSL AMS-120 bathymetry and sidescan are provided in either a set of parallel files supported as MB-System format 111 (the old scheme) or in the OIC single file format supported as MB-System format 141 (the new scheme). In either case, we recommend translating the data to similar but enhanced formats 112 and 142, respectively, to ease processing.

We recommend the following procedure when processing WHOI DSL AMS-120 data with MB-System:

        1) Concatenate all of the processed navigation

           files into a single file.

                cat *.nav > cruise.rnav

        2) Translate the DSL UTM navigation into geographic

           coordinates. In the "old" case the navigation is

           in a format designated by -F1 and
           in the new case by -F2. Note that
           you must know the UTM zone used - here we assume
           the zone is +27.
                mbm_dslnavfix -Icruise.rnav \

                        -Ocruise.mrg2 -F1 -J27 -V

        3) Copy the bathymetry and sidescan data in each

           file from format 111 to format 112 or from

           format 141 to 142.
                mbcopy -F111/112 \

                        -IDSL120.940630_1100.bat.dat \

                        -ODSL120.940630_1100.mb112

        4) Set the translated navigation to be merged with

           each of the format 112 or 142 files using
           mbset:
                mbset -I DSL120.940630_1100.mb112 \

                        -P NAVFORMAT:2 \

                        -P NAVFILE:cruise.mrg2 \

                        -V

        4) Process the data using mbprocess,

           producing a processed file called
           DSL120.940630_1100p.mb112 with longitude and
           latitude navigation.
                mbprocess -I DSL120.940630_1100.mb112

AUTHORSHIP

David W. Caress (caress@mbari.org)

Monterey Bay Aquarium Research Institute
Dale N. Chayes (dale@ldeo.columbia.edu)

Lamont-Doherty Earth Observatory

OPTIONS

-D: decimate
This option allows the user to decimate the input navigation. The decimate value represents the decimation factor. The default is decimate = 1, or no decimation.
-E: ellipsoid
This option sets the ellipsoid used in the UTM projection. The choices are:
        WGS-84          1984 World Geodetic System

        GRS-80          1980 International Geodetic Reference System

        WGS-72          1972 World Geodetic System

        Australian      1965 Used down under

        Krasovsky       1940 Used in the Soviet Union

        International   1924 Worldwide use

        Hayford-1909    1909 Same as the International 1924

        Clarke-1880     1880 Most of Africa, France

        Clarke-1866     1866 North America, the Phillipines

        Airy            1830 Great Britain

        Bessel          1841 Central Europe, Chile, Indonesia

        Everest         1830 India, Burma, Pakistan,  etc.

        Sphere          1980 The mean radius in GRS-80

Default: Clarke-1866 as per USGS standard.
-F: navformat
Sets the input navigation format. The available formats include the old, pre-OIC format (-F1), the new, OIC associated formats (-F2), and navigation obtained using mblist with the -OtXY option.
-H: This "help" flag cause the program to print out a description of its operation and then exit immediately.
-I: filename
Sets the input WHOI DSL AMS-120 navigation filename.
-J: utm_zone
Sets the UTM zone used for the translation. The UTM zones are 6 degrees wide in longitude and begin with zone 1 extending from 180 W to 174 W, zone 2 extending from 174 W to 168 W, and so on through zone 60. Negative zone values are used for the Southern Hemisphere.
-O: outfile
Sets the output filename for the translated navigation.
-V: Causes mbm_plot to operate in "verbose" mode so that it outputs more information than usual.

EXAMPLES

Suppose we have obtained a WHOI DSL navigation file as outlined above and execute the macro as suggested:

                mbm_dslnavfix -Icruise.rnav \

                        -Ocruise.mrg2 -F1 -J27 -V

The output will appear as follows:

Running mbm_dslnavfix...

Program Status:
--------------

   Input DSL navigation format:   1
   Input DSL navigation file:     dsl.nav
   Output navigation file:        dsl.mrg2
   Temporary projected nav file:  tmp_proj_8044.nav
   Temporary geographic nav file: tmp_geo_8044.nav

   ------------

   Projection:                    UTM Zone 27
   Projection units:              meters

   ------------

586 navigation records read...

Running mapproject...
mapproject tmp_proj_8044.nav -Ju27/1:1000000 -I \
        -R-20:0/0:0/-19:0/1:0r > tmp_geo_8044.nav

Deleting tmp_proj_8044.nav, tmp_geo_8044.nav...

Done...

BUGS

Let us know...

Last Updated: 24 September 2002

Return to list of MB-System manual pages...

Back to MB-System Home Page...