Formato del Excel

TerrioLabs CAD lee el mismo formato que exporta TerrioLabs Drilling. Esta página describe qué hoja y qué columna busca cada dato — útil sobre todo si armas el Excel a mano en vez de exportarlo desde Drilling.

Si prefieres no armarlo desde cero, Connection tiene un botón para descargar una plantilla de ejemplo ya con el formato correcto.

Reglas generales

• Las columnas se leen por nombre, nunca por posición — el orden de las columnas no importa, solo sus encabezados.
• Los datos empiezan en la fila 3 de cada hoja (las dos primeras son encabezado).
• Una columna que el plugin no reconoce no rompe nada — simplemente se ignora.
• El plugin no valida tus datos (por ejemplo, que depth_from sea menor que depth_to). Revisarlos es responsabilidad de quien arma el Excel.

Hoja info

Formato de dos columnas (campo / valor), no tabular. Campo obligatorio:

Campo	Qué es
format_version	Versión del formato. El plugin exige la serie 4.x — un Excel 2.x o 3.x ya no carga.

Campos opcionales que se usan en otras partes del plugin (proyecto, tabla de coordenadas): project_name, city, location, latitude, longitude, client, contractor, engineer, projection, description, status.

Hoja boreholes — un sondeo por fila

Columna	Obligatoria	Qué es
name	Sí	Nombre del sondeo. Debe ser único en la hoja.
depth_total	Sí	Profundidad total perforada.
easting / northing	No	Coordenadas planas — necesarias para Ubicación en planta y Secciones.
latitude / longitude	No	Se muestran tal cual en la tabla de coordenadas (no se reproyectan).
elevation	No	Cota de boca de pozo.
status	No	Estado del sondeo (ver abajo).

La columna status

El estado de cada perforación cumple dos funciones: agrupa los sondeos en el árbol del panel Tool Space y define el color con el que se dibuja su símbolo en planta.

Los valores válidos son estos cinco, escritos exactamente así (en minúscula, con guion bajo):

Valor	Grupo en el árbol	Color del símbolo
in_progress	En progreso	Ámbar
planned	Planeados	Azul
paused	Pausados	Gris
completed	Completados	Verde
cancelled	Cancelados	Rojo

Cualquier otro valor —o la celda vacía— cae en el grupo Sin estado, con símbolo azul-gris. No es un error: un proyecto que no lleve control de estados funciona igual, todos sus sondeos quedan en ese grupo.

Hoja stratigraphy — una capa por fila

Columna	Obligatoria	Qué es
borehole	Sí	Nombre del sondeo (debe existir en boreholes).
depth_from / depth_to	Sí	Profundidad inicial y final de la capa.
material	Sí	Nombre del tipo de material.
description	No	Descripción de la capa.
color	No	Color en hexadecimal. Si falta, el plugin asigna uno automáticamente.
pattern	No	Nombre del patrón de hatch de AutoCAD. Si no es válido, cae en SOLID.
pattern_scale	No	Escala del patrón. Si falta o es ≤ 0, usa 0.005.

Las tres últimas se definen por tipo de material, no por capa, y el detalle de cada formato está en Perfil de sondeo.

Hoja water_tables — nivel freático

Columna	Obligatoria	Qué es
borehole	Sí	Nombre del sondeo.
water_level_depth	Sí	Profundidad del nivel de agua. Si hay varias mediciones para el mismo sondeo, se usa la más superficial.

Hojas samples e insitu_tests — dinámicas

Estas dos hojas son las más flexibles: solo tres columnas son fijas, el resto se lee dinámicamente y queda disponible para elegir en las gráficas y labels del perfil (ver Perfil de sondeo).

Hoja	Columnas fijas (obligatorias)
samples	borehole, depth_from, depth_to
insitu_tests	borehole, depth_top, depth_base

Cualquier otra columna —sample_type, recovery, rqd, los golpes crudos del SPT (n1/n2/n3), n, su_*, cu, o lo que necesites— se detecta sola, sea numérica o de texto. Los valores derivados (N del SPT, cu, sensibilidad…) se dibujan tal como llegan, sin que el plugin los recalcule — ese cálculo es responsabilidad de Drilling, no del plugin.