mbdefaults(1)

NAME
mbdefaults - Set or list default mbio parameters for reading and writing swath sonar data

VERSION
Version 5.0

SYNOPSIS
mbdefaults [-Dpsdisplay -Iimagedisplay -Llonflip -Ttimegap -Wproject -V -H]

DESCRIPTION
mbdefaults is a utility for setting or listing the default read parameters used by some MBIO utilities such as MBCOPY. If a user wishes to set default parameters different from those set by the MBIO library, then these specialized default values must be stored in the file .mbio_defaults in the users home directory. If any option flag is given in invoking mbdefaults, then a new .mbio_defaults file will be written incorporating the newly set parameters along with any old parameters which have not been reset. If no option flag is given, then mbdefaults will list the current default values (set by mbio if no .mbio_defaults file exists).

CHANGES FROM VERSION 4.6
Note that prior to version 5.0, the MB-System defaults set by mbdefaults included the format id, a control for ping averaging, longitude and latitude bounds for windowing by area, and begin and end times for windowing in time. These values are no longer set in the .mbio_defaults file or controlled by mbdefaults.

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  psdisplay
    Sets the program used for displaying Postscript graphics files on a screen; this facility is used by shellscripts created through macros like mbm_plot. The default Postscript display utility is ghostview. Other common Postscript display utilities are pageview (for Sun workstations) and xpsview (for Silicon Graphics workstations.

-H  This "help" flag cause the program to print out a description of its operation and then exit immediately.

-I  imagedisplay
    Sets the program used for displaying Tiff image files on a screen; this facility is used by shellscripts created through macros like mbm_grdtiff. The default image display utility is xv. Other common image display utilities are gimp (GNU image processing) and gqview.

-L  lonflip
    Sets the range of the longitude values returned. If lonflip=-1 then the longitude values will be in the range from -360 to 0 degrees. If lonflip=0 then the longitude values will be in the range from -180 to 180 degrees. If lonflip=1 then the longitude values will be in the range from 0 to 360 degrees. Default: lonflip = 0.

-T  timegap
    Sets the maximum time gap in minutes between adjacent pings allowed before the data is considered to have a gap. Default: timegap = 1.

-V  Normally, mbdefaults outputs only a list of the default values to the stdout stream. If the -V flag is given, then mbdefaults works in a "verbose" mode and also outputs the program version being used.

-W  project
    Sets the name of the default project. This will be used by MB-System database management utilities yet to be created. Default: project = "none".

EXAMPLES
Suppose that one wishes the default Postscript viewer to be xpsview rather than ghostview. The following will suffice to create (or rewrite) a .mbio_defaults file in the users home directory:
    mbdefaults -Dxpsview The output will be:
 New MBIO Default Control Parameters:
 lonflip: 0
 timegap: 1.000000
 ps viewer: xspsview
 img viewer: xv
 project: none Suppose that one just wishes to see what the current default parameters are. The following will suffice:
    mbdefaults The output will be
 Current MBIO Default Control Parameters:
 lonflip: 0
 timegap: 1.000000
 ps viewer: ghostview
 img viewer: xv
 project: none

SEE ALSO
mbsystem(l), mbio(l), mbcontour(l), mbswath(l), mbgrdtiff(l), mbm_plot(l), mbm_grdplot(l), mbm_grd3dplot(l), mbm_xyplot(l), mbm_grdtiff(l)

BUGS
Too simple to have any really interesting bugs. Well, ok, this program occassionally runs wild, destroying filesystems and eating young children. But don't worry, it could never happen to you...