NCL Website header
NCL Home > Documentation > Functions > WRF, Graphics routines


Overlays different plot id's over a map background (deprecated in version 5.1.0).


load "$NCARG_ROOT/lib/ncarg/nclscripts/csm/gsn_code.ncl"      ; These two libraries are automatically
load "$NCARG_ROOT/lib/ncarg/nclscripts/wrf/WRFUserARW.ncl"    ; loaded from NCL V6.4.0 onward.
                                                              ; No need for user to explicitly load.

	procedure wrf_map_overlay (
		wks       : graphic,  
		map       : graphic,  
		plots [*] : graphic,  
		res   [1] : logical   



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


Graphical map background, possibly created by a call to wrf_map.


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


A plot resource. 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.


This procedure will be deprecated in version 5.1.0. Use the much more versatile function wrf_map_overlays instead.

Overlay a number of graphical plots over a map background on the given workstation.

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

WRF-related questions should be sent to

See Also

wrf_contour, wrf_vector, wrf_map, wrf_overlay


Example 1

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

  a = addfile("","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

  map = wrf_map(wks,a,True)

  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)

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