v.faultdirections

Creates a polar plot of fault directions

v.faultdirections [-a] map=name column=name [step=integer] [legend_angle=float] [--verbose] [--quiet] [--qq] [--ui]

Example:

v.faultdirections map=name column=name

grass.script.run_command("v.faultdirections", map, column, step=10, legend_angle=0.0, flags=None, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("v.faultdirections", map="name", column="name")

Parameters

Command linePython (grass.script)

map=name [required]
    Name of vector map
    Or data source for direct OGR access
column=name [required]
    Attribute column containing azimuth
step=integer
    Step of binning (in degrees)
    Default: 10
legend_angle=float
    Angle at which to put the axis labels
    Default: 0.0
-a
    Use absolute values in legend, instead of percentages
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

map : str, required
    Name of vector map
    Or data source for direct OGR access
    Used as: input, vector, name
column : str, required
    Attribute column containing azimuth
    Used as: input, dbcolumn, name
step : int, optional
    Step of binning (in degrees)
    Default: 10
legend_angle : float, optional
    Angle at which to put the axis labels
    Default: 0.0
flags : str, optional
    Allowed values: a
    a
        Use absolute values in legend, instead of percentages
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

DESCRIPTION

v.faultdirections draws a polar barplot of fault directions, with values binned according to the step parameter. Directions have to be stored in an attribute column of the vector map containing the faults.

The parameter legend_angle allows positioning the radial axis. By setting the flag a the user can choose to display absolute number of lines as radial axis labels instead of the default percentages.

NOTES

The module v.to.db can be used to load azimuth directions into the attribute table.

The plot can be saved to a graphics file interactively from the matplotlib window.

DEPENDENCIES

This module depends on matplotlib and on tkinter (aka python-tk). It is the users responsibility to make sure both are installed.

EXAMPLE

Load azimuth directions into the attribute map and draw plot:

v.db.addcolumn faultmap col="azimuth double precision"
v.to.db faultmap option=azimuth colum=azimuth
v.faultdirections faultmap column=azimuth step=10

AUTHOR

Moritz Lennert

SOURCE CODE

Available at: v.faultdirections source code (history)
Latest change: Thursday Feb 20 13:02:26 2025 in commit 53de819