View source code of the function ge_quiver3() in the MATLAB editor
Google Earth toolbox contents


Visualization of directional data (3D) using arrows.

Syntaxgo to top

kmlStr = ge_quiver3(X,Y,Z,U,V,W)
kmlStr = ge_quiver3(X,Y,Z,U,V,W,Parameter,Value)

Descriptiongo to top

kmlStr = ge_quiver(X,Y,Z,U,V,W)

Places 3D Collada model arrows at locations specified by "X" (longitude), "Y" (latitude), and "Z" (elevation). The direction of each arrow is determined from its components "U" (positive in the direction of positive longitude), "V" (positive in the direction of positive latitude), and "W" (positive in the direction of positive elevation).

kmlStr = ge_quiver(X,Y,Z,U,V,W,Parameter,Value)

In addition to the above, this syntax also allows for specification of a number of parameters regarding the appearance of the data when viewed in Google Earth. Assigning values to the parameters can be accomplished by inclusion of an alternating sequence of parameters and their value. The table below provides an overview of the authorized options. The order in which the parameters are included does not matter. Please be aware that the options are case-sensitive. Examples are provided further down.

'altitudeMode'Specifies which plane of reference to use. Must be one of 'absolute', 'relativeToGround' or 'clampToGround'.
'arrowScale'Scales the arrow, but allows for varying of the arrow length with fluctuations in vector components "U", "V", and "W". Default is 1.
'description'A description of objects can be included using this parameter. Its value must be passed as a character array. It will be displayed in the Google Earth Viewer within a pop-up text balloon.
'fixedArrowLength'Makes the arrow length independent from the vector components "U", "V", and "W". Used in function ge_windbarb(). Default is false.
'modelLinkStr'URL specifying which Collada model to use as arrow. See also collada models.
'msgToScreen'Defines whether verbose feedback is provided by the function when it is accessed and when it finishes. Default is false (which is equivalent to logical(0), but quicker).
'name'This character array will be used within the Google Earth Viewer 'Places' pane to identify objects.
'snippet'A short description of the feature. In Google Earth, this description is displayed in the Places panel under the name of the feature. If a Snippet is not supplied, the first two lines of the description are used
'timeSpanStart'See Dynamic visualization.
'timeSpanStop'See Dynamic visualization.

Remarksgo to top

Latitudes on the Southern hemisphere must be passed as negative values. Same for longitudes on the Western hemisphere.

Latitudes and longitudes should be passed in units of decimal degrees (also known as fractional degrees). Google Earth uses Simple Cylindrical projection (also known as Plate Carée) with a WGS84 datum. Altitudes must be passed in units of meters.

Input variables "X", "Y", and "Z" define the origin of the arrows.

Examplesgo to top

See the demo file for more details.

The demo script cycles through a double for-loop. During the first loop, when m is equal to 1, variable "a" is used to calculate the heading of the Collada model ('redcone.dae'). During the second loop, when m is equal to 2, variable "a" is used to calculate the model's tilt.

If the collada model file and the kml file are located in the same directory, the above should yield the following when viewed in Google Earth: