pygmt.Figure.velo

Figure.velo(data=None, scaling=None, **kwargs)

Plot velocity vectors, crosses, and wedges

Reads data values from files, numpy array or panda dataframe and will plot velocity arrows on a map. Most options are the same as for plot, except -S.

Must provide data and scaling.

Full option list at https://docs.generic-mapping-tools.org/latest/supplements/geodesy/velo.html

Aliases:

  • B = frame

  • C = cmap

  • J = projection

  • R = region

  • U = timestamp

Parameters

  • data (str or 2d array or dataframe) – Either a data file name, a 2d numpy array or a panda dataframe.

  • projection (str) – Required if this is the first plot command. Select map projection.

  • region (str or list) – Required if this is the first plot command. 'xmin/xmax/ymin/ymax[+r][+uunit]'. Specify the region of interest.

  • scaling (str) –

    Selects the meaning of the columns in the data file and the figure to be plotted. In all cases, the scales are in data units per length unit and sizes are in length units (default length unit is controlled by PROJ_LENGTH_UNIT unless c, i , or p is appended).

    ”-Sevelscale/confidence[+ffont]”

    Velocity ellipses in (N,E) convention. velscale sets the scaling of the velocity arrows. The confidence sets the 2-dimensional confidence limit for the ellipse, e.g., 0.95 for 95% confidence ellipse. font sets the font and size of the text [9p,Helvetica,black]. The ellipse will be filled with the color or shade specified by the -G option [default transparent]. The arrow and the circumference of the ellipse will be drawn with the pen attributes specified by the -W option. Parameters are expected to be in the following columns:

    1,2: longitude, latitude of station (-: option interchanges order) 3,4: eastward, northward velocity (-: option interchanges order) 5,6: uncertainty of eastward, northward velocities (1-sigma) (-: option interchanges order) 7: correlation between eastward and northward components 8: name of station (optional).

    ”-Snbarscale”

    Anisotropy bars. barscale sets the scaling of the bars. Parameters are expected to be in the following columns:

    1,2 : longitude, latitude of station (-: option interchanges order) 3,4 : eastward, northward components of anisotropy vector (-: option interchanges order)

    ”-Srvelscale/confidence[+ffont]”

    Velocity ellipses in rotated convention. velscale sets the scaling of the velocity arrows. The confidence sets the 2-dimensional confidence limit for the ellipse, e.g., 0.95 for 95% confidence ellipse. font sets the font and size of the text [9p,Helvetica,black]. The ellipse will be filled with the color or shade specified by the -G option [default transparent]. The arrow and the circumference of the ellipse will be drawn with the pen attributes specified by the -W option. Parameters are expected to be in the following columns:

    1,2: longitude, latitude, of station (-: option interchanges order) 3,4: eastward, northward velocity (-: option interchanges order) 5,6: semi-major, semi-minor axes 7: counter-clockwise angle, in degrees, from horizontal axis to major axis of ellipse. 8: name of station (optional)

    ”-Swwedgescale/wedgemag”

    Rotational wedges. wedgescale sets the size of the wedges. Values are multiplied by wedgemag before plotting. For example, setting wedgemag to 1.e7 works well for rotations of the order of 100 nanoradians/yr. Use -G to set the fill color or shade for the wedge, and -E to set the color or shade for the uncertainty. Parameters are expected to be in the following columns:

    1,2: longitude, latitude, of station (-: option interchanges order) 3: rotation in radians 4: rotation uncertainty in radians

    ”-Sxcross_scale”

    gives Strain crosses. cross_scale sets the size of the cross. Parameters are expected to be in the following columns:

    1,2: longitude, latitude, of station (-: option interchanges order) 3: eps1, the most extensional eigenvalue of strain tensor, with extension taken positive. 4: eps2, the most compressional eigenvalue of strain tensor, with extension taken positive. 5: azimuth of eps2 in degrees CW from North.

Other Parameters

  • -A (bool or str) – Modify vector parameters. For vector heads, append vector head size [Default is 9p]. See Vector Attributes for specifying additional attributes.

  • frame (str or list) – Set map boundary frame and axes attributes.

  • cmap (str) – File name of a CPT file or C='color1,color2[,color3,...]' to build a linear continuous CPT from those colors automatically.

  • -D (str) – can be used to rescale the uncertainties of velocities (-Se and -Sr) and rotations (-Sw). Can be combined with the confidence variable.

  • -E (str) – Sets the color or shade used for filling uncertainty wedges (-Sw) or velocity error ellipses (-Se or -Sr). [If -E is not specified, the uncertainty regions will be transparent.] (more …)

  • -G (str) – Select color or pattern for filling of symbols or polygons [Default is no fill]. (more …)

  • -L (str) – Draw lines. Ellipses and fault planes will have their outlines drawn using current pen (see -W).

  • -N (str) – Do NOT skip symbols that fall outside the frame boundary specified by -R. [Default plots symbols inside frame only].

  • timestamp (bool or str) – Draw GMT time stamp logo on plot.

  • -W (str) – Set pen attributes for velocity arrows, ellipse circumference and ault plane edges. [Defaults: width = default, color = black, style = solid].

  • -X (str) – '[a|c|f|r][xshift]'

  • -Y (str) – '[a|c|f|r][yshift]' Shift plot origin. (more …)