###############################################################################
# WaterTAP Copyright (c) 2021, The Regents of the University of California,
# through Lawrence Berkeley National Laboratory, Oak Ridge National
# Laboratory, National Renewable Energy Laboratory, and National Energy
# Technology Laboratory (subject to receipt of any required approvals from
# the U.S. Dept. of Energy). All rights reserved.
#
# Please see the files COPYRIGHT.md and LICENSE.md for full copyright and license
# information, respectively. These files are also available online at the URL
# "https://github.com/watertap-org/watertap/"
#
###############################################################################
"""
This module contains a zero-order representation of a storage tank unit.
"""
from pyomo.environ import units as pyunits, Var
from idaes.core import declare_process_block_class
from watertap.core import build_pt, constant_intensity, ZeroOrderBaseData
# Some more information about this module
__author__ = "Kurban Sitterley"
[docs]@declare_process_block_class("StorageTankZO")
class StorageTankZOData(ZeroOrderBaseData):
"""
Zero-Order model for a storage tank unit.
"""
CONFIG = ZeroOrderBaseData.CONFIG()
[docs] def build(self):
super().build()
build_pt(self)
constant_intensity(self)
# self._has_recovery_removal = False
self._tech_type = "storage_tank"
self.storage_time = Var(
self.flowsheet().time, units=pyunits.hours, doc="Storage time needed"
)
self.surge_capacity = Var(
self.flowsheet().time,
units=pyunits.dimensionless,
doc="Additional capacity needed for surge flow",
)
self._fixed_perf_vars.append(self.storage_time)
self._fixed_perf_vars.append(self.surge_capacity)
self.tank_volume = Var(
self.flowsheet().time, units=pyunits.m**3, doc="Storage tank volume"
)
@self.Constraint(self.flowsheet().time, doc="Tank volume constraint")
def tank_volume_constraint(b, t):
return b.tank_volume[t] == pyunits.convert(
b.properties[t].flow_vol, to_units=pyunits.m**3 / pyunits.hr
) * b.storage_time[t] * (1 + b.surge_capacity[t])
self._perf_var_dict["Storage Time (hr)"] = self.storage_time
self._perf_var_dict["Surge Capacity (%)"] = self.surge_capacity
self._perf_var_dict["Tank Volume (m3)"] = self.tank_volume