Skip to main content

What are model inputs

Every forecasting model is driven by input data, mainly weather variables coming from numerical weather prediction models. A single forecasting model can combine several weather sources at the same time, so that it does not depend on one weather provider alone. The Get Model Input endpoint returns the input data of the model’s latest run. It is useful when you want to inspect the weather that a forecast was based on, for example when investigating a large forecast error. To get the output which the model produced from these inputs, see how to get model output.

How to query the model inputs

The only parameter you need to provide is the model ID, which you can retrieve with the List Site Models endpoint, as described in Step 1 of the model output guide. The endpoint takes no further request parameters. It always returns the inputs of the most recent model run, with the target times in UTC.
Get model inputs
In the response example below the arrays are truncated to five time steps.
Response example
The response contains the following fields:
dataframe: A serialized table with one column per input feature, plus a valid_time column which contains the target times, i.e. the periods which are forecasted.
metadata: The data type of every input feature, for example numeric for the weather variables.
Each input feature is named after the weather source it comes from and the weather variable it holds, separated by an underscore. In the example above the model is driven by SolarDownwardRadiation from four different weather sources, DWDOM, ECHRESOM, GFSOM and HIRESMEPSOM.

Load the inputs into a DataFrame

The dataframe field is column oriented, so it can be handed straight to pandas.
Load model inputs into a DataFrame