This download is current as of May 3, 2002
libioapi_v2.1.a
instead of
libioapi_new.a
Release Version 2.1 of the I/O API and the I/O -related
tool and sample programs is available
here in source code form. New features of this release are
documented here.
Makeinclude
files are available for the following
platforms:
From these examples and from a knowledge of the compiler user manual,
it should be relatively easy to build Makeinclude
files
for most UNIX or UNIX-like platforms and compilers. Instructions
for building the I/O API library libioapi_v2.1.a
and the I/O API tool executable programs are as follows:
ioapi_21.tar.gz
.
It contains directories ioapi
for the
I/O API library source code,ioapi_doc
for the HTML documentation, and ioapi_tools
for the related tool programs.
ioapi_21.tar.gz
(with Gnu tar,
tar xvfz ioapi_v2.1.tar.gz
does unzip-untar all in one step).
setenv BIN <machinetype>
<machinetype>
matches the
extension on one of the Makeinclude.*
(building your own Makeinclude
if yours
is not one of the supported systems).BIN
is
setenv BIN `uname -s``uname -r | cut -d.
-f1`
although there are exceptions where more work is needed
for Cray, SGI and Linux systems, and F90 or DEBUG
compiles.
../$BIN
relative
to the source code directories for the I/O [;API and
tools.
Edit the Makefile to put OBJDIR wherever you want it
(if you want somewhere other than the default
../$BIN
location)
ioapi
,
type make to build the object library. The
current build process will generate
$OBJDIR/libioapi_v2.1.a
(to distinguish it
from earlier Version 1 $OBJDIR/libioapi.a
);
mv it to libioapi.a
or
libm3io.a
, if desired.
ioapi_tools
, type either make
(if you have a F90-compliant Fortran compiler), or
make f77
(if you don't) to build the
tool-program executables (adjusting the LIB
make-variable if you renamed
$OBJDIR/libioapi_v2.1.a
in the preceeding
step). Note that there are a number of these programs
that do require F90: dayagg, ginterp,
m3cple, m3agmax, m3agmask, m3combo, m3merge, mtxblend,
mtxbuild, mtxcalc, mtxcple, presterp,
and
selmrg2d
.
NOTE: On the Sun and SGI platforms, there are link incompatibilities between f77 and f90, caused by the fact that these vendors' f77 and f90 by default use different system libraries. Compaq, Cray, and IBM compilers do not seem to do this; however, it is probably advisable not to mix f77 and f90 compiles on a not-well-understood new platform.
I/O API usage requires archive libraries libioapi.a compiled for your modeling platform. It also requires the Unidata netCDF library libnetcdf.a, version 3.x or later (NOTE: certain token-value parameters were changed between netCDF 2.x and 3.x; all that is required to build the I/O API for netCDF 2.x is to use that version's netcdf.inc INCLUDE-file and recompile libioapi.a.). If you are running in coupled-model mode, you also need the model-coupling library, as well as PVM 3.4 or later.
Both the libioapi.a object library and the m3tools.tar.gz set of I/O API-related programs are available for the following list of currently-supported host architectures:
Please go to the EDSS Registration and Download page for more information about availability, software registration, and downloading of multiple EDSS subsystems, including not only the I/O API and its related tools but also the PAVE visualization system, the EDSS Study Planner, and the SMOKE emissions model.
On the other hand, its author thinks it is good stuffTM and welcomes comments and suggestions.