2.2.3 Matrix Sheet and Matrix Object Naming Conventions

This topic discusses naming of Origin matrix sheets and matrix objects. Matrix book naming is covered in the topic Origin Child Window Naming Conventions.

The matrix window may contain up to 1024 matrix sheets. With the exception of matrices that were created with earlier versions of Origin, all matrix sheets are named. Matrix books have a Short Name and a Long Name but matrix sheets have only one name.

Notes: > 255 sheets requires saving file to Unicode (e.g. *.opju) file format. Unicode formats not compatible with Origin versions prior to Origin 2018 SR0

Matrix objects can have two names, but the name that Origin uses is a number that represents the order of matrix object creation within a given matrix sheet.

Origin matrix sheet naming conventions

Default name: MSheetN(Short Name) Optional name: user-specified (Long Name)

Rules for matrix sheet Short Names:

  • Must be unique (within the matrix book).
  • Can contain spaces, numbers and special characters.
  • Can begin with a letter or number, or a special character (e.g. !, @, #, %).
  • Limited to 32 characters, including spaces.

You can rename the Origin Matrix sheet short name by one of the following:

  • Double-clicking on the Matrix sheet tab at the bottom of the sheet.
  • Right-clicking on the window title of Matrix sheet and choosing Show Organizer. Select Data Sheets on the left panel and enter/edit Name in the right panel.
  • Right click the Matrix sheet tab and select Name and Comments to specify the Short Name in appeared dialog.

If you need to show or rename the worksheet long name, you can:

  • Right click on the worksheet tab at the bottom of the sheet, select Sheet Name to Show: Long Name from the shortcut menu. The sheet Long Name will display.
  • To rename, double-click on the worksheet tab at the bottom of the sheet, or right click the worksheet tab and select Name and Comments to specify the Long Name in the appeared dialog.

Origin matrix object naming conventions

Default name: 1, 2, 3, 4 ...

Optional name: user-specified

The default name -- the matrix object index number -- is fixed and represents the order of object creation within a given sheet. It cannot be changed. However, you can add an optional long name by clicking on the object index number in the upper right corner of the matrix sheet and choosing Rename from the shortcut menu.

Rules for matrix object optional names:

  • does not need to be unique within the sheet.
  • allows special characters and spaces.
  • limited to 40 characters, including spaces.

References to matrix data

When performing graphing or analysis operations, matrix object data are selected or identified using a standard syntax that combines the matrix window name, the matrix sheet name and the matrix object index number or Long Name:


Note that, unlike the worksheet, the matrix object contains only a single dataset. Plotting operations work on the entire dataset but some analysis operations can operate on a subset of the matrix data

Note: References to the selected data range in the user interface (as in the Plot Details dialog box, for instance) will use Long Names, assuming (1) they have been defined and (2) you have selected Use Long Names when available in the Options dialog box (Preferences: Options: Miscellaneous). Otherwise, Short Names are used.