2.3 Browser Preferences
The OPeNDAP Matlab GUI uses a set of preferences to control several aspects of its
use, including selection ranges, font sizes, colors and so on. These
preferences can be loaded with the Preferences,Load File
button, and saved with the Preferences,Save or Preferences,
Save As buttons
(See here). These commands load and save a
Matlab script whose function is to define the values of the various
preferences. You may find it convenient to edit the file by hand; it
is only an ASCII file of Matlab commands.
If the preferences file is called browsopt.m, and is stored
somewhere in the Matlab path, it will be loaded automatically when the
browser starts up.
Following is a list of all the options a preference file may contain.
timetoggle- This option (controlled with the
Display,Time button) controls whether times are displayed as
Year/Month/Day or as the Year/Yearday, where Yearday is the ordinal
number of the day of that year.
dods_colors- This is the set of colors, expressed in RGB
values in a 10×3 array, used to display various aspects of
the browser window. The colors are used as follows:
dods_colors[1]- Default button color.
dods_colors[2]- Axis and window background.
dods_colors[3]- Axis and window foreground.
dods_colors[4]- Non-interactive window and axis text.
dods_colors[5]- Edit boxes, where users may type.
dods_colors[6]- Edit box text and button labels.
dods_colors[7]- The Get Data! button.
dods_colors[8]- Text and axis lines that change.
dods_colors[9]- The "whizzo" color, used for drawing
attention to special options. The Help is displayed in
this color, among others.
dods_colors[10]- The selection range box color.
fontsize- The point size of the displayed type.
figsizes- The default size and position of the browser
window, expressed in the pixel locations of the upper left and lower
right corners.
axes_vals- The starting axis values for the displayed
axes, expressed four pairs of minimum and maximum values for (in
this order), longitude, latitude, depth, and time:
axes_vals=[minLon maxLon minLat maxLat minDepth maxDepth minTime maxTime]
ranges- Specifies the default selection ranges, in the
same manner as the
axes_vals preference.
num_rang- An eight element vector of ones and zeros,
indicating which of the selection ranges have been set by the user.
A one means the corresponding item in the
ranges variable has
been set by the user. If not all the ranges are set, you can't `get
data' or `get details'. If a dataset is selected, and the depth or
geographic ranges have not been set, these are set to those of the
dataset.
color_limits- A two element vector indicating the data
values to assign to the top and bottom colors in the data palette.
palettefile- The name of a file containing the data
palette. This file must be in the Matlab path.
check_level- This is the number of megabytes for the
"Get Data" threshold. (Set with the Preferences,Get Data
Threshold button, see here for more
information.)
available_resolutions- This is a vector containing the
available resolutions offered with the Resolutions menu,
expressed as multiples of the dataset's basic resolution. The
default value is:
available_resolutions = [32 24 16 12 8 4 3 2 1];
This option is not changable through the browser, but you can edit
the preferences file directly to change it.
manURL- The URL of the OPeNDAP Matlab GUI manual. By default, this
points to
http://opendap.org/support/docs.html/user/mgui-html/. If
you have a local copy of the manual served, you can substitute that
URL.
guiserver- The URL to use for updates to the dataset
metadata files.
userlist_file- The name and location (on the local file
system) of the user's bookmarks file.
Tom Sgouros, December 21, 2004
Index
