Calculateur de tonnage CVC

Une surface conditionnée non positive est rejetée avec une erreur invalid_input claire, au lieu d'inventer une charge à partir de pieds carrés nuls ou négatifs. Le chemin est purement mathématique et déterministe — sans réseau, sans graines aléatoires, sans dépendance à l'horloge —, de sorte que l'exécuteur gratuit du navigateur et l'API prépayée renvoient le même JSON après l'arrondi décimal fixe à chaque appel.

Comment le tonnage de climatisation de toute la maison est estimé à partir de la surface et du climat

Lorsque vous connaissez déjà un facteur climatique personnalisé issu d'un tableau de code local ou d'une feuille de charge antérieure, envoyez climate_factor directement et il remplace la table des zones. La réponse indique cooling_btu comme la surface multipliée par le facteur, tons comme cooling_btu divisé par douze mille, recommended_tons comme cette valeur arrondie au palier de demi-ton suivant pour correspondre aux tailles nominales courantes de deux, deux et demi, trois tonnes et plus, et sqft_per_ton comme douze mille divisé par le facteur, afin de le comparer aux règles d'entrepreneurs telles qu'une tonne pour cinq cents à six cents pieds carrés.

Comment appeler l'API et ce qu'elle renvoie

Préférez envoyer des nombres plutôt que des chaînes préformatées lorsque vous contrôlez le client ; lorsque vous devez envoyer des chaînes, évitez les suffixes d'unité ou les séparateurs de milliers qui feraient échouer le motif de nombre fini. Envoyez un corps JSON avec le sqft obligatoire en pieds carrés conditionnés (alias area, conditioned_sqft, square_feet, floor_area, conditioned_area) et le climate_zone optionnel comme entier de un à huit (alias zone, iecc_zone, climate ; défaut quatre pour un climat mixte lorsque ni zone ni facteur ne sont fournis) ou le climate_factor optionnel comme intensité positive en BTU par pied carré (alias btu_per_sqft, factor, load_factor, btu_factor). Lorsque climate_factor est présent, il l'emporte ; climate_zone est encore renvoyé si vous envoyez les deux, afin que les audits enregistrent la zone que vous aviez en tête. Les pieds carrés doivent être un nombre fini et positif dans la plage absolue publiée, afin que les produits intermédiaires restent finis en double précision IEEE sur le Worker et dans le navigateur. Un sqft non positif est la principale erreur grave annoncée par cette capacité : une surface conditionnée nulle ou négative ne peut définir la charge de refroidissement de toute la maison et renvoie invalid_input. La zone climatique doit être un entier de un à huit ; climate_factor doit être positif et dans les limites absolues. En cas de succès, la réponse renvoie sqft et climate_factor arrondis, publie factor_source comme climate_zone ou climate_factor, climate_zone et climate_label lorsqu'une zone est connue, cooling_btu et btu (le même total), tons, recommended_tons, sqft_per_ton, btu_per_ton comme douze mille, unit comme tons, formula comme la chaîne lisible de l'équation, message comme un court résumé et steps comme un tableau ordonné de lignes de substitution. Une validation échouée — sqft manquant, nombres non finis, surface non positive, zones invalides ou valeurs hors limites absolues — renvoie invalid_input et n'est jamais facturée. Le prix est un forfait de $0.002 par requête réussie avec unité item.

Conseils pratiques, limites et recherches associées

Choisissez la zone climatique sur une carte IECC ou dans le code énergétique local de votre site, ou collez un climate_factor personnalisé lorsqu'un entrepreneur ou un Manual J antérieur indique déjà des BTU par pied carré. Pour enseigner ou écrire des tests, associez une maison de deux mille pieds carrés en zone quatre par défaut à un cas de zone chaude et un cas de facteur personnalisé, et incluez un sqft nul ou négatif délibéré pour prouver le chemin invalid_input. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient les scripts exploratoires bon marché lorsque vous envoyez délibérément sqft zéro pour vérifier la gestion des erreurs. Les contrôles aller-retour sont simples : recalculez sqft multiplié par le climate_factor publié, divisez par douze mille, arrondissez au demi-ton suivant et confirmez que tons et recommended_tons publiés correspondent au même arrondi à douze décimales utilisé pour tous les champs numériques.