Changes to LabTalk Scripting

From OriginLab Wiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 09:25, 19 November 2012 (edit)
Kathy (Talk | contribs)

← Previous diff
Revision as of 09:35, 19 November 2012 (edit) (undo)
Kathy (Talk | contribs)

Next diff →
Line 3: Line 3:
__TOC__ __TOC__
-==From 8.5 To 8.5.1==+We keep adding new features, please refer to the [ Release Notes] for details of feature implement in a specific Origin version.
-*[ '''System variables'''] +
-*:Add the following system variables, refer to the [ system variables list] for details:+
-*:*'''@SDD''' - to indicate the meaning of '''@SD'''+
-*:*'''@GAS''' - to control if Generate Script should dump all scripts about every X-function variable(except hidden) or not.+
-*:*'''@PBN''' - to control the status of built-in progress bar.+
-*:*'''@SCW''' - to enable/disable LabTalk string compare to match wildcards.+
-*:*'''@PST''' - to support pasting string contains space into one cell.+
-*:*'''@SCL''' - to support LT substitution in column label rows.+
-*:*'''__LASTOGS$''' - to hold the last execute OGS file.+
-*:Extend the limitation of system variable '''_HEADER$''' to be 999 lines.+
- +
-==From 8.1 To 8.5==+
-*[ '''Range Notation''']+
-*:A new [ range method] range.reverse( ), is available to invert the range.+
-*:The range notation of LabTalk allows variables for [ column subrange].+
-*:Range notation is improved to get the worksheet column range on a worksheet, i.e. the [ range -w and range -wx] syntax can be used in worksheet.+
-*[ '''System variables''']+
-*:Add the following system variables, for details refer to the [ system variables list]: +
-*:*'''@MBC''' - to control the color used to represent missing values in matrix. +
-*:*'''@PIM''' - access memory usage+
-*:*'''@PIG''' - access GDI objects+
-*:*'''@PIH''' - access Handles+
-*:*'''@PIV''' - access virtual memory usage+
-*'''Run command'''+
-*:The [ run] command can be used to change the recalculate mode for the entire project, by the syntax [ run -au] without UID.+
-*'''Document command'''+
-*:The [ document] command can be used to bring back the auto save reminder dialog with the syntax [ doc -ca] and/or [ doc -cas].+
-* '''Dotoolbox command'''+
-*:Add new options for the [ dotoolbox] command to realize some new features, such as panning, inserting OLE object etc.+
-*:*19: panning+
-*:*20: insert equation editor+
-*:*21: insert word+
-*:*22: insert excel+
-*:*23: insert OLE object+
-*'''Peak Analyzer'''+
-*:Support to change the settings of the Peak Analyzer tool with the [ op_change] x-function.+
-* '''Window command'''+
-*:You can use the [ window] command to hide/show notes windows using the syntax [ win -hn].+
-*'''Worksheet and Matrix Manipulation'''+
-*:*Add nMATS property to the [ wks object], to read/write the number of matrix objects in a matrix sheet. +
-*:*Add lname property to the [ wks.col object] to access the long name of a worksheet column or matrix object.+
-*:*Implement [ csetvalue] and [ msetvalue] x-functions+
-*:*Support set column/sheet position in Labtalk with the [ wks.index] or [ wks.col.index] properties.+
-*:*Support "+" to concatenate string columns in the Set Column Values dialog with the syntax col(a)$+col(b)$.+
-*'''Layer.Cmap object'''+
-*:Change the search method of the [ layer.cmap object] to first find the active plot and fix a bug in the Layer.cmap.undatescale( ) method.+
-*'''Set command'''+
-*:It is supported to use the [ set] command to extend plot line to full X range when there are missing Y values at the end of the curve with the syntax [ set -lm].+
-*'''Custom Label'''+
-*:Allow labtalk access to custom data label in the Label tab of Plot Details dialog, e.g. use the syntax %(wcol(n+1)[i]$).+
-*'''Improve Labtalk error message for syntax error'''+
==From 8.0 To 8.1== ==From 8.0 To 8.1==

Revision as of 09:35, 19 November 2012


We keep adding new features, please refer to the Release Notes for details of feature implement in a specific Origin version.

From 8.0 To 8.1

  • Layer Command
    The Layer command can delete a worksheet with all columns, by the syntax -dd.
  • System Variable @TOS
    System variable @TOS=1 (ON by default) was added to control text stretch in Window View.
  • % Notation
    The % notation to show page long name and comments were added.
    • %(%H, @PL): page long name.
    • %(%H, @PC): page comment.
    • %(%H, @PC1): page comment first line.
  • Layer.CMap Object
    More properties and methods for object Layer.CMap to provide precise control.
  • Function Definition
    Function definition was supported in LabTalk.
  • Ed Dialog
    Improvement on ed dialog provides script users the flexibility in viewing variables, functions etc.
  • Cell Link Notation
    Cell link notation allows LabTalk string expression, such as str://"We are in "+page.longname$+", at sheet "$.

From 7.5 To 8.0

  • Variable Scope
    Click here to learn more about variable scope.
  • Range Notation
    Click here to learn more about range notation and declaration.
  • String Assignment
    String assignment in Origin 8.0 requires the $ symbol and has no space between the object or variable and the $. For example: "col(1)[1] $=" does not work in Origin 8.0; both "col(1)[1]$ =" and "col(1)[2]$=" are OK. Click here to learn more about string variable.
  • String Functions
    Click here to learn more about string functions.
  • Expand LabTalk Data Types
    The new LabTalk Data Types have C-like methods and properties.
  • X-Function Access
    X-Functions can be easily executed from LabTalk scripts. The new command window has extended support for accessing X-Functions.
  • Command Window
    The Command Window is a new window introduced in Origin 8.0 that provides a comprehensive interface for developing, saving and running LabTalk script.
  • String Registers
    %C through %I, %X and %Y are considered reserved by Origin, they are string registers. Especially, %Z can hold a long string for temporary storage, up to 6290 characters. And %D has the meaning of current working directory, somewhat like operating in DOS, LabTalk script files (*.ogs) can be run directly in current working folder, that is the different meaning from Origin 7.5.
  • System Variable @AM
    System variable @AM is added to control analysis markers.
  • LabTalk Access to Sampling Interval Information
    Four variables were added for accessing to sampling interval infomation: wks.col.xinit, wks.col.xinc, wks.col.xname, wks.col.xunits.
  • System.FileExt.AddType()
    The AddType method was never added to System.FileExt as it was not needed.
  • returns z increment, but not y increment any more.
  • X-Function "newlayer" Was Removed
    The X-Function "newlayer" was removed since it was duplicated with "layadd".
  • Delete Command
    More methods were added to handle local variable deleted, such as -rar, -ras, -rav, -rac, -rat, -raa, -rag.
  • Accessing Elements of a Matrix
    In Origin 7.5, accessing elements of a matrix was by using syntax MatrixName[n], where n=(RowIndex-1)*NumbersOfColumns+ColumnIndex. This syntax will not work in Origin 8.0 any longer, but the syntax MatrixName[RowIndex, ColumnIndex] instead.