Pattern Matcher

Author: Optuma Team Last updated: Sep 9, 2020 20:37
Included in Trader Services Included in Professional Services Included in Enterprise Services


The Pattern Matcher tool generates a swing list between two selected mouse points and measures the highs and lows (in percent and bars). The Pattern Matcher will then run through the entire chart to find other instances where that same pattern occurred.


To add the tool to your chart, select the tool from the toolbox, and left-click on the first bar you want to calculate the tool from. Next, left-click on the bar where you want to calculate the tool to. Optuma will then draw the matching patterns using the default settings (Green for Exact Match, Red for Inverted Match).

Scripting Function: PATTERNMATCHER()

Actions & Properties



Copy Data to Clipboard: Will copy the tool’s values to the clipboard which can then be inserted into a spreadsheet, for example, allowing for further analysis.

Add to Toolbar: Adds the selected tool to your custom toolbar.

Apply Settings to All: When multiple Pattern Matcher tools have been applied to a chart, page or workbook, this action can be used to apply the settings of the one selected to other instances of the tool. This is a great time saver if an adjustment is made to the tool - such as line colour - as this allows all the other Pattern Matcher tools in the chart, page or entire workbook to be updated instantly.

Copy Tool: Allows you to copy the selected tool, which can then be pasted onto a different chart window.

Move to Back: If the tool is displaying in front of other tools or indicators clicking this action will move the tool view to the background.

Move to Front: If the tool is displaying behind other tools or indicators on the chart, clicking this action will bring the tool to the forefront.

Restore Default Settings: Click this action if you have adjusted the default settings of the tool, and wish to return to the standard properties originally installed with Optuma.

Save Settings as Default: If you have adjusted any of the tool’s properties (colour, for example) you can save the adjustments as your new default setting. Each time you apply a new Pattern Matcher to a chart, the tool will display using the new settings.

Delete: Deletes the tool from the chart.



Tool Name: Allows you to adjust the name of the tool, as it’s displayed in the Structures Panel.

Calculation Style: Allows you to set the type of Swing Calculations used when plotting the pattern. The options are Gann Swing, Percent Swing, Pivot Points and Volatility Swings (Requires Optuma Extreme add-on).

Swing Properties: Allows you to set the parameters of the Swings being used to plot the pattern. This includes Bar Count, Outside / Next Bar use, Inside Bar use and the Use Breakout rule.

Pattern: A script representation of the pattern being searched for. For example: {“PATTERNS”:[“33.33,-61.1”,”120,128.21”]}

Allow Inverts: When enabled, patterns matching the inverse values will also display on the chart.

Tolerance (%): Allows you to set a tolerance for a matching pattern to display. The higher the setting the greater a variation in pattern, which can display a positive result.

Match On: Allows you to set the passing criteria of the Pattern. The options are Price (default) Time, and Time & Price.

Base Box Style: Allows you to set the colour and line style of the pattern manually selected on the chart (also known as the Base Box). By default, the Base Box colour is Blue.

Exact Match Style: Allows you to set the colour and line style of any matching patterns found on the chart. By default, the colour is Green.
Inverted Match Style: Allows you to set the colour and line style of any inverse patterns found on the chart. By default, the colour is Red.
Projection Type: The Pattern Matcher can display the price movement which occurred after the Matching and Inverse Patterns found on the chart and project them from the end of the Base Box. These lines will use the same colour as the patterns (Green for Matches, Red for Inverse), or can be combined to form an Average Projection Line.
MASPATM Projection Lines
Individual Projection Lines

Average Projection Line
Projection Bars: Allows you to set the number of bars after a matching pattern are projected on the Base Box.

Tool Transparency: Use this slider bar to adjust the transparency of the tool. Moving the slider to the left will increase the transparency of the tool.

Visible: Un-tick this checkbox to hide the tool from the chart.