Analysis and instructions for use about built-in function _Cross

Author: Lydia, Created: 2023-10-07 15:35:44, Updated:

Analysis and instructions for use about built-in function _Cross

The _Cross function in the Global Functions section of the API documentation is used to calculate the crossover state of the two indicators.

The function implementation is similar to the following code:

Note that when arr1 is defined as an array of fast indicators and arr2 as an array of slow indicators, the value returned by the _Cross function is positive, i.e., according to the documentation, a positive number is the period of upward penetration, a negative number indicates the period of downward penetration, and 0 means the same as the current price. It can be seen, at this time arr1 upward penetrated the arr2 has been n cycles, at this time, it’s the fast line upward penetration the slow line, representing a crossup. The same _Cross function returns a negative number, that is, a crossdown.

The opposite is true if arr1 is defined as an array of slow indicators and arr2 as an array of fast indicators. A positive value returned by the _Cross function represents a crossdown. A negative value returned by the _Cross function represents a crossup.

// Return to the number of periods of upward penetration, the positive number is the number of periods of upward penetration, the negative number indicates the number of periods of downward penetration, 0 means the same as the current price
$.Cross = function(arr1, arr2) {            // The number of parameters is 2, it can be seen from the parameter name, these two parameters should be an array type, the array is like an array in the X-axis for the array index value, Y-axis for the index value of the line in the coordinate system, the function is to determine the intersection of the two lines 
    if (arr1.length !== arr2.length) {      // The first step is to determine if the two arrays being compared are equal in length
        throw "array length not equal";     // Throw an error if they are not equal, it is not possible to determine the intersection of unequal lines.
    }
    var n = 0;                              // Declare the variable n to record the intersection state, initially 0, unintersected 
    for (var i = arr1.length-1; i >= 0; i--) {      // Iterate over the array arr1, from the last element forward.
        if (typeof(arr1[i]) !== 'number' || typeof(arr2[i]) !== 'number') { // When any of the arrays arr1 or arr2 is of a non-numeric type (i.e., an invalid indicator), the traversal loop is broken.
            break;                                  // break out of a loop
        }
        if (arr1[i] < arr2[i]) {                    // If arr1 is smaller than arr2 then n--, will record the relative state of arr1, arr2 at the beginning, (i.e., at the beginning n will adjust itself according to the relative sizes of arr1[i], arr2[i], and once there is another relationship between the sizes of arr1[i], arr2[i] opposite to the state of n, i.e., a crossing of the two lines has occurred.)
            if (n > 0) {
                break;
            }
            n--;
        } else if (arr1[i] > arr2[i]) {             // If arr1 is greater than arr2 then n++
            if (n < 0) {
                break;
            }
            n++;
        } else {                                    // arr1[i] == arr2[i], then immediately break
            break;
        }
    }
    return n;                                       // Returns the value of n, which represents the number of periods that have been crossed, and 0, which means that the indicator values are equal.
};

Let’s simulate a set of data passed into this parameter and see how it turns out

var arr1 = [1,2,3,4,5,6,8,8,9]     // fast line indicator
var arr2 = [2,3,4,5,6,7,7,7,7]     // slow line indicator
function main(){
    Log("_Cross(arr1, arr2) : ", _Cross(arr1, arr2))
    Log("_Cross(arr2, arr1) : ", _Cross(arr2, arr1))
}

img

We can see the results are 3, -3.

img

As you we see in the chart, the crossover occurs in front of three K-line bars.


More