mbdefaults
Section:  MB-System 5.0  (1)
Updated:  12 September 2011 
Index


 
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 -Uuselockfiles 
-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. Another common Postscript display utilities
is gv; past postscript viewers included pageview 
(for Sun workstations) and xpsview (for Silicon Graphics workstations).
-F


fbtversion



Set the version of fbt files created by mbdatalist and mbprocess. 
If fbtversion = 2, "old", or "OLD", then the pre-5.3.1897 version of
format 71 will be used to write the "fast bathymetry" or "*.fbt" files.
If fbtversion = 3, "new", or "NEW", then the new, 5.3.1897-or-later version of
format 71 will be used to write the "fast bathymetry" or "*.fbt" files.

-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.
-U


uselockfiles



Sets whether MB-System uses the file locking mechanism to insure that
a swath file is only processed or edited by a single program at a time.
To revert to pre-lockfile behavior for mbedit, mbeditviz, 
mbclean, mbareaclean, mbnavedit, and mbprocess,
use -U0 or  -Uno. To reinstate use of lock files,
use -U1 or  -Uyes.
-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

 fbtversion: 3 (new)

 uselockfiles: 1

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

 fbtversion: 3 (new)

 uselockfiles: 1

 
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...



 
Index

NAME

VERSION

SYNOPSIS

DESCRIPTION

CHANGES FROM VERSION 4.6

AUTHORSHIP

OPTIONS

EXAMPLES

SEE ALSO

BUGS

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

Back to MB-System Home Page...