2.8.1 Basic Matrix Book Operation

Matrix book has the same data structure level with workbook in Origin, both are windows. So, you can manipulate matrix books with the Page object and Window command, which is similar to workbook.

Workbook-like Operations

Both matrix book and workbook are windows, and they share lots of similar operations, even using the same LabTalk script. So, the differences will be pointed out below, and if the same script is used, please refer to Basic Workbook Operation.

  1. Create New Matrix Book
    When using X-Function newbook to create new matrix book, the argument mat must be 1. Here is the similar example to the one for workbook.
    //Create a new matrix book with the Long Name "MyMatrixBook"
    newbook mat:=1 name:=MyMatrixBook;
    
    // Create a new matrix book with 3 matrix sheets
    // and use "Images" as Long Name and short name
    newbook mat:=1 name:=Images sheet:=3 option:=lsname;
    
    // Create a new hidden matrix book
    // and the matrix book name is stored in myBkName$ variable
    newbook mat:=1 hidden:=1 result:=myBkName$;
    // Output matrix book name
    myBkName$ = ;
  2. Open Matrix Book
    Use the same command, doc -o, as opening workbook, to open matrix book. The difference is that the extension of a matrix book is ogm.
  3. Save Matrix Book
    Origin's matrix book with data is with the extension of ogm, and template without data is otm. To save matrix book to ogm file and otm file, the save -i command and template_saveas X-Function will be used respectively, that is also the same with workbook. However, matrix book is not able to be saved as an analysis template.
  4. Close Matrix Book
    This is the same as workbook, see commands win -ca and win -cd.
  5. Show or Hide Matrix Book
    This is the same as workbook, see switches -ch, -h, and -hc in win command.
  6. Name and Label Matrix Book
    This is the same as workbook, see win -r command, and page object.
  7. Activate Matrix Book
    This is the same as workbook, see win -a command. The command window -o winName {script} can be used to run the specified script for the named matrix book. See the opening pages of the Running Scripts chapter for a more detailed explanation.
  8. Delete Matrix Book
    This is the same as workbook, see win -c command.

Show Image Thumbnails

To show or hide image thumbnails, the command matrix -it is available.

// Create a new matrix book
newbook mat:=1;
// Import an image
string strImg$ = system.path.program$;
strImg$ += "Samples\Image Processing and Analysis\bamboo.jpg";
impImage fname:=strImg$;

// Hide image thumbnails
matrix -it 0;