.. contents:: .. _purpose: ************************************ What is the Purpose of this Package? ************************************ This package was created by researchers from the `WE3 Lab `_ at Stanford University to assist in their energy-water nexus research. Our goal is to address the complexity of computing the electricity bill of an industrial consumer. We originally developed these methods while evaluating the cost-minimizing energy management strategies for water systems, such as wastewater treatment plants [`Musabendesu 𝐽. πΆπ‘™π‘’π‘Žπ‘›. π‘ƒπ‘Ÿπ‘œπ‘‘. (2021) `_; `Bolorinos πΈπ‘›π‘£π‘–π‘Ÿπ‘œπ‘›. 𝑆𝑐𝑖. π‘‡π‘’π‘β„Žπ‘›π‘œπ‘™. (2023) `_; `Chapin πΈπ‘›π‘£π‘–π‘Ÿπ‘œπ‘›. 𝑆𝑐𝑖. π‘‡π‘’π‘β„Žπ‘›π‘œπ‘™. (2025) `_], desalination facilities [`Rao 𝐴𝐢𝑆 π‘†π‘’π‘ π‘‘π‘Žπ‘–π‘›. πΆβ„Žπ‘’π‘š. 𝐸𝑛𝑔. (2024) `_], and water distribution [`Rao π‘π‘Žπ‘‘. π‘Šπ‘Žπ‘‘π‘’π‘Ÿ (2024) `_]. Unlike wholesale market pricing mechanisms, such as locational marginal prices (LMPs), which are straightforward to calculate directly as a timeseries in units of '$/MWh', retail electricity prices are broken down into a set of discrete charges. In particular, the **demand charge** is the maximum consumption during a specified time period, so computing a demand charge is a nonlinear operation (:ref:`complexities`). In addition to the mathematical complexity behind computing the electricity bill and optimizing bill savings, the wide variation in tariff structure is a challenge. Some regions offer flat prices, whereas others have up to four different time-of-use (TOU) pricing periods (i.e., "super-off-peak", "off-peak", "mid-peak", and "on-peak" periods). We designed a machine-readable format for encoding all relevant tariff data, including TOU periods, tiered charges, daily demand charges, and unit conversions [`Chapin π‘π‘Žπ‘‘. 𝑆𝑐𝑖. π·π‘Žπ‘‘π‘Ž (2024) `_]. Our research focuses on investigating the benefits of flexible operation of water systems, but we hope that this package will be useful to the wider community for seamlessly optimizing industrial consumers' electricity-related costs and emissions!