fit_curve.json

{
    "id": "fit_curve",
    "summary": "Curve fitting",
    "description": "Use non-linear least squares to fit a model function `y = f(x, parameters)` to data.",
    "categories": [
        "arrays",
        "math"
    ],
    "experimental": true,
    "parameters": [
        {
            "name": "data",
            "description": "A labeled array, the labels correspond to the variable `y` and the values correspond to the variable `x`.",
            "schema": {
                "type": "array",
                "subtype": "labeled-array",
                "items": {
                    "type": "number"
                }
            }
        },
        {
            "name": "parameters",
            "description": "Defined the number of parameters for the model function and provides an initial guess for them. At least one parameter is required.",
            "schema": {
                "type": "array",
                "minItems": 1,
                "items": {
                    "type": "number"
                }
            }
        },
        {
            "name": "function",
            "description": "The model function. It must take the parameters to fit as array through the first argument and the independent variable `x` as the second argument.\n\nIt is recommended to store the model function as a user-defined process on the back-end to be able to re-use the model function with the computed optimal values for the parameters afterwards.",
            "schema": {
                "type": "object",
                "subtype": "process-graph",
                "parameters": [
                    {
                        "name": "x",
                        "description": "The value for the independent variable `x`.",
                        "schema": {
                            "type": [
                                "number",
                                "null"
                            ]
                        }
                    },
                    {
                        "name": "parameters",
                        "description": "The parameters for the model function, contains at least one parameter.",
                        "schema": {
                            "type": "array",
                            "minItems": 1,
                            "items": {
                                "type": "number"
                            }
                        }
                    }
                ],
                "returns": {
                    "description": "The computed value `y` value for the given independent variable `x` and the parameters.",
                    "schema": {
                        "type": "number"
                    }
                }
            }
        },
        {
            "name": "ignore_nodata",
            "description": "Indicates whether no-data values are ignored or not. Ignores them by default. Setting this flag to `false` considers no-data values so that `null` is passed to the model function.",
            "schema": {
                "type": "boolean"
            },
            "default": true,
            "optional": true
        }
    ],
    "returns": {
        "description": "An array with the optimal values for the parameters.",
        "schema": {
            "type": "array",
            "minItems": 1,
            "items": {
                "type": "number"
            }
        }
    }
}