GRDVECTOR

Section: Misc. Reference Manual Pages (l)
Updated: DATE
Index Return to Main Contents
#ifdef SI #define UNIT cm #define PARAMS 0.075/0.3/0.25 #else #define PARAMS 0.03/0.12/0.1 #define UNIT inch #endif  

NAME

grdvector - Plot vector fields from grdfiles  

SYNOPSIS

grdvector compx.grd compy.grd -Jparameters [ -A ] [ -Btickinfo ] [ -Ccptfile ] [ -E ] [ -Fred/green/blue ] [ -Gfill] [ -Ix_inc[m][/y_inc[m]] ] [ -K ] [ -N ] [ -O ] [ -P ] [ -Qparameters ] [ -Rwest/east/south/north[r] ] [ -Sscale ] [ -T ] [ -U[/dx/dy/][label] ] [ -V ] [ -Wcontourpen ] [ -Xx-shift ] [ -Yy-shift ] [ -Zzlevel ] [ -ccopies ]  

DESCRIPTION

grdvector reads two 2-D gridded files which represents the x- and y-components of a vector field and produces a vector field plot by drawing vectors with orientation and length according to the information in the files. Alternatively, polar coordinate components may be used (r, theta). grdvector is basically a short-hand for using 2 calls to grd2xyz and pasting the output through psxy -SV.
compx.grd
Contains the x-component of the vector field.
compy.grd
Contains the y-component of the vector field. #include "explain_-j.txt"
 

OPTIONS

No space between the option flag and the associated arguments.
-A
Means grdfiles have polar (r, theta) components instead of Cartesian (x, y). #include "explain_-b.txt"
-C
Use cptfile to assign colors based on vector length.
-E
Center vectors on grid nodes [Default draws from grid node].
-F
Sets the color used for Frame and annotation. [Default is black]
-G
Sets color or shade for vector interiors [Default is no fill]. #include "explain_-K.txt"
-N
Do NOT clip vectors at map boundaries [Default will clip]. #include "explain_-O.txt" #include "explain_-P.txt"
-Q
Select vector plot [Default is stick-plot]. Optionally, specify parameters which are arrowwidth/headlength/headwidth (in UNIT) [Default is PARAMS]. Append nsize which will cause vectors shorter than size to have their appearence scaled by length/size. #include "explain_-R.txt" Specify a subset of the grid.
-S
Sets scale for vector length in data units per UNIT [1].
-T
Means azimuth should be converted to angles based on the selected map projection. #include "explain_-U.txt" #include "explain_-V.txt"
-W
Set pen attributes used for vector outlines [Default: width = 1, color = 0/0/0, texture = solid]. #include "explain_-XY.txt"
-Z
Means the angles provided are azimuths rather than direction (requires -A). #include "explain_-c.txt"
 

EXAMPLES

To draw the vector field given by the files r.grd and theta.grd on a linear plot using vector rather than stick plot, and scale vector magnitudes so that 10 units equal 1 UNIT, try

grdvector r.grd theta.grd -Jx2 -Q -S0.1 > gradient.ps

 

SEE ALSO

gmt, grdcontour, psxy #include "refs.i"


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 07:10:48 GMT, January 07, 2025