Calculadora altura de instrumento
Con un punto de referencia a 100 m y una lectura de espalda de 1,245 m, la altura de instrumento es de 101,245 m. Indique la cota y la lectura para iniciar un itinerario de nivelación o revisar un punto de cambio. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Cota del punto de referencia
- 100
- Lectura atrás
- 1,245
- Altura del instrumento
- 101,245
- Precisión
- 12
En la nivelación diferencial, la altura de instrumento es la cota de la línea de colimación del telescopio una vez que el aparato está estacionado y nivelado. Se obtiene sumando la lectura de mira de atrás sobre un punto de cota conocida a esa cota: HI es igual a BM más BS. Topógrafos, estudiantes de ingeniería civil y cuadrillas de campo necesitan esa suma cada vez que inician un circuito de nivelación o comprueban la reducción de un punto de paso, y los scripts de automatización requieren un contrato determinista que no invente lecturas a partir de datos ausentes.
Qué significa la altura de instrumento en nivelación diferencial
La nivelación diferencial transfiere cota desde un punto conocido hacia puntos desconocidos midiendo lecturas verticales de mira con un nivel cuya línea de colimación es horizontal. La altura de instrumento (HI) es la cota de esa línea horizontal de colimación sobre el datum del proyecto. Una vez conocida la HI, cualquier lectura de mira de adelante FS sobre un punto nuevo da la cota de ese punto como HI menos FS.
La forma habitual de establecer la HI en una estación es tomar una lectura de atrás (BS) sobre un punto de cota conocida —habitualmente un punto de referencia permanente o un punto de paso de la estación anterior— y sumar esa lectura a la cota conocida: HI es igual a BM más BS. La lectura de atrás es siempre la del punto conocido; es la que «mira hacia» el control.
Las lecturas de mira son longitudes no negativas medidas desde el pie de la mira hacia arriba; una lectura negativa implicaría que la línea de colimación queda por debajo de la base de la mira, lo cual no es una observación de campo válida en este modelo. Las cotas del punto de referencia pueden ser positivas, nulas o negativas cuando el datum local queda por encima de algunos puntos del terreno.
Las unidades deben ser coherentes: si el punto de referencia está en metros, la lectura de atrás debe estar en metros para que HI quede en metros; la calculadora no convierte pies a metros por usted.
Dónde aporta valor una calculadora de altura de instrumento
Los estudiantes encuentran HI igual a BM más BS en la primera semana de un curso de topografía, cuando un laboratorio pide reducir un tramo simple de dos puntos o cuando un examen da una cota de punto de referencia y una lectura de atrás y exige la altura de colimación antes de cualquier trabajo de mira de adelante.
Los profesores pueden pregenerar claves de respuesta para cifras modestas sin confiar en aplicaciones opacas que cambian de sistema de unidades en silencio o confunden lectura de atrás con lectura de adelante. Los desarrolladores invocan el mismo contrato desde scripts para sembrar vectores de prueba deterministas en software de libreta de campo, normalizar datos de nivelación introducidos por el usuario antes de un ajuste de mínimos cuadrados mayor, o satisfacer enunciados de retos de programación que exigen HI en lugar de un croquis a mano alzada.
Las cuadrillas de construcción y de obra civil usan la suma para comprobaciones rápidas cuando un punto de referencia permanente se conoce por redes de control y la lectura de mira sobre esa marca está anotada en el libro. Herramientas de producto y de educación usan la reescritura cuando un aprendiz escribe BM y BS y la interfaz debe mostrar la altura de instrumento con una cadena de fórmula limpia.
Qué puede hacer con ella
Comprobaciones de HI en tareas y laboratorio
Calcule la altura de instrumento a partir de una cota de punto de referencia conocida y de la lectura de mira atrás antes de reducir miras de adelante en un informe de nivelación diferencial.
Comprobaciones en libreta de campo y obra
Verifique la HI en cada estación del instrumento cuando se conozcan un punto de referencia permanente y la lectura BS, de modo que las cotas siguientes sean HI menos FS.
Preguntas frecuentes
¿Cuál es la fórmula de la altura de instrumento?
HI = BM + BS, donde BM es la cota conocida del punto de referencia (o punto de paso) y BS es la lectura de mira de atrás en ese punto.
¿Puede la cota del punto de referencia ser negativa o nula?
Sí. La cota del punto de referencia puede ser cualquier número finito, incluidos el cero y valores negativos por debajo del datum local. Solo la lectura de mira de atrás debe ser no negativa.
¿Cómo obtengo la cota de un punto nuevo a partir de la altura de instrumento?
Reste a la altura de instrumento la lectura de frente tomada sobre el punto nuevo. La lectura de espalda siempre se hace sobre el punto conocido y la de frente sobre el punto que quiere hallar.
¿Puede ser negativa la lectura de espalda?
No. La lectura de la mira se mide hacia arriba desde su pie, así que no puede bajar de cero y un valor negativo se rechaza. La cota del punto de referencia, en cambio, sí puede ser negativa.
¿Reduce un itinerario completo o compensa el error de cierre?
No. Resuelve una sola estación: cota del punto de referencia más lectura de espalda. Varias estaciones, el equilibrio de visuales y la compensación del cierre quedan fuera, así que arrastre usted cada nueva altura.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su 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)Ejemplo de solicitud
{
"benchmark_elevation": 100,
"backsight": 1.245
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "eng.level_hi",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Esta calculadora de altura de instrumento acepta la cota conocida del punto de referencia y la lectura de mira atrás en cualquier unidad de longitud coherente, devuelve el HI redondeado con la cadena de fórmula clásica y los pasos de sustitución ordenados, y rechaza lecturas de mira negativas como invalid_input en lugar de producir una altura de colimación sin sentido.
Qué significa la altura de instrumento en nivelación diferencial
Este endpoint devuelve la cota del punto de referencia y la lectura de atrás redondeadas que usted suministró, la altura de instrumento calculada, la precisión usada, una etiqueta de método differential_leveling_hi, formula como la cadena HI equals BM plus BS, message como un resumen breve en español y steps como un registro de sustitución ordenado. No hay reducción multiestación, ni equilibrado de miras, ni ajuste de error de cierre: el motor o bien suma dos números finitos dentro del rango de magnitud admitido, o rechaza la entrada con invalid_input.
Contrato de entrada, forma de la respuesta y comportamiento ante errores
Ambos deben ser números finitos; backsight debe ser no negativo porque una graduación de mira no puede leer por debajo de cero en este contrato. Prefiera enviar números en lugar de cadenas preformateadas cuando controle el cliente; si debe enviar cadenas, evite etiquetas de unidad que harían fallar el patrón de número finito. Envíe un cuerpo JSON con dos campos obligatorios: benchmark_elevation para la cota conocida del punto donde se sostiene la mira en la lectura de atrás (alias BM, bm, elevation, benchmark, known_elevation, elev_bm) y backsight para la lectura de mira en ese punto (alias BS, bs, backsight_reading, staff_reading, bs_reading). La precisión opcional (alias decimals, dp) elige cuántos decimales exponer en los campos numéricos, con valor por defecto doce y tope quince para que los goldens JSON se mantengan estables entre runtimes. Se aceptan formas en cadena de números cuando coinciden con un patrón decimal finito estricto con notación científica opcional; espacios embebidos, sufijos de unidad como m o ft y tokens no numéricos fallan con un mensaje invalid_input claro que nombra el campo. En caso de éxito la respuesta repite las entradas redondeadas, publica height_of_instrument como BM más BS, formula y message como se describe arriba, y steps como el registro de sustitución que usted puede afirmar en pruebas o mostrar junto a un croquis de libreta de campo. La validación fallida —campos ausentes, números no finitos, backsight negativo o valores fuera de los límites absolutos de magnitud— devuelve invalid_input y nunca se cobra. El precio es un fijo de $0.002 por solicitud correcta con unidad item. Empareje este endpoint con una reducción de mira de adelante cuando ya conozca HI y necesite la cota de un punto nuevo como HI menos FS; esta página responde solo a la altura de instrumento de una estación a partir de BM y BS.
Dónde aporta valor una calculadora de altura de instrumento
En esta página el trabajo se ejecuta por completo en su navegador; a través de la API cada consulta correcta cuesta $0.002, la validación fallida no se cobra y no se almacena nada tras devolver la respuesta. Esa división —exploración interactiva gratuita y una API idéntica de pago— encaja con el resto del catálogo KIT de nivel A y le permite pasar de una demo de aula a un pipeline automatizado sin cambiar el resultado matemático. Reserve esta herramienta para el paso elemental HI igual a BM más BS; si necesita reducciones multiestación, comprobaciones de cierre o promedios de nivelación de tres hilos, reduzca primero la HI de cada estación con este endpoint o use un modelo dedicado al ajuste completo del circuito.
Casos de integración
Fixtures de software y calificación LMS
Genere vectores de prueba deterministas HI = BM + BS para aplicaciones de topografía y califique automáticamente ítems de nivelación con un oráculo de parse puro.
Preguntas técnicas
¿Cómo se calcula la altura de instrumento en nivelación diferencial?
Envíe números finitos benchmark_elevation (BM) y backsight (BS, no negativo). La API devuelve HI = BM + BS con la misma unidad de longitud que sus entradas, más la fórmula y los pasos de sustitución.
¿Por qué la lectura de atrás debe ser no negativa?
Una lectura de mira de nivelación es una longitud medida hacia arriba desde la base de la mira; una lectura negativa no es una observación de campo válida bajo este contrato y falla con invalid_input.
¿Cuánto cuesta la calculadora de altura de instrumento?
La herramienta del navegador es gratuita. Las solicitudes API usan saldo prepago KIT a $0.002 por llamada correcta; la entrada inválida no se cobra.