DOWNLOADING NCL: The most current version of NCL can be downloaded from:

	http://ngwww.ucar.edu/ncl/download.html

	It is recommended that you download the latest version to run these
scripts. The current version is: NCAR Command Language Version 4.2.0.a014

NCL Documentation links:

	The main reference guide for NCL is:

		http://ngwww.ucar.edu/ngdoc/ng/ref/ncl/Overview.html

	Main list of NCL functions and procedures including math and graphics
	functions:
		
		http://ngwww.ucar.edu/ngdoc/ng/ref/ncl/NclFuncsAndProcs.html

	"Getting Started Using NCL" (GSUN) documentation is:

		http://ngwww.ucar.edu/ngdoc/ng/ug/ncl/gsun/

		

IMPORTANT: Before running any of the examples edit the file and change the 
	path in addfiles call to point to your WRF data file.


If you are going to construct or change the scripts, then...

CONTENTS:

In this directory are the file wrf_plot.ncl and wrf_user_ncl. These
files must be loaded in to NCL using the load command in order to use
and of the functions described below.

NOTE:

Many of the functions for creating plots accept optional arguments. Some
of these optional arguments are defined only for those functions and will
not work for every function. There are lists of these options with each
function description. Additionally actual HLU plot resources can be passed
as optional arguments. These resources are defined in the HLU reference
pages : http://ngwww.ucar.edu/ngdoc/ng/ref/hlu/Overview.html

For ContourPlot options:
http://ngwww.ucar.edu/ngdoc/ng/ref/hlu/obj/ContourPlot.obj.html

For VectorPlot options:
http://ngwww.ucar.edu/ngdoc/ng/ref/hlu/obj/VectorPlot.obj.html

For MapPlot options:
http://ngwww.ucar.edu/ngdoc/ng/ref/hlu/obj/MapPlot.obj.html

To set optional arguments create a logical variable:

opts = True

Then set optional arguments as NCL attributes:

opts@LevelLabel = 400.0
opts@UnitLabel = "Kg^2/s^2"

LIST OF FUNCTIONS AND OPTIONAL ARGUMENTS:

function wrf_open_ncgm(filename[1]:string)

	Opens a NCAR Graphics computer graphics metafile (NCGM) for output.

	Args:
		filename : The name of the file as a string.

	Optional Args: NONE 

function wrf_open_X11()

	Opens and X11 window to the current display

	Args: NONE

	Optional Args: NONE

function wrf_open_PS(filename[1]:string)

	Opens a PostScript file for output

	Args:
		filename : the name of the postscript file
	
	Optional Args: NONE

function wrf_new_vector(
	wks[1]: graphic, 
	data_u[*][*]:numeric, 
	data_v[*][*]:numeric, 
	opt_args[1]:logical)

	Creates a New vector plot. Assign return values to a variable and call
	draw to display.

	Args:
		wks: value returned from wrf_open_*() calls
		data_u: horizontal vector component must be same dimensions as
			data_v
		data_v: vetical vector component
		opt_args:  Optional arguments see below

	Optional Args:

		@NoTitles - prevents any titles from being drawn
		@NumVectors - number of vector accross bottom
		@WindBarbsOn - True switches on wind barbs
		@UnitLabel - title of lable bar
		@MainTitle - title above plot
		@TimeLabel - time label upper right corner
		@LevelLabel - level label upper left corner
	



function wrf_new_fill_contour(
	wks[1]: graphic, 
	data[*][*]:numeric, 
	opt_args[1]:logical)

	Creates a new contour plot. Assign return values to a variable and call
	draw to display.

	Args:
		wks: value returned from wrf_open_*() calls
		data: Data to contour, must not be constant and must be 2D
		opt_args:  Optional arguments see below

	Optional Args:
		@NoTitles - prevents any titles from being drawn
		@UnitLabel - title of lable bar
		@MainTitle - title above plot
		@TimeLabel - time label upper right corner
		@LevelLabel - level label upper left corner

procedure wrf_update_contour_data(wks[1]:graphic,cn[1]:graphic, data,opt_args)

	Use this to change data of existing plot

	Args: 
		wks : workstation returned from wrf_open*()
		data : new data
		opt_args: supports same optional arguments as 
			wrf_new_fill_contour

procedure wrf_update_vector_data(wks[1]: graphic,vc[1]:graphic, data,opt_args)
	Use this to change data of existing plot

	Args: 
		wks : workstation returned from wrf_open*()
		data : new data
		opt_args: supports same optional arguments as 
			wrf_new_vector

function wrf_new_map(wks[1]:graphic, in_file[1]:file, opt_args[1]:logical

	Use this to create a map object based on the map information available
	in a wrf netCDF file.

	Args:
		wks : workstation returned from wrf_open*()
		in_file: the in which wrf map information is described
		opt_args: supports resources for the map object

procedure wrf_mapoverlay(map[1]:graphic,plot[1]:graphic)

	Use this to overlay contours and vectors over maps

	Args:
		map: the map created from wrf_new_map
		plot: the plot created from wrf_new_*_contour or wrf_new_vector

procedure wrf_maplabel(wks[1]:graphic,map[1]:graphic,opt_args[1]:logical)

	This procedure will create annotations for the map created by 
	wrf_new_map. The annotations by default will appear on the left (lat) 
	and bottom (lon). The annotations will appear at locations based on
	the value of mpGridSpacingF. The default is every 10 degrees.

	Args:
		wks: The output workstation
		map: the map created by wrf_new_map
		opt_args: supports several optional arguments

			@LabelFontHeight: set to change default font size
			@LabelFont: set to change default font 
	                @LatSide: can be set to "Top" "Bottom" "Left" or "Right"
	                @LonSide: can be set to "Top" "Bottom" "Left" or "Right"
	                @LonLabelsOn: False to turn off labeling of longitudes
	                @LatLabelsOn: False to turn off labeling of latitudes
	                @LatStride: Number of labels to skip between lat labels
	                @LonStride: Number of labels to skip between lon labels