GPVECT(1)

NAME

gpvect - drawing 2-dim vector fiels. Contour/tone of scalar field can be plotted simultaneously.

  USAGE

The first command form is for only vector field plotting.
    % gpvect [options] gturl_x gturl_y ....

where the format of the gturl is
    path[@|/]varname[,dimname=pos1[:pos2[:thinning_intv]][,dimname=...]]

The command loads two gphys variables in each time and draws vector field whose x and y components are the first and the second argument, gturl_x gturl_y.

When the slice parameters are the same throughout the all Gphys variables, the following form can be used:
    % gpvect --slice <slice> [options] file@var_x file@var_y ...

where the format of the slice is
    dimname=pos1[:pos2[:thinning_intv]][,dimname=...]]

The second command form is
    % gpvect --scalar [options] gturl_c gturl_x gturl_y ....

In this case the command loads three gphys variables in each time and draws a contour/tone of the first argument gturl_c, and vector fields whose x and y components are the second and the thrid argument, gturl_x gturl_y.

  OPTIONS

  GLOBAL OPTIONS

--help:
    print this message.

--slice url:
    set the slicing parameters.

--wsn [1-4]:
    set work staion number. each number represent output device.

    • 1 => X window.

    • 2 => PS file. (named dcl.ps)

    • 3 => Tektronix output.

    • 4 => GTK Windows (depend on dcl-5.3).TP
    --clrmap [1-]: set colormap to draw tone/contour. default is 1.

--itr [1-4,5-7,10-15,20-23,30-33]:
    set axis scale. default is 1.

    • 1: linear scale for x/y axis

    • 2: linear scale for x , log scale for y axis

    • 3: log scale for x , linear scale for y axis

    • 4: log scale for x/y axis.TP
    --similar [simfac,vxoff,vyoff]: (for 5<=itr<=7) set similarity parameters which are fed in DCL.grssim.

--map_axis [uxc,uyc,rot]:
    (for 10<=itr<=33) set mapping parameters which are fed in DCL.umpcnt.

--title:
    set title of figure

--aspect <aspect>:
    set aspect ratio of Viewport. default is 2.0.

--noannotate:
    not draw annotations.

--animate/anim <dim>:
    plot animation along <dim>. <dim> must be name of dimension.

--alternate, --Ga:
    enable to backing store.

--nowait, --Gw:
    not wait for any actions if animate

--reverse, --Gr:
    plot animation reversible if animate

--smooth, --Gaw:
    equal to --anlternate && --nowait

--exch:
    exchange(transpose) x/y axis.

--mean <dim>:
    mean along axis <dim>.

--eddy <dim>:
    deviation from mean along axis <dim>.

--m, --map <map_type>:
    plot map. itr number must be set. this option is neglect if itr number is 1-4. abailable map type is coast_world, border_world, plate_world, state_usa, coast_japan, pref_japan

--scalar:
    plot scaler field (contour,tone)

--xx:yyyy=value:
    specify Dennou Club Library internal variable.

    • "xx" => a package name prefix of DCL (eg. sg=>sgpack).

    • "yy" => is a variable name of DCL.

    • "value" => is a value of the DCL variable.SS CONTOUR/TONE OPTIONS

--shade:
    make contour and tone plot.

--noshade:
    make contour plot, without tone.

--nocont:
    make tone plot, without contour.

--range [min:max]:
    set min/max value for contour/tone plot. min or max must be set.

--crange:
    set min/max value for contour plot. this is more dominant than --range

--srange:
    set min/max value for tone plot. this is more dominant than --interval/int

--interval,--int [num]:
    set interval value for contour/tone plot.set the number of lines if you set negative value.

--cint:
    set interval value for contour plot. this is more dominant than --interval/int

--sint:
    set interval value for tone plot. this is more dominant than --interval/int.

--levels:
    set values of contour/tone levels.

--clevels:
    set values of contour levels.

--slevels:
    set tone of contour levels.

--patterns:
    set each patterns for tone plot.

--tone [a|e|f|b|c]:
    set tone subroutine:

    • a (=> tone routine is selected automatically depending on the datasize)

    • e (=> DCL.uetone is used)

    • f (=> DCL.uetonf is used)

    • b (=> DCL.uetonb is used)

    • c (=> DCL.uetonc is used).TP
    --nocolorbar: do not draw color bar

--nozero:
    do not draw zero contour

--udsfmt [strings]:
    change contour label format. see UDCNTR/DCL manual for the format.

  VECTOR OPTIONS

--noflow_vect:
    DCL::ugvect is used.

--xintv <xintv>:
    interval of data sampling in x

--yintv <yintv>:
    interval of data sampling in y

--factor <factor>:
    (Effective only if flow_vect) scaling factor to strech/reduce the arrow lengths

--unit_vect:
    Show the unit vector

--max_unit_vect:
    (Effective only if flow_vect && unit_vect) use the maximum arrows to scale the unit vector

--ux_unit <value>:
    (Effective only if flow_vect) length of the x direction unit vector (precedence of this option is lower than max_unit_vect)

--uy_unit <value>:
    (Effective only if flow_vect) length of the y direction unit vector (precedence of this option is lower than max_unit_vect)

--xscale <value>:
    (Effective only if noflow_vect) scaling of the x direction vector

--yscale <value>:
    (Effective only if noflow_vect) scaling of the y direction vector

  EXAMPLES

For the first command format,
    % gpvect data.nc@vx data.nc@vy
    % gpvect data.nc@vx,lon=0 data.nc@vy,lon=0
    % gpvect --scalar data.nc@temp datax.nc@vx datay.nc@vy
    % gpvect --scalar --anim t --nocont data.nc@temp data.nc@vx data.nc@vy

For the second command format,
    % gpvect --scalar --slice lat=0 data.nc@temp data.nc@vx data.nc@vy

  HISTORY
    2007/07/02  S Takehiro (created based on gpview)
    2007/07/04  S Takehiro (polar coodinate vector component conversion
                            from U to N coordinates moved to ggraph.rb)
    2007/07/06  S Takehiro (default title was set when --scalar option is given)
    2009/09/30  S Takehiro (option --nocolorbar and --nozero implemented)
    2010/03/10  Y SASAKI (change help block into RD format)
    2010/07/16  Y SASAKI (option --clrmap implemented)
    2011/07/29  S Takehiro (option --clrmap fixed)
    2012/02/19  S Takehiro (description for gturl format updated)
    2012/07/28  S Takehiro (option --ux_unit, --uy_unit, --xscale, --yscale
                            implemented)
    2014/02/21  Y Naito && S Takehiro (implement DCL internal variable setting,
                                       add option --udsfmt)
    2014/02/23  S Takehiro (option --tonf is changed to --tone)
    2014/03/10  Y Kawai && S Takehiro (setting labels for contours)