Calculateur hauteur d'instrument
Avec un repère à 100 m et une lecture arrière de 1,245 m, la hauteur d'instrument est de 101,245 m. Saisissez l'altitude du repère et la lecture pour lancer un cheminement ou vérifier un point de changement. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Altitude du repère
- 100
- Lecture arrière
- 1,245
- Hauteur de l'instrument
- 101,245
- Précision
- 12
En nivellement différentiel, la hauteur d'instrument est l'altitude de la ligne de collimation du télescope une fois l'appareil stationné et mis de niveau. Vous l'obtenez en ajoutant la lecture de mire arrière sur un repère d'altitude connue à cette altitude : HI égale BM plus BS. Géomètres, étudiants en génie civil et équipes de chantier ont besoin de cette somme chaque fois qu'ils ouvrent un cheminement de niveau ou vérifient la réduction d'un point de passage, et les scripts d'automatisation exigent un contrat déterministe qui n'invente jamais de lecture à partir de données manquantes.
Ce que signifie la hauteur d'instrument en nivellement différentiel
Le nivellement différentiel transfère l'altitude d'un point connu vers des points inconnus en mesurant des lectures verticales de mire avec un niveau dont la ligne de collimation est horizontale. La hauteur d'instrument (HI) est l'altitude de cette ligne horizontale de collimation au-dessus du datum du projet. Une fois HI connue, toute lecture de mire avant FS sur un nouveau point donne l'altitude de ce point comme HI moins FS.
La façon standard d'établir HI à une station est de prendre une lecture arrière (BS) sur un point d'altitude connue — typiquement un repère permanent ou un point de passage de la station précédente — et d'ajouter cette lecture à l'altitude connue : HI égale BM plus BS. La lecture arrière est toujours celle du point connu ; c'est celle qui « regarde en arrière » vers le contrôle.
Les lectures de mire sont des longueurs non négatives mesurées depuis le pied de la mire vers le haut ; une lecture négative impliquerait que la ligne de collimation se situe sous la base de la mire, ce qui n'est pas une observation de terrain valide pour ce modèle. Les altitudes de repère peuvent être positives, nulles ou négatives lorsque le datum local se trouve au-dessus de certains points du terrain.
Les unités doivent être cohérentes : si le repère est en mètres, la lecture arrière doit être en mètres pour que HI soit en mètres ; le calculateur ne convertit pas les pieds en mètres pour vous.
Où un calculateur de hauteur d'instrument apporte de la valeur
Les étudiants rencontrent HI égale BM plus BS dès la première semaine d'un cours de topographie, lorsqu'un laboratoire demande de réduire un simple cheminement à deux points ou qu'un examen donne une altitude de repère et une lecture arrière et exige la hauteur de collimation avant tout travail de mire avant. Les enseignants peuvent pré-générer des clés de correction pour des chiffres modestes sans se fier à des applications opaques qui changent silencieusement de système d'unités ou confondent lecture arrière et lecture avant.
Les développeurs appellent le même contrat depuis des scripts pour semer des vecteurs de test déterministes pour des logiciels de carnet de terrain, normaliser des données de niveau saisies par l'utilisateur avant un ajustement aux moindres carrés plus large, ou satisfaire des énoncés de défis de programmation qui exigent HI plutôt qu'un croquis approximatif.
Les équipes de construction et de génie civil utilisent la somme pour des contrôles rapides lorsqu'un repère permanent est connu par les réseaux de contrôle et que la lecture de mire sur ce repère est notée dans le carnet. Les outils produits et éducatifs utilisent la réécriture lorsqu'un apprenant saisit BM et BS et que l'interface doit afficher la hauteur d'instrument avec une chaîne de formule propre.
Cas d’usage
Contrôles de HI pour devoirs et laboratoire
Calculez la hauteur d'instrument à partir d'une altitude de repère connue et d'une lecture de mire arrière avant de réduire les mires avant dans un rapport de nivellement différentiel.
Contrôles carnet de terrain et chantier
Vérifiez le HI à chaque station d'instrument lorsqu'un repère permanent et la lecture BS sont connus, afin que les altitudes suivantes soient HI moins FS.
Questions fréquentes
Quelle est la formule de la hauteur d'instrument ?
HI = BM + BS, où BM est l'altitude connue du repère (ou point de passage) et BS est la lecture de mire arrière sur ce point.
L'altitude du repère peut-elle être négative ou nulle ?
Oui. L'altitude du repère peut être tout nombre fini, y compris zéro ou des valeurs négatives sous le datum local. Seule la lecture de mire arrière doit être non négative.
Comment obtenir l'altitude d'un nouveau point à partir de la hauteur d'instrument ?
Soustrayez de la hauteur d'instrument la lecture avant faite sur le nouveau point. La lecture arrière se fait toujours sur le point connu, et la lecture avant sur le point que vous cherchez.
La lecture arrière peut-elle être négative ?
Non. Une lecture sur mire se mesure vers le haut depuis le pied de la mire, elle ne peut donc pas descendre sous zéro et une valeur négative est refusée. L'altitude du repère, elle, peut être négative.
L'outil réduit-il un cheminement complet ou compense-t-il la fermeture ?
Non. Il traite une seule station : altitude du repère plus lecture arrière. Plusieurs stations, l'équilibrage des portées et la compensation de fermeture restent hors champ ; reportez vous-même chaque nouvelle hauteur.
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
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/eng/level-hi \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"benchmark_elevation":100,"backsight":1.245}'const res = await fetch("https://api.kit.forhosting.com/eng/level-hi", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"benchmark_elevation": 100,
"backsight": 1.245
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/eng/level-hi",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"benchmark_elevation": 100,
"backsight": 1.245
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/eng/level-hi", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"benchmark_elevation":100,"backsight":1.245}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"benchmark_elevation":100,"backsight":1.245}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/eng/level-hi", 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
{
"benchmark_elevation": 100,
"backsight": 1.245
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "eng.level_hi",
"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
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
Ce calculateur de hauteur d'instrument accepte l'altitude connue du repère et la lecture de mire arrière dans toute unité de longueur cohérente, renvoie le HI arrondi avec la chaîne de formule classique et les étapes de substitution ordonnées, et rejette les lectures de mire négatives comme invalid_input au lieu de produire une hauteur de collimation dénuée de sens.
Ce que signifie la hauteur d'instrument en nivellement différentiel
Ce endpoint renvoie l'altitude du repère et la lecture arrière arrondies que vous avez fournies, la hauteur d'instrument calculée, la précision utilisée, une étiquette de méthode differential_leveling_hi, formula comme la chaîne HI equals BM plus BS, message comme un court résumé en français et steps comme un journal de substitution ordonné. Il n'y a ni réduction multi-stations, ni équilibrage des visées, ni ajustement d'erreur de fermeture : le moteur additionne deux nombres finis dans la plage de magnitude prise en charge, ou rejette l'entrée avec invalid_input.
Contrat d'entrée, forme de la réponse et comportement d'erreur
Les deux doivent être des nombres finis ; backsight doit être non négatif car une graduation de mire ne peut pas lire en dessous de zéro dans ce contrat. Préférez envoyer des nombres plutôt que des chaînes préformatées lorsque vous contrôlez le client ; si vous devez envoyer des chaînes, évitez les étiquettes d'unité qui feraient échouer le motif de nombre fini. Envoyez un corps JSON avec deux champs obligatoires : benchmark_elevation pour l'altitude connue du point où la mire est tenue pour la lecture arrière (alias BM, bm, elevation, benchmark, known_elevation, elev_bm) et backsight pour la lecture de mire sur ce point (alias BS, bs, backsight_reading, staff_reading, bs_reading). La précision optionnelle (alias decimals, dp) choisit combien de décimales exposer pour les champs numériques, avec douze par défaut et un plafond de quinze pour que les goldens JSON restent stables entre runtimes. Les formes chaîne de nombres sont acceptées lorsqu'elles correspondent à un motif décimal fini strict avec notation scientifique optionnelle ; espaces intégrés, suffixes d'unité tels que m ou ft, et jetons non numériques échouent avec un message invalid_input clair nommant le champ. En cas de succès la réponse renvoie les entrées arrondies, publie height_of_instrument comme BM plus BS, formula et message comme décrit ci-dessus, et steps comme le journal de substitution que vous pouvez affirmer dans des tests ou montrer à côté d'un croquis de carnet de terrain. Une validation échouée — champs manquants, nombres non finis, backsight négatif ou valeurs hors des limites absolues de magnitude — renvoie invalid_input et n'est jamais facturée. Le tarif est un forfait de $0.002 par requête réussie avec unité item. Associez ce endpoint à une réduction de mire avant lorsque vous connaissez déjà HI et avez besoin de l'altitude d'un nouveau point comme HI moins FS ; cette page ne répond qu'à la hauteur d'instrument d'une seule station à partir de BM et BS.
Où un calculateur de hauteur d'instrument apporte de la valeur
Sur cette page le travail s'exécute entièrement dans votre navigateur ; via l'API chaque consultation réussie coûte $0.002, la validation échouée n'est pas facturée et rien n'est stocké après le renvoi de la réponse. Cette division — exploration interactive gratuite et API identique payante — correspond au reste du catalogue KIT de niveau A et vous permet de passer d'une démo de classe à un pipeline automatisé sans changer le résultat mathématique. Réservez cet outil à l'étape élémentaire HI égale BM plus BS ; si vous avez besoin de réductions multi-stations, de contrôles de fermeture ou de moyennes de nivellement à trois fils, réduisez d'abord le HI de chaque station avec ce endpoint ou utilisez un modèle dédié à l'ajustement complet du circuit.
Cas d'intégration
Fixtures logicielles et notation LMS
Semez des vecteurs de test déterministes HI = BM + BS pour des applications de topographie et notez automatiquement des items de nivellement avec un oracle parse pur.
Questions techniques
Comment calcule-t-on la hauteur d'instrument en nivellement différentiel ?
Envoyez des nombres finis benchmark_elevation (BM) et backsight (BS, non négatif). L'API renvoie HI = BM + BS dans la même unité de longueur que vos entrées, plus la formule et les étapes de substitution.
Pourquoi la lecture arrière doit-elle être non négative ?
Une lecture de mire de nivellement est une longueur mesurée vers le haut depuis la base de la mire ; une lecture négative n'est pas une observation de terrain valide sous ce contrat et échoue avec invalid_input.
Combien coûte le calculateur de hauteur d'instrument ?
L'outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.