# How to create a custom map background file for use with the WRF SI GUI
#
# Author: Paula.McCaslin@noaa.gov   05 Nov 2003
#
# The gui creates background maps by reading in vector lat/lon coordinates 
# then drawing map vector lines. 
# The binary cartographic data (.bcd) contains vector data lat/lon
# coordinates. The extended binary cartographic data (.bcx) files are 
# are essentially the same as a .bcd file but includes a text string 
# associated with each record. Both bcd and bcx files are created from 
# ARCINFO shape files. We currently get our shape files from: 
# http://www.nws.noaa.gov/geodata
# 
# Shape files are produced by the ArcView GIS system but the format
# is public domain and so if you find a shape file that contains
# what you want this software can make a .bcd out of it as long 
# as the coordinate system is decimal lat/lon.

# Please note: all .bcd files currently have the same endian sense, 
# which will be the HP endian (big-endian) sense. IEEE standards mean 
# that byte swapping is trivial. You can always tell if swapping is needed 
# by whether either of the two high bytes of the point count that goes 
# with each record have non-zero data (i.e. count is less than zero or
# greater than 65535). 
# 
# It is not a good idea to mix little-endian architecture bcd files
# with big-endian bcd files because the WRF SI GUI is setup to read
# only one format at a time. There are plans to make the WRF SI GUI 
# flexible enough to understand both systems.
#
# The software to convert shape files to bcd files originates from the 
# NWS AWIPS mapping routines. Download the WRF SI GUI map conversion software 
# from: http://wrf-model.org/gui/map/cartographic_data.tar.gz (3.9M)
#

# Below are instructions to build the key executables: bcdProc and shp2bcd.
# -------------------------------------------------------------------

tar xvzf cartographic_data.tar.gz
cd cartographic 

# Set your system's paths for the env vars in env_setup.
source env_setup

cd $STAGING/awips_common/src/foundation
make buildlib

cd $STAGING/awips_common/src/logStream
make buildlib

cd $STAGING/awips_common/src/util_d2d
make buildlib

cd $STAGING/D-2D/src/mapping
make buildlib

cd $STAGING/D-2D/src/geoLib
make buildlib
make buildexe

cd $STAGING/D-2D/src/dm/shapefile
make buildexe


#
# Below are instructions to create a bcd file from an ARCINFO shape file.
# Additional information is available in $STAGING/doc/shp2bcd.doc.html
# and $STAGING/doc/bcdProc.doc.html.
# -------------------------------------------------------------------
 
mkdir $STAGING/dataFiles
cd $STAGING/dataFiles
 
# Download, for example, a U.S. interstate data file to $STAGING/dataFiles.
# http://www.nws.noaa.gov/geodata/catalog/transportation/data/in15oc03.zip
# (Or, press the "Download Compressed Shapefile" button at
# http://www.nws.noaa.gov/geodata/catalog/transportation/html/interst.htm)

# Unzip the file.
unzip in15oc03.zip
# Run shp2bcd 
$STAGING/D-2D/bin/shp2bcd c $STAGING/dataFiles/in101503 US_Interstates.bcd
# Make the new bcd file available to the WRF SI GUI.
mv US_Interstates.bcd $SOURCE_ROOT/gui/data/maps