Added a new control parameter for hybrid inverters and prepared a new version

Author: davidusb-geek

emhass/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.10.0 - 2024-06-02
+### BREAKING CHANGE
+- In this new version we have added support for PV curtailment computation. While doing this the nominal PV peak power is needed. The easiest way find this information is by directly using the `inverter_model` defined in the configuration. As this is needed in the optimization to correctly compute PV curtailment, this parameter need to be properly defined for your installation. Before this chage this parameter was only needed if using the PV forecast method `scrapper`, but now it is not optional as it is directly used in the optimization. 
+Use the dedicated webapp to find the correct model for your inverter, if you cannot find your exact brand/model then just pick an inverter with the same nominal power as yours: [https://emhass-pvlib-database.streamlit.app/](https://emhass-pvlib-database.streamlit.app/)
+### Improvement
+- Added support for hybrid inverters and PV curtailment computation
+- Implemented a new `continual_publish` service that avoid the need of setting a special automation for data publish. Thanks to @GeoDerp
+- Implement a deferrable load start penalty functionality. Thanks to @werdnum
+  - This feature also implement a `def_current_state` that can be passed at runtime to let the optimization consider that a deferrable load is currently scheduled or under operation when launching the optimization task
+### Fix
+- Fixed forecast methods to treat delta_forecast higher than 1 day
+- Fixed solar.forecast wrong interpolation of nan values
+
 ## 0.9.1 - 2024-05-13
 ### Fix
 - Fix patch for issue with paths to modules and inverters database

emhass/DOCS.md

@@ -100,16 +100,19 @@ The complete list of supported modules can be found here: [https://github.com/da
 
 And the list of inverter models can be found here: [https://github.com/davidusb-geek/emhass-add-on/files/9532724/sam-library-cec-inverters-2019-03-05.csv](https://github.com/davidusb-geek/emhass-add-on/files/9532724/sam-library-cec-inverters-2019-03-05.csv)
 
+This webapp can help you find your correct module/inverter key: [https://emhass-pvlib-database.streamlit.app/](https://emhass-pvlib-database.streamlit.app/)
+
 If your specific model is not found in these lists then solution (1) is to pick another model as close as possible as yours in terms of the nominal power.
 
 Solution (2) would be to use SolCast and pass that data directly to emhass as a list of values from a template. Take a look at this example here: [https://emhass.readthedocs.io/en/latest/forecasts.html#example-using-solcast-forecast-amber-prices](https://emhass.readthedocs.io/en/latest/forecasts.html#example-using-solcast-forecast-amber-prices)
 
-- pv*module_model: The PV module model. For example: 'CSUN_Eurasia_Energy_Systems_Industry_and_Trade_CSUN295_60M'. This parameter can be a list of strings to enable the simulation of mixed orientation systems, for example one east-facing array (azimuth=90) and one west-facing array (azimuth=270). When finding the correct model for your installation remember to replace all the special characters in the model name by '*'.
-- pv*inverter_model: The PV inverter model. For example: 'Fronius_International_GmbH**Fronius_Primo_5_0_1_208_240**240V*'. This parameter can be a list of strings to enable the simulation of mixed orientation systems, for example one east-facing array (azimuth=90) and one west-facing array (azimuth=270). When finding the correct model for your installation remember to replace all the special characters in the model name by '\_'.
+- pv_module_model: The PV module model. For example: 'CSUN_Eurasia_Energy_Systems_Industry_and_Trade_CSUN295_60M'. This parameter can be a list of strings to enable the simulation of mixed orientation systems, for example one east-facing array (azimuth=90) and one west-facing array (azimuth=270). When finding the correct model for your installation remember to replace all the special characters in the model name by '_'.
+- pv_inverter_model: The PV inverter model. For example: 'Fronius_International_GmbH__Fronius_Primo_5_0_1_208_240__240V_'. This parameter can be a list of strings to enable the simulation of mixed orientation systems, for example one east-facing array (azimuth=90) and one west-facing array (azimuth=270). When finding the correct model for your installation remember to replace all the special characters in the model name by '_'.
 - surface_tilt: The tilt angle of your solar panels. This is a value between 0 and 90. Defaults to 30. This parameter can be a list of integers to enable the simulation of mixed orientation systems, for example one east-facing array (azimuth=90) and one west-facing array (azimuth=270).
 - surface_azimuth: The azimuth of your PV installation. This is a value between 0 and 360. Defaults to 205. This parameter can be a list of integers to enable the simulation of mixed orientation systems, for example one east-facing array (azimuth=90) and one west-facing array (azimuth=270).
 - modules_per_string: The number of modules per string. Defaults to 16. This parameter can be a list of integers to enable the simulation of mixed orientation systems, for example one east-facing array (azimuth=90) and one west-facing array (azimuth=270).
 - strings_per_inverter: The number of used strings per inverter. Defaults to 1. This parameter can be a list of integers to enable the simulation of mixed orientation systems, for example one east-facing array (azimuth=90) and one west-facing array (azimuth=270).
+- inverter_is_hybrid: Set to True to consider that the installation inverter is hybrid for PV and batteries. (Default False).
 - set_use_battery: Set to True if we should consider an energy storage device such as a Li-Ion battery. Defaults to False.
 
 If the `set_use_battery` is set to `true`, then the following parameters need to be defined properly. If you don't have a battery then just leave the default values, they will not be used.

emhass/config.yml

@@ -1,7 +1,7 @@
 name: EMHASS
 description: Energy Management for Home Assistant
 url: https://github.com/davidusb-geek/emhass
-version: 0.9.1
+version: 0.10.0
 slug: emhass
 arch:
   - aarch64
@@ -80,6 +80,7 @@ options:
     - modules_per_string: 16
   list_strings_per_inverter:
     - strings_per_inverter: 1
+  inverter_is_hybrid: false
   set_use_battery: false
   battery_nominal_energy_capacity: 5000
 schema:
@@ -148,6 +149,7 @@ schema:
     - modules_per_string: "int(0,)?"
   list_strings_per_inverter:
     - strings_per_inverter: "int(0,)?"
+  inverter_is_hybrid: "bool?"
   set_use_battery: "bool?"
   set_battery_dynamic: "bool?" #optional
   battery_dynamic_max: "float(0.0,1.0)?" #optional

emhass/config_emhass.yaml

@@ -2,7 +2,7 @@
 
 retrieve_hass_conf:
   freq: 30 # The time step to resample retrieved data from hass in minutes
-  days_to_retrieve: 8 # We will retrieve data from now and up to days_to_retrieve days
+  days_to_retrieve: 2 # We will retrieve data from now and up to days_to_retrieve days
   var_PV: 'sensor.power_photovoltaics' # Photovoltaic produced power sensor in Watts
   var_load: 'sensor.power_load_no_var_loads' # Household power consumption sensor in Watts (deferrable loads should be substracted)
   load_negative: False # Set to True if the retrived load variable is negative by convention
@@ -13,6 +13,7 @@ retrieve_hass_conf:
   - 'sensor.power_photovoltaics'
   - 'sensor.power_load_no_var_loads'
   method_ts_round: 'nearest' # Set the method for timestamp rounding, options are: first, last and nearest
+  continual_publish: False # Save published sensor data and check for state change every freq minutes
 
 optim_conf:
   set_use_battery: False # consider a battery storage
@@ -76,6 +77,7 @@ plant_conf:
   - 16 
   strings_per_inverter: # The number of used strings per inverter
   - 1
+  inverter_is_hybrid: False # Set if it is a hybrid inverter (PV+batteries) or not
   Pd_max: 1000 # If your system has a battery (set_use_battery=True), the maximum discharge power in Watts
   Pc_max: 1000 # If your system has a battery (set_use_battery=True), the maximum charge power in Watts
   eta_disch: 0.95 # If your system has a battery (set_use_battery=True), the discharge efficiency

emhass/requirements.txt

@@ -16,5 +16,5 @@ flask>=2.0.3
 waitress>=2.1.1
 plotly>=5.6.0
 #EMHASS
-emhass==0.9.1
+emhass==0.10.0
 #git+https://github.com/davidusb-geek/emhass

emhass/translations/en.yaml

@@ -147,7 +147,7 @@ configuration:
     name: list_pv_module_model, (method=scrapper/solar.forecast) A list of the PV module model
     description: For example 'CSUN_Eurasia_Energy_Systems_Industry_and_Trade_CSUN295_60M'. This parameter can be a list of strings to enable the simulation of mixed orientation systems, for example one east-facing array (azimuth=90) and one west-facing array (azimuth=270). When finding the correct model for your installation remember to replace all the special characters in the model name by '_'.
   list_pv_inverter_model:
-    name: list_pv_inverter_model, (method=scrapper) A list of the PV inverter model
+    name: list_pv_inverter_model, (method=all methods, used in the optimization to set the PV peak power) A list of the PV inverter model
     description: For example 'Fronius_International_GmbH__Fronius_Primo_5_0_1_208_240__240V_'. This parameter can be a list of strings to enable the simulation of mixed orientation systems, for example one east-facing array (azimuth=90) and one west-facing array (azimuth=270). When finding the correct model for your installation remember to replace all the special characters in the model name by '_'.
   list_surface_tilt:
     name: list_surface_tilt, (method=scrapper/solar.forecast) The tilt angle of your solar panels
@@ -161,6 +161,9 @@ configuration:
   list_strings_per_inverter:
     name: list_strings_per_inverter, (method=scrapper) The number of used strings per inverter
     description: (Default 1). This parameter can be a list of integers to enable the simulation of mixed orientation systems, for example one east-facing array and one west-facing array.
+  inverter_is_hybrid:
+    name: inverter_is_hybrid, Set to True if it is a hybrid inverter (PV+batteries) or not
+    description: Set to True to consider that the installation inverter is hybrid for PV and batteries. (Default False).
   set_use_battery:
     name: set_use_battery, Set if a battery is present
     description: Set to True if we should consider an energy storage device such as a Li-Ion battery. (Default False).