NCL Home > Documentation > Functions > WRF, Graphics routines

wrf_map_overlays

Overlays different plot id's over a map background.

Available in version 5.0.1 or later.

Prototype

load "$NCARG_ROOT/lib/ncarg/nclscripts/csm/gsn_code.ncl"
load "$NCARG_ROOT/lib/ncarg/nclscripts/wrf/WRFUserARW.ncl"

	function wrf_map_overlays (
		nc_file   : file,     
		wks       : graphic,  
		plots [*] : graphic,  
		res1  [1] : logical,  
		res2  [1] : logical   
	)

Arguments

nc_file

Input netCDF file name.

wks

An NCL Workstation identifier. The identifier is one returned either from calling gsn_open_wks or calling create to create a Workstation object.

plots

Plots to overlay over map background, possibly created by calls to wrf_contour and/or wrf_vector.

res1

A plot resource list. Set to True if you want to advance the frame before creating the next frame. Set to False if you do not want to advance the frame. Use False only if you plan on adding additional text/lines/symbols to the frame before advancing it.

res2

A map resource list. Set to True if you want to advance the frame before creating the next frame. Set to False if you do not want to advance the frame. Use False only if you plan on adding additional text/lines/symbols to the frame before advancing it.

Description

Documentation for this function is still under construction. This function will be available in version 5.0.1, but if you have V4.3.1 or V5.0.0 of NCL, you can download this new WRFUserARW.ncl script and use it in place of the old one.

This function creates a map background, and overlays the given graphical plots. It then returns the map plot that contains all the overlaid plots.

wrf_map_overlays is part of a library of functions and procedures in WRFUserARW.ncl written to help users plot ARW WRF model data. This function replaces wrf_map_overlay.

WRF-related questions should be sent to wrfhelp@ucar.edu.

See Also

wrf_contour, wrf_vector, wrf_overlays

Examples

Example 1

  load "$NCARG_ROOT/lib/ncarg/nclscripts/csm/gsn_code.ncl"
  load "$NCARG_ROOT/lib/ncarg/nclscripts/wrf/WRFUserARW.ncl"

  a = addfile("wrfout_d01_2000-01-24_12:00:00.nc","r")

  wks = gsn_open_wks("x11","test")

  time = 1
  slp = wrf_user_getvar(a,"slp",time)  ; slp
        wrf_smooth_2d( slp, 3 )        ; smooth slp

  tc2 = wrf_user_getvar(a,"T2",time)   ; T2 in Kelvin
  u10 = wrf_user_getvar(a,"U10",time)  ; u at 10 m
  v10 = wrf_user_getvar(a,"V10",time)  ; v at 10 m

  rest = True
  rest@cnFillOn = True
  contour_t = wrf_contour(a,wks,tc2,rest)

  resp = True
  resp@cnLineColor = "NavyBlue"
  contour_p = wrf_contour(a,wks,slp,resp)

  resw = True
  vector = wrf_vector(a,wks,u10,v10,resw)

  over_id = wrf_map_overlays(a, wks,(/contour_t,contour_p,vector/),True,True)

You can see some other example scripts and their resultant images at:

http://www.mmm.ucar.edu/wrf/OnLineTutorial/Graphics/NCL/