/*********************************************************************************************** Title: Volume Profile Segment Indicator for eSignal By: Divergence Software, Inc. Web: http://www.sr-analyst.com ================================================================================================ Project Description: Create volume profiles (including volume histogram, upper value area, lower value area, and POC) based on user-defined segments of price data. Uses eSignal mouse interface. Profiles can be created using volume (the default) or using price. If the indicator is loaded into a symbol that does not report volume, it will automatically use price to create the profile. To create a new volume profile, click once on the "Vps" button at bottom-left of your chart. The "Vps" button background will change to a darker color to acknowledge that it has been clicked. Then click once on the first bar in the range, then click once on the second bar in the range. The volume profile will be created based on your selected range and displayed. To remove an existing volume profile, just click once on any of the price text associated with that profile (i.e., text on the UVA line, the LVA line, or the POC line). Important!!: If you are using eSignal v11/v12 you must hold down the SHIFT key prior to clicking on the "Vps" button or clicking on the bars to set the range. This is not required in eSignal v10. You can create as many volume profiles as you like on any chart by following the steps above. These profiles will be preserved between sessions, or when you change symbols. Indicator Parameters: Profile Logic: Select from "Use Volume" and "Use Price". If "Use Price" is selected then the the profile will be created using price instead of volume. This means that the indicator can be used with symbols that do not report volume. Tick Value Identification: This parameter allows you to quickly select between the Auto-Detect feature (which will attempt to calculate the correct Tick Value for the security you are charting automatically) and the Override feature (which allows you to input custom Tick Value and Precision values). Typically, you would want to leave this parameter at its default setting. If you need to enter a custom Tick Value (if, for example, the study's auto- detect feature calculated an incorrect Tick Value for the security you are charting), you should select the "Override" option and manually enter the correct Tick Value and decimal precision in the Tick Value (Override) and Precision (Override) parameter fields respectively. Tick Value (Override): This parameter is only active if the Tick Value Identification parameter has been set to the "Override" value. Enter the tick value of the instrument that you are charting. Valid range is from 0.0001 to 100.0. Precision (Override): This parameter is only active if the Tick Value Identification parameter has been set to the "Override" value. Select the precision you would like to use in the calculations. Precision is the number of decimals to the right of the decimal point. If you entered a Tick Value of 0.001 you would want to set the Precision parameter to 3 (e.g., there are 3 digits to the right of the decimal point in 0.001). Value Area Calculation: Select the algorithm you would like the study to use when performing the Value Area calculations. You can select from "Percent Method" or "StdDev Method". Percentage: The percentage to use when calculating the Value Area if "Percent Method" is chosen as the Value Area calculation method. The default is 0.7 (i.e., 70%). StdDevs: The number of standard deviations to use when calculating the Value Area if "StdDev Method" is chosen as the Value Area calculation method. The default is 1. Display Value Area: True or False. If you do not want the Upper Value Area (UVA) and Lower Value Area (LVA) lines displayed, set this option to false. UVA Color: The plot color to use for the Upper Value Area. Default is blue. Thickness: The plot thickness to use for the Upper Value Area. Default is 2. Line Style: The line style to use for the Upper Value Area. Select from "Solid", "Dot", "Dash", "DashDot", and "DashDotDot" The default is "Solid". Text Location: The location on the line where the price value should be displayed. Select from "Right-side flush", "Left-side flush", or "Centered". Default is "Right-side flush". LVA Color: The plot color to use for the Lower Value Area. Default is teal. Thickness: The plot thickness to use for the Lower Value Area. Default is 2. Line Style: The line style to use for the Lower Value Area. Select from "Solid", "Dot", "Dash", "DashDot", and "DashDotDot" The default is "Solid". Text Location: The location on the line where the price value should be displayed. Select from "Right-side flush", "Left-side flush", or "Centered". Default is "Right-side flush". POC Color: The plot color to use for the Point of Control. Default is magenta. Thickness: The plot thickness to use for the Point of Control. Default is 2. Line Style: The line style to use for the Lower Value Area. Select from "Solid", "Dot", "Dash", "DashDot", and "DashDotDot" The default is "Dash". Text Location: The location on the line where the price value should be displayed. Select from "Right-side flush", "Left-side flush", or "Centered". Default is "Centered". Extend POC?: True or False. Select True to extend the POC line forward to the current price bar. Extend LVA/UVA?: True or False. Select True to extend the LVA and UVA lines forward to the current price bar. Bars Past Current: Number of bars past the current price bar to extend the POC and/or LVA/UVA lines if their respective extend options are set to True. Display Frame around Segment?: True or False. Select true to draw a frame around the entire segment for highlighting purposes. The default is true. Frame Color: The color to use when drawing the frame. Default is light-grey. Thickness: The line thickness to use when drawing the frame. Default is 1. Line Style: The line style to use when drawing the frame. Select from "Solid", "Dot", "Dash", "DashDot", and "DashDotDot" The default is "Dot". Display Histogram?: True or False. Select true to draw the volume profile histogram. Select false and the histogram will not be drawn. Default is true. Show Volume Above/ Below POC?: True or False. Select true to draw the total volume above and below the POC. Default is true. Histogram Location: Select from "After Last Bar - Right", "After Last Bar - Left", "On Last Bar - Left", "On First Bar - Right", "Before First Bar - Right", and "Before First Bar - Left". Default is "After Last Bar - Right". Histogram Color: Select the color in which the histogram will be plotted. Default is blue. Thickness: The line thickness to use when drawing the histogram. Default is 1. Line Style: The line style to use when drawing the histogram. Select from "Solid", "Dot", "Dash", "DashDot", and "DashDotDot" The default is "Solid". Display Window Size: Select the window size (in bars) to use for displaying the histogram. The histogram displays the volume traded at each price level relative to all of the other price levels in the histogram. So if the window size is set to 30 bars, then the price level with the highest volume will have a histogram line that is 30-bars long, and all of the other histogram lines will be calculated as a ratio of that longest line. Default is 30. Text Color: The color to use for all text display in the indicator. Default is black. Font Size: Select the font size to use for displaying text. You can select a value between 4 and 55. The default is 8. Button FG Color: The foreground color to use when displaying the activator button. Default is white. Button BG Color: The background color to use when displaying the activator button. Default is light-blue. Vert Offset: Adjust the vertical position of the activator button by setting the number of pixels. The default is 15. Horz Offset: Adjust the horizontal position of the activator button by setting the number of pixels. The default is 1. Disclaimer: For educational purposes only! Obviously, no guarantees whatsoever and use at your own risk. **********************************************************************/