<!--Copyright (C) 1988-2005 by the Institute of Global Environment and Society (IGES). See file COPYRIGHT for more information.--> <html> <head> <title>GrADS Command: set gxout</title> <style type="text/css"> <!-- .style1 {color: #990000} body { background-color: #e0f0ff; } .red { color: #900; } --> </style> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> </head> <body text="#000000"> <h2><b>set gxout</b></h2> <p> <code>set gxout <i>graphics_type</i></code> <p> Where <code><i>graphics_type</i></code> can be one of the following: <ul> <code>bar </code> Bar chart (The <a href="library.html">library</a> contains an <a href="ftp://cola.gmu.edu/grads/scripts/box_and_whisker.gs">example script</a> demonstrating how to use gxout bar and errbar)<br> <code>barb </code> Wind barbs <br> <code>contour </code> Contour plot<br> <code>errbar </code> Error bars (The <a href="library.html">library</a> contains an <a href="ftp://cola.gmu.edu/grads/scripts/box_and_whisker.gs">example script</a> demonstrating how to use gxout bar and errbar)<br> <code>geotiff </code> (<span class="style1">2.0.a5+</span>) Generates a GeoTIFF format data file; options specified by <code><a href="gradcomdsetgeotiff.html">set geotiff</a></code><br> <code>grfill </code> Shaded grid boxes<br> <code>fgrid </code> Shaded grid boxes with values specified by <a href="gradcomdsetfgvals.html"><code>set fgvals</code></a><br> <code>fwrite </code> Writes data to file instead of drawing a plot; options specified by <code><a href="gradcomdsetfwrite.html">set fwrite</a></code><br> <code>grid </code> Grid boxes with printed values<br> <code>imap </code> (<span class="style1">2.0.a8+</span>) Quickly drawn shaded grid boxes. No metafile, so no hard copy; image output only with <code><a href="gradcomdoutxwd.html">outxwd</a></code>.<br> <code>kml </code> (<span class="style1">2.0.a5+</span>) Generates a TIFF image file and a KML text file; options specified by <code><a href="gradcomdsetkml.html">set kml</a></code><br> <code>line </code> Line Graph <br> <code>linefill </code> Color fill between two lines <br> <code>print </code> Generates ascii output for anything displayed; controlled by <a href="gradcomdsetprnopts.html"><code>set prnopts</code></a><br> <code>scatter </code> Generates a <a href="scatterplot.html">scatter diagram</a>. Requires two grid expressions as arguments, separated by a semicolon. See Usage Note #2 below.<br> <code>shaded </code> Shaded contour plot, alias for original algorithm (shade1)<br> <code>shade1 </code> (<span class="style1">2.0.0+</span>) Shaded contour plot, original algorithm<br> <code>shade2 </code> (<span class="style1">2.0.0+</span>) Shaded contour plot, new algorithm, polygons merged to be larger and fewer in number (faster to render)<br> <code>shade2b </code> (<span class="style1">2.0.0+</span>) Shaded contour plot, new algorithm, polygons all on sub-grid scale (slower to render)<br> <code>shp </code> (<span class="style1">2.0.a9+</span>) Generates a shapefile; options specified by <code><a href="gradcomdsetshp.html">set shp</a></code><br> <code>stream </code> Wind streamlines <br> <code>stat </code> Prints statistical output to terminal instead of drawing a plot<br> <code>vector </code> Wind vector arrows<br> </ul> <p> For station data, these additional graphics output types are also available: <ul> <code>findstn </code> Finds nearest station<br> <code>model </code> Plots station model<br> <code>stnmark </code> Plots a mark at station location that is colorized by data value<br> <code>tserbarb </code> Time series of wind barbs at a point (1-D)<br> <code>tserwx </code> Time series of weather symbols at a point (1-D)<br> <code>value </code> Plots station values<br> <code>wxsym </code> Plots weather symbols at station, controlled by <a href="gradcomdsetwxopt.html"><code>set wxopt</code></a><br> </ul> <p> <h3>Usage Notes</h3> <ol> <p> <li>For the graphics output types <code>vector, stream, </code>and <code>barb</code>, the plotting routines need two result grids, where the first result grid is treated as the U component, and the second result grid is treated as the V component. These two result grids are provided with the <a href="gradcomddisplay.html">display</a> command by entering two expressions separated by a semicolon: <ul> <code> display u ; v<br> display ave(u,t=1,t=10) ; ave(v,t=1,t=10)</code> </ul> <p> <li>For the graphics output types <code>vector</code> and <code>stream</code>, you can specify a third grid expression that will be used to colorize the vectors or streamlines: <ul> <code> display u ; v ; mag(u,v)<br> display u ; v ; hcurl(u,v)</code> </ul> Beginning with <span class="red">GrADS version 2.0.2</span>, the graphics output type <code>scatter</code> will also take a third grid expression to colorize the points in the scatter diagrm. <p> <li>To draw a 1-D time series with graphics output types vector or barb, set the dimension environment so that only time is varying, then : <ul> <code> display const(u,0); u ; v </code> </ul> <p> <li>For the graphics output type <code>wxsym</code>, each value at a station location is assumed to be a wx symbol code number. To see a chart of all available wx symbols and their corresponding code numbers, run the sample script <code>wxsym.gs</code>. <p> <li>The graphics output type <code>findstn</code> requires three arguments to be provided with the <a href="gradcomddisplay.html"><code>display</code></a> command. The first argument is a station data expression. The 2nd and 3rd arguments are the X and Y screen coordinates of the of the desired search location. GrADS will find the station closest to the specified X and Y position, and print its stid, lon, and lat. This graphics output type should only be used when X and Y are the varying dimensions and AFTER a regular display command (that results in graphics output) is entered. <p> <li>For the graphics output type <code>stnmark</code>, the size and style of the mark are controled by <a href="gradcomdsetdigsiz.html"><code>set digsiz</code></a> and <a href="gradcomdsetcmark.html"><code>set cmark</code></a>. To turn off rainbow colorizing and use a single color instead, use <code><a href="gradcomdsetccolor.html">set ccolor</a> <i>color#</i></code>. </ol> <p> <h3>Examples </h3> The <a href="library.html">library</a> contains an <a href="ftp://cola.gmu.edu/grads/scripts/box_and_whisker.gs">example script</a> demonstrating how to use gxout bar and errbar <p> </p> </body> </html>