NCL Home > Documentation > Functions > Climatology

clmMonTLLL

Calculates long term monthly means (monthly climatology) from monthly data: (time,lev,lat,lon) version

Prototype

load "$NCARG_ROOT/lib/ncarg/nclscripts/csm/contributed.ncl"  ; This library is automatically loaded
                                                             ; from NCL V6.2.0 onward.
                                                             ; No need for user to explicitly load.

	function clmMonTLLL (
		x [*][*][*][*] : float or double   
	)

	return_val [12][*][*][*] :  numeric

Arguments

A four-dimensional array of type float or double. Dimensions must be time, lev, lat, lon. The size of time dimension must be a multiple of 12. The dimensions must be named.

Return value

An array of the same size and type as x except that the leftmost dimension will be of size 12.

Description

Calculate long term monthly means (monthly climatology) from monthly data.

Examples

The following require that contributed.ncl be loaded prior to invoking the function.

       load "$NCARG_ROOT/lib/ncarg/nclscripts/csm/contributed.ncl"

Example 1

Calculate the monthly climatology of u(time,lev,lat,lon) where

[time | 528] x [lev | 23] x [lat | 128] x [lon | 256]

This represent 44 years [44*12=528] of monthly data. Consider the following code snippet:

      f    = addfile("x.1958-2001.nc, "r")
      u    = f->U
      uClm = clmMonTLLL( u )
      printVarSummary(uClm)

The result is: