set kml

set kml <-type> fnameroot

Sets the filename root and output options for Keyhole Markup Language (KML) output.

Where type may be one of the following:

img | image      (default) For writing out an image file and complementary KML file
ln  | line       For writing out contour lines in a KML file
poly             For writing out polygons from the shaded contouring algorithm in KML format.

When using the -img or -image option (the default), two output files will be created:

fnameroot.tif    A TIFF image file with a pixel for each gridbox in the domain (default is grads.tif)
fnameroot.kml    A text file in the Keyhole Markup Language (KML) that contains
                 the georeferencing information for the TIFF image (default is grads.kml)

fnameroot.kml    A text file in the KML format that contains the color, thickness, and
                 georeferencing information for the contour lines or polygons (default is grads.kml)

Usage Notes

This command is available in version 2.0.a5 or later. The -ln option for writing out contours in KML format is available in version 2.0.a9 or later. The -poly option for writing out polygons in KML format is available in version 2.0.0 or later. In order to use the -img option, GrADS must be linked with the TIFF and GeoTIFF libraries. Check the output from 'q config' for the message "GeoTIFF and KML/TIFF output ENABLED". The -ln and -poly options do not depend on the TIFF library, and are always enabled.

This command is used in conjunction with the set gxout kml command which sets the graphics output type; the display command will then create the output file(s) instead of drawing a plot. The display expression must be a 2-dimensional grid that varies in X and Y (longitude and latitude), and the projection must be latlon.

The files fnameroot.tif and fnameroot.kml will be replaced if they exist. If fnameroot provided by the user ends in ".kml", GrADS will not append an additional ".kml", and will change the extension to ".tif" for the image file (if necessary).

The output in KML format is intended for use with GIS tools such as Google Earth. Please note that Google Earth prefers longitudes to range from -180 to 180 instead of 0 to 360.

Examples

clear
set gxout kml
set kml myimg
d var

clear
set gxout kml
set kml -ln mycntr
d var