# Studies

MotiveWave™ has over 300 built in studies that can be used to display information on the price plot or separately in a plot below the price.

There are essentially two types of studies:

* Overlays – display information that is drawn on top of an existing plot (most typically the price plot)
* Study Plots – display information that is displayed in a plot that is separate from the price plot.

## Adding a Study

A study may be added by clicking on the Study icon on the top toolbar in the default MotiveWave layout. You can search for available studies using the Search bar and other filter boxes. You can quickly add a recent study to Favourites list or customize the studies in that list by right clicking on the studies.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FVAYS4bq3yKi0KUHqwkj3%2Fimage.png?alt=media&#x26;token=493126de-66f5-4bdd-810c-e985f3c21635" alt=""><figcaption></figcaption></figure>

A study may also be added to a chart by choosing one of the available studies found under the ***Study*** menu from the top menu bar. This menu organizes some (not all) of the studies into logical groups (based on author or function). The ***Add Study*** option enables you to search for a study instead of trying to find it in a sub-menu. For convenience, a ***Recent*** menu is available to access recently used studies.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2Fo1SJG6VXkY4SzEkMBBgp%2Fimage.png?alt=media&#x26;token=58c25e6e-4547-4191-9e17-fba3c8ac26c2" alt=""><figcaption></figcaption></figure>

If you choose ***Add Study***, you will see the following dialog. This is a convenient way to search for a study by typing it in into the Filter input (see below):

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2Flnk0wcaHNA9wYgjLZgj6%2Fimage.png?alt=media&#x26;token=6bff8405-5951-4a8c-bd45-af5b6e156867" alt=""><figcaption></figcaption></figure>

When you add or edit a study you will see the study dialog similar to the one displayed below. Each study will have different settings and configuration options. The available tabs will depend on the study, but all study dialogs will have **Options,** **Signals** (if it generates signals) and **Toolbar** tabs.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2F6nhF1Ev4so64yIfp9U4P%2Fimage.png?alt=media&#x26;token=72a54bbf-eb51-4f62-a167-fa8931b5d817" alt=""><figcaption></figcaption></figure>

Adjust the settings for the study and click on the **Create** button to add the study to the chart. For convenience, you can click on the **Defaults** drop down to save/apply/reset the study settings for the next time you create this study. You can also save study settings as templates and manage the templates by clicking on the Template drop down.

The following screenshot shows the **Simple Moving Average (SMA)** study from the **Study** dialog above. Also shown is a Study Plot for the **MACD** study.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FguWqSFV5g5aDXCd0qnjQ%2Fimage.png?alt=media&#x26;token=6b0dcd19-7a54-4063-9520-437f87069d37" alt=""><figcaption></figcaption></figure>

## Editing a Study

If you would like to edit the settings on a study simply double click or right click and choose Edit Study.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FPIfCKjPxqxJnbkGB8XM7%2Fimage.png?alt=media&#x26;token=8c7d8384-67bd-469e-b16c-4a56e9ef84dd" alt=""><figcaption></figcaption></figure>

## Study Options

All studies will have an **Options** tab as the last tab when you create or modify its settings. This tab will contain different values if it is an overlay or a study plot.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2F5pdKjaMS3Q82PL7MPwmF%2Fimage.png?alt=media&#x26;token=1a04487e-e4c4-44c8-a1c3-d6e817e4be5b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2F3qAkjdJgNdai4BO38JoQ%2Fimage.png?alt=media&#x26;token=0d7ea76e-396e-46e6-871e-fd21d4ca7b59" alt=""><figcaption></figcaption></figure>

### Overlay Plot

When you create an overlay study, by default it will be placed on the **Price Plot/Price Graph:**

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2F98zWXNkgwr3qgcjweVbv%2Fimage.png?alt=media&#x26;token=3aff72b4-576a-40bf-ba0e-8a224e7ef586" alt=""><figcaption></figcaption></figure>

Optionally, you can choose one of the existing plots to display the study. When you change the graph for the study, it will change the input options. For example, if you want to display a simple moving average (SMA) on an RSI study plot, you would choose the RSI(14) plot from the **Options** tab:

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2Fpwdy8WbnAYiFsKUXN8eX%2Fimage.png?alt=media&#x26;token=5e105b4d-1ca3-4e8b-b1b3-69d6cb5d5776" alt=""><figcaption></figcaption></figure>

