tw.forecast.build_model

tw.forecast.build_model(configuration=dict,dataset=pandas.DataFrame)

Build a forecast model. Submits a model-building job, polls until it completes, and returns the resulting model together with job metadata.

Parameters

configuration : dict

Model configuration payload as expected by the API.

dataset : pandas.DataFrame

Historical time-series data used for training. Must contain a timestamp column and at least one target column.

Returns

dict

A dictionary with keys:

"id" – job identifier (str).

"model" – the trained model object (dict).

"status" – final job status response (dict).

Example Configuration

CODE

forecast_build_model_configuration = {
    'target_column': 'string',
    'categorical_columns': [
        'string'
    ],
    'holiday_column': 'string',
    'prediction_from': {
        'base_unit': 'sample',
        'value': 1
    },
    'prediction_to': {
        'base_unit': 'sample',
        'value': 24
    },
    'target_offsets': 'combined',
    'predictor_offsets': 'common',
    'allow_offsets': True,
    'offset_limit': 0,
    'normalization': True,
    'max_feature_count': 20,
    'transformations': [
        'exponential_moving_average',
        'rest_of_week',
        'periodic',
        'intercept',
        'piecewise_linear',
        'time_offsets',
        'polynomial',
        'identity',
        'simple_moving_average',
        'month',
        'trend',
        'day_of_week',
        'fourier',
        'public_holidays',
        'one_hot_encoding'
    ],
    'daily_cycle': True,
    'confidence_level': 90,
    'data_alignment': [
        {
            'column_name': 'string',
            'timestamp': 'yyyy-mm-dd hh:mm:ssZ'
        }
    ]
}

Example Usage

CODE

forecast_build_model_response = tw.forecast.build_model(
    configuration = forecast_build_model_configuration,
    dataset = dataset
)

Example Output

CODE

forecast_build_model_id = forecast_build_model_response['id']
forecast_build_model_model = forecast_build_model_response['model']
forecast_build_model_status = forecast_build_model_response['status']