Chart settings

LightningChart Python Trader has a large number of various settings to modify the chart behavior and appearance. As with any other aspects of the chart, these can be modified in code.

This section explains general settings of the chart. For color and appearance settings, see "Color settings".

---

Chart settings via user interface

Most of the chart settings can be found in the settings menu, brought up by clicking the Chart settings button found in the toolbar to the left of the chart. Note that appearance and color related settings have their own menu.

Technical indicators and drawing tools have their own respective settings menus.
For indicators, see Modifying indicators.
For drawing tools, see Modifying drawing tools.

General settings

Chart Title
Allows modifying the title text shown on top of the chart.

Currency
The currency of the current dataset. When set, is shown after the chart title.

Price Axis alignment
Determines on which side of the chart the price axis is located. Default side is right.

Percent Scale
When enabled, modifies the price axis to show percentage ratios instead of price values.

Data Packing
When enabled, packs the candle-sticks or bars when the chart has a large number of data points. This improves the performance but may cause a loss of data accuracy.

Zoom Band Chart
Shows a small zoom band chart depicting the whole X-axis range of the main chart. Appears directly below the price chart.

Show chart title
Can be used to show and hide the chart title. The chart's top margin is automatically adjusted accordingly.

Show splitter lines
When enabled, shows horizontal lines between the price chart and technical indicators. These lines can be dragged to resize the corresponding segments.

Show search bar
When enabled, shows a button for the search bar in the top-left corner of the chart. The bar can be customized to work with user's own data provider.

Show file selection
Can be used to show and hide the csv file selection button.

Allow Hiding Toolbar
When enabled, the entire toolbar on the left side of the chart can be shown or hidden programmatically. Use the show_toolbar method to toggle the visibility of the toolbar.

Symbol Watermark
When enabled shows the current symbol as a semi-transparent watermark in the middle of the price chart.

Watermark text
Sets the text that is shown in the symbol watermark.

Cursor settings

Cursor Tracking
Allows you to set which OHLC-field is being tracked by the data cursor, and what values are shown in the result table.

Result Table Position
Allows setting the position of the result table showing the current cursor values. Options include top-left corner, current cursor position, and the result table being hidden.

Show Horizontal Line
Shows or hides the horizontal line of the data cursor. Affects also all study indicators (indicators below the price chart).

Show Vertical Line
Shows or hides the vertical line of the data cursor. Affects also all study indicators (indicators below the price chart).

Zooming and panning settings

Wheel zooming
Defines how the chart is zoomed when the mouse wheel is scrolled. Note that Vertical zooming and Restrict X/Y-axis settings also affects the zooming behavior. There are five behavior options to choose from:
KeepEnd - X- and Y-axis maximums are kept visible when zooming.
KeepStart - X- and Y-axis minimums are kept visible when zooming.
TowardsPointer - Zooms towards the current pointer location. This is the old behavior used before Trader 3.0 release.
Centered - Zooms towards the center of the chart.
Off - Mouse wheel zooming is disabled.

Rectangle zooming
Defines what button is used for rectangle zooming. Options include left, right, or middle mouse buttons, or disabling it entirely. If this and panning are set to use the same button, panning is automatically disabled.

Panning
Defines what button is used for panning. Options include left, right, or middle mouse buttons, or disabling panning entirely. If this and rectangle zooming are set to use the same button, rectangle zooming is automatically disabled.

Vertical zooming
When disabled, chart can be zoomed only in horizontal direction. In other words, X-axis is zoomed but Y-axis is ignored.

Vertical panning
When disabled, chart can be panned only in horizontal direction. In other words, X-axis is panned but Y-axis is ignored.

Restrict X-axis
When enabled, X-axis cannot be zoomed or panned past the dataset minimum or maximum.

Restrict Y-axis
When enabled, Y-axis cannot be zoomed or panned past the dataset minimum or maximum.

Chart settings in code

Every chart setting you can do via user interface, can also be done in code. Chart instance has various set...() and show...() methods to alter the behavior of the chart.

# Various chart settings in code
trader.show_zoom_band_chart(True)  # Enable the zoom band chart
trader.show_file_selection(False)  # Hide the file selection button
trader.set_chart_title('Dataset Title')  # Set the chart title
trader.set_percent_scale(True)  # Enable percentage scale
trader.set_ohlc_cursor_tracking('Close')  # Set OHLC cursor tracking type to 'Close'

Settings for individual technical indicators and drawing tools can also be modified in code. Each indicator and tool have their own methods to modify them. For further information, check the respective documentation:
For indicators, see Modifying indicators.
For drawing tools, see Modifying drawing tools.