Common Functions

2022년 3월 6일

Library "CommonFunctions"
This Library provides some handy functions commonly used in Pine Script.

crosses(source1, offset1, source2, offset2) Checks the existance of crosses between the series
  Parameters:
    source1: First series
    offset1: (Optional) Offset of First series. By default 0
    source2: (Optional) Second series. By default 'close' price
    offset2: (Optional) Offset of Second series. By default 0
  Returns: [cross, crossOver, crossUnder]

marketState(source1, offset1, source2, offset2) Determines Bullish/Bearish state according to the relative position between the series.
  Parameters:
    source1: Active series used to determine bullish/bearish states.
    offset1: (Optional) Offset of First series. By default 0.
    source2: (Optional) Second series. By default 'close' price.
    offset2: (Optional) Offset of Second series. By default 0.
  Returns: [bullish, bearish]

histProfile(source) Histogram profiling
  Parameters:
    source: Histogram series
  Returns: [histPosUp, histPosDown, histNegUp, histNegDown]

srcSelect(showSrc1, src1, showSrc2, src2) Selects the appropiate source. If multiple sources are activated simultaneously, the order within the switch clause prevails. The first one activated is the one being output.
  Parameters:
    showSrc1: Boolean controlling the activation of Source #1.
    src1: Source #1.
    showSrc2: Boolean controlling the activation of Sources #2-10. By default 'false'.
    src2: Sources #2-10. By default 'number'.
  Returns: Selected source.

2022년 3월 11일

릴리즈 노트

v2

Updated:
histProfile(hist, ref) Histogram profiling
  Parameters:
    hist: Histogram series
    ref: Reference value. By default '0'
  Returns: [histPosUp, histPosDown, histNegUp, histNegDown]

2022년 3월 13일

릴리즈 노트

v3

Added:
floatSelect(showSrc1, src1, showSrc2, src2) Selects the appropiate float variable based on a boolean condition. If multiple sources are activated simultaneously, the order within the switch clause prevails. The first one activated is the one being output.
  Parameters:
    showSrc1: Boolean controlling the activation of Source #1.
    src1: Source #1.
    showSrc2: Boolean controlling the activation of Sources #2-10. By default 'false'.
    src2: Sources #2-10. By default 'number'.
  Returns: Selected source.

intSelect(showSrc1, src1, showSrc2, src2) Selects the appropiate integer variable based on a boolean condition. If multiple sources are activated simultaneously, the order within the switch clause prevails. The first one activated is the one being output.
  Parameters:
    showSrc1: Boolean controlling the activation of Source #1.
    src1: Source #1.
    showSrc2: Boolean controlling the activation of Sources #2-10. By default 'false'.
    src2: Sources #2-10. By default 'number'.
  Returns: Selected source.

boolSelect(showSrc1, src1, showSrc2, src2) Selects the appropiate bool variable based on a boolean condition. If multiple sources are activated simultaneously, the order within the switch clause prevails. The first one activated is the one being output.
  Parameters:
    showSrc1: Boolean controlling the activation of Source #1.
    src1: Source #1.
    showSrc2: Boolean controlling the activation of Sources #2-10. By default 'false'.
    src2: Sources #2-10. By default 'false'.
  Returns: Selected source.

Removed:
srcSelect(showSrc1, src1, showSrc2, src2) Selects the appropiate source based on a boolean variable. If multiple sources are activated simultaneously, the order within the switch clause prevails. The first one activated is the one being output.

2024년 5월 19일

릴리즈 노트

v4

Added:
colorSelect(showSrc1, src1, showSrc2, src2, showSrc3, src3, showSrc4, src4, showSrc5, src5, showSrc6, src6, showSrc7, src7, showSrc8, src8, showSrc9, src9, showSrc10, src10)
  Selects the appropiate color variable based on a boolean condition. If multiple sources are activated simultaneously, the order within the switch clause prevails. The first one activated is the one being output.
  Parameters:
    showSrc1 (simple bool): Boolean controlling the activation of Source #1.
    src1 (color): Source #1.
    showSrc2 (simple bool): Boolean controlling the activation of Sources #2-10. By default 'false'.
    src2 (color): Sources #2-10. By default 'false'.
    showSrc3 (simple bool)
    src3 (color)
    showSrc4 (simple bool)
    src4 (color)
    showSrc5 (simple bool)
    src5 (color)
    showSrc6 (simple bool)
    src6 (color)
    showSrc7 (simple bool)
    src7 (color)
    showSrc8 (simple bool)
    src8 (color)
    showSrc9 (simple bool)
    src9 (color)
    showSrc10 (simple bool)
    src10 (color)
  Returns: Selected source.

2024년 5월 20일

릴리즈 노트

v5

Updated:
crosses(source1, offset1, source2, offset2)
  Checks the existance of crosses between the series
  Parameters:
    source1 (float): First series
    offset1 (int): (Optional) Offset of First series. By default 0
    source2 (float): (Optional) Second series. By default 'close' price
    offset2 (int): (Optional) Offset of Second series. By default 0
  Returns: [cross, crossOver, crossUnder]

