volume profile ranking indicator

📌 Introduction
This script implements a volume profile ranking indicato for TradingView. It is designed to visualize the distribution of traded volume over price levels within a defined historical window. Unlike TradingView’s built-in Volume Profile, this script gives full customization of the profile drawing logic, binning, color gradient, and the ability to anchor the profile to a specific date.

⚙️ How It Works (Logic)
1. Inputs
➤POC Lookback Days (lookback): Defines how many bars (days) to look back from a selected point to calculate the volume distribution.

➤Bin Count (bin_count): Determines how many price bins (horizontal levels) the price range will be divided into.

➤Use Custom Lookback Date (useCustomDate): Enables/disables manually selecting a backtest start date.

➤Custom Lookback Date (customDate): When enabled, the profile will calculate volume based on this date instead of the most recent bar.

2. Target Bar Determination
➤If a custom date is selected, the script searches for the bar closest to that date within 1000 bars.

➤If not, it defaults to the latest bar (bar_index).

➤The profile is drawn only when the current bar is close to the target bar (within ±2 bars), to avoid unnecessary recalculations and performance issues.

3. Volume Binning
➤The price range over the lookback window is divided into bin_count segments.

➤For each bar within the lookback window, its volume is added to the appropriate bin based on price.

➤If the price falls outside the expected range, it is clamped to the first or last bin.

4. Ranking and Sorting
➤A bubble sort ranks each bin by total volume.

➤The most active bin (POC, or Point of Control) is highlighted with a thicker bar.

5. Rendering
➤Horizontal bars (line.new) represent volume intensity in each price bin.

➤Each bar is color-coded by volume heat: more volume = more intense color.

➤Labels (label.new) show:

➤Total volume

➤Rank

➤Percentage of total volume

➤Price range of the bin

🧑‍💻 How to Use
1. Add the Script to Your Chart
➤Copy the code into TradingView’s Pine Script editor and add it to your chart.

2. Set Lookback Period

➤Default is 252 bars (about one year for daily charts), but can be changed via the input.

3. (Optional) Use Custom Date

●Toggle "Use Custom Lookback Date" to true.

➤Pick a date in the "Custom Lookback Date" input to anchor the profile.

4. Analyze the Volume Distribution

➤The longest (thickest) red/orange bar represents the Point of Control (POC) — the price with the most volume traded.

➤Other bars show volume distribution across price.

➤Labels display useful metrics to evaluate areas of high/low interest.

✅ Features
🔶 Customizable anchor point (custom date).

🔶Adjustable bin count and lookback length.

🔶 Clear visualization with heatmap coloring.

🔶 Lightweight and performance-optimized (especially with the shouldDrawProfile filter)