# Calibrate heat pump models

class PythonModel.calibrate.ManufacturerData(manufacturer, model, CoolingMode=False)

  Bases: `object`

  Heat pump performance data.

  Parameters:

    - manufacturer – Name of the manufacturer.

    - model – Name of the heat pump model.

    - CoolingMode – Boolean, set to True if heat pump is used in cooling mode.

  Note

  An empty heat pump performance object is created.

  add_data_point(EWT_Source, EWT_Load, flowSource, flowLoad, Capacity, HR, Power)

    Add a data point to the heat pump performance data.

    Parameters:

      - EWT_Source – Entering water temperature on the source side (K).

      - EWT_Load – Entering water temperature on the load side (K).

      - flowSource – Fluid mass flow rate on the source side (kg/s).

      - flowLoad – Fluid mass flow rate on the load side (kg/s).

      - Capacity – Heat pump capacity (kW).

      - HR – Heat transfer rate on the source side (kW).

      - Power – Power input to the heat pump (kW).

  calibration_data_16_points()

    Find the 16 min/max data points.

    Returns:

      Performance data for calibration (object).

    Note

    This method returns a subsample of the performance data corresponding to the combination of minimums and maximums of the inlet water temperatures and mass flow rates on the source and load sides.

  calibration_data_min_max_temp()
    Find the data points that correspond to the minimum and maximum

      inlet water temperature on the source and load sides.

    Returns:

      Performance data for calibration (object).

    Note

    This method returns a subsample of the performance data corresponding to the combination of minimums and maximums of the inlet water temperatures on the source and load sides.

  write_modelica_combiTimeTable(tableName, tableTempDir, tableFileName, CoolingMode)
    Write the combiTimeTable for use by the calibration model in

      Modelica.

    Parameters:

      - tableName – Name of the combiTimeTable.

      - tableTempDir – Temporary directory to write the table file.

      - tableFileName – Name of the text file containing the combiTimeTable.

      - CoolingMode – Boolean, set to True if heat pump is used in cooling mode.

class PythonModel.calibrate.SimulationResults(EWT_Source, EWT_Load, flowSource, flowLoad, Capacity, HR, Power, name)

  Bases: `object`

  Results from the simulation model.

  Parameters:

    - EWT_Source – Array of entering water temperature on the source side (K).

    - EWT_Load – Array of entering water temperature on the load side (K).

    - flowSource – Array of fluid mass flow rate on the source side (kg/s).

    - flowLoad – Array of fluid mass flow rate on the load side (kg/s).

    - Capacity – Array of heat pump capacity (W).

    - HR – Array of heat transfer rate on the source side (W).

    - Power – Array of power input to the heat pump (W).

    - name – Name of the heat pump.

PythonModel.calibrate.calibrate_model(heaPum, calData, data, plot=True)

  Manages the calibration of heat pump models.

  Parameters:

    - heaPum – Heat pump model (object).

    - calData – Subsampled data used for calibration (object).

    - data – Full data used for final comparison (object).

    - plot – Boolean, set to True to draw and save results.

  Returns:

    List of calibrated parameters, Results from the calibrated model, Results using the initial guess parameters.

PythonModel.calibrate.compare_data_sets(data, refData, plot=False, fname='ComparedDataSets')

  Compare two sets of data.

  Parameters:

    - data – Performance data (object).

    - refData – Reference performance data (object).

    - plot – Boolean, set to True to draw and save results.

    - fname – Name of the output figure file (no extension).

  Returns:

    Sum of normalized square errors between data sets.

PythonModel.calibrate.cost_function(scale, guess, heaPum, data)

  Evaluate the cost function for optimization.

  Parameters:

    - scale – Array of normalized parameters.

    - guess – Array of guess parameters.

    - heaPum – Heat pump model (object).

    - data – Reference performance data (object).

  Returns:

    Sum of normalized square errors between model and reference data.

  Note

  Parameters are evaluated by multiplying the corresponding normalized parameter with its guess value.

PythonModel.calibrate.simulate(heaPum, data)

  Evaluate the heat pump performance from the model.

  Parameters:

    - heaPum – Heat pump model (object).

    - data – Reference performance data (object).

  Returns:

    Performance data of the modeled heat pump (object).

  Note

  Performance data from the model is evaluated at the same operating conditions (inlet water temperatures and mass flow rates at the source and load sides) as in the reference data.

PythonModel.calibrate.simulate_in_dymola(heaPum, data, tableName, tableFileName)

  Evaluate the heat pump performance from the model in Dymola.

  Parameters:

    - heaPum – Heat pump model (object).

    - data – Reference performance data (object).

    - tableName – Name of the combiTimeTable.

    - tableFileName – Name of the text file containing the combiTimeTable.

  Returns:

    Performance data of the modeled heat pump (object).

  Note

  Performance data from the model is evaluated at the same operating conditions (inlet water temperatures and mass flow rates at the source and load sides) as in the reference data.