marketState(source1, offset1, source2, offset2)
  Determines Bullish/Bearish state according to the relative position between the series.
  Parameters:
    source1 (float): Active used to determine bullish/bearish states.
    offset1 (int): (Optional) Offset of First series. By default 0.
    source2 (float): (Optional) Second series. By default 'close' price.
    offset2 (int): (Optional) Offset of Second series. By default 0.
  Returns: [bullish, bearish]

floatSelect(showSrc1, src1, showSrc2, src2, showSrc3, src3, showSrc4, src4, showSrc5, src5, showSrc6, src6, showSrc7, src7, showSrc8, src8, showSrc9, src9, showSrc10, src10)
  Selects the appropiate float variable based on a boolean condition. If multiple sources are activated simultaneously, the order within the switch clause prevails. The first one activated is the one being output.
  Parameters:
    showSrc1 (bool): Boolean controlling the activation of Source #1.
    src1 (float): Source #1.
    showSrc2 (bool): Boolean controlling the activation of Sources #2-10. By default 'false'.
    src2 (float): Sources #2-10. By default 'number'.
    showSrc3 (bool)
    src3 (float)
    showSrc4 (bool)
    src4 (float)
    showSrc5 (bool)
    src5 (float)
    showSrc6 (bool)
    src6 (float)
    showSrc7 (bool)
    src7 (float)
    showSrc8 (bool)
    src8 (float)
    showSrc9 (bool)
    src9 (float)
    showSrc10 (bool)
    src10 (float)
  Returns: Selected source.

intSelect(showSrc1, src1, showSrc2, src2, showSrc3, src3, showSrc4, src4, showSrc5, src5, showSrc6, src6, showSrc7, src7, showSrc8, src8, showSrc9, src9, showSrc10, src10)
  Selects the appropiate integer variable based on a boolean condition. If multiple sources are activated simultaneously, the order within the switch clause prevails. The first one activated is the one being output.
  Parameters:
    showSrc1 (bool): Boolean controlling the activation of Source #1.
    src1 (int): Source #1.
    showSrc2 (bool): Boolean controlling the activation of Sources #2-10. By default 'false'.
    src2 (int): Sources #2-10. By default 'number'.
    showSrc3 (bool)
    src3 (int)
    showSrc4 (bool)
    src4 (int)
    showSrc5 (bool)
    src5 (int)
    showSrc6 (bool)
    src6 (int)
    showSrc7 (bool)
    src7 (int)
    showSrc8 (bool)
    src8 (int)
    showSrc9 (bool)
    src9 (int)
    showSrc10 (bool)
    src10 (int)
  Returns: Selected source.

boolSelect(showSrc1, src1, showSrc2, src2, showSrc3, src3, showSrc4, src4, showSrc5, src5, showSrc6, src6, showSrc7, src7, showSrc8, src8, showSrc9, src9, showSrc10, src10)
  Selects the appropiate bool variable based on a boolean condition. If multiple sources are activated simultaneously, the order within the switch clause prevails. The first one activated is the one being output.
  Parameters:
    showSrc1 (bool): Boolean controlling the activation of Source #1.
    src1 (bool): Source #1.
    showSrc2 (bool): Boolean controlling the activation of Sources #2-10. By default 'false'.
    src2 (bool): Sources #2-10. By default 'false'.
    showSrc3 (bool)
    src3 (bool)
    showSrc4 (bool)
    src4 (bool)
    showSrc5 (bool)
    src5 (bool)
    showSrc6 (bool)
    src6 (bool)
    showSrc7 (bool)
    src7 (bool)
    showSrc8 (bool)
    src8 (bool)
    showSrc9 (bool)
    src9 (bool)
    showSrc10 (bool)
    src10 (bool)
  Returns: Selected source.

colorSelect(showSrc1, src1, showSrc2, src2, showSrc3, src3, showSrc4, src4, showSrc5, src5, showSrc6, src6, showSrc7, src7, showSrc8, src8, showSrc9, src9, showSrc10, src10)
  Selects the appropiate color variable based on a boolean condition. If multiple sources are activated simultaneously, the order within the switch clause prevails. The first one activated is the one being output.
  Parameters:
    showSrc1 (bool): Boolean controlling the activation of Source #1.
    src1 (color): Source #1.
    showSrc2 (bool): Boolean controlling the activation of Sources #2-10. By default 'false'.
    src2 (color): Sources #2-10. By default 'false'.
    showSrc3 (bool)
    src3 (color)
    showSrc4 (bool)
    src4 (color)
    showSrc5 (bool)
    src5 (color)
    showSrc6 (bool)
    src6 (color)
    showSrc7 (bool)
    src7 (color)
    showSrc8 (bool)
    src8 (color)
    showSrc9 (bool)
    src9 (color)
    showSrc10 (bool)
    src10 (color)
  Returns: Selected source.