Calculator overview
Inputs and outputs
This summary comes from the calculator's published input and output contract.
Inputs
- CDP Temperature Unit
-
Default Fahrenheit Allowed Fahrenheit, Celsius
About this input
Selects the display and entry scale; all Magnus calculations are performed in Celsius internally.
- CDP Moisture Source
-
Default Interior air Allowed Interior air, Exterior air
About this input
Selects which air state supplies the dew point compared with assembly interfaces.
- CDP Interface Scope
-
Default All marked interfaces Allowed All marked interfaces, One interface number
About this input
Evaluates every grid row marked Yes or one numbered active interface.
- CDP Film Treatment
-
Default Include entered films Allowed Include entered films, Exclude films
About this input
Includes or excludes the two editable surface-film resistances in the temperature gradient.
- CDP Interior Temperature
-
Unit deg F/deg C Default 70 Range -100 to 200
About this input
Interior air temperature in the selected unit.
- CDP Exterior Temperature
-
Unit deg F/deg C Default 35 Range -100 to 200
About this input
Exterior air temperature in the selected unit.
- CDP Interior Relative Humidity
-
Unit fraction Default 0.3 Range 0.01 to 1
About this input
Interior relative humidity used by the Magnus dew-point relation; zero is excluded because its logarithm is undefined.
- CDP Exterior Relative Humidity
-
Unit fraction Default 0.75 Range 0.01 to 1
About this input
Exterior relative humidity used by the Magnus dew-point relation.
- CDP Interior Film R Conditional
-
Unit h ft^2 deg F/Btu Default 0.68 Range 0 to 5
About this input
Editable inside film resistance used only when films are included.
- CDP Exterior Film R Conditional
-
Unit h ft^2 deg F/Btu Default 0.17 Range 0 to 5
About this input
Editable outside film resistance used only when films are included.
- CDP Selected Interface Number Conditional
-
Unit row number Default 2 Range 1 to 10
About this input
One-based grid row evaluated under the one-interface route; it must identify an active layer.
- CDP Alert Band
-
Unit deg F/deg C Default 3 Range 0 to 50
About this input
Positive interface-temperature margin that still triggers a review alert in the selected temperature scale.
- CDP Layer Grid
-
Default 10 rows
About this input
Submit exactly ten complete rows; inactive typed rows replace saved workbook examples deterministically.
Column Range or allowed values Include Yes, No Layer label Not declared Layer R 0.001 to 500 Evaluate interface Yes, No Source note Not declared
Outputs
- CDP Interior Dew Point
-
Unit deg F/deg C
About this output
Interior-air dew point in the selected display unit.
- CDP Exterior Dew Point
-
Unit deg F/deg C
About this output
Exterior-air dew point in the selected display unit.
- CDP Source Dew Point
-
Unit deg F/deg C
About this output
Dew point selected from interior or exterior air for interface comparison.
- CDP Total Assembly R
-
Unit h ft^2 deg F/Btu
About this output
Sum of all active layers plus selected surface films.
- CDP Active Layer Count
-
Unit layers
About this output
Number of included layers in the temperature gradient.
- CDP Evaluated Interface Count
-
Unit interfaces
About this output
Number of active interfaces evaluated under the selected scope.
- CDP Worst Interface
-
No unit declared
About this output
Interface label with the smallest temperature-minus-dew-point margin.
- CDP Worst Interface Temperature
-
Unit deg F/deg C
About this output
Modeled temperature at the worst evaluated interface in the selected unit.
- CDP Minimum Dew Point Margin
-
Unit deg F/deg C
About this output
Worst interface temperature minus selected source-air dew point; negative means the plane is at or below dew point.
- CDP Risk Verdict
-
No unit declared
About this output
Plain-language screening verdict for the selected interfaces.
- Model Status
-
No unit declared
About this output
OK means every evaluated plane exceeds the active alert band; CHECK requires building-science review and is not a diagnosis.
Methodology
Purpose and model boundary
Calculates interior and exterior dew points with the Magnus relation, maps a steady-state temperature gradient through a complete assembly, and identifies the evaluated interface with the smallest dew-point margin.
Do not treat this result as an energy-code determination, Manual J, HVAC or ventilation design, moisture-control guarantee, structural or concrete design, permit approval, equipment selection, cost quote, or endorsement by a cited source. Site climate, assemblies, room use, ventilation, windows, material properties, geometry, manufacturer instructions, locally adopted codes, and approval thresholds remain the user's responsibility.
Inputs and units
- temperature unit: a listed route or text value.
- moisture source: a listed route or text value.
- interface scope: a listed route or text value.
- film treatment: a listed route or text value.
- interior temperature: entered in deg F/deg C.
- exterior temperature: entered in deg F/deg C.
- interior relative humidity: entered in fraction.
- exterior relative humidity: entered in fraction.
- interior film r: entered in h ft^2 deg F/Btu.
- exterior film r: entered in h ft^2 deg F/Btu.
- selected interface number: entered in row number.
- alert band: entered in deg F/deg C.
The layer grid contains 10 fixed data rows plus one header row with these columns: Include, Layer label, Layer R (h ft^2 deg F/Btu), Evaluate interface, Source note. Numeric columns retain the units shown here; text, route, and include columns are intentionally unitless.
Governing relationships
Temperatures are converted to Celsius before the moisture calculation. For air temperature T (deg C) and relative humidity RH (fraction), the Magnus relationship and dew point are:
gamma = ln(RH) + 17.625 T/(243.04+T)
T_dp = 243.04 gamma/(17.625-gamma)
T_dp is in deg C. Interior or exterior T_dp is selected by the moisture-source route.
Total thermal resistance is:
R_total = R_film,in + sum(R_j) + R_film,out
R_total is in h-ft^2-deg F/Btu, with film terms included only under the active route. At interface j, cumulative resistance from the interior is R_cum,j; interface temperature is:
T_j = T_in - (T_in-T_out) R_cum,j/R_total
The dew-point margin is:
M_j = T_j-T_dp
M_j is in deg C and is converted to a deg F difference by multiplying by 9/5 when Fahrenheit display is selected. The workbook reports the minimum eligible margin.
Calculation sequence
- Validate every active selector, scalar bound, type, and every fixed-grid entry.
- Apply the selected route and ignore values from inactive fields.
- Normalize unit-dependent inputs into the workbook's calculation basis.
- Evaluate every included row or candidate and aggregate the active schedule.
- Calculate primary and supporting outputs, populate the authored chart series, and apply derived numeric checks.
- Return the workbook status with the computed results; invalid input is never converted into a plausible engineering answer.
Outputs and interpretation
- interior dew point (deg F/deg C): Interior-air dew point in the selected display unit.
- source dew point (deg F/deg C): Dew point selected from interior or exterior air for interface comparison.
- worst interface: Interface label with the smallest temperature-minus-dew-point margin.
- worst interface temperature (deg F/deg C): Modeled temperature at the worst evaluated interface in the selected unit.
- minimum dew point margin (deg F/deg C): Worst interface temperature minus selected source-air dew point; negative means the plane is at or below dew point.
The chart is an explanatory view of the workbook's named chart ranges. It does not add a separate calculation or replace the numeric outputs.
Validation and status logic
The workbook evaluates Model_Status in the order shown. The first matching condition wins.
| First matching workbook condition | Exact returned status |
|---|---|
CDP_Inputs_Valid is FALSE |
NOT VALID: correct the temperature, moisture, interface, film, or complete layer inputs |
CDP_Minimum_Margin_Internal <= 0 |
CHECK: at least one evaluated interface is at or below the selected source-air dew point |
CDP_Minimum_Margin_Internal <= CDP_Alert_Band |
CHECK: the worst evaluated interface is within the entered near-dew-point alert band |
| None of the preceding conditions applies | OK |
Assumptions and limitations
Every shipped layer, film, temperature, and humidity value is synthetic and illustrative.
The assembly is one-dimensional and steady-state.
Layer R-values and films are user-verified inputs.
The dew-point comparison is a thermal-plane screen only.
Vapor diffusion, air leakage, rain wetting, capillary transport, sorption, thermal bridges, and drying are not modeled.
A CHECK is not a mold, durability, or condensation diagnosis.
Restrictions and non-computing states
Each numeric control offers a working range chosen for usable entry, which is not always the limit this calculator enforces; a value outside that limit is rejected with a message rather than quietly accepted. The calculator additionally enforces allowed choices, active-field types, complete fixed-grid rows, and conditional or cross-field rules before computing.
Unsupported route values, incomplete rows, out-of-domain inputs, relational failures, nonfinite derived arithmetic, and workbook error tokens are non-computing states. Hidden inputs remain in the values sent to the calculator but must not affect results while those fields are inactive.
Errors and warnings
A rejected entry means the submitted state failed the published input rules. Workbook NOT VALID identifies an invalid active domain or unsupported derived arithmetic. Workbook CHECK retains a finite result while flagging a planning condition that needs review. OK means only that the delivered workbook logic closed within the entered assumptions; it is not code compliance, professional approval, or a safety guarantee.
This version is checked against 80 saved test cases, covering both calculated results and entries that should be refused, run against this exact workbook.
References
- National Weather Service dew-point explanation - Primary public weather-service context for dew point and relative humidity. Official public U.S. government source; the Magnus relation is independently implemented without copied text, tables, or figures.
- U.S. Department of Energy moisture-control guidance - Primary public context for moisture transport limits and the need for project-specific evaluation. Official public U.S. government source; no copied standard text, table, figure, or dataset is embedded.
- NIST temperature unit guidance - Primary public source for temperature-scale conversion context. Official public U.S. government metrology source; no copied text, table, or figure is embedded.
Licensing conclusion: No licensed, proprietary, manufacturer, utility, product-price, code-table, climate table, material table, forecast, or external dataset is embedded. The calculator independently implements general heat-transfer, moisture, airflow, energy, geometry, and quantity arithmetic from cited public and official sources; all defaults, labels, property rows, equipment assumptions, diagrams, and test values are synthetic illustrations. No moisture-design standard, material table, or climate dataset is reproduced.
Found a problem, or have an idea?
Tell us if a result looks wrong, a label is unclear, or something is missing. We read every message.
LogicCommons is in beta. If a result, label, or reference looks wrong, tell us here; we read every message.