<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 Scripts Menu Page</title> <!-- The plist CFBundleHelpBookName value --> <meta name="AppleTitle" content="Scripts Menu"> <script language="JavaScript"> javascript: resizeTo(750, 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="anchor138874"></A> <TABLE WIDTH="660" 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; SCRIPT menu</FONT> <BR><FONT FACE = "Lucida Grande" SIZE =+0"> <ul id="nav" class="drop"> <li><a href="LAfilemenu.html">File</a></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>Script</b> <UL> <li><A HREF="#anchor579068">Record a script</A></li> <li><A HREF="#anchor579068">Halt script recording</A></li> <li><A HREF="#anchor597599">Load script</A></li> <li><A HREF="#anchor597599">View script</A></li> <li><A HREF="#anchor596894">Save script</A></li> <li><A HREF="#anchor596894">Run script [automatic, all files]</A></li> <li><A HREF="#anchor596894">Run script [1st run manual]</A></li> <li><A HREF="#anchor596894">Run script [automatic, one file]</A></li> <li><A HREF="#anchor596894">Interrupt script</A></li> <li><A HREF="#anchor596894">Clear script</A></li> <li><A HREF="#anchor596894">Quiet script runs</A></li> </UL> <li><a href="LAwindowmenu.html">Window</a></li> <li><a href="LAspecialmenu.html">Special</a></li> </ul> </ul> </TABLE> <TR><TD> <FONT FACE = "Lucida Grande"> <HR> <A NAME="anchor292172"></A><FONT SIZE=+1>'<B>Scripts</B>'</FONT> are pre-defined sequences of operations that simplify repetitive analysis.&nbsp; They are most useful for processing large numbers of <B>SIMILAR</B> data files, and for saving standardized protocols for future use.&nbsp; 'Similar' files are files with identical numbers of channels and identical variable types in the respective channels.&nbsp; <B>If you attempt to use scripted operations on <I><FONT COLOR="#FF0000">dissimilar</FONT></I> files, the results will be unpredictable and probably undesirable</B>, particularly if the '<B>Automatic run</B>' option is used. &nbsp; This is <I><B>especially</b></i> problematic if the 'save file' option is working and you overwrite and obliterate useful data.</P> <P>Although most useful for processing large numbers of similarly formatted files, scripts can also be used to save standardized protocols for future use.&nbsp; The operations in a script are those invoked from the <B><A HREF="LAeditmenu.html">EDIT</A></B> and <B><A HREF="analysismenu.html">ANALYZE</A></B> menus, such as lag correction, smoothing, gas conversions, basic statistics, etc.<A NAME="anchor574490"></A></P> <P>To use a script, you must place it into the script handler.&nbsp; There are two ways of doing this:</P> <UL> <LI><B>Load</B> a previously-recorded (and saved) script from disk.&nbsp; Existing scripts can be saved with the <B>SAVE SCRIPT </B>option.&nbsp; <LI><B>Automatically record </B>a new script by having the program copy manipulations and analyses as you perform them </UL> <P>Once a script is loaded into the script handler, you can make small alterations using the <B>VIEW SCRIPT</B> window.&nbsp;</P><A NAME="anchor546687"></A><A NAME="anchor659997"></A> <P>Script operations are those normally invoked from the <B>FILE, EDIT,</B> and <B>ANALYZE</B> menus.&nbsp; <B> <Font color = "FF0000"> Most -- BUT NOT ALL -- of these operations are scriptable. </B>&nbsp;</font> When editing or recording scripts, here are some other points to keep in mind:</P> <UL> <LI>A maximum of 40 operations can be programmed in a script.&nbsp; <LI>The '<B>Automatic run</B>' button, when clicked, will run<B> edit</B> operations without user input (unless necessary; e.g., locating blocks).&nbsp; The FIRST time the script is executed, user input is necessary to tell the script what options to select (e.g., smoothing intervals, baseline mode, gas units).&nbsp; <LI>You will be prompted to select a data block for any block-related operations (e.g., most <B><A HREF="analysismenu.html">ANALYZE</A> </B>menus).&nbsp; <LI>The <B>SCALE RESULTS</B> option in certain analysis operations is not permitted.&nbsp; </UL> <P>After it is entered, a script is run from the <B>RUN SCRIPT </B>menu selection.&nbsp; Unless stopped with the <B>INTERRUPT SCRIPT</B> button, it will proceed through the sequence of steps without pausing (except where user input is needed; i.e., to select baseline modes, remove spikes, etc.), and then halt.&nbsp; When a new file is loaded the script automatically starts again.&nbsp; <B>LabAnalyst</B> remembers most manipulation options, such as the number of smoothing steps, the channel used for setting flow rate, etc., so that once they are selected during the first script cycle, they automatically reappear during subsequent cycles.</P> <P>For <B>analysis </B>operations, which involve selection of data blocks and other user input, a button ('Continue script; step x') appears in the upper right corner of the data plot.&nbsp; When you have completed a particular analysis operation, click this button to proceed to the next step in the script.&nbsp; You may select new blocks, copy files, save analysis results to files or printer, make graphical file images, etc., when a script is running -- but only during analysis steps.</P> <P><A HREF="#anchor138874"><B>Back to top</B></A><A NAME="anchor579068"></A></P> <P><B><FONT COLOR="#000000" SIZE=+1>The SCRIPT menu selections are:</FONT></B></P> <P><LI>&nbsp;&nbsp; <B>RECORD A SCRIPT</B> &nbsp;&nbsp;&nbsp;&nbsp;Begins 'recording' subsequent manipulation and analysis operations.&nbsp; A white-on-red edit field at the top of the plot area keeps track of the cumulative number of script steps (remember that the maximum is currently 40 steps). <B><FONT SIZE=+1>This is the easiest way to set up a complex script -- </FONT><FONT COLOR="#FF0000" SIZE=+1>but it pays to think carefuly about the sequence of operations you need to accomplish <I>before</I> starting to record.</FONT></B></P> <P><LI> &nbsp;&nbsp;<B>HALT SCRIPT RECORDING...</B>&nbsp;&nbsp;&nbsp;&nbsp; Stops script recording. &nbsp; To process additional files with the recorded sequence of operations, use one of the <B>RUN SCRIPT </B>and '<B>automatic run</B>' commands, which will commence when the next file is loaded..<A NAME="anchor597599"></A></P> <P><LI> &nbsp;&nbsp;<B>LOAD SCRIPT </B>&nbsp;&nbsp;&nbsp;&nbsp;Loads a script from disk, but does not run it.&nbsp; Note that the script file formats for older <B>LabAnalyst </B>versions are not compatible with those for <B>LabAnalyst</B>.</P> <P><LI> &nbsp;&nbsp;<B>VIEW SCRIPT...&nbsp; </B>&nbsp;&nbsp;&nbsp;&nbsp;This option opens the <B>script editing window</B> (example below), which contains a list of the sequence of operations in the script.&nbsp; You can use the <B>'change& '</B> button for each operation to make minor adjustments. &nbsp; When <B>'change& '</B> is clicked,a small window will open with the numeric parameters for that operation. &nbsp; You can edit the 'a', 'b', or exponent values for numeric conversions, or change to a different channel.<A NAME="anchor596894"></A></P> <IMG SRC="LAXimages/ScriptSequence.jpg" > <Table width = 500> <TR><TD> <P><LI> &nbsp;&nbsp;<B>SAVE SCRIPT </B>&nbsp;&nbsp;&nbsp;&nbsp;Saves a script from memory to a disk file, with this icon (in OS X):</P> <P ALIGN=LEFT>Note that the script file formats for older <B>LabAnalyst </B>versions are not compatible with those for <B>LabAnalyst</B>.</P> <td> <P ALIGN=RIGHT><IMG SRC="LAXimages/script%20icon%20X.gif" WIDTH="100" HEIGHT="120" ALIGN="TOP" NATURALSIZEFLAG="3"> </table> <P><LI>&nbsp;&nbsp; <B>RUN SCRIPT [AUTOMATIC, ALL FILES]</B> &nbsp;&nbsp;&nbsp;&nbsp; Executes script instructions ('plays back' a script). &nbsp; The script will begin immediately after <B>RUN SCRIPT</b> is selected; subsequently it runs immediately when new files are loaded. &nbsp; In this mode, the script playback uses previously-stored parameters for transformations, etc.</P <P><LI>&nbsp;&nbsp; <B>RUN SCRIPT [1st RUN MANUAL]</B> &nbsp;&nbsp;&nbsp;&nbsp; Executes script instructions ('plays back' a script). &nbsp; The script will begin immediately after <B>RUN SCRIPT</b> is selected; subsequently it runs only when new files are loaded. &nbsp; In this mode, during the first run, the user is prompted at step for the required parameters; for subsequent files, the operation is automatic as soon as a new file is loaded. &nbsp; This mode is useful if you need to make adjustments to the stored script parameters.</P> <P><LI>&nbsp;&nbsp; <B>RUN SCRIPT [AUTOMATIC, ONE FILE]</B> &nbsp;&nbsp;&nbsp;&nbsp; Executes script instructions ('plays back' a script). &nbsp; The script will begin immediately after <B>RUN SCRIPT</b> is selected. &nbsp; However, the script will <B>NOT</b> run automatically when new files are loaded; instead, it will run after this menu option is selected. &nbsp; This lets the user perform small alterations to the file (spike removal, smoothing, etc.) before the automatic script operations are started. In this mode, the script playback uses previously-stored parameters for transformations, etc.</P> <P><LI> &nbsp;&nbsp;<B>INTERRUPT SCRIPT</B>&nbsp;&nbsp;&nbsp;&nbsp; Halts script operations, but does not change the script itself.&nbsp; If you interrupt a script and then restart it (with <B>RUN SCRIPT)</B>, the scripting operations don't commence until a new file is loaded.</P> <P><LI>&nbsp;&nbsp; <B>CLEAR SCRIPT</B>&nbsp;&nbsp;&nbsp;&nbsp; Halts script operations <B>and</B> eliminates all script information from memory.&nbsp; You will need to start scripting from scratch if this operation is used.</P> <P><LI> &nbsp;&nbsp;<B>QUIET SCRIPT RUNS </B>&nbsp;&nbsp;&nbsp;&nbsp;Turns off sounds during script operations.</P> <P><A HREF="#anchor138874"><B>Back to top</B></A></P> <HR ALIGN=LEFT> <table width = "700" Border = "0"> <tr><td>Other links: <td> <FONT FACE = "Arial"> <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> </table> </BODY> </HTML>