Calculateur de lames de terrasse : quantité, joint et chute

La même fonction pure alimente l’outil gratuit du navigateur et l’API payante, de sorte qu’un devis généré sur téléphone coïncide avec la ligne qu’un script envoie ensuite. Les dimensions de lame nulles ou négatives sont rejetées avec invalid_input plutôt qu’une division par zéro silencieuse.

Comment fonctionne la formule de décompte des lames de terrasse

Parte d’une identité de couverture qui reflète la façon dont les lames remplissent réellement une terrasse : chaque lame occupe toute sa longueur de face le long du rang et un pas de board_width plus gap entre solives. Écrivez effective_board_area égal à board_length multiplié par (board_width plus gap), en utilisant la même unité linéaire sous-jacente à votre deck_area en unités carrées, de sorte que les mètres s’apparient aux mètres carrés et les pieds aux pieds carrés. Le produit face seule board_length multiplié par board_width est renvoyé comme board_face_area pour audit, mais le calcul d’achat utilise l’empreinte effective plus large afin que les joints de drainage ne disparaissent pas du plan. Appliquez ensuite la chute comme facteur multiplicatif : waste_factor vaut un plus waste_percent divisé par cent, de sorte qu’une chute de dix pour cent planifie cent dix pour cent de la terrasse nue. Multipliez deck_area par ce facteur pour obtenir area_with_waste — la cible de couverture effective après chutes de coupe, cadres périphériques approximés avec stock supplémentaire, pièces cassées et surplus de lot. Divisez area_with_waste par effective_board_area pour produire boards_exact, un réel pouvant avoir une partie fractionnaire. La quantité d’achat boards_needed est le plafond de boards_exact. La réponse renvoie aussi les intermédiaires (board_face_area, effective_pitch, effective_board_area, waste_factor, waste_area, area_with_waste, boards_exact, coverage_area) et spare_area_vs_deck pour contrôler le calcul à la main sur le bordereau. Le pipeline est une arithmétique flottante déterministe, sans graines aléatoires, sans horloge murale et sans appels réseau, de sorte que des entrées identiques produisent toujours le même JSON. La largeur et la longueur de lame doivent être strictement positives : une taille nulle ou négative est rejetée avec invalid_input car une emprise nulle rendrait le rapport indéfini et une emprise négative n’est pas physique. La surface de terrasse doit aussi être positive ; gap et waste_percent doivent être non négatifs pour qu’un pose jointive à joint zéro et un rectangle parfait sans chute restent exprimables.

Ce que vous envoyez et ce que vous recevez

Les cinq champs sont obligatoires. Envoyez cinq nombres finis : deck_area pour la couverture du plan de terrasse en unités carrées, board_width et board_length pour le couple de face d’une lame en unités linéaires cohérentes, gap pour l’espacement entre lames adjacentes dans ces mêmes unités linéaires, et waste_percent comme le pourcentage de matériau supplémentaire (par exemple dix pour une marge de dix pour cent). Champs manquants, chaînes non numériques, NaN et Infinity échouent avec invalid_input et ne sont pas facturés. Lorsque board_width ou board_length est nul ou négatif, la requête échoue avec un message indiquant que les dimensions de lame doivent être positives, afin que le client corrige avant de réessayer plutôt que de recevoir Infinity lames. En cas de succès la réponse répète les entrées nettoyées, board_face_area, effective_pitch, effective_board_area, waste_factor, waste_area, area_with_waste, boards_exact, l’entier boards_needed, coverage_area, spare_area_vs_deck (combien de surface le lot acheté couvre au-delà de la terrasse nue en comptant chaque lame au pas complet), un rappel unit_note pour conserver un seul système d’unités, et une courte chaîne formula pour la documentation. Les contrôles classiques incluent une terrasse de vingt-quatre mètres carrés avec des lames de zéro virgule quatorze par trois virgule six mètres, un joint de cinq millimètres et dix pour cent de chute : l’aire effective de lame est longueur multipliée par largeur plus joint, l’aire avec chute est vingt-six virgule quatre, et boards_needed est le plafond de ce rapport. Le tarif des appels API réussis est la base publiée de $0.002 par article ; les échecs de validation ne consomment pas le solde prépayé.

Où les calculateurs de lames de terrasse interviennent dans le travail réel

Les propriétaires qui construisent une terrasse de jardin ont besoin d’un décompte de lames fiable avant de commander du composite ou du bois traité, surtout lorsque les longues lames ont un prix unitaire élevé et un délai de plusieurs semaines. Les constructeurs de terrasses et menuisiers établissent des métrés à partir des surfaces mesurées et des formats fabricant ; un unique point d’accès déterministe qui plafonne après joint et chute réduit la dérive de tableur entre l’estimateur et l’acheteur. Si vous avez ensuite besoin de solives et poutres, de clips de fixation cachée, de balustres ou de limons d’escalier, traitez-les comme des intentions de recherche et des pages distinctes, sans surcharger cette page de calculateur de lames de terrasse. Les paysagistes qui comparent trois références de lame pour le même plan peuvent n’échanger que board_width, board_length et gap en maintenant deck_area et waste_percent fixes, puis classer le total de lames et la couverture en réserve sans redériver la mathématique du pas à chaque fois. Les gestionnaires d’immeubles qui planifient des rénovations de balcons multi-logements envoient un lot de surfaces via l’API et joignent boards_needed aux bons de commande pour que le surstock reste intentionnel plutôt qu’accidentel. Comme cette capacité est un moteur de parse pur, le tarif API est la base publiée de $0.002 par article réussi et la validation échouée ne consomme pas le solde.