New controls

[mnblonsky]

Addresses #103 and #77

• [x] Reference the issue your PR is fixing
• [x] Assign at least 1 reviewer for your PR
• [x] Test with run_dwelling.py or other script
• [x] Update documentation as appropriate
• [x] Update changelog as appropriate

[mnblonsky]

Copying list from #103 with added controls

• HVAC:
  • [x] Setpoint
  • [x] Deadband
  • [ ] Max Power
  • [x] Max Capacity?, see #72
• Water Heating
  • [x] Setpoint, see #77
  • [x] Deadband
  • [x] Max Power
  • [ ] Max Capacity?
• EV
  • [x] Max Power (in addition to P Setpoint)
  • [x] Max SOC
  • [x] SOC Setpoint
• Battery
  • [x] P Setpoint
  • [x] SOC Setpoint
  • [x] Min/Max SOC (for self consumption mode)
  • [x] Import/Export limit (for self consumption mode)
  • [ ] Min/Max Power? (for self consumption mode
• PV
  • [ ] Max Power (i.e., P Setpoint)
  • [ ] Q Setpoint

[mnblonsky]

Note that Max Power for HPWH won't work for HP mode. It's tricky to implement for long time steps when the HPWH is in HP mode part time and ER mode part time. We probably want to limit the average power across the time step, which could mean lowering the ER time and increasing the HP time. Might be best to keep this out for now until there's a need.

[jmaguire1]

Note that Max Power for HPWH won't work for HP mode. It's tricky to implement for long time steps when the HPWH is in HP mode part time and ER mode part time. We probably want to limit the average power across the time step, which could mean lowering the ER time and increasing the HP time. Might be best to keep this out for now until there's a need.

Agreed, I think we just don't allow this for the time being, unless there's a real need for it. Most of the time the HP will be sufficient to meet the loads, especially at long timesteps, but not always.

[mnblonsky]

Noting that Max Capacity (and direct Capacity) is added for HVAC, and Max Power is added for Water Heating. We don't have plans to add both of those options for both end uses, because:

• Max Power seems more useful, and there isn't a great use case for setting Capacity for water heaters
• Max Power is very hard to do for HVAC, given the dependence on the envelope and the biquadratic functions for EIR. We could estimate or iterate, but it seems like a low priority for now. The Max Capacity Fraction is arguably pretty close to a "Max Power Fraction", so lets try that for now.

I'm moving on to EV/PV/Battery controls now.

[mnblonsky]

Added a few battery controls to the list. I don't think we'll need controls for min/max power limits, there's no known use case for that. Only EV and PV left!

[mnblonsky]

Added EV controls. I'm going to skip PV controls for now, since there's no current need for it. The most useful PV control might be some sort of non-export control that limits PV to the house load (e.g., if there's no battery and no grid exports are allowed). But I think we should hold off on that until it's necessary.

[mnblonsky]

Just finished building the docs, they're looking good now. @jmaguire1, this is ready for your review.