INSTALL file for MADIS (Unix/Linux) MADIS Version 3.7 July 25, 2008 -------------------------------------------------------------------------------- 1) Get the package MADIS source code and prebuilt binaries can be obtained at: http://madis.noaa.gov/madis_api.html From the "Software Download" section on that page, there will be links to the madis-3.7.tar.gz file containing: - Source code only - HP-UX source & binaries - SunOS source & binaries - AIX source & binaries - Linux source & binaries - IRIX/IRIX64 source & binaries 2) Install the package - Decide if you want to use a binary version or build your own. The compilation options used to create the binaries were selected for maximum portability across the various hardware architectures that run under each operating system. Only the default optimization levels have been used with each compiler. If desired, you may be able to gain performance improvements by changing the options for your system and building from the source. The f77 compiler was used for HP-UX, SunOS, and IRIX/IRIX64; the g77 compiler was used for Linux; and the xlf compiler was used for AIX. For more details on the operating system versions that the API has been built and tested with, see the "Supported Systems" section in the README file in this directory. - Decide where you want to install the package. Make the top-level directory (referred to here as $TOP). (Note that the full path through the $TOP directory must be < 239 characters.) - cd $TOP gunzip madis-3.7.tar.gz [or gzip -d if gunzip doesn't work] tar -xvf madis-3.7.tar 3) Build the API library and utility programs - If you've downloaded a binary version you shouldn't have to do the build step (unless you've encountered some problems, or want to make optimizations for your system). - The "SYSTEM DEPENDENT CONFIGURATION" section near the top of $TOP/src/makefile needs to be edited for your environment. The following four items need to be set: 1) Location of the netCDF package. (NETCDF_INC, NETCDF_LIB) 2) Name of the fortran compiler. (FC) 3) Compilation flags. (FFLAGS) 4) Load flags. (LDFLAGS) The makefile has sections showing the choices made for the systems for which binaries are distributed. You may find this useful in determining the settings for other environments. - cd $TOP/src make clean (will clear out object files from previous version) make (will make the utilities & library) 4) Compiling/linking user-written programs - You need to link to the MADIS library and to the netCDF library. Assuming $TOP for the top-level MADIS directory and $NCDF for the top-level netCDF directory, a sample compilation/link command would be: f77 ${FFLAGS} -o test.x test.f $TOP/lib/madislib.a $NCDF/lib/libnetcdf.a - The following FFLAGS options are required at a minimum. You may also wish to review the notes on the FFLAGS settings in the makefile in the src directory as far as other settings that can be used for portability, eliminating compiler warnings, etc. HP-UX FFLAGS=-K AIX FFLAGS=-bmaxdata0x19000000 -bmaxstack:0x5000000 IRIX/IRIX64 FFLAGS=-n32 5) Set up the run-time environment The MADIS data directories are all relative to a top-level directory. You can setup one or more sets of directories (for real-time, test data, archive, etc.) then point to the one you want with the MADIS_DATA environment variable. Here are the directories you need to setup (using $DTOP as the top-level) depending on which MADIS datasets you're planning on accessing: MADIS Dataset Directory ------------- --------- Surface (all sfc datasets) $DTOP/point/maritime/netcdf $DTOP/point/metar/netcdf $DTOP/point/sao/netcdf $DTOP/LDAD/coop/netCDF $DTOP/LDAD/mesonet/netCDF $DTOP/LDAD/urbanet/netCDF $DTOP/LDAD/hfmetar/netCDF Surface (mesonet only) $DTOP/LDAD/mesonet/netCDF Radiosondes $DTOP/point/raob/netcdf NPN hourly winds $DTOP/point/profiler/netcdf Aircraft data $DTOP/point/acars/netcdf Aircraft data profiles at airports $DTOP/point/acarsProfiles/netcdf Radiometers $DTOP/point/radiometer/netcdf Hydrological datasets $DTOP/LDAD/hydro/netCDF Multi-Agency Profilers (MAP) $DTOP/LDAD/profiler/netCDF Satellite winds (operational 3h) $DTOP/point/HDW/netcdf (experimental 1h) $DTOP/point/HDW1h/netcdf Satellite soundings $DTOP/point/POES/netcdf Satellite radiance $DTOP/point/satrad/netcdf Snow dataset $DTOP/LDAD/snow/netCDF WISDOM balloon winds $DTOP/LDAD/WISDOM/netCDF Note that the full path through the $DTOP directory must be < 239 characters. MADIS requires two environment variables at run-time: - MADIS_STATIC points to the static directory in the MADIS installation - MADIS_DATA points to the top of the directory tree where the MADIS (or AWIPS) data files are stored. setenv MADIS_STATIC $TOP/static [C-shell] setenv MADIS_DATA $DTOP MADIS_STATIC=$TOP/static [Bourne shell] MADIS_DATA=$DTOP - AWIPS users should point MADIS_DATA to /data/fxa. - OPeNDAP users should point MADIS_DATA to the top-level URL for their data distribution category on the MADIS web server, with the username and password embedded in the URL. Example for user SAMPLE_madis_public, with password xyz123: setenv MADIS_DATA http://SAMPLE_madis_public:xyz123@www.madis-fsl.org/ madisPublic/cgi-bin/nph-dods/DODS/madis/public (all on one line) Also note that if your password uses a character that can be interpreted by the Unix/Linux shell, you need to prefix it with a \. Example, using password xyz&123: setenv MADIS_DATA http://SAMPLE_madis_public:xyz\&123 ...[etc.]... You can verify that you got it right by setting the environment variable then doing a "printenv MADIS_DATA" command. It should show the complete password without the embedded \. 6) Disk space requirements - The MADIS software requires about 20-30 MB after being built. - Typical requirements per day for the different datasets can be seen at: http://madis.noaa.gov/madis_data_volume.html 7) Sample data installation Thirteen hours of data files are available for most of the datasets. These are made available for anyone who wants to download some data and try out the system before requesting real-time or archived data from MADIS. The sample data can be obtained by following the instructions at: http://madis.noaa.gov/madis_sample_data.html