
    i                     z    S SK Jr  S SKJr  S SKJrJr  S SKJr  S SK	J
r
JrJrJr    SS\S\S	\S
\S\S\4S jjrg)    )Series)pstdev)DictLikeInt)ma)v_mamodev_offsetv_pos_defaultv_seriesNvolumelengthmamodeoffsetkwargsreturnc                 h   [        US5      n[        X!5      n[        X5      n[        X5      n U c  g[        US5      n[	        U5      n[        X0US9nX-
  [        X5      -  nUS:w  a  UR                  U5      nSU;   a  UR                  US   SS9  S	U 3n	X:X  a  U	OU	 S
U 3Ul	        SUl
        U$ )a'  Volume Heatmap

This indicator attempts to quantify volume trend strength of
specified length.

Sources:
    * [tradingview](https://www.tradingview.com/script/unWex8N4-Heatmap-Volume-xdecow/)

Parameters:
    volume (Series): ```volume``` Series
    length (int): The period. Default: ```610```
    std_length (int): Standard devation. Default: ```610```
    mamode (str): Mean MA. See ```help(ta.ma)```. Default: ```"sma"```
    offset (int): Post shift. Default: ```0```

Other Parameters:
    fillna (value): ```pd.DataFrame.fillna(value)```

Returns:
    (Series): 1 column

Note: Signals
    - Extremely Cold: ```vhm <= -0.5```
    -           Cold: ```-0.5 < vhm <= 1.0```
    -         Medium: ```1.0 < vhm <= 2.5```
    -            Hot: ```2.5 < vhm <= 4.0```
    -  Extremely Hot: ```vhm >= 4```
ib  Nsma)r   r   fillnaT)inplaceVHM__r   )r
   maxr   r   r	   r   r   shiftr   namecategory)
r   r   
std_lengthr   r   r   _lengthmuvhm_propss
             O/var/www/html/trading/venv/lib/python3.13/site-packages/pandas_ta/volume/vhm.pyr   r      s    B 63'Fz2J&%Gf&F~fe$FfF 
F6	*B;&4
4C {ii 6

6(#T
2 F8_F-vfXQzl3KCHCLJ    )NNNN)pandasr   
statisticsr   pandas_ta._typingr   r   pandas_ta.mar   pandas_ta.utilsr   r	   r
   r   strr    r"   r!   <module>r*      sZ      +   :>*.== #==$'=:B= 
=r"   