Origin User Guide 2022b E
Origin User Guide 2022b E
Table of Contents
Table of Contents ................................................................................................................................. iii
1 Introduction .............................................................................................................................. 1
4 OriginPro ................................................................................................................................ 13
14 Gadgets................................................................................................................................ 295
iii
1 Introduction
Welcome, and thank you for using Origin!
Origin is a powerful data analysis and publication-quality graphing software, tailored to the needs of scientists
and engineers. What sets Origin apart from other applications is the ease with which you can customize and
automate your data import, analysis, graphing and reporting tasks.
Customizations can range from simple modifications to a data plot, saved as a graph "template" for later use,
to customized data analyses which produce publication-quality reports, saved as an Analysis Template. Batch
plotting and analysis operations are also supported, wherein templates are used for repeat analysis of multiple
files or datasets.
We are confident that you will find Origin to be an effective tool for analyzing your data and presenting your
findings. And to help you get the most from Origin, we offer first-class customer and technical support,
training and consulting services.
In this guide, unless otherwise noted, "Origin" will refer to both Origin and OriginPro. OriginPro offers all the
features of Origin, plus extended analysis tools for Peak Fitting, Surface Fitting, Statistics, Signal Processing
and Image Handling.
The purpose of this guide is to try and present a broad overview of Origin's capabilities. We hope that new
users will find this to be a valuable orientation to the Origin workspace and its primary features. For those who
are already using Origin, we hope you will find useful information on new features and perhaps learn a thing or
two about Origin features that you had overlooked previously.
More detailed information is provided in the Origin Help file (Help:Origin from your Origin software's main
menu) and numerous other learning resources exist. For a complete listing of available resources, see the
Origin Resources chapter of this guide.
We have added short tutorials to numerous topics throughout this guide. These short
tutorials are intended to give you a quick introduction to a key Origin feature. These
tutorials will be marked with this icon.
Also, sprinkled throughout this guide, you'll find tips on using Origin. These tips are
marked with this icon.
Features that are new to this version of Origin will be marked with this icon.
Important changes to key features and other critical information will be marked with
this icon.
We like to get feedback from our users on ways to improve and expand Origin's data analysis and graphing
capabilities. We would love to hear from you. You can find contact information in the Origin Resources chapter
of this guide.
1
2 Installing and Updating Origin
• The Origin upgrade installs into a new program folder - it does not update a previous version. It is
therefore not necessary to install or uninstall a previous version of Origin before upgrading.
• If you are upgrading from Origin 2018 or a later version, the process should be pretty painless. Origin
2018 and later versions share a common license file and User Files Folder. The first time you run Origin
2022b, it should be licensed and know where your User Files are located.
• If you are upgrading from Origin 2017, you will be prompted to pick a new User Files Folder (see
Selecting a User Files Folder, below). If you have custom Origin files from your previous version, you
can transfer them to your new User Files Folder. From the Preferences menu, select Transfer User
Files. Provided your Maintenance has not expired, you should not have to re-license your software. If
your Maintenance has expired, you will need to re-license your Origin 2022b software (See Registering
Origin, below).
• If you are upgrading from Origin 2016 or earlier, you will need to complete the license management
process. When your upgrade is launched for the first time, a license dialog will display asking for your
Product Key If you have custom Origin files from your previous version, you can transfer them to your
new User Files Folder. From the Preferences menu, select Transfer User Files.
• If you have a dongle package, please update your dongle after the Maintenance renewal to make sure
your dongle is available for the latest version. Upgrade your dongle by entering a Product Key in the
License Activation dialog. Once done, you can use this dongle for Origin installed with the same serial
number on any other computers without re-activating the dongle.
Lastly, we want to point out that your Origin software has some great new features. For more information on
key features by version, see the originlab.com/VersionComparison page on our website.
In addition to the InstallShield setup that runs from the Product DVD, an MSI installer and sample transform
are available. The MSI installer is ideal for use at multi-user sites, as it can be used to build an Origin
installation package for distribution. Information on the MSI installer and alternate deployment techniques can
be found on our website:
• MSI Installation
• Silent Install
• Installing Origin on a Remote Access Server such as Windows Terminal Server or Citrix.
3
UserGuide_2022b
There are three steps that must be completed to prepare Origin for use:
• Installation
• License management
Both the Origin upgrade and the newly-purchased products install into a new program folder. Origin does not
overwrite previous versions when upgrading, so your old version continues to function. Likewise, your original
version does not have to be installed when running the upgrade.
If you are installing from a DVD, the startup program that launches when you insert the Origin DVD, includes
an Origin installation button. If the startup program does not automatically run, you can browse the DVD to
launch the setup.exe.
Please note that Origin and OriginPro 2022b are only available as 64-bit versions.
2.3.1 How to Proceed if You Already Have the Origin Trial Version Installed
If you already have the trial version of Origin installed on your computer, you can convert it to the full product
or upgrade.
• If you have purchased the Origin package with node-locked license management, run Origin and select
Help:Convert Trial to Product; or you can use Help: Activate License, click the “Or if you have
purchased already” radio button and choose Activate for this computer. In either case, you will be
asked to enter the Product Key that was generated when you registered your software purchase on
originlab.com.
• For all other license management packages, run the Origin Add or Remove Files program located in the
Origin program icon folder, or rerun the Origin installer (both require a log in account with administrator
permissions). When the Origin setup program starts, select the Modify option and then select Install
Product (requires serial number).
2.3.2 How to Correct or Change your Serial Number After you Complete an
Installation
If you installed Origin with an incorrect serial number, you can correct it by running the Origin Add or
Remove Files program located in your Origin program icon folder, or rerun the Origin installer (both require a
log in account with administrator permissions). When the Origin setup program starts, select the Modify
option and then click Yes to change your serial number.
4
Installing and Updating Origin
• If you are upgrading from Origin 2018 or later versions, your User Files Folder (UFF) location is unchanged.
• If you are upgrading from Origin 2017 or earlier, you will be prompted to pick a location for a new UFF.
You must choose a different path from your old UFF.
• To transfer the contents of your old UFF and your toolbar and workspace configurations to the new UFF,
you can run the Origin software and selecting Preferences: Transfer User Files. For more information,
see Transfer User Files.
• If you have a mobile computer, it is best to select a location on your computer rather than on your
network.
• For non-mobile computers, you can select a location on the computer or on the network, as long as you
have stable access to the folder.
• Do not select the same UFF as other Origin users. To learn how to share custom files with other Origin
users, please see the chapter on Sharing Origin Files, later in this Guide.
Each time Origin starts, the program checks to see that your UFF is accessible. If Origin cannot connect to the
UFF, you will be prompted to select a new location for the UFF. Note that you can change the location of your
UFF at any time while running Origin. From the Preferences menu, select Options and then click the System
Path tab.
2.5.1 Node-locked
Each Origin computer requires a license to run Origin. The license is obtained from the OriginLab website by
entering a Product Key in the License Activation dialog when you start Origin. In-dialog instructions are
provided for computers with no internet access.
Each Origin computer must connect to a FLEXnet license service to run Origin. Your IT department or Origin
administrator installs a FLEXnet license server provided by OriginLab (available from the Origin DVD), obtains
a license for this server from the OriginLab website, and then sets up a license service. The license service
counts and restricts the number of Origin computers that can run concurrently. For more information, see the
Help Center on the OriginLab website (originlab.com/HelpCenter).
2.5.3 Dongle
A dongle (USB hardware key) is provided with the Origin dongle-license package and must be present in the
computer's USB port to run Origin. From Origin 2019, dongles are cross-version.
5
UserGuide_2022b
and Template Center dialog, which provide direct access to Apps&Templates and their updates from your
Origin software, requires that your installation be registered.
For Node-locked licenses, registration is completed automatically when you enter a Product Key into the
License Activation dialog box that opens when you start Origin. To verify that you are registered, select About
Origin from the Help menu. The dialog should display the Registration ID that is assigned to your Origin
installation.
For all other license management packages, open Origin, and then select Register on-line... from the Help
menu to open the Registration dialog box. Use the Registration dialog to register your Origin installation on
the Origin website. During this process, a Registration ID is issued. Enter or copy and paste this Registration
ID into the Registration dialog to complete the process. The About Origin dialog should now display your
Registration ID.
2.7 Maintenance
Most Origin packages are sold with the first year of Maintenance included. Maintenance provides you with free
Origin upgrades, and may also include priority technical support, discounts on Origin training and consulting
services, and a home-use license.
Maintenance customers should receive notice of their eligibility for a free upgrade, when
choosing Help: Get Help Files/Check for Updates.
• To check if your Origin package includes Maintenance, select the Help menu and then select About
Origin. If your package includes Maintenance, the About Origin dialog will show your Maintenance
expiration date.
• To learn about the benefits of Maintenance, contact OriginLab or your local Origin distributor.
• As your maintenance expiration date approaches, Origin will display a maintenance expiration message
with a link to the OriginLab website to learn how to renew your maintenance. This reminder message
provides a check box to prevent showing in the future.
6
Installing and Updating Origin
A system transfer is required if you plan to replace your licensed Origin computer with a different computer.
Open Origin and then select Deactivate License from the Help menu. After successful deactivation, your
Computer ID will be removed from OriginLab’s server so that you can install and activate on another computer.
2.11.2Concurrent Networks
A system transfer is only required if you need to replace the FLEXnet license server. A system transfer is not
required when replacing an Origin computer.
To obtain a replacement FLEXnet server license file, complete the "System Transfer Request Form" available
from the Support area of the OriginLab website.
7
UserGuide_2022b
The Remove program deletes all folders and files that were installed by the Origin setup program. It also
deletes folders and keys created by the installer in the Windows registry.
8
3 Origin Resources
The following tables list key Origin resources available to you. If you purchased Origin from a local distributor,
your Origin distributor may provide additional resources. Please contact your distributor to learn more.
9
UserGuide_2022b
• Control-by-control explanation
of Origin dialog boxes
Press F1 when the dialog box is open
• The dialog box must be open
10
Origin Resources
• Step-by-step instructions on
performing many Origin
Tutorials operations, from the simple to Help: Origin : Tutorials
the complex
• Resources list
• Contact Info
11
UserGuide_2022b
pages by keyword
or type v <key phrase> in the
Origin Start menu.
Information on key Origin features often can be found by just doing a quick web
search. Open a browser and search on phrases such as... "Origin shortcut keys",
"LabTalk graph legend", or "OriginC NAG functions".
12
4 OriginPro
OriginPro, the professional version of Origin, provides all of the features of Origin, plus additional analysis
tools and capabilities. If you don't know which product you have -- Origin or OriginPro -- look to the title bar.
Users of standard Origin will note that some menu commands are marked with (Pro),
indicating that the feature is available only in OriginPro. If you own the standard version of
Origin, but find that you need features of OriginPro, you can upgrade by contacting your
Origin representative.
If you wish to continue using standard Origin without seeing (Pro) menu commands, click
Preferences: System Variables and enter the following in the Set System Variables
dialog box and click OK (Comment is optional):
In addition to Origin's linear and nonlinear curve fitting capabilities, OriginPro includes support for the
following:
13
UserGuide_2022b
• Fitting Comparison: Fit and rank all functions in a category, compare two models to one dataset or two
datasets to one model.
• Global fitting of multiple curves using different functions, with the option of sharing parameters.
For more information, see these web pages: Linear and Polynomial Fitting and Nonlinear Fitting.
With OriginPro, you can perform 3D Surface Fitting. Choose from 21 built-in surface fitting models including
Gauss2D, DoseResponse2D, Exponential2D, and Polynomial2D; or define your own function.
• Locate and fit multiple peaks using one of several peak identification methods.
• Find specific Z values along the fit surface and include them in your output.
• Option for automatic recalculation of results and saving tool settings to a Theme file for repeat use.
OriginPro includes the Peak Analyzer tool with support for the following:
• Peak finding (Local Max, Window Search, 1st Derivative, 2nd Derivative, Residual after 1st Derivative).
• Detect and subtract baseline (Constant, Dataset, XPS, End Points Weighted, Straight Line, User-Defined,
None).
• Fit Baseline as part of the peak fitting process (user-defined or built-in functions).
4.1.4 Statistics
14
OriginPro
• Survival analysis (Kaplan-Meier, Cox Proportional Hazards, Weibull Fit, test of equality of survival
functions)
• Parametric hypothesis tests (two-/pair-sample t-Test on rows, one-/two-sample test for variance, one-
/two-sample proportion test).
• Nonparametric tests (one-/paired-sample Wilcoxon signed rank, paired-sample sign test, Mann-Whitney,
two-sample Kolmogorov-Smirnov, Kruskal-Wallis ANOVA, Mood's median test, Friedman ANOVA, support
for simultaneous tests).
• Power and sample size (one-/two-/paired-sample t-test, one-/two-proportion test, one-/two-variance test,
one-way ANOVA).
In addition to Origin's standard suite of signal processing tools, the following are available in OriginPro:
• Wavelet Analysis (continuous wavelet transform, discrete wavelet transform, inverse discrete wavelet
transform, multi-scale wavelet decomposition, smoothing, noise removal, 2D wavelet decomposition, 2D
wavelet reconstruction).
• Coherence.
4.1.6 Gadgets
Origin Gadgets provide a quick and easy way to perform exploratory analysis on plotted data. While there are
specific Gadgets for each analysis, all work by allowing you to graphically and interactively position a region-
of-interest (ROI) object around the data that you wish to analyze. OriginPro includes these additional Gadgets:
• Cluster Gadget (stats on points inside/outside the ROI; with support for masking, editing, copying and
deleting points).
• 2D Integration Gadget (integration on image plot or contour plot from matrix or worksheet data).
15
UserGuide_2022b
Origin and OriginPro include a collection of easy-to-use image processing tools. OriginPro includes additional
tools in the following areas:
• Arithmetic transforms (alpha blend, extract to XYZ, image simple math, math function, morphological
filter, pixel logic, replace background, subtract background, subtract interpolated background).
4.1.8 Apps
Many add-on Apps are coded to integrate with an OriginPro feature and therefore, they require an OriginPro
license to run. OriginPro-only Apps will be listed in the Origin File Exchange with a red symbol beside
them.
• Redundancy Analysis
• Speedy Fit
• Correlation Plots
• Phylogenetic Tree
• 2D Peak Analysis
• Rank Models
• Peak Deconvolution
• Design of Experiments
• 2D Confidence Ellipse
• Logistic Regression
• Sequential Fit
• Piecewise Fit
• Piecewise Smooth
16
OriginPro
• Slope Analyzer
• 3D Smoother
• Cyclic Voltammetry
• Enzyme Kinetics
17
5 What's New in Origin 2022b
• Export Graphs and Layouts to SVG Image Format: Graphs and layouts can now be exported in SVG
format, allowing for easy editing of the exported file in applications such as Adobe Illustrator™.
• Workbook Buttons for New Sheet, Workbook Organizer: Buttons are added to workbook navigation
to add new sheets or to toggle the Workbook Organizer on and off.
• Arrange Windows with Custom Sorting and Snapping: New dialog to arrange/tile windows by Project
Explorer order, window name, window type, etc. Aligned windows can be "snapped" to a common edge by
dragging.
• Rich Text Support in Notes Windows: Applies to standalone Notes or Notes added as workbook sheet.
Use Format toolbar, apply document styles. Auto-wrapping.
• Rich Text Support for Worksheet Cell Notes: Use the Format toolbar and paragraph styles to style
text in both label row and data cells.
• Insert Images into Graphs and Notes: Insert linked images from data cells, image windows, files or
online, into labels in graphs or into Notes windows.
• Simplified Symbol Map Dialog: Open a smaller, tabbed dialog for inserting common symbols. Direct
access to "Advanced" dialog.
• Distance Annotation on Graphs. A new Distance Annotation tool (Tools toolbar) for labeling the
distance between to points on the graph.
• Expanded Named Range Support for Label Rows and Fitting Dialogs: Use label row values in
calculations or placing reference lines. Use in fitting operations as parameters and bounds.
• Apps Gallery Improvements: Adjust icon spacing, plus dock the Gallery to top of workspace.
• New Graph Types: Bar Map, Circular Packing, and Right-Triangle Ternary.
• New Apps:
19
UserGuide_2022b
5.2.2 Notes
• Notes Window Support for Inserting Graphs, Images, Cell Values, LaTeX equations, etc.
5.2.3 Graphing
20
What's New in Origin 2022b
21
UserGuide_2022b
5.2.4 Analysis
5.2.4.1 General
5.2.4.2 Gadget
5.2.4.3 Fitting
22
What's New in Origin 2022b
5.2.7 Miscellaneous
5.2.8 Programming
5.2.8.1 LabTalk
23
UserGuide_2022b
5.2.8.2 Origin C
5.2.8.3 Python
• Zoom FFT
• Matrix Analysis
• Tangential Baseline
• Mann-Kendall Test
• GeoTIFF Export
To find out more about Origin Apps, including where you can get the free add-on Apps listed above, see the
Apps for Origin chapter of this User Guide.
24
6 The Origin Interface
For Origin 2022b, window size and position in the workspace, are automatically
adjusted to accommodate different displays. This should make it easier for you to
switch between your laptop and a higher-resolution monitor, without having to
resize/reposition every window and dialog box. A system variable is added to control
rescaling behavior: @SRWS (0 = previous behavior; 1 = fit width, scale y; 2 = fit
height, scale x; 3 (default) = fit width and height).
25
UserGuide_2022b
While not part of the Origin interface, you can use Windows File Explorer (previously "Windows Explorer") to
preview graphs in a project file.
• Windows Explorer's Large or Extra large icons views (right-click in File Explorer and choose View:
Large Icons or Extra Large Icons or select from the Explorer View menu) will show an image of the
last active graph before the project file was saved.
• Open the Preview Pane (ALT + P) and scroll through all graphs in the project file.
• If you do NOT wish to save graph previews into the file (either in icon view or in the Explorer Preview
Pane), you can set LabTalk system variable @PESS=0 or =-1. For information on changing the value of a
system variable, see FAQ-708 How do I permanently change the value of a system variable?
• Context-sensitivity of menu bar and menus: The menu bar and menu commands are context-
sensitive; they change as you change window type (from worksheet to graph to matrix, for instance).
Only menus pertinent to the active window will display.
• Menu bitmaps, toolbar buttons and shortcut keys: Some menu commands also have bitmaps that
display to the left of the command. Additionally, you may see a shortcut key combination listed to the
right of a menu command. The button bitmap and the shortcut keys indicate alternate ways to access the
same functionality.
26
The Origin Interface
• Shortcut menu commands: Many commands are available from shortcut menus. To open a shortcut
menu, right-click on an Origin object (worksheet window, graph axis, text object, etc.). Only pertinent
menu commands will show.
• Collapsible menus: By default, main and shortcut menus in Origin are "collapsed", meaning they display
an abbreviated set of commands. When you use a menu item which isn't included, it is added to the menu.
If you prefer to always see full menus, click Preferences: Options > Miscellaneous tab and clear the
Enable Collapsible Menus box.
• Most frequently used analysis menu commands: Most-recently used menu commands will appear at
the bottom of the analysis menus (Worksheet, Analysis, Statistics, Image, etc.). This gives you quick
access to tools when performing repeat operations.
• Custom Menu Organizer: Since Origin 8.1, Origin users have been able to use the Custom Menu
Organizer to add or remove menu items. To learn more, see the chapter Customizing Origin, later in this
Guide.
Use the Customize Toolbar dialog box (View: Toolbars) to control toolbar display and reset or reinitialize
toolbars.
• Customize toolbar button appearance: Use controls on the Options tab of the Customize Toolbars
dialog box to modify button and toolbar appearance.
• Dock/Float a toolbar: Toolbars can be undocked and made to float on the workspace. To float a toolbar,
hover over the left-end of the toolbar. When the pointer becomes a four-headed arrow, drag the toolbar
off of the toolbar space. To return the toolbar to its former docked position, double-click the toolbar title
bar.
• Hide/Show a toolbar: Clicking the Close button on a toolbar removes the toolbar from view. To restore
a hidden toolbar, open the Customize Toolbars dialog box and select the toolbar.
• Hide/Show a button: Clicking the tiny arrow at the end of toolbar to turn on/off some buttons on a
toolbar.
• Move button location: Alt+drag a button to move it to a new location within or among toolbars.
Alt+drag to blank workspace to create a new toolbar. Alt+drag a button to child window til X shows to
remove a button.
OriginLab continues to add Mini Toolbar support for common objects and tasks. These toolbars appear when
the user selects an object or when the user clicks in certain key areas inside the page. Available controls
depend on context (selected object, window type, etc).
27
UserGuide_2022b
• Before using Mini Toolbars, make sure there is a checkmark beside View: Mini Toolbars (default).
• To display the toolbar, select an object such as a data plot, a text label, or a worksheet cell.
• In addition, there are toolbars for more-general page- and layer-level customizations and these toolbars
are displayed by hovering near the margins of the window. When you see your mouse cursor change to
something like this , this is your cue that clicking in this spot will display a Mini Toolbar of relevant
tools.
• Most Mini Toolbars have a Properties button that gives access to more complex settings (e.g. a
graph window's Plot Details dialog box).
• If you move away or you do not act quickly enough, a Mini Toolbar will fade away. To restore a Mini
Toolbar after it has faded, press the SHIFT key.
• To add or remove buttons from a Mini Toolbar, click on the three dots at the bottom center of the toolbar.
This opens the Customize Mini Toolbar dialog box where you can enable or disable buttons as needed.
28
The Origin Interface
Prior to Origin 2022b, the View: Mini Toolbars setting was not remembered across
sessions (i.e. if turned off in the current session, they would be restored on Origin
restart). Now, this setting is remembered across sessions (alternately, you can control
Mini Toolbar display by setting system variable @DMT (ON=0; OFF=1)).
Enter keywords and phrases into the Find box to return relevant Menu entries, Apps, FAQs, Videos and X-
Functions. Open recently-opened Files, Menus and Apps.
Open the Start Menu by (1) pressing F1 (when no other dialogs are open), (2) by clicking the magnifying-
glass icon at the bottom left corner of the Origin workspace, or (3) by clicking Help: Activate Start Menu
(main menu).
29
UserGuide_2022b
To narrow your search, type the following letters in front of the search term(s):
Alternately ...
Click the "gear" icon beside the search field to open the Settings box. Here you can restrict search results and
tweak other search settings.
Search for Apps and install them directly from the Start
menu.
30
The Origin Interface
Learning Center is a "startup" dialog that gives quick access to graphing and analysis examples, plus
learning resources (tutorials, videos, the OriginLab blog, etc.).
• View and load sample graphs, including sample data and notes on re-creating the graph.
• Browse the Learning Resources tab for tutorials and videos and links to the Origin Blog, User Forum and
Origin social media pages.
• Move files from your previous User Files Folder to your new User Files Folder.
31
UserGuide_2022b
To see new graphs in Origin 2022b, open the Learning Center, click the Graph
Samples tab, set the plot filter drop-down to All Plot Types and search on 2022b.
Project Explorer (PE) is a tool to help you organize the contents of your Origin project files (OPJ).
Project Explorer (PE) is split into two panels. The primary panel shows the OPJ folder structure. The sub-panel
shows windows contained in the folder that is highlighted in the primary panel.
• Right-click the PE title bar or click the drop-down menu to display the panels stacked (Vertical
Alignment) or side-by-side (Horizontal Alignment).
• Context menus in both panels provide options to delete, hide, print, etc. Menu options vary depending on
what is selected or where you have right-clicked.
• Multiple-selection of windows in the sub-panel is supported (press Shift or Ctrl while clicking with your
mouse).
• The sub-panel supports differing views of windows: Details (default), List, Small Icons, Large Icons,
Extra Large Icons.
• In any view, mousing over a window icon shows a popup preview of the graph, worksheet, matrix or
layout window. Notes window content is shown in a tooltip.
32
The Origin Interface
• Control display of popup previews by right-clicking in the subpanel and placing a check
mark beside Hold Ctrl Key for Preview Popup. Henceforth, popups will only appear
as you press CTRL.
• When subpanel's Show Folders is checked, folders now show folder Size.
• When displaying windows as Extra Large Icons, the PE sub-panel displays a thumbnail of graphs, layout
windows, workbooks and matrixbooks. Notes window content is shown in a tooltip.
33
UserGuide_2022b
Prior to 2018, the PE sub-panel listed sub-folders in the folder selected in the top panel.
To restore this display mode, set the value of system variable @PEF = 1.
You can right-click on PE folder (upper panel) and choose Copy -- or select the folder
and do a CTRL + C and CTRL + V -- to copy and paste the folder structure and content
to (a) another folder in the current project or (b) another project running in a second
Origin session. To copy a single workbook window, right-click on the window (lower
panel) and copy and then paste the window to (a) another folder in the same project,
or (b) to a new project running in a second Origin session.
1. Select Help: Open Folder: Program Folder, click the Samples subfolder, then drag
the file Tutorial Data.opj to your Origin workspace.
2. By default, Project Explorer is docked to the left side of the Origin workspace in
auto-hide mode. Mouse over the Project Explorer tab to show the PE window.
3. Click on the "push pin" icon on the PE title bar to pin the window in the docked
position.
4. By default the sub-panel is in Details view. In this view, window metadata such as
34
The Origin Interface
Name, Size and Comments show below these column headings. Try dragging
column headers to reorder them.
5. Right-click on the column headings and show or hide any of the headings by
checking or unchecking the box beside each.
6. To add a comment in the Comments field, click once, pause briefly and click a
second time. This puts you into edit mode. Enter a comment.
7. To change the Name of a window, right-click in the row and choose Rename. By
default, the Name field displays the window Short Name; or if a window Long
Name exists, the window Long Name (all windows must have a Short Name but
Long Names are optional). Click the SN or LN button to the right-side of the
editable Name field to edit the Short Name or Long Name. If the Long Name does
not exist, you can enter one.
8. In the top panel of Project Explorer, scroll to the folder 3D Surface with Point
Label and click on it. The sub-panel shows that there are three windows in the
folder. Note that the worksheet window eastcali3053 is bold indicating that it is
35
UserGuide_2022b
the "active" window - the window that is being acted upon as well as the window
that determines what operations are available. There is also a Notes window, and
a matrix window named MBook4.
9. In the sub-panel, double-click on MBook4 and note that it is now bold and has a
magenta "halo", indicating that it is the active window. You will also see that the
whole window(in the workspace) displays with a halo which can be customized in
color with the system variable @AWC-- another indicator that this is the "active"
window. Double-click on this MBook4 icon again and note that the icon is now
dimmed. Note also that the actual window disappears from the workspace. This is
because MBook4 is now hidden. Double-click the MBook4 icon again and the
window is restored and made active.
10. With MBook4 active, click Plot > 3D: Surface: 3D Colormap. This creates a 3D
colormap surface graph (close the attention message). Note also that a new window --
Graph1 -- has been added to the sub-panel of Project Explorer.
11. Right-click in an empty portion of the sub-panel and choose View: Extra Large
Icons. Note that Graph1 now displays a graph thumbnail.
12. Right-click again and choose View: Large Icons. Note that windows are now
represented by icons but if you hover on them, you can see the window contents
as a pop-up.
36
The Origin Interface
To disable PE previews, open the Script Window (Window: Script Window) and type
one or both of the following, then highlight the text and press Enter:
When you set the value of a system variable using the Script Window, you are altering
Origin's behavior for the current session only. To set the value of a system variable
across sessions, see this FAQ.
Apps are add-on applications for Origin that perform specific graphing and/or analysis tasks. A small number
of Apps that are broadly applicable to science and engineering fields are pre-installed with your Origin software.
37
UserGuide_2022b
Use the App Center dialog for browsing, updating or downloading Origin Apps. This new dialog gives you
direct access to all of the Apps on the OriginLab File Exchange without you having to open a browser and
navigate there.
To launch the App Center, click the Add Apps button that appears on all tabs of the Apps Gallery, docked at
the right-side of your Origin workspace. If you do not see the Apps Gallery, click View: Apps (or ALT + 9) and
verify that there is a check mark beside Apps.
• Installed and Up-to-date Apps will appear in the App Center with a green check mark beside them
• Installed Apps for which there is a newer version will appear with an Update icon beside them
• Those not installed will appear with a clickable Download and Install icon beside them
Origin's Statistics, Analysis: Fitting and Analysis: Peaks and Baseline menus include a Find Apps entry.
Clicking Find Apps opens the App Center to show only Apps that relate to the current menu (e.g. Statistics).
You can download or update Apps directly from the App Center.
Use the Apps Gallery to organize and access your installed Apps.
New Apps and App updates are are continually made available to Origin and OriginPro
users. Be sure to open your App Center occasionally (press F10) and if it displays the
red Download Now button, click to get the latest list of available Apps.
38
The Origin Interface
The Object Manager is a dockable panel that opens to the right side of the workspace, by default. Use the
Object Manager for quick manipulation of the active graph or workbook window.
Graph Windows
• Select an element (layer, plot group, data plot or special point) in the Object Manager to select the
corresponding element in the graph window and vice versa. Selection also (a) dims all other plots in the
graph layer and (b) selects the source data in the worksheet.
• Object Manager can show a "Graph Objects" view and a "Plots" view of graph windows. To toggle
between the two views right-click in an empty portion of the Object Manager and choose Show
Plots/Show Graph Objects; or press Ctrl + Shift + S.
39
UserGuide_2022b
• Hide or show plots or graph objects by clearing or checking the corresponding box in the Object Manager.
• At the graph level, change Object Manager list order (Drawing Order or its reverse -- Order of
Appearance ).
• At the plot level, show labels, show or hide plots, reorder plots or create plot groups.
• Within a plot group (labeled as gN), ungroup plots, re-order plots by dragging or by shortcut menu
command, change plot type.
• Access the Plot Details, Layer Contents and Plot Setup dialog boxes.
The Object Manager also supports certain actions for workbooks and matrices:
• Click a sheet in Object Manager to activate the corresponding sheet in the workbook or matrix.
• Right-click in Object Manager for access to common worksheet operations, including Delete, Insert, Add,
Move, Copy, and Duplicate.
40
The Origin Interface
Layout Windows
When a Layout Page is active, the Object Manager lists and allows arrangement of objects via shortcut
menu commands.
• All objects, including added graphs, tables and text objects, list in the Object Manager.
• Select multiple objects in Object Manager, then right-click and align or distribute them using shortcut
menu commands.
Active windows -- the window that will be acted upon by graphing and analysis
operations -- display a colored frame to make the active window more obvious. You can
customize the active window indicator properties (frame color, where the frame shows,
frame line style) with "@ System Variables" @AWC (color) and @AWI (style).
41
UserGuide_2022b
• Workbooks: The Origin workbook provides a framework for importing, organizing, analyzing,
transforming, and plotting your data. The tabbed workbook contains between 1 and 1,024 sheets. Each
sheet may contain more millions of rows and more than 65,000 columns of data. In addition to your data,
workbook windows may also store graphs, annotations, column-based functions, scripts and
programmable button objects, LabTalk variables and import filters.
• Matrixbooks: Like the worksheet, a matrixsheet is a grid of cells, arranged in rows and columns. The
primary difference is that in the worksheet, each column is a dataset and each dataset can be configured
to contain various types of data (text, text & numeric, numeric (double), numeric (int), etc). In contrast,
the matrix is a single, numerical dataset of Z values, related in the XY plane by row (Y) and column (X)
index numbers. The matrixbook contains between 1 and 1,024 sheets. Each sheet can contain multiple
matrix objects (up to 65,504).
• Graphs: The graph window is the primary container for your data plots. Origin supports over 100 chart
types, chosen specifically for their applications in various technical fields. Each chart is created using a
built-in, user-modifiable graph template that can be saved with your custom settings. In addition to data
plots, the graph may also contain annotations (text and drawing objects) or button objects that, when
triggered, perform some custom graphing or analysis task. Graph windows can be inserted into worksheet
cells or "floated" on worksheets (outside the grid) in a workbook window.
• Images: The image window is a window for importing, viewing and editing raster images and videos
(.avi, .mov, .mp4).
• Function Graphs: The function graph is a specialized graph window that displays a curve described by a
function. The function graph differs from other Origin graphs in that it is not produced from a dataset of
discreet values (though you can generate data after plotting).
• Layout Pages: The layout window allows you to combine and arrange graph and worksheet windows and
various annotations onto a single "display panel." It is used primarily for creating presentations.
• Excel workbooks. Excel workbooks can be opened or created in Origin. Workbooks can be saved
separately or as part of your Origin project file.
• Notes: The Notes window supports plain text, Rich Text, HTML and Markdown. Use it for simple tasks
such as recording analysis procedures, making notes to students and colleagues, and cutting and pasting
text from other applications; or use it for rendering highly formatted text, including HTML reports and
mathematical expressions (see next).
The Notes window now supports both LaTeX and KaTeX, allowing you to render
highly-formatted mathematical expressions.
42
The Origin Interface
Help: Origin: Origin Help > Origin Basics > Elements of the Origin Workspace > Creating a
Child Window
Help: Origin: Origin Help > Origin Basics > Elements of the Origin Workspace > Basic Child
Window Operations
• Select File: Save Window As... to save active window. File extensions OGW(U), OGG(U), OGM(U) are for
Origin Workbook, Graph and Matrix windows, respectively.
• Right-click any window title bar and choose Save as... context menu.
Note: To save an Excel window as an external Excel file, right-click the Excel window title in Origin and choose
Save Workbook as... context menu.
Origin 2018 added Unicode (UTF-8) support for Origin projects, child windows and
templates. When you save a window file, you will have the option of saving a file with
or without a "u" appended to the file type (*.opj or *.opju). If you intend to use the file
only in the latest version of Origin, you should choose the Unicode-compliant
(appended "u") option as it offers some performance advantages.
To open a worksheet, graph, matrix, or notes window that was saved to a file:
• Select File: Open or click the Open button on the Standard toolbar to open window files.
• Select File: Recent Books, File: Recent Graphs to open recently saved workbook and graph window
files.
43
UserGuide_2022b
Note: Origin supports window Short Name, Long Name and Comments and the Short Name must be
unique in the Origin project. The window Short Name will be renamed if such a name has already exists in the
project. If you open window file in the current project, then save the project, the window will be included in
the project.
If you are intending to work with Excel files in Origin, please see this section of the
Origin Help file before proceeding.
• Select File: Open Excel menu to open a external Excel file. Or, you can click Import Excel button in the
Standard toolbar or select Data: Import from File: Excel (XLS, XLSX, XLSM)... from the main menu
to import the Excel file.
Note: If you choose Open Excel, the Excel file is opened as an Excel workbook, in an Excel session that runs
inside Origin. In this mode, you have only limited access to Origin features. If you choose Data: Connect to
File: Excel or Data: Import From File: Excel, the Excel file is imported into an Origin workbook and all
Origin features are available.
Origin 2022b adds some new window arranging tools that go beyond the basic Tile
and Cascade functionality. Users in industry and research who work with high
resolution monitors and many windows should find the tools helpful.
Central to using these tools is the Arrange Windows (winarrange) dialog (Window: Arrange Windows).
44
The Origin Interface
Use the dialog to sort and arrange windows in the Origin workspace.
• Sort by order of activation, Project Explorer order, or window name (ascending, descending).
Windows that are arranged in rows and columns can be "snapped"; that is, dragged and resized along a
common edge. The visual cue for engaging the snap is a green bar.
• To resize a single window without snapping, press SHIFT while dragging window border.
• Swap two window positions by pressing ALT while dragging the window title bar.
The Command Window can be used to issue LabTalk commands to Origin, to do simple mathematical
calculations, or to check the value of LabTalk variables. The Command Window maintains a time-stamped
command history that can be carried over from session to session, and intellisense which provides auto-
completion features when writing X-function commands.
45
UserGuide_2022b
The Command Window is dockable and has two panels. The left-hand panel displays the command history,
while the right-hand panel provides the command line.
The Script Window provides some of the same functionality as the Command Window. It lacks some of the
Command Window's features (no intellisense, no command prompt, no command history) but it is handy for
running simple LabTalk commands (e.g. changing the value of a LabTalk system variable). The window's Tools
menu also opens the LabTalk Variables and Functions dialog box where you can view a list of Origin
variables, functions, macros, loose datasets, etc.
• Click the Command Window button on the Standard toolbar. Alternately, select Window:
Command Window menu or press ALT+3.
The Formula Bar is similar to formula bars in OpenOffice and Excel. While it is not necessary to use the
Formula Bar to enter cell expressions, it does offer the advantages of function search, interactive range
selection and improved visibility of expressions, particularly of long expressions that exceed cell width.
1. With a workbook active, toggle the Formula Bar on or off by clicking View: Formula Bar on the main
menu.
2. To change font size, change the value of LabTalk system variable @FBFS (default is "130").
For more information, see the Workbooks, Worksheets and Columns chapter.
• The Search Functions dialog that is opened from the Function menu in certain
dialogs (e.g. Set Column Values) can be opened by clicking Tools: Search
Functions.
46
The Origin Interface
The Status Bar is located at the bottom of the Origin workspace. It reports multiple parameters, including:
• Tool tips for functions listed in the Set Values F(x) menu.
• Notifications from OriginLab, represented by a small red flag to the right side of the Status Bar.
• You can select what shows in the Status Bar by right-clicking on the Bar and selecting (or clearing) items
from the context menu.
• Copy displayed statistical values by selecting Copy Statistics from the context menu. The copied data are
TAB separated between quantity and values, with each key value pair separated by a CRLF delimiter.
Smart Hints are triggered by user actions and are intended to give the user help with current task. These
hints may appear briefly inside a dialog box, as in this example.
47
UserGuide_2022b
Alternately, Smart Hints may appear in the lower left corner of the Origin workspace, as in this example.
Unless you hover over a Hint, it will quickly fade. You can prevent display of individual Smart Hints by checking
the "Do not show this message in the future" box at the bottom of a Smart Hint.
Hints are logged for the current Origin session and can be reviewed by clicking the Smart Hint Log tab,
docked at the edge of the Origin workspace (Note that in-dialog Hints are not logged).
1. From the Origin menu, select View: Smart Hint Log or press ALT+7.
To prevent a particular Smart Hint from displaying again in the current session, right-click on the hint in the
Smart Hint Log window and check Do not show this hint again from the context menu. A message asks you
to confirm that you do not want to show or log this message.
To turn off all Smart Hint display in the session, open the Script Window and type the following:
@SHS = 0;
48
The Origin Interface
To turn on Smart Hint display (including those were individually hidden), type @SHS = 1, and click Help:
Reactivate All Hints.
When you set the value of a system variable using the Script Window, you are altering
Origin's behavior for the current session only. To set the value of a system variable
across sessions, see this FAQ.
6.1.15Code Builder
Origin integrated development environment (IDE) is called Code Builder. Code Builder provides tools for
writing, compiling, and debugging your Origin C functions. Additionally, it can be used for running and
debugging Python code.
1. From the Origin menu, select View: Code Builder or click the Code Builder button on the Standard
toolbar or press ALT+4.
2. Code Builder can also be opened by clicking Connectivity: Open untitled.py. In this mode, you can
paste and run Python code by pressing CTRL + F5.
6.1.16Messages Log
The Messages Log window shows messages about operations including Output Information, Results and
Errors. It displays messages that are not sent to the Script Window or the Command Window.
1. From the Origin menu, select View: Messages Log or press ALT+6.
6.1.17Results Log
Origin automatically types many analysis and fitting results to the Results Log. Each entry in the Results Log
includes a date/time stamp, a window name, a numeric stamp which is the Julian day (see Dates below), the
type of analysis performed, and the results.
In most cases, when results are reported to the Results Log, it opens automatically. Manually open (or close)
the Results Log by doing one of the following:
1. Click the Results Log button on the Standard toolbar. Alternately, from the Origin menu, select
View: Results Log or press ALT+2.
Right-click in the Results Log to open a shortcut menu with commands to Copy, Print, Clear..., and View
Results.
There are several Origin windows, which can be floated, docked, auto-hidden, or hidden. These windows
include Project Explorer, Results Log, Command Window and Messages Log. This allows you to
customize your Origin workspace so as to maximize utility and save screen space.
49
UserGuide_2022b
• Displayed vs. Actual Cell Value: When you import or type your data into a workbook or matrixbook,
Origin uses a combination of user-specified settings to determine how to display the data in each cell.
What displays is a visual representation of the data value. The actual data values are stored with the full
precision allowed by the dataset's Data Type (see table below). When you perform calculations, it is the
actual data values that are used and not the displayed values.
• When Contents Exceed Cell Width: Prior to Origin 2020b, if the sequence of characters in a sheet cell
exceeded what could be displayed at the current cell (column) width, Origin represented cell contents as a
series of pound signs (######). This has changed to mimic MS Excel's worksheet behavior:
• Text strings will not trigger display of pound signs ###### regardless of column width. To
view the full string, you must increase column width.
• Numeric values that exceed column width will first be rounded to the nearest decimal and
only if that is not sufficient to display the full integer value, will pound signs ######
display in place of the numeric value.
• This rounding of numeric values affects the displayed value only. The internally-stored value
does not change.
• To restore the old behavior of displaying pound signs ###### whenever cell contents were
not fully displayed, set system variable @WPE = 1. For information on changing the value of
a system variable, see this FAQ.
• Missing Values in the Worksheet: When spreadsheet programs first appeared it was recognized that
there was a need for a special number that was "not a number" which would - when used in a calculation -
generate itself. Origin has such a number and its internal value is -1.23456789E-300. Because Origin
recognizes this value as a special value, it can be used to enter a missing value into a worksheet or matrix
and it can be used in calculations or scripts (for instance, to return a missing value unless some condition
is met). Origin displays missing values in a worksheet or matrixsheet as "--". However, you shouldn't
confuse this display (output) with what you enter as a missing value (input).
• Decimal, Scientific and Engineering Notation: You can display workbook or matrixbook data in
Decimal:1000, Scientific:1E3, Engineering:1k, and Decimal:1,000 notations. You can manually
choose from these data display options but you can also pre-define thresholds for automatic display of
scientific notation. By default, these thresholds are set to 6 (upper) and -3 (lower).
• Dates and Times in Origin: Origin's long-time mathematical system for dates and time is based on
Astronomical Julian Day Numbers, with a 12 hour offset. This system defines January 1, -4712 (January 1,
4713 BCE), 12 hours Greenwich Mean Time as zero. Recently, two alternate time systems were added: (1)
a true Julian Date value (0 is at noon instead of the following midnight) and (2) a "2018" system in which
0 is defined as 00:00 on January 1, 2018. The 2018 system supports greater precision when, for instance,
importing data with the Import Wizard (e.g. Custom Date Format supports "MM'/'dd'/'yyyy
HH':'mm':'ss'.'######"). Previously, precision was limited to 0.0001 seconds. For more information, see
Dates and Times in Origin.
50
The Origin Interface
Help: Origin: Origin Help > Origin Basics > Elements of the Origin Workspace > Numbers in
Origin
• Project Explorer
• Customizing Toolbars
• Mini Toolbars
• Numbers in Origin
• FAQ: How do I turn off the collapsible menus and show full menus?
• Customizing Toolbars
51
UserGuide_2022b
52
7 Origin File Types
A series of Unicode-compliant (UTF-8) file types was added for Origin 2018. Upgrade
users may recognize that some of the old familiar file types now have a Unicode
counterpart, denoted by an appended 'u' (e.g. *.opj => *.opju). Origin versions 2018
and later will read and write the older, non-Unicode file types. As the default is to save
to the newer Unicode-type files, be sure to set the Save as type drop-down if you
need to save to an older file type.
Origin Project
*.opj(u) A container for all data.
Files
Fitting Function
*.fdf A fitting function definition file.
Files
LabTalk Script
*.ogs A text file organized in sections of LabTalk script.
Files
53
UserGuide_2022b
Configuration
*.cnf A text file that contains LabTalk script commands.
Files
Custom Plot A binary file that holds the bitmap images of custom
origin.uds
Symbols symbols.
• System Themes
• Origin Fitting Functions, the Fitting Function Organizer and the Fitting Function Builder
54
8 Import Data
A new generalized data import mechanism we call Data Connectors was added in Origin 2019b. As the name
implies, Data Connectors create a link between your project and an external source file. The source file may be
local, it can be on a company network; it can even be on a web-server. Data Connectors support options for
excluding imported data when saving the project (smaller files, plus, maintain a live link to source data) and
for protection of data against accidental alteration or deletion. Data Connectors also make possible import of
previously-unavailable data sources, including HTML Tables and JavaScript Object Notation (JSON). Data
Connectors support drag-and-drop and Auto Import on Project Open. In addition, OriginLab continues to
expand Connector support to new data formats. In Origin 2021b, for instance, we have improved Connectors
for National Instruments TDMS and NetCDF files; plus we've added a new Thermo Fisher Scientific
MSRawFile Connector.
• OriginLab continues support for Origin's long-standing X-Function + filter-based routines for ASCII,
CSV, Excel, binary files, and many third-party formats, including MATLAB, pClamp, NI TDM and NetCDF. If
you are a long-time user and you have import filters and Themes that you have long relied on, they
should still work as they always have.
• Copy-paste for quick import of simply-structured data (mostly useful for quickly adding data to
worksheets).
• For complex ASCII, binary or User-defined file types, you can use the graphical interface of the Import
Wizard to parse your file and save settings to an import filter file. The Import Wizard supports power
features such as saving file metadata to variables and use of custom Origin C functions for data
processing and import.
• If you work with SQL databases, you can use Origin's Database Connector and SQL Editor interface to
create connection strings and SQL queries.
55
UserGuide_2022b
56
Import Data
Data Connectors are a general mechanism for importing data to your Origin projects from local or from web-
based files and pages. Data Connectors differ from older Origin import methods primarily in two default (but
modifiable) behaviors:
• Data imported via Connector is locked to editing. This helps ensure data integrity.
• Data imported via Connector is not saved with the project. This helps to keep your project files smaller.
• Text/CSV
• Excel
• MATLAB
• HTML Table
• HDF
• TDMS
• NetCDF
• N42
• Import Filter (use a custom import filter with the Data Connector mechanism)
• If you are connecting to a local or network file, click Connect to File and pick a file type.
• If you are connecting to web data, click Connect to Web and enter a URL.
• By default, when import data file size exceeds 500kB, the imported data and graphs made from that data
are NOT saved with the Origin file (see LabTalk system variable @FSE). All analysis output resulting from
imported data ARE saved with the Origin file. Not saving raw data with your project file can significantly
reduce file size and improve performance when working with large projects.
• IMPORTANT: Since, by default, connector-imported data (> 500kB) is not saved with the project file,
users should always ask themselves whether they need to preserve imported data. This could be an issue
when the data source is web-based and stored in a place beyond your control. If you prefer to save all
57
UserGuide_2022b
data imported via a Data Connector, with your Origin file, click the Data Connector icon and clear the
check mark beside Exclude Imported When Saving prior to saving your file†. Note that each Data
Connector-containing book will have its own Exclude... check mark. Alternately, if you decide the Data
Connectors are not needed, you can click the Data Connector icon and choose Remove Data Connector
(from this book) or Remove Data Connectors from All Books (in the project).
• Data can be re-imported at any time by clicking the Data Connector icon ( or ) in the upper left
corner of the worksheet and choosing Import (Ctrl+4) or Import All.
• By default, imported via a Data Connector is locked from editing. You can graph it and analyze it but you
cannot modify it. While this ensures against accidental modification, some users may find this too
restrictive. Unlock sheet data by clicking the Connector icon and choosing Unlock Imported Data. See
this FAQ for more information on removing editing restrictions from Connector-imported data.
• A workbook can have only one type of Connector (e.g. Text/CSV). For files with a simple structure such as
Text/CSV, you can have multiple sheets with each connecting to a separate file, as long as they share the
same Connector. For files with more complex structures such as Excel or MATALAB, you will initially
connect to one sheet/variable, then use the Data Navigator's Add and Connect Sheet(s) shortcut menu
command to add other sheets/variables in the book, as needed. You can only connect a single Excel or
MATLAB file to a single Origin workbook or matrixbook.
• In books containing files with a simple structure (e.g. CSV), when you right-clicking on a sheet tab and
add a new sheet, the sheet is added with an empty Connector. The unconnected state is denoted by a
pale-yellow Connector icon (see Connector states, below). Click on the Connector icon to open a
shortcut menu where you can connect the sheet to a data source.
58
Import Data
• Data Connectors that you do not use can be hidden by choosing Data: Connect to File: Customize...
and clearing the checkbox next to unused Connectors.
• Data Connectors for file formats not shipped with Origin, are available by clicking Data: Connect to File:
Add New.... New Data Connectors are added to the Data menu.
†
Origin caches data imported by Data: Connect to Web, for a period of time
determined by LabTalk system variable @CFDT, plus file size. By default, a 10MB file
will use cached data for ~24 hrs. In other words, if you re-import (i.e. reconnect to the
web file) within 24 hrs, you will be using data that was cached on first import. If you
re-import to this 10MB file after 24 hrs passes, the cache is cleared and the data are
freshly imported. To learn how to control this caching behavior see, these topics:
• When the data source is connected, the icon looks like this:
• When data in the sheet are unlocked to editing (either by the Connector menu or @IPDC=0), the icon
• When a data source import is pending, the icon looks like this:
• When a new sheet is added to a connected book, an empty Connector is added to the sheet and the icon
59
UserGuide_2022b
• When the data source is no longer viable (e.g. the data source has been moved), the icon looks like this:
Regardless of the state of the connection, you can click the Connector icon, then use the Data Source File
Path and Common Data Path to help you maintain the connection between your Origin files and your source
data.
• Relative to Project Path: If your data are stored in folders under the project file, you could set Data
Source File Path to Relative to Project path. You can then move the project and data sources together,
and their relative paths are preserved. No path corrections are then needed when re-opening the project
file from a different location on your network.
• Relative to Common Data Path: If data sources are under some common path, you could set Data
Source File Path to Relative to Common Data Path. If the files are subsequently moved, you can re-
establish the Common Data Path and then Import All Books.
The Data Navigator is a collapsible panel that is automatically added to the workbook when you connect to
multi-page/multi-variable files such as Excel, MATLAB or Origin Projects.
60
Import Data
• Origin will import data from the first sheet and list other sheets in dimmed type.
• Right-click on a dimmed sheet -- or press CTRL or SHIFT and select multiple sheets -- then choose Add
and Connect Sheets.
• The file name is assigned to the book Long Name and sheets are the original sheet name is assigned to
sheet Name.
There is drag-and-drop support for the file types listed under Data: Connect to File:
• For files with a simple header information (e.g. only column name and units), a Data Connector is added
and the file is properly parsed with no need for an import filter.
• For files that are not properly parsed (i.e. header information ends up in the data portion of the
worksheet), consider making an Origin Import Filter (*.oif) file using the Import Wizard.
• Import filters can be saved to the data file folder, the User Files\Filters folder or in the current window. If
you intend to use a template for your data import, you can save the filter to the window; otherwise the
filter file (*.oif) should be placed either in the data file folder or in \User Files\Filters.
61
UserGuide_2022b
In this mini-tutorial, we use the Text/CSV Connector to import a text file with a date-
time component. While older Origin import methods treated the date-time data as text,
requiring the user to manually set the date-time column to Date after import, the Text/CSV
Connector is able to automatically configure the worksheet column on import.
1. Click the New Workbook button and choose Data: Connect to File: Text/CSV.
2. Browse to the <Origin Program>\Samples\Import and Export\ folder and open Date
with higher precision.dat.
3. In the CSV Import Options dialog, accept default settings and click OK. Data are
imported to the workbook.
4. Click on the column A header to select the column, then right-click and choose
Properties. Note that Format has been automatically set to Date, Display has been
set to Custom Display and a custom format shows in Custom Display.
In this mini-tutorial, we use a Data Connector to import multiple files. These identically-
structured files have multiple rows of metadata that we want to preserve. So, you will
make use of an import filter file that has been developed using the Import Wizard, to
import the files and write file metadata out to multiple column label rows in each
worksheet. In so doing, you will see (a) how to import multiple files using a Data
Connector and (b) how you can use an import filter file (*.oif) developed with an earlier
version of Origin, to import files using Origin's newer Data Connector technology.
1. Start a new project and with the workbook active, choose Data: Connect Multiple
62
Import Data
Files.
2. In the files2dc dialog box, set the following:
o Data Connector = Import Filter
o Source = Specified Files
o File Names = <Origin Program>\Samples\Import and Export\S15-125-
03.dat, S21-235-07.dat and S32-014-04.dat
o Same Book = enabled (checking the box will bring all files into one book)
3. Click OK and in the dialog that opens, set Import Filter = Data Folder:
VarsFromFileNameAndHeader.oif
4. Click OK and the three files are imported as separate sheets in the workbook.
You can use the CSV Import Options dialog to specify a partial import of web-stored
files just as you can for locally-stored files. Check the Partial Import box for guidance
on the syntax used to define Column and Row import.
Note: To learn more about working with the Text/CSV Connector, see the Origin Help:
• Connecting to a MATLAB file at the root level will add all variables as Origin matrix objects in the
matrixsheet.
• A slider is added so that you can flip through Origin matrix objects in the sheet. You can toggle between
slider and thumbnails using the Slider or Thumbnails Mini Toolbar button.
63
UserGuide_2022b
• The Connector also adds a collapsible Data Navigator panel to the window. If you wish to add variables
as individual sheets, you can right-click on the Data Navigator list and add them.
1. With a workbook or matrixbook active, click Data: Connect to File: MATLAB or Data: Connect to Web
and enter a URL to your .mat file.
2. Select the variables that you want to import (add them to the Browser's bottom panel) and click OK.
Note: To learn more about working with the JSON/MATLAB Connector, see the Origin Help:
64
Import Data
1. With a workbook or matrixbook active, click Data: Connect to File: NetCDF; or Data: Connect to Web
and enter a URL to your .nc file.
2. Select the variables that you want to import by adding them to the Browser's bottom panel.
3. Adjust Import Options ("pencil" button) as needed and and click OK twice.
4. If a workbook is active but the variable requires a matrixbook, you will be prompted to add a new
matrixbook or an embedded matrixbook in the active workook.
• Support for executing Time Axis Skipping first, then applying Averaging
To connect to a Shapefile:
1. With a workbook or matrixbook active, click Data: Connect to File: Shapefile and browse to and choose
your .shp file.
2. Specify whether to Load Attributes and (optionally) encoding, and click OK.
Origin 2022b improves export of NetCDF data. Now, you can export matrix analysis
results (e.g. Linear Fit of Matrix Stack) to .nc files that can be used in Origin or in
other software. For more information on importing and analyzing NetCDF data and on
using shapefiles, see the Origin Help File. In addition, check out these OriginLab blog
posts:
65
UserGuide_2022b
Note: To learn more about working with the NetCDF Connector, see the Origin Help:
1. With a workbook active, click Data: Connect to Cloud. This opens the browser for picking files.
2. Use the browser's drop-down controls to switch cloud services or accounts, if needed.
Note that the first time you connect to a cloud account, you'll be asked to verify that account. OriginLab will
only access and transfer data between your cloud account and your local computer using a temporary file. No
other communication of information occurs.
• You can copy Excel data to the Clipboard and paste or paste link that data into Origin.
66
Import Data
• You can use a Data Connector to import a local Excel file by (1) clicking Data: Connect to File: Excel,
(2) clicking the button on the Standard toolbar, or (3) dropping your Excel file onto the Origin
workspace.
• You can use a Data Connector to import Excel data from the web by clicking Data: Connect to Web:
Excel (see below).
• You can use Origin's older X-Function-based routines to import a local Excel file by clicking Data: Import
From File. This option was recently hidden to accommodate the Excel Connector but if you prefer to use
this method, see this section of the Origin Help file.
Things to know:
• If you are importing data using the Excel Connector, you can refresh your Origin-side data at any time by
clicking the Connector icon and choosing Import; or re-import your Excel data at the time that you
open the Excel-connected Origin project.
• If you are using the older (X-Function based) impMSExcel import routine: Certain file import information is
saved to the workbook on import. Having once imported an Excel file to an Origin workbook, you can use
the Re-import button on the Standard toolbar to re-import an updated Excel file -- including those that
contains multiple sheets -- to your Origin workbook.
• Origin does not support dynamically linking one Excel workbook with another Excel workbook, nor does it
recognize or translate Excel formulas.
Note: To learn more about working with Excel data, see the Origin Help:
Help: Origin: Origin Help > Working with Microsoft Excel and Connecting to File > Excel
Both the Excel Connector and impMSExcel routines support partial import of Excel
data. For more information, see the Origin Help file topic Partial Importing and Re-
importing.
Origin 2022b auto detection of import file header info (i.e. column names, units and
other file header information) is improved for Data: Connect to File: Excel.
Origin's Data Connectors create a live link between your external data files and your Origin project.
67
UserGuide_2022b
• To connect to a local file, click Data: Connect to File or click the button located on the Standard
toolbar.
• If the file is a multi-sheet file, you must first connect to a single sheet. This opens the the Data
Navigator panel (described above) where you can connect to additional pages, as needed.
• When all sheets are identically structured, ensuring that the first sheet is properly parsed (e.g. the header
information is correctly handled) will allow you to connect additional sheets without making adjustments.
1. Click the New Workbook button to create a new workbook, then choose
Data: Connect to File: Excel.
2. Browse to and open <Origin Program>\Samples\Import and Export\United States
Energy (1980-2013).xls.
3. In the Excel Import Options dialog that opens, accept default settings and click
OK.
4. In the Data Navigator panel that opens to the left side of the workbook, hold the
CTRL key and select the other three (dimmed) sheets, right-click and choose Add
and Connect Sheet(s). The remaining sheets -- Natural Gas, Coal and Total
Primary Energy -- are imported into the workbook. Note that if the unconnected
sheets are large in size, you can opt to connect to them one-at-a-time, as needed.
68
Import Data
Note, also, that Connectors may not exist for some of the file types listed in this table. If no Data Connector
exists, you should use the Data: Import From File methods.
The Standard toolbar Import Single ASCII button now calls the Data: Connect
to Files: Text/CSV routine. For the impASC routine, see the next section.
• The Data: Import From File: Multiple ASCII... ( ) method is generally satisfactory for importing
text files having a simple structure (works for single or multi-file import). This routine will typically handle
files with commonly-used delimiters and a simple header structure, without adjustments.
• If the file import needs adjustments, select the Show Options Dialog checkbox when selecting your
file(s) in the ASCII dialog. This will open the impASC dialog box prior to file import, allowing you to
tweak the way that the files are handled.
Note: To learn more about working with the ASCII Import using the impASC dialog, see the Origin
Help:
Help: Origin: Origin Help > Customizing the ASCII Import Options
Once you've adjusted impASC dialog import settings, you can save them in one of two ways:
• As a Theme file from within the impASC dialog box (including saving for drag-and-drop).
69
UserGuide_2022b
Saving import settings with the worksheet template offers portability (e.g. templates are easily shared with
colleagues). Saving import settings as a Theme offers the advantage of being able to recall any number of
import options combinations (Themes) when importing via the impASC dialog box.
For more information on Themes and templates, see the Customizing Origin chapter later in this User Guide.
Additionally, see topics listed under "Topics for Further Reading", below.
You can quickly load your custom import theme from the list at the bottom of the Data
menu. You can also use the Data: Import from File: Add/Remove File Types ...
menu to open the Import Menu Customization dialog box where you can select and
add User Themes to the Data: Import From File menu.
If a Data Connector does not exist for a certain third-party format, you can still use Origin's older X-
Function-based import routines. These include many widely-used formats, including pClamp, NI TDM, and
NetCDF. As with all X-Function-based routines, you can customize third-party file import options and save your
settings with the worksheet template or as a dialog Theme for later use. As with other supported file types,
you can import third party files by drag-and-drop.
70
Import Data
Note: Some of these 3rd party file formats are hidden by default. To add, choose Data: Import From
File: Add/Remove File Types.... This opens the Import Menu Customization dialog box where you
can choose which file types to show in the Import From File menu. To insert a separator after a menu
command, right-click on the command in the right-hand panel and choose Add Separator. To remove a
separator, double-click on it in the right-hand panel.
If no Data Connector exists for a given file type (i.e. those listed in the table above),
then drag-and-drop support is managed by file extension, using the Filter Manager
dialog. From the main menu, click Preferences: Import Filters Manager....
Note: To learn more about working with the Third-party Formats, see the Origin Help:
Another advantage to using the Import Wizard to your ASCII data is that you can create import filters that are
targeted to a group of similarly-named data files. This is especially helpful when those files contain metadata
that that needs to be handled in a certain way. The filter can then be used for drag-and-drop import
operations and it can be added to the Data: Import From File menu.
• You can add your import filter file to the Data: Import From File menu.
Subsequently, when you pick your filter from the menu, the Open dialog will only
show files that match your filter.
71
UserGuide_2022b
• In prior versions, the default was to apply a filter to all files with .dat, .txt or .asc
extensions. Henceforth, the default will be to name the filter as the current Wizard file
and to only apply the filter to files of the same name. As was the case in earlier
versions, the user can still modify the Applicable File name, and using wildcards,
expand the list of files to which the import filter (.oif) applies.
1. Choose Data: Import From File: Import Wizard... or click the button located on the Standard
toolbar.
• Develop Origin import filter files (*.oif) for import of ASCII files not handled satisfactorily by the Text/CSV
Connector.
• Import data from the web pages using the Clipboard (see below).
• The ability to post-process your imported data using a custom LabTalk script.
Help: Origin: Origin Help > Importing and Exporting Data > The Import Wizard
• Data copied from Excel and pasted to Origin will be brought over with full precision, regardless of the
number of displayed decimal digits in Excel.
• When working with Excel files with header information, paste the Clipboard data into data row 1 in Origin
(not into the column label rows), then select a row and use the (right-click) shortcut key commands Set
as Long Name, Set as Units, Set as Comment, etc. to tag your header information.
• Data copied from the web can be formatted in various ways. You may have to experiment a bit to find a
method that brings the data over cleanly. If a simple copy and paste doesn't work, try using the Import
Wizard. The Import Wizard provides an interactive interface for parsing Clipboard data, with the added
benefit that you can save your procedure to an import filter file (.oif) for reuse with identically formatted
data. For more information, see the tutorial Using the Import Wizard to Import Clipboard Data.
72
Import Data
73
UserGuide_2022b
1. With the worksheet active, choose Data: Connect to File or Connect to Web.
2. Browse to your Origin file and click Open. This opens the Data Connector Browser.
Data will be selectively imported into the active workbook as specified by your query.
Common Keywords:
Keyword Description
Examples:
Select Column from Project where (Column_P1 like "*y*" and Column_D1 > 3);
Select Column from Project where (Book_SName like "Book*" or Book_LName like
"*fit*")
For more information, see Examples of using SQL query condition in Origin Connector.
74
Import Data
8.12 Database
Origin supports connecting to databases by ODBC and OLE DB. Additionally, Origin includes a simple SQL
Editor to add connection strings and generate SQL queries within Origin.
To import SQL data, start with the Data: Connect to Database menu command:
• Open lets you browse for and open a saved connection (ODS) or query (ODQ) file.
• Connection string: Select this if you already have a text-based connection string for a
given data source (ODBC or OLE DB).
• ODBC data source: Select this if you have defined an ODBC data source via the Windows
ODBC Data Source Administrator applet.
• ODBC driver: Select this if you have an ODBC driver and want to create a data source
applicable to this data connector instance.
• Windows Data Link Properties dialog: Select this if you are using an OLE DB-based data
source such as some SQL Server or Access client libraries.
• Use the LabTalk system variable @IPDB to control protection of imported range (0 = no protection, 1 =
protected but allow reorder, 2 = protected).
• Similar to other Connectors, you can opt to Exclude Imported (data) When Saving as OPJU/OGWU.
75
UserGuide_2022b
Help: Origin: Origin Help > Importing and Exporting Data > Importing Data from a Database
8.13 Digitizer
At times, you may only have a graphic representation of some data that you would like to explore further. Use
the Digitizer to import an image file, then digitize the plots, converting your image to numeric data that you
can study and re-plot using Origin's analysis and graphing tools.
76
Import Data
• Rotate the imported image, remove noise and calibrate scales by picking start and end values.
1. Click the Digitize Image button on the Standard toolbar or choose Tools: Digitizer... from the
main menu.
Users now have the option to save Origin files without imported data. This is a particularly attractive option for
those who work with large data files, where saving of that data with the file would hinder performance or
waste disk space.
• By default, data imported using a Data Connector, will not be saved with the book when the import file
size exceeds 500kB. Each book has its own Exclude Imported When Saving check mark and clearing
the check mark on any page in the book will cause all imported data to be saved with the book.
• Any book in the project -- not only those with Data Connectors -- can be configured to exclude imported
data by right-clicking on the window title bar, selecting Properties, then checking the Exclude imported
data when saving project box at the bottom of the dialog.
77
UserGuide_2022b
The act of excluding data when saving differs from saving a template file in a couple of important
ways:
• When you exclude imported data, you are still saving all output resulting from analysis operations on
imported data -- fitting results, statistical analyses, Set Values calculations, etc. -- you just don't save
imported data or graphs of that imported data.
• Books which you have saved without imported data retain a "live" link to the original data source. For
Data Connector-containing books, click the Data Connector icon and click Import (active sheet) or
Import All (all sheets in book). For books used for standard file import, activate the empty book and click
Data: Re-import Directly; or click the Re-Import no dialog button on the Import toolbar (see next).
• Re-Import Directly. When you import a file into an Origin worksheet or matrixsheet, by default a
number of parameters, including file path and name, are saved in the sheet. If you have an external data
file that is periodically updated or you want to reload a standard file into the worksheet, you can re-import
directly without opening an import dialog.
• Re-Import.... This menu command opens the corresponding X-Function import dialog box for the file
type so that you can adjust your import options before re-importing.
Notes:
• Only one file can be re-imported at a time. When you use either of these two menu commands,
only the file associated with the active worksheet or matrixsheet, will be imported. If the selected
data are imported from multiple files, re-importing will fail.
• If you import an ASCII file via the Import Wizard and select Data: Re-Import..., the impASC
dialog will open instead of the Import Wizard.
• Re-import does not work for Binary or User Defined data types brought in using the Import
Wizard.
78
Import Data
Clone import is supported by both Data Connector and X-Function-based import methods. A brief tutorial
will show you the basics of cloning import and analysis operations.
3. Click the column B header to select the column, then click the Scatter button to
create a scatter plot.
4. Click on the X or Y graph axis scale and in the Axis dialog box that opens, click the
Scale tab, then press Ctrl and select both Horizontal and Vertical axis icons in the
left panel. Set Rescale to Auto and click OK.
5. With the graph active, click Analysis: Fitting: Linear Fit and open the dialog box.
Set Recalculate = Auto, accept other default settings and click OK. Answer No to the
Reminder Message and click OK.
6. Right-click on one of your workbook tabs and click Add Graph as Sheet. This will
add your scatter plot with the linear fit results, as a page in your workbook.
7. Make sure the sheet with data imported from Sensor01.dat is active and click the
79
UserGuide_2022b
• Data Connectors
• Tutorial: Importing Multiple Files into Workbooks Cloned from Active Workbook
80
9 Workbooks Worksheets Columns
• Each worksheet contains a collection of columns (up to 65,500) and each column contains rows of cells
(up to 90,000,000).
• Each column has a Short Name (e.g. "A") that uniquely identifies it within the worksheet and a Column
Designation (e.g. "(X)" which determines how it is handled, by default, in plotting and analysis
operations.
• Each worksheet, and each worksheet column, has data-containing cells identified by row (index) number;
and a preceding metadata containing area ("header") comprised of optional label rows, including Long
Name, Units, Comments, etc.
81
UserGuide_2022b
For Origin 2022b, two convenient buttons are added to the workbook window: Add
Sheet and Show/Hide Organizer.
† > 255 sheets requires saving file to Unicode-compliant (e.g. *.opju) file format. Unicode formats not
compatible with Origin versions prior to Origin 2018.
82
Workbooks Worksheets Columns
• A Workbook has a Short Name and an optional Long Name and Comments.
Origin uses the Short Name for internal operations.
• Short Name must be unique within the project file, can contain only alpha-
numeric characters (letters and numbers), must begin with a letter and are
limited to 13 characters.
• A Workbook Long Name is optional, need not be unique within the project
Workbooks file, can use any characters in any order and has a limit of 5,506 characters
(including spaces).
83
UserGuide_2022b
• Worksheet Label and Comment are optional. They need not be unique within
Worksheets the project file, can use any characters in any order, and can be of any
practical length.
• The Short Name must be unique within the worksheet. When spreadsheet
cell notation is enabled (default setting), you cannot edit the column Short
Name (see Column Short Name Restriction). When cell notation is disabled,
you can edit the column Short Name. When editing Short Names note that
they must use only alphanumeric characters (no special characters), must
begin with a letter or number, and cannot exceed 18 characters.
• A Column Long Name is optional, need not be unique within the project file,
Columns can use any characters in any order and has a limit of 30,000 characters. The
Long Name can be edited directly by clicking in the Long Name cell or by
right-clicking on the column header and choosing Properties from the
shortcut menu.
• Dialog box and Status Bar references to data range will use Long Names,
provided that (1) Long Name exists and (2) you have selected Use Long
Names when available (Preferences: Options: Miscellaneous).
Otherwise, Short Names are used.
9.1.3 Workbooks
Origin workbooks are highly customizable and can be saved with data (e.g. Workbook File) or without data
(e.g. Workbook Template). Since they can be configured for many different applications, there is a good
chance that you will collect a number of custom files over time. The New Book dialog is useful for organizing
and choosing these files for use.
Origin 2022b supports Edit: Undo Delete Workbook (CTRL+Z). Set system variable
@WU to disable Undo.
84
Workbooks Worksheets Columns
For Origin 2022, an Open Template Center button was added to the New Book
dialog. Click the button to browse for additional workbook templates that you can
download and add to your template list.
• The dialog lists both add-on (Extended) and User-defined (User) files.
• Right-click on a template name and Edit metadata or Set as Default (e.g. New Workbook button).
Also, right-click to Clear Default.
• Enable Show in Menu to list a window in the New: Workbook or New: Matrix menus.
• Filter windows by type using the Book Type drop-down menu. Reset to show all.
85
UserGuide_2022b
Each window's Properties dialog has a Comments box for entering text. These
comments are included in the New Book dialog previews and the Project Explorer
previews. In addition, comments are searchable from the Edit: Find in Project tool.
Origin workbooks support Spreadsheet Cell Notation (SCN). Spreadsheet Cell Notation allows the sort of
cell-level calculations that are familiar to users of spreadsheets (more details below).
• In Origin 2017 - 2019, when SCN was enabled in the workbook, you saw this icon in the upper-left
corner of the worksheet.
• Beginning with Origin 2019b, the SCN icon is hidden (by default) but SCN remains enabled (also by
default) to make room on the workbook window for the Data Connector icon.
• Most users will want to leave SCN enabled but in rare cases (e.g. you need to customize the column Short
Name), you may want to turn SCN off. To disable SCN, right-click on the workbook title bar and choose
Properties. Look for the Spreadsheet Cell Notation check box about half-way down the page.
• When SCN is turned off, users of all versions will see this icon in the upper-left corner of the
workbook.
• If you open a project or workbook window in Origin and SCN is turned OFF in a particular workbook, the
SCN OFF button will display in the upper-left corner. This includes projects or workbooks that were
created prior to Origin 2017. To enable SCN, right-click on the book title bar, choose Properties and
check the Spreadsheet Cell Notation check box.
The workbook serves as a flexible container for all of your work-related data -- not just text and numeric data.
You can add graphs, matrices, images, notes; and store calculations, scripts and variables, text objects and
programmable buttons, and create live links to other project data. Beyond its role as a flexible data container,
the workbook can also serve as a medium for batch analysis and reporting.
86
Workbooks Worksheets Columns
This table summarizes the kinds of objects that can be saved in the workbook window at the workbook,
worksheet and worksheet cell levels, and how to access them.
87
UserGuide_2022b
• Right-click the
selected
column > Set
Column
Right-click in the gray Values
area to the right of last
Scripts • Added --
column > Show Script
Panel text/drawing
objects and
associated
scripts
88
Workbooks Worksheets Columns
Add Programmable
Buttons and Text
Text and Drawing
-- Labels and Drawing --
Objects
Objects to the
worksheet.
9.1.4 Worksheets
Prior to Origin 2018, an Origin workbook could contain a maximum of 255 worksheets. That number is now
increased to 1024. When you have more than 255 sheets in a book, you will need to save your file to one of
the Unicode-compliant formats (opju, oggu, otwu).
To add worksheets to the workbook, right-click on a worksheet's tab and choose one of the following:
• Duplicate Without Data. Duplicates the active worksheet without duplicating the data.
Each sheet in a workbook can have its own set of customizations. When you Insert or
Add a worksheet, the new sheet is based on the ORIGIN.otwu file, specifically the
version of ORIGIN.otwu that is saved to your User Files Folder (found in UFF if you
have customized this file). To add a sheet that is based on another sheet in the
workbook (including number of columns and special formatting), you would use the
Duplicate or Duplicate Without Data shortcut command.
A sheet has a single Name which can contain spaces and special characters. Optionally, you can add a Label
and/or a Comment.
1. Double-click on the sheet tab and enter a Name. Alternately, right-click on the sheet tab, choose Name
and Comments and edit the Name field.
System variable @SSL can be used to modify sheet naming behavior. Look for @SSL in the LabTalk System
Variable List.
When mousing over the worksheet tab, Name, Label and Comments appear as a
tooltip.
89
UserGuide_2022b
1. Right-click in the gray area to the right of the worksheet grid (but inside the workbook window) and
choose Properties.
You can use the Worksheet Properties dialog box to customize properties of the sheet, including...
• Display of row labels, header labels and grid lines (View tab).
• The number or rows and columns and other sheet dimensions such as column or row header height (Size
tab).
• Enabling of rich text, text wrap, how to display truncated cell content, sheet font and color (Format tab).
• Auto add rows, ignore hidden rows in plotting and analysis, cell resizing (Miscellaneous tab).
• Printing/exporting of grid lines, headers and footers, background color (Print/Export tab).
• Display and edit a user tree (e.g. the user adds some configuration info for use in the template) (User
Tree tab).
Note that many of the sheet customizations can be applied at the cell level by right-clicking on a selected cell
and choosing Format Cells.
Use the Object Manager's shortcut menu commands to manipulate display of workbook content:
• Click a sheet in Object Manager to activate the corresponding sheet in the workbook.
• Right-click in Object Manager for access to common worksheet operations, including Delete, Insert, Add,
Move, Copy, and Rename.
90
Workbooks Worksheets Columns
• To add a new column to the right end of an existing worksheet, right-click in the gray area to the right
of the worksheet columns and choose Add New Column or Click the Add New Column button on
the Standard toolbar.
• To add multiple columns to the worksheet, make the worksheet active then choose Column: Add New
Columns... from the main menu. Specify the number of columns to add in the Add New Columns dialog
box and click OK; or use the Format: Worksheet... menu item or the F4 hot key to open the
Worksheet Properties dialog, then set the desired value for Column Number in the Size tab.
• To insert a column into the worksheet, highlight a column, then right-click and choose Insert. A column
is inserted ahead of the selected column and column Short Names are adjusted accordingly.
• Double-clicking on the column heading opens the Column Properties dialog box. Enter/edit Short Name
and/or Long Name.
• Type a Long Name directly into the worksheet header cell by double-clicking in the cell.
• Import a data file and specify that the workbooks, worksheets, and columns be named upon import.
• Use the Enumerate Labels tab of the Worksheet Properties dialog to enumerate or duplicate column
names and labels.
• Type names into a few columns (e.g. Peak 1 and Peak 2), then highlight the cells and drag the bottom-
right corner of the selection to auto fill and enumerate the names for other columns. This also works for
other column label rows such as Comments. See the above table for rules on worksheet column naming.
91
UserGuide_2022b
As mentioned, worksheet Column Designations (aka "Plot Designations") generally determine how data are
handled during analysis and plotting operations. For instance, you might select an X column + three Y columns
to perform a simultaneous linear fitting of each Y dataset against a common set of X values. Or you might
select the same columns to graph 3 line plots against a common set of X values. In addition, there are
designations for Z values, for error data, for labels, etc. (for more information, see Column Designation in the
Origin Help file).
While there are a number of places in the user-interface where you can designate columns during some
analysis or plotting operation, at a basic level, they are set in the worksheet by (1) clicking on the column
header to select a column, then (2) doing one of the following:
• Right-click on the column and choose Set As and choose an option from the shortcut menu.
The Column Properties dialog box is used to customize properties of the column including...
• Plot Designation.
Use the Properties tab to edit the column Short Name, if desired. Other properties -- Long Name, Units
and Comments -- can be edited here or entered directly into the column label row cells.
92
Workbooks Worksheets Columns
Data in the Origin worksheet is treated as either text or numeric data. While the display of text data in the
worksheet is fairly straightforward, the display of numeric data is more complicated.
Unless otherwise specified, all numbers in the worksheet are stored internally as floating point, double
precision (Double(8)) numbers. This includes date and time, data which is formatted to display in degrees-
minutes-seconds or numbers that are formatted to display a fixed number of decimal digits.
When dealing with numeric data, understand that what you see in the worksheet is a representation of a
number that is stored internally. This is important for two reasons:
• Calculations involving worksheet values are always done on the double-precision number that is stored
internally, not the value that is displayed in the worksheet.
• You can apply various Format and Display options to change the way that this stored number displays in
the worksheet.
While the central place for formatting worksheet data is the Properties dialog, as
described above, keep in mind that there are quick-access Mini Toolbar buttons for
changing the Display of numeric and date-time data. Note that the Format of selected
columns must first be set as Date or Numeric/Text & Numeric for these buttons to be
visible.
By default, Origin stores date-time data as a modified Julian Day value and it uses this number for date-time
calculations. Typically, however, you will prefer to display this Julian Day value in a more meaningful date-time
format:
93
UserGuide_2022b
2. Click the Properties tab, then set Format = Time, Date, Month or Day of Week.
3. Set the Display list to one of the listed options.
4. If none of the listed options are appropriate you can choose Custom Display and construct your own
custom date-time string using these date-time format specifiers.
When importing date-time data into the worksheet, Origin will sometimes treat this data
as text (Origin's CSV Connector generally does a better job of recognizing date-time
data). If your date-time data are left-aligned in the worksheet cell, Origin "sees" it as text.
You will need to open the Column Properties dialog box and choose your Format and
Display options. When you see that your date-time data are right-aligned in the cell, you
know that Origin "sees" the data as numeric data, displaying in a date-time format.
• Supports direct entry of HTML color codes into the worksheet cell to set cell background color, with the
option to display or hide the HTML codes in the Color cell.
• Use the color() function to calculate hex values and set colors from RGB values in other data columns
using Set Column Values or cell formula (e.g. color(A,B,C) sets color using RGB values in columns A, B
and C).
94
Workbooks Worksheets Columns
• Select a column in which Format = Color and use a Mini Toolbar button to Save as Increment List
(color list) for use in your graphs.
• Alternately, from the Custom colors menu in the Color Chooser, choose Create Color List from
Column and pick a Color worksheet column from the flyout.
Origin can display numeric values in the worksheet in a variety of custom formats. This illustration shows
various formats applied to the same set of numeric values (column A(X)).
The following is a sample listing of some supported custom format options (this just happens to be the pre-
populated list that ships with Origin 2019). Note that you can enter custom formats directly into the Custom
Display list and they will be saved to this list.
There are many other format options. For more information, see Custom Numeric Formats.
Example
Format Description
if cell value = 123.456
95
UserGuide_2022b
Example
Format Description
if cell value = 123.456
# #/n Display a number as proper fraction, in nths. # #/8 displays 123 4/8
96
Workbooks Worksheets Columns
Example
Format Description
if cell value = 123.456
Origin 2022b adds cell Notes support to column label rows, including the F(x)= column
formula row. Select a cell and on the Mini Toolbar, click the Insert Note button.
Column label rows store metadata -- data that is used to describe other data. Typically, this metadata may be
brought in as header information in imported files, or it may be manually entered. Display of column label rows
is optional and the user can selectively show them or hide them, as needed.
97
UserGuide_2022b
Column label row information is often used in plotting operations (e.g. worksheet Long Names used as graph
legend text or Axis titles). The F(x)= row is used in performing math operations on columns of data (see
below). Data stored in User-defined Parameter rows might be used in labeling or grouping of datasets in
plotting, data manipulation, statistical analysis or math operations (see Tutorial 2, below).
You can copy a selected subrange of worksheet cells and include associated column
label row information with the copy-paste operation. To copy label rows with data cells,
right click on your subrange selection and choose Copy (including label rows).
Display (showing or hiding) of column label rows is controlled by shortcut menu commands:
98
Workbooks Worksheets Columns
There is also a worksheet column label row Mini Toolbar for managing label rows. Use it to do such things as
hide selected label rows, enable Rich Text or change label row order.
Origin 2019 introduced a new view mode for the worksheet called Column List View that is a transposed
view of the column label row metadata. This view is potentially useful if your worksheets have many rows of
metadata and you want to focus on some particular aspect of that metadata. With the worksheet active,
choose View: Column List View or press Ctrl + W.
Further, you can apply a data filter to metadata in Column List View. When you return to the standard
worksheet view (clear the mark beside View: Column List View), only data associated with the filtered
metadata will show in the worksheet.
99
UserGuide_2022b
Column List View displays column index number ahead of column short name (+ column
designation). In addition, you can hover on the left edge of column long name and a
tooltip reports dataset size. To disable the display of column index, set @DSI=1.
9.1.6.3 Sparklines
Numeric data stored in a column will graphically display in the column header in a special label row called
Sparklines. A sparkline is, by default, a small inset line plot of the data in a column, plotted as the dependent
variable (Y) against the row number or the associated X column as independent variable (X). When importing
data, Origin displays sparklines by default when the number of columns is less than 50.
• Show Sparklines by clicking Column: Add or Update Sparklines. This opens the sparklines dialog.
• Show Sparklines for selected columns by clicking the Add Sparklines button on the Column toolbar.
• Right-click on the worksheet's Sparklines column label row and choose Add or Update Sparklines.
• Delete sparklines by right-clicking the Sparklines column label row and pressing the Delete key.
100
Workbooks Worksheets Columns
• In addition to the default line plot, Sparklines can display as Histogram or Box Charts. Highlight one or
more columns by clicking on the column header, then choose Column: Add or Update Sparklines. In
the dialog box that opens, set the Plot Type to Histogram or Box.
• Sparkline plot properties can be customized. Double-clicking on a sparkline pops open a graph window.
Double-clicking on the pop-up window opens the Plot Details dialog box where you can customize the plot.
When you close the pop-up window, your customizations are applied to sparkline.
As mentioned, the workbook commonly stores metadata, some of which is visible in the column label rows.
Other metadata may be hidden in the workbook. Such hidden metadata might include things like import file
path and name, date and time of data import, file header information not written to the column label rows,
variable names and values, etc. This hidden metadata can be viewed in the Workbook Organizer panel.
101
UserGuide_2022b
Starting with Origin 2022b, you can add separate plain-text Notes to each sheet by
highlighting a sheet under Data Sheets in the Organizer panel.
A number of common book-, sheet-, column and cell-level properties can be set or toggled ON/OFF with a
Mini Toolbar button.
102
Workbooks Worksheets Columns
• To see which tools are available, make a worksheet selection and then hover on your selection.
• Page-level formatting options are shown by hovering in the upper-left corner of the sheet or near the
window margins in the gray area to the right of the worksheet columns.
Prior to Origin 2022b, the View: Mini Toolbars setting was not remembered across
sessions (i.e. if turned off in the current session, they would be restored on Origin
restart). Now, this setting is remembered across sessions (alternately, you can control
Mini Toolbar display by setting system variable @DMT (ON=0; OFF=1)).
• Clicking Find opens a small dialog for searching the current worksheet selection.
• While the dialog is minimized, you can edit within the selection or press CTRL + Page Up/Page Down to
search backwards or forwards; or change the worksheet selection and restore the dialog to perform a new
search.
• Click the ellipsis button (...) to open Origin's larger Find and Replace dialog.
103
UserGuide_2022b
Origin has another "Replace" tool that can be scripted: wreplace. To open a UI dialog,
open the Script Window (Window: Script Window) and type wreplace -d. To learn
about scripting options, see X-Function documentation for wreplace.
or
Fill a range or column with row
numbers
• Right-click and select Fill
Range/Column(s) With Row
Numbers
104
Workbooks Worksheets Columns
• Column:Fill Column
With:Uniform Random
Numbers
• Column:Fill Column
With:Normal Random Numbers
or
Fill a column with normally distributed
random numbers
• Right-click and select Fill
Range/Column(s) With Normal
Random Numbers
The auto fill feature can be used in filling column label rows and the worksheet data cells:
To use auto fill to extend a pattern in the data across a range of cells (numeric data only):
1. Select a contiguous block of cells and move the mouse cursor to the bottom right corner of the selection.
2. When the cursor becomes a "+", hold down the ALT key and drag the mouse to the bottom or the right.
105
UserGuide_2022b
To use auto fill to repeat a pattern in the data across a range of cells (text or numeric data):
1. Select a contiguous block of cells and move the cursor to the bottom right corner of the selection.
2. When the cursor become a "+", hold down the CTRL key and drag the mouse toward the bottom or to the
right.
1. With a new worksheet active, open the Script Window from the Windows menu, and copy-paste the
following lines of script code into that window:
col(1)={0:0.01:4*pi};
col(2)=sin(col(1));
2. Highlight the two lines and press ENTER to execute them. The first two columns of the worksheet will be
filled with data.
• The Set Values dialog and the F(x)= cell get Auto Complete support. Begin
typing to see a list of possible functions.
• The Search Functions dialog that is opened from the Function menu in the Set
Values dialog can now be opened directly from the Tools menu (Tools: Search
Functions).
The Set Values dialog box is used to set up a mathematical expression that creates or transforms one or
more columns of worksheet data. The dialog box includes a menu bar, a control used to define output range, a
tool for searching and inserting LabTalk functions into your expression, a column formula box used to define a
one-line mathematical expressions, a Before Formula Scripts panel (usage optional) intended for data pre-
processing and defining of variables used in your one-line expression and for Python users, a Python
Function tab for defining and using Python functions which can also be used in your expressions.
106
Workbooks Worksheets Columns
Since Origin 2017, the column formula box (the upper box) in Set Values has supported a simplified
spreadsheet cell notation like is used in MS Excel and Google Sheets. A cell is addressed using column
Short Name + row index number (e.g. the first cell in column A -- formerly represented as "col(A)[1]" -- is
now simply "A1").
In new workbooks, spreadsheet cell notation is enabled by default. Spreadsheet cell notation can only be used
in defining the column formula. It cannot be used in the Before Formula Scripts panel of Set Values, nor can
it be used in your LabTalk scripts. Note that the "old" column and cell notation will work in spreadsheet mode,
so if you are an experienced user and you prefer to use the old notation, you may enter it as you always have.
For an introduction to the spreadsheet cell notation syntax as well as a contrast with the "old" methods, see
Column Formula Examples.
1. Select multiple, contiguous worksheet columns (skip no columns) or the entire worksheet.
2. From the menu, choose Column: Set Multiple Column Values... or right-click on the worksheet column
and choose Set Multiple Column Values... from the shortcut menu.
107
UserGuide_2022b
Because Long Names need not be unique within the worksheet, Origin 2022b now
displays both Long Name and Short Name in the formula box.
108
Workbooks Worksheets Columns
• Formula: Load a saved formula into the column formula box. Formulas are
saved using Formula: Save or Formula: Save As....
• wcol(1): Use the menu to include worksheet columns in either your column
formula or your Before Formula Scripts (column reference is inserted at the
cursor). A Column Browser is available to help in selecting the correct
columns. Columns are listed by column index.
When you mouse over one of the functions listed in the Function menu in Set Values
dialog, a one-line tooltip is displayed in the Status Bar. If you select the function, a
Smart Hint appears with a more detailed explanation and a link to the full function
description, syntax, examples, etc.
Additionally, you can click the Search and Insert Functions button to search for
available functions by keyword and, once found, insert the function into your
expression.
For simple expressions, you can use the F(x)= row to set column values. Any expression you enter here is
directly entered into the Set Values dialog and vice versa. Note that the simplified spreadsheet cell notation
that works in the formula box in Set Values also works in F(x)=:
109
UserGuide_2022b
Note that there is "Auto Complete" support for Functions and Named Ranges in the
Formula Bar, cell formulas (begin typing with "="), the F(x)= cell and the Set Values
dialog. Hints are linked to function documentation (Functions) or data ranges (Named
Ranges).
If you prefer not to use Auto Complete, you can disable it by setting system variable
@FAC=0.
110
Workbooks Worksheets Columns
B*1.6
movavg(B,5,5)
and press Apply. Column 3 is filled with an 11-point moving average of the data
from column B (note that you can insert functions such as movavg from the
Function menu of the Set Values dialog box).
5. Click the >> button above the edit box to switch to the 4th column.
6. In the edit box for the 4th column, enter the formula:
movrms(B,5,5)
and press OK. This 4th column will be filled with root-mean-square (RMS) values,
using a window size of 11 at each point.
1. Create a new project by clicking the New Project button on the Standard
111
UserGuide_2022b
toolbar.
2. Click the Import Multiple ASCII button to import the files F1.dat and F2.dat
in the <Origin Folder>\Samples\Import and Export\ path. In the impASC dialog,
set Multi_File (except 1st) Import Mode to Start New Books and click OK.
3. Two workbooks are created, named as F1 and F2. Click the New Workbook
button on the Standard toolbar to create another workbook.
4. With the 3rd workbook active, click the Add New Columns button to add a
column. Highlight all columns and select Column: Set Multiple Columns Values
from the main menu or right-click the columns and select Set Multiple Columns
Values from the shortcut menu to open the Set Values dialog box.
5. Expand the bottom panel by clicking the Show Scripts button. Enter this
script in the Before Formula Scripts edit box,
range r2=[F2]F2!wcol(j);
112
Workbooks Worksheets Columns
• To use cell formulas, Spreadsheet Cell Notation must be enabled (it is by default).
• Cell formulas can incorporate cell references, variables, operators, LabTalk-supported functions and
constants.
• Cell formulas can be extended to other cells by dragging with your mouse.
When creating cell formulas, or column formulas using F(x)=, the Formula Bar makes it easier to find and
insert functions, select cell ranges and view and edit expressions, particularly long expressions that exceed cell
width.
To enter an expression into a cell (data cell or F(x)=), click on the cell, then:
1. Enter an "=" and type your expression; or click the button to open the Search and Insert
Functions dialog.
2. Search for the desired function then double-click on it to insert it into your Formula Bar expression.
113
UserGuide_2022b
3. Interactively select your data range going to the worksheet and (a) clicking on a column heading or (b)
dragging to select a range of cells.
Note that you can drag the edge of the Formula Bar to resize it. You can also change
the default font size by changing the value of LabTalk system variable @FBFS (default
is "130").
=A1+A$1
7. Click on the Cell in C1 but this time enter (omitting the "$"):
=A1+A1
114
Workbooks Worksheets Columns
column B "locked" the second cell A1 reference so that it didn't change but that the
A1 reference in column C changed with the row index number as we extended the
cell calculation to other cells.
The only place where you can use cell formulas in the worksheet column label rows
(worksheet header rows), is in a User Parameter row.
1. Create a new workbook and then choose Data: Import From File: Single ASCII
and import the file \Samples\Import and Export\S15-125-03.dat.
2. With your mouse, hover just to the left of the F(X)= row label and when the
pointer becomes an arrow, right-click and Add User Parameters.
3. In the dialog box that opens, enter "MaxValue" and click OK.
=Max(This)
5. Click outside the cell and cell should now display "10".
6. Click back on this cell, then grab the selection handle in the lower right corner of
the cell and drag to the right to extend the cell formula to MaxValue cells in
columns B(Y), C(Y) and D(Y). All MaxValue cells should now display the
maximum values in their respective columns.
All data in the worksheet column label rows, including User Parameter rows, is stored
as string data. To use a "number" stored in a column label row in a cell calculation, you
must convert the string to a numeric value. In the following example, we use the
LabTalk value() function to convert column label row data to a numeric so that it can
115
UserGuide_2022b
1. Create a new workbook and then choose Data: Import From File: Single ASCII
and import the file \Samples\Import and Export\S15-125-03.dat.
2. With your mouse, hover just to the left of the F(X)= row label and when the
pointer becomes an arrow, right-click and Add User Parameters.
3. In the dialog box that opens, enter "Correction" and click OK.
4. In column D, enter the value "0.2" into the Correction cell.
=D1+value(D[Correction]$)
7. Press ENTER. This converts the Correction value to a numeric and adds the
numeric to the value in cell D1. The cell should display 101.9.
NOTE: The "$" in the above expression does not function to create an absolute cell
reference as in the first example above. In this context, the "$" syntax is used to
express a string variable stored in a user-parameter cell, before converting that string
to a numeric value.
Origin 2022b adds support for named ranges to column label rows. Use, for example,
to incorporate a label row parameter value in your Set Column Values calculations.
You can assign a name to a worksheet data range and use the name in cell formulas or column formulas and
to define Reference Lines in graphs.
116
Workbooks Worksheets Columns
117
UserGuide_2022b
Beginning with Origin 2022b, you can use a small dialog to remove formulas and links
from the current selection, the active sheet, the active book or the entire project. This
converts formulas and links to raw numbers.
Removing formulas and links can make it easier to share project data with colleagues without having to share
such things as externally-linked (DDE) Excel files; or to significantly reduce project size before archiving data.
• Cell formulas
• Column formulas
• Linked cell values (e.g. values copied a report sheet and paste-linked to other worksheet cells in the
project).
For Origin 2022b, worksheet cell Notes get Rich Text support, meaning you can now
style text using Origin. In addition, you can add images and graphs, and link to
worksheet cell values, report table values, etc. See Notes Windows for Reporting.
1. To add a Note, select the worksheet cell and click the Mini Toolbar Add Note button .
118
Workbooks Worksheets Columns
2. Enter your text. If adding more than brief, simple text, click the Mini Toolbar Open in Notes
Window button. Rich Text is enabled by default.
3. While editing cell notes, use Format toolbar buttons (a) to format your text. To see your note in
"Render" mode (b), press CTRL + M (Notes: Render Mode). To insert the finished Note into the
worksheet cell, click the Close button (c).
119
UserGuide_2022b
For text that is not assigned a paragraph style (see next section), you can use the Font
Size control on the Format toolbar, to control text size. Font Size can be set for each
window but all Notes windows must share a common Font (e.g. Segoe UI).
Origin 2022b supports "substituting" cell Notes in graph legend and text objects using
@WN (e.g. %(1, @WN, B, 3) for Note in col(B), 3rd cell of 1st plot's source
worksheet).
In addition to styling text with the Format toolbar, you can apply a simple set of styles
to each line/paragraph. Manage styles with the Text Styles Manager dialog box.
120
Workbooks Worksheets Columns
Note that you can add styles by selecting <new> from the Styles to Modify drop-down list; or select a style
and Delete.
121
UserGuide_2022b
• Hide Column
Column: Hide/Unhide Columns
• Hide Rows
Hide/Unhide Rows (shortcut menu only)
• Append Worksheet
Worksheet: Append Worksheet
• Split Columns
• Split Worksheet
• Split Workbooks
Worksheet: Split Columns
122
Workbooks Worksheets Columns
Worksheet: Remove/Combine
Duplicated Rows
Worksheet: Reduce Columns
Worksheet: Reduce Rows
• Data Reduction Analysis: Data Manipulation: Reduce
Duplicate X Data
Analysis: Data Manipulation: Reduce
by Group
Analysis: Data Manipulation: Reduce to
Evenly Spaced X
• Worksheet Transpose
Worksheet: Transpose
123
UserGuide_2022b
• Reverse Order
Column: Reverse Order
• Highlight mode opens a dialog box with controls to apply color to worksheet cells based on one or more
conditions (e.g. "equal to", "not equal to", "text that contains", etc).
• Duplicates mode opens a dialog box with controls to apply to worksheet cells that contain duplicate
values.
• Heat Map mode opens a dialog box with controls to apply a color map to cells based on worksheet values.
The worksheet Heat Map is zoomable and scrollable, making it easy to get a "big picture" overview of data
variation in three dimensions.
Manage conditional formatting in the active sheet using the Conditional Format Manager.
When using 3-Color Limited Mixing to apply color to worksheet heatmaps, you can now
precisely control where the middle color falls. Specify by Percentile, by Percent or by
Value.
124
Workbooks Worksheets Columns
Apart from text and numeric data, the workbook can contain various other types of information -- images,
graphs, notes and matrices; links to cell values in other books, project variables, documents or web pages;
plus, import file metadata, variables and scripts -- making the workbook a flexible medium for collecting
research data or for creating custom reports.
Further, as we will see, the workbook can "store" a complex sequence of analysis operations -- for instance,
the application of a data filter, plus a fitting operation on the filtered data, combined with a customized plot of
the results -- into something that we call an Analysis Template. The Analysis Template makes it possible to
automatically generate a custom report of results, simply by supplying new input data.
One attractive option for generating reports (there are others -- see the tip at the bottom of this section) is to
export data to a custom MS Word template, and optionally, a PDF file. This is done by running an output-
generating analysis in Origin, then associating key results with bookmarks in a Word template, and, finally,
saving the workbook as an Analysis Template. To generate your report, you open the Batch Processing tool,
point to both your Analysis Template and your Word template, run the batch process and generate your
reports.
• For information on generating custom reports using an MS Word Template, see the tutorial
Batch Processing with Word Template for Reporting.
• For information on batch analysis and generating custom reports, see the Batch Analysis
section of the "How to Handle Repetitive Tasks" chapter of this Guide.
125
UserGuide_2022b
Another option for generating reports is to create HTML reports using Origin's Notes
window. A Notes window can link to graphs, worksheet cells, etc., either directly or
using a placeholder sheet. For more information, see HTML Reports from Notes
Windows.
126
Workbooks Worksheets Columns
127
10 Matrix Book Matrix Sheet Matrix Objects
† > 255 sheets requires saving file to Unicode (e.g. *.opju) file format. Unicode formats not compatible with
Origin versions prior to Origin 2018 SR0.
Note: The product of any combination of rows and columns must not be greater than 90,000,000.
129
UserGuide_2022b
• The matrixbook has a Short Name whether you display it or not. Origin uses
the Short Name for internal operations.
• Short Names must be unique within the project file, cannot contain spaces,
must begin with a letter, consist only of alphanumeric characters (A to Z and 0
to 9), and limited to 13 characters. You can use lowercase characters and the
Matrixbook text will appear as such, but upper and lower case are not unique characters.
(You cannot name one matrix MBOOK1 and another mbook1.)
• Long Names are optional, need not be unique within the project file, can
contain spaces, can begin with a letter, a number or a special character, and
the length cannot exceed 520 characters, including spaces.
130
Matrix Book Matrix Sheet Matrix Objects
• The sheet Name must be unique within the matrixbook and is limited to 32
characters.
• You can add a name to the object by clicking on the yellow object icon - for
Matrix Objects a data matrix or for an image matrix - in the upper right corner of the
matrixsheet and choosing Rename from the menu. Alternately, you can
double-click on the matrix object number/name below the thumbnail and enter
a name.
In the worksheet, a dataset is contained in a single column and the dataset may consist of X,Y,Z, Error, or
Label data. In the Origin matrix, a dataset is arranged in a specified dimension of rows and columns. The
matrix contains a single dataset of Z values.
Note that the matrix window has two column and row heading view modes:
• By default, matrix row and column headings display as row and column index numbers (View: Show
Column/Row from the menu or press Ctrl+Shift+C).
• You can opt to view matrix row and column as X and Y values by choosing View: Show X/Y from the
Origin menu (or press Ctrl+Shift+X). The displayed X and Y values are the X and Y coordinate values,
calculated by linear interpolation of the axes From and To values by the number of columns and rows.
131
UserGuide_2022b
In addition to the two row and column heading view modes, there are two matrix display modes:
• In Data Mode (View: Data Mode from the menu or press Ctrl+Shift+D), the matrix object displays as
raw numbers.
• In Image Mode (View: Image Mode from the menu or press Ctrl+Shift+I), the matrix object displays
as either a gray scale image or a color image, depending upon the type of data in the matrix. A matrix of
real numbers or complex numbers displays as a gray-scale image while RGB values will display as a color
image.
132
Matrix Book Matrix Sheet Matrix Objects
Note: If the matrix object is an image, the object icon will display as whether you are viewing the
matrix object in Image Mode (View: Image Mode) or Data Mode (View: Data Mode). Similarly, when
you import numeric data into the matrix, the object icon will display as regardless of View mode.
10.1.3Matrixbooks
Like the workbook window, the matrixbook window is created from a customizable template (.otmu file). The
matrix template stores such things as number of sheets in the book, the names of the matrixsheets, matrix
dimensions, data type, math functions, data import handling instructions as well as various style and format
options.
When you create a new matrixbook, the book is named MBookN, with N reflecting the order of window creation.
Appended to the book name, you will see something like ":1/3" where the first integer denotes the active
matrix object and the second denotes the number of matrix objects in the active matrixsheet. Following the
above example, if you click the yellow object icon to the right side of the matrix, the menu shows three matrix
objects with the first being the active one - the one with a check mark placed beside it (note that in our
illustration, the objects are empty).
You can right-click on a worksheet tab and Add Matrix as Sheet and insert a
matrixbook into a workbook. This is useful when building Analysis Templates that
involve matrix-based operations such as 3D surface fitting or 3D plotting operations.
133
UserGuide_2022b
10.1.4Matrixsheets
Prior to Origin 2018, an Origin matrixbook could have a maximum of 255 sheets. That
number is now increased to 1024. When you have more than 255 sheets in a book, you
will need to save the file using one of the new Unicode-compliant formats (opju, ogmu,
etc).
A matrixbook can have up to 1024 matrixsheets. The default matrixbook template - ORIGIN.otmu - has a
single matrixsheet containing 32 rows and 32 columns. Each matrixsheet can differ in dimensions(number of
rows and columns and X & Y range).
1. Click on a tab to activate the sheet and choose Matrix:Set Dimensions/Labels. This opens the Matrix
Dimensions and Labels dialog box.
2. Specify a number of columns (X dimension) and rows (Y dimension).
3. Specify a From and To value for X (columns) and Y (rows).
Note: The X and Y coordinates of the matrix are evenly spaced. The first X is mapped to the first matrix
column and the last X is mapped to the last matrix column. The X coordinates of other columns are
interpolated. Matrix rows are similarly mapped using the From Y and To Y values. When plotting or
analyzing matrix data, the position of a point in 3D space is determined by the column X and row Y
coordinate values (not column or row index) and the Z value contained in the cell intersected by the row
and column.
10.1.5Matrix Objects
A matrixsheet can contain up to 65,504 matrix objects, though the actual limit is likely to be far less
(determined by system resources). Objects in a sheet share the same X/Y dimensions and column (X) and row
(Y) headers, but every object can have its own Z header. Other matrix object properties include internal data
type and numeric display options.
Matrix object properties are set in the user interface via the Matrix Properties dialog box. To open the dialog
box:
1. Make sure that the matrix object is active (check mark shows beside it in the object menu).
134
Matrix Book Matrix Sheet Matrix Objects
You can set properties for multiple matrix objects without closing the Matrix Properties
dialog box by clicking the << Previous or Next >> buttons at the top of the dialog
box.
Origin has two structures for importing multi-frame images -- the matrix window and the Image window. The
matrix window is better-suited to performing data analysis tasks (e.g. surface fitting, statistics, mathematic
transformations of data, etc.) and some graphing operations, but take note of the following:
• When you import an image to the matrix, you can -- as with other matrix data -- switch between "Data
Mode" (View Data Mode) and "Image Mode" (View: Image Mode).
• However, until converted to data, matrices contain RGB values (regardless of View mode), as seen in the
second window in the sequence below.
• Performing certain analysis or graphing tasks requires that the matrix first be converted to Z values (e.g.
Nonlinear Matrix Fit or creating an Image Plot) by choosing Image: Conversion: Convert to Data.
135
UserGuide_2022b
For more information, see Image Conversion in the Origin Help File.
1. With the matrix active, choose Data: Import From File: Image to Matrix.
2. This opens the Image to Matrix (impImage) dialog. Note that there are are controls for Import
Grayscale GeoTIFF as Data, Show Image Thumbnails and multi-file import-handling.
136
Matrix Book Matrix Sheet Matrix Objects
When the sheet contains multiple objects, you can display those objects as a series of thumbnails in a spacer
at the top of the matrix window.
1. Right-click on the matrix window title bar and place a check mark beside Show Image Thumbnails.
137
UserGuide_2022b
Alternately, you can use a slider control to view these objects in the active matrixsheet.
If you are seeing thumbnail images in the spacer at the top of the window, you can switch to the slider by
doing the following:
1. Hover in the space between the thumbnails and when the cursor changes to a grid icon , click to show
the page Mini Toolbar (you can also click in the gray area to the right of your matrix image).
3. Likewise, you can turn off both thumbnails and slider by clicking the Image Selector button. Click the
View Image button to toggle between Data Mode and Image Mode.
138
Matrix Book Matrix Sheet Matrix Objects
Named ranges can be used in Matrix: Set Values (e.g. to perform math operations on other matrix objects of
the same dimensions).
GeoTIFF is a public-domain image format that stores spatial information in a TIFF file
and which has applications in mapping. Starting with Origin 2022b, Origin supports
import of GeoTIFF files to both matrices and Image windows.
For more information, see the Origin Help file page for GeoTIFF Importing and Processing.
1. Go to Tools: Region of Interest Tools and verify that there is a check mark beside the menu item. If
not, click on this item or press CTRL + SHIFT + T to enable the ROI tools.
139
UserGuide_2022b
2. Click on the displayed ROI tool (e.g. Rectangle Tool ) on the Tools toolbar and choose an ROI shape
from the flyout menu (rectangle, circle, polygon, region).
3. Using your mouse, drag out an area on the image and double-click to set your selection. Once the
selection is set, additional clicks allow rotating, stretching, or skewing the ROI.
4. To add multiple ROI to a matrix, you must give each ROI a name that is unique within the matrixsheet.
Double-click on the ROI to open a small dialog with access to the object name.
5. Right-click on your ROI and choose an option from the shortcut menu. To discard the ROI, press Delete:
o Crop: Crop the image to the minimum rectangular area that will contain the ROI. By default,
values outside the ROI will show black (zero values in Data Mode).
o Copy: Rectangle only. Creates an image from the ROI.
o Copy Positions: Copy the position of the selected ROI.
o Paste Positions: Paste the position of the selected ROI to another ROI (width, height...all).
o Export ROI: Save the ROI object(s).
o Import ROI: Replace the object(s) with those in a saved .ROI file (hint: create a "dummy" ROI
to import).
o Create New: Use the mroi2mat tool to generate a new matrix from the ROI.
o Extract as XYZ: Use the mroi2xyz tool to generate a new worksheet of XYZ values.
o Intensity Profile: Use the mroiprofile tool to generate a statistics for the ROI.
140
Matrix Book Matrix Sheet Matrix Objects
ROI stats are automatically reported to the Status Bar. Right-click on the Status Bar to
hide or show statistics.
Note that if you import an image to the matrix (Data: Import From File: Image to Matrix) you must first
convert the image to data (Image: Conversion: Convert to Data) before creating your Image Plot (Plot:
Contour: Image Plot).
141
UserGuide_2022b
By default, the image plot will use the same colormap, Z scale range and missing value color, as matrix image
mode (View: Image Mode). See Matrix: Apply Palette to Color Map, below.
For Origin 2022b, a Transparency control is added to the Plot Details Colormap tab
of Image Plots created from matrix data.
• Open an image file for basic manipulation (flip, rotate, convert to gray-scale) using the Image Window's
Mini Toolbar.
• Edit an image inserted into a worksheet cell or graph window (double-click on the inserted image).
• Define one or more regions-of-interest (ROI) for which you can Copy Positions, Paste Positions (from
another ROI), and Export or Import position information saved to an Origin *.ROI file (a text file with
position information on each ROI on the image).
• Open and operate on images inserted to worksheets or graphs: crop, copy, export ROI, etc.
• Content can be exported to one of several raster formats: BMP, GIF, JPG, PNG,
TIF. For Origin 2022b, you can adjust DPI in the exported file.
• Import multiple GeoTIFF files of same dimensions into an Image window and
enable a slider.
1. Choose File: New Image, then choose an option from the flyout menu.
• Empty Window: You can later add a file by right-clicking and choosing Import or Import
from Web. Alternately, click the New Image button on the Standard toolbar.
142
Matrix Book Matrix Sheet Matrix Objects
• Image/Video (CTRL + ALT + I): Use the file type drop-down to specify an image or video
file format.
143
UserGuide_2022b
• Multiple Image Files (CTRL + ALT + T): Specify which files to import as a stack, including
GeoTIFF. Note that the resulting stack will show an image slider, by default.
• Web Image (CTRL + ALT + L): Enter a URL in the dialog to link to a web-stored image. Hint:
to grab an image URL, right-click on the web image and choose Copy image link or Copy
image address.
144
Matrix Book Matrix Sheet Matrix Objects
GeoTIFF is a public-domain image format that stores spatial information in a TIFF file
and which has applications in mapping. Starting with Origin 2022b, Origin supports
import of GeoTIFF files to both matrices and Image windows.
1. Click File: New: Image: Image/Video and choose the GeoTIFF image.
1. Click File: New: Image: Multiple Image Files and choose your images. Images are imported to the
active Image window and a slider is added to scroll images.
• The Image window Mini Toolbar has a button for setting Missing Value Color
• Convert an Image window containing multiple GeoTIFF files to matrix using Image: Convert
to Matrix. Each image in the stack becomes an object in the output matrix.
Click inside the window, somewhere near the top, to show the Mini Toolbar.
For more information, see the Origin Help file page for GeoTIFF Importing and Processing.
145
UserGuide_2022b
• To help control Origin project file size, right-click on an Image Window image and enable Linked File.
This saves a link to the image file into the window but excludes the image from the saved project. When
you reopen the saved project, the window will appear empty; at this point, you can decide whether you
need to re-import the image (CTRL + 4 or Import from the window shortcut menu).
• Actual Size Mode is turned on by default for images of max width or height of less than 800 pixels. The
size threshold can be adjusted using system variable @IWP (see this FAQ for info on changing the value
of a system variable).
Display of image information and navigation controls is enabled or disabled via the the View menu and/or the
Image Window Mini Toolbar (None, Thumbnails, Video or Slider).
146
Matrix Book Matrix Sheet Matrix Objects
10.4.3Image Resize
10.4.4Define ROIs
For Origin 2022b, you can add multiple ROI without stopping to rename each (see 2.,
below). To speed operations, Add ROI is added to the matrix image shortcut menu.
You can define a region-of-interest using one of the ROI tools (e.g. Rectangle Tool ) on the Tools toolbar.
1. Select the tool and drag out an ROI. Once added, fine adjustments can be made by dragging the blue
handles.
2. To add multiple ROIs to an image, (a) click an ROI tool (Rectangle/Circle/Polygon/Region) and drag out
your ROI or (b) right-click on the matrix image and choose Add ROI. Repeat as needed. Objects will be
named as "ROIxx" as they are added.
147
UserGuide_2022b
When the ROI is selected, use the Style toolbar Line/Border Color button to
change the outline color of the ROI.
Mini Toolbar buttons are available for performing simple image manipulation, including rotating, flipping or
converting to grayscale.
You can apply a color palette to a grayscale image using the Palette button on the
Style toolbar. Click More Palettes to open the Color Manager dialog box and add
more palettes.
148
Matrix Book Matrix Sheet Matrix Objects
1. Activate the matrix object and choose Plot > 2D: Profile: Image Profiles from the main menu.
This creates an image plot and opens the Image/Contour Profile dialog box. Use the dialog box to specify X
and/or Y profile plots and the location and appearance of the cross-sectional lines. Note that this dialog box is
interactive. You can make adjustments to your image profile -- move the cross-sectional lines or change the
configuration or the appearance of the plots -- without closing the dialog box. After closed the dialog box, a
button Profiles...will appear at the right-top corner of graph window, which can be used to reopen the
Image/Contour Profiles dialog.
149
UserGuide_2022b
You can assign a name to a matrix object and use the name Set Values (e.g. to
perform math operations on other matrix objects of the same dimensions).
To open the Set Values dialog box, make sure that the matrix object is active, then:
or
1. Select the matrix by clicking in the upper-left corner (in the empty header cell just below the matrix
icon/name), then right-click on the matrix and choose Set Matrix Values from the shortcut menu.
150
Matrix Book Matrix Sheet Matrix Objects
• Formula: Load a saved formula into the matrix formula box. Formula are
saved using Formula: Save or Formula: Save As....
• Mat(1): Use the menu to include matrix objects in either your matrix formula
or your Before Formula Scripts (matrix object reference is inserted at the
cursor). A Matrix Browser is available to help in selecting the correct objects.
Objects are listed by object index.
Menu • Mat(A): Similar to Mat(1) menu functionality but matrix objects are listed by
Commands object Long Name, if one exists.
• Enter one or more lines of LabTalk script to be executed before the expression
Before Formula in the Matrix formula box is executed.
Scripts
Use the Before Formula Scripts panel at the bottom of the Set Values dialog box to
define variables or LabTalk functions that you wish to use in your matrix formula.
Click the Search and Insert Functions button to search for built-in LabTalk
functions.
151
UserGuide_2022b
Matrix: Resize
• Transpose a matrix.
Matrix: Transpose
• Generate a 3-dimensional
dataset by transforming XYZ
Matrix: Generate Grid
values by formula.
152
Matrix Book Matrix Sheet Matrix Objects
You can use the Palette button and the Missing Value Color button in the Mini Toolbar to customize
the color of the matrix window.
The selected palettes and missing value color will apply to all matrix objects in the
active matrix sheet, but will not change the palettes and missing value colors of objects
in other matrix sheets in the same matrix window.
There are two methods for converting matrix data to worksheet data -- Direct and XYZ Columns. Starting,
for instance, with the following arrangement:
10.9.1Direct
This copies the Z values in the matrix to a worksheet with no reordering. If the matrix consists of M rows by N
columns of Z values, this method produces a worksheet which has M rows and N columns. By default, the X
and Y coordinates of the matrix Z values are not copied to the worksheet. You can opt to copy X coordinates to
the 1st worksheet row or a parameter row and the Y coordinates to the 1st worksheet column.
153
UserGuide_2022b
10.9.2XYZ Columns
When there is a single matrix object, this method produces a worksheet with three columns: X,Y, and Z, with
X and Y columns containing the X and Y coordinate values and the Z column containing the matrix Z value at
each XY coordinate.
• Saves matrix object Long Name, Units and Comments to the Z column label rows.
• If the converted matrix contains a color image, the resulting Z column will display a Color column of HTML
colors for each matrix cell.
154
Matrix Book Matrix Sheet Matrix Objects
When there are N matrix objects, you can set Convert On = All Objects and output columns as X, Y and Z x
N (i.e. XYZZZ...).
1. With the worksheet active, choose Worksheet: Convert to Matrix and choose one of the following
methods:
155
UserGuide_2022b
• Y across columns M.
Direct
• No X and Y • Y data values in the 1st
column, X data values in the
1st row and Z values in
columns 2 to N and rows 2 to
M.
• Expand by Column:
specifies the number of
ASCII file columns
comprising one matrix
column.
156
Matrix Book Matrix Sheet Matrix Objects
157
UserGuide_2022b
Note: You can create 3D plots from XYZ columns of worksheet data in which data are irregularly spaced in
the X and Y dimensions. This is not considered a "virtual matrix."
158
11 Graphing
All graph types are accessible from the Plot menu. Note that while most graph types also have a
corresponding 2D Graphs or 3D and Contour Graphs toolbar button, some do not. Until you've had time to
familiarize yourself with available toolbar buttons, the Plot menu should be your "go to" place for creating
graphs.
Some Origin graph types have very specific data requirements. Other graphs can be created from multiple
data arrangements. See the Origin Graph Types section for specific requirements.
Origin's most generic graph types -- line, column/bar, pie -- plus a lot of the more specialized types, are
created from worksheet data. The following quick tutorial demonstrates importing an ASCII data file and
creating a simple graph.
1. Open a new workbook and select Data: Import from File: Single ASCII... from
the main menu.
2. Choose the file Samples/Curve Fitting/Multiple Gaussians.dat and click Open.
3. Now highlight columns B(Y), C(Y), D(Y) and E(Y) by clicking and dragging across
the four column headings.
4. Click Plot > Basic 2D: Line & Symbol: Line & Symbol. A graph window is
created with four line and symbol plots. Note that the plots differ by line color and
by symbol type.
5. Return to the worksheet, and again select columns B(Y), C(Y), D(Y) and E(Y).
6. This time, select the Plot > Multi-Panel/Axis: 4 Panel menu item. Note that a
very different plot is created using the same datasets.
We were able to quickly create two different graphs using the same data. The chapter Customizing Graphs
discusses customizing graphs and saving templates in more depth.
We are also able to create 3D plot types from worksheet data. The following tutorial demonstrates creating a
3D surface plot, then overlaying it with a 3D scatter plot.
159
UserGuide_2022b
1. Create a new, empty workbook window and import the file \Samples\Matrix
Conversion and Gridding\XYZ Random Gaussian.dat.
2. Highlight column C and right click. Select Set As: Z from the fly-out menu.
3. Select Plot > 3D: 3D Colormap Surface to create a 3D Colormap Surface plot.
4. Select the Graph: Layer Contents... menu item or right click the layer icon on the
left-top of the graph to open the Layer Contents dialog. In this dialog, click on
5. Select column C from the left panel and click on the Add Plot button to add
the 3D scatter plot to the graph. Click OK to close the dialog.
6. Double-click on the plot to open the Plot Details dialog. In the left panel, expand
the Layer1 node and then expand the 2nd node which represents the scatter plot.
Click and select the branch named Original. Be sure to leave the node-level check
box selected, otherwise this plot will be hidden.
7. In the Symbol tab on the right side, set Shape to Ball, Size to 12 and Color to
Color Mapping: Col(C).
8. In the Drop Lines tab, clear the Parallel to Z Axis check box.
9. Select Layer1 from the left panel of the Plot Details dialog. In the Lighting tab,
under Mode, select Directional. Click OK to close the dialog.
10. Click on the scatter plot in the graph to select this plot, then in the Style toolbar,
160
Graphing
You can hold down the R key on your keyboard and use the mouse to freely rotate the
3D surface. With the pointer tool active, click on the layer for additional controls to
move, stretch and rotate the surface.
The labels (X), (Y), (Z), etc. in column headings are referred to as the Column Plot Designation. Columns
can also be designated as Label, Disregard, Y Error or X Error. Each plot type has certain data
requirements (e.g. a simple line plot requires one X and one Y dataset) and column plot designations work in
concert with settings saved in the graph template, to allow you to quickly create a graph.
To set the Column Plot Designation, select a column or multiple columns, then from the menu choose Column:
Set as:<option>; or right-click and choose an option from the Set As: context menu.
In the 1st tutorial above, we plotted 2D graphs, which require Y data from one or more worksheet columns.
The Y data were automatically plotted against the X column data to their left. In 2nd tutorial, we plotted a 3D
graph using Z data. The Z data were plotted against X and Y data columns to the left of the Z data column.
Note: For more information on Column Plot Designations and how they affect plotting behavior, see Plot
Designation, in documentation for the Column Properties Dialog Box.
• Multiple columns: To select a small number of contiguous columns, click on the first column heading and
drag the pointer to the last column heading. To select a large number of contiguous columns, click on the
first column heading, use the scroll bar at the bottom of the worksheet to locate the last column, then
press the SHIFT key and click on the last column heading. To select non-contiguous columns, press the
CTRL key while clicking on the desired column heading.
• A range in a column: Click on the first cell of the range and drag to the last cell of the range.
• Multiple ranges within a column: Select one range. Press the CTRL key while selecting each range.
When plotting, each range will be treated as a separate data plot in a plot group.
• Ranges across multiple columns: If cells are contiguous, click on the first cell and drag to the last cell.
If cells are not contiguous, press the CTRL key while selecting each range. Each range selection will be
treated as a separate data plot in a plot group.
• Range(s) across all columns: Click on the first row heading and drag to the last row heading, to select
multiple rows. This will select data in all columns in the worksheet. Press the CTRL key while selecting row
headings for non-contiguous rows. Each range selection will be treated as a separate data plot in a plot
group.
• Entire worksheet: Press CTRL+A to select the entire worksheet; or mouse over the bottom-right corner
of the blank cell in the upper-left corner of the worksheet. When the pointer becomes a downward-
pointing arrow, click to select the entire worksheet.
• Specific columns: To select columns by data in column label rows (header rows); or to select columns
using a pattern, choose Edit: Select.
161
UserGuide_2022b
As noted in the Worksheet Column Plot Designations section just above, if you select Y
or Z columns, Origin defaults to plotting the Y column against the nearest X column to the
left; or to plot the Z column against the nearest Y and X columns to the left. But if you In
the case of simple XY 2D plots (line, line+symbol, etc.), you can ignore this rule and plot
with selected XY columns not matter the selected X is on the left or right side of Y.
As discussed in the Matrixbook, Matrixsheets and Matrix Objects chapter, a matrix is a dataset of Z values
arranged as an array of columns and rows which are linearly mapped to X (column) and Y (row) values. Matrix
data is used to create 3D, contour and heatmap graphs -- all of which require require "3D" data. In earlier
versions of Origin you had to have your data in a matrix to create such plot types but this is no longer the case
(see discussion of the Virtual Matrix below). A few graph types such as a color-filled surface with error bars
still require matrix data.
There are still many situations in which you will be creating 3D plots from matrix data. If data are stored in a
worksheet and for one reason or another, you need to convert it into a matrix form, see Converting
Worksheets to Matrixes.
Once your data are in a matrix form, plotting matrix data is simple: activate the matrix window then select
your plot type using a Plot menu command or corresponding 3D and Contour Graphs toolbar button. Since
you cannot plot only a portion of the matrix, data selection isn't necessary. You can, however, choose a subset
of the data plot to display once the graph is created. See Editing Plot Range, below.
The Virtual Matrix concept was covered in the Matrixbook, Matrixsheet and Matrix Object chapter of this Guide.
To recap, a virtual matrix is a block of worksheet cells which contain Z values, with X and Y coordinates in the
first row or column label row, and first column. X and Y coordinates don't have to be evenly spaced and can
even contain text or date/time data.
When selecting and plotting virtual matrix data to 3D, Contour and Heatmap graph types, the worksheet's
Column Plot Designations are ignored. Instead, a dialog box is opened where you designate your X and Y
coordinates. The intersecting data points are then treated as Z values.
1. With a new workbook active, use the Data: Import from File: Import Wizard...
menu to open the Import Wizard dialog.
2. Press the browse button in the dialog and select the file Waterfall.dat from the
Samples\Graphing subfolder.
3. This file has an import filter already associated with it. Press the Finish button to
162
Graphing
the Palette button and then select the Pumpkin Patch palette. Your graph
should look similar to the image below:
Once you customize your contour levels and colors, you can save your settings as a
Theme, or simply copy-paste your customizations from one graph to another. To save a
Theme, right-click on the graph and choose Save Format as Theme; or use the
Colormap Theme controls on the Colormap/Contours tab of the Plot Details dialog
box.
163
UserGuide_2022b
Unlike plots from worksheet data or plots from matrix data, parametric plots are not plots of actual data.
Instead, they are plots of mathematical functions.
To create function plots and parametric function plots, select File: New: Function Plot menu. There are four
options to choose from:
x = f1(u, v)
3D Parametric Function
y = f2(u, v)
Plot
z = f3(u, v)
These plot types are also accessible from the function plot buttons on the Standard toolbar.
1. From the menu, choose File: New: Function Plot: 3D Parametric Function
Plot...
2. In the dialog that opens, click on the arrow button at the top right side of the
dialog, and from the fly-out menu select the built-in example Partial Torus
(System) and press OK to close the dialog. The function plot will be created.
3. With the function plot window active, invoke the menu File: New: Function Plot:
3D Function Plot....
4. In the dialog that opens, enter -5 and 5 for the From and To edit boxes for x and
164
Graphing
y scale.
5. In the Z(x,y) edit box, enter 0.
6. Set the drop-down at the bottom left corner of the dialog to Add to Active Graph
and press OK to close dialog.
7. The Z=0 plane will be added to the graph, and the plane will properly intersect the
parametric surface plot. You can hold down the R key and use the mouse to freely
rotate the plot.
• Some function plot dialogs provide sample formulas. Click the arrow button beside Theme at the top of
the dialog box to access them. You can download more examples at http://originlab.com/3dfunctions.
• For 2D parametric, 3D, and 3D parametric function plots, data is generated when the function plot is
created. To create data for 2D function plots, right-click the plot and choose Make dataset copy of
Function or if on the Function tab in Plot Details, click the Workbook button.
• Besides function plots, you can also create graphs with all built-in and user-defined nonlinear curve-fitting
or surface-fitting functions. From the menu, choose Analysis: Fitting: Simulate Curve... or Simulate
Surface.... You can even add noise to the plot. Corresponding data is created as well.
You can add function plots to existing graph windows containing other plot types. See FAQ-171, specifically
the section entitled Add Function Plot to an Existing Graph.
165
UserGuide_2022b
column designations on an ad hoc basis, allowing you to overcome some of the restrictions of template-based
plotting.
However, to make use of the Plot Setup dialog box, you need to have some familiarity with the hierarchy of
objects contained in the Origin graph window.
Each Origin graph window is comprised of a single, editable graph page. The graph page is defined by the
white area inside the graph window. Anything that lies outside the page is not printed or exported. By default,
the dimensions of the graph page are defined by the printable area of your default printer driver; without
adjusting settings, a printed graph should fill the printed page.
• The graph page must contain at least one, and may contain as many as 1024, graph layers.
• Each graph layer generally contains one or more data plots (graphical depictions of datasets). Note that
the graph in the image above contains three graph layers, represented by the three non-printing layer
icons in the upper-left corner of the graph page. Note that there is one layer icon which is highlighted,
indicating that this is the active layer.
• Just as there is only one active layer, there is only one active plot in a graph. Usually, the active plot is
the first plot in the active layer. To verify which plot is active, click on the Data menu while the graph is
active. The active plot will have a check mark beside it.
166
Graphing
The hierarchical structure of the graph page can be seen in these places:
The Plot Setup dialog box is a flexible all-in-one plotting tool for creating graphs and manipulating the data
plots in an existing graph.
• Creating graphs from a combination of data sources: multiple worksheets, workbooks, matrixbooks, loose
datasets, etc.
167
UserGuide_2022b
To create a graph with the Plot Setup dialog, make sure no data is selected in the active worksheet and
choose the plot type that you want to create (from the Plot menu or by clicking on a toolbar button).
To open the Plot Setup dialog for an existing graph window, right-click on any layer icon in the upper left
corner of the graph window and select Plot Setup..., or choose menu Graph: Plot Setup....
Tutorial: Creating a Simple Line Plot with the Plot Setup Dialog Box
168
Graphing
8. Press CTRL and click on each plot in the bottom panel to select all three, then right-click
and choose Group.
9. Click OK to create a grouped line plot.
169
UserGuide_2022b
• The Plot Setup middle panel only allows choosing one X column at a time.
• If your worksheet is set up with the correct Column Plot Designations (e.g. XYXY) but you only want
columns with same Long Name, click the toggle in the upper-right corner of middle panel so that only
plottable columns show (e.g. for 2D plot types, X columns are not shown). Then you can sort the columns
and select all columns with same Long Name and plot them together. The Y columns will be plotted
against corresponding X columns.
• To change a data plot's type, choose the corresponding plot in bottom panel. Corresponding X and Y
columns will show in middle panel. Choose a new plot type in middle panel and click the Replace button.
• All data plots in a group share the same plot type. If you want to change the plot type of a single plot in a
group, right-click the Group node in bottom panel and Ungroup first.
• Drag and drop data plots in the bottom panel to move them to different layers.
• If the bottom panel is hidden and you have selected columns in the middle panel, you can directly click
the OK button to create your graph.
170
Graphing
plot customizations, including those involving such things as changing plot symbols, colors, and legend
customizations, see the Customizing Graphs chapter.
Some Origin plot types (e.g. scatter, line, line+symbol) allow you to interchange the plot type of an existing
plot with a few other select plot types. Some examples:
• Right-click on the data plot and choose Change Plot to: Graph Type from the shortcut menu.
• Click on the data plot and choose Format: Plot... and in Plot Details choose from the Plot Type drop-
down list.
• Click on the data plot, then click one of the supported graph toolbar buttons.
Note that if you switch plot types and the selected plot is part of a plot group, all plots in the group are
switched.
A word of caution: This is an old Origin feature, and for a quick change of common plot
types in a single-layer graph it works well. Changing plot types in a multi-panel, multi-
layer graph can lead to unwanted outcomes. When working with more complex graphs,
it is better to create a graph directly using the specified Plot menu command or toolbar
button .
You can quickly change the data source (X, Y, or worksheet) of a plot using these context menu commands.
Right-click on a data plot, then select one of these options:
• Change X/Y/Z. These menu items allow you to swap the current X,Y or Z data with data from any column
in the project.
• Select Columns. This opens the Column Browser where you can select another column in the Current
Folder, in the Current Folder (recursive) (includes subfolders) or in Current Project.
• Change Worksheet. This menu item allows you to replace both X and Y with data from another
worksheet. The selected worksheet must have the same Short Names, the same Column Plot Designations
and the same row index range as the current worksheet.
1. Start with a new workbook and import the file automobile.dat from the
Samples\Statistics sub-folder of the Origin installation folder.
171
UserGuide_2022b
2. Select the Gas Mileage column and select the Plot: Basic 2D: Scatter menu
item. The Gas Mileage column is plotted against the default X column Year.
3. Right-click on the data plot and select Change X: Engine Displacement. The
Gas Mileage column is now plotted against Engine Displacement.
Note: If new data is significantly outside of the current range for X or Y axes, you will be asked if the
graph should be rescaled. If data are not significantly different, you may want to manually rescale the
graph (Hot key: CTRL+R).
If you have performed some analysis on the data plot (e.g. linear regression with
Recalculate set to Auto), the fit results will automatically update when you change
X/Y or the worksheet.
Use the following methods to add or remove data plots from a graph.
You can add data to a graph by drag and drop. When using this method, Origin relies on worksheet Column
Plot Designations to create the plot.
1. Select the worksheet data (one or more columns or a range of one or more columns).
2. Move the mouse over the left or right edge of the selected range.
3. When the pointer looks like this , hold down the left mouse button and drag the data to the graph
window. Release the mouse.
4. If there are multiple layers in the graph, drag the data to the desired layer, then release the mouse.
Usually the current plot type is used when plotting by drag-and-drop. To change the
global plot type to use when drag and drop, choose Preferences: Options... from the
main menu. Go to the Graph tab and change the Drag and drop plot type.
Use the Insert menu to insert some types of plots to the active graph layer. Choice of plot type depends on
the active graph window and the last-activated data source (worksheet or matrix). For instance, if you create a
2D graph, select data in a workbook window, then return to graph window and click Insert: Plot to Layer,
your insert choices will be Line, Scatter, Line + Symbol, Column..., Area and Contour....
To use the Insert menu command, you should have an existing graph window:
172
Graphing
2. Return to the graph window, make sure that the target layer is active layer, then choose Insert: Plot to
Layer: Plot Type.
11.3.3.3 Adding and Removing Data with the Layer Contents Dialog Box
Open the Layer Contents dialog box by double-clicking or right-clicking on the layer icon(s) in the top left
corner of the graph page. Controls in the left panel can be used to filter and list available datasets. The right
panel lists datasets that are plotted in the active layer.
Controls in the center of the dialog box allow you to add or remove plots from the active graph layer. When
adding data to the graph, click the list button (downward-pointing arrow) to pre-select the plot type before
adding data to the layer. Use controls in the right panel to group or ungroup plots, or re-order plots in the
layer.
In Origin 2022b, a new LabTalk system variable @SCCS modifies Layer Contents
sort behavior: @SCCS = 0 (default) sorts as Book1 > Book2 > Book10; @SCCS = 1
sorts as Book1 > Book10 > Book2.
11.3.3.4 Adding, Removing, Replacing or Hiding Data Plots with the Plot Setup Dialog Box
Among other things, the Plot Setup dialog box can be used to add or remove data plots from the graph.
1. To add plots to the graph, use the top panel of Plot Setup to identify your source data.
2. Use the controls in the middle panel to specify the plot type and how the data selection should be treated
(as X, Y, yError or Label).
3. In the bottom panel, choose the Layer to which you want to add plots, then click the Add button.
173
UserGuide_2022b
4. To remove a plot from the layer, select the plot in the bottom panel, then right-click and choose Remove.
5. To hide a plot, uncheck the Show check box for the plot.
6. To replace a plot, select the plot in bottom panel, then change the X and Y selection and plot type in
middle panel and click the Replace button.
You can import ASCII files directly into the active graph window using the the Import ASCII toolbar button.
Note that this method works only with files having a simple structure and it supports only the simplest of
graph types - Line, Scatter, Line + Symbol, Column and Bar charts.
1. Click the Import ASCII button. This opens the Import ASCII dialog box.
2. Choose a file.
3. Click Open.
With many Basic 2D graphs (e.g. Scatter, Line, Line + Symbol, Bubble, etc.), you can copy a plot from an
existing graph layer and paste it to another layer in the same window or into a separate graph window. Prior to
Origin 2020, this would only produce a black line plot. Origin 2020 expanded copy-paste of plots to other plot
types, while preserving plot properties (symbol size, color, etc.).
You can also copy a plot by selecting the plot in the graph and clicking on the Copy Plot button on the Mini
Toolbar.
174
Graphing
Previous versions also allowed you to select and copy a simple plot (Line, Scatter, Line
+ Symbol, 2D Column/Bar) and paste underlying data into a worksheet. The default
settings no longer support this but you can reverse this by setting LabTalk system
variable @CPNP=1.
The Object Manager is a dockable panel that allows for easy manipulation of graph layers and data plots.
See the section on The Object Manager in this Guide.
To hide or remove plots, right-click on a plot and choose from the shortcut menu:
• Remove a plot from the graph window (hidden plots can be quickly shown again; removed plots must be
added back using one of the above methods).
• If the plot is part of a group, you can right-click on an individual plot and remove just that plot or you can
right-click on the group icon and remove the entire plot group.
175
UserGuide_2022b
• When you right-click on a plot, you can use Hide Plots with Same Name and Hide All Plots shortcut
menu items to quickly hide selected plots in the window without removing them entirely (restore plots by
enabling their display in the Object Manager or in Plot Details).
In the left panel of the Plot Details dialog box (Format: Plot...), right-click on a plot and choose Remove or
Hide from the context menu. Remove will delete the data plot from the graph so if you just want to
temporarily hide a plot, choose Hide. Neither of them will delete data from worksheet or matrix.
Click on a data plot (either in the graph window or Object Manager) and press the Delete key. If the selected
plot is part of a group, the entire group is deleted.
Note that this is more sweeping than the Remove shortcut menu command in that it will remove an entire
plot group from the graph window. This action does not delete worksheet or matrix data.
To restore the deleted plots, choose Edit: Undo Remove Plot from the main menu.
Once a graph is made, you can edit the plot display range, specifying only a portion of the plotted data:
• Right-click on the plot and choose the Edit Range... shortcut menu command. Edit the From and To
values.
• In the right panel of the Layer Contents dialog box (Graph: Layer Contents), turn on the Range column
by right-clicking on the column headings and choosing Range. Click on a plot's range values, then click
the ... button that appears to the right side of that column.
• In the bottom panel of Plot Setup (Graph: Plot Setup), click on the plot range in the Range column and
click the ... button that appears to the right side of that column.
Choose Graph: Rescale to Show All to rescale the graph after editing the plot range.
176
Graphing
When you make multiple range or column selections, then create a graph, Origin groups the resulting data
plots in the graph layer. This applies to most 1D (statistical) and 2D graphs, plus 3D XYY (XYY 3D bar, 3D
ribbon, 3D wall, and 3D waterfall plots) and 3D XYZ (3D scatter, 3D bar) graphs.
Grouping provides for quick creation of presentation-ready graphs because each plot in the group is assigned a
differentiating set of plot attributes (line color = black, red, green...; symbol shape = square, circle, triangle...;
etc.). Assignments are made by cycling through a pre-determined (user-modifiable) increment list of styles.
For instance, the first plot of a grouped line plots might be denoted by a black line; the second plot might be
denoted by a red line (the second color in the color list), the third plot by a green line (the third color in the
color list), and so on.
1. Open a fresh worksheet and click the Import Single ASCII button on the
Standard toolbar.
2. Browse to the Samples\Graphing subfolder in the Origin software folder and Open
GROUP.DAT.
3. Select B(Y), C(Y), and D(Y) columns
4. Click the Line & Symbol button on the 2D Graphs toolbar. Note that line and
symbol color and symbol type are automatically differentiated for each plot.
1. To open the Layer Contents dialog box, double-click on the layer n icon in
upper-left corner of the graph window.
2. To create a group, select the desired data sets from the Layer Contents list (use
CTRL + select, SHIFT + select, or simply drag the mouse to select multiple data
sets).
3. Click Group. Note that each plot in Layer Contents is now preceded by a gn (for
"group1", "group2", etc.).
4. To ungroup, click on one of the grouped data plots in the Layer Contents list and
click Ungroup.
1. To open the Plot Setup dialog box, ALT + double-click on the layer n icon in
upper-left corner of the graph window.
2. To create a group, select the desired plots from the Plot List (use the CTRL or
SHIFT keys to select multiple data sets).
3. Right-click and select Group. Note that a Group icon now precedes the selected
177
UserGuide_2022b
11.3.5Speed Mode
With Speed Mode, you can control the number of data points displayed in a graph layer. This option is most
used when working with large data sets, though note that there have been improvements in this area and
Origin now has Density Dots and Color Dots graph templates specifically for creating scatter plots of large
datasets.
Speed Mode can be turned on for any 2D or 3D graph. When Speed Mode is enabled, the layer icon displays in
red and a Speed Mode is On banner appears in the layer. The banner is not included when printing, copying,
or exporting the graph.
1. With your graph active, select Format: Layer... from the Origin menu.
2. Select the Display/Speed tab.
3. For plots created from worksheet data, Select the Worksheet Data, Maximum Points Per Curve check
box to enable Speed Mode for all the data plots in the layer that are created from worksheet data. Type
the desired value (n) in the associated text box. If the number of data points in a data plot exceeds n,
Origin displays a subset of the data plot containing n points, drawn by extracting values at regular
intervals from the data set.
4. For 3D data plots created from a matrix or for contour data in the layer, Select the Matrix Data,
Maximum Points Per Dimension check box to enable Speed Mode. Type the desired value (n, m) in the
X and Y text boxes. If the number of data points in a data plot exceeds n or m, Origin displays a subset of
178
Graphing
the data plot composed of -- at maximum -- n by m points. This subset is drawn by extracting values at
regular intervals from the matrix columns (X) and rows (Y).
For broad control, you can select Speed Mode from the Graph menu. This opens the speedmode X-Function
dialog. The dialog lets you specify which windows the settings should apply to ( Target ) and also, offers
several levels of data plot thinning from Off to High, plus Custom.
Click the Enable/Disable Speed Mode button on the Graph toolbar, to toggle
Speed Mode on/off for all layers in the graph window.
Origin 2022b adds a page-level Mini Toolbar button to toggle the Speed Mode Banner
at the individual graph level.
• Skip Points and Speed Mode plot the last data point, by default, but this is controlled by system
variable @SMEP.
• The Speed Mode controls on the Display/Speed tab of the layer's Plot Details only apply to what you see
on screen. They do not apply to graphs that are printed or exported, by default.
179
UserGuide_2022b
• If you wish to skip points in printouts, use controls in the Print dialog. See the discussion of the Skip
Points feature as it applies to some graph windows in the Origin Help file.
• If you wish to apply Speed Mode settings to graphic export, please see this discussion of Performance
Group controls on the Miscellaneous tab of the Plot Details dialog box or use controls under the Export
Settings node in the Graph Export dialog.
• Speed Mode settings are saved with the graph template. If you make changes to Speed Mode settings for
a particular graph type, you will have to resave the graph template to make those changes permanent.
• Always exercise judgement when using Speed Mode. Since Speed Mode systematically weeds out a
portion of your data points, any graph in which Speed Mode is turned on, may -- or may not -- accurately
represent your data, to your satisfaction. Always familiarize yourself with your data and adjust and
compare Speed Mode settings to ensure that trends in your data are accurately depicted.
11.4 Publishing Your Graph: Copy/Paste, Image Export, Slide Shows and
Printing
There are a number of ways to present your finished graph.
• Copy a graph page and paste it in other applications such as Word, Powerpoint, etc.
• Printout.
• Create Movies.
Please read details in the Publishing and Export chapter of this User Guide and the "Topics for Further Reading"
there.
Origin Graph Samples of most 2D and 3D graph types are included with your Origin
software. To view graphs, supporting data and guidelines for making the graphs,
choose Help: Learning Center(F11).
The tables below list all Origin graph types, grouped by Plot menu category:
180
Graphing
• The Plot menu icon for each graph type precedes the graph name.
• The Notes column provides basic information on data requirements. For more specific data
requirements, click on the graph name beside the Plot menu icon.
You can modify the size of the Plot menu icons using the LabTalk system variable
@PPS. To find out how to change the value of a system variable, see Customizing
Origin Using System Variables.
181
UserGuide_2022b
11.5.1.1 Basic 2D
Scatter
Scatter Central
Column Scatter
Scatter + Rug
Bubble
Color Mapped
182
Graphing
Before and After Graph • For Line Series graph, select 2 or 3 Y columns.
183
UserGuide_2022b
Column
Floating Bar
Kite Diagram
184
Graphing
Pie Map
Bar Map
Fill 2 Colors
185
UserGuide_2022b
11.5.1.3 Multi-Panel/Axis
Multiple Y Axes...
Vertical 2 Panel
• Start with a Worksheet.
Horizontal 2 Panel • Select one Y column (or range) per panel.
Multiple Panels by
Label...
186
Graphing
187
UserGuide_2022b
11.5.1.4 Statistical
Bar
Overlap
Bar
Normal
Scatter
Interval
Marginal
Box Charts
Beeswar
m Plot
188
Graphing
Histogra
m
Histogra
m + Rug
Histogra
m + Probabilities
Multi-
Panel Histograms
Distributi
on
• Start with a Worksheet.
Distributi • Select at least one Y column or a range from at least one Y column.
on + Rug
• For specific data requirements, follow links in the Graph Types column.
Histogra
m with Labels
Stacked
Histograms
Populatio
n Pyramid
Marginal
Histograms
Marginal
Plots (Grouped
Marginal
Histogram)
Scatter • For specific data requirements, follow the link in the Graph Types
Matrix column.
189
UserGuide_2022b
Violin
Plot
Violin
with Box
Violin column.
with Quartile
• For data requirements and other information on plot variations, see
Violin Plot.
Violin
with Stick
For data requirements and other information on Ridgeline Charts, follow the
link in the Graph Types column.
Split Plot
Half
Violin
Ridgeline
Chart
Pareto column.
Chart - Raw Data
QC (X-bar • For specific data requirements, follow the link in the Graph Types
R) Chart column.
190
Graphing
Bridge
Chart
• Start with a Worksheet.
Stacked • Select one or more Y columns (or a range of one or more Y columns). If
Bridge Chart
there is an X column to the left of the Y column(s), this X column is
treated as categorical data; otherwise, the worksheet's row indices will
Stacked
Total Bridge be used.
Chart
• Origin Bridge Charts are variants of one basic chart type. For more
information, see Bridge Charts.
Horiz-
Bridge Chart
Double Y
Box
Bland- • Select two Method columns and one Subject column (optional).
Altman Plot
11.5.1.5 Contour
Contour - Categorical Z
191
UserGuide_2022b
192
Graphing
11.5.1.6 Specialized
193
UserGuide_2022b
Ternary
Ternary, Line+Symbol
Piper
Origin 2022b New Graph
Type: Right-Triangle
Stiff Ternary
Stiff Map
Schoeller
Durov
194
Graphing
Bar theta, r
• Start with a Worksheet.
Symbol r, theta
195
UserGuide_2022b
High-Low-Close
OHLC-Volume
Line
196
Graphing
11.5.1.7 Categorical
197
UserGuide_2022b
198
Graphing
Alluvial Diagrams
199
UserGuide_2022b
Sunburst Plot
200
Graphing
11.5.1.8 3D
3D Scatter
3D Line
3D Trajectory
3D Bar Graph
• Start with a Worksheet (XYZ) or a Virtual
Matrix or Matrix of Z values.
3D Stacked Bars Graph • For specific data requirements, follow links in the
Graph Types column.
201
UserGuide_2022b
Wire Frame
Wire Surface
202
Graphing
203
UserGuide_2022b
For an overview of Origin's 3D graph types and their source data requirements, see these topics:
• Creating 3D Graphs
Browser graphs are useful for selectively plotting data from worksheets containing many columns (and rows),
into a single graph layer:
• Specify automatic rescale and/or common display range for all plots.
204
Graphing
The page-level Mini Toolbar includes an Add Browser button so that you can add a
Browser panel to a regular 2D line plot.
Stack
205
UserGuide_2022b
11.5.1.11 My Templates
App Notes
• Graph Axes
206
Graphing
• Graph Layers
• Linking Layers
• Batch Plotting
207
12 Customizing Graphs
12.1 Introduction
This chapter introduces you to various aspects of graph customization. All Origin graphs start from a graph
template. If the graph you are making is fairly standard for its type, the options that were stored in the graph
template may be entirely adequate to produce a polished-looking graph. The business of basic graph creation
was covered in the last chapter, Graphing.
Sooner or later, however, you are going to want to add annotations, modify axis scales, or change plot colors.
Hence, the purpose of this chapter is to introduce you to some key Origin graph customization tools and
techniques, as well as to point you toward resources that will help you manage more complex graph
customization tasks.
We begin with a discussion of the graph customization-related toolbars, as these toolbars have tools that are
commonly used for quick modifications of graph elements.
209
UserGuide_2022b
Toolbar
Description
(default configuration)
• Creating and
customizing text
objects.
210
Customizing Graphs
Toolbar
Description
(default configuration)
• Add legends/color
scales/bubble scales;
date & time and
project path stamps;
XY scale; table
objects.
211
UserGuide_2022b
212
Customizing Graphs
213
UserGuide_2022b
Most Origin graphs support a set of "quick editing" tools for interactively modifying common graph object
properties. Tools are context-sensitive so that -- (1) depending on where you click inside the graph window, (2)
what the selected object is and (3) whether you have selected an individual plot or a plot group -- you will
have a different set of tools available to edit your selection.
214
Customizing Graphs
• There are five levels -- i.e. five groupings of graph properties -- that can be edited with Mini Toolbars:
page, layer, plot, text or drawn objects and graph axes.
• When editing grouped plots, a single click will select a single plot. The Mini Toolbar displays two tabs --
one for the customizing the group, the other for customizing the single plot.
• Most Mini Toolbars have a "properties" button that opens a related Origin dialog box where you will
find the full range of available controls.
Unless you have changed your selection, you can do a one-time restore of a Mini
Toolbar after it has faded by pressing the SHIFT key.
Prior to Origin 2022b, the View: Mini Toolbars setting was not remembered across
sessions (i.e. if turned off in the current session, they would be restored on Origin
restart). Now, this setting is remembered across sessions (alternately, you can control
Mini Toolbar display by setting system variable @DMT (ON=0; OFF=1)).
Some Mini Toolbar buttons will increase or decrease some property by some increment, each time you click
the button (e.g. font size, rotation angle, layer grid spacing). In such cases, you can modify that increment by
manipulating the value of a LabTalk system variable.
For information on these LabTalk system variables, see this Appendix in Origin Help.
The Object Manager is general tool for managing Origin windows but it is especially useful for manipulating
graph windows. When a graph window is active, the Object Manager offers alternate views -- toggled by right-
215
UserGuide_2022b
clicking in an empty portion of the Object Manager and choosing Show Plots or Show Graph
Objects(Ctrl+Shift+S):
• Show Plots: a collapsible, hierarchical list of plots by layer, plot group, etc.
• Show Graph Objects: a collapsible, hierarchical list of window objects (legends, text objects, images,
etc.) by layer.
• Whether in Show Plots or Show Graph Objects view, right-clicking on an element will open a shortcut
menu of relevant actions (ungrouping a set of plots or designating a plot as the first plot in a plot group,
for instance).
• Common to both views is a check box beside each element; when checked, the element displays in the
graph window, when cleared, the element is hidden.
• Additional shortcuts give quick access to source data, to Plot Details, allow you to rearrange plot or object
order and to other relevant tasks such as opening an inserted image in an Image window for further
editing.
When a graph is active and you select graph elements in the Object Manager, a Mini Toolbar will show (make
sure the Mini Toolbars option is checked in the Show Plots/Show Graph Objects shortcut menu as shown
in the image above).
With the available buttons, you can make quick customizations to common plot properties such as line color,
line thickness, display of labels, etc.
New in Origin 2022b: In Object Manager Show Graph Objects view, a new Select
All with Same Name shortcut menu entry. Use in combination with Mini Toolbar
buttons (e.g. Font Size) to make quick graph changes.
Quick formatting of many plot properties can be done using Mini Toolbar or dockable toolbar buttons, as
mentioned above. However, more comprehensive access to plot properties is available from each graph's Plot
Details dialog box.
216
Customizing Graphs
• Click the Format menu, then choose Page..., Layer... or Plot..., to open Plot Details at the
corresponding level.
The figure below shows an example of the Plot Details dialog box:
• The left panel depicts the Page > Layer > Plot hierarchy as an expandable/collapsible tree.
• The right panel contains controls, organized by tabs, that pertain to the object that is currently selected in
the left panel.
• To customize an object, select it in left panel and modify the corresponding properties that appear on
the various tabs in the right panel.
Settings that pertain to the whole page -- Print/Dimensions, layer drawing orders,
Page
page display color, legends/titles, etc.
217
UserGuide_2022b
Settings that are specific to the graph layer -- Layer background colors, layer size
Layer and speed mode settings, layer display settings, stack settings for applicable plot
types. Some plot types will include extra tabs/controls specific to the plot type.
Plot-specific properties. The tabs and controls vary by plot type (e.g. Scatter plots
have a Symbol tab with controls pertaining to scatter symbols, Line plots a Line tab
Plot
with controls pertaining to line plots). Anything to do with a particular data plot --
color, fill patterns, colormapping, labeling -- will be found at this level in Plot Details.
Properties that apply to user-specified "special points". Available for any plot for
which plots discrete points (scatter, line + symbol, column/bar, etc.). The tabs and
Data Point
controls are generally similar to those available at the Plot level but any property that
you set at the level of a special point, will apply only to that point.
218
Customizing Graphs
Prevent text and label objects from scaling when resizing layer, by going to the Size
tab of Plot Details (Layer level) and setting Fixed Factor to 1.
Beginning with Origin 2020, there was a change in selection behavior that affects
grouped plots. Now, a single-click on a plot selects the plot. A second click (or
CTRL+click) selects a single point. SHIFT+click selects the entire group. Note that when
using the new mini toolbars, a single click on a plot group displays tools for editing the
plot group or the single, selected plot. To revert to the old plot selection behavior, set
@GSM=0.
When you select and plot multiple data ranges to a single graph layer, the plots are grouped in the layer.
Generally speaking, plots within a group are automatically differentiated by assigning styles built from one or
more customizable "increment lists", one for each plot property (symbol shape, symbol color, line style, etc.).
By default, some properties are configured to increment "by one" (e.g. line color is assigned according to the
"Candy" color list and each successive plot is assigned the next color in the list) and some will be configured
not to increment (e.g. line style is solid for every plot), though this is ultimately controlled by the user. In any
case, the increment lists for each property are saved with the graph template (.oggu) or Theme file (.oth) so
that you can easily use them later to create graphs with the same look.
219
UserGuide_2022b
The above image shows the Plot Details Group tab settings for a line + symbol plot in the upper-left. On this
Group tab, the first column lists Line Color, Symbol Type, Line Style Symbol Edge Color and Symbol
Interior. Properties of Line Color, Symbol Type and Symbol Edge Color are set to increment By One and
Between Subgroups (subgrouping occurs using the column Comments), while Line Style and Symbol
Interior are set to increment by None (they do not vary).
As previously mentioned, this arrangement is completely customizable and you can save customizations with
the graph template:
• To find out more about customizing of grouped and subgrouped plots, see The Plot Details Group Tab
Controls.
• To find out more about saving graphs as templates, see Graph Template Basics.
• To highlight a single plot and dim others (grouped or ungrouped) in the layer, click once on the plot in
Object Manager. Conversely, clicking once on a plot in the Object Manager, highlights the plot in the graph
window, while dimming others.
• To reorder plots in the layer, drag a plot icon within the group; or right-click on the plot (in Object
Manager) and choose Move Up or Move Down.
• To group or ungroup data plots in the layer, right-click on the group icon ("gN") and choose Ungroup. To
group plots in the layer, right-click on a plot and choose Set as Group Begin.
220
Customizing Graphs
• To move a plot from one group to another, drag the plot to the other group.
• To move a series of plots out of the group, right-click the last plot that you want to keep in the group and
choose Set as Group End.
• To remove a plot from the layer (and the graph), right-click on the plot and choose Remove.
• To move a plot to a second Y axis, or move the plot to another layer, right-click on the plot in Object
Manager and choose Move Plot to Second Y Axis or Move Plot(s) to Other Layer ....
The graph layer is a fundamental concept in Origin and it is a primary building-block of most complex Origin
graphs (e.g. a graph with both left and right Y axes is constructed by overlaying one layer on another, and
sharing a common X axis between the two layers). While the graph layer is, fundamentally, a self-contained
unit it is, at times, desirable to create dependencies between layers:
• One type of dependency is what we call "linking" of layers, which involves establishing spatial relationships
or relationships between axis scale values. You can read more about linking graph layers, below.
• Another type of dependency is based on what we call "common display" and this is most useful in a
situation where we have multiple similar panels in a graph and we want to do something like change the
background color of each graph, or perhaps the change plot colors used in each layer.
For Origin 2022b, a new Add Label for Layers button is added to the page-level Mini
Toolbar (hint: click outside of graph layers to show).
At the graph page level in Plot Details, you will find a Layers tab that has controls that affect all layers within
a given graph page. The Common Display controls can be used to enable simultaneous editing of layer, plot
and axis properties of multi-layer graphs. For instance, in the following example, we have a two-layer trellis
plot -- the two layers being necessitated by there being a left-Y axis and a right-Y axis with two completely
different scales -- and as a simple illustration, we have used the Common Display controls to simultaneously
add a background color to both layers. We could have accomplished the same thing without using the Common
Display controls but this would have required twice the work -- set the background color of layer 1, then set
the background color of layer 2.
221
UserGuide_2022b
This was a simple illustration but we can use the Common Display controls for application of more complex mix
of layer, plot and axis properties. Some of Origin's built-in multi-layer graph templates have Common Display
elements turned on by default. When working with multi-panel graphs, you may want to choose Format:
Page, click the Layers tab in Plot Details, and check the Common Display settings. See Common Display
for more information.
The Common Display Apply to control supports including or excluding certain layers
from common display customizations. For instance, you might have a 4 panel graph,
each with an inset layer and using this control, you could apply a common background
color to the inset layers without applying the same background color to the 4 primary
layers (panels). See Common Display for more information.
You can customize line style within a single data plot (e.g. between data points in a line
+ symbol plot). For Origin 2022b, you can assign line style according to a custom
increment list.
1. Double-click on the plot to open Plot Details, then click the Line tab.
2. Set Style = Increment, adding a Line Style List tab.
3. Enable custom increment list and customize the list as needed.
222
Customizing Graphs
For some plot types such as scatter, column or pie, you can modify the display properties of a single data point.
1. Click twice (slowly) or press CTRL + click on a data point to select it. Use the Mini Toolbars to edit
properties of the data point; or click available buttons on the Style or Format toolbars.
2. For access to a wider range of customization options, (a) double-click on the selected point or (b) CTRL +
double-click on an unselected data point. This opens the Plot Details dialog box with the focus set to edit
the data point (identified in the left-panel of Plot Details by its row index number). Then use controls on
the tabs in the right panel to modify the appearance of the data point, add drop lines, data label, etc.
Changes you make to the special point will not affect the appearance of other points in the same plot.
223
UserGuide_2022b
Note:: When the Custom Construction box is checked, you can use these controls to customize the
plot symbol of the selected point. Custom Construction can be applied to any plot symbol -- not
simply those that are designated as special points.
Origin supports adding your own plot symbols. For more information, see User
Defined Symbols Grid.
• Right-click the single point in the left panel of the Plot Details dialog and choose Delete.
• In the graph window, click on the single point to select it, then press DELETE on the keyboard.
The point itself is not deleted; only the custom style is removed, with the point reverting to the style of the
containing data plot.
Adding a special point at the beginning or end of a plot is not always easy, but there is a
simple, foolproof technique:
1. Select a special point anywhere on the plot, then double-click on the point to open Plot
Details.
2. In the left-hand panel of Plot Details, click once on on the point index number and
wait until the index number becomes editable.
224
Customizing Graphs
3. To add the special point to the first point in the plot, type Begin; to add to the last
point type End. If you know the index number of the first or last point, you can type
that instead.
4. Click outside the edit box. Make other special point customizations as needed, the click
Apply or click OK to close Plot Details. The special point will be added to the beginning
or end of your plot.
For more complex edits of axis properties, open the Axis Dialog:
For quick adjustments to axis properties, you can use Origin's axis Mini Toolbars. As with all Mini Toolbars,
available tools will vary by plot type and selected object. For instance, note that clicking on a graph axis line
brings up a different set of buttons than clicking on the axis tick labels.
225
UserGuide_2022b
Note that clicking the "gear" button on the axis line Mini Toolbar produces a popup menu with simplified "Mini
Dialogs" for axis line elements. For access to all axis settings, click Axes Dialog on either toolbar.
All graph axis customizations can be made in the Axes Dialog box. Click on the Mini Toolbar "gear" button
and choose Axes Dialog; or double-click on the graph axis or tick labels. This will open the Axis Dialog -
Layer N dialog box.
This image shows the tab-based axis dialog used by most 2D and 3D graphs.
In the left panel, you can select one or more icons (hold the CTRL key to select multiple icons) to specify the
axis or axes to be customized, then select the desired tab and choose your options.
226
Customizing Graphs
Scale range of values, scale type, rescale mode and margin, reverse scale, major and
Scale
minor ticks.
Display and Format options for major and minor tick labels, including custom labeling using
LabTalk substitution or mathematical expression. For information on custom formatting of
numeric data including display of percentages, fractions, pi, and geographic (Lat/Lon)
formats, see Origin Custom Formats.
Axis title (often set using variable notation) and font options. Note that you can directly edit
Title
by double-clicking the text object in the graph.
Grids Control display and properties of grid lines at major and minor ticks.
Line and
Global axis line and tick display options for all axes.
Ticks
Special
Placement of special tick labels.
Ticks
Reference lines are optional lines that you add to your graph, either for emphasis or to
mark some key statistic. Additionally, they can be paired to add fill color to some portion of
your graph (e.g. "recession bars" in plots of financial data).
Reference
Lines
You can use named ranges to place Reference Lines on a
graph.
227
UserGuide_2022b
Click the Apply To... button to apply the axis format settings of the currently selected
axis to another axis.
Origin 2022b supports wrapping of tick labels for languages which typically do not use
space between characters (e.g. Japanese or Chinese). Controls are found at Format:
Axes > Tick Labels > Format > Wrap Text.
Note: For more information on axis customization and for axis controls for specialized graph types (e.g.
polar, ternary, radar chart.etc), refer to:
12.7.1Color Manager
Use the Color Manager for importing, creating and organizing the color lists and palettes that you use in
Origin:
228
Customizing Graphs
The following list numbers correspond to controls shown in the image above:
on the Style toolbar and from the Mini Toolbar Fill Color button when a plot or special point is
selected.
6. Use the list control to set Category = Undefined, Sequential, Diverging or Qualitative.
7. Use these controls to add or remove color lists and palettes from the user-interface (GUI).
8. Use these controls to move a selected list or palette up or down in the various GUI color lists.
9. Click Set Default Plot Colors to open the Theme Organizer's System Increment Lists tab, where you
can set default colors for use in your plots.
10. Drag list-number icons to rearrange GUI color list order.
There are many options for applying color to your graphs. We will try and cover the basics here, pointing you
to other resources for more in-depth discussion.
• The Plot Details Color Map/Contours Tab Controls for 3D and Contour Plots
Picking and applying a single custom color has been made easier with the addition of
the "eyedropper" tool to the Single tab of the Color Chooser. Previously, the
eyedropper tool was buried in the Build Colors dialog.
Applying colors singly simply means applying a single color to a plot as opposed to applying color from a color
list to a series of plots. It is the most basic way to apply color to a single plot or special point. Simply select a
color well from anywhere on the Single tab -- from the LabTalk colors at the top, from a selected color list, or
from a custom or recently used color.
229
UserGuide_2022b
• Select a plot (e.g. scatter plot) and click the Fill Color button on the Mini Toolbar that appears.
• Select a plot and click the Fill Color button on the Style toolbar.
• Double-click on a plot to open the Plot Details dialog box where you can click on a tab to the right side
(e.g. Symbol tab for a scatter plot) and set color for the element.
• To create a special point -- i.e. to assign special characteristics to one data point in your plot -- press
Ctrl+click to select the point, then use the Mini Toolbar, Style toolbar or Plot Details controls to
customize color for that point.
Applying colors By Points generally means applying a color to each point in a plot by one of several schemes.
The simplest involves picking an Increment From color from a predefined color list and assigning colors, in
sequence, to each point in the plot.
230
Customizing Graphs
As in the case of applying a single color, you can apply these settings using controls in Plot Details; or by
selecting the plot and using the Fill Color buttons on the floating Mini Toolbar or Style toolbar docked to the
top of your workspace.
Other schemes typically make use of a column of values to assign color to points:
• Indexing assigns point color by associating an integer or text string (categorical value) to different colors
in a list.
• Direct RGB assigns color using a value derived from columns of RGB values.
• Color Mapping -- used for 2D, Contour and 3D plots -- assigns colors in a list or palette, to values across
the range of the plot's Y or Z values.
There are several other schemes which are specific to a certain plot type (or family of plots), but the list above
covers most of what you will use. For more information see Using a Dataset to Control Plot Color.
You apply color By Plots when you want to assign differentiating colors to a series of plots. Typically, this
series of plots comprises a "plot group." In a plot group, plot attributes including color, are assigned to each
plot by incrementing through a style list -- color, line-style, symbol shape, etc.
231
UserGuide_2022b
While you can use a color list with a contour or 3D plot, it is probably more common that you will use a color
palette. This allows a wider range of color variation and can add realism to to 3D surfaces and 3D function
plots.
You can add new color palettes to Origin by drag-and-drop. Support for Scribus (.xml),
Office Color Table (.soc), Adobe Color (.aco), Adobe Color Table (.act), Adobe Swatch
Exchange (.ase) and JASC PaintShopPro (.pal).
Colormapping can also be applied to 2D plots. This allows you apply a greater range of color variation to data
points than would be possible with incrementing or indexing. A good example of applying a color map to a
scatter plot would be Origin's Density Dots plot in which, typically, thousands of scatter points are plotted
and an algorithm is used to calculate point density and assign color to ranges of point densities.
232
Customizing Graphs
Applying a colormap to a 3D or contour plot is much the same as applying color singly, by points or by plots.
You select a plot -- then using the Palette button on the floating Mini Toolbar or the Style toolbar. You pick
a palette.
You can also use the controls on the Colormap/Contours tab of Plot Details. This tab gives many more
options beyond simply picking and applying a colormap.
233
UserGuide_2022b
For more information on applying color to colormapped plots, including contour and 3D surfaces,
see these topics:
• Surface Graph
A graph legend is automatically created when you plot data. For most 2D and some 3D graph templates, the
default legend combines (A) plot style information stored with the graph template, with (B) dataset
information stored in the worksheet column label rows, and places the resulting legend object on the
graph page.
Note that the default legend object is not created with literal text and plot symbols but instead is created from
LabTalk script.
• This allows the legend object to be dynamically linked to plotted data and worksheet metadata, so that
the legend can be updated when data or plot metadata change.
• Because construction of the legend object relies on scripting rather than literal information, you can save
customizations to a graph template and recreate the graph with its accompanying legend object using new
data, as often as is needed.
The legend script relies on "substitution notation" to convert variable values to readable symbols and text. You
can see this notation when you double-click inside of the legend object (as if to edit it).
234
Customizing Graphs
• You control which dataset metadata are used in constructing the default legend text by setting the the
Translation mode of %(1), %(2) list in the Legends/Titles tab of the Plot Details dialog box
(Format: Page...).
• Custom strings can be constructed using LabTalk substitution. Customizations can be saved to the graph
template for repeat use.
Origin has a Fit Layers to Page tool that is useful for arranging a graph and a large,
text-wrapped legend on the page.
The table below lists tasks associated with adding or updating the graph legend, and where to find editing
controls for each legend type. Before proceeding, we should point out that there are two legend refresh modes:
• Updating a legend will preserve any customizations that you might have made to the existing legend,
including size and position adjustments and legend symbol and text customizations.
• Reconstructing a legend will overwrite any customizations. When you add or reconstruct the legend, you
are creating a copy of the legend that is stored in the graph template.
In addition, the graph template stores a Legend Update Mode setting that determines how the legend is
refreshed when adding or removing data plots from the graph. See Controlling Legend Update, below.
• CTRL+L.
Add or reconstruct
legend
235
UserGuide_2022b
• Point-by-point legends.
• Click the Add Color Scale button (Add Object to Graph toolbar).
• When you have multiple color-mapped plots in a single graph window, you
can click on each plot to select it, then add a corresponding color scale.
Available when a color scale object has been added to a graph. To open the Color
Scale Control dialog:
236
Customizing Graphs
Add bubble scale • Click the Add Bubble Scale button in the Add Object to Graph
toolbar.
• Right-click the legend to select Add Bubble Scale from the context
menu.
Available when bubble scale object has been added to a graph. To open the
Bubble Scale Control dialog:
Control bubble
scale • Double-click on the bubble scale object.
The legendupdate dialog box and the Legend/Titles tab at page level of Plot
Details both have an Auto Legend Translation Mode drop-down that determines
which worksheet metadata (e.g. column Long Name, Comments, etc.) is used to
generate the legend text. For a list of Custom options, see Legend Substitution
Notation.
Note: For more information on creating and customizing graph legends, see:
Help: Origin: Origin Help > Graphing > Graph Legends and Color Scales
When a data plot is added or removed from a graph layer, the default behavior is to update the legend. The
Legend/Titles tab at the graph page level in the Plot Details provides a Legend Update Mode drop-down
to control this behavior.
The default setting Update when Adding only affects the legend display of data plots that are added or
removed. Previous legend customizations to existing plots, such as literal text entered manually, will be
maintained.
237
UserGuide_2022b
4. Click on one of the workbooks, select the column B, and create a line plot.
5. Right-click on the legend and select Legend: Update Legend... to open the
legendupdate dialog.
6. Change the Auto Legend Translation Mode drop-down to Custom, and in the
edit box that appears below, enter the string:
@WS, @LD3
and then press OK to close the dialog box. The legend updates, displaying the
sheet name and the third user parameter.
7. Click on the second workbook, select column B, move the mouse over the right-
edge of the column until it changes to , and then drag-and-drop this data
onto the graph to create a 2nd data plot.
8. Repeat the procedure with column B from the third workbook. The graph will now
display three data plots, and the legend will automatically update to display the
identifier for all three plots.
9. Click on each individual curve and use the Style toolbar to set a different line color
for each. The legend will automatically update and display the new line color.
As mentioned, Origin supports these specialized legends for use with specific graph types. These legends can
be customized and updated similarly to the Data Plot legend used by most 2D graph types.
238
Customizing Graphs
Origin 2022b adds support for quick editing of multiple legend objects on the same
page using Mini Toolbars:
• In the graph window, press Ctrl and select multiple objects. Release Ctrl to display
the Mini Toolbar.
• Additionally, when the graph window is active, go to Object Manager and right-click
on a legend object and choose Select All with Same Name to display the Mini
Toolbar.
Many edits to the graph legend can be made from the legend's Mini Toolbars. The default legend for 2D graphs
has two Mini Toolbars:
• The Legend toolbar -- available when you select the legend object -- has general controls for font, legend
reconstruction, reversing order, etc. Click on the legend object to produce the blue selection handles.
You also gain quick access to more complex controls such as Data Plot Legend Translation Mode --
identifying the column label row metadata that you wish to use to create your graph legend.
239
UserGuide_2022b
• The Legend Symbol toolbar becomes available when you click on a legend symbol. Use it to change
symbol or pattern block height and width, line thickness, etc.
In addition to the Mini Toolbar for the default legend, there are toolbars specifically for Color Scales and
Bubble Scales.
1. Select a legend or legend component (e.g. legend symbol). A Mini Toolbar with context-specific buttons
will show.
2. If the toolbar fades too quickly, restore it by pressing the Shift key.
• Apart from the Mini Toolbar buttons, you can also right-click on the legend object, choose Legend and
open a shortcut menu with some useful commands such as Text Color Follows Plot, Reverse Order,
and Show Legend for Visible Plots Only. The same menu commands are available from Graph:
Legend.
• Both the Mini Toolbar and the shortcut menu have an Arrange in Vertical/Horizontal button/command
for changing the legend aspect; or you can modify it interactively by selecting the legend object, then
pressing CTRL while dragging a selection handle (e.g. drag horizontally to create a legend that is all on
one line).
240
Customizing Graphs
• You can modify the white space around legend entries in the default 2D legend, by clicking precisely on
the legend frame and dragging the selection handles.
• While plot metadata stored in column label rows is an ideal source for legend text, you can simply
overwrite the existing legend text with literal text. Either double-click on the legend text to enter in-place
edit mode or if that proves to cumbersome, right-click on the legend and choose Properties (taking care
not to overwrite the "\l( )" notation that creates the plot symbol). CTRL + double-clicking on the legend
will also open the this dialog.
• Any changes that you make to the legend can be saved with the graph template (File: Save Template
As) If you do not want a legend object added to your graph each time you create the graph, delete the
legend object and re-save the graph template.
If you are adding symbols to the legend manually, there is a new simplified Symbol
Map dialog for Origin 2022b. Most-used symbols are arranged on tabs for easy
access. To access the full Symbol Map dialog, click the Advanced button.
Annotating a graph can be as simple as adding a static text object and formatting it with Mini Toolbar buttons.
Or you might add a more complex object that is dynamically linked to a variable value or to some LabTalk
script that is executed whenever some user-specified event occurs.
Origin 2022b supports "substituting" cell Notes in graph legend and text objects using
@WN (e.g. %(1, @WN, B, 3) for Note in col(B), 3rd cell of 1st plot's source
worksheet).
The following table lists some common graph annotation tasks and available tools for accomplishing those
tasks:
241
UserGuide_2022b
Task Method
• Choose Format: Plot ..., then click the Label tab and select Enable (not
available for all plot types).
• Select a plot and use the Mini Toolbar Show Data Labels button to turn
on labels. Some label buttons may support formatting options for the data
labels (hint will be a downward pointing arrow as on the button shown here).
• To label a single data point, click twice on the point (hint: not a double-click but
a click, pause, click). When the single-point is selected, click the Show Data
Labels button on the Mini Toolbar.
Label Data
Points and Plots • For format options not supported by Mini Toolbars, you will generally use
controls on the Label tab of Plot Details. Note that labeling options will depend
on the plot type.
• Click the Text Tool button, then click on the graph to place the object.
• Right-click on the graph and choose Add Text from the shortcut menu.
• Double-click on text to do rich text editing; or click on the object and use the
text object Mini Toolbar to change font color, bold, align, wrap text, etc.
242
Customizing Graphs
Task Method
• Right-click on graph and choose Add/Modify Layer Title from the shortcut
menu to add/modify layer title in active layer.
Add Layer Title In Origin 2022b, add a label to multi-layer graphs with the
page-level Mini Toolbar Add Label for Layers button
(hint: click outside of graph layers to show).
• With a 2D graph active, use the Insert: Straight Line... menu item. Note that
this tool allows use of a simple LabTalk expression in the At Value field (e.g.
Add
Vertical/Horizont "mean(plotdata(1,Y))" which translates to "mean of 1st plot's Y dataset") for
al Line positioning the line object. For information, see At Axis Value.
• This is another another option for labeling individual data points. Click the
Annotate a Data
Point Annotation tool on the Tools toolbar. See The Annotation Tool.
Add Drawing
Objects
New for Origin 2022b: On the Tools toolbar "split-button"
with the Arrow and Curved Arrow tools, you'll now find a
Distance Annotation button for drawing a scale-labeled,
double-headed arrow between two points on a 2D graph.
243
UserGuide_2022b
Task Method
• Insert Equation button group on the Tools toolbar. For equations, note that you
can download a free App from the OriginLab File Exchange, for adding LaTeX
objects to worksheets and graphs.
• Right-click on the graph and choose Insert Images From Files. You will be
asked whether you want to insert your image as a background for the active
Insert Image graph layer. Answering yes will cause the image to be imported and placed
behind plots, graph legends, text objects, etc.
• Click the New Link Table button on the Add Object to Graph toolbar and
then click on the graph.
• To format the table, select it and use the available Mini Toolbar.
Add Table
244
Customizing Graphs
Task Method
Insert Date & • Date & Time button on the Add Object to Graph toolbar.
Time Stamp
Insert Project • Project Path button on the Add Object to Graph toolbar.
Path
Add Bracket with • Manually adjust the size and placement of brackets by dragging handles on the
Asterisk object.
• To format the bracket, click the bracket and use the Mini Toolbar buttons.
Beginning with Origin 2021, use Alt+Enter when creating multi-line text objects. To
revert to using Ctrl+Enter to insert a line break, set @FCA=1.
• Pressing CTRL when drawing with the Rectangle or Circle tools, will draw a square or circle (as
opposed to a rectangle or ellipse).
• Use Mini Toolbar buttons for quick edits to selected objects. For more complex edits, right-click an object
and choose Properties to edit object properties and set defaults.
• For text objects, including the axis titles and graph legends, you can edit text objects directly in "In-place
Edit" mode. Double-click on a text object to edit. Use the Format toolbar buttons to add superscript,
subscript, and Greek characters.
• Note that manual editing of axis titles and legends may be the best "quick solution", in most cases, you
are better off using worksheet column metadata to automatically create axis title and legend text.
• Do NOT set font size while in "In-place Edit Mode" unless you need to mix font sizes within a single text
object. The correct way to change font size is to click the text object once so that the green selection
245
UserGuide_2022b
handles appear, then select font size from the Format toolbar. If you set while in In-place Edit mode,
Origin will not indicate the proper font size when you hover on the text object.
• When you are in In-place Edit mode, you can right-click and choose Symbol Map to insert special
characters into your text object.
For Origin 2022b, this opens a simplified, tabbed Symbol Map with quick access to
most-used symbols. To access the full dialog, click the Advanced button.
• You can insert data from of a worksheet cell into a text object by copying and pasting the cell contents.
While in In-place Edit mode in the text object, right-click and choose Paste or Paste Link. Data added by
Paste is static; Paste Link is dynamic and thus, the text object will update if the data in the linked cell
changes.
• Also, when in In-place Edit mode, you can right-click and choose Insert Info. Variable... to insert
project variables into the text object. Since the pasted information is linked to a LabTalk variable value,
the inserted data updates if the variable value changes.
• You can insert variable values into a text object using the LabTalk %, and $ substitution notation by
setting the Link to (%,$), Substitution Level to 1 in the text object's Properties dialog box,
Programming tab. Right-click on the text object and choose Properties from the shortcut menu.
Alternately, you can use the Link to Substitution Mini Toolbar button, saving you
from having to open the Properties dialog.
• You can use controls on the Programming tab of Properties to associate your LabTalk script with a text
or drawing object (for instance, see Linking Text Labels to Data and Variables). Enter your script in the
text box and specify a Script, Run After condition for running the script. Use the Apply to drop-down to
set the scope for the script.
• You can copy a range (of cells) from a workbook and paste it into a graph as a table object. Table content
is (a) edited by double-clicking on the object and (b) can be formatted using Mini Toolbar buttons.
246
Customizing Graphs
You can group text labels and drawn objects so that they move or resize as a unit:
1. To select objects, press SHIFT + click; or drag out a box around objects using the Pointer tool.
2. To group the selected objects, click the Group button on the Object Edit toolbar.
3. To ungroup objects, click the Ungroup button on the Object Edit toolbar.
You can align multiple text labels and/or drawn objects with one another using the tools on the same Object
Edit toolbar:
1. Select objects to be aligned by holding the SHIFT key while selecting (or drag out a selection box using
the Pointer tool), then click one of the align objects buttons on the toolbar. Note that objects will be
aligned with respect to the first-selected object.
You can bring overlapping objects to the front or send them to the back:
1. Select the objects that you want to move to the front or the back.
2. Click the Front button or the Back button on the Object Edit toolbar.
Note: For more information on graph annotations, see your Origin User Guide:
Help: Origin: Origin Help > Graphing > Adding Text and Drawing Objects
You can also use the Object Edit Toolbar to manipulate graph layers. Use buttons to
align and set a uniform size for multiple graph layers or to swap layer order.
247
UserGuide_2022b
For manually placing objects -- graph layers, text objects, legends, etc. -- you can turn on a non-printing, non-
exporting page or layer grid:
• With the graph active, choose View: Show: Page Grid/Layer Grid (displays only one at a time).
• Alternately, you can turn on grids by clicking near the page margin and clicking the Mini Toolbar Show
Grids button. In addition, you'll find buttons for increasing or decreasing grid size by increments.
Grid display and related grid settings are found by clicking on the Show Grids button.
There are two settings that you should know something about, particularly if you subsequently modify axis
scales or resize the graph layer after adding annotations: One is the object's Attach to method, the other is
the layer's Scale Elements behavior.
When you add a text or drawing object to an Origin graph window, the object becomes part of the active graph
layer. Thus, if you resize or delete that graph layer, you will resize or delete the added object.
In addition to being part of the graph layer that was active at the time of object creation, note also that
objects are attached to the graph in one of three ways, depending upon the type of object and where it is
created on the page.
248
Customizing Graphs
Though objects remain a part of the layer that was active at the time of their creation, you can manage some
object behaviors by changing the object attachment method. An object is attached in one of three ways:
• Page. When attached to the page, objects are not affected by moving or resizing the graph layer, nor are
they affected by a change in axis scales. These objects are still associated with a particular graph layer
and they will be hidden or deleted if the layer is hidden or deleted.
• Layer Frame. Objects that are attached to the layer frame, are resized and moved with respect to the
layer frame. However, they are not tied to axis scales and are not affected by changes in the layer's axis
scale values. Objects are hidden or deleted if the associated layer is hidden or deleted.
• Layer and Scales. Objects are linked to a particular range of axis scale values. If you resize the layer,
the object is resized accordingly. If you rescale the axes, the object moves in relation to the visible scale
and will disappear from view if the linked axis scale range is not displayed. These objects are hidden or
deleted if the associated layer is hidden or deleted.
To briefly illustrate why object attachment is important, let's look at the following graph. After the graph was
created, arrows and text objects that point to their respective data plots, were added to the graph. Both
arrows and text objects are attached to the graph Layer Frame.
Now, consider what happens to these objects when we modify the graph's X axis scale (recall that objects
attached to the Layer Frame "are unaffected by changes in the layer's axis scale values"). Note that by
changing the axis scale display range, we have shifted the data plots but the text objects and arrows did not
move with them.
249
UserGuide_2022b
The remedy for this is to change the text and drawing objects' Attach to method to be Layer and Scales
because "if you rescale the axes, the object moves in relation to the visible scale." Sometimes we may want an
object to move with scale changes; at other times we may not. You can force either behavior if you keep in
mind the Attach to setting.
Object scaling often comes up when manually resizing the graph layer or when merging separate graphs into a
single multi-panel graph (Graph: Merge Graph Windows). By default, added objects are set to Scale with
Layer Frame -- that is, when the graph layer is resized, associated objects such as text objects, axis lines and
ticks, and axis titles -- will be scaled proportionally. In the case where you merge four single layer graphs into
a single, four layer multi-panel graph, these objects will be scaled down with the reduction in size of the layer
frame.
However, this is another default behavior that you may want to change (e.g. you have set your font size to 10
pt. and you want to preserve that size), and you can do this using the Scale Elements control on the Size tab
(Layer level) of Plot Details. If our goal is to keep objects at their current size when merging graphs, for
instance, we can open the Plot Details dialog box and at the layer level (Format: Layer...), click on the Size
tab, choose the Fixed Factor radio button and set the scaling factor to 1.
250
Customizing Graphs
If you have resized the graph layer, either by merging multiple graphs into a single
graph or by manually resizing the layer, you will find that the font sizes do not display
at their "correct" size (i.e. if you select a text object, the Font Size list on the Format
toolbar shows the original font size). Further, if select a text object, the Status bar will
report two font size numbers -- "size" and "actual". You can reset font size so that they
are shown as actual size, not scaled size, by choosing Graph: Fix Scale Factors. For
more information, see FAQ-441 How do I export graphs with exact size and resolution
as specified by publishers?
• Once opened in the Image Window, define a region-of-interest (ROI) and Clip the image (graph image
clipped to ROI) or Crop the image (image is cropped in Image Window and graph).
• Use the Image Window to Set (image) Scale or Set (image) Coordinates of the inserted image.
• Images may be saved with the project or linked to an external file (Link File) to control project size.
You can insert an insert an image into graph page, with the option of inserting it as a background image that is
linked to layer and scales.
1. With the graph layer active, choose Insert: Image from File. The image is inserted as a floating image.
2. To convert the image to a background image, double-click to open it in an Image Window.
3. Right-click on the Image Window image and choose Set as Layer Background.
4. Click the Close button on the Image Window.
251
UserGuide_2022b
1. With the graph window active, choose Insert: Image from Image Window. The Insert from Image
Window dialog opens.
2. Set the Image Window drop-down to the desired image.
3. Optionally, choose to insert the image as Layer Background and to Rescale Layer using Image
Coordinates (Layer Background only).
Clicking on an Image Window image produces a Mini Toolbar with buttons for simple image manipulations
(flip, rotate, convert to gray scale, etc.).
Placing an ROI object on the Image Window image allows you to perform certain image editing operations.
Once added, the ROI can be resized (by dragging handles) or moved. Additionally, various operations can be
performed on the ROI, including:
• Clip graph image to ROI, Crop image to ROI or Copy ROI as image to graph.
• Copy Positions/Paste Positions for copying ROI dimensions to a second ROI on another Image Window.
For more information on the Image Window, see the Origin Help File.
252
Customizing Graphs
Starting with Origin 2022b, images can also be inserted as part (or the entirety) of a
text object. Source images can be from:
• Worksheet cell
When you insert an Image from File or Image from Web using the following
methods, the image is linked and not stored in the Origin project file. This helps control
project file size.
1. On the Tools toolbar, click the Text tool and click once on the graph to enter "in-place" edit mode.
2. Enter text if needed and when ready to insert image, right-click and choose Insert: Image from File or
Image from Web:
o When inserting an image from file, browse to your local image file and click Open.
o When inserting an image from Web, you'll need a URL (hint: locate your Web image, then right-
click and copy the address (Copy Image Address, Copy Image Link, etc, depending upon
browser).
To examine (or modify) the syntax used for inserting an image, you can select the inserted object and choose
Properties. In the Text Object dialog, you should see something like these examples:
Examples:
\img(https://www.originlab.com/images/header_logo.png, w=200)
... where option "w=" is the default width in pixels, of the inserted image. Width is user-modifiable by editing
the "w=" value in Properties or -- if no width is specified -- by simply dragging the object's selection handles.
You can also insert an image from a worksheet cell into a text object, but you'll need to make use of a special
syntax. The syntax is not complicated and combines a \cell( ) escape sequence with a cell reference --
either a range reference (e.g. [Book1]Sheet1!col(C)[1] ) or a named range reference.
253
UserGuide_2022b
1. On the Tools toolbar, click the Text tool and click once on the graph to enter "in-place" edit mode; or
right-click and choose Add Text from the shortcut menu.
2. Enter your string into the text object using the examples below as a guide:
o If you are copying and pasting a string (e.g. \cell([Book1]Sheet1!B[1])), click outside the
text object to leave edit mode. Your cell image should display in the text object.
o If you are typing directly into the text object in "in-place" mode, enter your syntax (e.g.
\cell([Book1]Sheet1!B[1])) and when finished, right-click on the object, choose
Properties and on the Text tab, remove one of the leading "\" characters from your cell
reference (Origin automatically "protects" "\" characters entered into text objects which is why
you'll need to remove one "\". See Escape Sequences).
o If you are typing directly into the Text Object (Properties) dialog, enter your syntax (e.g.
\cell([Book1]Sheet1!B[1])) directly to display the cell image.
Examples:
You can overlay geopolitical boundaries on graphs or Image Plots of NetCDF data from the Insert menu.
• Insert: World Map will apply boundaries within the graphs current Lat and Lon ranges.
• Depending upon the graph's Lat and Lon ranges, other options may be available (e.g. Continental USA
Map, Map of China, etc.).
You can also import locally-stored shapefiles using Origin's Shapefile Connector:
There are at least two add-on Apps for inserting geographic data:
• OriginLab's free Google Map Import App lets you place a Google Map as background on the graph page
using specified coordinates.
254
Customizing Graphs
• Maps Online is another free OriginLab App that lets you connect to one of several map databases.
You can find and install these Apps by pressing F10 and searching on maps. For information on App
installation, see Where Do I Find Apps?
Task Method
or
Merge
multiple
graph
windows
into a single
graph
A Unit control is added for Origin 2022
window.
Origin has two dialog boxes -- Fitting Layers to Page and Fit
Page to Layers -- that are useful for arranging multiple graph
panels on the page and for adjusting graph margins.
255
UserGuide_2022b
Task Method
or
Extract
multiple • Click the Extract to Graphs button on the Graph toolbar.
layers in a
single
graph to All layers are extracted to individual graph windows, even if a layer is linked to another
multiple layer.
graph
By default, the layextract dialog box has Extracted Layers set to 1:0, which specifies
windows
that all layers be extracted. To extract only certain layers, clear Auto and use the
layextract X-Function's comma/colon notation to control which layers are extracted. The
notation 1:0 means starting with layer 1, extract all layers to graphs (0 denotes all).
Specifying 1,3:4, for example, tells Origin to extract only the first, third and the fourth
layer. Note that you can enable Keep Source Graph to preserve the original graph.
• Position selected layers using Object Edit toolbar buttons. Hold SHIFT + click to
select multiple layers and Align Left, Right, Top, Bottom, etc.
Add,
arrange,
resize,
position,
swap, align, A Unit control is added for Origin 2022
or link
layers
You can use the Layer Management tool's Swap control (Graph:
Layer Management,Size/Position tab) to physically swap
layer positions without reassigning layer numbers. Before doing
so, set each linked layer's Units to % of Page (Size/Speed
tab of Plot Details).
• Row by column layer arrangement with control of page size and spacing between
layers.
Simple
arrangeme
nt of layers
256
Customizing Graphs
Task Method
• Linked Axes Scales tab, layer level of Plot Details dialog box.
Link graph When linking layers, the child layer must have a higher layer number than the parent
layers layer.
You can link layers' axis scale values to be Straight (1:1) or you can specify a Custom
mathematical relationship.
There are several ways to reorder graph layers (reassign Layer number for each Layer).
Reorder Learn more about reassigning layer numbers in the mini tutorial below this table.
layers
Method 1: Open the Layer Management dialog and click the row header (shown in image
below) and drag it up or down to change the Layer order.
page.reorder(n,m)
Method 3: Use the Front and Back buttons on the Object Edit toolbar (these buttons work
on the active layer as indicated by the graph layer icon ). Alternately, right-click on
the graph layer icon and change layer order using shortcut menu commands (e.g. Bring to
Front).
257
UserGuide_2022b
Task Method
Reorder
layers A Note on Inset Graphs: In certain situations (see Tutorial, below),
the order in which the layers are drawn on the screen becomes an
(cont’d) issue. In this image, we have added an inset graph using the Add
Inset Graph with Data button (Graph toolbar). The problem is that
the data plot of the parent layer (red symbols) shows through the inset
layer (small, black symbols). To fix this, we do two things:
• Set the layer Drawing order to Draw layer by layer (Format: Page
then Layers tab).
By default, an inset layer is added "on top of" the parent layer but if
needed, you can click on the inset layer to select it, right-click and
choose Bring to Front.
258
Customizing Graphs
Task Method
• Method 1: Open Plot Setup dialog(by selecting Graph:Plot Setup), expand the
bottom panel, select a plot and drag it from a layer to another layer.
• Method 2: Run laymplot -d; (e.g. open the Script Window, type the command
and press <Enter>) to open the Move Plot dialog to specify plot(s) to move and a
Move a target layer.
plot(s) to
another
layer
You can move a plot by Copying (CTRL+C or Copy Range
context menu) and Pasting (CTRL+V or Paste context menu)
operations, between different layers or different graphs. Please
note, the pasted plot won't be associated with the source data of
the copied plot, but exists as a loose dataset.
In a multi-layer graph, layer order determines drawing order. The 1st layer is plotted and
then 2nd layer is plotted on top of it, and so on. The layer with higher number is drawn on
top of the layer with lower number. This is important when plots in one layer overlay plots
in another layer. When necessary, you can change layer order to change plot drawing
order.
This mini tutorial shows you how layer reassignment works. Use the preview window to
see how layer number reassignment affects your graph.
3. Activate the graph Area Plot With Horizontal Color Gradient, then click the
Extract to Layers button on the Graph toolbar. Set both number of rows
and columns to 1, click OK, then, click OK again for the page spacing. The green
layer is on the top of the yellow layer in the figure. The purpose of this last step
was simply to create a two layer graph in which the data in one layer partially
hides the data in the other layer. What we will do now is to reorder the layers and
259
UserGuide_2022b
set the yellow layer on the top, giving you a better view of the two plots.
4. Choose Graph: Layer Management... menu, then drag the row header "1" of the
Layer1 in the Layer Selection downward under the Layer2 (indicated by a blue
line), and click OK.
260
Customizing Graphs
Alternate Method: You can use the Front or Back toolbar buttons (located in
the Object Edit toolbar, or at the top of Layer Selection box in the Layer Management
dialog) to bring a layer forward or push it backwards. As happens when you rearrange
layer order with the Layer Management dialog, this method swaps layer numbers.
You can easily add an inset layer with data by clicking the Add Inset Graph With
Data button on the Graph toolbar or Insert: New Layer(Axes): Inset With
Data (Linked Dimension) .
You can copy a layer from one graph window to another graph window. Click to select
the layer first (a frame shows around the layer). Then press Ctrl+C or right-click and
choose Copy. Click on the target graph window, then right-click to Paste.
Note: For more information on merging graphs, see your Origin User Guide:
Help: Origin: Tutorials > Graphing > Layers > Merging and Arranging Graph Layers
Help: Origin : Origin Help > Graphing > Reference > The Merge Graph Dialog Box
261
UserGuide_2022b
Note: For detailed information please refer to Origin Help file, see:
Help: Origin: Origin Help > Graphing > Creating Graphs from Graph Templates
Help: Origin: Origin Help > Customizing Your Graph > Graph Formats and Themes
12.13.1 Templates
A new Origin installation lists close to 240 plot types, each one backed by an Origin graph template file (*.otp
or *.otpu). For most users, a Plot menu graph is the starting point for customizing and saving your own
custom graph templates. The basic process goes like this:
1. Plot your worksheet or matrixsheet data using the Plot menu (or equivalent graphing toolbar button).
2. Customize the graph's default settings.
3. Save the graph as a graph template file (*otp or *.otpu) by choosing File: Save Template As and filling
in the requisite information. By default, custom templates are saved to your User Files Folder (hint:
easily find this folder by clicking Help: Open Folder: User Files Folder).
• The Plot menu is the definitive list of built-in plot types. At one time, a graphing toolbar button was
created for each new plot type but in recent versions, few toolbar buttons have been added as toolbar
space has become limited.
• In a fresh Origin installation, each one of Origin's 240 built-in graph types uses a specific "system"
template when creating a particular graph type. When you click on a Plot menu graph or graphing toolbar
button (e.g. Area ), one of these system templates is used to plot the selected data.
• System templates are installed to the Origin Program Folder. They are completely customizable but as the
Program folder is write-protected, you cannot overwrite the original system template file (see next).
• Instead, when you customize and save a system template, it is saved by default to your User Files Folder
(UFF). If you save the customized template to the same system template name, the customized template
replaces the system template as the template associated with the Plot menu command or corresponding
toolbar button used to create that plot type. Additionally, the customized template is added to the user's
Template Library.
• To view your custom graph templates, click Plot (workbook or matrix should be active) and click Category
= MyTemplates.
• You can save a graph template anywhere (and with any name) that you like -- it does not need to be
saved to your UFF. However, by saving customized templates to your UFF, they will be collected in one,
262
Customizing Graphs
easily-remembered place and they will be readily available when you upgrade your Origin software (since
Origin 2018, all Origin versions have shared a common User Files Folder).
• For information on the Template Library, see The Graph Template Library.
Summary of Features:
• Toggle between list and thumbnail view modes. Thumbnails images are automatically generated when you
save a template.
• In either mode, you can hover on the template to preview, read template location, comments, etc.
• In list mode you can sort; or opt to list a User or Extended template under Plot: My Templates.
• Templates are listed as System, Extended or User. System templates are Origin's default templates for
creating Plot menu graphs. They can be plotted to and customized but cannot be overwritten. Extended
263
UserGuide_2022b
templates are add-on templates that are installed with Origin. User templates are those that you
specifically customize then save using File: Save Template As; or which you add using the Library's Add
or Scan functions. Note that User templates can include customized System templates that you have
saved to \User Files.
• To scan your User Files folder (UFF) for custom templates, click the Scan User Template icon. To browse
and add a template file to the Library, click the Add Template icon.
• Click the List Cloneable Templates icon to show only cloneable templates.
• Click the Manage Mode icon to delete, show or hide a given template. Hiding a template removes it from
My Templates but does not remove it from the Template Library (note that you can also remove a
template from My Templates simply by clearing Show in Menu). Deleting a template removes it from the
Library and moves the template to User Files\DeletedTemplates.
• Click the Template Center icon to open a dialog and search the OriginLab site for additional graph
templates.
Beginning with Origin 2022b, you can search for Template Center templates and
install them directly from the Start menu.
An Origin Theme is a file containing a set of object properties. There are four kinds of Theme files in Origin:
graph Themes, worksheet Themes, dialog Themes and function plot Themes.
Graph Themes are a collection of properties of different elements in a graph window. A graph Theme can be
very simple (e.g. graph axis major and minor tick direction settings) or it could be something more complex
(e.g. a combination of page dimensions, layer background, axis scales, and color palettes). Whether simple or
complex, the purpose of graph Themes is to allow you to quickly change one or more object properties in an
existing graph, or to apply a consistent set of properties to a selection of graph windows, without having to
recreate a suite of settings, or to apply those settings one-by-one to individual graph windows.
All graph objects have a customizable set of properties that are specific to the object type. Therefore, it follows
that the properties that can be saved as a Theme differ depending upon the selected object. You can (1) copy
a Theme from one object and "paste" it to another object of the same type or (2) you can save a Theme from
one object as a named Theme and apply that named Theme to other like objects at a later time.
1. Right-click on an object in a graph window (e.g. a plot) and choose Copy Format. Depending on what
you click on, there may be sub-menu items under the Copy Format shortcut menu, which give you the
option as to what exact format to copy.
o To apply the copied formats to a single object, right-click on your target graph and choose Paste
Format To. Again, this shortcut menu might has some sub-items that limit what to paste. In this
way, the formatting option(s) from your source object should be applied to your target object.
o To apply the copied formats to multiple windows in the project, keep the source graph window
active and select Edit:Paste Format(Advanced)... from the Origin menu. This opens the Apply
Formats dialog box. Here you have the option of editing or selectively applying formats to one or
more graph windows in the Origin Project.
264
Customizing Graphs
2. If you would prefer to save formats to a named Theme file that you can re-apply at a later time, choose
the Save Format As a Theme... shortcut menu item, then use Preferences: Theme Organizer to
apply the Theme when needed.
Use the Theme Organizer (Preferences: Theme Organizer) to organize and apply Themes to graphs.
With this dialog box you can apply a graph Theme simultaneously to multiple graphs in the Origin project file.
1. Press the CTRL key while selecting multiple Themes, then right-click and choose Combine from the
shortcut menu. The shortcut menu in the tool provides an option for editing a Theme, allowing the user to
add/delete properties from an existing Theme.
• The Theme Organizer has separate tabs for managing graph, increment list, worksheet, dialog boxes and
plotted mathematical function Themes.
• If you right-click on a graph Theme and save it as your System Theme, then each time you plot a new
graph, this System Theme will be applied regardless of the settings that were saved with the graph
template†.
• Use the System Increment Lists tab to manage increment lists and selectively apply them to project
graphs.
• You can load a graph Theme in the Export Graph dialog and the Theme will be applied to the exported
image file.
265
UserGuide_2022b
† If you don't want a System Theme to be applied automatically to the graph, save the
graph as a template (File: Save Template As) and clear the Apply System Theme
to Override check box.
• Graph Axes
• Graph Legends
• Color Scales
• System Templates
• System Themes
266
13 Graphical Exploration of Data
Origin includes a number of tools for graphically exploring your data including those for zooming and panning
data plots, reading XY coordinate values and other data point metadata, or highlighting or masking selected
data points.
267
UserGuide_2022b
With Origin 2016, OriginLab began releasing add-on tools called Apps. Many
exploratory and analysis-related tools have been added to OriginLab's File Exchange
since that time. If you find you need some exploratory or analysis tool that is not a
standard part of Origin, you might check to see if the tool exists as an App. If it does
not, request it!.
• Click on one plot in the graph layer. Other plots in the layer and in linked layers sharing the same X axis,
will be dimmed.
• To highlight/dim plots on hover (without clicking), click the Highlight Plot when Mouse Over Mini
Toolbar button (page-level).
Other Origin features useful for quick visual inspection of data plots:
• If you have many columns of Y data, plotting a Browser Graph, or adding a Browser panel to an existing
2D line plot, can be useful for quick visual inspection. Clicking the menu on the Browser panel, you can
plot every Nth column or Flip Through plots using a specified Move By factor.
• For scatter data, use the customizable Data Point Tooltip to read coordinate values and column
metadata on mouseover.
• You can also use Tools toolbar buttons to zoom or pan your graph, as you will see in the next section.
• Origin has various other tools available for visually inspecting and recording information on your data plots
and those are covered in the remaining subsections of this chapter.
268
Graphical Exploration of Data
1. Apply one or more filters to your worksheet data and create your plot.
2. Hover just inside the graph window but outside the layer and when you see the Mini Toolbar cursor, click
and look for the Data Slicer button.
3. Once the Data Slicer panel is enabled, you will want to right-click on the title bar of both the worksheet
and the graph and Duplicate the two windows. Duplicating the two will allow you to make side-by-side
comparisons.
4. In the left panel of the duplicated graph, click on the listed filter(s) and choose another category from the
drop-down list.
This section discusses the use of toolbar tools, and keyboard and menu commands that change the view of
your 2D graph. We have split these tools and commands into two groups:
• Page-level zoom and pan operations that do not change axis scales.
• Axis rescale operations which zoom and pan the graph by changing axis From and To values.
269
UserGuide_2022b
Page level zoom and pan do not alter the graph; they only determine which portion of
the graph page is visible within the graph window. You can read the current zoom level
in the Zoom dropdown list of the Standard toolbar. Page-level zoom and pan will not
affect the printout or export of the graph. On the other hand, axis rescaling tools (e.g.
and ) do alter the graph and, thus, will affect the printout and export of the
graph.
• Stepped zoom.
• CTRL+I activates
zoom in; click on the
† View:Zoom graph to establish
Stepped Zoom-Pan :
CTRL + I In and the focal point.
Zoom graph in or out, by
CTRL + M View:Zoom
increment.
Out • CTRL+M zooms out;
clicking on graph not
needed.
270
Graphical Exploration of Data
• Can be used to
locate "lost" objects
Zoom All: All objects in View: Zoom lying outside the
-- --
the window are shown. All
graph page.
†
Notes: These are older tools and methods that have been deprecated. Toolbar buttons are not shown by
default. To add them to the workspace, use the Customize Toolbars dialog box (View: Toolbars > Graph
button group).
13.3.2Axis Rescaling
• Enable clipping on Miscellaneous tab of Plot Details (layer level) hides plots
outside of frame.
• SHIFT + scroll to
rescale Y.
271
UserGuide_2022b
Z + scroll
wheel
• Rescale the graph in
X + scroll
wheel • Rescales X.
Pan the graph in the X or
-- -- • Does not rescale Y.
dimension. X+
+/-
keys
• Rescales (Resets) X
Rescale X: Rescale the to full X range +
graph in the X -- --
some padding factor.
dimension.
SHIFT + Z +
scroll wheel • Rescale the graph in
SHIFT + X
+ scroll
wheel • Rescales Y.
Pan the graph in the Y or
-- -- • Does not rescale X.
dimension. SHIFT
+X+
+/-
keys
• Rescales (Resets) Y
Rescale Y: Rescale the to full Y range +
graph in the Y -- --
some padding factor.
dimension.
• Rescales (Resets) X
Rescale XY: Rescale and Y to full range +
the graph in both X and -- --
Y dimensions. some padding factor.
272
Graphical Exploration of Data
• Rescales (Resets) Z
Rescale Z: Rescale the to full range + some
graph in the Z -- --
padding factor.
dimension.
• Select Scale In
button, then drag
out rectangle(s) to
define axis scale
range desired.
• Reset by clicking on
the Scale Out
Scale In/Scale Out:
Rescale the graph in X and -- -- button (no need to
and Y dimensions. drag) several times.
You can use the Scale In button to copy an enlarged portion of your 2D graph to a
new window. This will also work on any graph that has multiple linked layers as long as
the layers are overlapped and share a common axis (% of Linked Layer has
Left/Top set to 0 and Width/Height set to 100, plus Straight (1 to 1) linking to the
parent layer). With a graph active, press Ctrl then click the Scale In button (Tools
toolbar) and drag out a rectangle on your 2D graph. Note that this Enlarged graph is
dynamic. Move or resize the rectangle on your original graph and the Enlarged graph
is updated.
If you do not see a toolbar button, it may be turned off. To add or remove buttons from
a toolbar, see The Customize Toolbar Dialog Box.
273
UserGuide_2022b
To prevent an axis from rescaling when using one of the axis rescaling tools, set
Rescale = Fixed. If both X and Y axes are set to Fixed and you pick one of these axis
rescaling tools, you are reminded that X and Y axes are in "Manual Rescale mode" and
are prompted to proceed. Answering Yes will allow you to override and manually
rescale in one or both dimensions. If you need to block such manual overrides of Fixed
axis scales, set @nrm = 1.
This openGL toolbar that previously displayed when a 3D layer was selected, has been
replaced by layer-level Mini Toolbar buttons.
When you click inside the layer of a 3D graph, the layer is selected and a Mini Toolbar appears. Click the
Rotate Mode button to enter rotation mode; then use one of the hotkey/mouse combinations listed below; or
drag the radial rotation handles in the graph with your mouse.
Rotate the 3D graph around With graph layer active and with Rotate Mode
Y + Arrow key
the Y axis.
button selected in the 3D floating button group.
Drag to rotate the 3D graph Press "R" before pressing other keys.
R + Mouse
in an arbitrary direction.
274
Graphical Exploration of Data
Most 2D plot types, 3D Scatter, XYY Bar and XYZ Bar plots support a floating, customizable tooltip that reads
data point values when you hover on a data point.
275
UserGuide_2022b
For tooltip customization and other options, right-click directly on the data point tooltip.
• Show Data Plot Tooltip toggles display of a non-customizable data plot tooltip in place of the
customizable data point tooltip (see, below).
• Pick Data Points puts the cursor into data reading mode and opens a Pick Points dialog. Double-click
on points in the graph and when finished, click Done. This generates summary data (source, X-Y
coordinates, etc.) for your picked points.
• Copy copies data point tooltip information, including labels, to the Clipboard.
• Copy Coordinates copies only coordinate values. Right-click on a cell and Paste each value to a separate
cell within the row; or Paste (keep spaces) to paste values to the selected cell as a space-separated
string.
• Preferences opens the Data Point Tooltip dialog allowing you to customize tooltip content and
formatting. Use documentation of the Data Info window, below, as a guide to configuring your tooltips.
The Data Point Tooltip dialog is a slightly simpler version of the Data Info window's preferences dialog (Data
Info Report Settings). See The Data Info Window for help with customizing your Data Point Tooltip.
For Origin 2022b, the Data Point Tooltip dialog adds a Column Width control, giving
you better control over the width of tooltip column display. This is especially handy when
tooltips include images.
276
Graphical Exploration of Data
By default, the Data Point Tooltip displays with a moderate degree of transparency. You
can affect tooltip transparency by changing the value of LabTalk System Variable
@TDT. For information on changing the value of a LabTalk System Variable, see this
FAQ.
There is a second tooltip that can be displayed in place of the Data Point Tooltip and this we refer to as the
Data Plot Tooltip. This non-customizable tooltip displays the source book, worksheet and coordinate datasets,
on hover.
The Data Point Tooltip displays by default. If you prefer to use the Data Plot Tooltip, right-click on the Data
Point Tooltip and choose to Show Data Plot Tooltip. Conversely, right-click on the Data Plot Tooltip and
choose Show Data Point Tooltip.
277
UserGuide_2022b
You can turn off display of data tooltips by activating the graph window, clicking on the View menu and
clearing the check mark beside Data Tooltips.
There is a second way to control tooltip display that is more complicated but allows a greater degree of control.
This entails changing the value of LabTalk system variables @PT and @PTI.
@PT=3; //Enable data plot tooltips for both 2D graph and 3D OpenGL graph
Use the Annotation tool to label a data point. The tool works with Symbol/Line+Symbol and Column/Bar plots.
Choose from several standard data point labels or create your own custom label using LabTalk script.
1. Click the Annotation button on the Tools toolbar and move the cursor to the desired data point. The
cursor and the Status Bar will display the current label form.
2. Use the TAB to toggle between the following standard annotation forms: (X coordinate value, Y coordinate
value); (X coordinate value, Y coordinate value)[index number]; X coordinate value; Y coordinate value;
index number (row number); or Custom (see Tutorial, next).
3. When you've selected your label form, double-click to add a label to the data point; or single-click on the
point and press Enter.
The annotation string can be customized by combining literal characters with the X and
Y coordinate values:
278
Graphical Exploration of Data
3. Click the Annotation button , hover on your graph, then press the Tab key
several times to cycle through the annotation choices until the custom string
format specified above is displayed in the Status Bar. The cursor will display the
word "Custom".
4. Start double-clicking on data points (or single-click and press Enter) to add the
custom annotation string. The X values will be displayed with two decimal places
and the Y values will be displayed with 5 significant digits, as specified by your
script.
• To move a label to another data point, click the Pointer tool , press the ALT key and drag the label.
• To re-position overlapping labels, drag the label. A leader line is automatically added.
• To copy a label to another data point, press CTRL + SHIFT and drag the label to a new data point.
Note: Please view more information on string formatting in the Programming help file:
Help: Programming: LabTalk > Language Reference > Object Reference > Alphabetical
Listing of Objects > String
The Screen Reader uses the Data Display window to report the XY(Z) coordinates of the cursor on the
graph page. Note that the Screen Reader is not reading data point coordinates; rather it is reading page
coordinates relative to the graph axes.
The Data Display window opens automatically when you select the Screen Reader tool from the Tools toolbar
(by default, the Data Display window is docked at the bottom of your Origin workspace).
279
UserGuide_2022b
You can alter basic properties of the Data Display window by right-clicking on the window title bar or by right-
clicking inside the window.
1. Click the Screen Reader button on the Tools toolbar. This opens the Data Display tool.
2. Click on a location in the graph page to read its X,Y, and Z coordinates (ternary and contour only).
Coordinate values show in the Data Display window.
3. To increase cross-hair size, press the space bar.
4. Click the Pointer button on the Tools toolbar to exit screen reading mode.
The Data Reader is used to read information associated with a data point in your plot. This could be
coordinate values or it could be more complex information including metadata or even images that relate to
the data point. The Data Reader works in concert with the customizable Data Info window.
The Data Reader tool is grouped with two related tools -- the Data Cursor and
the Data Highlighter . Only one of these toolbar buttons will show at any given
time. To select a hidden tool, click on the small arrow to the right of the button and
select a tool from the pop-up menu.
1. Click the Data Reader button on the Tools toolbar. This opens the Data Info window.
280
Graphical Exploration of Data
2. Click on a data point to read its X,Y (and Z, if they exist) coordinates. Coordinate values display in the
Data Info window (and Data Display window).
3. To move the cross-hair to the next data point along the data plot, use the LEFT and RIGHT arrow keys or
click on the data point using your mouse. If you have multiple plots in a layer, use the UP and DOWN
arrow keys to move to a data point on another plot or use your mouse to click on the point.
4. To change the vertical and horizontal cross-hair size, click on a point and press the spacebar.
5. Click the Pointer button on the Tools toolbar or Esc key to exit the Data Reader tool.
You can zoom into the graph while using the Data Reader. While the tool is active,
press CTRL and use your mouse wheel to zoom in or out on the page.
The Data Cursor tool -- grouped on the Tools toolbar with the Data Reader tool -- allows you to place one
or more cursors on a data plot and (using the Data Info window) read the cursor coordinates or measure the
X and Y distance between two cursors, or the distance between a cursor and a point selected with the Data
Reader.
2. Click and select the Data Cursor button from the Tools toolbar.
3. Double-click on one of the peaks or click once on a data point and press
ENTER, to add a cursor object.
281
UserGuide_2022b
282
Graphical Exploration of Data
New for Origin 2022b: On the Tools toolbar "split-button" with the Arrow and
Curved Arrow tools, you'll now find a Distance Annotation button for drawing a
scale-labeled, double-headed arrow between two points on a 2D graph.
283
UserGuide_2022b
To fine-tune arrow placement, right-click on the drawn arrow and choose Properties.
Use Dimensions tab settings to control exact placement of object.
The Data Highlighter is grouped on the Tools toolbar with the Data Reader and Data Cursor tools. Use the
Data Highlighter to pick one or more points in the your graph and simultaneously highlight the corresponding
data row in the worksheet. Unselected points are dimmed in the graph and the worksheet.
• Use left/right arrow keys to highlight individual points in sequence by row index.
• In the worksheet (still in Highlight mode), CTRL+click multiple rows or SHIFT+select blocks of rows, and
highlight corresponding points in the graph.
• Press ESC to exit Highlight mode in the graph while keeping highlighted rows selected in the worksheet.
When the Data Highlighter is active, a Mini Toolbar displays at the upper-right corner of the graph or
worksheet window. The toolbar has buttons to Create Subset Sheet, Delete Points, Mask/Unmask
Highlighted Points or Dimmed Points; plus a Highlighter Properties for configuring how to pick and
collate data from multiple worksheets.
284
Graphical Exploration of Data
A new method is added for picking a subset of points from a graph of plots from
multiple worksheets and adding them to a single sheet:
1. Pick the Data Highlighter tool , then CTRL+click to select multiple points
from a SINGLE plot; or drag out a rectangle/freehand object on the graph to select
multiple points (hint: press spacebar for ROI shape).
2. When finished, click the Create Subset Sheet button on the Highlighter Mini
Toolbar.
3. Click the Open Properties Dialog button on the Mini Toolbar and set Add
Data Mode = Append or Append with Gap.
4. Continue to pick points from other plots (worksheets) as in step 1, clicking the
Create Subset Sheet button each time you finish picking points from one of the
plots.
The Data Info window opens when you choose either the Data Reader , the Annotation or the
Data Cursor tools . When you click on a plotted data point with one of these tools, the Data Info window
displays information about this particular data point.
285
UserGuide_2022b
In its default configuration, the Data Info window reports only a column short name, plot designation (e.g.
"X") and the XY coordinate values of a data point. However, the window is capable of displaying any of the
worksheet-contained information that is associated with a data point including metadata and images.
• The Data Info window can report any information in the source data worksheet. You are not limited to
displaying plotted data.
• The window can display anything that can be inserted into the worksheet cell, including inserted graphs
and images.
• The window can be customized with a Window Title and Report Title.
• Window configurations can be saved as Themes, including Save to <Graph>, Save to <Layer> and
Save to <DataPlot>. This allows, for instance, all graph windows in your project or all graph layers in
your multi-panel graph to have a unique Data Info window. Saved Themes can loaded and applied to the
current Data Info window.
286
Graphical Exploration of Data
If you save your Data Info Theme settings in the graph, then save the graph window
as a standalone graph window file (OGG, OGGU), know that the OGG/OGGU file travels
only with the data that are plotted in the graph. Therefore, if your Data Info Theme
uses data in other columns in your worksheet, the Data Info display will be incomplete
if, for instance, you reopen the window file in a new project.
• Tutorial: The Data Reader Tool (discussion on customizing the Data Info window).
13.5.11 Gadgets
Origin provides several Gadgets for data exploration and analysis. These gadgets are accessible from the
Gadgets menu when a graph window is active. Three gadgets in particular are suitable for data exploration:
• Vertical Cursor
• Statistics
• Cluster (OriginPro)
The Vertical Cursor gadget is especially useful for reading XY coordinate values for data points in stacked
panel plots or multi-plot graphs, where plots share a common X scale.
287
UserGuide_2022b
1. With a graph window active, choose Gadgets: Vertical Cursor... from the main menu. This opens the
Vertical Cursor dialog box.
Using the controls in this Gadget's dialog box, you can add data labels to the graph, increase or decrease label
font size, hide labels, etc.
When labeling plots with the Vertical Cursor, you can opt to combine separate data labels
into a single label by clicking the gadget's Show All Info in One Label button.
The Statistics gadget returns basic statistics on data points falling inside a rectangular region-of-interest (ROI)
on the graph.
288
Graphical Exploration of Data
• Display mean and nth Standard Deviation lines inside the ROI.
289
UserGuide_2022b
When you use the Cluster gadget to define a category (points within a ROI on a plot), you
can apply a differentiating color to points within the ROI.
290
Graphical Exploration of Data
This collection of tools and menu-driven operations is helpful in exploring certain "what if" scenarios, or to
quickly generate some data for purposes such as testing a fitting function. These procedures work only with 2D
scatter plots.
3. A small dialog opens and displays the graph window short name.
4. Click the Start button, then hover on the graph and double-click to set a data point. Continue clicking to
set as many data points as you need.
5. Points drawn on a new graph window will be added to a new sheet in the GAData book. Click the
Worksheet button to pop-up this new Workbook.
291
UserGuide_2022b
o Points drawn on a new graph window will be added to a new sheet in the GAData book. Each
graph window will have its own sheet in the workbook.
7. To label data points, go to the new Worksheet and enter label information in the Label column. Note that
Label column info can also be used to create plot groups by opening Plot Details and editing controls on
the Symbol tab (e.g. Symbol Color is indexed, by points, using the Label column data).
You can move individual data points in the graph. Understand that when you do this, you are changing the plot
and the underlying data:
1. Select Data: Move Data Points (you'll be warned that you are about to change your data).
2. Click on the point you want to move (change X and Y coordinates). Place crosshairs on the point and drag;
or use the arrow keys.
3. Click the Pointer button on the Tools toolbar or press ESC to exit the Move Data Points mode.
The data point is moved in the plot and the X and Y coordinates are changed in the worksheet cell.
292
Graphical Exploration of Data
The data point is deleted from both the data plot and the worksheet cell. In the worksheet, only the data cell
for the Y value will be cleared and shown as missing value.
• Gadgets
• The Digitizer
• Masking Data
• Data Filtering
293
14 Gadgets
Gadgets provide a quick and easy way to perform exploratory analysis on plotted data. The concept is simple:
While each Gadget has a specific purpose, each is built around applying a set of customizable analysis
operations to a range of plotted data defined by a movable, resizable, region-of-interest (ROI) object.
You can drag to modify the ROI at any time, then change your analysis options and recalculate results by
clicking the arrow button in the upper-right corner of the ROI and choosing one of the menu options. For
general access to Gadget formatting and analysis options, choose Preferences at the bottom of the context
menu. Use the Preferences Dialog Theme box to save a group of Gadget settings to a Theme file.
Multiple Gadgets are supported on a graph. You can distinguish ROIs by giving each a different color. Click on
an ROI object to bring it forward. When an ROI is selected, you can use the TAB key to switch the ROI.
Origin 2016 introduced add-on tools called Apps. Since being introduced, many new
exploratory and analysis-related tools have been added to OriginLab's File Exchange
and more tools are being released all the time. Please visit the File Exchange to review
available tools.
295
UserGuide_2022b
Differentiate Gadget Calculate and plot the nth-order derivative of selected data.
Integration Gadget Calculate the area under a curve, or between two curves.
2D Integration Calculate the 2D integration for a contour or image graph created from matrix or
Gadget XYZ worksheet data.
Interpolate Gadget Perform linear, spline, b-spline or Akima spline interpolation of selected data.
Intersect Gadget Calculate the intersection points of two or more data plots.
Quick Fit Gadget With Origin 2022b the Quick Fit Gadget supports
custom labeling of the ROI Box .
Quick Peaks Gadget Locate peaks, and compute area and other peak properties.
Rise Time Gadget Analyzes rise/fall time for the step-like signal.
Statistics Gadget Compute and display simple descriptive statistics of selected data on the graph.
Vertical Cursor Read coordinate values and label data plots across multiple graph layers that share
Gadget the same X axis.
Image/Contour
Analyze the image or contour from matrix data and generate profiles.
Profile
296
Gadgets
Curve Translate Drag a curve in the vertical or horizontal direction, adjusting source data in the
Gadget process.
Help: Origin: Origin Help >Matrixbooks Matrixsheets and Matrix Objects > Viewing and
Profiling Matrix Data
1. With a new workbook active, import the file Peaks on Exponential Baseline.dat
located in the Samples\Spectroscopy subfolder under the Origin installation folder.
2. Create a line plot of the data in column B.
3. With the graph active, go to the main menu and click Gadgets: Integrate....
4. In the dialog box that opens, click the Baseline tab and select Straight Line from
the Mode drop-down list.
5. Click the Output tab, and under the Output Quantities to node, select Append to
Worksheet and clear the other check boxes.
6. Expand the Quantities node, select None from the Dataset Identifier drop-down
list and enable Beginning X and Ending X.
7. Press OK to close the dialog box. The Region-of-Interest (ROI) rectangle object is
added to the graph.
8. Resize and move the ROI object to cover just the first peak in the data plot, then
press the arrow button located at the top-right of the ROI and select New
Output; or press "O" on your keyboard. This will write the parameters for the first
peak to a worksheet.
9. Drag and move the ROI to cover the second peak, and repeat the steps above to
generate output for the second peak.
10. Press the arrow button again and this time select Go to Report Worksheet. A
worksheet with the integration results will open.
297
UserGuide_2022b
Click the flyout menu button (top right of the ROI) and output results for all curves
in the current layer (New Output for all Curves (N)) or for all layers of the graph
page (New Output for All Layers (L)) or press the corresponding N or L hotkey. This
allows for batch analysis of multiple curves in a graph.
298
Gadgets
Origin 2022b supports custom labeling of the ROI Box for the Quick Fit and
Statistics gadgets.
2. Open the gadget dialog (hint: if the ROI is already added, click the menu button and choose
Preferences).
3. Click the ROI Box tab and enable Custom Label.
4. Build your custom label using a mix of (a) literal text (b) escape sequences (e.g. Greek symbols or
superscripts) and (c) custom variables. Specify decimal places, etc. using Origin custom formats.
299
UserGuide_2022b
1. Choose Gadgets: Statistics: Open Dialog (hint: if the ROI is already added, click the menu button
N n Count = $(n)
• Gadgets
• Peak Analyzer
• Digitizer
300
15 Data Analysis
15.1 Introduction
Origin contains powerful tools for all of your data analysis needs, including curve fitting, statistics, peak
analysis and signal processing. Most of Origin's analysis tools can make use of a stored collection of settings --
something known as a Dialog Theme -- that makes repeat analyses a snap. Furthermore, the output from
one operation can become the input for another operation, thus allowing you to set up a chain of operations,
with results that update whenever there are changes to source data, as would happen when importing a series
of data files.
The following sections cover (1) selecting the data that you wish to analyze and (2) the Origin and OriginPro
tools available for analyzing that data. Please refer to the How to Handle Repetitive Tasks chapter of this User
Guide for more information on Analysis Templates, Dialog Themes and other time-saving features.
Apps are add-on tools that extend Origin's graphing and analysis capabilities. Many
analysis-related tools are available free-of-charge from OriginLab's File Exchange. To
find out more about Apps in Origin, see the Apps for Origin chapter of this User Guide.
Data selections can be made before or after opening an analysis dialog. Most of Origin's X-Function based
analysis tools have a Input branch with a range selection control that you can use to interactively select your
data (as explained below).
When you highlight a range of worksheet data, then open one of X-Function based dialog boxes -- that would
include nearly all of those that open from the Analysis or Statistics menus -- you will see your range
selection already entered into the dialog box Input branch. Most will find that selecting worksheet data prior
to opening an Analysis or Statistics dialog box, is the easiest way to specify which data you wish to analyze.
301
UserGuide_2022b
If you open one of the X-Function dialog boxes without pre-selecting your data, the first thing you should do
upon opening the dialog is to select data in Input branch:
1. Click the range selection control next to Input (or Input Data). The dialog box will roll up.
2. Go to worksheet and highlight your worksheet data, then click the button at the right end of the
rolled up dialog box. The Input branch will now show the selected range.
Note that you do not have to select entire datasets (columns). You can select a portion of your worksheet data
and analyses will be confined to that selected subset of your data. Also if the analysis supports multiple
datasets, you could support multiple ranges such as multiple Y columns or Y ranges. If the analysis only
supports one dataset, you may be able to select multiple ranges in the worksheet, but only the 1st range will
be picked in the analysis.
302
Data Analysis
Notes
• The Input Data branch has a hierarchical structure. If the analysis supports multiple datasets, you can
add multiple ranges under Input Data and they will show as Range 1, Range 2, etc., each with its
corresponding X, Y, Error and Row controls.
• Mousing over each level will show a tooltip indicating where the data on that level is from (i.e. book, sheet
and column).
• A Rows control under each range node lets you set range by row index or X value. If you want to apply
the same row range to all ranges under Input Data, click the arrow button to the right of the range node
and choose Apply Row Range to All.
• Depending on where you are in the Input Data hierarchy, the range selection button may have some
limitations ( e.g. if you click range selection control next to Y, though you could select multiple columns in
a worksheet, only the 1st column is accepted).
• Clicking the arrow button to the right of the range selection control will show more selection options,
including individual worksheet columns that can be quickly added to your data selection.
• Depending on which level you are in, the selection options when clicking the arrow button may vary. For
instance, clicking the "arrow" button next to Input Data and clicking the Select Columns... menu item,
will open the Column Browser allowing you to select multiple columns from different worksheets.
303
UserGuide_2022b
1. Use the List Datasets drop-down list to filter which sheets you want to pick from. The top panel list can
be sorted by clicking any of the column headings, making it easy to select, for example, all columns that
share the same LName or Comments.
2. Then click the Add button to add the column to your selection list in bottom panel.
3. To modify the data input range of any dataset, click the range button to the right of any dataset added to
the bottom panel and edit the From and To values.
When a graph window is active and you select one of the Analysis menu tools, the default behavior is for the
analysis dialog box to open showing the selected range of the active dataset as your Input Data (note that
analysis dialogs include an Input Data node that allows adjustments -- adding more datasets with the
interactive range selector button, changing a data range, etc.).
The active data plot is the one that shows in the data list (bottom of the Data menu) with a check mark next
to it. If the active graph layer contains a plot group, the default behavior is to make the first plot in the group
the active data plot (note the "g1" beside each range in the following image, indicating that all are members of
plot group 1). You can activate a different plot by clicking on another of the data plots listed at the bottom of
the Data menu. Subsequently, when you open an analysis dialog box, this newly-selected plot will be listed as
your input data.
304
Data Analysis
However, for most purposes, you can ignore the data list and select your plot data directly in the graph
window or using the Object Manager:
• If your data plots are part of a plot group, select the entire group by pressing SHIFT + clicking on a plot.
Alternately, click on the group icon in the Object Manager. Either will set Input Range to all plots in the
group.
• To select just a single plot -- whether it be an independent plot or part of a group -- click once on the plot.
Alternately, click on the plot icon in the Object Manager. Either will set Input Range to only the selected
plot.
305
UserGuide_2022b
You can also indicate the active dataset by placing a red box around the plot's legend
entry. In the case of grouped plots, the red box shows on the first plot in the group.
• Click on your graph window, select Format: Page..., click on the Legends/Titles
tab and enable or clear the Indicate Active Dataset box.
• Select the graph legend, then right-click on it and choose Legend, then
select/deselect the Indicate Active Dataset menu entry.
• Select the graph legend, then right-click on it and choose Legend: Update
Legend and enable or clear the Indicate Active Dataset box.
You can adjust data range using the Rows controls under the Input Data branch of most analysis dialogs. If
you have an analysis dialog box open:
1. Click on an axis then click the Mini Toolbar Axis Scale button to open the Axis Scale dialog box.
306
Data Analysis
As you can see, the customized scale range of X axis on the graph has been used to specify the input data
range for your analysis (Rows = By X).
You can graphically select a range of data using the Regional Data Selector tool:
307
UserGuide_2022b
1. With a graph window active, click and hold on the Regional Data Selector button on the Tools
toolbar, and then choose either the Selection on Active Plot or Selection on All Plots button.
2. Drag out a rectangle or freehand object to select an area of the plot(s). Note that you can press Space to
When you make your selection, Data Markers are placed on the graph to mark the selected range(s). You can
now use Origin's analysis tools (e.g., Linear Fit) to perform an analysis on the selection, but note that some
analysis dialog boxes do not work on multiple data ranges. The smoothing dialog box, for example, (Analysis:
Signal Processing: Smooth...) will only smooth data in the active dataset or a single, selected plot.
There is a new Mini Toolbar for controlling X scale range when using Data Markers.
Click on a Data Marker and use the buttons to Set Display Range or Reset to Full
Range.
308
Data Analysis
and choose Reselect All Data from Graph. The dialog will roll up. Drag out a
rectangle in graph again to make your selection and then click the button at
the right end of the rolled up dialog box. The new data selection will show in Input
Data branch.
8. Accept default Linear Fit settings and press OK to close the dialog. Linear fitting
will be performed on all three curves over the selected range.
In addition to the data selection and data masking methods discussed in this
section, Origin offers data filtering and data reduction tools. Please visit the linked
pages for details.
• To modify a data range, right-click a data marker and choose Edit; or double-click on the data marker.
The red marker changes to a dark color with arrows on both ends and the cursor changes into a cross-hair.
Drag the beginning or ending marker to a new position or use one of the keyboard shortcuts listed below
and modify the data range. To escape edit mode, double-click on the marker or press the Enter key.
• There are other options when right-clicking the data marker such as Delete Marker, Delete Data, etc..
309
UserGuide_2022b
Note: If you use the Regional Data Selector to place markers on multiple plots (Selection on All
Plots), be aware that moving markers will affect the data range of the active plot only; the ranges of other
selected plots will not follow that of the active plot. This is a limitation of the Regional Data Selector.
Alternately, you can use these keyboard shortcuts to select and edit data markers:
s Select the first pair of data markers on the graph (those marked with "1").
Select the next pair of data markers (not in edit mode) or the other data
Tab
marker of the pair (in marker edit mode).
2. ... then activate and edit the data marker using these key combinations:
Activate the selected data marker for editing. (Press Enter again to exit
Enter
data selection mode.)
Arrow Move the active data marker exactly one data point.
Ctrl/Shift + Arrow Move the active data marker multiple data points.
310
Data Analysis
• Data Markers define a sub-range that you select using the Data Selector tool.
If you want to remove the data markers from a graph, you can select Data: Clear Data Markers from
the main menu, or click the Clear Data Markers button on the Markers and Locks toolbar.
• When the analysis routine is completed, Data Markers are replaced with Analysis Markers. By default,
Analysis Markers will not show if the analysis is done on the entire dataset. If performed on a subrange,
Analysis Markers will show at the beginning and end of that subrange. To modify the data range and rerun
your analysis, you must right-click an analysis marker and choose Change Parameters.... Change the
Input Data range and rerun the analysis.
311
UserGuide_2022b
Note:
1. If you set Recalculate to None in the analysis dialog box, then no analysis markers are
generated.
2. Data markers and analysis markers are not exported when you choose File: Export Graphs.
3. To select the exact same range again for another analysis, click the green lock and choose Plot
Input Data with Data Markers to create a new graph and do analysis on it.
4. There is a Markers and Locks toolbar to control analysis markers and locks, such as Marker
Hide Show to toggle analysis markers on or off, etc. There is also an Analysis Markers
submenu, available from the Data menu; or when you right-click on an analysis marker or green
lock and choose Analysis Markers.
You can also pick the data points in the graph using the Pick Data Points tool. This works best for scatter or
line + symbol plots of smaller datasets.
1. Select Data: Pick Data Points. The Pick Points dialog will pop up.
2. With the square cross-hair, you can read the coordinate of current data points in the Pick Points dialog
(also the Data Source). Double-click on the point you want to pick until the cross-hair cursor became
round, the actual X&Y values will be recorded and the total number of picked points will be counted up.
312
Data Analysis
3. Once you finished the picking, click the Done button to output the results to a new workbook.
In some cases, the Data Highlighter on the Tools toolbar, can be useful for selecting some portion of your
data for further analysis. For instance, you have a 2D scatter plot and you are interested in data points in a
particular region of the graph.
You now have a secondary worksheet named as wcopyN, that contains only the data points that you selected
in the graph.
Output can be directed to various places -- a range of worksheet cells or columns, or possibly to a worksheet,
a workbook, a matrixsheet, or a graph layer. Output options depend upon the target object as well as the type
of window that was active when the tool was opened. You can determine your output target by:
313
UserGuide_2022b
• Typing directly in the associated text box, using a standard range notation
This being an introductory manual, we will stick with the simplest to use -- using predefined range strings.
For information on other options, follow the links above.
Referring to the image above, note that range strings are enclosed by < > characters. Valid strings will differ
from dialog to dialog (e.g. <source> is available from the Book list under the Output Fitted Values To
branch of the Fit Linear dialog, but it is not used to specify Output in the Smooth dialog).
You can type these strings directly into the edit box but the easiest thing to do is to just select them from the
flyout menu (options will vary by tool). Alternately, you can click the Custom button and open the Range
String Builder. Despite the intimidating name, it is just a way to step through the process of specifying your
output target. For more information on range strings and Range String Builder, see Output Results in the
Origin Help file.
• When data exist in both the worksheet and the graph, masking data in one will mask (and mark) the
corresponding data in the other.
• When data are selected in the worksheet, a Mini Toolbar Mask Data button becomes available.
The active worksheet's Masked and/or Unmasked Data Count can be reported to the
Status Bar.
314
Data Analysis
These toolbar buttons are used to mask and manipulate masking of selected data. Note that this includes
graphs, once data have been selected (see the next section on Tools toolbar buttons for graph selection).
Toolbar
Action Shortcut Command Notes
Button
There was a change made to the default masking mode, starting with Origin 2021:
315
UserGuide_2022b
1. Choose Data: Mask Data Points from the main menu or click the Mask Points on Active Plot button or
Mask Points on All Plots button on the Tools toolbar, then hover on the graph.
2. To mask a single point, double click on the point. To mask a region of points, press the Space bar to
toggle among masking by row index number, by rectangular region or by freehand region (differences
explained below), then drag out a region.
3. Once data are masked in the graph, you can use the Mask toolbar buttons, described above.
Mask data points by rectangular region. Only the data points inside
the rectangle that you drag out, will be masked.
Mask data points by freehand region. Only the data points inside
the region that you drag out, will be masked.
Mask data points by row index number. All data points between the
lowest and highest selected index numbers are masked regardless
of whether they lie inside your rectangle.
1. Choose either the Unmask Points on the Active Plot tool or the Unmask Points on All Plots of
drag to unmask your data points. The tool will be active until press ESC or click the Pointer tool.
When worksheet data are selected -- cells or entire columns -- A Mini Toolbar Mask Data button
becomes available. The button works as a toggle to mask or unmask data within the selection.
There is a tool for masking worksheet data values by condition (e.g. <= 0).
1. With the data selected (cells or one or more columns), choose Column: Mask Cells by Condition. This
opens the colmask dialog.
2. Choose your Condition and Value, plus other options as needed and click OK.
316
Data Analysis
15.5 Mathematics
Origin provides a number of mathematics tools to perform basic calculations, interpolation, and area or volume
calculations.
15.5.1Basic Math
• Simple Column
Math/Simple Curve
Math
• Perform basic calculations
• Normalize
on worksheet columns or Analysis:Mathematics
Columns/Curves
XY data plots (workbook, graph)
• Average Multiple
Curves
• Differentiate
• Perform element-wise
• Simple Math Analysis:Mathematics
arithmetic on two matrices.
(matrix)
317
UserGuide_2022b
• Use a Gadget to
• Vertical Translate graphically translate
Analysis:Data Manipulation
• Horizontal Translate curve(s) in vertical or
(graph)
horizontal.
• Perform differentiation
• Differentiate Gadget over a region of interest in Gadgets:Differentiate...
a graph (graph)
• Use formulae to
• Set Column Values set/transform worksheet Analysis:Mathematics
column values (workbook)
318
Data Analysis
15.5.2Interpolation
• Perform interpolation
• Interpolate Gadget over a region of Gadgets:Interpolate...
interest (graph)
• Perform
interpolation/extrapola
tion on a group of XY
• Interpolate/Extrapolate
data.
• XYZ Trace Interpolation(3D
• Perform periodic
Graph) Analysis:Mathematics
interpolation on XYZ
• Trace Interpolation(2D (workbook, graph)
worksheet data
Graph)
• Perform interpolation
on cycle or periodic
curves
• Perform
interpolation/extrapola
tion on a group of XY
data to find Y at given
X values.
• Perform 2D
• Interpolate/Extrapolate Y
interpolation on a
from X Analysis:Mathematics
group of XYZ data to
• 3D Interpolation (workbook)
find Z at given XY
values w/ choice of 8
methods.
• Perform interpolation
with a 3D function on
XYZ dataset.
• Perform 2D
• 2D Interpolate/Extrapolate interpolation/extrapola Analysis:Mathematics
(matrix, graph from
tion for a matrix matrix)
319
UserGuide_2022b
15.5.3Area/Volume Calculation
• Perform integration on
• Integrate(2D Graph)
input data
• Polygon Area(2D
• Calculate the area of
Graph)
enclosed plot regions
Analysis:Mathematics
• XYZ Surface Area (workbook, graph)
• Calculate the area of the
(3D Graph)
XYZ surface
• 2D Volume Integrate
• Calculate the volume
Analysis:Mathematics: 2D
beneath the matrix surface Volume Integrate (matrix, 3D
from zero plane graph from matrix)
• Matrix Surface Area or
• Calculate the area of the Analysis:Mathematics:
matrix surface Matrix Surface Area (matrix,
3D graph from matrix)
A number of free Apps designed for various curve-fitting operations are available from
the OriginLab File Exchange. To find and install these Apps click Analysis: Fitting:
Find Apps. The App Center will open, displaying only fitting-related Apps. Browse
available Apps and click the Download and Install button to install an App.
320
Data Analysis
• Use named range values as fitting function parameters, X "From" and "To" values,
lower and upper bounds and initial parameter values in the nonlinear curve fitter
(NLFit).
• Better auto initialization of parameters that are not assigned a specific value.
• For User Defined functions, support EMF or SVG image of Formula (Equation) to
display in lower panel of NLFit or Fitting Function Organizer.
1. Create the EMF/SVG using an equation editor (hint: Origin's LaTeX App can convert a
user-defined fitting function into a LaTeX equation object).
2. Name the EMG/SVG image just as you named the user-defined fitting function (e.g.
MyFunction.SVG) and place in \User Files\fitfunc.
321
UserGuide_2022b
Most curve fitting and peak finding analyses add an optional Result Table with equation,
weighting, slope, intercept, etc., to the active graph. Origin 2022b adds a Mini Toolbar
button for adjusting displayed digits in the Result Table.
Linear and polynomial fitting can be performed on worksheet data or data plots in a graph. Linear Fit on
Matrix Stack is performed on a series of matrix objects.
You can perform nonlinear curve fitting using one of many built-in fitting functions, or you can create a user-
defined fitting function. OriginPro supports implicit function fitting, surface fitting, and fit comparison. Some
tools are available only in OriginPro.
322
Data Analysis
functions
Analysis:Fitting:Nonlinear
• Fit data from a matrix or
• Surface Fit Surface Fit (workbook, graph)
worksheet XYZ columns or
Analysis:Nonlinear Matrix
Fit (matrix)
323
UserGuide_2022b
Origin provides several tools for peak analysis. With these tools, you can define and subtract baselines, find
peaks, integrate peaks, and fit peaks. Some tools are available only in OriginPro.
324
Data Analysis
Note that a number of free Apps designed for peak analysis are available from the OriginLab File Exchange. To
find and install these Apps click Analysis: Peaks and Baseline: Find Apps. The App Center will open,
displaying only peak-fitting related Apps. Browse available Apps and click the Download and Install button
to install an App.
The table below summarizes various built-in tools available for peak analysis:
• Create baseline
• Integrate peaks
• Fit peaks
• Create baseline
• Subtract baseline
• Find peaks
• Integrate peaks
characteristics
325
UserGuide_2022b
You may refer to the tables below for the signal processing tools and their menu entry.
15.8.1Signal Transforms
• FFT Gadget
Gadgets:FFT... (graph)
• 2D FFT
15.8.2Filtering
326
Data Analysis
15.8.3Smoothing
15.8.4Correlation
15.8.5Convolution
• Convolution Analysis:Signal
Processing:Convolution (workbook,
graph)
327
UserGuide_2022b
• Smoothing
• Noise Removal
• 2D Wavelet Decomposition
Analysis:Signal Processing:Wavelet
• 2D Wavelet Reconstruction
Analysis (matrix)
328
Data Analysis
• Image:Adjustments
• Image:Arithmetic Transforms
• Image:Conversion
• Image:Geometric Transforms
• Image:Spatial Filters
• Linear/Polynomial Regression
• Signal Processing
329
16 Statistics
Origin 2016 introduced add-on tools called Apps. Since being introduced, a number of statistics-related
graphing and analysis Apps have been added to OriginLab's File Exchange and more tools are being released
all the time.
A few Apps are installed with your Origin software. Note that as of the fall of 2019, all Apps are available at no
extra cost and they are easily added to Origin. Click Statistics: Find Apps. This opens the App Center to
show only statistics-related Apps. Browse available Apps and click the Download and Install button to
install an App.
Origin includes a pre-installed App called Stats Advisor. This App uses an interactive "wizard" interface to
help you choose appropriate statistical tests and to tell you where to find them in your Origin software, or -- if
the test is available from another add-on App -- where to find it on the OriginLab File Exchange.
331
UserGuide_2022b
Many of Origin's advanced statistical tests are available only in OriginPro. Users of
standard Origin will see these Pro-only tests marked as (Pro) in the main menu. If you
own the standard version of Origin but find that you need features of OriginPro, you can
upgrade by contacting your Origin representative.
If you wish to continue using standard Origin without seeing (Pro) menu commands, click
Preferences: System Variables and enter the following in the Set System Variables
dialog box and click OK (Comment is optional):
• Statistics on Columns
Statistics:Descriptive Statistics
332
Statistics
• Discrete Frequency
• Frequency Counts
Statistics:Descriptive Statistics
• 2D Frequency Counts/Binning
Distribution
• Distribution Fit
Relationship
• Correlation Coefficient
Detecting Outliers
• Grubbs Test
333
UserGuide_2022b
Origin provides a couple of gadgets to explore and summarize data plotted in graphs.
• Cluster Gadget
Gadgets:Cluster...
Gadgets:Statistics...
• Statistics Gadget
With Origin 2022b the Statistics Gadget
supports custom labeling of the ROI Box.
Origin provides some quick ways to obtain basic statistics on a selected range of worksheet cells, or data plot(s)
in a graph.
Select a range of cells in a worksheet. Note that the selection can include cells from one or more columns, and
you can use the CTRL key to select non-contiguous groups of cells.
Basic statistics (average, sum, count, min, max) for your selected data will be displayed in the status bar.
Right click on the status bar to customize what quantities to display.
334
Statistics
1. Select a range of cells in a worksheet, or click and select a group of data plots or an individual data plot in
a graph.
2. Open the Command Window or the Script Window from the Windows menu, and type one of these
commands, then press ENTER:
stats
moments
quantiles
With the Command Window, the results are typed out below the command line. With the Script Window, you
will need to issue an additional command to return your results:
stats;
335
UserGuide_2022b
stats.=;
Origin provides numerous statistical graph types. All graphs can be easily customized and saved as a template
for repeat use. View the Graphing and Customizing Graphs chapters of this guide for more information.
Plot Menu
Graph Type
Category
Box Charts: Box, Interval Plot, Bar Charts, Box Overlap, Box Normal, Half
Box, Bar Overlap, Bar Normal, Scatter Interval, Double-Y Box, Marginal Box Statistical
Charts.
Box Charts, Violin Plots, etc., Grouped: Grouped Scatter - Indexed Data,
Grouped Box Charts - Indexed Data, Grouped Box Charts - Raw Data, Grouped
Column Scatter - Indexed Data, Grouped Interval Plot - Indexed Data, Categorical
Grouped Mean Bar - Indexed Data, Grouped Violin - Indexed Data, Grouped
Half Violin - Indexed Data, Grouped Half Box - Indexed Data.
Violin Plots: Violin Plot, Violin with Box, Violin with Point, Violin with Quartile,
Statistical
Violin with Stick, Split Violin, Half Violin.
336
Statistics
Plot Menu
Graph Type
Category
Pareto and QC Chart: Pareto Chart - Binned Data, Pareto Chart - Raw Data,
Statistical
QC (X-bar R) Chart.
Trellis Plot: Trellis Plot, Double-Y Trellis Plot, Double-Y Trellis Plot Categorical
The following statistical graphs are only available within the Plots branch of the statistical analysis dialogs.
• Means Plot
Statistics: ANOVA: One-Way ANOVA, Two-Way ANOVA
• Means Comparison
Plot
Statistics: ANOVA: One-Way Repeated Measure ANOVA
• Survival Curve
• Scree Plot
• Dendrogram
Statistics: Multivariate Analysis: Hierarchical Cluster Analysis
337
UserGuide_2022b
• Classification
Summary Plot
• Classification Fit
Plot Statistics: Multivariate Analysis: Discriminant Analysis
• Canonical Score
Plot
• ROC Curve
Statistics: ROC Curve
• One-Sample t-Test
• Two-Sample t-Test
• Pair-Sample t-Test
Variance
• One-Sample Proportion
Test
Test
• Two-Sample t-Test on
Rows
Rows
338
Statistics
16.4.2ANOVA
• One-Way ANOVA
• Two-Way ANOVA
• Three-Way ANOVA
16.4.3Non-parametric Tests
• Mann-Whitney Test
• Friedman ANOVA
Notes:
• (NPH) Paired Samples: Paired-Sample Wilcoxon Signed Rank Test and Paired-Sample Sign Test
339
UserGuide_2022b
16.5.1Multivariate Analysis
Origin offers several multivariate analysis methods to help you simplify, classify, or make predictions from
your data.
• K-Means Cluster
• Hierarchical Cluster
Notes: Canonical Discriminant Analysis is integrated with Discriminant Analysis. It is accessible from the
Statistics:Multivariate Analysis:Discriminant Analysis: Canonical Discriminant Analysis(System)
menu.
16.5.2Survival Analysis
Statistics, Power and Sample Size Origin provides eight types of power and sample size analysis, useful in
designing experiments. Origin can compute the power of the experiment for a given sample size and can also
compute the required sample size for given power values.
340
Statistics
• One-Proportion Test
• Two-Proportion Test
• One-Sample t-Test
• Two-Sample t-Test
• Two-Variance Test
• One-Way ANOVA
16.5.4ROC Curve
ROC Curve analysis is useful in determining if an incident has occurred, or in comparing the accuracy of two
methods that are used to discriminate between diseased and healthy cases.
• ROC Curve
Statistics: ROC Curve
• Descriptive Statistics
• Normality Testing
• Distribution Fit
• ANOVA
• Nonparametric Tests
• Multivariate Analysis
• Survival Analysis
• ROC Curves
341
17 How to Handle Repetitive Tasks
Analysis operations, such as those performed with the tools listed in the Analysis chapter or in the Statistics
chapter, create detailed Analysis Report Sheets.
• Analysis Report Sheets contain tables that are organized in a tree structure.
• Tables are not static reports. They are constructed using placeholders linked to particular analysis results
and thus, results can be recalculated with changes to input or analysis parameters.
• You can add comments to the sheet or copy tables and paste or paste-link them to other windows in your
project.
• Analysis Report Sheets often contain embedded graphs such as fit curves or residual plots. To customize
these plots, double-click on them. This opens the embedded graph in a separate window where -- as with
any Origin graph -- you can customize it using Mini Toolbar buttons or Plot Details controls. When you are
done customizing, click the Close button and re-insert the customized graph back into the report
sheet.
343
UserGuide_2022b
For more information on Analysis Report Sheets, see the Origin Help File.
17.2 Recalculation
All Analysis and most data processing dialog boxes in Origin include a Recalculate control. This control
allows you to tie output operations to the source data. When Recalculate is set to Auto or Manual, changes to
the source data will trigger an update of the output (pending, in the case of Manual). This allows you to
analyze multiple datasets by, for instance, serial import of a new data file to replace existing data. This feature
is also the basis for creating Analysis Templates. The Analysis Template concept is explained below.
None • Changes to the input data will not result in an update of the output.
• An auto green lock displays on the output columns and graphs of the output data.
The main operation lock displays on the left-most column as , while any related
operations columns to right of the main operation display the "+" icon .
Auto • The output will be automatically updated when input data is changed.
• You can also click on a lock icon and open the dialog to make changes to the analysis
settings, including changing the Recalculate mode.
344
How to Handle Repetitive Tasks
• A manual green lock is displayed in up-to-date output columns, and graphs that
contain plots of the output data. Any related operations columns to right of the main
operation display the "+" icon .
• A yellow lock indicates that input data have changed and recalculation operations
are pending. You can trigger updates individually by clicking on a yellow lock and
Manual selecting Recalculate from the shortcut menu; or you can update all pending
• You can also click on a lock icon and open the dialog to make changes to the analysis
settings, including changing the Recalculate mode.
• A left-click on the lock displays a menu that provides multiple options including changing analysis
parameters, opening source data sheet, switching to result sheets, and controlling the status of the
operation such as switching from manual update to auto update.
• The Standard toolbar displays a Recalculate button that shows green when all project operations
are up-to-date and yellow when there are recalculation operations pending. If you have opened a
project and you see that the Recalculate button is yellow, understand that calculations are pending and
that the data and data plots you see in the project may not be up-to-date.
• If a lock icon appears dark gray in color , this indicates that the associated operation was performed in
OriginPro and the window or project has been opened in standard Origin. The operation is not supported
by standard Origin and to modify or re-run the analysis, you will need to locate a computer with an
OriginPro license.
• If a lock icon appears red something has occurred which makes recalculation operations impossible.
Such conditions are rare but would occur if, for instance, you passed a project file that included a user-
defined curve fitting operation to a colleague but failed to pass along your user-defined fitting function.
• Having many recalculation operations in your project file can slow down your work. You can block
recalculation -- both Manual and Auto recalculation -- by clicking on a lock icon and choosing Block
Recalculation from the popup menu. Placing a block on pending recalculations places a yellow "block"
icon on each associated operation in the chain. Placing a block on up-to-date calculations places a
green "block" icon on each operation in the chain. To remove the block, click on the "block" icon and
clear the check mark (Note that clicking the yellow Recalculate button on the Standard toolbar does
not update blocked operations).
• To suspend all recalculation, press Ctrl+0, choose Analysis: Pause Auto Recalculate (worksheet only)
• You can hide the lock icons on your graph window by clicking on the graph and, from the main menu,
choosing View: Show and clearing the check mark beside Lock Icons. This does not remove associated
operations from the graph window. To re-display the icons, repeat the procedure.
345
UserGuide_2022b
Pause Auto Recalculate using hotkey Ctrl+0. Menu command also added to the
Analysis menu when a worksheet is active.
Last used dialog box settings are automatically saved as a <last used> Theme. Origin also allows you to save
your custom settings as the <default> Theme. The default Theme, last used Theme, and any named Theme
that you have saved, can all be accessed from the Dialog Theme fly-out menu that opens from the dialog box.
The same Themes are also available from the main menu item associated with the analysis dialog box.
Dialog Themes are managed with the Theme Organizer tool, available from the Tools menu.
1. Import the file Linear Fit.dat from the Samples\Curve Fitting\ subfolder.
2. Highlight column B and select Analysis: Fitting: Linear Fit...
3. In the Linear Fit dialog that opens, check the Fix Intercept checkbox (under Fit
Options) and set the Fix Intercept at edit box to 0.
4. Click the button next to the Dialog Theme control and select Save as .... In
346
How to Handle Repetitive Tasks
the Theme Name box, enter Zero Intercept and press OK. Press OK again to
close the Linear Fit dialog box and perform the analysis. FitLinear1 and
FitLinearCurve1 result sheets are added to the workbook.
5. Return to the source data and highlight column C. Select Analysis: Fitting:
Linear Fit from the menu. You will see a fly-out menu with multiple Theme options
including the Zero Intercept Theme you saved in the previous step.
6. Select your saved Theme. The analysis is automatically performed on Column C
using the settings saved in the Theme. Note that the dialog box does not open.
• Hold the SHIFT key while clicking on your Theme in the main menu and the
associated dialog box will open with settings from the selected Theme loaded into
the dialog box.
• The default Theme Origin shipped for an analysis is called System Default. Click
the fly-out menu in the analysis dialog and choose System Default to load it.
• Click the fly-out menu in the analysis dialog and choose Delete to delete Themes
you have created, including any customized <default> Theme.
• The customized <default> Themes for all analysis dialogs are saved in
Defaults.xml in the User Files Folder. Deleting this file restores system default
settings of all analysis dialogs.
• You might import data files that always have a fixed number of columns with a repeating pattern of
column designations (e.g. XYyError, XYyError, etc.) so you create a custom workbook just for importing
these files (File: Save Template As).
• You regularly import data files of similar structure and you perform some routine graphing and analysis
operations on the data, then generate a report using a worksheet or a workbook embedded Notes window.
This would be a typical example of an Analysis Template (File: Save Workbook As Analysis Template).
• You perform some operations similar to those described in the previous example but you can't save your
workbook as an Analysis Template because all data are cleared from the workbook on saving and that
would destroy a sheet of reference values that you rely on for your analysis. Instead, you could opt to
clear only the imported data and save your workbook as a window file (File: Save Window As). This
preserves the sheet of reference data and like the Analysis Template, saves analysis and graphing
operations with the workbook.
• You routinely import data, do some analysis and generate a report and would like to make use of the
Analysis Template concept (as in the second bullet point), but you have multiple windows in your project,
including Layout windows that cannot be embedded in the workbook. So, a single workbook Analysis
347
UserGuide_2022b
Template won't do the job. In this case, you could save the project without data by "cloning" it (File:
Clone current Project).
The workbook can contain worksheets with data, metadata, floating or embedded graphs, embedded matrices
and notes, plus scripts, variables and other supporting data.
You can save a workbook as a template for repetitive graphing and/or analysis tasks. Depending on your
needs, there are three options for saving your workbooks -- as a workbook (OGWU), as a template (OTWU)
or as an Analysis Template (OGWU):
• Workbook (OGWU): Choosing File: Save Window As saves all workbook content.
• Analysis Template (OGWU): Choosing File: Save Workbook as Analysis Template clears all data
columns that are used in analysis operations in the workbook before saving. Operations are preserved as
are data that are not associated with analysis operations.
• Template (OTWU): Choosing File: Save Template As saves the structure of the workbook, plus any
analysis operations that exist in the workbook, but all data including data that are not associated with
these analysis operations, are cleared.
The New Book dialog is a template library for managing workbook, matrixbook and
Analysis Templates. See Workbooks for an overview of dialog box features.
348
How to Handle Repetitive Tasks
Analysis Templates can include summary sheets and custom report sheets (worksheet-based or HTML),
making them an ideal medium for importing, analyzing, plotting and reporting the results of your routine
analyses. When used in combination with the the Batch Processing tool, you can repeat a set of analyses
and graphing operations for any number of data files and create a PDF summary report for each one, as it is
processed. View the Batch Plotting and Batch Analysis sections of this chapter for examples of using the
workbook as a template for handling repetitive tasks.
Notes windows now support HTML. Notes windows can be added to the workbook
(right-click on sheet tab and Add Notes as Sheet) making it easy to incorporate HTML
reports into your Analysis Templates. For more information, see HTML Reports
From Notes Windows.
The Origin project file can also be used as a "template" for carrying out repetitive graphing and analysis tasks
-- particularly when your analyses and graphing tasks can't be resolved within a single workbook.
1. Create the desired graphs and/or analysis results from data in your workbook(s) and save the project.
2. After saving the project, choose File: Clone current Project. A small dialog opens for configuring
your cloned project:
o Add Data Connectors: Check this box to add Data Connectors from the cloned project to your
saved project. Each cloned worksheet will have a connection to the original worksheet in the
saved project. If you plan to import data from other similar files in your cloned project, you
should CLEAR this box.
o Clear All: Clear imported data only. Analysis operations are preserved in the cloned project.
o Clear Imported Data and Delete Calculations: Clears imported data and analysis operations.
349
UserGuide_2022b
3. Click OK to create your cloned project. Selected data are cleared and the cloned project named UNTITLED
is added to the workspace.
4. Name and save the cloned project and when you are ready to process more data files, you can open it and
import new data:
o If your analysis and graphing operations are linked to a particular set of data files that are
periodically updated, you don't necessarily need to use Connectors. You can simply re-import the
files (Data: Re-import... or Re-import Directly).
o If your operations are linked using Data Connectors, click the Connector icon and from the
popup menu choose Import (this Connector only) or Import All (all Connectors in the book).
o One possible scenario is that you store all of your data in a single Origin project file. If you have
added Data Connectors from your cloned project, to your original project then you can selectively
import just the data that you need to perform your graphing and analysis operations. When you
have finished, you can save the file to a new name, preserving your cloned project for re-use.
A new Match X by Offset check box is added to the Set Column Offset dialog, for
handling batch plotting of graphs that use multiple X columns (e.g. Sunburst plot).
If you have several workbooks, worksheets or columns with similar data structure as you the data used to plot
the graph, you can have Origin clone that graph via Window: Duplicate (Batch Plotting) menu with new
data. There are two cases:
• If you have plotted a graph with a single dataset and customized it, and want to clone the graph with
other data in the same worksheet: Choose Window: Duplicate (Batch Plotting): Duplicate with New
Columns. Pick other data (columns) that you want to plot. Each column will be plotted as a new graph.
• If you have plotted a graph with data in one worksheet or workbook and customized the graph, and you
want to clone the graph with other worksheets or workbooks with a similar data structure: Choose
Window: Duplicate (Batch Plotting): Duplicate with New Sheets/Duplicate with New Books.
Origin will list all worksheets or workbooks with a similar data structure. Pick the worksheet or workbook
you want to plot from. Each worksheet or workbook will be plotted as a new graph.
350
How to Handle Repetitive Tasks
2. Press the Import Wizard button on the same toolbar. This opens the Import
Wizard dialog box.
3. Click the browse button to the right of the File box. Browse to the Import
and Export folder and select the files S15-125-03.dat, S21-235-07.dat, and
S32-014-04.dat. Click Add File(s), then press OK. In the Import Wizard dialog
box, press Finish. The files are imported into three separate workbooks.
4. Drag and select all three Y columns in one of the workbooks, then select the menu
item Plot>2D: Multi-Y: 3Ys Y-YY to create a graph with multiple Y axes and one
shared X axis. Make any desired customizations to the graph.
5. Right-click on the title bar of the graph window then select Duplicate (Batch
Plotting) shortcut menu.
6. In the dialog box that opens, press Ctrl and select the other two
workbooks/worksheets then press OK. Two more graphs are created with data
from the other two workbooks/worksheets.
If you want to plot graphs from many data files but don't want to import all files to workbooks before plotting,
you can import one file, create the desired graph(s) based on that data, then add the graph(s) to your
workbook and save the workbook as a template. Using this template you can process multiple files, creating a
workbook for each file and its corresponding graph.
1. With a new workbook active, choose Data: Import From File: Single ASCII and
import the file Sensor01.dat from the Samples\Curve Fitting subfolder of the
Origin installation folder.
2. Highlight column B and create a line+symbol graph of the data.
3. Double click on the X axis to open the Axis dialog. Make sure Scale tab is active.
Select both Horizontal and Vertical on the left panel and set Rescale to be Auto
and click OK. This will ensure that the graph scale will update automatically on
data change.
4. In the workbook, right-click on the worksheet tab and select Add Graph as
Sheet, then select the graph created above and click Done. This will add a new
workbook sheet containing an embedded graph.
5. Switch to the data sheet, double-click on the tab rename the sheet as Data.
6. Select the Worksheet: Clear Worksheet menu item to clear the data in this
sheet. Note that this step is optional. Clearing the data will reduce the size of the
template saved in the next step.
7. Select the File: Save Window As... menu item, assign a name such as Sensor
Data and Graph and press Save.
8. Now we can use this template to process multiple files. Select the File: Batch
351
UserGuide_2022b
If processing of your data requires some custom import settings, those settings will be
saved to the data sheet by default. Settings thus saved to the sheet will be used for
import when batch processing of multiple files using the workbook as a template.
Some analysis dialog boxes, for instance Linear Fit and Nonlinear Fit, support analysis of multiple datasets.
Report sheets created by these dialog boxes include a summary table listing the parameter values for each
dataset and other pertinent results such as goodness-of-fit indicators. The summary table can be copied to an
external sheet for further processing.
352
How to Handle Repetitive Tasks
In the NLFit report sheet, click on the downward-pointing arrow button next to the
table named Summary and select Create Copy as New Sheet. This will create a copy
of the table in which all cells are linked to the report. Any updates/changes to the fit
will automatically update the values in this copied sheet. This sheet can then be used to
plot or to perform secondary analysis on the fit parameters.
When enumerating something like a column Long Name, as you did in step 2 above,
enter the string in the first cell (e.g. "Peak 1"), select the cell and hover over the lower-
right corner. When the cursor becomes a "+", drag across the other cells and the
contents of the first cell will be extended to those cells.
Origin includes several gadgets for performing interactive analysis on plotted data. Gadgets allow selecting a
data range of interest, switching from one dataset to another, and setting various preferences specific to the
analysis being carried out.
Most gadgets offer an option to perform the analysis on all data plots in the current layer, or all data plots in
the graph page. This allows for performing repetitive analysis on multiple datasets using the same settings,
and generating a table of results across all datasets.
6. Click the arrow button at the top right of the ROI object, then choose Change Data
from the context menu and switch to another plot in the layer. Check that the current
baseline setting works for other curves in the layer.
7. Click the arrow button , select New Output for All Curves (N) or simply press the
"N" key. Integration is performed on all curves.
8. Click the arrow button again and select Go to Report Worksheet. Expand the
353
UserGuide_2022b
The Batch Processing tool allows you to process multiple files or datasets using an Analysis Template.
Simply perform the analysis on one of the files, include all desired results and report sheets in one workbook,
and save that workbook as an Analysis Template. The Batch Processing tool then uses the Analysis Template
to process multiple files/datasets. You have the option to retain one workbook for each file/dataset, and
additionally, to create a summary table with select analysis parameters and other metadata that you have pre-
configured in your analysis template.
• If the Analysis Template is set up to import multiple files into the same
sheet, Batch Processing will now import all selected files to new columns
354
How to Handle Repetitive Tasks
1. From the main menu, choose File: Batch Processing.... This opens the Batch
Processing dialog box.
2. Set Batch Processing Mode to Load Analysis Template.
3. Press the browse button to the right of the Analysis Template box and
browse to and select the file <Origin Program Folder>\Samples\Batch
Processing\Sensor Analysis.OGW. This Analysis Template contains multiple
sheets set up for linear regression analysis, reporting, and summary tables.
4. Set Data Source = Import From Files, then click the browse button to the
right of the File List and from the Samples\Curve Fitting folder, select files
Sensor01.dat, Sensor02.dat and Sensor03.dat .
5. Set Dataset Identifier to File Name, Data Sheet(s) to Data, and Result Sheet
to Result. Note that these are the names of existing sheets in the Analysis
Template.
6. Uncheck Delete Intermediate Workbook.
7. Click OK to close the dialog box and process the three files (you can answer "No"
to the prompt). You will obtain three books with the data, analysis results, and
report for each file, and a fourth book containing the summary table of analysis
results from all files.
355
UserGuide_2022b
Saving the initial workbook as an Analysis Template is optional. You can simply save
the Origin project (.opj) and next time replace the data in your workbook to update all
results and graphs. The Batch Processing tool also has an option to repeatedly import
files into the active window, allowing you to simply re-use an existing book within a
project (which contains all desired analysis and graphs) as an on-the-fly template for
the batch analysis.
You can batch generate analysis reports using a custom MS Word template, with the
option of outputting a PDF and/or an MS Word file for each report. Additionally, you
can opt to combine reports into a single file. For information on Batch Processing
with a Word Template for Reporting, see this tutorial.
• In worksheet columns or reports, clicking the lock will show the menu command Repeat this for All Y
columns. Selecting this will repeat the analysis on all other Y columns in the source data sheet.
• In a graph, clicking the lock will show the menu command Repeat this for All Plots. Selecting this will
repeat the analysis for all other data plots in the graph page, even if the plots are in different layers.
This is particularly useful for such analysis dialog boxes as smoothing or interpolation that support input of
only one dataset. As long as the data are contained in one worksheet or plotted in one graph, the analysis can
be repeated on all other datasets.
4. Click on the lock in the output column and select Repeat this for All Y
columns. Three more columns of smoothed data with same settings will be
generated from the data in columns C thru E.
356
How to Handle Repetitive Tasks
The lock icon placed on analysis output can be clicked on to open a menu, giving you post-analysis access to
operation parameters and other information. This includes the dialog box and parameter-set used to produce
the analysis output, opened by clicking Change Parameters.
Towards the bottom of this menu, you will see a Duplicate this Operation entry.
1. The user performs an analysis operation on a data plot, say, a fitting operation using the nonlinear curve
fitter (NLFit).
2. The user is not sure which fitting function best models her data so she tries a fit using one potential
function.
3. The user clicks the resulting operations lock and chooses Duplicate this Operation.
4. A duplicate analysis is run and a second operations lock is added to the graph window.
5. The user clicks the second operations lock, chooses Change Parameters and when the NLFit dialog
opens, chooses her alternate fitting function and performs a new fit operation. The new fit operation
results in new output which can now be compared to the output generated by a fit of the first fitting
function.
357
UserGuide_2022b
Selected columns from the source data sheet can be copied to create child sheets where the filter condition
stays synchronized with the parent sheet, or is locked to the child sheet. When the source data sheet is
updated, all child sheets, associated graphs and analysis results will automatically update using their
respective filter conditions. Additionally, the filter condition of a particular child sheet can be pushed back to
the parent sheet at any time.
The image below displays the source workbook with data for several makes of automobiles. Two books were
created with a subset of columns and a data filter to restrict the data to a particular make of automobile.
Linear regression analysis of the filtered data was performed, allowing comparison of the results across the
two filters.
358
How to Handle Repetitive Tasks
2. Click on the Make column, then click the Add/Remove Data Filter button on
the Worksheet Data toolbar.
3. Click on the filter icon that was added to the column, and uncheck all makes
but Honda (Hint: Clear the check mark beside Select All, then check Honda and
click OK).
4. Hold down the CTRL key and click and select the Make, Power and Engine
Displacement columns. Next, right-click and select Copy Columns to... from the
shortcut menu.
5. In the dialog that opens, expand Copy Labels and place a check mark beside
Long Name and Units, then click OK. A new worksheet will be added to the
workbook and it will contain only the Honda data, for Power and Engine
Displacement.
6. Click and hold the tab of the new worksheet and drag it to an empty spot in the
Origin workspace to create a separate workbook.
7. Click on any of the locks in the columns of this copied sheet, and select
359
UserGuide_2022b
Worksheet Filters: Lock. The filter conditions will be locked to this sheet. If you
change the filter condition in the original data sheet, this copied sheet will not be
affected.
8. You can now return to the original automobile book, click the filter icon and
change the filter condition to Toyota, then use Copy Columns to to create another
worksheet.
9. Highlight column B in your Honda workbook,then right-click and choose Set As: X.
Do the same for the Toyota book.
10. Highlight column C in your Honda workbook and click the Scatter button on
the 2D Graphs toolbar. Do the same for the Toyota book. This gives you two plots
of Power vs Engine Displacement, one for Honda, one for Toyota.
11. Click on the Honda graph and choose Analysis: Fitting: Linear Fit. Accept the
dialog defaults and click OK. Do the same for the Toyota graph. A linear fit is
performed for both datasets and an Analysis Report Sheet is generated for each.
12. Compare the fitting results for the two automobile makes.
By default, when there is a data filter on a column that is input for an analysis
operation, filtered data (hidden rows) are ignored in the analysis. To include hidden
rows, click on an analysis lock icon and set Ignore Hidden Rows = No.
360
How to Handle Repetitive Tasks
In addition to the above mentioned methods for automating tasks using the interface, graphing and analysis
features can also be accessed programmatically from the LabTalk scripting language, from Origin C or from
Python (internal or external). Access to Graph Themes and templates, and Analysis Templates can be
programmed. You can set up some of the procedures manually by first creating templates (graph templates,
Analysis Templates™, etc.) using the graphical user interface, and then write your code to call the templates
as needed.
You can get a broad look at what programming options are available in Origin by browsing the Programming
Chapter of this User Guide. More in-depth programming-related information is linked to from that chapter.
• Analysis Templates
361
18 Publishing and Export
363
UserGuide_2022b
To make use of this feature, you must first create your Master Page. The Master Page should contain only the
properties and objects that you want to display on your selected graph windows:
1. From the menu, choose File: New: Master Page. If you are not in the project root folder when selecting
this menu item, you will be asked to switch to the project root folder.
2. Customize the Master Template. Note that the comments that show beneath the Save Master Template
button are "hidden" and will not be applied to your graph windows.
3. Click the Save Master Template button. When you save, the Master Template will be saved to the
User Files Folder as "name of active window".otpu (e.g. "C:\Users\YourName\Documents\OriginLab\User
Files\Master.otpu").
• Master items will only show in graphs pages of the same dimensions as the template. Apply Dimension
to All Graphs applies Master Template page dimensions to all graphs of the same aspect ratio.
• If you create a graph and modify page size, then choose File: New: Master Page and load a Master
Template into the workspace, the Master Template will be loaded with the page dimensions of your
modified graph page.
• The Rotate button swaps the Master Template page dimensions (toggles orientation between landscape
and portrait).
• When you click Apply Dimension to All Graphs you are prompted to apply dimensions only to graphs of
the same aspect ratio, or to all graphs of the same orientation (portrait or landscape).
364
Publishing and Export
• Master Page items on a graph with portrait orientation will not show on a graph with landscape orientation
and vice versa.
• When NOT using Master Items, Edit: Copy Page (CTRL + J) will place an OLE-editable Origin graph
object on the Clipboard. When using Master Items, Edit: Copy Page will place an image on the Clipboard;
the Copy Graph as Image dialog will open asking you to accept or adjust image settings before clicking
Copy.
• If a graph uses Master Items, Send Graphs to PowerPoint does not support Insert Graphs as
Embedded Object. Instead, use Insert Graphs as Picture which does support Master Items.
• There is a mechanism for selectively excluding Master Items in your exported or printed page. Any object
that you do not want to appear in the exported or printed page should begin with "NoExport" (e.g. open
an arrow object's Properties dialog and on the Programming tab, rename "Arrow" to
"NoExport_Arrow").
• When you customize and save your Master Page to the User Files Folder, the next time you choose File:
New: Master Page, you load your customized template.
• If you don't want to show Master Items in the workspace, click View: Show: Master Items and remove
the check mark. The exported graph will still contain the Master Items (they just won't show in the
workspace).
• If you want to remove Master Items from a graph in both the workspace and exported images, click
Format: Page..., Display tab and clear the Use Master Items check box.
You could use the Text tool to add project and system information to your Master
Template as static text objects, but since the idea is to build a template for re-use,
consider "soft-coding" information in your text labels. To learn more, see these topics:
365
UserGuide_2022b
1. Click on the graph window (to activate) and choose Edit: Set Export Margins. This opens the Export
Margin Offsets dialog.
2. Drag the blue selection handles that appear at the page margins; or enter values into the dialog edit
boxes and click Apply.
• Fit Page to Layers: Choose Graph: Fit Page to Layers to open the pfit2l dialog box.
• Fit Layers to Page: Choose Graph: Fit Layers to Page to open the gfitp dialog box.
366
Publishing and Export
Both dialogs can be used to remove white space. Both can perform resizing, with or without changing graph
aspect ratio. You can view the documentation for both to decide which might work best for you but basically it
boils down to whether you need to keep a particular page size. If so, you'll likely want Fit Layers to Page; if
not, either one may work for you.
• As an image
When you paste as an image, you are pasting a static object. In MS Word, for instance, you may be able to
modify the image using Word's picture-editing tools, but you cannot make edits to the graph in Origin and
have it update the graph in Word (short of deleting the existing image and replacing it with a new one).
By contrast, when you paste an editable OLE graph object you can later double-click on the object in the host
application to launch a new instance of Origin. The graph and any associated data sheets will be available for
editing. After editing, use Origin's File: Exit and Return to... menu item to update the embedded object,
close Origin and return to the host application.
2. Choose Edit: Copy Graph as Image (CTRL+ALT+J). Alternately, click on the graph window near the
page margin and click the Copy Graph as Image button on the Mini Toolbar.
367
UserGuide_2022b
When copying the graph as an image (CTRL+ALT+J), you have a choice of image formats (PNG, EMF, DIB,
HTML, JPG). Additionally, you can make quick size adjustments and specify background transparency (PNG).
The Copy Graph as Image (copyimg) dialog includes a Dialog Theme control which allows repeating <Last
used> settings, saving current settings as default Save as <default> or saving settings to a named Theme
(Save As...).
There is a Copy control on the Preferences: Options: Page tab that lets you assign
the CTRL+C hotkey combination to either Copy Graph as Image <last used> or
Copy Page (CTRL+J) (i.e. "editable OLE graph object"). This allows you to bypass the
Copy Graph as Image dialog and speed up placing a standardized image on the
Clipboard using CTRL+C.
368
Publishing and Export
Help: Origin: Origin Help > Exporting and Publishing Graphs > Pasting or Embedding Graphs
in Other Applications
• Right-click on a window and choose Add Shortcuts to Favorites. This will add a shortcut to each graph
window, to a new Favorites subfolder (visible in Project Explorer).
• When sending graphs to PowerPoint or creating an Origin slideshow, you can (1) set slide order in the
corresponding dialog box or (2) set slide order following this procedure.
If you are preparing a manuscript for publication, you may want to see FAQ-441 How
do I export graphs with exact size and resolution as specified by publishers?
Origin 2022b supports export of layout pages to .SVG files. When adding graphs to
the layout, choose Add Graph from the layout shortcut menu and elements of your
SVG file (e.g. text) will be editable in applications such as Inkscape or Adobe
Illustrator.
A layout page, as the name implies, is a window useful for laying out different elements for publication or
export. Use it to assemble graphs, result tables, text objects, etc. onto a single panel.
369
UserGuide_2022b
For more on the layout page, see Using the Layout Page Window in the Origin Help file.
370
Publishing and Export
As an alternative to manually creating layouts, Origin offers a tool that will merge select graphs into a single
layout page of equal spacing. In this case, merged graphs are images and, therefore, not editable using the
procedure described in step #3 of the previous section. However, if further graph edits are not needed, you
can use this method to quickly produce a nice-looking layout.
1. With a graph window active, click Graph: Merge Graph to Layout: Open Dialog.
2. Use the Selection drop-down to specify how to select graphs. To choose individual graphs, choose
Specified and use the browse button beside Graphs to open the Graph Browser and pick graphs.
Origin 2022b adds a Fit Page to Objects menu command (Format: Fit Page to
Objects), allowing you to apply a uniform margin to the active Layout page. This works
the same as the aforementioned Fit Page to Layers does for graph windows.
Origin 2021b added a simplified graph export routine to complement the existing graph export routine:
• File: Export Graph: If you simply want to export one or two graphs to one of several common image
format (PNG, BMP, JPEG, TIFF, EMF) and need only minimal control of image size, this routine is quick and
easy.
• File: Export Graphs (Advanced): If you want to batch export graphs (e.g. All in Active Folder, All in
Project, etc.), or export to vector types such as PDF or EPS, use this routine. The dialog supports
outputting to a specified path, auto naming, application of Speed Mode settings to exported graphs, plus
margin control, image size and other filetype-specific settings.
371
UserGuide_2022b
Origin 2022b supports export of graphs and layout pages to .SVG files. Before
exporting, confirm that @SVGTC = 1 and text objects (e.g. axis titles and tick labels)
will be more-easily editable in applications such as Inkscape or Adobe Illustrator.
File: Export Graph (X-Function = expG2img) is a simplified routine for exporting the active graph page to
one of the following formats: PNG, BMP, JPEG, TIFF, or EMF. It does not offer the level of control or flexibility
as File: Export Graphs (Advanced) (next section) but it works well for simple export of individual graph
pages.
File: Export Graphs (Advanced) (X-Function = expGraph) is Origin's primary tool for exporting graphs and
layout pages. It supports raster or vector output, flexible multi-page export (e.g. All in Active Folder), DPI
and Speed Mode control and more.
372
Publishing and Export
Raster Formats BMP, GIF, JPG, PCX, PNG, TGA, PSD, TIF;
As is the case with many other Origin dialog boxes, you can save your graph export settings as a Dialog
Theme for repeat use.
• Click the flyout button to the right of Dialog Theme and choose one of the Theme save options.
• Using any group of custom settings creates a temporary default Theme called <Last used>. This Theme
then becomes available for loading your last used settings and you can access it from the expG2img or
''expGraph dialog boxes or from the File: Recent Exports menu.
373
UserGuide_2022b
Since Origin 2021, expGraph dialog box settings are saved to the graph automatically on export.
• To restore saved settings after you've modified them in the export dialog, choose <Graph>
Help: Origin: Origin Help > Exporting and Publishing Graphs > Exporting Your Graph or
Layout Page to an Image File
374
Publishing and Export
You can export multiple graphs, such as all graphs in a folder or all graphs in a project file,
to a single, multi-page PDF file. Choose File: Export Graphs and open the Export Graphs
dialog box. Set Image Type to Portable Document Format (*.pdf) and Select
Graph(s) to one of the following options and you will see a checkbox for Export as multi-
page PDF file.
375
UserGuide_2022b
For Origin 2022b, you can set a DPI for your exported image.
or...
1. Click the Send Graphs to PowerPoint icon in the Apps Gallery, docked to the right-side or your
Origin workspace (if you do not see the Apps Gallery, click View: Apps or press ALT + 9).
or...
1. Right-click in the lower-pane of Project Explorer and choose Send Graphs to PowerPoint.
clicking the in the middle of the dialog box. Click OK. A scrollable list of
graphs is added to the left panel in the App.
5. Set Insert Graph as = Picture.
6. Set the Slide Margin top dimension as 8% and leave the others as 0.
7. Set Title Line = Top of Slide, and Title = Window Long Name.
8. Set Starting Slide Index = 3 and Slide Mode = Start New.
9. Use the browse button beside Load File/Template (optional) to load the file
<Origin EXE Folder>\Samples\Import and
Export\Column_Plots_in_Sample_OPJ.pptx.
376
Publishing and Export
10. Specify a Save File as (optional) output path for the resulting PPTX file.
There is also a Send Graphs to Word App that is pre-installed with your Origin
software. This App is particularly useful for batch export of graphs to a book-marked
MS Word document.
• Right-click on any folder in Project Explorer and select Slide Show of Graphs...
or
A dialog box opens offering options to set slide order, slide cycle time, whether to include graphs in sub folders,
etc. The dialog also lists shortcut keys for use during the slide show (e.g. G = go to the actual graph window
of the currently displayed slide).
1. Use the File: Open Sample Projects: 2D and Contour Graphs menu to open
the sample project.
2. Click on the Slide Show of Graphs button in the Standard Toolbar.
3. Accept default settings in the dialog that opens, and press OK to start the slide
show.
4. You can use the up/down arrow keys or the mouse wheel to flip thru the slides.
Origin provides a Video Builder tool, accessible from the Open Video Builder button on the
Standard Toolbar. This tool can be used to manually capture a series of graph windows, and write one frame
at a time to a video (.AVI) file.
Videos can be created using LabTalk script or Origin C code, by programmatically computing or updating data
and then writing out the graph as a frame in the video, at each step during the computation.
Help: Origin: Origin Help > Exporting and Publishing Graphs > Creating Graph Animation
377
UserGuide_2022b
For specific examples of programmatically created movies, including Origin Projects and
code, please visit www.originlab.com/animation.
For Origin 2022b, the Notes window gets Rich Text support.
Over time, Origin's Notes window has morphed from a plain-text window for jotting down your research notes,
into a flexible medium for collating a variety of research-related materials.
Because the Notes window can contain linked objects -- graphs, images, worksheet cell values, etc. -- it can
be useful to add a Notes window to an Analysis Template™ for purposes of summarizing analysis results.
Alternately, you can save your Notes window as a PDF by clicking File: Print and choosing a PDF driver.
Origin's Notes window supports four syntaxes: Text, Origin Rich Text (default), HTML, and Markdown.
With Rich Text, the Notes window has two modes -- raw text mode and Render mode. Toggle between these
modes using Notes: Render Mode or shortcut key combination CTRL + M.
To add text to the Notes window, you need to be in raw text mode. To style added text, use the Format
toolbar and/or apply pre-defined paragraph styles.
378
Publishing and Export
Object Comments
Opens the Graph/Image Browser where you can pick project graphs and images.
Note that you can Show Embedded Graph (see the first row of this table for a
Graph/Image
definition of "embedded graph") and Project Explorer "Favorites" folder shortcuts
(Include Shortcut Page).
Opens the interactive range selector. Use this to pick a cell value in a worksheet or
Worksheet Cell...
report sheet. Click Done to insert a linked cell value.
Opens the Insert Variables dialog for inserting project variables stored on data
Info Variable...
import.
Opens the New Table dialog for configuring a basic table. Clicking OK closes the
dialog and opens a basic workbook containing a single worksheet. Customize the
New Table
worksheet, add data, etc., then use Notes window Render Mode to view the resulting
table.
379
UserGuide_2022b
Object Comments
Opens a simplified Symbol Map with characters sorted by tab. Click Advanced to
Symbol Map
go to the full Symbol Map.
Opens the LaTeX Equation Editor App (if you've not already installed this free App,
LaTeX Equation you are prompted to do so). You can click the Equation button to open a list of
Origin's fitting functions (incl. your user-defined functions). Pick a function (or enter a
function into the top box) and click Preview to see your equation rendered.
Opens a dialog box for entering Text to display and a Link. The link can be a URL
or it can be a link to such things as a worksheet data range (e.g.
Link
range://[book1]sheet1!col(1)[100]). Additionally, you can run simple LabTalk
commands using a "labtalk://" tag (e.g. labtalk://newsheet).
Opens a dialog to browse for image files. Note that the inserted image is linked to an
Image from File
external file and is not saved with the project.
Opens a dialog to specify a Image Link for a web image (hint: In your browser,
Image form Web
right-click on an image and Copy Image Address, Copy Image Link, etc).
press CTRL + M. Note that you can use the Zoom combo box on the Standard toolbar to
zoom in or out on the page (CTRL + mouse wheel also works).
380
Publishing and Export
In addition to styling text with the Format toolbar, you can apply a simple set of
paragraph styles on a line-by-line basis. Manage styles with the Text Styles Manager
dialog box.
381
UserGuide_2022b
Note that you can add styles by selecting <new> from the Styles to Modify drop-down list; or select a style
and Delete.
To see a list of built-in paragraph styles, open a fresh Notes window, then from the
menu choose Notes: Load Samples: Built-in Styles.txt.
382
Publishing and Export
Insert Rich Text content of a Notes window to a text object on a Layout or graph page.
1. Select the Text tool , then click on the Layout/Graph and enter "@@@NotesN" (i.e. the Notes
window Short Name).
2. Click off the text object to insert Notes content.
383
UserGuide_2022b
You can output Rich Text content to a physical printer; or print to PDF using a third-party driver such as
Microsoft Print to PDF.
• Paper Size: This is set in File: Page Setup or in the Advanced options for your printer driver.
• Notes Display Margin: By default, the Notes display margin = 5 (units = points). Thus, you will note
that in Render Mode (CTRL + M), there is a slight margin to the left side of the Notes page. This display
margin is controlled by setting system variable @NDM.
• Notes Window Page Width: Page width is controlled by the property note.width (units = in/cm, etc).
Default = 0, which corresponds to an uncontrolled width. For best printing results, you will need to set
notes.width.
Paper Size - Margins - Notes Display Margin = Width of the printed area (paper or PDF).
So, for example, an 8.5 inch wide page with 1 inch margins to the left and right; and a display margin of 0
points, should "print out" as 6.5 inches wide. Therefore, for best results, set page.width = 6.5 before
printing.
You can also use Notes windows to create HTML or Markdown reports. Similar to Rich Text, you can build your
HTML report using placeholders that link to report sheet elements such as metadata, statistical results or
graphs. The resulting HTML report can be printed or exported; or it can be incorporated into your Analysis
Template. If Markdown syntax is used, optional HTML syntax can be also included for advanced customization.
To use this feature, the user should have some basic familiarity with HTML or Markdown, and as with most
things, the more proficient the user is, the easier it will be to create professional-looking output. However, the
skill needed to generate a basic report can be easily mastered. See this OriginLab blog post for guidance.
The basic steps of creating reports using an Origin Notes window, are as follows:
384
Publishing and Export
When a Notes window is active, you can click the Notes menu and load a sample HTML
file into the Notes window.
385
UserGuide_2022b
As you fill in your Placeholders sheet, you should see your HTML report take shape in the Notes window. Once
completed, you can do various things with your HTML report, including:
• Click the embed button in the upper-right corner of the Notes window to embed the content into your
workbook, then save the workbook as an Analysis Template (File: Save Workbook As Analysis
Template).
With a worksheet active, the File: Export menu item provides the following options:
This option is available only for sheets containing data columns, and is not available when report sheets
such as those created by the Nonlinear Fitting tool are active. The exported file will contain only data
from the worksheet columns. Floating or embedded graphs placed in the worksheet will be ignored.
• Excel
Export books of worksheet columns with text and numeric data to an MS Excel file (XLS, XSLX, XSLM).
Note that analysis report sheets with their hierarchical tables, and things such as embedded graphs and
images, are not exported to the Excel file. Analysis results that are output to regular Origin worksheets
are exported.
For information on copying analysis report sheets and pasting to MS Office applications,
see FAQ-815 How do I copy report sheet tables and paste them into Word, Excel or
PowerPoint?
• SQLite
This option exports the active worksheet(s) as an SQLite file. Specify a file extension of .sqlite, .sqlite3
or .db (note that file structure is identical). Options to skip hidden columns or rows. Limited to export of
data in worksheet columns.
This option is available only on sheets with data columns, and not for report sheets. Use the View:
Page Break Preview Lines menu item to view the vertical and horizontal page break lines that
determine which columns and rows will be included in each page of the export. Floating or embedded
graphs placed in the worksheet will be included in the exported image.
386
Publishing and Export
• As Image File
This option is available on both data and report sheets. In the dialog that opens, you can select whether
to export the entire sheet, visible area, or selection. Image file formats including PDF are supported.
Floating or embedded graphs placed in the worksheet will be included in the exported image.
• As PDF File†
This option is available for both data and report sheets. In the dialog that opens, you can opt for
exporting the entire sheet, the visible area, or a selection. Floating or embedded graphs are included in
the exported PDF.
When creating a custom report from a worksheet that combines data, numeric results
and graphs, the best option is to export the entire sheet as a PDF file, or export the
sheet as a multi-page PDF file.
• ASCII
This will create an ASCII file of the data contained in the active matrix object.
• Image
This option will export the image view of the active matrix object, as a raster file.
Help: Origin: Origin Help > Importing and Exporting Data > Exporting Worksheets and
Matrices
387
UserGuide_2022b
388
19 Apps for Origin
Origin 2016 introduced Origin Apps -- tools that you could easily add to your Origin installation by dropping
them onto your Origin workspace. This ever-expanding collection of add-on tools is extending Origin's already-
powerful graphing and analysis capabilities.
Because an App is a self-contained, easily-distributed tool aimed at solving a particular problem, it can be
developed and deployed quickly, sidestepping the need to wait for a new Origin product release. In addition,
an App can be developed by anyone with a basic knowledge of programming in Origin, making it attractive as
a means to create and distribute tools for your company or user-community.
At present, all Apps can be downloaded for free. Note that some Apps require OriginPro; these are denoted in
the App description by the symbol.
The App Center provides "one stop" App installation and maintenance: Browse and download new and
popular Apps, search for Apps, update existing Apps, request an App or submit an App via the OriginLab
website.
Search for Apps and install them directly from the Start menu.
To open the App Center, click the Add Apps button that appears on all tabs of the Apps Gallery.
• Installed Apps with an Up-to-date Version icon beside them are up-to-date.
• Apps with a clickable Download and Install icon beside them are not installed. Click
this icon to install.
• Apps with an Update icon beside them have an available update that you can install.
Click this icon to update.
• Click the New and Popular tab for a quick look at what's available. Download and update
Apps.
• Click the Search tab to find Apps by Category and Minimum Version. Download and
update Apps.
389
UserGuide_2022b
• The Updates tab will display a red circle icon when there is an update to one or more
installed Apps. Improvements and bug fixes are listed for each.
New Apps and App updates are continually made available to Origin and OriginPro
users. Be sure to open your App Center occasionally (press F10) and if it displays the
red Download Now button, click to get the latest list of available Apps.
You can find Apps for these specific applications by clicking Find Apps... from Origin's main menu:
• Analysis: Fitting
• Statistics
These menu commands open the App Center Search tab to show only relevant Apps that are currently
available from OriginLab's File Exchange. Click the Download and Install button beside an App, to
install the App.
390
Apps for Origin
If you install your Apps using the Download and Install button in the App Center dialog, you don't
need to do anything else. The App is automatically downloaded and installed. When App updates become
available, you can use the Update button to update an installed App.
If your workstation does not have internet access, you will need to find a computer that does (does not need
to have Origin installed), download the App from the OriginLab File Exchange to a thumb-drive and bring it
back to your workstation.
If you have questions, click the How to Install link below the Download File button on the File Exchange
App description and download page.
• Upon installation, an App icon is placed in the Apps Gallery, docked to the right side of the Origin
workspace.
• App operations may be window-specific. If the App is dimmed (grayed out), the active window cannot be
operated on by the App. Check the required window type (hover on the dimmed App icon in the Apps
Gallery).
• If the Origin window type (worksheet, graph, etc.) is matched to the App, you can launch the App by
double-clicking on it in the Apps Gallery.
• If you prefer to launch the App from a toolbar button, open the Customize (Toolbars) dialog box (View:
Toolbars), click the Button Groups tab, locate the App's toolbar button and drag the button to the
OriginLab workspace or to an existing toolbar. Close the dialog box.
• Specific usage information is available on the description and download page for each App.
391
UserGuide_2022b
• Use the App Center (discussed above) to add and update Apps, search for Apps, request an App or
submit a review of an App.
. To launch the App Center, click the Add Apps button in the Apps Gallery.
• Organize your Apps by adding tabs to the Gallery. Right-click in an empty portion of the Gallery and
choose New Tab, then double-click on the default tab name and give the tab a meaningful name.
392
Apps for Origin
Adjust icon spacing using an Apps Icon Spacing slider control. LabTalk
system variable support for @APPS (horizontal) and @APPV (vertical)
spacing.
• Refresh
• New Tab
393
UserGuide_2022b
• A number of App-specific actions can be performed by right-clicking directly on the App icon in the Gallery
and choosing from the shortcut menu.
• Open the File Exchange Page: Opens the App's description and download page on the
OriginLab File Exchange.
• Show All (user-added tabs only): Shows Apps from all Gallery tabs on the active tab.
• Tab Views: Place or remove the check mark beside the App to determine on which Gallery
tab(s) the App shows.
394
Apps for Origin
Beginning with Origin 2022b, you can dock the Gallery to the top of the workspace, just
below the toolbars.
1. To dock the Gallery at the top of the workspace, drag the title bar toward the top of the workspace. Guide
it to and drop it on he workspace docking button that appears (shown outlined in magenta).
2. Once docked, drag the bottom edge of the Gallery to adjust width, as needed.
395
UserGuide_2022b
• A red dot appears in the upper-right corner of the Add Apps icon in your Apps Gallery (docked to
the right side of your workspace). Additionally, the red dot shows on individual Apps when an update
is available.
• In the App Center, the App will appear with a clickable "update" icon beside it.
• The App Center Updates tab will show a red dot with a number indicating how many App updates are
available. The tab will list updated Apps and allow you to apply updates for individual Apps or all Apps.
To update an App:
• Click the Update icon that appears next to the App in the App Center.
• Right-click on the App in the Apps Gallery and choose Download and Install Update
• Click the Update All Compatible button that appears on the Updates tab in the App Center; or click the
"update" icon beside each App.
• Right-click on the Add Apps icon in the Apps Gallery and choose Update All.
396
Apps for Origin
You can verify the version of an installed App by hovering on the App in your Apps
Gallery.
397
UserGuide_2022b
1. To request an App, open the App Center and click the Request App button in the lower-left corner of the
dialog box. This opens a web page on www.originlab.com.
2. Verify that the Your Reason for Contacting Us drop down is set to Request an App.
3. Fill out the remaining required fields and click the Submit Inquiry button at the bottom of the form.
398
20 Programming in Origin
As you gain experience with Origin, you may want to access Origin features programmatically, add your own
custom routines and tools, or communicate with Origin from other applications. This chapter outlines basic
programming options available in Origin. For more detailed information, see the following Origin programming-
related resources:
• Programming documentation including guides, language references, and examples are available from the
Help menu in the product.
• You can typically locate online programming pages by performing a web search from your browser using
phrases such as: labtalk importing , originc interpolate, or labview origin send data.
• Sample files for LabTalk, Python, COM Server and Client, etc. can be found in the \Samples folder of your
Origin software.
399
UserGuide_2022b
20.1 LabTalk
LabTalk is a scripting language that provides access to most of Origin's functionality. With LabTalk you can
access and change properties of Origin objects such as worksheets, columns, graph layers, and data plots.
LabTalk script can include calls to X-Functions to perform advanced data processing and analysis.
There are many options for executing your LabTalk scripts. Multiple lines of script can be organized as sections
in a file, and those individual sections can be executed from the user-interface at the command prompt in the
Script Window or Command Window; from buttons added to worksheets and graphs; from included or
custom-made toolbar buttons; or from custom menu commands.
• Support for "substituting" cell Notes in graph legend and text objects using @WN
(e.g. %(1, @WN, B, 3) for Note in col(B), 3rd cell of 1st plot's source worksheet).
1. Run Origin and start a new project by clicking the New Project button on the
Standard toolbar.
2. Click Data: Import from File: Single ASCII and browse to the file
\Samples\Graphing\Box Chart.dat. Select the file and click Open. The file is
imported into the active worksheet window.
3. With the worksheet window active, click Format: Worksheet. In the Worksheet
Properties dialog, click the Size tab and set Gap from Top to 25, then click OK.
A gap is added to worksheet window.
4. Click the Text Tool on the Tools toolbar. Click inside the gap that you just added
and type "Add Mean Label Row" into the text object. Click outside the text object
to exit edit mode.
5. Right-click on the text label and select Properties.... Choose Programming
Control tab, set Script Run After to Button Up. Copy and paste the following
script into the text box:
400
Programming in Origin
wks.userParam1 = 1;
wks.userParam1$ = "Mean";
range rr = $(ii);
Col($(ii))[D1]$ = $(mean(rr),.2*);
6. Click OK to apply settings and close the Text Object dialog box. Note that your
text object now looks like a button.
7. Click the button. Note that a new header row labelled "Mean" is added to the
worksheet and the mean value of each column of data is written to the Mean row
cell above the corresponding column.
Note: For more information on LabTalk, Origin's built-in scripting language, please consult your
product documentation at Help: Programming: LabTalk.
Sample files can be found in the \Samples\LabTalk Script Examples folder of your Origin software.
20.2 Python
Origin provides an embedded Python environment so that you can run Python in Origin. Origin supports
command line execution of Python code from the Python Console or Origin's Code Builder IDE. As of
September 2021, the embedded Python version is version 3.8.3.
• Added package version checking to pip -chk and pip -chk1 (e.g. pip -chk
401
UserGuide_2022b
Note: For more information on integrated usage of Origin and Python, see these topics in the Python
documentation:
• Embedded Python
There is an API for calling Origin from Python. See note under Automation Server,
below.
20.3 R
Origin supports running R commands in the Origin environment. You can issue R commands in the Script
Window or from the built-in R Console, or you can run .R files. All releases of R are supported up through
version 3.6.
Note: For more information on integrating Origin and R, refer to the Origin Help file (R Console and
Rserve Console) and the LabTalk Scripting Guide (Running R in Origin, R Objects, Rserve
Objects).
Sample files can be found in the \Samples\R folder of your Origin software.
20.4 MATLAB
The MATLAB Console allows Origin users to issue MATLAB commands from Origin, and to transfer data
between the two applications either using a graphical interface or using a command line.
• The Console requires both Origin and MATLAB be installed on the same computer.
• Origin also supports importing MATLAB (MAT) files from disk. There are two import routines, the older
Data: Import from File and the new Connector-based Data : Connect to File: MATLAB. Importing
MAT files does not require that MATLAB be installed.
Note: For more information on the MATLAB Console, refer to the Origin Help file (MATLAB Console.
The <Origin Program Folder>\Samples\COM Server and Client\MATLAB subfolder contains an example
(CreatePlotInOrigin.m, CreatePlotInOrigin.OPJ) that illustrates how to connect to an Origin COM server
from a MATLAB client (requires MATLAB).
402
Programming in Origin
20.5 Origin C
Origin C is a full-featured high-level programming language based on the ANSI C programming language
syntax. Origin C also supports a number of C++ features and a few C# features. Origin C provides access to
all aspects of Origin including data import, data handling, graphing, analysis, and exporting. You can access
Origin C functions from interface controls such as buttons, toolbars, and menu items, using LabTalk script.
Origin C is organized as a set of functions with support for passing arguments. Origin C functions are compiled
to object code and then loaded and executed inside of Origin. Origin C provides increased reliability and
manageability for developing and debugging code of greater scope and complexity.
Origin C also provides access to the NAG Numerical Library functions included in your Origin installation.
NAG functions provide you with a large selection of algorithms for performing computations ranging from
simple statistics and Fourier transforms to linear algebra and multivariate analysis. Origin currently supports
NAG Library Version Mark 26.1.
• Add function to matrixbase class for importing ASCII strings; with support for
LF/CRLF, specify token separator and missing value.
Note: For more information on Origin C, please refer to the Origin C documentation:
There you will find usage information, a language reference, developer notes, examples, etc.
Sample files can be found in the \Samples\Origin C Examples folder of your Origin software.
20.6 X-Function
An X-Function is a self-contained XML file that can be loaded in Origin as a special type of global function.
Origin C is the language used to create X-Functions. X-Functions provide a way to expand the functionality of
Origin by adding custom data processing features. Many of the built-in tools in Origin are based on X-Functions.
Once an X-Function has been created, it can be accessed from anywhere in the interface that allows for script
execution, such as the script window, toolbar buttons, or custom menu items.
Note: For more information on X-Functions, please refer to your product documentation that is
installed with your software:
There, you will find information on creating and using X-Functions, a language reference, and tutorials.
403
UserGuide_2022b
Note: For more information on Origin's Automation Server functionality, refer to the product
documentation installed with your Origin software:
There you will find examples and language reference information. Sample files can be found in the
\Samples\COM Server and Client folder of your Origin software.
20.8 LabVIEW
National Instruments™ LabVIEW™ is widely used for data collection. For example, many instrument and
sensor vendors provide LabVIEW drivers for acquiring data. Once the data is collected, the end user will need
to graph and analyze the data, and create reports for presentation. Origin provides powerful data analysis and
graphing tools, including the Analysis Template feature, which allows for repeat analysis on newly acquired
data. The ability to communicate between LabVIEW and Origin can thus greatly improve the efficiency of post-
acquisition analysis and presentation.
Origin ships with a collection of LabVIEW sub-VIs. LabVIEW users can simply incorporate these custom sub-VIs
in their main LabVIEW application to communicate seamlessly with Origin.
For Origin 2022b, the "Close References" application control is added to all
Samples\COM Server and Client\LabVIEW .vi files. Copy these samples to LabVIEW
using the Origin menu Tools: Copy Origin Sub-VI LabVIEW vi.lib\addons.
Note: For more information on Origin-LabVIEW connectivity, see the product documentation installed
with your Origin software:
Help: LabVIEW VI
20.9 Orglab
Orglab is a freely distributed component DLL for directly creating or reading Origin Project (.opj) and other
Origin file types (.ogg, .ogw and .ogm). It is available as a free download. An Origin license is not required to
use Orglab. Typical use of Orglab is for instrument manufacturers and other third-party vendors to allow their
frontend software to output data as Origin files.
The Orglab module is available for 64-bit systems. To find out more about Orglab and to download the
Orglab module, go to the Products > Orglab page of www.originlab.com.
404
21 Customizing Origin
The multi-tabbed Options dialog box has controls for Origin global settings pertaining to numeric display,
file and system paths, text fonts, Origin program opening and closing behaviors, etc.
• If you opened an Excel file inside Origin, choose Window: Origin Options (Excel workbook is active)
Controls For
• Display of zeros and scientific notation in tick labels, units display in axis title
• Zero is '0'
• No Trailing Zero
• Set file paths to track last opened, last saved, last exported file
File Locations • Set default path and file extension for importing different file types
Tab • Define applicable file types for ASCII import dialogs
405
UserGuide_2022b
Controls For
• 2D graph anti-aliasing
Graph Tab
406
Customizing Origin
Controls For
• Default percent of page size of OLE graphs copied to Clipboard, graph margin
and CTRL+C hotkey controls.
Page Tab
Until 2021b, the Size Factor (%) (formerly, Ratio) was
set to 40. The default is now 100.
• View/Change the location of the User Files, Autosave, Backup, Unsaved and
Group folders
System Path
Tab • View locations of system folders (Program, License and Application Data)
System variables are internal Origin settings that allow for the fine-tuning of a wide range of Origin behaviors.
Origin's Set Systems Variables dialog box (Preferences: System Variables...) can be used to view and set
system variable values. In the dialog, there is a link named System Variables List which opens a web page
with a list of all system variables, the default value, and description.
407
UserGuide_2022b
1. Type the system variable name in the first column of Set System Variables, without the @ symbol. For
example, if you wanted to make a global change to the Recalculate mode of analysis dialog boxes, type:
DAM
2. Click on the 2nd column to view the current value, and type in a new value. For example, with DAM, to set
Recalculate to Auto, type the value: 1.
3. Add optional comments in the third column and click OK to close dialog.
This modified value will be remembered and applied in every Origin session.
You can quickly read or set the value of a writable system variable in the Script Window (Window: Script
Window) by typing @systemVariable= as, for example ...
@DAM=
... then pressing ENTER. When setting the value of a system variable in this way, note that that typing in the
Script Window sets the variable value for the current session only.
Origin uses OpenGL (Open Graphics Library) for rendering of 3D graphs. OpenGL provides enhanced
performance including fast drawing, fast rotation and zoom, transparency, and lighting support.
For optimum performance, your card should support OpenGL version 3.0 or higher. To check your hardware's
support for OpenGL, run Origin and choose Preferences: 3D Open GL Settings.... Look under OpenGL Info
for information on graphics hardware and the supported version of OpenGL.
If your graphics hardware is older, you may experience compatibility issues with things such as transparency
settings and anti-aliasing. The controls under the Settings node in this dialog allow you do such things as
disabling transparency. The dialog box also provides information on disabling OpenGL.
For more information on OpenGL in Origin, see the links under "Topics for Further Reading" at the end of this
chapter.
21.2.1Collapsible Menus
Like many software products, Origin uses an auto-expanding "collapsible" menu feature that shows only a
partial list of menu commands when opening longer menus. If you want to show all commands upon opening,
click Preferences: Options, click the Miscellaneous tab and clear the Enable Collapsible Menus check box.
408
Customizing Origin
If you have scripts that are frequently run, you can add them to the menu for quick access. With the Custom
Menu Organizer you can...
To open the Custom Menu Organizer, choose Preferences: Custom Menu Organizer... from the main menu.
Then press F1 or click the button in the upper-right hand corner of the dialog box for instructions.
Once you create and save a new menu configuration (.omc) file, you can then select that configuration from
the Preferences: Menu fly-out menu. Multiple configuration files can be created, allowing you to easily switch
from one configuration to another. A Default configuration is also available in the fly-out, to revert to default
menu settings. Configuration files can be shared among colleagues so that you use a common set of menu
commands.
You'll note that form some menu commands, a bitmap is displayed to the left of the menu entry. The bitmap
indicates that there is an equivalent toolbar button.
On some systems such as VirtualPC or Terminal Servers, such bitmaps may cause a long delay when opening
menus. To turn off the display of menu command bitmaps:
You can modify the size of the Plot menu icons using the LabTalk system variable
@PPS. To find out how to change the value of a system variable, see Customizing
Origin Using System Variables.
• Click the small down arrow at the end of any toolbar and select the Add or Remove Buttons context
menu. Then select desired sub menu and check/uncheck to show/hide buttons. A Reset option is also
available.
• Press ALT key and drag a button to any new toolbar location.
• Press ALT key and drag a button to blank Origin workspace to create a new toolbar.
• Press ALT key and drag a button to any window till X shows, then release to delete the toolbar.
409
UserGuide_2022b
• Double click the left/top end of any docked toolbar to undock. Double-click on title of floating toolbar to
dock.
• In floating mode, click X button to hide the toolbar. Drag it to any new location to reposition. Drag it to
edge of the Origin workspace to dock.
• To show/hide multiple toolbars together, choose View: Toolbars... from the main menu. Use the check
boxes on Toolbars tab to show/hide toolbars. Click the New button to add a new toolbar, then drag
buttons from the Button Groups tab to add buttons on the new toolbar.
Origin supports creating new toolbar buttons with Labtalk script, both built-in or user-defined script to run
when click it. Choose View: Toolbars... and create new button group on Button Group tab.
• Origin ships with three button groups starting with User Defined... with a bunch of bitmap images.
• Click any button and click Settings... button to link .ogs (Script) file section with the button.
• If you are feeling really creative, Origin allows you to define a new button group that uses your own 16
color, 16 x 16 pixel bitmaps.
• Export the button group as an .OPX file and share it with others. The person who gets the OPX can drag
and drop the OPX file onto Origin workspace to install the toolbar.
Note: To learn more about creating and exporting user-defined toolbars, see:
Help: Origin: Origin Help > Customization and Automation > Customizing Toolbars
Origin supports adding a system button to the left of the minimize button on the window title bar. A custom
LabTalk script can then be associated with this button.
410
Customizing Origin
Note: Please view the -tbb option of the LabTalk Page command in the Programming help file:
Help: Programming: LabTalk > Language Reference > Command Reference > Alphabetical
Listing of Commands > Page
• Press ALT and drag items along the Status Bar to reorder.
• Right click on the window title bar to specify dock, hide, auto hide, and other settings.
• Arrange dockable windows as multiple tabs along the edge of the workspace to save screen space.
The hierarchy of Origin objects such as graph pages, combined with extensive object properties, lends itself to
the creation of custom settings for repeat use. You can save your custom settings either as templates or
themes, described briefly in the following sections.
411
UserGuide_2022b
Note: For detailed information please refer to Origin Help file, see:
Help: Origin: Origin Help > Origin Basics > Origin Template Files (OTW, OTP, OTM)
21.6.1Templates
The Origin template concept applies to graphs, workbooks, matrixbooks, and Analysis Templates™. Templates
allow you to choose a set of properties or operations and save those for repeat use.
Both the New Book (File: New: Workbook/Matrix: Browse...) and Template Library (Plot: Template
Library) dialogs include an Open Template Center button that opens a dialog for browsing and
downloading additional templates.
To open the Template Center directly, choose Tools: Template Center and set the Type drop-down to Graph
or Book.
412
Customizing Origin
Beginning with Origin 2022b, you can search for additional templates and install them
directly from the Start menu.
You can save workbook or matrixbook settings, such as the number of columns and sheets, column plot
designations, fonts, colors, display formats, custom header rows, scripts associated with the sheet, or
dimension and coordinate settings, to OTWU (workbook template) or OTMU (matrix template) files.
When the workbook or matrix window is active and you choose File: Save Template As, you save any
window customizations, minus any data that might exist in the window at the time of saving, to a template file.
The template file can then be used to create new windows, as needed, for storing and analyzing your data.
You can use the New Book dialog box for managing your workbook, matrixbook and Analysis templates. The
New Book dialog is re-designed for Origin 2021b and is covered in the Workbooks chapter of this User Guide.
Use the same New Book dialog to manage your Analysis Templates™. An Analysis Template starts from a
workbook but differs in that when you save it as an Analysis Template (File: Save Workbook as Analysis
Template), it is saved with whatever analysis operations and dependent graphing operations, exist in the
workbook at the time of saving. Analysis Templates are discussed briefly in the Batch Analysis section of
How to Handle Repetitive Tasks chapter of this guide.
• Analysis Templates.
As mentioned in the Customizing Graphs chapter, Origin ships with about 240 built-in graph templates that are
used to create Origin’s many science and engineering graph types. Using one of these as a starting point, you
can create your own graph, adding more layers, setting scale or dimensional relationships between layers,
modifying data plot properties, etc., and then save your customizations as a user-defined graph template
(.OTP) file by clicking File: Save Template as.... See the "Templates and Themes" section of the Customizing
Graphs chapter for a general discussion of graph templates.
One important subset of graph templates are what are called “cloneable” templates. A cloneable template
requires a very specific data arrangement in your worksheet or matrix; the idea being that if you have once
created a complex arrangement between worksheet datasets, matrix objects, etc. and, for instance, layers or
panels in your graph, then you shouldn't need to recreate this arrangement every time you want to recreate
413
UserGuide_2022b
such a graph. Cloneable templates are identifiable in the Template Library by the presence of a “sheep” icon
next to the template name or thumbnail image.
For more information, see the section on cloneable templates in Graph Template Basics in your Origin Help
file.
21.6.2Themes
An Origin Theme is a file containing a set of object properties or dialog settings. Thus for example, the
customized settings of a graph window can be saved as a Theme, or the customized settings in an analysis
dialog can be saved as a Theme. If you were to open the Theme Organizer (see below), you would see that
there are tabs for Graph, Worksheet, Dialog, Function and System Increment Lists.
Themes allow you to quickly apply a new set of properties to an object, such as a graph. For example, you
might apply a black-and-white Theme to a color graph in order to prepare it for publication. Or you might take
the object properties of one graph and apply them to all the other graphs in the same project.
Right-click on plot, layer, object, etc. in graph -- or right click with nothing selected in graph -- and choose
Copy Format context menu to copy format. Depending where you right click, the corresponding selection's
format can be copied. Then right-click on corresponding selection or right click in target graph and click Paste
Format to apply the copied settings to the target selection or graph. You can also choose Edit: Paste
Format... to paste the Format to multiple target graphs.
414
Customizing Origin
The Theme Organizer dialog box is opened from the Preferences menu. Use this dialog to organize your
graph, worksheet, and dialog themes.
With this dialog you can apply a graph theme to multiple graphs to have consistent look. To combine multiple
graph themes in the Theme Organizer dialog, hold down Ctrl while selecting the Themes, and then right-click
to access the Combine context menu. The context menu in the tool provides an option to edit a Theme,
allowing the user to add/delete properties to an existing theme. Setting a Theme as a System Theme means
that it will be applied to new graphs automatically, if the graph template allows a System Theme to override
template settings (see the Allow System Theme & System Increment Lists to Override check box).
The Theme concept extends to dialog box settings, as well. For instance, you can choose a particular suite of
settings in the Linear Fit dialog box (Analysis:Fitting:Linear Fitting), and then save those settings to disk
as a named Theme file. You can save multiple Theme files for a given dialog box and then load them into the
dialog, as needed, using the dialog box's Dialog Theme drop-down list. Saving multiple Themes for a dialog
box allows you to customize your analysis routines from different experiments, when each requires using a
specific (and unique) group of settings.
415
UserGuide_2022b
Dialog themes are explained in more detail in the How to Handle Repetitive Tasks chapter of this guide.
• Analysis Themes
416
22 Sharing Origin Files
You may want to customize some aspect of your Origin installation and then share your customizations with
other Origin users. Custom settings can be saved in many file types including graph templates (.otpu) and
themes (.oth), analysis templates (.ogwu or .opju), dialog themes, curve fitting functions, import wizard filters,
LabTalk script files (.ogs), and X-Functions.
Drag-and-drop is supported for most Origin file types. Origin project (.opju) and graph template (.otpu) files
automatically open when dropped into the workspace. Other files are copied to the appropriate subfolders in
the User Files Folder (UFF). For example, when you drop a fitting function (.fdf) file into the workspace, a
dialog opens asking how you want to categorize the new fitting function.
Beginning with Origin 2022b, you can use a small dialog to remove formulas and links
from the current selection, the active sheet, the active book or the entire project. This
converts formulas and links to raw numbers. Removing formulas and links can make it
easier to share project data with colleagues without having to share such things as
externally-linked (DDE) Excel files; or to significantly reduce project size before
archiving data.
417
UserGuide_2022b
Help: Origin: Origin Help > Customization and Automation > Setting Your Preferences > The
User Files Folder
Origin supports setting multiple group folders, making it possible to share different files
between groups. A leader machine can set up multiple groups and publish different files
to different groups. A member machine can belong to multiple groups and thus receive
all files published by group leaders.
Help: Origin: Origin Help > Sharing Your Origin Files with Others > Sharing Files with
Multiple Clients > Setting a Group Folder Location
To access the Package Manager, click Tools, and then click Package Manager...
To install the contents of an .opx file, simply drag and drop into the Origin workspace.
Help: Origin: Origin Help > Sharing Your Origin Files with Others > Packaging Multiple Files
as OPX
418
Sharing Origin Files
• Available as a 64-bit Windows application, or as a native Mac application (Mac version not compatible with
11.0.1, Big Sur).
• Project Explorer-like folder view with graph previews on hover, icon or details views, X-large icon view
option.
Origin 2018 introduced a new Unicode-compliant project file type (OPJU). Origin Viewer
versions 9.6.5 or later allow anyone to save the Unicode-compliant OPJU project files
to the pre-2018 OPJ format for sharing of projects with users of older versions of
Origin.
If you have Origin graphs or data that you wish to share with colleagues who are not currently using Origin,
you might direct them to the Origin Viewer page (www.originlab.com/viewer) where they can find out more
and download the free EXE.
• Package Manager
419
23 Origin Toolbars
This is a list of Origin toolbars, and buttons by button group. Toolbars are shown in their default configurations.
You will note that some buttons are missing from default toolbar configurations. This may be because a button
has been deprecated, because it is duplicated on another toolbar, or simply because it is a lesser-used button.
Note also that some toolbar buttons have a small downward pointing arrow next to them. Clicking the tool
displayed on these "split buttons" carries out the action associated with the displayed tool. Clicking the arrow
beside it opens a menu, allowing you to pick another tool. A split button displays the tool that was last used.
Finally, toolbar buttons will be inaccessible (dimmed) if the object that they act on is not active. For instance,
the 3D-Rotation Toolbar is only available when a 3D graph is active.
In addition to these dockable toolbars, Origin has context-sensitive Mini Toolbars for
variety of common editing tasks. These toolbars are discussed in The Origin Interface
chapter of this Guide. For a complete list of those toolbars, see the Origin Help File.
23.1 Standard
421
UserGuide_2022b
Ctrl +
New Image Open
O
Ctrl +
Open From Cloud Save Project
S
Recalculate Auto/Up-to-
Save Template
date vs Manual/Pending
Ctrl +
Print Slide Show of Graphs
P
Send Graphs to
Open Video Builder
PowerPoint
Refresh F5 Duplicate
Alt +
Custom Routine Project Explorer
1
Alt + Alt +
Object Manager Results Log
8 2
Alt + Alt +
Command Window Code Builder
3 4
422
Origin Toolbars
23.2 Import
Ctrl +
Re-import no Dialog Re-import with Dialog
4
23.3 Edit
423
UserGuide_2022b
23.4 Graph
Enable/Disable Anti-
Rescale Ctrl+R
Aliasing
Rescale X Rescale Y
Rescale XY Rescale Z
Whole Page
424
Origin Toolbars
23.5 2D Graphs
Note that only common plot types have a toolbar button. Complete access to Origin plot
types is found on the Plot menu.
Y Error X Y Error
Row-wise Column
425
UserGuide_2022b
9 Panel Stack
426
Origin Toolbars
427
UserGuide_2022b
Ternary Piper
Template Library
428
Origin Toolbars
3D Ribbons 3D Walls
429
UserGuide_2022b
23.8 3D Rotation
430
Origin Toolbars
Rotation Angle
23.10 Column
Set as X Set as Y
431
UserGuide_2022b
23.11 Layout
23.12 Mask
432
Origin Toolbars
23.13 Tools
Pointer Scale In
433
UserGuide_2022b
Freehand Draw
Curve Tool
Tool
Hold
Zoom-Panning Tool Insert Equation
"A"
Hold
Rotate Tool
"R"
Left Right
Top Bottom
434
Origin Toolbars
Vertical Horizontal
Group Ungroup
Front Back
Forward Backward
Front(data) Back(data)
23.15 Arrow
435
UserGuide_2022b
23.16 Style
Inside Horizontal
Frame Borders
Borders
436
Origin Toolbars
23.17 Format
Descriptio
Button Hotkey Button Description Hotkey
n
Underlin
Ctrl+"U" Superscript Ctrl+"+"
e
Subscrip SuperSubscri
Ctrl+"=" Ctrl+"-"
t pt
Ctrl+">" Ctrl+"<"
Increase Decrease
Font Ctrl+Shift+ Font Ctrl+Shift+
"." ","
Center
Horizont Right
al
Center
Top
Vertical
437
UserGuide_2022b
Button Description
Lock Positions
438
Origin Toolbars
439
Index
2 Code Builder .................................................. 49
3D Graphing, Hardware Compatibility ............... 408 Column Values, Setting .................................. 106
Animating Graphs ......................................... 377 Curve Fit, Linear and Polynomial ...................... 322
ASCII Data, Import to Graph ........................... 174 Customizing Origin, Global Settings .................. 405
Auto Recalculate ........................................... 344 Customizing Toolbars and Buttons .................... 409
Batch Peak Analysis ....................................... 324 Data Info Window ......................................... 285
441
UserGuide_2022b
Digitizing Scatter Plots ..................................... 76 Graphs, Add Data by Insert Plot to Layer ........... 172
Drag and Drop Plotting ................................... 172 Graphs, Adding or Removing Plots.................... 172
Drag-and-Drop Origin File Sharing ................... 418 Graphs, Adding Text & Drawing Objects ............ 241
Embed Graphs, 3rd Party Applications............... 367 Graphs, Customizing Grouped Plots .................. 219
Embed Graphs, Origin Templates ..................... 348 Graphs, Distance Between Two Points ............... 281
Excel.......................................... 42, 66, 403, 405 Graphs, Extract to Layers ............................... 255
Exporting Graphs/Layout Pages ....................... 371 Graphs, Insert Equation ................................. 244
FFT ...................................................... 295, 326 Graphs, Layer Contents Dialog Box................... 173
Filtering, Signal Processing ............................. 326 Graphs, Legend Customization ........................ 234
Full Menus ..................................................... 27 Graphs, Listed by Type182, 188, 191, 193, 197, 201, 205, 206
Graph Layer ................................................. 166 Graphs, Reading Coordinate Values .................. 275
Graph Layer Frame ........................................ 166 Graphs, Reorder Layers .................................. 257
Graphical Exploration Tools, Annotation ............ 285 Graphs, Saving Custom Templates ................... 213
Graphical Exploration Tools, Data Cursor ........... 285 Graphs, Send to PowerPoint ............................ 376
Graphical Exploration Tools, Data Info Window ... 285 Graphs, Slide Show ....................................... 377
Graphical Exploration Tools, Data Reader .......... 285 Graphs, Speed Mode ...................................... 178
Graphing Matrix Data ..................................... 162 Graphs, Template Library ............................... 213
442
Index
Hiding Worksheet Columns ............................. 121 Legend, Categorical Data ................................ 236
imzML ........................................................... 70 M
J Mat ............................................................... 70
443
UserGuide_2022b
Matrix, Converting Worksheet Data .................. 156 Networks, Sharing Files .................................. 418
Matrix, Data Mode vs. Image Mode .................. 131 New Features ................................................. 19
Matrix, Set Values ......................................... 149 Object Linking and Embedding (OLE) ................ 367
Networks, Multi-seat Node-locked ........................ 3 Peak Analysis ................................... 14, 295, 324
444
Index
Plot Setup Dialog Box ...................... 167, 173, 177 Sample Projects .............................................. 10
Profiling Matrix Data ...................................... 149 Sharing Files with Multiple Users ...................... 418
Programming Origin................................ 361, 399 Sharing Origin Files ................................ 417, 418
Region of Interest (ROI)287, 288, 295, 318, 319, 320, 323, 325,
SPC353
.............................................................. 70
445
UserGuide_2022b
Statistics, Report to Script/Command Window .... 335 User Files Folder (UFF) ................................ 4, 418
Statistics, Report to Status Bar ........................ 334 User Files, Transferring ...................................... 3
T WAV ............................................................. 70
Theme Organizer ............................ 214, 265, 415 Worksheet Plot Designations ........................... 165
Themes, Dialog Box ....................................... 346 Worksheets, Converting to Matrix ............... 156–55
Toolbar Bitmaps, in Menus .............................. 409 Worksheets, Set Column Values....................... 106
Toolbar Buttons, Custom ................................ 410 Worksheets, Sorting Data ............................... 121
Toolbars and Buttons, Customzing ................... 409 Worksheets, Transposing Data......................... 121
Tutorials, Video............................................... 11
446