When you choose this, the Input field (under the **General** tab) will be updated to reflect the inputs available from the RSI plot:

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FCjiItZdxjRD6lOcEc3Ld%2Fimage.png?alt=media&#x26;token=8a7a0669-6aa0-480f-85e1-5e409be7e37e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2F2zWpErtg8fXptT7PzqDM%2Fimage.png?alt=media&#x26;token=5be1eb65-2e71-4746-b4b7-0806425caa05" alt=""><figcaption></figcaption></figure>

### Study Plot Overlay

Study plots may be overlaid on other plots (Price Plot or other study plots). You can change the overlay plot for a study from the **Options** tab.

You may have noticed this feature already with the Volume overlay on the default layout of the Console. This is an example of a study plot on the Price Plot:

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2F1LGdns7iCubWopv4mbeF%2Fimage.png?alt=media&#x26;token=c921d4f2-7544-4db7-8d6c-b415530aa15f" alt=""><figcaption></figcaption></figure>

&#x20;The following example shows a MACD and SMA study plots on RSI study plot :

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FSQcN9GhfA0K6dn6xXL6l%2Fimage.png?alt=media&#x26;token=ed1426b1-451f-4fb3-9efe-9fb07b71a195" alt=""><figcaption></figcaption></figure>

You can adjust an overlay study plot by clicking on the study to show its axis, then holding and dragging the yellow points at the top and bottom of the graph:

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2Fwqe3NyhGAJNLxMAweGC5%2Fimage.png?alt=media&#x26;token=3ba6a5cc-c733-48ea-96ef-74064b7f2335" alt=""><figcaption></figcaption></figure>

You can also double click on the overlay study plot to open the study settings > Options tab for more options to select top/bottom insets, overlay types, height, axis settings:

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FzGI8y3hwORrAtEJslgOf%2Fimage.png?alt=media&#x26;token=cd08fcf3-272f-4235-80b6-b57997206166" alt=""><figcaption></figcaption></figure>

### Study Bar Size

By default when you create a study, it will use the bar size of the chart. When the chart bar size changes, the study will be automatically updated to reflect the new bar size. MotiveWave™ does allow you to choose a specific bar size for the study. This allows you to, for example, display a 1 day SMA (Simple Moving Average) on a 15 minute chart. This feature also applies to study plots so you could display a 10 minute RSI on a 15 minute chart (see example below):

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FuSpx05i4jAyPuq0qmCcM%2Fimage.png?alt=media&#x26;token=5de8cd9f-a6a7-4b44-9290-a86f668fe2af" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FPMnIIA2GRhk4MqmuQ2oP%2Fimage.png?alt=media&#x26;token=203fa755-8091-41f5-85e8-acd128bca173" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FmHdKDxIZlMun5b67vkSh%2Fimage.png?alt=media&#x26;token=72dfa6d1-1c74-481c-be5f-b4da9388423a" alt=""><figcaption></figcaption></figure>

### Study Visibility

For convenience, you can specify that a study is only visible on certain bar sizes. This is similar to the visibility feature for components. By default a study is visible on all bar sizes. You can change this from the **Options** tab:

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FOfgaS3pC6cXe7ndPTaTq%2Fimage.png?alt=media&#x26;token=6e49cb04-a59a-4eea-8bd1-b25f3a20bdbd" alt=""><figcaption></figcaption></figure>

## Study Toolbar

Some options of a study can be added to the toolbar(s) for easy access via the Toolbar tab of that study settings.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FwSV4dYTOkXEyuz1eBwHw%2Fimage.png?alt=media&#x26;token=22afc682-d8c9-4ae7-9ce9-0b6690eb3412" alt=""><figcaption></figcaption></figure>

For the options to be displayed on the toolbar, make sure that you have the Study Editor section enabled/added via the Configure menu > Settings > Toolbar > Toolbar. In the screenshot below, the Study Editor is located between the Link Chart and Lock Scroll actions:&#x20;

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FhSkG4t1hJxzPwZCMhsfs%2Fimage.png?alt=media&#x26;token=2c930617-6947-44b1-a530-0f873b99ebff" alt=""><figcaption></figcaption></figure>

