Author: Optuma Team Last updated: Jul 8, 2020 02:47


The Eclipse tool graphically displays on the chart when Solar and/or Lunar Eclipses occur.


To add the tool to your chart, select the tool from the Astro tool group, and left-click on the chart or indicator on which you wish to add the tool. Optuma will then draw the tool using the default settings.

Scripting Function: ECL()

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 Eclipse 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 Eclipse 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.

Set Time Alert: Selecting this action will set a Time Alert at the value the Vertical Line is positioned.

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 Eclipse 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.

Show Lines: When selected Eclipse lines will be displayed on the chart. When checked the options for “Lines Over All Views” and “Line Style” will become available.

Show Symbols: When the Show Lines property is enabled this checkbox will appear. You can untick it to hide the symbols from the tool so only the lines display on the chart.

Lines Over All Views: Check this box to ensure the that the Eclipse lines extend over all tools or indicators that are placed on the chart. For example, the lines will run through the volume indicator if this box is checked.

Line Style: Expands to display the line properties of the Eclipse. The following properties can be adjusted:

  • Line Style - The Line Style property allows you to adjust the type of Eclipse Lines displayed. There are 8 options available: Solid, Dots, Dash, Dash Dots, Long Dash, Long Dash Dot, Long Dash Dot Dot, Stippled
  • Line Width - Allows you to adjust the width of the Eclipse lines. Moving the slider bar to the right increases the thickness of the line.
  • Transparency - Use this slider bar to adjust the transparency of the Eclipse Lines. Moving the slider to the left will increase the transparency.

GMT Offset: Use this option to adjust the Eclipse time zone setting for a specific market. Select the required GMT setting and the Eclipse will automatically update.

Coordinate Type: Changes the positions based on equatorial or ecliptic coordinates.

Eclipse Type: Allows you to select whether you want the Solar, Lunar, or Both eclipses to show.

Position: Use this option to adjust the position of the Eclipse symbols. The following positions can be selected: High, Low, Top, Bottom or Floating.

Symbol Size: Allows you to adjust the size of the Eclipse symbols. Moving the slider bar to the right increases the Symbol size.

Solar Colour: Allows you to adjust the colour of the Solar Eclipse Symbols and Lines.

Lunar Colour: Allows you to adjust the colour of the Lunar Eclipse Symbols and Lines.

Stack Symbols: When multiple Eclipse tools are added to a chart, this property allows you to stack them over a bar instead of having them appear in front of each other.

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.