<html> <head> <title>Gri: Write commands</title> </head> <body bgcolor="#FFFFFF" text="#000000" link="#0000EE" vlink="#551A8B" alink="FF0000"> <!-- newfile Write.html "Gri: Write commands" "Gri Commands" --> <!-- @node Write, Write Columns, While, List Of Gri Commands --> <a name="Write" ></a> <img src="./resources/top_banner.gif" usemap="#navigate_top" border="0"> <table summary="top banner" border="0" cellspacing="0" cellpadding="0"> <tr> <td width="150" valign="top"> <font size=-1> <br> Chapters: </br> <a href="Introduction.html">1: Introduction</a><br> <a href="SimpleExample.html">2: Simple example</a><br> <a href="InvokingGri.html">3: Invocation</a><br> <a href="GettingMoreControl.html">4: Finer Control</a><br> <a href="X-Y.html">5: X-Y Plots</a><br> <a href="ContourPlots.html">6: Contour Plots</a><br> <a href="Images.html">7: Image Plots</a><br> <a href="Examples.html">8: Examples</a><br> <a href="Commands.html">9: Gri Commands</a><br> <a href="Programming.html">10: Programming</a><br> <a href="Environment.html">11: Environment</a><br> <a href="Emacs.html">12: Emacs Mode</a><br> <a href="History.html">13: History</a><br> <a href="Installation.html">14: Installation</a><br> <a href="Bugs.html">15: Gri Bugs</a><br> <a href="TestSuite.html">16: Test Suite</a><br> <a href="Acknowledgments.html">17: Acknowledgments</a><br> <a href="License.html">18: License</a><br> <br> Indices:</br> <a href="ConceptIndex.html"><i>Concepts</i></a><br> <a href="CommandIndex.html"><i>Commands</i></a><br> <a href="BuiltinIndex.html"><i>Variables</i></a><br> </font> <td width="500" valign="top"> <map name="navigate_top"> <area alt="index.html#Top" shape="rect" coords="5,2,218,24" href="index.html#Top"> <area alt="ListOfGriCommands.html#ListOfGriCommands" shape="rect" coords="516,2,532,24" href="ListOfGriCommands.html#ListOfGriCommands"> <area alt="Gri: `while' command" shape="rect" coords="557,2,573,24" href="While.html"> <area alt="Gri: programming" shape="rect" coords="581,2,599,24" href="Programming.html"> </map> <map name="navigate_bottom"> <area alt="index.html#Top" shape="rect" coords="5,2,218,24" href="index.html#Top"> <area alt="Gri: programming" shape="rect" coords="581,2,599,24" href="Programming.html"></map> <h3>9.3.52: The `<font color="#82140F"><code>write</code></font>' commands</h3> <!-- latex: \index{write} --> The `<font color="#82140F"><code>write</code></font>' commands write various things. <p> If the filename is `<font color="#82140F"><samp>stdout</samp></font>', the information is written to the standard output device (ie, the screen); if it is `<font color="#82140F"><samp>stderr</samp></font>', the information is written to the standard error device (ie, the screen). <p> <b>IMPORTANT NOTE</b>: The `<font color="#82140F"><code>write</code></font>' commands <b>append</b> to the output file, as opposed to overwriting the contents of the file. Therefore if you've run the Gri script before, and want fresh output, make sure to do something like the following <p> <TABLE SUMMARY="Example" BORDER="0" BGCOLOR="#efefef" WIDTH="100%"> <TR> <TD> <PRE> <font color="#82140F"> system rm -f the_grid.dat write grid to grid.dat </font></PRE> </TD> </TR> </TABLE> <p> <UL> <LI><a href="Write.html#WriteColumns">Write Columns</a>: Write columns to a file <LI><a href="Write.html#WriteContour">Write Contour</a>: Write contour (x,y) data to a file <LI><a href="Write.html#WriteGrid">Write Grid</a>: Write grid data to a file <LI><a href="Write.html#WriteImage">Write Image</a>: Write various properties of image to a file </UL> <!-- @node Write Columns, Write Contour, Write, Write --> <a name="WriteColumns" ></a> <h4>9.3.52.1: `<font color="#82140F"><code>write columns</code></font>'</h4> <TABLE SUMMARY="Example" BORDER="0" BGCOLOR="#efefef" WIDTH="100%"> <TR> <TD> <PRE> <font color="#82140F"> `write columns to \filename' </font></PRE> </TD> </TR> </TABLE> <p> Append data columns to the end of the indicated file. <p> <!-- @node Write Contour, Write Grid, Write Columns, Write --> <a name="WriteContour" ></a> <h4>9.3.52.2: `<font color="#82140F"><code>write contour</code></font>'</h4> <TABLE SUMMARY="Example" BORDER="0" BGCOLOR="#efefef" WIDTH="100%"> <TR> <TD> <PRE> <font color="#82140F"> `write contour .value. to \filename' </font></PRE> </TD> </TR> </TABLE> <p> Append to the named file the (x,y) pairs defining the contour of the indicated value. <p> The first line of output is a header line, containing two numbers: the contour value and the missing value. Then the (x,y) pairs are written a line at a time, with missing values being used to indicate ends of segments. A blank line is written after the last data pair. For example, if the contour contained two closed regions, Gri would output a pair of missing values as one of the xy pairs, to denote the separation of the two curves. You could read and plot the output as in this example <p> <TABLE SUMMARY="Example" BORDER="0" BGCOLOR="#efefef" WIDTH="100%"> <TR> <TD> <PRE> <font color="#82140F"> write contour 10 to contour.out write contour 20 to contour.out open contour.out read .contour_value. .missing. set missing value .missing. read columns x y draw curve </font></PRE> </TD> </TR> </TABLE> <p> <!-- @node Write Grid, Write Image, Write Contour, Write --> <a name="WriteGrid" ></a> <h4>9.3.52.3: `<font color="#82140F"><code>write grid</code></font>'</h4> <TABLE SUMMARY="Example" BORDER="0" BGCOLOR="#efefef" WIDTH="100%"> <TR> <TD> <PRE> <font color="#82140F"> `write grid to \filename [bycolumns]' </font></PRE> </TD> </TR> </TABLE> <p> Append grid to the end of the named file. Storage is in `<font color="#82140F"><code>%f</code></font>' format, and is in normal image order. If the keyword `<font color="#82140F"><code>bycolumns</code></font>' is present, then the grid is transposed first, in such a way that `<font color="#82140F"><code>read grid data bycolumns</code></font>' performed on that file will read back the original grid data. <p> <!-- @node Write Image, Programming, Write Grid, Write --> <a name="WriteImage" ></a> <h4>9.3.52.4: `<font color="#82140F"><code>write image</code></font>'</h4> <TABLE SUMMARY="Example" BORDER="0" BGCOLOR="#efefef" WIDTH="100%"> <TR> <TD> <PRE> <font color="#82140F"> `write image ... to \filename' </font></PRE> </TD> </TR> </TABLE> <p> The variants of this command write various things about the image to the named file, as illustrated in the following table. <p> <ul> <li> `<font color="#82140F"><code>write image to image.dat</code></font>' Append image to the end of the named file. Storage is by unsigned-char, and is in normal image order. There is no header. <li> `<font color="#82140F"><code>write image rasterfile to image.dat</code></font>' Append image to the end of the named file, in Sun Rasterfile format. <li> `<font color="#82140F"><code>write image pgm to mask.dat</code></font>' Append image mask to the end of the named file, in PGM 'rawbits' format. <li> `<font color="#82140F"><code>write image mask to mask.dat</code></font>' Append image mask to the end of the named file. Storage is by unsigned-char, and is in normal image order. <li> `<font color="#82140F"><code>write image mask rasterfile to mask.dat</code></font>' Append image mask to the end of the named file, in Sun Rasterfile format. <li> `<font color="#82140F"><code>write image mask pgm to mask.dat</code></font>' Append image mask to the end of the named file, in PGM 'rawbits' format. <li> `<font color="#82140F"><code>write image colorscale to colorscale.dat</code></font>' Append image colorscale transform to the end of the named file. Storage is a series of 256 lines, each containing 3 numbers (for Red, Green and Blue) in the range 0 to 1. The file is suitable for reading with the `<font color="#82140F"><code>read image colorscale</code></font>' command. <li> `<font color="#82140F"><code>write image grayscale to grayscale.dat</code></font>' Append image grayscale transform to the end of the named file. Storage is a series of 256 lines, each containing a number in the range 0 to 1. The file is suitable for reading with the `<font color="#82140F"><code>read image grayscale</code></font>' command. </ul> <p> </table> <img src="./resources/bottom_banner.gif" usemap="#navigate_bottom" border="0"> </body> </html>