Skip to main content

VectorFieldRenderer

Summary

Visualizes flow direction and magnitude information in a raster with vector symbols.

Discussion

The referenced raster dataset for the raster object is temporary. To make it permanent, you can call the raster object's save method.

Syntax

VectorFieldRenderer(raster, {is_uv_components}, {reference_system}, {mass_flow_angle_representation}, {calculation_method}, {symbology_name})

Parameter Explanation Data Type

raster

The input raster.

Raster

is_uv_components

Specifies whether the input components represent U-V, or magnitude and direction.

  • True—The input data represents U-V components.

  • False—The input data represents magnitude and direction components. This is the default.

The default value is None.

Boolean

reference_system

Specifies how the direction component is measured.

  • 1—Direction is measured in arithmetic coordinates. 0° points due east, and 90° points due north.

  • 2—Direction is measured in geographic coordinates. 0° points due north, and 90° points due east.

The default value is 2.

Integer

mass_flow_angle_representation

Specifies the angle of mass flow.

  • 0—From—The mass is flowing along the angle and moving toward the origin of the reference system. This is sometimes referred to as the meteorological convention.

  • 1—To—The mass is flowing along the angle and moving away from the origin of the reference system. This is sometimes referred to as the oceanographic convention.

The default value is From.

Integer

calculation_method

Specifies the thinning method to be used to calculate the magnitude and direction value of a tile.

  • Vector Average—The following calculation occurs for each pixel: convert direction and magnitude to U and V components, calculate the averages of U and V for all pixels in a tile, and then convert the average U and average V back to direction and magnitude.

  • Nearest neighbor—Uses the value from the pixels closest to the center of the tile.

  • Bilinear—Bilinear resampling will be performed on the tile.

  • Cubic—Cubic convolution resampling will be performed on the tile.

  • Minimum—The minimum pixel value of the tile.

  • Maximum—The maximum pixel value of the tile.

The default value is Vector Average.

String

symbology_name

Specifies the name of the symbol depicting direction and magnitude.

  • Single Arrow—A single arrow depicting direction and magnitude.

  • Wind Barb—Wind barbs indicating wind direction and magnitude.

  • Ocean Current—Ocean current symbol indicating current and magnitude.

The default value is Single Arrow.

String

Return value

Data Type Explanation

Raster

The output raster displayed according to your rendering parameters.

Code sample

VectorFieldRenderer example

Visualizes flow direction and magnitude information in a raster with vector symbols.

import arcpy

VectorFieldRenderer_raster = arcpy.sa.VectorFieldRenderer(out_vector_field_raster,
           is_uv_components=False, reference_system='Geographic',
           mass_flow_angle_representation='from')