ForHosting KIT · Mathématiques

Volume d'un cylindre en gallons

Convertissez un cylindre mesuré en pouces en gallons US : un rayon de 6 pouces et une hauteur de 48 pouces contiennent 23,500745 gallons. Pratique pour les aquariums, fermenteurs, chauffe-eau, récupérateurs d'eau de pluie et fûts. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Rayon: 6
Hauteur: 48

Vous obtenez

Volume (gallons): 23,500745

Plombiers, aquariophiles, brasseurs amateurs et tous ceux qui dimensionnent un réservoir aux États-Unis se heurtent au même calcul, encore et encore : un cylindre mesuré en pouces dont il faut la contenance en gallons. Cette capacité répond exactement à cela. Vous envoyez le rayon de la base et la hauteur, tous deux en pouces, et vous obtenez le volume en gallons liquides US en un seul appel déterministe — le volume du cylindre πr²h en pouces cubes, divisé par la conversion exacte de 231 pouces cubes par gallon.

Des pouces aux gallons : les mathématiques

Un cylindre de révolution est un cercle extrudé le long d'un axe droit, donc son volume est l'aire de la base multipliée par la hauteur : V = πr²h. Avec le rayon r et la hauteur h tous deux mesurés en pouces, cette formule donne directement des pouces cubes. La conversion en gallons liquides US n'est pas une approximation mais une définition exacte : un gallon US vaut exactement 231 pouces cubes, une valeur fixée par la loi depuis le XIXe siècle.

Ce point de terminaison calcule donc πr²h puis divise par 231 — aucun facteur empirique, aucune table de correspondance, aucune correction de température. Si vous avez mesuré le diamètre plutôt que le rayon, divisez-le par deux avant l'appel : envoyer le diamètre comme rayon surestimerait le volume d'un facteur quatre, car le rayon entre au carré dans la formule.

Notez aussi qu'il s'agit du gallon liquide US : le gallon impérial utilisé au Royaume-Uni et au Canada est environ 20 % plus grand (277,42 pouces cubes), les résultats ne sont donc pas interchangeables entre les deux systèmes.

Validation, précision et arrondi

Les deux entrées sont vérifiées avant toute opération : le rayon et la hauteur doivent être des nombres positifs et finis. Les chaînes numériques telles que "6.5" sont acceptées et converties, ce qui rend le point de terminaison accueillant pour les données de formulaires et les paramètres de requête.

Une fois les entrées validées, le volume est calculé en double précision puis arrondi au nombre de décimales demandé — six par défaut, de zéro à douze via le champ optionnel <em>decimals</em> — selon une règle d'arrondi au plus proche (half-up) appliquée à la valeur absolue.

Cet arrondi déterministe compte plus qu'il n'y paraît : les queues brutes en virgule flottante dépendent de la machine, et une règle d'arrondi stable rend la réponse identique à l'octet près sur n'importe quelle machine, ce qui permet aux pipelines automatisés et aux tests de référence de comparer les résultats de façon fiable. La réponse renvoie le rayon et la hauteur exacts utilisés, de sorte qu'une seule charge utile constitue un enregistrement complet du calcul effectué.

Où les gallons issus des pouces apparaissent

La contenance en gallons d'un réservoir ou d'un contenant est une question quotidienne dans les métiers américains, et le pouce est l'unité de travail du mètre ruban.

Les aquariophiles dimensionnent bacs et décantations ; les brasseurs amateurs et vignerons vérifient la capacité des fermenteurs ; les plombiers et foreurs de puits calculent le volume utile des réservoirs à diaphragme et des chauffe-eau ; les techniciens CVC et chaudières estiment le volume de fluide des cuves cylindriques ; et quiconque achète un récupérateur d'eau de pluie, un fût de carburant ou une citerne veut savoir ce que contiennent réellement les dimensions du fabricant.

Le fût standard de 55 gallons est le test de cohérence classique : environ 11,5 pouces de rayon et 33,5 pouces de hauteur donnent presque exactement 55 gallons.

