cumproduct.json

{
    "id": "cumproduct",
    "summary": "Cumulative products",
    "description": "Computes cumulative products of an array of numbers. Every computed element is equal to the product of the current and all previous values. The returned array and the input array have always the same length.\n\nBy default, no-data values are skipped, but stay in the result. Setting the `ignore_nodata` flag to `true` makes that once a no-data value (`null`) is reached all following elements are set to `null` in the result.",
    "categories": [
        "math > cumulative"
    ],
    "experimental": true,
    "parameters": [
        {
            "name": "data",
            "description": "An array of numbers.",
            "schema": {
                "type": "array",
                "items": {
                    "type": [
                        "number",
                        "null"
                    ]
                }
            }
        },
        {
            "name": "ignore_nodata",
            "description": "Indicates whether no-data values are ignored or not and ignores them by default. Setting this flag to `false` considers no-data values so that `null` is set for all the following elements.",
            "schema": {
                "type": "boolean"
            },
            "default": true,
            "optional": true
        }
    ],
    "returns": {
        "description": "An array with the computed cumulative products.",
        "schema": {
            "type": "array",
            "items": {
                "type": [
                    "number",
                    "null"
                ]
            }
        }
    },
    "examples": [
        {
            "arguments": {
                "data": [
                    1,
                    3,
                    5,
                    3,
                    1
                ]
            },
            "returns": [
                1,
                3,
                15,
                45,
                45
            ]
        },
        {
            "arguments": {
                "data": [
                    1,
                    2,
                    3,
                    null,
                    3,
                    1
                ]
            },
            "returns": [
                1,
                2,
                6,
                null,
                18,
                18
            ]
        },
        {
            "arguments": {
                "data": [
                    1,
                    2,
                    3,
                    null,
                    3,
                    1
                ],
                "ignore_nodata": false
            },
            "returns": [
                1,
                2,
                6,
                null,
                null,
                null
            ]
        }
    ]
}