How To Get The MB-System Source Distribution
The source code for MB-System is available as a compressed tar
by anonymous ftp to the Lamont-Doherty Earth Observatory of Columbia
This archive file is about 3 megabytes in size and, depending on the
speed of your internet connection, may take a few minutes to transfer.
Click here to ftp the current stable MB-System release as a compressed tar archive.
Click here to ftp the current unstable ("beta") MB-System release as a compressed tar archive.
Click here to
get point-and-click ftp access to all of the MB-System related
available from Lamont (these may include data examples and beta
of MB-System ).
If access through the above links fails, try running ftp from a
The following commands represent a typical anonymous ftp session (note
firstname.lastname@example.org literally means to enter your email address, and that many modern ftp clients do not require the "binary" command).
% ftp ftp.ldeo.columbia.edu
If anonymous ftp fails with an error message like: "Sorry no DNS entry"
after the email address is entered as the anonymous password, this
means that the internet address (also called IP address) of the
computer in use is
not known to the Lamont network to be legitimate. As a security
illegitimate IP addresses are not allowed to connect to the Lamont
The Lamont ftp server attempts to look up or resolve IP addresses using
the primary Domain Name Service (DNS) servers associated with the
internet as a whole. So, this problem arises when computers use IP
addresses are not properly registered with the global DNS servers. This
exists for computers connecting through improperly configured firewalls
or Network Address Translation (NAT) devices. Users facing this issue
succeed by running ftp from a "better connected" server in their
organization. Otherwise, they will need to contact their internet
provider or their network/computing support staff.
> cd pub/MB-System
> get MB-System.tar.gz
Packaged MB-System Distributions
MB-System has been packaged for MacOS X as part of the Fink Project. The MB-System fink package is maintained by Kurt Schwehr of CCOM/JHC UNH.
MB-System is included in Poseidon Linux, an Ubuntu Linux based distribution that is pre-loaded with a number of software packages used for scientific research.
Suggested Software and Data
MB-System requires a number of other software packages and databases
to be fully functional. These are:
- GMT version 4.2.0 or later: MB-System makes use of the
Mapping Tools (GMT) libraries and programs for much of its graphics.
also includes a detailed global coastline database. GMT has been
by Professor Paul Wessel of SOEST (School of Ocean and Earth Science
Technology at the Univeristy of Hawaii) and Dr. Walter H. F. Smith of
The GMT source code is available from the GMT
- NetCDF version 3.5.1 or later: Both GMT and MB-System
- Perl version 5.0 or later: Perl is a fast, well
scripting language used widely in the Linux/Unix world. MB-System contains a
number of perl scripts used both for installation and to ease common
tasks. Most of the current Unix operating systems include perl. If
you need to obtain the perl source code, first check with your local
system administrator - you will probably find perl already available
locally. The perl source code can be obtained from the
software archives of the Free
- X11: The interactive graphical utilities in MB-System (MBedit, MBnavedit, MBvelocitytool, MBgrdviz, MBeditviz) use and require the X11 windowing system.
- Motif: The interactive graphical utilities in MB-System (MBedit, MBnavedit, MBvelocitytool, MBgrdviz, MBeditviz) use version 2 of the Motif widget set, and Motif libraries
are required for these utilities to be built and to run.
Most current Unix/Linux operating systems include the required Motif
libraries, either in the original proprietary form (Motif), or the not-quite-open-source form (OpenMotif). If you do not have these libraries, the OpenMotif 2 source is available through
Motifzone. An old alternative open source Motif-compatible
distribution called LessTif does not work with the new OpenGL based MB-System programs (MBgrdviz, MBeditviz) and should be avoided.
- Levitus Database: The MB-System program mblevitus depends
a 16 MByte data file that is not included in the MB-System tarfile.
to ftp this file. Be sure to uncompress the file and to set the
flag in the install_makefiles appropriately, as described below in the
- FFTW: The "Fastest Fourier Transform in the West" package is used by the sonagram calculation program MBbsegypsd to calculate, well, Fast Fourier Transforms. FFTW is commonly used and thus available on or for most current Unix operating systems.
- OTPSnc: The Oregon State Ocean Tide Prediction Software package is required for the tidal modeling program MBotps (which in fact is just a convenient front end for the old-style-batch interface of OTPS). The OTPSnc package can be obtained from the tidal modeling group at Oregon State University.
MB-System produces Postscript based graphics. Most current Unix
systems provide a program which serves as a screen-based Postscript
If you do not have a Postscript viewer, one option is to obtain one of
packages from the Free Software Foundation.
- gv: Open source screen Postscript viewer. This
package is a bit more sophisticated than ghostview and can handle
poster-sized plots. The
source code can be obtained from the GNU
software archives of the Free
Users of MacOs X should note that many of the above packages can be
painlessly installed using the fink package available from the
How to Install MB-System
The MB-System source code is extracted by first uncompressing the
file and then running tar:
% tar xvzf MB-System.tar.gz
This will create a directory called (for the 5.1.3 distribution):
In order to
configure your installation, you must edit the perl script
mbsystem-5.1.3/install_makefiles, and set a number of parameters to reflect the system architecture, the location of the installation, and the locations of certain required libraries.
This script will read template makefiles in the MB-System
directories and create makefiles with the correct dependencies, compile flags, and link flags. The important parameters to be set in install_makefiles are listed below. The install_makefiles script includes comments suggesting parameters to use for many common computer systems.
These parameters must be set for all installations:
- MBSYSTEM_HOME - Absolute path to the directory containing install_makefiles.
- OS - Operating system (Recognized options are: DARWIN, LINUX, CYGWIN, SUN, IRIX, IRIX64, SOLARIS, HPUX, LYNX, CYGWIN or OTHER).
- CFLAGS - Compile flags for C source files. These vary with different operating systems and installations.
- LFLAGS - Load flags for all object files.
- NETCDFLIBDIR - Location of NetCDF library libnetcdf.a
- NETCDFINCDIR - Location of NetCDF include file netcdf.h
- GMTLIBDIR- Location of GMT libraries libgmt.a and libpsl.a
- GMTINCDIR - Location of GMT include files gmt.h, grd.h, and pslib.h
- LEVITUS - Path of Levitus global water properties data file. This is usually $MBSYSTEM_HOME/share/annual.
- PROJECTIONS - Path of PROJ4 projections database. This is usually $MBSYSTEM_HOME/share/Projections.dat.
These two parameters are required to build the graphical tools mbedit, mbnavedit, mbvelocitytool, mbnavadjust, mbgrdviz, and mbeditviz. If these parameters are not both set, no graphical tools will be built.
- MOTIFINCDIR - Location of Motif include files.
- MOTIFLIBS - X11 and Motif libraries required for graphical tools.
This parameter must be set to build the openGL tools mbgrdviz and mbeditviz:
- OPENGLLIBS - OpenGL libraries required for new graphical tools, including mbgrdviz and mbeditviz. If this parameter is not set, mbgrdviz and mbeditviz will not be built
This parameter must be set to build the sonogram calculation program mbsegypsd:
- FFTWLIBDIR - location of FFTW library providing fast Fourier transform.
- FFTWINCDIR - location of FFTW include files
This parameter must be set for the tidal modeling program mbotps to work:
- OTPSDIR - location of OTPSnc tide prediction program predict_tide.
This optional parameter can be used to specify a non-default C compiler:
- CC - C compiler to be used.
These optional parameters can be used to specify linking with an independent installation of the PROJ4 library. In this case, the PROJ4 library included with MB-System will not be built.
- PROJLIB - Path to PROJ4 library (usually libproj.a)
- PROJINCDIR - Location of PROJ4 include file proj_api.h
These optional parameters can be used to specify linking with an independent installation of the GSF library. In this case, the GSF library included with MB-System will not be built.
- GSFLIB - Path to GSF library (usually libgsf.a)
- GSFINCDIR - Location of GSF include file gsf.h
install_makefiles, do the following:
% cd mbsystem-5.1.3
Because install_makefiles is a perl script, the executable perl must
be available in the installer's path. Once install_makefiles has been
configured and run, give the command "make all" to generate the
% make all
The make command will descend recursively down through the directory
structure, compiling source files, linking object files, and copying
and manual pages to the appropriate directories. The executables will
placed in mbsystem-5.1.3/bin, the libraries in mbsystem-5.1.3/lib, and
the manual pages
Naturally, in order for users to use the MB-System utilities, the
containing the executables must be included in their path. Altering the user path variable is generally accomplished by editing the initialization files hidden in the user's home directory. Which files need to be edited depends on which command line shell is being used. If the user works with csh, then the .cshrc and .login files need to be changed. If the shell is bash, then the .bashrc and .profile files must be altered. See the manual pages for the relevant shell program to determine how to set the user environment. The
perl must also be available in the user's path for most of the macros
Most users will also wish to specify which program they generally
to view Postscript plots on their screen. This parameter is set
with the mbdefaults program (see the mbdefaults manual page for
Popular open source options for Postscript display include ghostview and gv. The postscript plots can also be imported into proprietary tools like Adobe Illustrator, Adobe Acrobat, or Preview on MacOs X. On old Unix machines, pageview worked well on Sun workstations running Solaris, and xpsview on on Silicon
Graphics machines running Irix.
Last Updated: $Id: mbsystem_how_to_get.html 1863 2010-06-08 00:44:13Z caress $
to MB-System Home Page...