Calculateur de gravité API

Un calculateur de gravité API transforme la densité relative d'un liquide pétrolier en degrés API grâce à la formule exacte de l'hydromètre utilisée par l'industrie, sans tableaux ni calculs manuels. Saisissez la densité relative de votre brut ou produit raffiné — la densité mesurée sur la base standard de soixante sur soixante degrés Fahrenheit — et l'outil renvoie les degrés API correspondants, une classification léger, moyen, lourd ou extra-lourd, la chaîne de la formule et les étapes de substitution que vous pouvez coller dans un cahier de laboratoire ou un rapport de cargaison. Une densité relative nulle ou négative est physiquement dépourvue de sens sur cette échelle : le solveur la rejette donc avec une erreur invalid_input claire au lieu d'inventer un chiffre.

Qu'est-ce que la gravité API et comment fonctionne la formule

Définie par l'American Petroleum Institute et normalisée dans ASTM D287, elle exprime à quel point un liquide pétrolier est lourd ou léger par rapport à l'eau à la température de référence de soixante degrés Fahrenheit. La densité relative désigne ici la densité sur la base 60/60 °F — la densité du liquide divisée par celle de l'eau, toutes deux à la température de référence — il s'agit donc d'un nombre pur, sans dimension ni unité. Il applique uniquement la définition en forme fermée — aucun facteur de correction volumique de température, aucune règle de mélange, aucune interpolation de table — donc la réponse obtenue est la valeur définitionnelle pure que vous calculeriez à la main, arrondie à douze décimales pour une reproductibilité entre systèmes. La gravité API est l'échelle de densité que parle réellement l'industrie pétrolière. La relation avec la densité relative est exacte et algébrique : les degrés API valent cent quarante et un virgule cinq divisés par la densité relative, moins cent trente et un virgule cinq. L'eau elle-même, avec une densité relative d'exactement un, tombe à exactement dix degrés API, ce qui fait de dix la ligne de partage : les liquides au-dessus de dix degrés API flottent sur l'eau, ceux en dessous coulent. Les bruts légers comme le West Texas Intermediate se situent autour de quarante degrés API, les qualités moyennes se regroupent dans les vingt et le bas des trente, les bruts lourds entre dix et vingt-deux, et les bitumes extra-lourds descendent sous dix. Comme la formule divise par la densité relative, l'échelle est indéfinie lorsque celle-ci vaut zéro et dépourvue de sens physique lorsqu'elle est négative ; ce calculateur rejette les deux cas avec une erreur invalid_input nommant le champ, plutôt que de renvoyer un résultat infini ou absurde.

Comment appeler l'API et lire la réponse

La valeur doit être un nombre fini, ou une chaîne numérique stricte sans symboles monétaires ni séparateurs de milliers, dans une magnitude absolue d'un billion, et elle doit être strictement supérieure à zéro. Envoyez un corps JSON avec un seul champ obligatoire, specific_gravity, qui répond aussi aux alias sg, value, gravity, relative_density et density afin que vos charges utiles existantes s'intègrent sans renommage. En cas de succès, la réponse renvoie la densité relative arrondie, puis api et api_gravity — le même chiffre en degrés API sous deux clés pour plus de commodité — plus unit défini au symbole des degrés API, une classification light, medium, heavy ou extra heavy suivant les bandes usuelles de l'industrie, la chaîne de la formule montrant les constantes exactes utilisées, un message en langage clair résumant le résultat, et un tableau steps listant les lignes de substitution ordonnées, de l'entrée jusqu'à la classification. Les échecs de validation — champ manquant, valeur non finie, magnitude au-delà de la limite ou densité relative nulle ou négative — renvoient invalid_input avec un message nommant le champ fautif, et les tâches échouées ne sont jamais débitées du solde prépayé. La tarification est un forfait fixe de $0.002 par requête réussie, avec un article unitaire et un prix unitaire marginal nul. Cela rend la capacité sûre à intégrer dans des tableaux de bord, applications mobiles, traitements d'analyses par lots, ou tout client détenant une lecture de densité relative et ayant besoin du chiffre en degrés API pour l'affichage, les tickets ou les rapports mixtes SI et impériaux.

Conseils pratiques, limites et quand utiliser ce calculateur

Envoyez des nombres bruts lorsque vous contrôlez le client ; l'entrée sous forme de chaîne n'est acceptée que si elle correspond à un motif numérique fini strict, donc rejetez de votre côté les valeurs formatées selon la locale avant l'appel. Rappelez-vous que cet outil applique uniquement la formule définitionnelle : le transfert de propriété et les rapports officiels exigent souvent des volumes corrigés en température issus des tables ASTM D1250, hors de portée ici. Restez dans la limite absolue publiée d'un billion afin que la division intermédiaire ne puisse pas déborder, et considérez la bande de classification comme une convention informelle de l'industrie plutôt que comme une frontière contractuelle. Les points de référence classiques font de bons contrôles de cohérence : une densité relative de un doit renvoyer exactement dix degrés API, un brut léger autour de zéro virgule quatre-vingt-cinq renvoie environ trente-cinq degrés API, et un brut lourd proche de zéro virgule quatre-vingt-treize renvoie environ vingt degrés API. Si vous avez besoin du sens inverse, ou de conversions vers des unités de densité absolue comme les kilogrammes par mètre cube, les grammes par centimètre cube ou les livres par gallon, utilisez plutôt la capacité dédiée de conversion de gravité API — ce calculateur fait délibérément une seule chose, la densité relative vers les degrés API, et il le fait de manière déterministe. Cette page sert les personnes recherchant un calculateur de gravité API, des degrés API à partir de la densité relative, ou une vérification de la formule d'hydromètre pétrolier ; ce n'est ni un convertisseur d'unités général, ni un outil de densité pour d'autres industries, ni un moteur de mélange ou de correction de température. Les appels échoués renvoient invalid_input et ne consomment aucun solde, ce qui garde les scripts exploratoires et les sondes de validation côté client économiques pendant votre intégration.