Calculateur de volume de réservoir

Cette capacité prend un rayon interne positif, une longueur axiale positive (longueur du réservoir en horizontal, hauteur en vertical), une profondeur de remplissage non négative mesurée verticalement depuis le fond, et un indicateur d'orientation, puis renvoie le volume rempli, le volume total, le volume vide et la fraction de remplissage en JSON déterministe. Une profondeur de remplissage qui dépasse le diamètre est rejetée avec invalid_input afin que les scripts d'inventaire n'inventent jamais de liquide au-dessus de la coque. La même résolution pure s'exécute gratuitement dans le navigateur et sur le chemin API prépayé, sans appels réseau, sans graines aléatoires et sans dépendance à l'horloge murale.

Formules pour réservoirs cylindriques horizontaux et verticaux

Les deux orientations partagent la même capacité totale : total volume equals π times radius squared times length, le volume d'un cylindre circulaire droit.

Comment appeler l'API et ce qui revient

Utilisez-le depuis des scripts d'inventaire et de tables de jauge, des métrés d'ingénierie de procédé, des contrôles de ferme et de dépôt de carburant, des sandboxes de préparation d'entretien, ou tout flux qui a besoin de volumes de réservoir reproductibles sans installer un package d'algèbre informatique sur chaque machine. Envoyez un corps JSON avec radius, length et fill_depth. Le champ radius est le rayon interne positif ; les alias r et R sont acceptés. Le champ length est la longueur axiale positive du cylindre—la longueur du réservoir en horizontal et la hauteur debout en vertical ; les alias L, height et h_tank mappent la même signification. Le champ fill_depth est la hauteur de liquide non négative depuis le fond ; les alias depth, fill, h et liquid_height sont acceptés. L'orientation optionnelle est horizontal ou vertical et vaut horizontal par défaut si omise ; les alias axis et position sont acceptés. En cas de succès la réponse renvoie radius, length, fill_depth, diameter et orientation ; retourne filled_volume, total_volume, empty_volume, fill_fraction et fill_percent ; et inclut method plus un court bloc formula documentant les formes fermées. Une validation échouée—champ requis manquant, nombre non fini, radius ou length non positifs, fill_depth négatif, fill_depth supérieur au diamètre, remplissage vertical au-dessus de la hauteur du réservoir, ou chaîne d'orientation invalide—renvoie invalid_input et n'est jamais facturée. Le tarif est un forfait $0.002 par requête réussie avec élément unitaire et prix marginal unitaire nul.

Conseils pratiques, limites et recherches liées

Cette page cible ceux qui cherchent un calculateur de volume de réservoir ou le volume de liquide d'un cylindre horizontal et vertical depuis la profondeur de remplissage ; ce n'est pas un outil d'aire de surface de cylindre plein, un estimateur de fond de barrique ni un convertisseur d'unités. Préférez cet outil lorsque vous connaissez déjà le rayon interne, la longueur axiale et une hauteur de jauge ou de capteur et avez besoin du volume rempli plus total en une seule fois. Les contrôles aller-retour sont faciles : un remplissage complet horizontal ou vertical doit correspondre au total volume dans la tolérance flottante, un remplissage vide doit donner zero filled volume, et un remplissage horizontal à mi-hauteur avec h equals r doit donner la moitié du volume total. Gardez radius et length dans la plage positive publiée jusqu'à un billion pour que les produits intermédiaires restent finis en précision double IEEE sur le Worker et dans le navigateur. Imposez toujours fill depth inférieure ou égale au diamètre deux fois radius ; l'API rejette les lectures plus profondes avec invalid_input plutôt que de rogner en silence. Pour les réservoirs verticaux gardez aussi fill depth au plus égale à length, la hauteur physique du réservoir. En enseignant ou déboguant, préférez des exemples appariés : radius one, length ten, fill depth one horizontal pour un ballon horizontal à moitié plein ; radius two, length five, fill depth three vertical pour un fût vertical à soixante pour cent ; et fill depth three avec radius one pour démontrer le chemin de rejet par diamètre. Comme le volume horizontal est non linéaire en hauteur, une lecture à mi-niveau est une demi-capacité seulement quand fill depth equals the radius—pas quand le pourcentage de hauteur est cinquante dans un autre sens. Les tâches échouées qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui garde les scripts exploratoires bon marché lorsque les opérateurs saisissent des lectures de jauge impossibles en apprenant le contrat.