Cas d’usage

Vérifier la capacité d'un aquarium ou d'une décantation

Obtenez la contenance réelle en gallons d'un bac cylindrique, d'une décantation ou d'un refugium à partir de son rayon et de sa hauteur en pouces, avant de le remplir ou de doser.

Dimensionner les cuves de brassage et de fermentation

Vérifiez combien de gallons contient réellement un fermenteur, une bouilloire ou un fût à partir de deux relevés au mètre ruban en pouces.

Calculer le volume d'un réservoir à diaphragme ou d'un fût

Estimez les gallons contenus dans un réservoir à diaphragme de puits, un chauffe-eau ou un fût de 55 gallons à partir de ses dimensions cylindriques.

Questions fréquentes

Combien cela coûte-t-il ?

C'est également gratuit dans votre navigateur sur cette page.

Quelles unités sont utilisées ?

Le rayon et la hauteur sont en pouces.

S'agit-il de gallons US ou de gallons impériaux ?

De gallons liquides US. Le gallon impérial est environ 20 % plus grand (277,42 pouces cubes) : ne mélangez pas les deux systèmes.

J'ai mesuré le diamètre, pas le rayon. Que dois-je envoyer ?

Divisez d'abord le diamètre par deux. La formule est πr²h, et envoyer le diamètre comme rayon donnerait quatre fois le volume réel.

Puis-je contrôler la précision ?

Oui. Le champ optionnel decimals définit le nombre de décimales du résultat, de 0 à 12, avec six par défaut. L'arrondi est au plus proche (half-up).

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/math/cylinder-volume-gallons

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/math/cylinder-volume-gallons \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"radius":6,"height":48}'

const res = await fetch("https://api.kit.forhosting.com/math/cylinder-volume-gallons", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "radius": 6,
    "height": 48
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/math/cylinder-volume-gallons",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "radius": 6,
    "height": 48
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/math/cylinder-volume-gallons", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"radius":6,"height":48}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"radius":6,"height":48}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/cylinder-volume-gallons", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "radius": 6,
  "height": 48
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "math.cylinder_volume_gallons",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Les deux entrées sont validées comme des nombres positifs et finis avant tout calcul, et toute autre valeur est rejetée avec une erreur typée invalid_input qui nomme le champ fautif : une mauvaise mesure ne se transforme jamais en contenance silencieusement erronée.

Validation, précision et arrondi

Zéro, une valeur négative, un champ manquant, une chaîne non analysable, NaN ou l'infini sont tous rejetés avec une erreur typée <em>invalid_input</em> dont le message nomme le champ en cause — une erreur jamais facturée, car ce sont les données de l'appelant qui ont échoué, pas le service.

Où les gallons issus des pouces apparaissent

La capacité s'exécute comme une fonction pure sur notre réseau périphérique mondial : rien n'est stocké, rien n'est envoyé à un tiers, et le même code qui répond aux appels API payants s'exécute gratuitement dans votre navigateur sur cette page, pour vérifier une mesure de façon interactive avant d'automatiser quoi que ce soit. À $0.002 par requête, sans composante à l'unité, un traitement par lots qui balaie des milliers de dimensions candidates — par exemple pour dimensionner un réservoir selon un objectif de contenance — coûte exactement ce qu'annonce le catalogue, sans surprise.

Questions techniques

Quelles entrées sont rejetées ?

Tout ce qui n'est pas un nombre positif et fini : zéro, valeurs négatives, chaînes non numériques, NaN, infini et champs manquants renvoient tous une erreur typée invalid_input.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Des pouces aux gallons : les mathématiques

Validation, précision et arrondi

Où les gallons issus des pouces apparaissent

Cas d’usage

Vérifier la capacité d'un aquarium ou d'une décantation

Dimensionner les cuves de brassage et de fermentation

Calculer le volume d'un réservoir à diaphragme ou d'un fût

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Validation, précision et arrondi

Où les gallons issus des pouces apparaissent

Questions techniques

merci