In case there are no study settings added to the toolbar, there will be a blank space displayed as in the default chart layout:

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FOx8V7vti1YnNUmlY4gVH%2Fimage.png?alt=media&#x26;token=27586c99-568f-4675-9940-d21e2e590ff1" alt=""><figcaption></figcaption></figure>

## Signals

Some studies generate signals. Signals occur when a specific event occurs with the study. For example, a signal may be generated in a CCI study where the CCI value crosses above the top guide. These signals can be used to show alerts, play sounds or even send an email notification.&#x20;

Note: if you want to send emails, you will need to configure your email (SMTP) settings in the ***Configure > Settings > Email*** from the Console menu bar. Please see [Email Configuration](https://docs.motivewave.com/user-guide/console-1/email-configuration) guide.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FOTcNixttOILhRyvOMZDI%2Fimage.png?alt=media&#x26;token=45bedad9-6aae-4067-a8d2-064dbed65e9f" alt=""><figcaption></figcaption></figure>

## Instrument Overlay

An instrument can be overlaid on top of the price plot by choosing ***Study > Instrument > Instrument Overlay*** from the top menu bar. This action will open the dialog displayed below:

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FQmHkOCX1sGBCH9VOc26g%2Fimage.png?alt=media&#x26;token=a50062eb-7a6f-4847-87f6-6f62b40137e5" alt=""><figcaption></figcaption></figure>

This dialog has the following elements:

* **Instrument** – Type or select the instrument.
* **Price Bar** – Choose the type of bar and line source (opening price, closing price, etc.) that you would like to display for the overlay (default is a line chart). Click on the pencil icon for more line styling options.
* **Indicator** – Options for the indicator of the instrument overlay.
* **Shift** – The number of bars to shift the study forward (negative value for backward). Uncheck **Lock Shift** to enable dragging of the overlay backward or forward using the mouse.
* **Bottom/Top** –&#x20;
* **Show Label** – Display a label at the end of the overlay for the Instrument symbol

Click on the **Add** button to add this overlay to the price plot.&#x20;

The example below shows an instrument overlay for the USD/JPY pair on top of the price plot for the EUR/USD pair. The axis for the USD/JPY pair can be displayed on the right or left hand side ( this can be edited in the Options tab of the study settings) and has indicators for the current prices.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FW1TedfiGdWiWL9rMPO4k%2Fimage.png?alt=media&#x26;token=494a04d1-e678-4a2b-a529-463b137a8ce6" alt=""><figcaption></figcaption></figure>

With **Auto Scale** enabled, dragging the chart left or right will automatically scale the values for the overlay.

The vertical scale of the overlay can be adjusted by clicking and dragging the space between the overlay axis and the price plot. Dragging from the top or bottom will add more top/bottom space. Drag from the middle to adjust both at the same time.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FuzIfAg8k1yIDgFcuVCbQ%2Fimage.png?alt=media&#x26;token=9c7e17b5-6599-4df0-b2df-38dc37c13da7" alt=""><figcaption></figcaption></figure>

If auto scale is disabled, you can click and drag the overlay up or down to adjust the location of the overlay relative to the main instrument axis.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2F17Wg2Mpw3pMEpkbGN0ed%2Fimage.png?alt=media&#x26;token=1cc02107-17e8-404d-9bd4-a583a9871a5f" alt=""><figcaption></figcaption></figure>

The horizontal location of the overlay can be adjusted by changing the value of the Shift field in the **Instrument Overlay** dialog. A positive value will shift the overlay into the future and a negative value will shift it into the past. If you uncheck the **Lock Shift** option you will be able to adjust the shift by dragging the overlay to the left or right with the mouse.

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FmVwap4fZoEEvbFpCe55L%2Fimage.png?alt=media&#x26;token=5ecde650-4b05-457d-a194-6c9be7585a11" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2457682635-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTKkuQ4IBYTTbN0oyR7L0%2Fuploads%2FthQa6qTgDmTF18aV2tZi%2Fimage.png?alt=media&#x26;token=37712d66-e7cc-474d-82d7-ab41331fbcfd" alt=""><figcaption></figcaption></figure>
