NAP Visualisation using procedure plot_nao

Table of Contents

  1. Introduction
  2. Usage
    1. Options
  3. Examples

Introduction

A NAO can be visualised using procedure plot_nao, which can represent it by: It is possible to animate color-coded images and xy graphs.

The Tcl code is in the files plot_nao.tcl and plot_nao_procs.tcl.

Usage

plot_nao expression ?options?

Options

-barwidth float: (bar chart only) width of bars in x-coordinate units. (Default: 1.0)

-buttonCommand script: executed when button pressed with z-plots (Default: "lappend Plot_nao::${window_id}::save [set Plot_nao::${window_id}::xyz]")

-colors list: Colors of graph elements (lines). (Default: black red green blue yellow orange purple grey aquamarine beige)

-filename string: Name of output PostScript file.

-fill 0 or 1: 1 = Scale PostScript to fill page. (Default: 0)

-gap_height int: height (pixels) of horizontal white gaps (Default: 20)

-gap_width int: width (pixels) of vertical white gaps (Default: 20)

-geometry string: If specified then use to create new toplevel window.

-height int: Desired height (screen units) Type xy/bar: Height of whole window (Default: automatic) Type z: Image height (can be "min max") (Default: NAO dim if within limits)

-help: Display this help page

-key int: width (pixels) of image-key. No key if 0 or blank. (Default: 30)

-labels list: Labels of graph elements (lines). (Default: Use element names i.e. y0, y1, y2, …)

-menu 0 or 1: 0 = Start with menu bar at top hidden. (Default: 1)

-orientation P, L or A: P = portrait, L = landscape, A = automatic (Default: A)

-overlay C, L, S, N or "E expression": Define overlay. C = coast, L = land, S = sea, N = none, E = expr (Default: N)

-ovpal expression: Overlay palette in same form as main palette (Default: black white red green blue)

-palette expression: Main palette defining color map for 2D image. This is matrix with 3 or 4 columns & up to 256 rows. If there are 4 columns then the first gives color indices in range 0 to 255. Values can be whole numbers in range 0 to 255 or fractional values from 0.0 to 1.0. "" = black-to-white. (Default: blue-to-red)

-paperheight distance: E.g. '11i' = 11 inch (Default: '297m' = 297 mm (A4))

-paperwidth distance: E.g. '8.5i' = 8.5 inch (Default: '210m' = 210 mm (A4))

-parent string: parent window (Default: "" i.e. create toplevel window)

-print 0 or 1: 1 = automatic printing (for batch processing) (Default: 0)

-printer string: name (Default: env(PRINTER) if defined, else any printer)

-range expression: defines scaling (Default: auto scaling)

-rank 1, 2 or 3: rank of sub-arrays to be displayed (Default: 3 <<< rank(data))

-scaling 0 or 1: 0 = Start with scaling widget hidden. (Default: 1)

-symbols list: One for each element. Draw at points. Can be plus, square, circle, cross, splus, scross, triangle or single character (e.g. "*") (Default: "" i.e. none)

-title string: title (Default: NAO label (if any) else expression)

-type string plot-type ("bar", "xy" or "z") If rank is 1 then default type is "xy". If rank is 2 and n_rows <= 8 then default type is "xy". If rank is 2 and n_rows > 8 then default type is "z". If rank is 3 then type is "z" regardless of this option.

-width int: Desired width (screen units) Type xy/bar: Width of whole window (Default: automatic) Type z: Image width (can be "min max") (Default: NAO dim if within limits)

-xflip 0 or 1: Flip left-right? 0 = no, 1 = yes. (Default: 0)

-xlabel string: x-axis label (Default: name of last dimension)

-yflip 0, 1, ascending or geog: Flip upside down? 0 = no, 1 = yes, ascending = "if y ascending", geog = "if ascending & (y_dim_name = latitude or y_unit = degrees_north (or equivalent))" (Default: geog)

-ylabel string: y-axis label (Default: name of 2nd-last dimension)

The height and width used are limited by the screen dimensions.

Examples

  plot_nao "reshape(0 .. 199, {200 200})" -geometry +0+0
  nap "sales = {{2 5 1}{1 3 8}}"
  nap "month = 3 .. 5"
  $sales set coord "" month
  plot_nao sales -colors "blue red" -symbols "plus cross" -type xy
  $sales set label "Car sales"
  plot_nao sales -labels "Joe Mary" -type bar

Author: Harvey Davies       © 2002, CSIRO Australia.       Legal Notice and Disclaimer
CVS Version Details: $Id: plot_nao.html,v 1.6 2003/05/20 05:31:36 dav480 Exp $