<HTML> <HEAD> <!-- Apple Help needs these meta tags in the default page --> <meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> <!-- The HTML page title is displayed in Help Viewer's search results window --> <title>LabAnalyst File Menu Page</title> <!-- The plist CFBundleHelpBookName value --> <meta name="AppleTitle" content="LabAnalyst File Menu"> <script language="JavaScript"> javascript: resizeTo(770, 900) </script> <style> /*---- CROSS BROWSER DROPDOWN MENU ----*/ ul#nav {margin: 6 0 0 10px;} ul.drop a { display:block; color: #000080; font-family: Arial; font-size: 14px; text-decoration: none;} ul.drop, ul.drop li, ul.drop ul { list-style: none; margin: 0; padding: 0; border: 1px solid #fff; background: #e0e0e0; color: #0000FF;} ul.drop { position: relative; z-index: 597; float: left; } ul.drop li { float: left; line-height: 1.3em; vertical-align: middle; zoom: 1; padding: 2px 15px; } ul.drop li.hover, ul.drop li:hover { position: relative; z-index: 599; cursor: default; background: #20b2aa; } ul.drop ul { visibility: hidden; position: absolute; top: 100%; left: 0; z-index: 598; width: 225px; background: #555; border: 1px solid #fff; } ul.drop ul li { float: none; } ul.drop ul ul { top: -2px; left: 100%; } ul.drop li:hover > ul { visibility: visible } </style> </HEAD> <BODY> <A NAME="anchorTOP"></A> <TABLE WIDTH="619" HEIGHT="45" BORDER="0" CELLSPACING="2" CELLPADDING="2"> <TR> <TD><IMG SRC="LAXnewlogo.jpg"> &nbsp;&nbsp; &nbsp;&nbsp;</TD> <TD><FONT FACE = "Lucida Grande" COLOR="#000000" SIZE=+2> &nbsp;&nbsp;&nbsp; FILE menu</FONT> <BR><FONT FACE = "Lucida Grande" SIZE =+0"> <ul id="nav" class="drop"> <li>File</b> <UL> <li><A HREF="#anchor1372801">Open Warthog</A></li> <LI>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Import <UL> <li><A HREF="#anchor1373348">Warthog binary from 'classic' OS9</A></li> <li><A HREF="#anchor1373348">Text [ .csv, ASCII ] file</A></li> <li><A HREF="#anchor1374337">Sable file</A></li> </UL> </LI> <LI>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Merge <UL> <li><A HREF="#anchor1374828">Warthog file</A></li> <li><A HREF="#anchor1374828">Sable file</A></li> </UL> </LI> <LI><A HREF="#anchor1375729">Save</A></li> <LI><A HREF="#anchor1375729">Save as</A></li> <LI><A HREF="#anchor1375731"> &nbsp;&nbsp;&nbsp; Export Block as csv</A></li> <LI><A HREF="#anchor1376106">Show file data</A></li> <LI><A HREF="#anchor1376453">Print file image</A></li> <LI><A HREF="#anchor1376453">File image preview</A></li> <LI>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Send results <UL> <LI><A HREF="#anchor5553635">Printer</A></li> <LI><A HREF="#anchor5554054">Spreadsheet</A></li> <LI><A HREF="#anchor5554452">Text file</A></li> </UL> </LI> <LI><A HREF="#anchor100001">Output results </A></li> <LI><A HREF="#anchor100001">Close | print file </A></li> </UL> </li> <li><a href="LAeditmenu.html">Edit</a></li> <li><a href="analysismenu.html">Analyze</a></li> <li><a href="LAviewmenu.html">View</a></li> <li><a href="LAscriptsmenu.html">Script</a></li> <li><a href="LAwindowmenu.html">Window</a></li> <li><a href="LAspecialmenu.html">Special </a></li> <li><a href="#anchor1375366">Appearance of Loaded Files</a></li> <li><a href="WHfileformat.html">LabHelper, LabAnalyst File Formats</a></li> </ul> </ul> </TABLE> </P> <TR> <td> <FONT FACE = "Lucida Grande"> <B><FONT COLOR="#FF0000">NOTE: &nbsp; LabAnalyst </b></FONT> will open double-clicked data files of appropriate formats, or data files  dragged and dropped onto the LabAnalyst icon..<P> The program can have up to 20 data files open simultaneously, each in its own window. &nbsp; You can switch between files either by clicking the appropriate window, or with the <B>WINDOW</B> menu.&nbsp; Individual files can be closed either by clicking the standard 'close' button, or if the window of the file you want to close is active (in front), with the <B> close file</B> option in the <B>FILE</B> menu.<br> &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;If you have the maximum number files open and attempt to load another, you will be asked which of the currently open files you want to close to make room for the new file.<P> For any file format, you can automatically scan and fix large  spikes in the data by selecting the  Automatically Filter Newly-loaded Files option in the <B>PREFERENCES/FileHandling menu</b>. <A NAME="anchor1372801"></A><LI>&nbsp;&nbsp; <B>OPEN WARTHOG...&nbsp; </B><IMG SRC="LAXimages/apple.gif" ALIGN="BOTTOM"><B>O</B> &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp;Loads data files produced by <B>LabHelper</B> or <B>LabAnalyst.</B> &nbsp;There are four types (note: &nbsp;icons may be 'lost' if files are sent across the Internet): <TABLE WIDTH="710" HEIGHT="111" BORDER="1" CELLSPACING="0" CELLPADDING="0"> <TR> <TD BGCOLOR="#ffffff" WIDTH="51%" HEIGHT="51"> <TABLE WIDTH="370" HEIGHT="10" BORDER="0" CELLSPACING="0" CELLPADDING="0"> <TR><TD BGCOLOR="#ffffff"> <P ALIGN=CENTER>&nbsp;&nbsp;&nbsp;&nbsp;<IMG SRC="LAXimages/WarthogTEXT.gif" ALIGN="MIDDLE"> <td>Warthog-format text files <p>&nbsp;&nbsp;(chart or oscilloscope) <BR>&nbsp;&nbsp; extension .WHtext</TR> </TABLE> <TD><TABLE WIDTH="370" HEIGHT="10" BORDER="0" CELLSPACING="0" CELLPADDING="0"> <TR><TD BGCOLOR="#ffffff"> <P ALIGN=CENTER>&nbsp;&nbsp;&nbsp;&nbsp;<IMG SRC="LAXimages/RawBinaryFileIcon.jpg" ALIGN="MIDDLE"> <td><FONT COLOR="#0000FF">&nbsp;&nbsp;raw</FONT></B> binary <B>chart</B> data <P> &nbsp;&nbsp;extension .whog</TR> </TABLE> <TR> <TD><TABLE WIDTH="370" HEIGHT="10" BORDER="0" CELLSPACING="0" CELLPADDING="0"> <TR><TD BGCOLOR="#ffffff"> <P ALIGN=CENTER>&nbsp;&nbsp;&nbsp;&nbsp;<IMG SRC="LAXimages/large%20scope%20icon.gif" ALIGN="MIDDLE"> <td><FONT COLOR="#0000FF">&nbsp;&nbsp;raw</FONT></B> binary <B>scope</B> data <P> &nbsp;&nbsp;extension .whsc</TR> </TABLE> <TD><TABLE WIDTH="370" HEIGHT="10" BORDER="0" CELLSPACING="0" CELLPADDING="0"> <TR><TD BGCOLOR="#ffffff"> <P ALIGN=CENTER>&nbsp;&nbsp;&nbsp;&nbsp;<IMG SRC="LAXimages/LA%20file%20icon.gif" ALIGN="MIDDLE"> <td>&nbsp;&nbsp;binary <B>edited </B>data<p>&nbsp;&nbsp;(saved from LabAnalyst) <br> &nbsp;&nbsp; extension .WHdata</TD></TR> </TABLE> </TABLE> </P> <P>The file opening box highlights only these types, with the proper extensions.&nbsp; Two are binary formats, for <B>LabHelper</B> and edited <B>LabAnalyst</B> files: &nbsp;the older Binary-Coded Decimal (BCD) and Floating-Point (FP).&nbsp; <B>LabAnalyst </B> will transparently read either, but will write only in FP format.&nbsp; The main difference is speed: &nbsp; BCD files load more slowly (since they are read and converted one sample at a time), while FP files load quickly (since entire channels are read directly from disk into memory).<P> <P><IMG SRC="LAXimages/TypeOfFile.jpg" ALIGN="RIGHT">If you click the toolbar '<B>Open</B>' or '<B>Append</B>' or '<B>Stack</B>' buttons, you will get this window if you've not specified in the '<B><A HREF="LabAnalystmenu.html">Preferences</A></B>' window that only Warthog files will be shown:</P> <P>This gives you the choice of Warthog (current OS X files or 'classic' files obtained on earlier Mac OS versions [OS8, OS9, etc]), ASCII (text) or Sable SSCF or ExpeData files (see below). <P> Two of the buttons ('<B>Warthog Only</b>') and ('<B>Sable or Warthog Binary</b>') will only access files <B><I>with the correct extensions </b></i> (.whog, &nbsp; .whsc, &nbsp; .WHdata, &nbsp; .ext, &nbsp; .sabl, &nbsp; .WHsable). &nbsp; The '<B>Any Sable or Warthog File</b>' button allows access to all file types, but <B>only files in Warthog or Sable format will load properly.</b> &nbsp; If you attempt to load a file that isn't Warthog or Sable format, you'll get an error message.</P> <P ALIGN=CENTER> <A NAME="anchor1379999"></A> <P><LI>&nbsp;&nbsp; <B>IMPORT </B>&nbsp;&nbsp;<IMG SRC="LAXimages/H_Menu.gif" ALIGN="TOP">&nbsp;&nbsp;&nbsp;&nbsp;<B>This submenu has three items:</B></P> <BLOCKQUOTE> <P><LI>&nbsp;&nbsp; <B>WARTHOG BINARY FROM 'CLASSIC' OS9...&nbsp; </B>&nbsp;&nbsp;&nbsp;&nbsp;For old Warthog binary files from prior to OS X.</A></B>&nbsp; <B><FONT COLOR="#FF0000">WARNING: &nbsp; only files with these formats will load properly.</FONT></B><A NAME="anchor1373348"></A> <TABLE WIDTH = "485" border = "1" cellpadding = "2"> <TR><TD> <img src = "LAXimages/OS9Warthogicon.jpg" ALIGN="RIGHT"> <B><I>Note: &nbsp; </b></i>binary files from 'Classic' Macs (OS8, OS9) may look like this: <p> You can make the correct icons appear by adding the appropriate file extension (e.g., '.whog' ). </table> <P><LI>&nbsp;&nbsp; <B> TEXT [ .csv, ASCII ] FILE...</B>&nbsp;&nbsp;&nbsp;&nbsp; This routine lets you load data in text (.csv) files, as long as:<BR> <UL> <LI> data are in spreadsheet format with variables (columns) delimited by <B>commas or tabs</B> (<B><FONT COLOR="#FF0000">spaces do not work</FONT></B> as delimiters) and cases (rows) delimited by carriage returns <BR> <LI> the data are numeric only (text data are ignored)<BR> <LI> the input file may contain many variables but you must select a maximum of 40. <LI><b>NOTE:&nbsp; </B> this will NOT import complex Excel worksheets (i.e., .xls; .xlsx). &nbsp; If you want to load data in Excel format into <B>LabAnalyst</b>, save a copy as a tab-delimited text file (.txt) or .csv file, which <B>LabAnalyst</b> can read.<P> </UL> Go to <A HREF = "ASCIIfiles.html">this page</a> for more information on importing text files.<p> <A NAME="anchor1374337"></A></P> <P><LI>&nbsp;&nbsp; <B>SABLE FILE...</B>&nbsp;&nbsp;&nbsp;&nbsp; Loads <A HREF="http://www.sablesys.com/">Sable Systems</A> data files in SSCF format or the similar but newer 'ExpeData' format.&nbsp; Nearly all Sable files will load; those which have more than 40 variables will load the first 40 only.&nbsp; The maximum number of markers in <B>LabAnalyst</B> is about 20,000; Sable files can (theoretically; <I>extremely</i> rarely in practice) exceed that limit.&nbsp; The converter will read the first 20,000 markers only.&nbsp; Older SSCF files do not include channel labels, so after the completion of file loading you are prompted to provide your own labels.&nbsp; Also, the values for mass, flow rate, effective volume, and so forth are arbitrary and may have to be edited, and there is no information on voltage conversions. &nbsp; The newer ExpeData files contain channel labels and many conversion factors. <TABLE WIDTH="600" BORDER="0" CELLSPACING="0" CELLPADDING= "3"> <TR><TD WIDTH="65%"> If you save Sable files from <B>LabAnalyst </B> or <B>LabHelper</B>, they will appear (on a Mac) with a custom icon (extension .WHSable):</TD> <TD WIDTH="35%"> &nbsp; &nbsp; <IMG SRC= "LAXimages/Sable%20icon.jpg" ALIGN="BOTTOM"> &nbsp; &nbsp;</TD></TR> </TABLE> </P> </BLOCKQUOTE> <P><B><A HREF="#anchorTOP">Back to top</B> </A><A NAME="anchor1374828"></A></P> <P><LI>&nbsp;&nbsp; <B>APPEND OR STACK </B>&nbsp;&nbsp;<IMG SRC="LAXimages/H_Menu.gif" ALIGN="TOP">&nbsp;&nbsp;&nbsp;&nbsp;<B>This submenu has 3 items:</B></P> <BLOCKQUOTE> <P><LI> &nbsp;&nbsp;<B>WARTHOG FILE...</B>&nbsp;&nbsp;&nbsp;&nbsp;<BR CLEAR="ALL"> <LI> &nbsp;&nbsp;<B>SABLE FILE...&nbsp; </B>&nbsp;&nbsp;&nbsp;&nbsp;Merges a <B>Warthog-format</B> file (either text or binary) or a Sable SSCF file with the currently loaded file. &nbsp; The new file can either be <B>appended</b> to the 'right' (i.e., adding new cases) of the current file, or <b>stacked</b> to the 'bottom' (i.e., adding new channels). <p> Appending is much more common than adding channels. &nbsp; In either case, the following window opens (appearance will vary depending on the number of channels and samples in the two files): <P ALIGN=CENTER><IMG SRC="LAXimages/FileAppendWindow.jpg" ALIGN="BOTTOM"></P><P> </P> <P> The program checks to make sure the merged file will not exceed the current maximum file size -- unlikely unless one or both of the files are <B>very</b> large (a warning is shown if this is the case). &nbsp; However, the program <B><I>does not</I></B> check to make sure the channel <B><U>contents</u></B> match in the current and new files.&nbsp; Thus it is possible to create a new file that contains two (or more) types of data in a single channel (i.e., a set of temperature data from the initial file, then gas concentration data from a second file, then wind speed data from a third file, etc.).</P> <P>Needless to say, this can cause <B>considerable</B> confusion unless you are careful to avoid merging files with differing channel types.&nbsp; To help avoid such mistakes, the computer provides a graphical display of the old and new data.&nbsp; In this example, the file to be merged has 8 channels and the current file contains 9 channels.<BR> <FONT COLOR="#330099"> </FONT></P> <P><B>LabAnalyst</B> will allow access to the maximum number of channels in <B>either</B> the current or new file.&nbsp; Sable SSCF files don't contain channel labels, so if you merge them you HAVE to know ahead of time what the channel structure is.</P> </BLOCKQUOTE> <LI> &nbsp;&nbsp;<B>TIME SCALE ADJUSTMENT...&nbsp; </B>&nbsp;&nbsp;&nbsp;&nbsp;This is a specialized operation that has to be used with care. &nbsp; It is primarily intended to equalize the effective sampling rates of two files that you want to merge or append. &nbsp; This is done in one of two ways, depending on the old and new sampling rates.&nbsp; It is important to note that <B>even if you add points, <FONT COLOR="#FF0000"> you do NOT add information. &nbsp;</FONT> And if you make the file smaller,<FONT COLOR="#FF0000"> information will be LOST. </FONT></B>&nbsp; Therefore, it is a good idea to make a copy of the file before you perform this manipulation.<P> <BLOCKQUOTE> " If the new rate is <B> faster </B> than the old rate (i.e., more samples per unit time), <B>LabAnalyst</B> will add the extra data points by interpolation. &nbsp; For a simple example, if the original sample rate was one Hz (one sample per second) and you want to change that to two Hz (two samples per second), the program will fit one additional data point between each of two successive existing points.&nbsp; The new point will have a value that is the mean of the two points surrounding it. &nbsp; The operation is similar, but more complex, if the new and old sample rates are not integral multiples of each other. <BR> &nbsp;&nbsp;&nbsp;&nbsp; As mentioned earlier, don t make the mistake of thinking that because you have added more data points, you somehow have added information content.<P> " If the new rate is <B> slower </B> than the old rate (i.e., fewer samples per unit time), <B>LabAnalyst</B> will simply remove data points as appropriate. &nbsp; It does not do any averaging.&nbsp; Consequently, this operation reduces the amount of information in the file& . so use with care (and backup copies if you are wise). </BLOCKQUOTE> These operations are transient unless you save the file (or use the <B> Save as </b> option to make a copy with a different name). &nbsp; But if you save a time-adjusted file under its original name, the file is permanently changed. <B><FONT COLOR="#FF0000"> You cannot  undo time adjustment.</FONT></B> &nbsp; The time scale adjustment window looks like this: <P ALIGN=CENTER><IMG SRC="LAXimages/TImeScaleAdjust.jpg" ALIGN="BOTTOM"></P><P> <P><A HREF="#anchorTOP"><B>Back to top</B> </A><A NAME="anchor1375366"></A><HR ALIGN=LEFT> <B> &nbsp;&nbsp;&nbsp;&nbsp; <FONT size = +1 COLOR="#0000FF">Screen display basics</b><P> </FONT> After a file is loaded, the 'plot area' in the top part of the screen displays either the first channel of the file (<B><A HREF="LAviewmenu.html#anchor1464019">single channel</A></B> mode) or several user-selected channels (<B><A HREF="LAviewmenu.html#anchor1463799">multi-channel</A> </B>mode); see the <B><A HREF="LAviewmenu.html">VIEW</A></B> menu for details.&nbsp; The screen in single-channel mode looks approximately as shown below -- but note that immediately after loading, no block will be selected and no data will appear in the <B>results</B> or <B>block </B>windows.&nbsp; The <B><A HREF="LAviewmenu.html#anchor1464987">colors</A></B> of the plot area and block window are user-selectable (<B><A HREF="LAviewmenu.html">VIEW</A></B> menu) and may differ from this example.</P> <ALIGN=CENTER><IMG SRC="LAXimages/dataScreenArrows.jpg"></P> The major components are the <B>plot area</B> (top half of the screen), yellow <B>data bar</B> (upper left), <B>screen selection slider </B>(bottom edge of plot area), '<B>toolbar</B>' <B>menu buttons</B> (across the center, just below the screen selection slider -- optionally, the toolbar can be above or to the left of the plot area), <B>comments window </B>(middle right), <B>block window</B> (lower right), and <B>results window</B> (lower left; this contains controls for <B>EDIT</B> menu operations as well as analysis results).&nbsp; A selected block appears as a color-inverted segment of the plot area. &nbsp; The small <B>'n'</B> buttons along the bottom of the plot area indicate <B>notes</B> entered while gathering data; clicking one of these buttons brings up the note text (example):</P> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<ALIGN=CENTER><IMG SRC="LAXimages/note.jpg"></P> <P>Note that in current versions, a small gray band between the data bar and the plot area shows marker labels (this doesn't appear in the image above). <P>The appearance of the plot area depends on the <B><FONT COLOR="#330099">screenwidth</FONT></B> (the width of the screen in pixels) and the number of cases.&nbsp; If the file contains &lt;= <B><FONT COLOR="#330099">screenwidth</FONT></B> cases, data are plotted 1 pixel per case (if the number of cases is &lt; 50% of <B><FONT COLOR="#330099">screenwidth</FONT></B>, the plot is <B>expanded</B>, with more than 1 pixel per case).&nbsp; If the total number of cases is more than <B><FONT COLOR="#330099">screenwidth</FONT></B>, the X-axis will be scaled to fit within the screen dimensions.&nbsp; 'Screens' (consisting of <B><FONT COLOR="#330099">screenwidth</FONT></B> cases) are indicated by vertical lines, with a crossbar at the top of the active screen.&nbsp; <B>The example shows a file containing many <FONT COLOR="#330099">screenwidths</FONT> of data.&nbsp; </B></P> <P>If there are more than <B><FONT COLOR="#330099">screenwidth</FONT></B> cases, the bottom of the plot area will show a <B>screen selection slider.</B> The currently 'active' segment of the file -- the <B>active screen</B> - is indicated by the slider position.&nbsp; Use the slider or the left and right arrow keys to change the active screen.&nbsp; To view the active screen only (necessary for some manipulation and analysis operations), hit the <B>shift</B> or <B>return</B> keys.&nbsp; Do this again to go back to viewing the entire file (this example shows '<B>entire file</B>' mode).&nbsp; Any <B>markers</B> are shown as vertical dashed lines (this file contains numerous markers, but they are not shown; see the <B><A HREF="LAviewmenu.html">VIEW</A></B> menu).&nbsp; While in the plot area, the cursor is a cross-hair; out of the area it is an arrow.&nbsp; The data bar has a readout of case number, elapsed time, and the value of the currently active channel at the cursor position. The time of day is shown (24-hour scale) along the bottom of the plot area, with optional hour indicators (vertical dotted lines).</P> <P>To perform analyses and some transformations, you need to select a <B>data block.</B> This can be done by the normal 'click-hold-and-drag' method (the cursor must be within the plot area).&nbsp; A second method uses individual clicks: move the cursor to the desired start point and click <B>once</B>; repeat for the end point (which may be on either side of the start point).&nbsp; Alternately, blocks of defined width can be selected with single clicks (see the <B><A HREF="analysismenu.html#anchor1526736">BLOCK WIDTH</A></B> option in the <B><A HREF="analysismenu.html">ANALYZE</A></B> menu).&nbsp; If there is sufficient space, you can 'shift' blocks to the left or right with the <B><A HREF="analysismenu.html#anchor111112">BLOCK SHIFT</A></B> commands (also in the <B><A HREF="analysismenu.html">ANALYZE</A></B> menu).<BR> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; You can select blocks in 'entire file' or in 'active screen only' mode, and blocks can include multiple screens.&nbsp; If a single screen is shown, mark the start with a single click, then shift screens until the end can be marked.&nbsp; A selected block is indicated as a color-inverted rectangle in the plot area, and is scaled to fit within the block window (discrete data points on the block window only appear if the number of included points is small). </P> <P><A HREF="#anchorTOP"><B>Back to top</B> </A><A NAME="anchor1375729"></A></P> <TABLE WIDTH="725" HEIGHT="22" BORDER="1" CELLSPACING="0" CELLPADDING="6"> <TR> <TD> <FONT FACE = "Lucida Grande" COLOR="#000000" SIZE=+1><B>Note for file saving options:</b></font> <P>When you save a file in either Sable or Warthog binary format, with either the <B>Save... </B> or <B>Save As...</b> options, <B>LabAnalyst</b> will add a file extension (<font COLOR="#FF0000"> .WHdata </font>for <B>Save...</b>;<font COLOR="#FF0000"> .WHSable </font> if you select Sable-format output in the <B>Save As...</b> option). &nbsp; The new extension will replace any existing extension, which in effect creates a new file if the source file had a different extension (e.g, .whsc, .whog, .sabl, .ext) or no extension. </table> <P><LI> &nbsp;&nbsp;<B>SAVE...&nbsp; </B>&nbsp;&nbsp;<IMG SRC="LAXimages/apple.gif" ALIGN="BOTTOM"><B>S </B>&nbsp;&nbsp;&nbsp;&nbsp;Stores the current file <B>including any modifications you made</B>.&nbsp; Note that binary files saved from <B>LabAnalyst</B> have different icons than the 'raw' data files generated by <B>LabHelper</B> .&nbsp;</P> <P><LI> &nbsp;&nbsp;<B>SAVE AS...&nbsp; </B>&nbsp;&nbsp;&nbsp;&nbsp;Stores the current file -- or optionally a marked block -- with any modifications you made.&nbsp; You may save all channels or a subset.&nbsp; Files are stored in Warthog binary (file type 'WHog') format, in Sable format (ExpeData), or as ASCII text files. The '<B>standard format</B>' button saves the existing file (with any modifications you have made with transformations, smoothing, etc.) under a new file name of your choice.&nbsp; &nbsp; If '<B>standard format</B>' was not clicked, after selecting the channels to save, the file format selection window appears, as shown below: </P> <P ALIGN=CENTER><TABLE WIDTH="720" HEIGHT="22" BORDER="0" CELLSPACING="0" CELLPADDING="3"> <TR> <TD> <TABLE WIDTH="370" HEIGHT="22" BORDER="1" CELLSPACING="0" CELLPADDING="3"> <TR> <TD BGCOLOR="#ffffff">As mentioned above, <B>Sable ExpeData files</B> do not include values for mass, flow rate, barometric pressure, temperature, and effective volume (unless written in the comments), and comments are limited to 240 characters.</TD></TR> <TR> <TD BGCOLOR="#ffffff">The 'time counter' option creates a variable that indicates elapsed time in hours. &nbsp; For example, this variable would have the value of '1' for all data during the first hour, '2' for all data during the second hour, and so forth.</TD></TR> <TR> <TD BGCOLOR="#ffffff">If you are saving in Text format, you can save any markers in the file in a separate column.</TD></TR> </TABLE> <TD> <IMG SRC="LAXimages/SaveAs.jpg" ALIGN="MIDDLE"> </table> </P> <P></P> <P>If you select the ASCII option, you have two formatting choices:</P> <UL> <LI>Timing data are stored with each case (elapsed time since acquisition began, and time of day).&nbsp; This option is useful for sending files to spreadsheets or plotting programs where time data are important. <LI>The sample interval and start time are stored in the comment string (the first line in the file). <LI>You can also perform a <FONT COLOR="#0000FF" size = "+1"><B>'conditional' save</B></font>, which lets you save only those cases that meet a Boolean selection criterion (see below) <LI><B><FONT COLOR="#FF0000" size = "+1">NOTE: </B> &nbsp; </font> if you use conditional save, the time information (time of day, etc.) in the file <I><B>will no longer be accurate.</B></I> &nbsp; Therefore, it is highly recommended that you make backup copies of the original data before the conditional save operation.</LI> </UL> <BLOCKQUOTE> <TABLE WIDTH="710" HEIGHT="22" BORDER="0" CELLSPACING="0" CELLPADDING="3"> <TR> <TD> <TABLE WIDTH="210" HEIGHT="22" BORDER="1" CELLSPACING="0" CELLPADDING="3"> <TD BGCOLOR="#ffffff" WIDTH="100%">The <B>'Conditional save'</b> option lets you filter data case by case and save only the cases that meet the selection conditions. You need to specify which channel is to be tested (it is not necessary that the tested channel will be saved), one of five Boolean criteria (<, =<, =, >=, >), and a selection criterion (a number against which the individual case values in the tested channel are compared).<BR> &nbsp;&nbsp;&nbsp;&nbsp; In this example, only cases where the value of channel 13 (wheel#1 speed in RPM) is greater than 0.5 will be saved.</TD> </TABLE> <TD> <IMG SRC="LAXimages/ConditionalSav.gif" ALIGN="MIDDLE"> </table> </P> <P>Data files (other than ASCII) that have been saved by <B>LabAnalyst </B>have these icons: <TABLE WIDTH="670" HEIGHT="145" BORDER="0" CELLSPACING="2" CELLPADDING="0"> <TR> <TD BGCOLOR="#ffffff" WIDTH="37%" HEIGHT="138"><P ALIGN=CENTER><IMG SRC="LAXimages/LA%20file%20icon.gif" ALIGN="MIDDLE"> <BR> binary files (.WHdata)</TD> <TD BGCOLOR="#ffffff" WIDTH="26%"><P ALIGN=CENTER>&nbsp;<IMG SRC="LAXimages/WarthogTEXT.gif" ALIGN="MIDDLE"> <p> Warthog text files</TD> <TD BGCOLOR="#ffffff" WIDTH="37%"><P ALIGN=CENTER><IMG SRC="LAXimages/Sable%20icon.jpg" ALIGN="MIDDLE"> <BR> Sable formats (.WHSable)</TD></TR> </TABLE> <P>LabAnalyst saves some other file types, shown here (these may look different on your system, depending on what version of OS X is running):<BR CLEAR="ALL"> <P><TABLE WIDTH="652" HEIGHT="137" BORDER="0" CELLSPACING= "2" CELLPADDING="0"> <TR> <TD BGCOLOR="#ffffff" WIDTH="50%"><P ALIGN=CENTER><IMG SRC="LAXimages/LA%20X%20preferences.gif" ALIGN="MIDDLE">&nbsp; Preference files (.LApr)</TD> <TD BGCOLOR="#ffffff" WIDTH="50%"><P ALIGN=CENTER><IMG SRC="LAXimages/script%20icon%20X.gif" ALIGN="MIDDLE">&nbsp; Script files (.LAscript)</TD></TR> </TABLE> </P> </BLOCKQUOTE> <A NAME="anchor1375731"></A></P> <P>&nbsp;&nbsp; <P><LI>&nbsp;&nbsp; <B> &nbsp;&nbsp;&nbsp; EXPORT BLOCK AS csv </B>&nbsp;&nbsp;&nbsp;&nbsp;This is a 'shorthand' version of the SAVE AS option. &nbsp; It saves the selected block of data as a .csv (comma-separated values) text file, readable by Excel and many other programs. &nbsp; You can select which channels to save but otherwise the file format is fixed, with date (Julian date; day of year) and elapsed time included with every data point. <P> <hr> <P><A NAME="anchor1376106"></A></P> <P><LI>&nbsp;&nbsp; <B>SHOW FILE DATA </B>&nbsp;&nbsp;&nbsp;&nbsp;Opens a window below the plot area showing the labels of all the channels, the sample interval, the time and date of storage, etc., and the conversions used by the <B>LabHelper</B> acquisition program to change raw voltages into appropriate units (temperature, gas concentrations, speed, etc.).&nbsp; The type of conversion equation (&quot;transform&quot;) and the number of samples averaged for each recorded point (&quot;N&quot;) are also shown.</P> <P> Note that a file loaded in Sable or ASCII format may not show all of the variables.</P> <P>The following example shows the file data for a 13 channel file<B>.</B></P> <BLOCKQUOTE> <P><IMG SRC="LAXimages/FileInfo.gif" ALIGN="BOTTOM"></P> </BLOCKQUOTE> <P ALIGN=CENTER><B><FONT COLOR="#330099" SIZE=+1>Conversion equations:</FONT></B></P> <P>Most conversion equations used by the Warthog acquisition program <B>LabHelper</B> are 2-order polynomials (shown as &quot;poly&quot; in the <B>transform</B> column):</P> <BLOCKQUOTE> <P><B><FONT COLOR="#FF0000" SIZE=+1>value = A + B*volts + C*volts<sup>2</sup></FONT></B></P> </BLOCKQUOTE> <P>Note that a <B><FONT COLOR="#FF0000" SIZE=+1>C</FONT></B> of zero produces a linear conversion.&nbsp; Occasionally a power function is used:</P> <BLOCKQUOTE> <P><B><FONT COLOR="#FF0000" SIZE=+1>value = A + B*volts<sup>C</sup></FONT></B></P> </BLOCKQUOTE> <P>Note that in a power function a non-integer <B><FONT COLOR="#FF0000" SIZE=+1>C</FONT></B> will produce meaningless data if the voltage is negative; in this condition, <B>LabHelper </B>sets the results to zero.&nbsp; A <B><FONT COLOR="#FF0000" SIZE=+1>C</FONT></B> value of 1 produces a linear conversion.</P> <P><B>LabHelper </B>allows use of the keyboard as an <B>event recorder</B>, and a single channel can use a <B>3-degree polynomial </B>conversion.&nbsp; If data have been <B>transformed or copied into a new channel, </B>no coefficients are shown.</P> <P><A HREF="#anchorTOP"><B>Back to top</B> </A><A NAME="anchor1376453"></A></P> <P><LI>&nbsp;&nbsp; <B>PRINT FILE IMAGE...</B> &nbsp;&nbsp;&nbsp;&nbsp;Sends an image of the file to the printer port (or a pdf file). &nbsp; <B>You can usually do this by hitting the 's' key.</B> &nbsp;If you have selected a block, you have the option of printing an image of the block or of the entire file.</P> <P><IMG SRC="LAXimages/PrintFileImage.gif" ALIGN="RIGHT">Before printing, you are presented with 'Page Setup' boxes for whatever printer driver is in use.&nbsp; Note that for '<B>US LETTER</B>' (or similar) sized paper, you should use landscape mode (maximum image sizes are about 70% for portrait mode and 80% for landscape mode).&nbsp; If you use other paper sizes, the recommended image sizes may be too large to fit on the page or smaller than the available space.</P> <P>The printed output will match whatever is shown in the on-screen viewing mode (<B>Entire File</B> or <B>Active Screen</B>).&nbsp; A file displayed in the &quot;<B>Compacted and Averaged</B>&quot; format will be printed in that format.&nbsp; If a block has been selected, you have the option of printing only the block.</P> <P>You can select which features will appear in the printout, such as labeling, file information, comments, and markers.&nbsp; If the file has more than one channel, you can print any subset of the channels.</P> <P><IMG SRC="LAXimages/PlotHite.gif" ALIGN="RIGHT">If you click the '<B>non-standard plot heights</B>' button, a window will open to allow customization of the height of each printed channel:</P> <P>The window contains a diagram of the printed page.&nbsp; You select the relative height of each channel in sequence by moving the cursor on the diagram to the desired height, and then clicking the mouse ONCE.&nbsp; The channels will be redrawn one by one as their heights are selected.&nbsp; Note that there is a fixed amount of room on the page, so that enlarging one channel requires shrinking one or more of the others.&nbsp; Consequently, the computer reserves an amount of space necessary for plotting the remaining channels at the minimum possible height (and will not let you exceed that limit).&nbsp; You must select plot heights for all the channels.&nbsp; When done, you can accept the results, redo the plot height selection, or revert to the normal setting (all channels plotted with equal heights).</P> <UL> <LI>The speed of printing depends on the number of points and channels to be plotted, CPU speed, the printer interface, the presence or absence of a print spooler, and the size and selected printing resolution of the image. </UL> <BLOCKQUOTE> <P><LI>&nbsp;&nbsp; <B>FILE IMAGE PREVIEW...</B> like the above routine, but it sends the image to the screen instead of directly to the printer (you can re-route the previewed image to the printer).<A NAME="anchor5553635"></A></P> </BLOCKQUOTE> <P><A HREF="#anchorTOP"><B>Back to top</B> </A><HR ALIGN=LEFT><LI>&nbsp;&nbsp; <B>SEND RESULTS TO </B>&nbsp;&nbsp;<IMG SRC="LAXimages/H_Menu.gif" ALIGN="TOP">&nbsp;<B>This submenu has two items.</B><BR CLEAR="ALL"></P> <BLOCKQUOTE> <P><LI>&nbsp;&nbsp; <B>SPREADSHEET...&nbsp; </B>&nbsp;&nbsp;&nbsp;&nbsp;<A NAME="anchor5554452"></A>Opens a spreadsheet-format text file for storing results generated by analysis menu operations.&nbsp; Data are saved in a tab-delineated format readable by many spreadsheet programs or statistical packages. &nbsp;Optionally, you can save results to an <B>Excel-format</B> file (double-clickable directly into Excel).&nbsp; Besides the results data, the spreadsheet file also contains column labels.&nbsp; Mean, SD, N, and variable name are always saved; other parameters (start of block, end of block, start and end time, elapsed time, analysis type, mass, and channel number and file name) are user-selectable. &nbsp;You can also enter one or two user-typed '<B>notes</B>' with each case (edit fields appear in a window over the COMMENTS window when the 'p' key is struck; hit 'return' or click the window close button when the values are correct).&nbsp; Certain analyses, such as regressions, do not fit this format and cannot be put into spreadsheets.</P> <P ALIGN=CENTER><IMG SRC="LAXimages/TabFileOptions.jpg" ALIGN="BOTTOM"></P> <P>The default is one set of analysis results per line in the spreadsheet, but if you've selected <B>Excel</B> format you can use the '<B>Multiple results per line</B>' option to save the results from two to 15 different analyses per line.&nbsp; You need to specify how many results you want to save initially (you can't change this when the file is in use).&nbsp; Therefore, you need to keep track of the order of analyses so as to avoid confusion later on. &nbsp; If you use notes or store animal mass, these items are saved only once per spreadsheet line (not every time you save an analysis result).</P> <P ALIGN=CENTER><IMG SRC="LAXimages/MultipleResults.gif" ALIGN="BOTTOM"></P> <P>Here is a general format for one line from a file with 2 results per line, with both user notes selected and mass saved:</P> <BLOCKQUOTE> <P><B>Note1</B> <B><FONT COLOR="#FF0000" SIZE=+2>&middot;</FONT></B> <B>Note2</B> <B><FONT COLOR="#FF0000" SIZE=+2>&middot;</FONT></B> <B>M1</B> <B><FONT COLOR="#FF0000" SIZE=+2>&middot;</FONT></B> <B>SD1</B> <B><FONT COLOR="#FF0000" SIZE=+2>&middot;</FONT></B> <B>N1</B> <B><FONT COLOR="#FF0000" SIZE=+2>&middot;</FONT></B> <B>var1</B> <B><FONT COLOR="#FF0000" SIZE=+2>&middot;</FONT></B> <B>anal1</B> <B><FONT COLOR="#FF0000" SIZE=+2>&middot;</FONT></B> <B>mass</B> &middot; <B>M2</B> <B><FONT COLOR="#FF0000" SIZE=+2>&middot;</FONT></B> <B>SD2</B> <B><FONT COLOR="#FF0000" SIZE=+2>&middot;</FONT></B> <B>N2</B> <B><FONT COLOR="#FF0000" SIZE=+2>&middot; </FONT>var2</B> <B><FONT COLOR="#FF0000" SIZE=+2>&middot;</FONT></B> <B>anal2 <FONT COLOR="#0000FF">&lt;CR&gt;</FONT></B><FONT COLOR="#0000FF"> </FONT></P> </BLOCKQUOTE> <P>where <B><FONT COLOR="#FF0000" SIZE=+2>&middot;</FONT></B> is a tab character, <B><FONT COLOR="#0000FF">&lt;CR&gt;</FONT></B><FONT COLOR="#0000FF"> </FONT>is a carriage return character, <B>M1</B> = mean of the first result, <B>SD1</B> = SD of first result, <B>N1</B> = sample size of first result, <B>var1</B> = variable for first result, <B>anal1</B> = analysis for first result, <B>mass</B> = body mass, <B>M2</B> = mean of the second result, etc.</P> <P>Storage of results (in memory) occurs when you press the 'p' key (with the <B>Results</B> window open), or select <B>OUTPUT RESULTS</B>. &nbsp;The spreadsheet file is not saved to disk until you exit from <B>LabAnalyst </B> or use the <B>PRINT | CLOSE FILE</B> option.</P> <P>Some additional considerations:</P> </BLOCKQUOTE> <UL> <UL> <LI>Certain analyses, such as regressions and integration, do not fit this format and cannot be put into tabular files.&nbsp; <LI>When doing waveforms or pairs-difference, pressing the 'p' key stores BOTH frequency and amplitude data.&nbsp; If you want to store one or the other, press the 'f' key to store frequency data only, or the 'a' key to store amplitude data only.<A NAME="anchor12150"></A> </UL> </UL> <BLOCKQUOTE> <P><LI> &nbsp;&nbsp;<B>SIMPLE TEXT FILE...</B>&nbsp;&nbsp;&nbsp;&nbsp; Opens a text file for storing the contents of the Results Window.&nbsp; The format of the disk file is similar to that shown in the Results Window and is identical to the format of data sent to the printer. &nbsp; These files are <U>not</u> formatted for use in spreadsheet-based applications, such as Excel.</P> </BLOCKQUOTE> <LI> <A NAME="anchor100001"></a>Analysis results are transferred to <B><I>temporary</i></b> storage in a memory table when you press the 'P' or 'p' key, or select <B>OUTPUT RESULTS.</b> <P> Real storage (writing data to disk) occurs when you select the <B>PRINT | CLOSE FILE &nbsp; (&nbsp;<IMG SRC="LAXimages/apple.gif" ALIGN="BOTTOM">J </B>) option. However, any temporary memory tables are automatically saved to disk if you quit the program. </P> <P><A HREF="#anchorTOP"><B>Back to top</B></A></P> <HR ALIGN=LEFT> <table width = "700" Border = "0"> <tr><td>Other links: <td> <FONT FACE = "Lucida Grande"> <ul id="nav" class="drop"> <li><a href="LAHP.html">Overview</a></li> <li><a href="LAIcons.html">Icons</a></li> <li><a href="LAHalerts.html">Alerts</a></li> <li><a href="LAcredits.html">Credits</a></li> <li><a href="http://warthog.ucr.edu/">Warthog Systems</a></li> <li><a href="mailto:chappell@ucr.edu?subject=Warthog%20LabAnalyst%20question">email</a></li> </ul> </table> </BODY> </HTML>