RadiativeExchange.hpp

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
//
// Copyright 2026 Caleb Buahin
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

 
#ifndef OPENSWMM_ENGINE_TRANSPORT_RADIATIVE_EXCHANGE_HPP
#define OPENSWMM_ENGINE_TRANSPORT_RADIATIVE_EXCHANGE_HPP
 
#include "../../../data/HeatOverrideData.hpp" // HeatElement (PE1)
 
namespace openswmm {
struct SimulationContext;
struct RadiativeConfig;
}
 
namespace openswmm::transport::heat {

inline constexpr double kStefanBoltzmann = 5.67e-8;

inline constexpr double kKelvinOffset = 273.15;

double netShortwave(double incoming_wm2, double albedo, double shade_factor) noexcept;

double backLongwave(double t_water_c, double emiss_water) noexcept;

double atmosphericEmissivity(double e_a_kpa, double atm_emiss_coeff,
                             double cloud_factor = 1.0) noexcept;

double atmosphericLongwave(double t_air_c, double humidity_pct, double atm_emiss_coeff,
                           double lw_reflection, double sky_view,
                           double cloud_factor = 1.0) noexcept;

double landCoverLongwave(double t_air_c, double emiss_landcover, double sky_view) noexcept;

double netRadiativeFluxOut(double t_water_c, double t_air_c, double humidity_pct,
                           const RadiativeConfig& cfg, double jin_wm2 = -1.0,
                           double cloud_factor = 1.0, double incoming_longwave = -1.0) noexcept;

double radiativeFluxOut(const SimulationContext& ctx, const HeatElement& elem, double t_w) noexcept;
double radiativeFluxOut(const SimulationContext&, const HeatElement&, double,
                        bool enabled) noexcept;
 
} // namespace openswmm::transport::heat
 
#endif // OPENSWMM_ENGINE_TRANSPORT_RADIATIVE_EXCHANGE_HPP