Skip to content

README.rdoc

Latest commit

 

History

History
73 lines (49 loc) · 2.75 KB

README.rdoc

File metadata and controls

73 lines (49 loc) · 2.75 KB

iconPlot - General purpose plot script for the ICON climate model

This package contains a plotscript for:

* contour and vector/streamline plots
* overlay of both
* vertical sections
* representing the ICON grid

Installation

Download and run icon_plot.ncl directly with ncl

ncl icon_plot.ncl altLibDir='"."'

or use nclsh from the contrib directory for easyer command line options

nclsh icon_plot.ncl -altLibDir=.

Note that a config file $HOME/.icon_plot.rc is read in if available. Any commandline options can be set here. This is especially usefull for setting the altLibDir.

Requirements

NCL 6.0 and CDO 1.5.x are required

Usage

Basic Usage:

ncl   icon_plot.ncl 'iFile="path/file.nc"' 'varName="ELEV"' 'oFile="test"' timeStep=1  levIndex=1
nclsh icon_plot.ncl -iFile=path/file.nc    -varName=ELEV    -oFile=test   -timeStep=1 -levIndex=1

Select an special area of the globe with mapLLC (LowerLeftCorner) and mapURC (UpperRightCorner) 

ncl   icon_plot.ncl 'iFile="path/file.nc"' 'varName="W"' 'mapLLC=(/35.0, -8/)' 'mapURC=(/55, 8/)'
nclsh icon_plot.ncl -iFile=path/file.nc    -varName=W    -mapLLC=35.0,-8       -mapURC=55,8

Masking:

ncl icon_plot.ncl 'iFile="oce_aqua_planet_O.R2B04L4_0001.nc"' 'varName="ELEV"' 'maskName="wet_c"' 
ncl icon_plot.ncl 'iFile="oce.nc"' 'varName="W"' 'maskName="topo"' 'maskFile="icon_mask.nc"'

Vectorplot:

ncl icon_plot.ncl 'iFile="oce.nc"' 'vecVars="u-veloc v-veloc"' 'oFile="test"'

Vertical cross section:

ncl icon_plot.ncl 'iFile="iconOutput.nc"' 'secLC=(/ 0.0,-90.0 /)' 'secRC=(/ 0.0,90.0/)' 'oType="png"' 'rStrg=""' 'tStrg="ICON coupled aqual planet"'

Overlay plot (vectors over contour plot)

ncl   icon_plot.ncl  'iFile="iconOutput.nc"' 'varName="T"' 'vecVars="u-veloc v-veloc"'
nclsh icon_plot.ncl  -iFile=iconOutput.nc    -varName=T    -vecVars=u-veloc,v-veloc

same for current atmo input

ncl icon_plot.ncl  'iFile="atm.nc"' 'varName="T"' 'vecVars="U V"'

Atmosphere input plotted on the 3rd height level

ncl icon_plot.ncl  'iFile="atm.nc"' 'varName="T"' 'atmLev="h"' levIndex=2

same but on pressure level

ncl icon_plot.ncl  'iFile="atm.nc"' 'varName="T"' 'atmLev="p"' levIndex=2

Options can be combined execept showGrid=True (with nclsh: -showGrid) with vector and overlay plots

Recommendations

Use the provided ncl wrapper script nclsh:

ncl icon_plot.ncl 'iFile="iconOutput.nc"' 'secLC=(/ 0.0,-90.0 /)' 'secRC=(/ 0.0,90.0/)' 'oType="png"' 'varName="T"' vecVars='"u v"'

becomes

nclsh icon_plot.ncl -iFile=iconOutput.nc -secLC=0.0,-90.0 -secRC=0.0,90.0 -oType=png -varName=T -vecVars=u,v

This is useful for write script which call other NCL application.

Support, Issues, Bugs, …

write an issue or use mail

License

iconPlot uses the GPLv2 License