h2integrate.converters.hopp.hopp_mgmt

Functions

recreate_hopp_config_for_optimization(...[, ...])	Adjusts the HOPP configuration dictionary for optimization based on system ratings.
run_hopp(hi, project_lifetime[, verbose, ...])
setup_hopp(hopp_config[, pv_rating_kw, ...])

h2integrate.converters.hopp.hopp_mgmt.recreate_hopp_config_for_optimization(hopp_config, pv_rating_kw=None, wind_turbine_rating_kw=None, battery_rating_kw=None, battery_rating_kwh=None)

Adjusts the HOPP configuration dictionary for optimization based on system ratings.

This function modifies the HOPP configuration (hopp_config) to reflect the desired ratings for photovoltaic (PV), wind turbine, and battery systems. It ensures that the configuration adheres to specific tolerances and removes technologies if their ratings fall below certain thresholds. It also sets a range where a lower rating than given will be used so optimization algorithms can adjust ratings, pushing them into feasible ranges or below removal thresholds.

Parameters:

• hopp_config (dict) – The original HOPP configuration dictionary containing site, technology, and cost information.

• pv_rating_kw (float, optional) – Desired system capacity for photovoltaic (PV) in kilowatts. If None, PV configuration remains unchanged in the config dictionary.

• wind_turbine_rating_kw (float, optional) – Desired turbine rating for wind in kilowatts. If None, wind configuration remains unchanged in the config dictionary.

• battery_rating_kw (float, optional) – Desired system capacity for battery in kilowatts. If None, battery configuration remains unchanged in the config dictionary.

• battery_rating_kwh (float, optional) – Desired energy capacity for battery in kilowatt- hours. If None, battery configuration remains unchanged in the config dictionary.

Returns:

dict – A modified copy of the HOPP configuration dictionary with updated system ratings and technology configurations based on the function input values.

Return type:

dict

Notes

• Technologies are removed from the configuration if their ratings fall below the

  smooth_tol threshold.

• Ratings are interpolated between smooth_tol and rating_tol for values within

  this range.

• Cost information related to removed technologies is also removed from the configuration.

• Battery operation and maintenance (O&M) costs are recalculated based on the provided ratings.

Example

updated_config = recreate_hopp_config_for_optimization(
    hopp_config=original_config,
    pv_rating_kw=500,
    wind_turbine_rating_kw=1000,
    battery_rating_kw=200,
    battery_rating_kwh=400,
)

Raises:

• KeyError – If required keys are missing in the hopp_config dictionary.

• TypeError – If the input ratings are not numeric values.

Parameters:

hopp_config (dict)

Return type:

dict

h2integrate.converters.hopp.hopp_mgmt.setup_hopp(hopp_config, pv_rating_kw=None, wind_turbine_rating_kw=None, battery_rating_kw=None, battery_rating_kwh=None, electrolyzer_rating=None, n_timesteps=8760)

h2integrate.converters.hopp.hopp_mgmt.run_hopp(hi, project_lifetime, verbose=True, n_timesteps=8760)